@forgeax/engine-rhi-null 0.0.0-dev.8d955ade1c79

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,129 @@
+# @forgeax/engine-rhi-null
+
+> Headless no-op RHI backend for structural unit tests -- inject via `createRenderer(canvas, { rhi })`, zero GPU / DOM dependency. Covers the full `RhiDevice` surface with no-op brands and a per-device handle ledger so command-stream assertions (draw count / pass schedule / create-destroy pairing / bind-group assembly) work in `test:unit` without a real GPU.
+
+## Access -- Channel 1 injection
+
+```ts
+import { rhi } from '@forgeax/engine-rhi-null';
+import { createRenderer } from '@forgeax/engine-runtime';
+
+// `canvas` is a required positional param. In headless CI hand it any object
+// shaped like a canvas -- RhiNull never touches the DOM, so a minimal stub is
+// enough (the dogfood tests use one; see packages/runtime/src/__tests__).
+const canvas = { width: 1, height: 1 } as unknown as HTMLCanvasElement;
+const created = await createRenderer(canvas, { rhi });
+if (!created.ok) throw created.error;
+const renderer = created.value;
+```
+
+The exported `rhi` singleton has the `RhiBackendPack`-mandated shape (`RhiInstance & { acquireCanvasContext; createShaderModule }`). `createRenderer` picks it up via Channel 1's `rendererOptions.rhi` escape hatch -- no backend auto-selection logic is modified, no `navigator.gpu` probe involved.
+
+| Entry | Type | Purpose |
+|:--|:--|:--|
+| `rhi` | `RhiInstance & { acquireCanvasContext; createShaderModule }` | Singleton; inject into `createRenderer({ rhi })` |
+| `rhi.requestAdapter(opts?, canvas?)` | `async fn` | Returns `ok(new RhiNullAdapter())` |
+| `rhi.createShaderModule(device, desc)` | `async fn` | Returns `ok(ShaderModule)` without real compile |
+| `rhi.acquireCanvasContext(canvas?)` | `fn` | Returns `ok(RhiNullCanvasContext)` for any canvas / null / undefined |
+| `rhi.adapter.requestDevice()` | `async fn` | Returns `ok(new RhiNullDevice(queue, encoderFactory))` |
+| `RhiNullDevice` | class `implements RhiDevice` | All `create*` mint legal brands + ledger entries; all `destroy*` fail-fast on double-destroy |
+| `RhiNullQueue` | class `implements RhiQueue` | `submit` returns `ok`; `onSubmittedWorkDone` resolves immediately |
+
+## Capabilities
+
+`renderer.inspect().capabilities` reports the D-5 profile: every boolean cap is `true` except the three `@reserved-for-wgpu-native-only` fields (`multiDrawIndirect`, `pushConstants`, `textureBindingArray`), which are `false`. `maxColorAttachments` is 8. The headless backend maximizes structural coverage -- any `caps.X` gate in the engine codebase passes through:
+
+| Cap | Value | Note |
+|:--|:--|:--|
+| `backendKind` | `'null'` | 4th union member alongside `'webgpu'` / `'wgpu-native'` / `'wgpu-webgl2'` |
+| `compute` | `true` | |
+| `timestampQuery` | `false` | Structural backend; GPU timing is refused |
+| `indirectDrawing` | `true` | |
+| `textureCompressionBc` | `false` | headless has no compression hardware (AC-06) |
+| `textureCompressionEtc2` | `false` | headless has no compression hardware (AC-06) |
+| `textureCompressionAstc` | `false` | headless has no compression hardware (AC-06) |
+| `multiDrawIndirect` | `false` | `@reserved-for-wgpu-native-only` |
+| `pushConstants` | `false` | `@reserved-for-wgpu-native-only` |
+| `textureBindingArray` | `false` | `@reserved-for-wgpu-native-only` |
+| `samplerAliasing` | `true` | |
+| `firstInstanceIndirect` | `true` | |
+| `storageBuffer` | `true` | |
+| `storageTexture` | `true` | |
+| `rgba16floatRenderable` | `true` | |
+| `rg11b10ufloatRenderable` | `true` | |
+| `float32Filterable` | `true` | |
+| `maxColorAttachments` | `8` | >= 4 (HDRP deferred minimum) |
+
+> [!WARNING]
+> RhiNull is deliberately non-timing. Timestamp query creation returns a
+> structured feature error and membership timing must terminate as
+> `timestamp-query-unsupported`; do not turn the structural ledger into fake
+> GPU evidence.
+
+`device.features` returns an empty `ReadonlySet`; `device.limits` returns an empty `Record`. Capability planning reads `caps` booleans, not the feature set.
+
+## Handle bookkeeping
+
+Every `create*` call on `RhiNullDevice` registers the returned handle in a per-device `Bookkeeper`. Each ledger row is a `HandleRecord`:
+
+```ts
+interface HandleRecord {
+  readonly id: number;          // per-device monotonic
+  readonly kind: string;        // 'Buffer' / 'Texture' / 'BindGroupLayout' / ...
+  destroyed: boolean;           // flipped on first destroy
+  readonly sourceDeviceId: number;  // cross-device validation
+}
+```
+
+**Readback for assertions** -- the device ledger is an owner-local test concern. Public `Renderer` exposes no device; inject the RhiNull pack into a package-local construction test when counters are needed:
+
+```ts
+import type { RhiNullDevice } from '@forgeax/engine-rhi-null';
+
+const device = ownerLocalDevice as RhiNullDevice;
+device.totalDrawCount = 0;       // reset before a frame if you assert deltas
+device.totalDispatchCount = 0;
+renderer.draw(world);
+const records = device.bookkeeper.allRecords(); // snapshot of all ledger rows
+```
+
+M3 unit tests read this to assert:
+
+- **Create / destroy pairing** (`kind: 'Buffer'` count == `kind: 'Buffer'` with `destroyed === true` count)
+- **Draw count >= 1** (`device.totalDrawCount` after `renderer.draw(world)`)
+- **Compute dispatch count** (`device.totalDispatchCount`, including indirect dispatch)
+- **Bind-group assembly counts** (`device.totalBindGroupCount`)
+- **Pass schedule order** -- prefer the type-safe `renderer.perFramePassNames` (no cast needed); `device.framePassNames` is the same data on the cast `RhiNullDevice`
+- **BGL / PSO shape** (ledger entries with `kind: 'BindGroupLayout'` / `kind: 'RenderPipeline'`)
+
+**Handle-chain validation** -- `setVertexBuffer` / `setBindGroup` validate handle ownership. A handle issued by device A passed to device B returns `err({ code: 'rhi-not-available', expected, hint })`. A second `destroy` on the same handle returns `err({ code: 'destroy-after-destroy', expected, hint })`. Zero new `RhiErrorCode` members -- reuses existing closed-union codes (D-1).
+
+## Pipeline `getBindGroupLayout`
+
+`createRenderPipeline` and `createComputePipeline` return pipeline handles that carry a no-op `getBindGroupLayout(index)` method (D-2). The method returns a legal `BindGroupLayout` brand registered in the ledger, so the auto-layout path in `debug-draw.ts` and existing mock unit tests do not crash on a missing method.
+
+## Boundaries
+
+- **Structural only, never produces pixels.** RhiNull covers the command-stream protocol layer (buffer / texture / bind-group / pipeline / pass-encoder creation and submission). It does not execute shaders, write to GPU memory, or produce render-target contents. `getCurrentTexture()` returns a brand with no pixel data.
+- **Does not replace dawn / browser pixel readback.** Smoke tests (`apps/hello/*`, `apps/learn-render/*`) still need a real GPU backend (`rhi-webgpu` or `rhi-wgpu`). RhiNull is for `test:unit` structural assertions, not visual verification.
+- **No image-channel dependency** (charter P2). The README is ASCII-only; the backend has no screenshots, no pixel baselines, no render-target PNGs.
+- **Per-renderer instances are independent.** Each `createRenderer({ rhi })` creates a fresh `RhiNullDevice` with its own `Bookkeeper`. Cross-instance handle pollution is impossible because each device's ledger keys on `sourceDeviceId`.
+- **`'null'` union member meaning.** The 3 pre-existing backends (`webgpu` / `wgpu-native` / `wgpu-webgl2`) are unchanged. `'null'` is the 4th member, representing "no real GPU -- structural-only command-stream ledger." `render-graph` barrier insertion treats it as no-barrier (same equivalence group as `webgpu` / `wgpu-webgl2`).
+
+## Distinction from vitest mocks
+
+| Aspect | vitest mock (`vi.fn()`) | RhiNull (`createRenderer({ rhi })`) |
+|:--|:--|:--|
+| Surface | Partial stub (caller chooses what to mock) | Full `implements RhiDevice` (tsc-complete) |
+| Ledger | None (assert `.toHaveBeenCalled()` on mocks) | `Bookkeeper.allRecords()` + `totalDrawCount` / `framePassNames` |
+| Integration depth | Tests one function call at a time | Exercises real `createRenderer` -> `Result<Renderer>` -> `renderer.draw(frame)` path |
+| Handle validation | None | Cross-device and double-destroy fail-fast |
+| Render-graph coverage | Mock `RhiCommandEncoder` return values | Real pass scheduling through URP default pipeline |
+
+Use vitest mocks for isolated unit tests (single function / class). Use RhiNull for structural integration tests that need the full engine lifecycle (renderer init -> draw -> command flow).
+
+## Dependencies
+
+- `@forgeax/engine-rhi` (workspace) -- interface contract SSOT.
+- `@forgeax/engine-types` (workspace) -- POD types / `Result` SSOT.
+- `@webgpu/types` (workspace) -- descriptor type alignment; no real GPU binding.

