@forgeax/engine-rhi-webgpu 0.1.2

package/dist/__tests__/__mocks__/gpu-device.d.ts

@@ -0,0 +1,233 @@
+/** Failure-injection switches consumed by the device path tests. */
+export interface MockFailures {
+    /** `requestAdapter` returns null (research F-5 single null channel). */
+    adapterNull?: boolean;
+    /** `requestDevice` rejects with `OperationError` (spec behaviour for an
+     *  unsupported feature). */
+    requestDeviceFeatureNotEnabled?: boolean;
+    /** `requestDevice` rejects with `OperationError` (spec behaviour for an
+     *  out-of-range limit). */
+    requestDeviceLimitExceeded?: boolean;
+    /** `createShaderModule` returns a module whose `getCompilationInfo()`
+     *  yields error-typed messages. */
+    shaderCompileMessages?: readonly GPUCompilationMessage[];
+    /** `createShaderModule` returns a module whose `getCompilationInfo()`
+     *  rejects — models the GPU instance being dropped mid-await (device
+     *  destroyed / page teardown while the async query is in flight). */
+    getCompilationInfoRejects?: boolean;
+    /** `createRenderPipeline` throws synchronously with this message. */
+    renderPipelineError?: string;
+}
+/** Mock-capture event union; consumed by passthrough assertions. */
+export type MockCapture = {
+    kind: 'requestAdapter';
+    options: GPURequestAdapterOptions | undefined;
+} | {
+    kind: 'requestDevice';
+    options: GPUDeviceDescriptor | undefined;
+} | {
+    kind: 'writeBuffer';
+    buffer: MockBuffer;
+    bufferOffset: number;
+    data: ArrayBufferView | ArrayBuffer;
+    dataOffset: number | undefined;
+    size: number | undefined;
+} | {
+    kind: 'createBuffer';
+    descriptor: GPUBufferDescriptor;
+} | {
+    kind: 'createTexture';
+    descriptor: GPUTextureDescriptor;
+} | {
+    kind: 'createSampler';
+    descriptor: GPUSamplerDescriptor | undefined;
+} | {
+    kind: 'createBindGroupLayout';
+    descriptor: GPUBindGroupLayoutDescriptor;
+} | {
+    kind: 'createBindGroup';
+    descriptor: GPUBindGroupDescriptor;
+} | {
+    kind: 'createPipelineLayout';
+    descriptor: GPUPipelineLayoutDescriptor;
+} | {
+    kind: 'createRenderPipeline';
+    descriptor: GPURenderPipelineDescriptor;
+} | {
+    kind: 'createShaderModule';
+    descriptor: GPUShaderModuleDescriptor;
+} | {
+    kind: 'createTextureView';
+    sourceDescriptor: GPUTextureDescriptor;
+    descriptor: GPUTextureViewDescriptor | undefined;
+} | {
+    kind: 'createComputePipeline';
+    descriptor: GPUComputePipelineDescriptor;
+} | {
+    kind: 'createQuerySet';
+    descriptor: GPUQuerySetDescriptor;
+};
+/** Unique brand symbol so captured handles cannot be confused with real GPU* objects. */
+declare const MOCK_BRAND: unique symbol;
+/**
+ * Mock texture handle: exposes spec readonly fields the shim consumes for
+ * createTextureView cross-resource validation (research §1.1: format must be
+ * in source.format ∪ source.viewFormats; usage must be a subset of
+ * source.usage). The shim retrieves these via its own WeakMap (filled at
+ * createTexture time), but the mock surfaces createView so the shim can
+ * forward and capture descriptors verbatim.
+ */
+export interface MockTexture {
+    readonly [MOCK_BRAND]: 'texture';
+    readonly format: GPUTextureFormat;
+    readonly usage: GPUTextureUsageFlags;
+    readonly viewFormats: readonly GPUTextureFormat[];
+    createView(descriptor?: GPUTextureViewDescriptor | undefined): MockTextureView;
+}
+/** Mock texture view handle. */
+export interface MockTextureView {
+    readonly [MOCK_BRAND]: 'texture-view';
+}
+/** Mock device exposed subset (covers only the surface the shim uses). */
+export interface MockDevice {
+    readonly features: GPUSupportedFeatures;
+    readonly limits: GPUSupportedLimits;
+    readonly lost: Promise<GPUDeviceLostInfo>;
+    readonly queue: MockQueue;
+    createBuffer(descriptor: GPUBufferDescriptor): MockBuffer;
+    createTexture(descriptor: GPUTextureDescriptor): MockTexture;
+    createSampler(descriptor?: GPUSamplerDescriptor | undefined): {
+        readonly [MOCK_BRAND]: 'sampler';
+    };
+    createBindGroupLayout(descriptor: GPUBindGroupLayoutDescriptor): {
+        readonly [MOCK_BRAND]: 'bgl';
+    };
+    createBindGroup(descriptor: GPUBindGroupDescriptor): {
+        readonly [MOCK_BRAND]: 'bg';
+    };
+    createPipelineLayout(descriptor: GPUPipelineLayoutDescriptor): {
+        readonly [MOCK_BRAND]: 'pl';
+    };
+    createRenderPipeline(descriptor: GPURenderPipelineDescriptor): {
+        readonly [MOCK_BRAND]: 'render-pipeline';
+    };
+    createComputePipeline(descriptor: GPUComputePipelineDescriptor): {
+        readonly [MOCK_BRAND]: 'compute-pipeline';
+    };
+    createQuerySet(descriptor: GPUQuerySetDescriptor): {
+        readonly [MOCK_BRAND]: 'query-set';
+    };
+    createShaderModule(descriptor: GPUShaderModuleDescriptor): {
+        readonly [MOCK_BRAND]: 'shader';
+        getCompilationInfo(): Promise<GPUCompilationInfo>;
+    };
+    createCommandEncoder(descriptor?: GPUCommandEncoderDescriptor | undefined): MockCommandEncoder;
+}
+/** Mock queue: tracks submit / writeBuffer for assertions; M5 / w37 adds
+ *  writeTexture / copyExternalImageToTexture / onSubmittedWorkDone. */
+export interface MockQueue {
+    readonly [MOCK_BRAND]: 'queue';
+    submit(commandBuffers: Iterable<MockCommandBuffer>): void;
+    writeBuffer(buffer: MockBuffer, bufferOffset: number, data: ArrayBufferView | ArrayBuffer, dataOffset?: number, size?: number): void;
+    writeTexture(destination: unknown, data: ArrayBufferView | ArrayBuffer, dataLayout: unknown, size: unknown): void;
+    copyExternalImageToTexture(source: unknown, destination: unknown, copySize: unknown): void;
+    onSubmittedWorkDone(): Promise<undefined>;
+}
+/** Mock buffer; carries `size` so writeBuffer bounds-checking has a value.
+ *  Extended in M5 / w35 with mapping surface (mapAsync / getMappedRange /
+ *  unmap / mapState) so the shim Buffer wrapper can drive the validation
+ *  paths (research §4.1 / §4.2 / §4.4). */
+export interface MockBuffer {
+    readonly [MOCK_BRAND]: 'buffer';
+    readonly size: number;
+    mapState: 'unmapped' | 'pending' | 'mapped';
+    mapAsync(mode: number, offset?: number, size?: number): Promise<void>;
+    getMappedRange(offset?: number, size?: number): ArrayBuffer;
+    unmap(): void;
+}
+/** Mock command encoder: returned by device.createCommandEncoder. */
+export interface MockCommandEncoder {
+    readonly [MOCK_BRAND]: 'command-encoder';
+    beginRenderPass(descriptor: GPURenderPassDescriptor): MockRenderPassEncoder;
+    beginComputePass(descriptor?: GPUComputePassDescriptor): MockComputePassEncoder;
+    copyBufferToBuffer(...args: unknown[]): void;
+    copyBufferToTexture(source: unknown, destination: unknown, copySize: unknown): void;
+    copyTextureToBuffer(source: unknown, destination: unknown, copySize: unknown): void;
+    copyTextureToTexture(source: unknown, destination: unknown, copySize: unknown): void;
+    clearBuffer(buffer: MockBuffer, offset?: number, size?: number): void;
+    resolveQuerySet(...args: unknown[]): void;
+    pushDebugGroup(label: string): void;
+    popDebugGroup(): void;
+    insertDebugMarker(label: string): void;
+    finish(descriptor?: GPUCommandBufferDescriptor): MockCommandBuffer;
+}
+/** Mock render pass encoder. */
+export interface MockRenderPassEncoder {
+    readonly [MOCK_BRAND]: 'render-pass-encoder';
+    setPipeline(pipeline: unknown): void;
+    setBindGroup(...args: unknown[]): void;
+    setIndexBuffer(...args: unknown[]): void;
+    setVertexBuffer(...args: unknown[]): void;
+    draw(...args: unknown[]): void;
+    drawIndexed(...args: unknown[]): void;
+    drawIndirect(...args: unknown[]): void;
+    drawIndexedIndirect(...args: unknown[]): void;
+    setViewport(...args: unknown[]): void;
+    setScissorRect(...args: unknown[]): void;
+    setBlendConstant(...args: unknown[]): void;
+    setStencilReference(...args: unknown[]): void;
+    pushDebugGroup(label: string): void;
+    popDebugGroup(): void;
+    insertDebugMarker(label: string): void;
+    end(): void;
+}
+/** Mock compute pass encoder. */
+export interface MockComputePassEncoder {
+    readonly [MOCK_BRAND]: 'compute-pass-encoder';
+    setPipeline(pipeline: unknown): void;
+    setBindGroup(...args: unknown[]): void;
+    dispatchWorkgroups(...args: unknown[]): void;
+    dispatchWorkgroupsIndirect(...args: unknown[]): void;
+    end(): void;
+}
+/** Mock command buffer (returned by encoder.finish). */
+export interface MockCommandBuffer {
+    readonly [MOCK_BRAND]: 'command-buffer';
+}
+/**
+ * Minimal mock `GPU` provider injected via the shim's `gpu?: GPU` provider
+ * seam (research F-6 webgpu-utils + CTS consensus).
+ *
+ * `__captured` / `__failures` are observation points exclusive to the test
+ * side; the shim does not read them.
+ */
+export interface MockGpu {
+    /** Test observation: createX / requestX call-site descriptors in order. */
+    readonly __captured: MockCapture[];
+    /** Failure-injection switches for the test side. */
+    readonly __failures: MockFailures;
+    requestAdapter(options?: GPURequestAdapterOptions | undefined): Promise<MockAdapter | null>;
+}
+/** Mock adapter subset. */
+export interface MockAdapter {
+    readonly features: GPUSupportedFeatures;
+    readonly limits: GPUSupportedLimits;
+    requestDevice(descriptor?: GPUDeviceDescriptor | undefined): Promise<MockDevice>;
+}
+/**
+ * Create a MockGpu test entry point.
+ *
+ * @example
+ *   const gpu = createMockGpu();
+ *   gpu.__failures.adapterNull = true;
+ *   const r = await rhiWebgpu.requestDevice({ gpu });
+ *   expect(r.ok).toBe(false);
+ */
+export declare function createMockGpu(failures?: MockFailures): MockGpu;
+/**
+ * Build a 6-field GPUCompilationMessage (OQ-P2 locked field set).
+ * Used by shader-compile-failed path tests asserting detail.compilerMessages.
+ */
+export declare function makeShaderError(partial?: Partial<GPUCompilationMessage>): GPUCompilationMessage;
+export {};
+//# sourceMappingURL=gpu-device.d.ts.map

