# Matrice graphique Windows : backend WebGPU unifié

Inventaire initial du 2026-10-09, complété par les qualifications natives du 2026-10-10.

## Sources locales

| Source              | Chemin                                                                            | Backend                                             | Couverture DirectX                      |
| ------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------- | --------------------------------------- |
| Aphrody render      | `$APHRODY_ROOT/crates/ui/render` (feature `gpu`)                                  | wgpu (`dx12`, `vulkan`, `metal`, `webgpu`, `webgl`) | D3D12 via wgpu                          |
| Aphrody gpu-backend | `$APHRODY_ROOT/crates/native/gpu-backend`                                         | wgpu (`dx12` via `native-backends`) + CUDA          | D3D12 via wgpu                          |
| Aphrody ui/bun      | `$APHRODY_ROOT/crates/ui/bun`                                                     | wgpu (dépendance)                                   | D3D12 via wgpu                          |
| Aphrody softraster  | `$APHRODY_ROOT/crates/ui/softraster`                                              | CPU                                                 | aucune                                  |
| Rio                 | absent de `C:\`                                                                   | non trouvé                                          | non vérifié                             |
| Bun fork            | `$APHRODY_BUN_CHECKOUT/packages/bun-windows-{d2d1,d3d11,d3d12,dxgi,dwrite,dcomp}` | FFI générée (Win32 metadata 71.0.30-preview)        | D2D1, D3D11, D3D12, DXGI, DWrite, DComp |

## Surface bun:windows existante

- `windows.families.<name>` (`src/js/bun/windows.ts`, ~ligne 983) charge les paquets `@aphrody/bun-windows-*`.
- `windows.gpu.d3d12` (`src/runtime/windows/sys/gpu.rs`, appels COM directs, sans wgpu) : `info()` (adaptateur 0, niveau de fonctionnalité 12_0 ou 11_0), `clearRenderTarget(width, height, color)` (cible RGBA8, relecture des pixels), `copyBuffer(data)` (upload, copie GPU, relecture). Un device par appel, synchronisé par fence.
- Tests : `describe("gpu.d3d12")` dans `test/js/bun/windows/windows.test.ts`.
- Qualification native ciblée, 2026-10-10 : RTX 4070, niveau 12_0, clear RGBA8 4 × 4 et copie de 37 octets relus exactement. Le module sys compilé seul échoue avant la correction du pointeur de sortie COM et passe après. Le binaire Bun reconstruit passe les cinq tests JavaScript D3D12 (16 assertions).
- Le probe wgpu 30.0.1 existant exécute désormais un shader WGSL headless et vérifie ses 37 résultats après relecture. Build release, Clippy strict et exécution RTX 4070 / Dx12 réussis ; voir `scripts/aphrody/alpine/wsl/examples/wgpu-probe/README.md`.
- Le gate Buv/PyJS/PyCUDA a compilé un kernel CUDA sans cache, doublé 37 entiers et vérifié leur relecture dans le processus Bun sur RTX 4070 (capacité 8.9). Qualification du 2026-10-10 : PyCUDA 2026.1, CUDA 13.4.1, CPython 3.12.15 ; les PID Python et Bun sont identiques. Voir `packages/buv/README.md` pour l'environnement explicite du host embarqué.
- Absent : énumération multi-adaptateurs, D3D11, D2D, swap chain et présentation, shaders et pipelines.

## Non fait dans cette passe

- Inventaire GitHub des projets WebGPU mis à jour dans les 30 derniers jours : non exécuté (outils MCP `github_*` non chargés).
- Vérification de Rio : dépôt absent de `C:\`.
- Migration d'Aphrody vers `bun:windows.gpu` : non faite ; Aphrody utilise toujours wgpu.

## Lots suivants

1. Énumération de tous les adaptateurs DXGI (aujourd'hui adaptateur 0 seulement).
2. Device D3D11 : création et clear dans `gpu.d3d11`.
3. D2D sur swap chain D3D11 ; présentation DXGI.
4. Shaders et root signature D3D12 pour des rendus non triviaux.
5. Gates Rust sérialisées sur un hôte natif ou une factory qualifiée.