package/dist/.tsbuildinfo

@@ -0,0 +1 @@
+{"fileNames":["../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es5.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2015.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2016.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2017.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2018.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2019.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2020.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2021.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2022.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.dom.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.dom.iterable.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2015.core.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2015.collection.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2015.generator.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2015.iterable.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2015.promise.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2015.proxy.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2015.reflect.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2015.symbol.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2016.array.include.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2016.intl.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2017.arraybuffer.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2017.date.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2017.object.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2017.sharedmemory.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2017.string.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2017.intl.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2017.typedarrays.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2018.asyncgenerator.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2018.asynciterable.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2018.intl.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2018.promise.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2018.regexp.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2019.array.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2019.object.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2019.string.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2019.symbol.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2019.intl.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2020.bigint.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2020.date.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2020.promise.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2020.sharedmemory.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2020.string.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2020.symbol.wellknown.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2020.intl.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2020.number.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2021.promise.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2021.string.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2021.weakref.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2021.intl.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2022.array.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2022.error.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2022.intl.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2022.object.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2022.string.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2022.regexp.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.decorators.d.ts","../../../node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.decorators.legacy.d.ts","../../types/dist/animation-target.d.ts","../../types/dist/asset-errors.d.ts","../../types/dist/result.d.ts","../../types/dist/asset-evidence.d.ts","../../types/dist/asset.d.ts","../../types/dist/material/color-space.d.ts","../../types/dist/material/asset.d.ts","../../types/dist/vfx.d.ts","../../types/dist/asset-runtime.d.ts","../../types/dist/handle.d.ts","../../types/dist/material/errors.d.ts","../../types/dist/material/resolve.d.ts","../../types/dist/material/index.d.ts","../../types/dist/asset-producer.d.ts","../../types/dist/catalog.d.ts","../../types/dist/runtime-scope.d.ts","../../types/dist/derive-paramschema.d.ts","../../types/dist/import.d.ts","../../types/dist/index.d.ts","../../rhi/dist/errors.d.ts","../../rhi/dist/index.d.ts","../src/bookkeeping.ts","../src/device.ts","../src/pass-encoders.ts","../src/command-encoder.ts","../src/queue.ts","../src/adapter.ts","../src/canvas-context.ts","../src/shader.ts","../src/index.ts","../../../node_modules/.pnpm/@webgpu+types@0.1.71/node_modules/@webgpu/types/dist/index.d.ts"],"fileIdsList":[[78,80,82,84,85],[78,80],[78,80,81,82,83],[78,80,81],[78,80,82,83,84,85,86,87,88],[78],[78,79],[61,62,64],[61,62,64,78],[63],[62,64,73],[61,73,74,75,78],[60,61,62,64,66,67,68,69,72,73,74,75,76,77],[65,78],[66],[65,66,70,71],[62,66,70],[73,74]],"fileInfos":[{"version":"bcd24271a113971ba9eb71ff8cb01bc6b0f872a85c23fdbe5d93065b375933cd","affectsGlobalScope":true,"impliedFormat":1},{"version":"3f88bedbeb09c6f5a6645cb24c7c55f1aa22d19ae96c8e6959cbd8b85a707bc6","impliedFormat":1},{"version":"7fe93b39b810eadd916be8db880dd7f0f7012a5cc6ffb62de8f62a2117fa6f1f","impliedFormat":1},{"version":"bb0074cc08b84a2374af33d8bf044b80851ccc9e719a5e202eacf40db2c31600","impliedFormat":1},{"version":"1a7daebe4f45fb03d9ec53d60008fbf9ac45a697fdc89e4ce218bc94b94f94d6","impliedFormat":1},{"version":"f94b133a3cb14a288803be545ac2683e0d0ff6661bcd37e31aaaec54fc382aed","impliedFormat":1},{"version":"f59d0650799f8782fd74cf73c19223730c6d1b9198671b1c5b3a38e1188b5953","impliedFormat":1},{"version":"8a15b4607d9a499e2dbeed9ec0d3c0d7372c850b2d5f1fb259e8f6d41d468a84","impliedFormat":1},{"version":"26e0fe14baee4e127f4365d1ae0b276f400562e45e19e35fd2d4c296684715e6","impliedFormat":1},{"version":"d6b1eba8496bdd0eed6fc8a685768fe01b2da4a0388b5fe7df558290bffcf32f","affectsGlobalScope":true,"impliedFormat":1},{"version":"7f57fc4404ff020bc45b9c620aff2b40f700b95fe31164024c453a5e3c163c54","impliedFormat":1},{"version":"eadcffda2aa84802c73938e589b9e58248d74c59cb7fcbca6474e3435ac15504","affectsGlobalScope":true,"impliedFormat":1},{"version":"105ba8ff7ba746404fe1a2e189d1d3d2e0eb29a08c18dded791af02f29fb4711","affectsGlobalScope":true,"impliedFormat":1},{"version":"00343ca5b2e3d48fa5df1db6e32ea2a59afab09590274a6cccb1dbae82e60c7c","affectsGlobalScope":true,"impliedFormat":1},{"version":"ebd9f816d4002697cb2864bea1f0b70a103124e18a8cd9645eeccc09bdf80ab4","affectsGlobalScope":true,"impliedFormat":1},{"version":"2c1afac30a01772cd2a9a298a7ce7706b5892e447bb46bdbeef720f7b5da77ad","affectsGlobalScope":true,"impliedFormat":1},{"version":"7b0225f483e4fa685625ebe43dd584bb7973bbd84e66a6ba7bbe175ee1048b4f","affectsGlobalScope":true,"impliedFormat":1},{"version":"c0a4b8ac6ce74679c1da2b3795296f5896e31c38e888469a8e0f99dc3305de60","affectsGlobalScope":true,"impliedFormat":1},{"version":"3084a7b5f569088e0146533a00830e206565de65cae2239509168b11434cd84f","affectsGlobalScope":true,"impliedFormat":1},{"version":"c5079c53f0f141a0698faa903e76cb41cd664e3efb01cc17a5c46ec2eb0bef42","affectsGlobalScope":true,"impliedFormat":1},{"version":"32cafbc484dea6b0ab62cf8473182bbcb23020d70845b406f80b7526f38ae862","affectsGlobalScope":true,"impliedFormat":1},{"version":"fca4cdcb6d6c5ef18a869003d02c9f0fd95df8cfaf6eb431cd3376bc034cad36","affectsGlobalScope":true,"impliedFormat":1},{"version":"b93ec88115de9a9dc1b602291b85baf825c85666bf25985cc5f698073892b467","affectsGlobalScope":true,"impliedFormat":1},{"version":"f5c06dcc3fe849fcb297c247865a161f995cc29de7aa823afdd75aaaddc1419b","affectsGlobalScope":true,"impliedFormat":1},{"version":"b77e16112127a4b169ef0b8c3a4d730edf459c5f25fe52d5e436a6919206c4d7","affectsGlobalScope":true,"impliedFormat":1},{"version":"fbffd9337146eff822c7c00acbb78b01ea7ea23987f6c961eba689349e744f8c","affectsGlobalScope":true,"impliedFormat":1},{"version":"a995c0e49b721312f74fdfb89e4ba29bd9824c770bbb4021d74d2bf560e4c6bd","affectsGlobalScope":true,"impliedFormat":1},{"version":"c7b3542146734342e440a84b213384bfa188835537ddbda50d30766f0593aff9","affectsGlobalScope":true,"impliedFormat":1},{"version":"ce6180fa19b1cccd07ee7f7dbb9a367ac19c0ed160573e4686425060b6df7f57","affectsGlobalScope":true,"impliedFormat":1},{"version":"3f02e2476bccb9dbe21280d6090f0df17d2f66b74711489415a8aa4df73c9675","affectsGlobalScope":true,"impliedFormat":1},{"version":"45e3ab34c1c013c8ab2dc1ba4c80c780744b13b5676800ae2e3be27ae862c40c","affectsGlobalScope":true,"impliedFormat":1},{"version":"805c86f6cca8d7702a62a844856dbaa2a3fd2abef0536e65d48732441dde5b5b","affectsGlobalScope":true,"impliedFormat":1},{"version":"e42e397f1a5a77994f0185fd1466520691456c772d06bf843e5084ceb879a0ad","affectsGlobalScope":true,"impliedFormat":1},{"version":"f4c2b41f90c95b1c532ecc874bd3c111865793b23aebcc1c3cbbabcd5d76ffb0","affectsGlobalScope":true,"impliedFormat":1},{"version":"ab26191cfad5b66afa11b8bf935ef1cd88fabfcb28d30b2dfa6fad877d050332","affectsGlobalScope":true,"impliedFormat":1},{"version":"2088bc26531e38fb05eedac2951480db5309f6be3fa4a08d2221abb0f5b4200d","affectsGlobalScope":true,"impliedFormat":1},{"version":"cb9d366c425fea79716a8fb3af0d78e6b22ebbab3bd64d25063b42dc9f531c1e","affectsGlobalScope":true,"impliedFormat":1},{"version":"500934a8089c26d57ebdb688fc9757389bb6207a3c8f0674d68efa900d2abb34","affectsGlobalScope":true,"impliedFormat":1},{"version":"689da16f46e647cef0d64b0def88910e818a5877ca5379ede156ca3afb780ac3","affectsGlobalScope":true,"impliedFormat":1},{"version":"bc21cc8b6fee4f4c2440d08035b7ea3c06b3511314c8bab6bef7a92de58a2593","affectsGlobalScope":true,"impliedFormat":1},{"version":"7ca53d13d2957003abb47922a71866ba7cb2068f8d154877c596d63c359fed25","affectsGlobalScope":true,"impliedFormat":1},{"version":"54725f8c4df3d900cb4dac84b64689ce29548da0b4e9b7c2de61d41c79293611","affectsGlobalScope":true,"impliedFormat":1},{"version":"e5594bc3076ac29e6c1ebda77939bc4c8833de72f654b6e376862c0473199323","affectsGlobalScope":true,"impliedFormat":1},{"version":"2f3eb332c2d73e729f3364fcc0c2b375e72a121e8157d25a82d67a138c83a95c","affectsGlobalScope":true,"impliedFormat":1},{"version":"6f4427f9642ce8d500970e4e69d1397f64072ab73b97e476b4002a646ac743b1","affectsGlobalScope":true,"impliedFormat":1},{"version":"48915f327cd1dea4d7bd358d9dc7732f58f9e1626a29cc0c05c8c692419d9bb7","affectsGlobalScope":true,"impliedFormat":1},{"version":"b7bf9377723203b5a6a4b920164df22d56a43f593269ba6ae1fdc97774b68855","affectsGlobalScope":true,"impliedFormat":1},{"version":"db9709688f82c9e5f65a119c64d835f906efe5f559d08b11642d56eb85b79357","affectsGlobalScope":true,"impliedFormat":1},{"version":"4b25b8c874acd1a4cf8444c3617e037d444d19080ac9f634b405583fd10ce1f7","affectsGlobalScope":true,"impliedFormat":1},{"version":"37be57d7c90cf1f8112ee2636a068d8fd181289f82b744160ec56a7dc158a9f5","affectsGlobalScope":true,"impliedFormat":1},{"version":"a917a49ac94cd26b754ab84e113369a75d1a47a710661d7cd25e961cc797065f","affectsGlobalScope":true,"impliedFormat":1},{"version":"6d3261badeb7843d157ef3e6f5d1427d0eeb0af0cf9df84a62cfd29fd47ac86e","affectsGlobalScope":true,"impliedFormat":1},{"version":"195daca651dde22f2167ac0d0a05e215308119a3100f5e6268e8317d05a92526","affectsGlobalScope":true,"impliedFormat":1},{"version":"8b11e4285cd2bb164a4dc09248bdec69e9842517db4ca47c1ba913011e44ff2f","affectsGlobalScope":true,"impliedFormat":1},{"version":"0508571a52475e245b02bc50fa1394065a0a3d05277fbf5120c3784b85651799","affectsGlobalScope":true,"impliedFormat":1},{"version":"8f9af488f510c3015af3cc8c267a9e9d96c4dd38a1fdff0e11dc5a544711415b","affectsGlobalScope":true,"impliedFormat":1},{"version":"fc611fea8d30ea72c6bbfb599c9b4d393ce22e2f5bfef2172534781e7d138104","affectsGlobalScope":true,"impliedFormat":1},{"version":"1ce14b81c5cc821994aa8ec1d42b220dd41b27fcc06373bce3958af7421b77d4","affectsGlobalScope":true,"impliedFormat":1},{"version":"b3a048b3e9302ef9a34ef4ebb9aecfb28b66abb3bce577206a79fee559c230da","affectsGlobalScope":true,"impliedFormat":1},"89fe170d9a59f81cd9a9d95de3278f108ff91491810b2529cc0ffb502a57b6c0","0b4928041c807c01b33b1fa028236df635c52f7acff5a40f2c2d0d677b53428b","5ad2e5b8b17893d0eb1f11a1b6e8c03b17344be03a6a72a624cd38ab05fe4d5c","6a1e553079e654a1771463e9eeb98ea4f7bb4b6417a5237d4fdf9b546d49647f","7f11be86b9ac5c2cd5127cd9d40ccc7694c58868a3157692a153d452fc171525","6e3488ee1183ea915eb43f08aebc5f75e30be25aef1f678d1965324bdd7506e1","bc2f20caa6ccca429df0bf6a6f21506c4b00f9b171fdc3a4b6ada1775252db31","a318d8734523d9e750681e7b8e685ef817d4049c5612451f4e849da8b2b572a9","8b52dd8be86f44f871db89a6c1f77f7585688d53141ff55b6c5fac3eb67b1241","beae2d03867dde9fdf8da461c7e7e84da71612842422d4b482ab1c2a15fe6b12","080e7748d9754ccaea8debbc933552c7976c1ef588f9642a6f07e5a4d139d43b","51342c51a9090c0bc8bae60c5ec1a0f46d6d44db84392f12a8cd46e6d8a9f617","ae777307a0baeb9b5d7ba18e6a029a54eb0b612b1491591dcedb020cc8d36f97","d7ba738e316b7baed10ca49cc156b57b8c973b747bec6612e62a925e9f7f33a4","1d5292578fcf0329a43ef19fe2481d7d1cde75e75610019a7897c70dcfff0b31","459b3765e622008ed590474ae6b61ab55107a7b9529a28d05087a6fef51d7248","e1f11ad703121f97a74001059d054aba25c9c4662af44da05ead0a247fe18742","d9c64d02dfe3a9c74da35fdbcc645cf4e8d4ca0f4162ec312de51474103ac3a7","f4fbd89956010d9d27d3bbc562f0e5e00d374ba03a3f3bb11bcc94f5505bc3d2","8d6101c60d99ac57af23b947db35bedaa5580f2e7ae126c5b39841aa423cd242","28361b3472a80a6249aa6db3122c2ebe8a24be0310c071e64b79cd1cd3c2f297",{"version":"e6ab1909f187622ae669cf63724c9ea605a205b6722963f0c3c8128a1e6d6604","signature":"09dc81335309c1cbd4e76e059081d600202d1ee94f28f472f7e268bbe3038f3c"},{"version":"6a379a45f68b6512c078edc38dbe923bfa4602e913dde8a9ba2a82e2ea99b4b8","signature":"144f48de4a0e8e5edfa2401d214040eda94438dd1259a0df1a330cb5a50cedc9"},{"version":"50785ac8e17f7830df875aed608bcd406b617477c1a59f240405e0b113bacb94","signature":"e8238980485ff78002802ba1459cc9c3d535b4780d9e5fd93275b431ce22b976"},{"version":"7440f13da434317832dfc31f4a08277b2f4b1bddac770fdbf2833a678853ea68","signature":"7be5a6082d47bfc5a4734c782c9aec453bf59d10fc303841f21c6babcb2e61f2"},{"version":"4494b76dd2de2fe3496eff1c73f011b5b90f702ca50c89a584117686f306bc7b","signature":"fc304265d07f6f2f6375b9940342f00ac07310d129744314cc4e498fbde8a2cd"},{"version":"5c922107890068582021093ebb548c2c9c95e3fb76c68f02bdf4293410652828","signature":"fcc13b35d46376913754604f7b81009164b5622798324ca14a0faaeb88b302d9"},{"version":"827972af1602afdf6980f358beabe2434441e3b09783db6795a6a0b199d30aa7","signature":"d4dba6009e05b0c51e668d54ba8756d76a5c80c342a8e18f7adcde962c130a21"},{"version":"daaf595617f9e5d7315f958ba0f35127e94400033cf13564f7ed7fc467e667cc","signature":"a3a9d29a44d494ebcd48e3745a0cfb086ea2ec547372e8994ecd869f9b37c203"},{"version":"84cfde571cec4735a9f768e9f74cf9ff728fd8be13017c7acd127aa2a97904a8","signature":"853323635a5dab6bb009411a2af0c65a7126d18b3aafdb65591b1034311b0ad4"},{"version":"d2e5cfb2397ec8cacfd30de0e6f7992eb7db7b02cc83b7c43ef58bcd5aa88bc3","affectsGlobalScope":true,"impliedFormat":1}],"root":[[81,89]],"options":{"composite":true,"declaration":true,"declarationMap":true,"emitDeclarationOnly":true,"exactOptionalPropertyTypes":true,"module":99,"noFallthroughCasesInSwitch":true,"noImplicitOverride":true,"noImplicitReturns":true,"noUncheckedIndexedAccess":true,"noUnusedLocals":true,"noUnusedParameters":true,"outDir":"./","rootDir":"../src","skipLibCheck":true,"strict":true,"target":9,"tsBuildInfoFile":"./.tsbuildinfo","useDefineForClassFields":true,"verbatimModuleSyntax":true},"referencedMap":[[86,1],[81,2],[87,2],[84,3],[82,4],[89,5],[83,4],[85,2],[88,2],[79,6],[80,7],[63,8],[68,9],[64,10],[74,11],[76,6],[69,6],[77,12],[78,13],[66,14],[65,15],[72,16],[71,17],[75,18]],"latestChangedDtsFile":"./index.d.ts","version":"6.0.3"}