package/dist/__tests__/__mocks__/gpu-device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-device.d.ts","sourceRoot":"","sources":["../../../src/__tests__/__mocks__/gpu-device.ts"],"names":[],"mappings":"AA6BA,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;gCAC4B;IAC5B,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC;+BAC2B;IAC3B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;uCACmC;IACnC,qBAAqB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACzD;;yEAEqE;IACrE,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,oEAAoE;AACpE,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,wBAAwB,GAAG,SAAS,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAAA;CAAE,GACnE;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,GACD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,mBAAmB,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,oBAAoB,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,UAAU,EAAE,4BAA4B,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,UAAU,EAAE,sBAAsB,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,UAAU,EAAE,2BAA2B,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,UAAU,EAAE,2BAA2B,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,yBAAyB,CAAA;CAAE,GACrE;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,UAAU,EAAE,wBAAwB,GAAG,SAAS,CAAC;CAClD,GACD;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,UAAU,EAAE,4BAA4B,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAElE,yFAAyF;AACzF,QAAA,MAAM,UAAU,EAAE,OAAO,MAAkC,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,UAAU,CAAC,UAAU,CAAC,EAAE,wBAAwB,GAAG,SAAS,GAAG,eAAe,CAAC;CAChF;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;CACvC;AAED,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,YAAY,CAAC,UAAU,EAAE,mBAAmB,GAAG,UAAU,CAAC;IAC1D,aAAa,CAAC,UAAU,EAAE,oBAAoB,GAAG,WAAW,CAAC;IAC7D,aAAa,CAAC,UAAU,CAAC,EAAE,oBAAoB,GAAG,SAAS,GAAG;QAC5D,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;KAClC,CAAC;IACF,qBAAqB,CAAC,UAAU,EAAE,4BAA4B,GAAG;QAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC;IAClG,eAAe,CAAC,UAAU,EAAE,sBAAsB,GAAG;QAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAA;KAAE,CAAC;IACrF,oBAAoB,CAAC,UAAU,EAAE,2BAA2B,GAAG;QAC7D,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;KAC7B,CAAC;IACF,oBAAoB,CAAC,UAAU,EAAE,2BAA2B,GAAG;QAC7D,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;KAC1C,CAAC;IACF,qBAAqB,CAAC,UAAU,EAAE,4BAA4B,GAAG;QAC/D,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;KAC3C,CAAC;IACF,cAAc,CAAC,UAAU,EAAE,qBAAqB,GAAG;QACjD,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;KACpC,CAAC;IACF,kBAAkB,CAAC,UAAU,EAAE,yBAAyB,GAAG;QACzD,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;QAChC,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;KACnD,CAAC;IACF,oBAAoB,CAAC,UAAU,CAAC,EAAE,2BAA2B,GAAG,SAAS,GAAG,kBAAkB,CAAC;CAChG;AAED;uEACuE;AACvE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAC1D,WAAW,CACT,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,eAAe,GAAG,WAAW,EACnC,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAAC;IACR,YAAY,CACV,WAAW,EAAE,OAAO,EACpB,IAAI,EAAE,eAAe,GAAG,WAAW,EACnC,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,OAAO,GACZ,IAAI,CAAC;IACR,0BAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3F,mBAAmB,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;CAC3C;AAED;;;2CAG2C;AAC3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5D,KAAK,IAAI,IAAI,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACzC,eAAe,CAAC,UAAU,EAAE,uBAAuB,GAAG,qBAAqB,CAAC;IAC5E,gBAAgB,CAAC,UAAU,CAAC,EAAE,wBAAwB,GAAG,sBAAsB,CAAC;IAChF,kBAAkB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7C,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACpF,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACpF,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACrF,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtE,eAAe,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC1C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,aAAa,IAAI,IAAI,CAAC;IACtB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,UAAU,CAAC,EAAE,0BAA0B,GAAG,iBAAiB,CAAC;CACpE;AAED,gCAAgC;AAChC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IAC7C,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC,YAAY,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACvC,cAAc,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACzC,eAAe,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC1C,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,WAAW,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACtC,YAAY,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACvC,mBAAmB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACtC,cAAc,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACzC,gBAAgB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC3C,mBAAmB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,aAAa,IAAI,IAAI,CAAC;IACtB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,GAAG,IAAI,IAAI,CAAC;CACb;AAED,iCAAiC;AACjC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,sBAAsB,CAAC;IAC9C,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC,YAAY,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACvC,kBAAkB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7C,0BAA0B,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACrD,GAAG,IAAI,IAAI,CAAC;CACb;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACzC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,cAAc,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC7F;AAED,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,aAAa,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAClF;AAsQD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,GAAE,YAAiB,GAAG,OAAO,CA6BlE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,OAAO,CAAC,qBAAqB,CAAM,GAC3C,qBAAqB,CAavB"}