package/dist/adapter.d.ts

@@ -0,0 +1,9 @@
+import type { RequestDeviceOptions, Result, RhiAdapter, RhiDevice, RhiError as RhiErrorType } from '@forgeax/engine-rhi';
+/** Headless adapter. Holds an empty feature set + limits map; requestDevice
+ *  builds a fully-wired RhiNullDevice. */
+export declare class RhiNullAdapter implements RhiAdapter {
+    readonly features: ReadonlySet<GPUFeatureName>;
+    readonly limits: Readonly<Record<string, number>>;
+    requestDevice(_opts?: RequestDeviceOptions | undefined): Promise<Result<RhiDevice, RhiErrorType>>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,oBAAoB,EACpB,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,IAAI,YAAY,EACzB,MAAM,qBAAqB,CAAC;AAM7B;0CAC0C;AAC1C,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,CAAa;IAC3D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAM;IAIvD,aAAa,CACX,KAAK,CAAC,EAAE,oBAAoB,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;CAO5C"}

package/dist/bookkeeping.d.ts

@@ -0,0 +1,86 @@
+import type { Result, RhiError as RhiErrorType } from '@forgeax/engine-rhi';
+/**
+ * One ledger row for an issued opaque-handle brand.
+ *
+ * - `id` — per-device monotonic numeric id assigned at register time; the value
+ *   M3 assertions read back to pair create / destroy and count draws.
+ * - `kind` — the handle category (`'Buffer'` / `'Texture'` / `'BindGroupLayout'`
+ *   etc.); free-form so every create* entry can tag what it minted.
+ * - `destroyed` — flipped to `true` by the first destroy; a second destroy
+ *   fail-fasts via `'destroy-after-destroy'`.
+ * - `sourceDeviceId` — the id of the device that issued the handle; cross-device
+ *   use fail-fasts via `'rhi-not-available'`.
+ */
+export interface HandleRecord {
+    readonly id: number;
+    readonly kind: string;
+    destroyed: boolean;
+    readonly sourceDeviceId: number;
+}
+/**
+ * The brand attachment RhiNull stamps onto every issued handle object so the
+ * ledger can be recovered from the handle alone (handle-chain validation reads
+ * `handle[BOOKKEEPING_KEY]` rather than holding a side Map keyed on identity,
+ * which would leak across device instances).
+ *
+ * Lives behind a module-private symbol so it never collides with a real RHI
+ * brand symbol and never appears in the public `.d.ts` surface.
+ */
+export declare const BOOKKEEPING_KEY: unique symbol;
+/** A handle object as RhiNull mints it: a plain object carrying its ledger row
+ *  under the private bookkeeping symbol, cast to the relevant brand at the
+ *  create* call site. */
+export interface BookkeptHandle {
+    readonly [BOOKKEEPING_KEY]: HandleRecord;
+}
+/**
+ * Per-device handle ledger. One Bookkeeper instance lives on each
+ * RhiNullDevice; it assigns the device id at construction and mints monotonic
+ * handle ids thereafter.
+ */
+export declare class Bookkeeper {
+    readonly deviceId: number;
+    private nextHandleId;
+    private readonly records;
+    constructor(deviceId: number);
+    /**
+     * Register a freshly-minted handle of the given kind, returning a plain
+     * object that carries its ledger row. The caller casts the return value to
+     * the concrete brand (`as unknown as Buffer` etc.).
+     */
+    register(kind: string): BookkeptHandle;
+    /**
+     * Mark a handle destroyed. Fail-fasts on a second destroy
+     * ('destroy-after-destroy') or on a handle issued by a different device
+     * ('rhi-not-available'); otherwise flips the destroyed flag and returns ok.
+     */
+    destroy(handle: unknown): Result<void, RhiErrorType>;
+    /**
+     * Report whether a handle has already been destroyed (true once destroy()
+     * has flipped its flag). Used by command-stream methods that must not
+     * consume a stale handle.
+     */
+    isDestroyed(handle: unknown): boolean;
+    /**
+     * Validate that a handle was issued by THIS device. Returns the ledger row on
+     * success so callers can mutate it (e.g. flip destroyed); returns
+     * 'rhi-not-available' for a foreign handle (AC-09 — no silent pass).
+     */
+    validateOwnership(handle: unknown): Result<HandleRecord, RhiErrorType>;
+    /**
+     * Return all ledger rows as a readonly array. M3 unit tests (w17) read this
+     * to assert create/destroy pairing, BGL/PSO shape counts, and resource
+     * lifecycle coverage (AC-05/06/07). Returns a snapshot of the current Map
+     * so callers can iterate without a stale reference after further mutations.
+     */
+    allRecords(): readonly HandleRecord[];
+    /** Report the total number of records in the ledger. */
+    recordCount(): number;
+}
+/**
+ * Validation function: has this handle already been destroyed? Returns ok(void)
+ * for a live handle; returns 'destroy-after-destroy' for a handle whose ledger
+ * row is flagged destroyed (charter P3 fail-fast over silent idempotency).
+ */
+export declare function isHandleDestroyed(handle: unknown): Result<void, RhiErrorType>;
+//# sourceMappingURL=bookkeeping.d.ts.map

package/dist/bookkeeping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookkeeping.d.ts","sourceRoot":"","sources":["../src/bookkeeping.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAI5E;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,eAAyC,CAAC;AAEtE;;yBAEyB;AACzB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,YAAY,CAAC;CAC1C;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;gBAE/C,QAAQ,EAAE,MAAM;IAI5B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAYtC;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;IASpD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;IAIrC;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC;IActE;;;;;OAKG;IACH,UAAU,IAAI,SAAS,YAAY,EAAE;IAIrC,wDAAwD;IACxD,WAAW,IAAI,MAAM;CAGtB;AAUD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAW7E"}

package/dist/canvas-context.d.ts

@@ -0,0 +1,22 @@
+import type { CanvasConfiguration, Result, RhiCanvasContext, RhiError as RhiErrorType, Texture } from '@forgeax/engine-rhi';
+/**
+ * Headless canvas context. configure succeeds vacuously; getCurrentTexture
+ * mints a legal opaque-handle Texture brand so the swap-chain acquisition path
+ * never blocks frame rendering in headless CI.
+ */
+export declare class RhiNullCanvasContext implements RhiCanvasContext {
+    configure(_desc: CanvasConfiguration): Result<void, RhiErrorType>;
+    unconfigure(): void;
+    getConfiguration(): CanvasConfiguration | undefined;
+    getCurrentTexture(): Result<Texture, RhiErrorType>;
+}
+/**
+ * Acquire a canvas context. The headless backend returns ok(context) so the
+ * createRenderer context-acquisition step succeeds. The context's
+ * getCurrentTexture mints a legal Texture brand once a bookkeeper is attached.
+ *
+ * R-1: this is mounted on the rhi singleton so Channel 1's facade never
+ * crashes on a missing acquireCanvasContext.
+ */
+export declare function acquireCanvasContext(_canvas?: HTMLCanvasElement | OffscreenCanvas | null | undefined): Result<RhiCanvasContext, RhiErrorType>;
+//# sourceMappingURL=canvas-context.d.ts.map

package/dist/canvas-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-context.d.ts","sourceRoot":"","sources":["../src/canvas-context.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,mBAAmB,EACnB,MAAM,EACN,gBAAgB,EAChB,QAAQ,IAAI,YAAY,EACxB,OAAO,EACR,MAAM,qBAAqB,CAAC;AAG7B;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,SAAS,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;IAIjE,WAAW,IAAI,IAAI;IAEnB,gBAAgB,IAAI,mBAAmB,GAAG,SAAS;IAInD,iBAAiB,IAAI,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC;CAMnD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,iBAAiB,GAAG,eAAe,GAAG,IAAI,GAAG,SAAS,GAC/D,MAAM,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAExC"}

package/dist/command-encoder.d.ts

@@ -0,0 +1,27 @@
+import type { Buffer, CommandBuffer, ComputePassDescriptor, QuerySet, RenderPassDescriptor, Result, RhiCommandEncoder, RhiComputePassEncoder, RhiError as RhiErrorType, RhiRenderPassEncoder } from '@forgeax/engine-rhi';
+import type { Bookkeeper } from './bookkeeping';
+import type { RhiNullDevice } from './device';
+/**
+ * Headless command encoder. begin*Pass returns a no-op pass encoder bound to
+ * the issuing device's ledger; recording methods are no-ops; finish mints a
+ * CommandBuffer brand.
+ */
+export declare class RhiNullCommandEncoder implements RhiCommandEncoder {
+    private readonly bookkeeper;
+    private readonly counter;
+    constructor(bookkeeper: Bookkeeper, device: RhiNullDevice);
+    beginRenderPass(desc: RenderPassDescriptor): RhiRenderPassEncoder;
+    beginComputePass(desc?: ComputePassDescriptor | undefined): RhiComputePassEncoder;
+    copyBufferToBuffer(_source: Buffer, _sourceOffsetOrDestination: number | Buffer, _destinationOrSize?: Buffer | number | undefined, _destinationOffset?: number | undefined, _size?: number | undefined): void;
+    copyBufferToTexture(_source: GPUTexelCopyBufferInfo, _destination: GPUTexelCopyTextureInfo, _copySize: GPUExtent3DStrict): void;
+    copyTextureToBuffer(_source: GPUTexelCopyTextureInfo, _destination: GPUTexelCopyBufferInfo, _copySize: GPUExtent3DStrict): void;
+    copyTextureToTexture(_source: GPUTexelCopyTextureInfo, _destination: GPUTexelCopyTextureInfo, _copySize: GPUExtent3DStrict): void;
+    clearBuffer(_buffer: Buffer, _offset?: number | undefined, _size?: number | undefined): void;
+    resolveQuerySet(_querySet: QuerySet, _firstQuery: number, _queryCount: number, _destination: Buffer, _destinationOffset: number): Result<void, RhiErrorType>;
+    writeTimestamp(_querySet: QuerySet, _queryIndex: number): void;
+    pushDebugGroup(_groupLabel: string): void;
+    popDebugGroup(): void;
+    insertDebugMarker(_markerLabel: string): void;
+    finish(): Result<CommandBuffer, RhiErrorType>;
+}
+//# sourceMappingURL=command-encoder.d.ts.map

package/dist/command-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-encoder.d.ts","sourceRoot":"","sources":["../src/command-encoder.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,qBAAqB,EACrB,QAAQ,EACR,oBAAoB,EACpB,MAAM,EACN,iBAAiB,EACjB,qBAAqB,EACrB,QAAQ,IAAI,YAAY,EACxB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA2C9C;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa;IAKzD,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,oBAAoB;IAKjE,gBAAgB,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,SAAS,GAAG,qBAAqB;IAKjF,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,0BAA0B,EAAE,MAAM,GAAG,MAAM,EAC3C,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAChD,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,EACvC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GACzB,IAAI;IAEP,mBAAmB,CACjB,OAAO,EAAE,sBAAsB,EAC/B,YAAY,EAAE,uBAAuB,EACrC,SAAS,EAAE,iBAAiB,GAC3B,IAAI;IAEP,mBAAmB,CACjB,OAAO,EAAE,uBAAuB,EAChC,YAAY,EAAE,sBAAsB,EACpC,SAAS,EAAE,iBAAiB,GAC3B,IAAI;IAEP,oBAAoB,CAClB,OAAO,EAAE,uBAAuB,EAChC,YAAY,EAAE,uBAAuB,EACrC,SAAS,EAAE,iBAAiB,GAC3B,IAAI;IAEP,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAE5F,eAAe,CACb,SAAS,EAAE,QAAQ,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;IAI7B,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAE9D,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAEzC,aAAa,IAAI,IAAI;IAErB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAE7C,MAAM,IAAI,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC;CAG9C"}

package/dist/device.d.ts

@@ -0,0 +1,67 @@
+import type { BindGroup, BindGroupDescriptor, BindGroupLayout, BindGroupLayoutDescriptor, Buffer, BufferDescriptor, CommandEncoderDescriptor, ComputePipeline, ComputePipelineDescriptor, PipelineLayout, PipelineLayoutDescriptor, QuerySet, QuerySetDescriptor, RenderPipeline, RenderPipelineDescriptor, Result, RhiCaps, RhiCommandEncoder, RhiDevice, RhiError as RhiErrorType, RhiFeatures, RhiLimits, RhiQueue, Sampler, SamplerDescriptor, Texture, TextureDescriptor, TextureView, TextureViewDescriptor } from '@forgeax/engine-rhi';
+import { Bookkeeper } from './bookkeeping';
+/**
+ * Factory that builds a command encoder bound to a device's ledger. Injected at
+ * device construction (rather than imported here) so device.ts carries no
+ * dependency on command-encoder.ts; the singleton assembly (index.ts) supplies
+ * the real factory. The Bookkeeper and RhiNullDevice are passed so the encoder
+ * threads draw / dispatch counts + binding validation through the same per-device
+ * ledger AND writes aggregated frame stats to the device for M3 unit-test readback.
+ */
+export type CommandEncoderFactory = (bookkeeper: Bookkeeper, device: RhiNullDevice) => RhiCommandEncoder;
+/**
+ * Headless no-op RhiDevice. Every create* mints a legal brand and records it;
+ * every destroy* fail-fasts a double-destroy; caps reports the all-true-except-
+ * reserved profile (D-5).
+ */
+export declare class RhiNullDevice implements RhiDevice {
+    private readonly internalBookkeeper;
+    private readonly nullQueue;
+    private readonly encoderFactory;
+    /** Per-frame total draw count across all pass encoders executed this frame
+     *  (aggregated by the command encoder on finish, then reset). M3 unit tests
+     *  (w17) read this to assert draw count >= 1 (AC-06). */
+    totalDrawCount: number;
+    /** Per-frame total direct and indirect compute dispatch count. */
+    totalDispatchCount: number;
+    /** Per-frame total bind group set count (AC-06 / AC-05 readback). */
+    totalBindGroupCount: number;
+    /** Per-frame pass names executed this frame, in schedule order (AC-04). */
+    framePassNames: string[];
+    /** The per-device handle ledger — exposed so M3 tests can assert create/destroy
+     *  pairing and BGL/PSO shape counts (AC-05/06/07). */
+    get bookkeeper(): Bookkeeper;
+    constructor(queue: RhiQueue, encoderFactory: CommandEncoderFactory);
+    get caps(): RhiCaps;
+    get features(): RhiFeatures;
+    get limits(): RhiLimits;
+    get queue(): RhiQueue;
+    get lost(): Promise<{
+        readonly reason: 'destroyed' | 'unknown';
+        readonly message: string;
+    }>;
+    createBuffer(_desc: BufferDescriptor): Result<Buffer, RhiErrorType>;
+    createTexture(_desc: TextureDescriptor): Result<Texture, RhiErrorType>;
+    destroyBuffer(buf: Buffer): Result<void, RhiErrorType>;
+    destroyQuerySet(querySet: QuerySet): Result<void, RhiErrorType>;
+    destroyTexture(tex: Texture): Result<void, RhiErrorType>;
+    createTextureView(_texture: Texture, _desc: TextureViewDescriptor): Result<TextureView, RhiErrorType>;
+    createSampler(_desc?: SamplerDescriptor | undefined): Result<Sampler, RhiErrorType>;
+    createBindGroupLayout(_desc: BindGroupLayoutDescriptor): Result<BindGroupLayout, RhiErrorType>;
+    createBindGroup(_desc: BindGroupDescriptor): Result<BindGroup, RhiErrorType>;
+    createPipelineLayout(_desc: PipelineLayoutDescriptor): Result<PipelineLayout, RhiErrorType>;
+    createRenderPipeline(_desc: RenderPipelineDescriptor): Result<RenderPipeline, RhiErrorType>;
+    createComputePipeline(_desc: ComputePipelineDescriptor): Result<ComputePipeline, RhiErrorType>;
+    createQuerySet(desc: QuerySetDescriptor): Result<QuerySet, RhiErrorType>;
+    createCommandEncoder(_desc?: CommandEncoderDescriptor | undefined): Result<RhiCommandEncoder, RhiErrorType>;
+    /**
+     * Mint a pipeline handle whose object also carries the no-op
+     * `getBindGroupLayout(index)` ops method (D-2). The prod auto-layout path
+     * (debug-draw.ts) and the existing mock unit tests both call
+     * `pipeline.getBindGroupLayout(n)`; returning a legal BindGroupLayout brand
+     * (recorded in the ledger) keeps those consumers from crashing on a missing
+     * method.
+     */
+    private makePipeline;
+}
+//# sourceMappingURL=device.d.ts.map

package/dist/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,yBAAyB,EACzB,MAAM,EACN,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,QAAQ,EACR,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,MAAM,EACN,OAAO,EACP,iBAAiB,EAEjB,SAAS,EACT,QAAQ,IAAI,YAAY,EACxB,WAAW,EACX,SAAS,EACT,QAAQ,EAER,OAAO,EACP,iBAAiB,EACjB,OAAO,EACP,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,aAAa,KAClB,iBAAiB,CAAC;AAOvB;;;;GAIG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IAEvD;;6DAEyD;IACzD,cAAc,SAAK;IACnB,kEAAkE;IAClE,kBAAkB,SAAK;IACvB,qEAAqE;IACrE,mBAAmB,SAAK;IACxB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,EAAE,CAAM;IAE9B;0DACsD;IACtD,IAAI,UAAU,IAAI,UAAU,CAE3B;gBAEW,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,qBAAqB;IAMlE,IAAI,IAAI,IAAI,OAAO,CAwBlB;IAED,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAED,IAAI,MAAM,IAAI,SAAS,CAEtB;IAED,IAAI,KAAK,IAAI,QAAQ,CAEpB;IAMD,IAAI,IAAI,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAE1F;IAED,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAInE,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC;IAItE,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;IAItD,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;IAI/D,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;IAIxD,iBAAiB,CACf,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,qBAAqB,GAC3B,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC;IAIpC,aAAa,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC;IAInF,qBAAqB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;IAI9F,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC;IAI5E,oBAAoB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAAC,cAAc,EAAE,YAAY,CAAC;IAI3F,oBAAoB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAAC,cAAc,EAAE,YAAY,CAAC;IAI3F,qBAAqB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;IAI9F,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC;IAaxE,oBAAoB,CAClB,KAAK,CAAC,EAAE,wBAAwB,GAAG,SAAS,GAC3C,MAAM,CAAC,iBAAiB,EAAE,YAAY,CAAC;IAI1C;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;CAMrB"}