package/dist/__tests__/dawn-real-gpu.dawn.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dawn-real-gpu.dawn.test.d.ts.map

package/dist/__tests__/dawn-real-gpu.dawn.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dawn-real-gpu.dawn.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dawn-real-gpu.dawn.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/queue-write-range.browser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-write-range.browser.test.d.ts.map

package/dist/__tests__/queue-write-range.browser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-write-range.browser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/queue-write-range.browser.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/rgba16float-live-probe.browser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rgba16float-live-probe.browser.test.d.ts.map

package/dist/__tests__/rgba16float-live-probe.browser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgba16float-live-probe.browser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/rgba16float-live-probe.browser.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/rgba16float-live-probe.d.ts

@@ -0,0 +1,12 @@
+import { type Rgba16floatRenderTargetProbe } from '@forgeax/engine-rhi';
+export interface Rgba16floatLiveProbeEvidence {
+    readonly backend: string;
+    readonly initial: Rgba16floatRenderTargetProbe;
+    readonly loss: {
+        readonly reason: 'destroyed' | 'unknown';
+        readonly message: string;
+    };
+    readonly recovered: Rgba16floatRenderTargetProbe;
+}
+export declare function runRgba16floatLiveProbe(): Promise<Rgba16floatLiveProbeEvidence>;
+//# sourceMappingURL=rgba16float-live-probe.d.ts.map

package/dist/__tests__/rgba16float-live-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgba16float-live-probe.d.ts","sourceRoot":"","sources":["../../src/__tests__/rgba16float-live-probe.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtF,QAAQ,CAAC,SAAS,EAAE,4BAA4B,CAAC;CAClD;AAgBD,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAerF"}

package/dist/__tests__/rgba16float-live-probe.dawn.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rgba16float-live-probe.dawn.test.d.ts.map

package/dist/__tests__/rgba16float-live-probe.dawn.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgba16float-live-probe.dawn.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/rgba16float-live-probe.dawn.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/rhi-webgpu.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rhi-webgpu.unit.test.d.ts.map

package/dist/__tests__/rhi-webgpu.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rhi-webgpu.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/rhi-webgpu.unit.test.ts"],"names":[],"mappings":""}

package/dist/device.d.ts

@@ -0,0 +1,62 @@
+import type { RhiCanvasContext, RhiDevice } from '@forgeax/engine-rhi';
+/**
+ * Get the underlying GPUDevice associated with a RhiDevice.
+ *
+ * @internal
+ *
+ * Single-point escape hatch (D-S1 / feat-20260508-rhi-surface-completion).
+ * The `_internal_` prefix + `@internal` JSDoc tag mark this as engine-internal
+ * plumbing; the only sanctioned consumer is
+ * `apps/hello/triangle/src/main.ts:96` which threads the raw GPUDevice into
+ * `RendererOptions.rawDeviceForContextConfigure` so the canvas
+ * `GPUCanvasContext.configure({device})` slot keeps working
+ * (GPUCanvasContext is outside the RHI surface). Every other engine path
+ * goes through the RHI interface.
+ *
+ * Future: deprecated once `feat-future-rhi-adapter-surface` lands a
+ * `RhiCanvasContext` abstraction; this function will be removed at that
+ * closure. AC-08 grep gate keeps further callers out via word-boundary
+ * `\bgetRawDevice\b` allow-list (see apps/hello/triangle/scripts/ac-08-grep-gate.mjs).
+ */
+export declare function _internal_getRawDevice(device: RhiDevice): GPUDevice | undefined;
+/**
+ * Construct a RhiDevice shim wrapping GPUDevice.
+ *
+ * Does not cache or reclassify device.lost (single-source subscription +
+ * dual-form fan-out is the engine layer's job; this package only exposes the
+ * spec Promise). See plan-strategy 3 R2 mitigation.
+ */
+export declare function makeRhiDevice(rawDevice: GPUDevice): {
+    device: RhiDevice;
+    /** Exposed for createShaderModule and other shim entry points that need to
+     *  bypass the createX Result wrapper. */
+    raw: GPUDevice;
+};
+/** Stripped-down GPUCanvasContext shape the shim consumes. Real
+ *  GPUCanvasContext satisfies this; the unit-test mock fixture only
+ *  implements what is needed (charter proposition 1: progressive disclosure). */
+export interface GpuCanvasContextLike {
+    configure(configuration: GPUCanvasConfiguration): void;
+    unconfigure(): void;
+    getConfiguration(): GPUCanvasConfiguration | null;
+    getCurrentTexture(): GPUTexture;
+}
+/**
+ * Build a RhiCanvasContext shim around a raw GPUCanvasContext (M3 / K-4 /
+ * w21).
+ *
+ * Pre-configure validation (research §3.3 mapping):
+ *   - format gate: format must be in SUPPORTED_CONTEXT_FORMATS; otherwise
+ *     fast-path returns `'webgpu-runtime-error'` with the spec-aligned
+ *     `.expected` literal `'one of bgra8unorm/rgba8unorm/rgba16float'`.
+ *
+ * Post-configure semantics:
+ *   - getCurrentTexture forwards each call to the raw context (NO cross-frame
+ *     caching, research §3.3 [[Expire the current texture]]); spec
+ *     InvalidStateError catches map to `'webgpu-runtime-error'`.
+ *   - getConfiguration projects the spec record verbatim; missing fields
+ *     remain missing (feature-detection idiom, research §3.2 toneMapping
+ *     NOTE).
+ */
+export declare function makeCanvasContext(rawContext: GpuCanvasContextLike): RhiCanvasContext;
+//# 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":"AA6BA,OAAO,KAAK,EAqBV,gBAAgB,EAIhB,SAAS,EAYV,MAAM,qBAAqB,CAAC;AAsM7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAE/E;AAijCD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG;IACnD,MAAM,EAAE,SAAS,CAAC;IAClB;6CACyC;IACzC,GAAG,EAAE,SAAS,CAAC;CAChB,CAicA;AA0BD;;iFAEiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,aAAa,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACvD,WAAW,IAAI,IAAI,CAAC;IACpB,gBAAgB,IAAI,sBAAsB,GAAG,IAAI,CAAC;IAClD,iBAAiB,IAAI,UAAU,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,oBAAoB,GAAG,gBAAgB,CAqGpF"}

package/dist/errors.d.ts

@@ -0,0 +1,47 @@
+import { type Result, RhiError } from '@forgeax/engine-rhi';
+/** adapter null path (research F-5 single null channel). */
+export declare function adapterUnavailable(): Result<never, RhiError>;
+/** feature not enabled path (boundary cases / requirements). */
+export declare function featureNotEnabled(featureName?: string | undefined): Result<never, RhiError>;
+/** limit exceeded path (boundary cases / requirements). */
+export declare function limitExceeded(limitName?: string | undefined): Result<never, RhiError>;
+/** shader compile failed path + detail.compilerMessages forwarding (OQ-P2 6 fields). */
+export declare function shaderCompileFailed(compilerMessages: readonly GPUCompilationMessage[]): Result<never, RhiError>;
+/**
+ * Command encoder reused after finish() (W3C WebGPU 22 GPUCommandEncoder lifecycle).
+ *
+ * Trigger: encoder.beginRenderPass / copyXxx / finish called after a prior finish().
+ * Distinct from 'rhi-not-available': this is a real-path validation failure,
+ * not a placeholder for unimplemented surface (plan-strategy D-S3 template 1).
+ */
+export declare function commandEncoderFinished(): Result<never, RhiError>;
+/**
+ * Render pass not ended before next pass / finish (W3C WebGPU 22.7 Render pass).
+ *
+ * Trigger: encoder.beginRenderPass while previous pass active, or encoder.finish
+ * with active pass still recording (plan-strategy D-S3 template 2).
+ */
+export declare function renderPassNotEnded(): Result<never, RhiError>;
+/**
+ * Queue.submit real-path failure (W3C WebGPU 23 Queue).
+ *
+ * Trigger: submit([cb]) with destroyed buffer/pipeline references, or GPU validation
+ * error fan-out via onuncapturederror. Explicitly distinct from 'rhi-not-available'
+ * (device-lost subclass) - submit-failed signals dynamic resource life-cycle issues
+ * the AI user can self-recover from (plan-strategy D-S3 template 3).
+ */
+export declare function queueSubmitFailed(detailMessage?: string | undefined): Result<never, RhiError>;
+/**
+ * Queue.writeBuffer offset/size out of bounds (W3C WebGPU 23.2 writeBuffer).
+ *
+ * Trigger: writeBuffer(buf, offset, data) where offset is not 4-byte aligned, or
+ * offset + data.byteLength exceeds buffer.size. Distinct from 'limit-exceeded'
+ * (static device.limits) - out-of-bounds is a dynamic per-buffer boundary
+ * (plan-strategy D-S3 template 4).
+ */
+export declare function queueWriteBufferOutOfBounds(args: {
+    offset: number;
+    byteLength: number;
+    bufferSize: number;
+}): Result<never, RhiError>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAYA,OAAO,EAAO,KAAK,MAAM,EAAE,QAAQ,EAA+B,MAAM,qBAAqB,CAAC;AAE9F,4DAA4D;AAC5D,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAQ5D;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAS3F;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CASrF;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,SAAS,qBAAqB,EAAE,GACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAUzB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAQhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAS5D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAe7F;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAS1B"}

package/dist/index.d.ts

@@ -0,0 +1,183 @@
+import type { RequestAdapterOptions, Result, RhiAdapter, RhiCanvasContext, RhiDevice, RhiError, RhiInstance, ShaderModule } from '@forgeax/engine-rhi';
+/**
+ * The `GPU` subset accepted at the provider seam (research §F-6 webgpu-utils +
+ * CTS consensus).
+ *
+ * The shim only calls the two entries `gpu.requestAdapter()` →
+ * `adapter.requestDevice()`; accepting a structural subset rather than requiring
+ * a full GPU interface implementation lets the mock fixture
+ * (src/__tests__/__mocks__/gpu-device.ts) skip implementing
+ * `wgslLanguageFeatures` / `getPreferredCanvasFormat` and other fields this loop
+ * does not consume (charter proposition 1: progressive disclosure).
+ */
+export interface GpuLike {
+    requestAdapter(options?: GPURequestAdapterOptions | undefined): Promise<GpuAdapterLike | null>;
+}
+/** The `GPUAdapter` subset accepted at the provider seam — only the `requestDevice` entry is consumed. */
+export interface GpuAdapterLike {
+    requestDevice(descriptor?: GPUDeviceDescriptor | undefined): Promise<GpuDeviceLike>;
+}
+/**
+ * The `GPUDevice` subset accepted at the provider seam — exactly the fields the
+ * shim actually touches (the 5 descriptor `createX` calls + features / limits /
+ * lost + a `queue` placeholder).
+ *
+ * Differences from the full GPUDevice spec:
+ * - `onuncapturederror` / `pushErrorScope` / `createCommandEncoder` not required
+ *   (only needed at M3).
+ * - `wgslLanguageFeatures` / `getPreferredCanvasFormat` not required (charter
+ *   proposition 1: progressive disclosure).
+ *
+ * The coverage of `cast as GPUDevice` inside `makeRhiDevice` matches this
+ * interface exactly; both the mock and the real GPUDevice only need to satisfy
+ * this structural subset.
+ */
+export interface GpuDeviceLike {
+    readonly features: GPUSupportedFeatures;
+    readonly limits: GPUSupportedLimits;
+    readonly lost: Promise<GPUDeviceLostInfo>;
+    readonly queue: unknown;
+    createBuffer(descriptor: GPUBufferDescriptor): unknown;
+    createTexture(descriptor: GPUTextureDescriptor): unknown;
+    createSampler(descriptor?: GPUSamplerDescriptor | undefined): unknown;
+    createBindGroupLayout(descriptor: GPUBindGroupLayoutDescriptor): unknown;
+    createBindGroup(descriptor: GPUBindGroupDescriptor): unknown;
+    createPipelineLayout(descriptor: GPUPipelineLayoutDescriptor): unknown;
+    createRenderPipeline(descriptor: GPURenderPipelineDescriptor): unknown;
+    createShaderModule(descriptor: GPUShaderModuleDescriptor): unknown;
+}
+/**
+ * Options for the `requestDevice` entry.
+ *
+ * `gpu?: GpuLike` is the provider seam (research §F-6 webgpu-utils + CTS
+ * consensus):
+ * - omitted → falls back to `globalThis.navigator.gpu` (real-device path).
+ * - explicitly provided → uses the caller-injected mock / real GPU object (mock
+ *   unit-test path).
+ *
+ * `adapterOptions` / `deviceDescriptor` pass through to the corresponding spec
+ * entries.
+ */
+export interface RequestDeviceOptions {
+    gpu?: GpuLike | undefined;
+    adapterOptions?: GPURequestAdapterOptions | undefined;
+    deviceDescriptor?: GPUDeviceDescriptor | undefined;
+}
+/**
+ * Internal `requestDevice` — single-step factory accepting an injected
+ * `gpu` mock provider. **Not part of the public RHI surface**: AI users go
+ * through the spec-aligned two-step path
+ * `rhi.requestAdapter() -> adapter.requestDevice()` (M3 break-point #2 + M6
+ * fix-up [w51]; AGENTS.md break-point list 2026-05-10 #2). This entry is
+ * retained as the unit-test seam (`packages/rhi-webgpu/src/__tests__/*`)
+ * for `gpu` mock injection; it is **not** re-exported through the `rhi`
+ * singleton and is **not** referenced by engine / apps / dawn paths
+ * (charter proposition 5 consistent abstraction red line + grep gate
+ * `m6-e: rhi.requestDevice( 0 hit`).
+ *
+ * Generates 3 of the 4 error paths here (research §F-5):
+ * - adapter null     → `Result.err(RhiError { code: 'adapter-unavailable' })`
+ * - feature not enabled → `Result.err(RhiError { code: 'feature-not-enabled' })`
+ * - limit exceeded   → `Result.err(RhiError { code: 'limit-exceeded' })`
+ *
+ * The 4th path (shader-compile-failed) is generated by the
+ * `createShaderModule` entry.
+ */
+export declare function requestDevice(opts?: RequestDeviceOptions): Promise<Result<RhiDevice, RhiError>>;
+/**
+ * Entry 2 - async `createShaderModule`. The shader-compile-failed path
+ * forwards every 6 fields of `GPUCompilationMessage` to
+ * `RhiError.detail.compilerMessages` (OQ-P2 / F-3 finding).
+ *
+ * Implementation (post fix-f3):
+ *   1) Look up the underlying `GPUDevice` via the in-package
+ *      `_internal_getRawDevice` (RAW_DEVICE_MAP reverse lookup; same module).
+ *   2) `rawDevice.createShaderModule(desc)` calls the spec entry to obtain
+ *      a `GPUShaderModule`.
+ *   3) `await module.getCompilationInfo()` retrieves compilation info.
+ *   4) If any message has `type === 'error'`, return
+ *      `Result.err(RhiError { code: 'shader-compile-failed',
+ *      detail: { compilerMessages } })`.
+ *   5) Otherwise return `Result.ok(module as ShaderModule)`.
+ *
+ * Note: this entry accepts a shim-wrapped RhiDevice (not a raw GPUDevice)
+ * to keep the public API single-source; the in-package
+ * `_internal_getRawDevice` is the only sanctioned reverse lookup.
+ *
+ * fix-f3: the synchronous `RhiDevice.createShaderModule` placeholder is
+ * removed; the shader-compile-failed path closes inside this async entry
+ * (charter proposition 5 consistent abstraction + proposition 4 explicit
+ * failure).
+ */
+export declare function createShaderModule(device: RhiDevice, desc: {
+    label?: string | undefined;
+    code: string;
+}): Promise<Result<ShaderModule, RhiError>>;
+/**
+ * Entry — `requestAdapter` walks `navigator.gpu.requestAdapter(opts)` and
+ * wraps the result as a forgeax `RhiAdapter` (M3 break-point #2; K-5 + K-6).
+ *
+ * Strict two-step path mirrors wgpu / Dawn (research §6); the legacy
+ * `requestDevice(opts)` factory below is the deprecated single-step shortcut
+ * kept for backward compatibility while existing callers migrate.
+ *
+ * Optional `gpu` provider seam at the `RequestAdapterOptions`-side: this
+ * factory takes only the forgeax-spec `RequestAdapterOptions` (powerPreference
+ * / forceFallbackAdapter); when callers need the mock-injection seam they go
+ * through the legacy `requestDevice({ gpu })` form.
+ *
+ * @param opts — W3C-spec request adapter options.
+ * @param _compatibleSurface — accepted for dual-impl symmetry
+ *   (plan-strategy D-5; AGENTS.md "Dual-impl ship-together" rule).
+ *   The browser WebGPU backend does not use this parameter; it is
+ *   ignored. rhi-wgpu routes it to `requestAdapterWithCanvas`.
+ */
+export declare function requestAdapter(opts?: RequestAdapterOptions | undefined, _compatibleSurface?: HTMLCanvasElement | OffscreenCanvas | undefined): Promise<Result<RhiAdapter, RhiError>>;
+/**
+ * Acquire a canvas rendering context from an HTMLCanvasElement (M3 / w15).
+ *
+ * Spec anchor: W3C WebGPU §3.3 GPUCanvasContext.
+ *
+ * Internally calls `canvas.getContext('webgpu')` and wraps the result as a
+ * branded RhiCanvasContext. Returns `Result<RhiCanvasContext, RhiError>` —
+ * canvas does not support WebGPU returns `RhiError { code: 'rhi-not-available' }`
+ * with a precise `.hint` so AI users can display a degradation banner (charter
+ * proposition 4 explicit failure).
+ *
+ * This replaces the legacy `createCanvasContext(rawCtx)` — AGENTS.md §Change stance
+ * authorizes the breaking rename (acquireCanvasContext, optimal > compatible).
+ *
+ * @example
+ *   const ctxResult = acquireCanvasContext(canvas);
+ *   if (!ctxResult.ok) {
+ *     // canvas does not support WebGPU
+ *     return;
+ *   }
+ *   const canvasContext = ctxResult.value;
+ *   canvasContext.configure({ device, format: 'bgra8unorm', usage: 0x10 });
+ */
+export declare function acquireCanvasContext(canvas: HTMLCanvasElement | OffscreenCanvas): Result<RhiCanvasContext, RhiError>;
+/**
+ * The `rhi` singleton entry (charter proposition 1: progressive disclosure +
+ * plan-strategy §7.4 discoverability:
+ * 'import { rhi } from @forgeax/engine-rhi-webgpu' + 'Engine.create({ rhi, canvas })'
+ * injection shape).
+ *
+ * Strict two-step path (M3 break-point #2 + M6 fix-up [w51]; K-5 + K-6):
+ *   `rhi.requestAdapter(opts) -> adapter.requestDevice(opts)`
+ *
+ * The legacy single-step `rhi.requestDevice(opts)` factory was retired here
+ * (AGENTS.md break-point list 2026-05-10 #2). AI users follow the spec
+ * idiom (charter proposition 5 consistent abstraction red line):
+ *   const adapter = (await rhi.requestAdapter()).unwrap();
+ *   const device  = (await adapter.requestDevice(opts)).unwrap();
+ */
+export declare const rhi: RhiInstance & {
+    createShaderModule: typeof createShaderModule;
+    acquireCanvasContext: typeof acquireCanvasContext;
+};
+export type { BindGroup, BindGroupDescriptor, BindGroupLayout, BindGroupLayoutDescriptor, Buffer, BufferDescriptor, CanvasConfiguration, CommandBuffer, CommandEncoderDescriptor, ComputePassDescriptor, ComputePassTimestampWrites, ComputePipeline, ComputePipelineDescriptor, Fence, PipelineLayout, PipelineLayoutDescriptor, QuerySet, QuerySetDescriptor, RenderPassColorAttachment, RenderPassDepthStencilAttachment, RenderPassDescriptor, RenderPipeline, RenderPipelineDescriptor, RequestAdapterOptions, RequestDeviceOptions as RhiRequestDeviceOptions, Result, ResultErr, ResultOk, RhiAdapter, RhiAssetNotRegisteredDetail, RhiCanvasContext, RhiCaps, RhiCommandEncoder, RhiComputePassEncoder, RhiDevice, RhiError, RhiErrorCode, RhiErrorDetail, RhiFeatures, RhiInstance, RhiLimits, RhiQueue, RhiRenderPassEncoder, RhiShaderCompileDetail, RhiSurface, RhiWebgpuRuntimeDetail, Sampler, SamplerDescriptor, ShaderModule, Texture, TextureDescriptor, TextureView, TextureViewDescriptor, } from '@forgeax/engine-rhi';
+export { err, ok, RhiError as RhiErrorClass } from '@forgeax/engine-rhi';
+export { _internal_getRawDevice } from './device';
+export { translateErrorEventToRhiError } from './internal/error-translation';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}