aigpu 0.3.1

package/dist/api-types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Shared public types with no runtime weight and no dependency on the `Gpu` facade.
+ *
+ * They live outside `gpu.ts` so feature modules (compute, storage, ping-pong, uniforms, ...)
+ * can be imported — and tree-shaken — without pulling the object that owns every factory.
+ */
+import type { AIGpuError } from "./errors.ts";
+import type { Target } from "./target.ts";
+export interface ComputeOptions {
+    readonly label?: string;
+    readonly set?: Record<string, unknown>;
+    /** Values for WGSL `override` constants, keyed by name (or by numeric id as a string when the override has @id). Immutable after construction. */
+    readonly constants?: Readonly<Record<string, number | boolean>>;
+    /** Compute entry point to use when the shader has several. Defaults to the first @compute entry point. */
+    readonly entry?: string;
+}
+export interface DispatchOptions {
+    /** GPU-driven dispatch: read the workgroup counts from a buffer instead of CPU-side counts. */
+    readonly indirect: StorageBuffer | {
+        readonly buffer: StorageBuffer;
+        readonly offset?: number;
+    };
+}
+export interface Compute {
+    set(values: Record<string, unknown>): this;
+    dispatch(x: number, y?: number, z?: number): void;
+    dispatch(opts: DispatchOptions): void;
+}
+export type StorageAccess = "read" | "read-write";
+export interface StorageOptions {
+    /** Binding access for shader reflection. Defaults to "read-write". */
+    readonly access?: StorageAccess;
+    /** Adds the "indirect" buffer usage so the buffer can supply GPU-read draw/dispatch arguments. Defaults to false. */
+    readonly indirect?: boolean;
+}
+export interface StorageBuffer {
+    readonly size: number;
+    readonly access: StorageAccess;
+    read(): Promise<ArrayBuffer>;
+    write(data: BufferSource): void;
+}
+export interface PingPongTargets {
+    readonly read: Target;
+    readonly write: Target;
+    swap(): void;
+}
+export interface PingPongStorage {
+    readonly read: StorageBuffer;
+    readonly write: StorageBuffer;
+    swap(): void;
+}
+export interface SharedUniforms<T extends Record<string, unknown> = Record<string, unknown>> {
+    set(values: Partial<T>): void;
+}
+export type GpuErrorListener = (error: AIGpuError) => void;
+//# sourceMappingURL=api-types.d.ts.map

package/dist/api-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-types.d.ts","sourceRoot":"","sources":["../src/api-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,kJAAkJ;IAClJ,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAChE,0GAA0G;IAC1G,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,eAAe;IAC9B,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjG;AACD,MAAM,WAAW,OAAO;IAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE;AACjK,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;AAClD,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,qHAAqH;IACrH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AACD,MAAM,WAAW,aAAa;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAAC,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE;AACvJ,MAAM,WAAW,eAAe;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,IAAI,CAAA;CAAE;AAChG,MAAM,WAAW,eAAe;IAAG,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAAC,IAAI,IAAI,IAAI,CAAA;CAAE;AAC9G,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;CAAE;AAC9H,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC"}

package/dist/api-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api-types.js.map

package/dist/api-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-types.js","sourceRoot":"","sources":["../src/api-types.ts"],"names":[],"mappings":""}

package/dist/bind-cache.d.ts

@@ -0,0 +1,19 @@
+import type { ResourceIdentity, UnsubscribeResourceDestroy } from "@aigpu/core";
+export type BindGroupIdentityPart = ResourceIdentity | {
+    readonly kind: string;
+    readonly id: number;
+} | string | number;
+export type BindGroupFactory = () => GPUBindGroup;
+export interface BindGroupCache {
+    getOrCreate(drawId: number | string, group: number, identityTuple: readonly BindGroupIdentityPart[], factory: BindGroupFactory): GPUBindGroup;
+    evictIdentity(identity: BindGroupIdentityPart): void;
+    clearDraw(drawId: number | string): void;
+    dispose(): void;
+}
+export declare function createBindGroupCache(): BindGroupCache;
+export declare function identityKey(identity: BindGroupIdentityPart): string;
+export declare function subscribeEviction(resource: {
+    onDestroy?: (cb: (resource: unknown) => void) => UnsubscribeResourceDestroy;
+    readonly resourceIdentity?: ResourceIdentity;
+}, cache: BindGroupCache): UnsubscribeResourceDestroy | undefined;
+//# sourceMappingURL=bind-cache.d.ts.map

package/dist/bind-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-cache.d.ts","sourceRoot":"","sources":["../src/bind-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,MAAM,CAAC;AACxH,MAAM,MAAM,gBAAgB,GAAG,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,qBAAqB,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAAC;IAC9I,aAAa,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACrD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CA2BrD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAGnE;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE;IAAE,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,KAAK,0BAA0B,CAAC;IAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CAAE,EACvI,KAAK,EAAE,cAAc,GACpB,0BAA0B,GAAG,SAAS,CAIxC"}

package/dist/bind-cache.js

@@ -0,0 +1,43 @@
+export function createBindGroupCache() {
+    const entries = new Map();
+    return {
+        getOrCreate(drawId, group, identityTuple, factory) {
+            const identities = identityTuple.map(identityKey);
+            const key = `${drawId}:${group}:${identities.join("|")}`;
+            const existing = entries.get(key);
+            if (existing)
+                return existing.bindGroup;
+            const bindGroup = factory();
+            entries.set(key, { identities, bindGroup });
+            return bindGroup;
+        },
+        evictIdentity(identity) {
+            const needle = identityKey(identity);
+            for (const [key, entry] of entries) {
+                if (entry.identities.includes(needle))
+                    entries.delete(key);
+            }
+        },
+        clearDraw(drawId) {
+            const prefix = `${drawId}:`;
+            for (const key of entries.keys())
+                if (key.startsWith(prefix))
+                    entries.delete(key);
+        },
+        dispose() {
+            entries.clear();
+        },
+    };
+}
+export function identityKey(identity) {
+    if (typeof identity === "string" || typeof identity === "number")
+        return String(identity);
+    return `${identity.kind}:${identity.id}`;
+}
+export function subscribeEviction(resource, cache) {
+    const identity = resource.resourceIdentity;
+    if (!identity || typeof resource.onDestroy !== "function")
+        return undefined;
+    return resource.onDestroy(() => cache.evictIdentity(identity));
+}
+//# sourceMappingURL=bind-cache.js.map

package/dist/bind-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-cache.js","sourceRoot":"","sources":["../src/bind-cache.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwF,CAAC;IAEhH,OAAO;QACL,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO;YAC/C,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAClD,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC,SAAS,CAAC;YACxC,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;YAC5C,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,aAAa,CAAC,QAAQ;YACpB,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;YACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;gBACnC,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QACD,SAAS,CAAC,MAAM;YACd,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC;YAC5B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE;gBAAE,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpF,CAAC;QACD,OAAO;YACL,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAA+B;IACzD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1F,OAAO,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAuI,EACvI,KAAqB;IAErB,MAAM,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC;IAC3C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAC5E,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/dist/bundle.d.ts

@@ -0,0 +1,30 @@
+import { type Draw, type DrawCallOptions } from "./draw.ts";
+import { type Effect } from "./effect.ts";
+import type { CompileTarget } from "./target.ts";
+import type { Gpu } from "./kernel.ts";
+/**
+ * Records an explicit WebGPU render bundle: the draws in `record` are encoded once and replayed
+ * with `pass.bundles(bundle)`.
+ *
+ * A bundle freezes its commands, its bind groups and the target signature it was recorded for; the
+ * recorded state is re-checked at replay and a mismatch throws `AIGPU-R3-BUNDLE-STALE` instead of
+ * drawing something stale. Recording against a `Surface` is only legal inside a frame, because the
+ * surface's current texture — and therefore its format — is only defined there.
+ */
+export declare function bundle(gpu: Gpu, opts: BundleOptions, record: (recorder: BundleRecorder) => void): Bundle;
+export interface BundleOptions {
+    readonly target: CompileTarget;
+    readonly label?: string;
+}
+export interface BundleRecorder {
+    draw(drawable: Draw | Effect, opts?: DrawCallOptions): void;
+}
+export interface Bundle {
+    readonly id: string;
+    readonly gpu: GPURenderBundle;
+}
+/** Records explicit WebGPU render bundles and keeps the R3 stale signature checked at replay time. */
+export declare function createBundle(device: {
+    readonly gpu: GPUDevice;
+}, opts: BundleOptions, record: (recorder: BundleRecorder) => void): Bundle;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AACA,OAAO,EAAkJ,KAAK,IAAI,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5M,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAA2B,MAAM,aAAa,CAAC;AAM1E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,CAExG;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;CAC/B;AAKD,sGAAsG;AACtG,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;CAAE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,CAOzI"}

package/dist/bundle.js

@@ -0,0 +1,127 @@
+import { createRenderBundle } from "./core/render-bundle.js";
+import { drawUsesBlendConstant, drawUsesStencilReference, encodeDraw, registerDrawBundle } from "./draw.js";
+import { InternalEffect, effectDraw } from "./effect.js";
+import { normalizeSignature, signatureKeyOf, validateTargetSignature } from "./pipeline-store.js";
+import { bundleBlendConstantError, bundleStencilReferenceError, surfaceNotInFrameError, AIGpuError } from "./errors.js";
+import { isFrameActive, isSurface } from "./surface.js";
+import { FRAME_BUNDLE } from "./frame-protocols.js";
+import { liveKernel } from "./live-kernel.js";
+/**
+ * Records an explicit WebGPU render bundle: the draws in `record` are encoded once and replayed
+ * with `pass.bundles(bundle)`.
+ *
+ * A bundle freezes its commands, its bind groups and the target signature it was recorded for; the
+ * recorded state is re-checked at replay and a mismatch throws `AIGPU-R3-BUNDLE-STALE` instead of
+ * drawing something stale. Recording against a `Surface` is only legal inside a frame, because the
+ * surface's current texture — and therefore its format — is only defined there.
+ */
+export function bundle(gpu, opts, record) {
+    return createBundle(liveKernel(gpu, "bundle").device, opts, record);
+}
+let nextBundleId = 1;
+let recordingDepth = 0;
+/** Records explicit WebGPU render bundles and keeps the R3 stale signature checked at replay time. */
+export function createBundle(device, opts, record) {
+    const id = opts.label ?? `bundle${nextBundleId++}`;
+    if (isSurface(opts.target) && !isFrameActive())
+        throw surfaceNotInFrameError("bundle");
+    const signature = normalizeBundleSignature(opts.target);
+    const bundle = new RecordedBundle(device, id, signature);
+    bundle.record(record);
+    return bundle;
+}
+class RecordedBundle {
+    device;
+    id;
+    signature;
+    gpu;
+    #staleEvent;
+    #signatureKey;
+    #draws = new Set();
+    constructor(device, id, signature) {
+        this.device = device;
+        this.id = id;
+        this.signature = signature;
+        this.#signatureKey = signatureKeyOf(signature);
+    }
+    record(record) {
+        this.gpu = createRenderBundle(this.device, {
+            label: this.id,
+            colorFormats: this.signature.colors,
+            depthStencilFormat: this.signature.depth,
+            sampleCount: this.signature.sampleCount ?? 1,
+            record: (recorder) => this.#recordCommands(record, recorder.gpu),
+        });
+        for (const draw of this.#draws)
+            registerDrawBundle(draw, this);
+    }
+    /**
+     * Frame bundle protocol: `pass.bundles()` replays through this, so `frame.ts` never imports
+     * bundle.ts. The recorded bundle is its own protocol object — `gpu` and the staleness check.
+     */
+    get [FRAME_BUNDLE]() { return this; }
+    markStale(event) {
+        if (recordingDepth > 0)
+            return;
+        this.#staleEvent ??= event;
+    }
+    assertReplayable(target) {
+        const actual = normalizeBundleSignature(target);
+        const actualKey = signatureKeyOf(actual);
+        if (this.#signatureKey !== actualKey)
+            throw bundleStaleError(this.id, targetSignatureStaleMessage(this.id, this.#signatureKey, actualKey));
+        if (this.#staleEvent)
+            throw bundleStaleError(this.id, staleEventMessage(this.id, this.#staleEvent));
+    }
+    remember(draw) {
+        this.#draws.add(draw);
+    }
+    #recordCommands(record, encoder) {
+        recordingDepth += 1;
+        try {
+            record(new ExplicitBundleRecorder(this, encoder));
+        }
+        finally {
+            recordingDepth -= 1;
+        }
+    }
+}
+class ExplicitBundleRecorder {
+    bundle;
+    encoder;
+    constructor(bundle, encoder) {
+        this.bundle = bundle;
+        this.encoder = encoder;
+    }
+    draw(drawable, opts = {}) {
+        // Blend/writeMask are constructor-only draw pipeline state. If they ever become mutable or per-call,
+        // bundles need a new staleness dimension beyond the target signature checked at replay.
+        const draw = drawable instanceof InternalEffect ? effectDraw(drawable) : drawable;
+        // The blend constant is render-pass state; GPURenderBundleEncoder has no setBlendConstant, so reject at recording.
+        if (drawUsesBlendConstant(draw))
+            throw bundleBlendConstantError(this.bundle.id, draw.label);
+        // Likewise the stencil reference: GPURenderBundleEncoder has no setStencilReference. Stencil pipeline state without ref records fine.
+        if (drawUsesStencilReference(draw))
+            throw bundleStencilReferenceError(this.bundle.id, draw.label);
+        this.bundle.remember(draw);
+        encodeDraw(draw, this.encoder, this.bundle.signature, opts);
+    }
+}
+function normalizeBundleSignature(target) {
+    const signature = normalizeSignature(target);
+    validateTargetSignature(signature, "bundle");
+    return signature;
+}
+function targetSignatureStaleMessage(id, recordedKey, actualKey) {
+    return `bundle '${id}' is stale: the replay target signature does not match the recorded signature. Bundles freeze format/depth/sampleCount and bind groups.\n  Recorded signature: ${recordedKey}\n  Actual signature: ${actualKey}\n  Fix: re-record the bundle for this target → ${id} = bundle(gpu, { target: scene }, ...)\n  (re-recording is always your responsibility; the library only detects this).`;
+}
+function staleEventMessage(id, event) {
+    if (event.kind === "group-claim") {
+        return `bundle '${id}' is stale: group ${event.group} of draw\n  '${event.drawLabel}' changed bind group after recording. Bundles freeze commands and bind groups.\n  Fix: re-record it → ${id} = bundle(gpu, { target: scene }, ...)\n  (re-recording is always your responsibility; the library only detects this).`;
+    }
+    return `bundle '${id}' is stale: binding \`${event.bindingName}\` (@group(${event.group}) @binding(${event.binding})) of draw\n  '${event.drawLabel}' changed resource after recording. Bundles freeze commands and bind groups.\n  Fix: re-record it → ${id} = bundle(gpu, { target: scene }, ...)\n  (re-recording is always your responsibility; the library only detects this).`;
+}
+function bundleStaleError(id, message) {
+    return new AIGpuError({ code: "AIGPU-R3-BUNDLE-STALE", message, where: `bundle '${id}' replay` });
+}
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

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

package/dist/claim-validation-encode.d.ts

@@ -0,0 +1,14 @@
+import type { Device } from "@aigpu/core";
+import { type ClaimedGroupValidationContext, type ClaimedGroupValidationResult } from "./claim-validation.ts";
+/**
+ * Ends a render pass and maps native end-time failures back to raw group claims.
+ *
+ * Raw WebGPU validation scopes are device-global, so this abort helper drains
+ * only scopes still open after a failing pass end and suppresses every collected
+ * validation promise before rethrowing. Callers pass the fallback context they
+ * already used before this extraction so end-failure diagnostics stay unchanged.
+ *
+ * @internal
+ */
+export declare function endRenderPassWithClaimValidation(device: Device, pass: GPURenderPassEncoder, validations: ClaimedGroupValidationResult[], fallbackContext?: ClaimedGroupValidationContext): void;
+//# sourceMappingURL=claim-validation-encode.d.ts.map

package/dist/claim-validation-encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-validation-encode.d.ts","sourceRoot":"","sources":["../src/claim-validation-encode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAGL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EAClC,MAAM,uBAAuB,CAAC;AAG/B;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,oBAAoB,EAC1B,WAAW,EAAE,4BAA4B,EAAE,EAC3C,eAAe,CAAC,EAAE,6BAA6B,GAC9C,IAAI,CAYN"}

package/dist/claim-validation-encode.js

@@ -0,0 +1,28 @@
+import { discardClaimedGroupValidationResults, popClaimedGroupValidationScopes, } from "./claim-validation.js";
+import { claimedGroupNativeValidationError } from "./errors.js";
+/**
+ * Ends a render pass and maps native end-time failures back to raw group claims.
+ *
+ * Raw WebGPU validation scopes are device-global, so this abort helper drains
+ * only scopes still open after a failing pass end and suppresses every collected
+ * validation promise before rethrowing. Callers pass the fallback context they
+ * already used before this extraction so end-failure diagnostics stay unchanged.
+ *
+ * @internal
+ */
+export function endRenderPassWithClaimValidation(device, pass, validations, fallbackContext) {
+    try {
+        pass.end();
+    }
+    catch (error) {
+        const scopes = popClaimedGroupValidationScopes(device);
+        discardClaimedGroupValidationResults(validations);
+        discardClaimedGroupValidationResults(scopes);
+        validations.length = 0;
+        const context = scopes[0]?.context ?? fallbackContext;
+        if (context)
+            throw claimedGroupNativeValidationError(context.label, context.group, error);
+        throw error;
+    }
+}
+//# sourceMappingURL=claim-validation-encode.js.map

package/dist/claim-validation-encode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-validation-encode.js","sourceRoot":"","sources":["../src/claim-validation-encode.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oCAAoC,EACpC,+BAA+B,GAGhC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,UAAU,gCAAgC,CAC9C,MAAc,EACd,IAA0B,EAC1B,WAA2C,EAC3C,eAA+C;IAE/C,IAAI,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,+BAA+B,CAAC,MAAM,CAAC,CAAC;QACvD,oCAAoC,CAAC,WAAW,CAAC,CAAC;QAClD,oCAAoC,CAAC,MAAM,CAAC,CAAC;QAC7C,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,eAAe,CAAC;QACtD,IAAI,OAAO;YAAE,MAAM,iCAAiC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1F,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/claim-validation.d.ts

@@ -0,0 +1,73 @@
+import type { Device } from "@aigpu/core";
+import { type AIGpuError } from "./errors.ts";
+export interface ClaimedGroupValidationContext {
+    readonly label: string;
+    readonly group: number;
+}
+export interface ClaimedGroupValidationResult {
+    readonly context: ClaimedGroupValidationContext;
+    readonly error: Promise<GPUError | null>;
+}
+export type ValidationErrorSink = (error: AIGpuError) => void | Promise<void>;
+export interface ClaimedGroupValidationDoneOptions {
+    readonly errorSink?: ValidationErrorSink;
+}
+/**
+ * Opens a native WebGPU validation scope for one raw claimed bind group.
+ *
+ * WebGPU error scopes are device-global and strictly LIFO, so callers must pair
+ * this with `popLastClaimedGroupValidationScope()` immediately after the small
+ * protected encode operation. Metadata-backed claims bypass this helper because
+ * aigpu can validate their layout synchronously and the normal path should not
+ * pay for native error scopes.
+ */
+export declare function pushClaimedGroupValidationScope(device: Device, context: ClaimedGroupValidationContext): void;
+/**
+ * Pops the most recent raw-claim scope in native LIFO order and returns its promise.
+ *
+ * The returned promise is delivered through `gpu.onError` and tracked by
+ * `Frame.done` / `gpu.settled()` after submit. Popping immediately keeps the device-global WebGPU scope stack from
+ * being shared accidentally by overlapping frames or one-shot draws.
+ */
+export declare function popLastClaimedGroupValidationScope(device: Device): ClaimedGroupValidationResult | undefined;
+/**
+ * Pops every currently open raw-claim scope for this device in native LIFO order.
+ *
+ * Device-global WebGPU error scopes are not an ownership/collection boundary;
+ * this exists only for abort paths that must drain scopes left open by a failed
+ * protected encode region before rethrowing.
+ *
+ * @internal
+ */
+export declare function popClaimedGroupValidationScopes(device: Device): readonly ClaimedGroupValidationResult[];
+/** Discards one open raw-claim scope after a synchronous encode failure. */
+export declare function discardLastClaimedGroupValidationScope(device: Device): void;
+/**
+ * Discards every currently open raw-claim scope for this device after aborting an encode region.
+ *
+ * This is intentionally device-global and abort-only: normal validation owners
+ * pop scopes immediately and store the returned promises on their frame/draw.
+ *
+ * @internal
+ */
+export declare function discardClaimedGroupValidationScopes(device: Device): void;
+/** Suppresses already-popped validation promises when their frame/draw will not submit. */
+export declare function discardClaimedGroupValidationResults(results: readonly ClaimedGroupValidationResult[]): void;
+/**
+ * Resolves after the device queue reports submitted work completion, when supported.
+ *
+ * This is feature-guarded because the mock and some compatibility environments
+ * may omit `onSubmittedWorkDone`.
+ */
+export declare function submittedWorkDone(device: Device): Promise<void>;
+/**
+ * Awaits raw claimed-bind-group validation collected during encode.
+ *
+ * No scopes remain open here: native scopes were already popped in LIFO order
+ * immediately after each protected encode operation. Validation errors are
+ * delivered to the supplied device-level error sink as `AIGPU-R4-GROUP-VALIDATION`;
+ * this promise resolves after delivery and never rejects.
+ */
+export declare function claimedGroupValidationDone(device: Device, results?: readonly ClaimedGroupValidationResult[], opts?: ClaimedGroupValidationDoneOptions): Promise<void>;
+export declare function preferClaimedGroupValidationResult(preferred: ClaimedGroupValidationResult, fallback: ClaimedGroupValidationResult): ClaimedGroupValidationResult;
+//# sourceMappingURL=claim-validation.d.ts.map

package/dist/claim-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-validation.d.ts","sourceRoot":"","sources":["../src/claim-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CAC1C;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAID;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAM5G;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,4BAA4B,GAAG,SAAS,CAM3G;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,4BAA4B,EAAE,CAQvG;AAED,4EAA4E;AAC5E,wBAAgB,sCAAsC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAG3E;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAExE;AAED,2FAA2F;AAC3F,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,SAAS,4BAA4B,EAAE,GAAG,IAAI,CAE3G;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,4BAA4B,EAAO,EAAE,IAAI,GAAE,iCAAsC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7K;AAED,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,4BAA4B,EAAE,QAAQ,EAAE,4BAA4B,GAAG,4BAA4B,CAKhK"}

package/dist/claim-validation.js

@@ -0,0 +1,135 @@
+import { claimedGroupNativeValidationError } from "./errors.js";
+const pendingScopes = new WeakMap();
+/**
+ * Opens a native WebGPU validation scope for one raw claimed bind group.
+ *
+ * WebGPU error scopes are device-global and strictly LIFO, so callers must pair
+ * this with `popLastClaimedGroupValidationScope()` immediately after the small
+ * protected encode operation. Metadata-backed claims bypass this helper because
+ * aigpu can validate their layout synchronously and the normal path should not
+ * pay for native error scopes.
+ */
+export function pushClaimedGroupValidationScope(device, context) {
+    if (!device.gpu.pushErrorScope || !device.gpu.popErrorScope)
+        return;
+    device.gpu.pushErrorScope("validation");
+    const pending = pendingScopes.get(device.gpu);
+    if (pending)
+        pending.push(context);
+    else
+        pendingScopes.set(device.gpu, [context]);
+}
+/**
+ * Pops the most recent raw-claim scope in native LIFO order and returns its promise.
+ *
+ * The returned promise is delivered through `gpu.onError` and tracked by
+ * `Frame.done` / `gpu.settled()` after submit. Popping immediately keeps the device-global WebGPU scope stack from
+ * being shared accidentally by overlapping frames or one-shot draws.
+ */
+export function popLastClaimedGroupValidationScope(device) {
+    const pending = pendingScopes.get(device.gpu);
+    if (!pending?.length || !device.gpu.popErrorScope)
+        return undefined;
+    const context = pending.pop();
+    if (!pending.length)
+        pendingScopes.delete(device.gpu);
+    return { context, error: device.gpu.popErrorScope() };
+}
+/**
+ * Pops every currently open raw-claim scope for this device in native LIFO order.
+ *
+ * Device-global WebGPU error scopes are not an ownership/collection boundary;
+ * this exists only for abort paths that must drain scopes left open by a failed
+ * protected encode region before rethrowing.
+ *
+ * @internal
+ */
+export function popClaimedGroupValidationScopes(device) {
+    const results = [];
+    let result = popLastClaimedGroupValidationScope(device);
+    while (result) {
+        results.push(result);
+        result = popLastClaimedGroupValidationScope(device);
+    }
+    return results;
+}
+/** Discards one open raw-claim scope after a synchronous encode failure. */
+export function discardLastClaimedGroupValidationScope(device) {
+    const result = popLastClaimedGroupValidationScope(device);
+    if (result)
+        suppressClaimedGroupValidationResult(result);
+}
+/**
+ * Discards every currently open raw-claim scope for this device after aborting an encode region.
+ *
+ * This is intentionally device-global and abort-only: normal validation owners
+ * pop scopes immediately and store the returned promises on their frame/draw.
+ *
+ * @internal
+ */
+export function discardClaimedGroupValidationScopes(device) {
+    for (const result of popClaimedGroupValidationScopes(device))
+        suppressClaimedGroupValidationResult(result);
+}
+/** Suppresses already-popped validation promises when their frame/draw will not submit. */
+export function discardClaimedGroupValidationResults(results) {
+    for (const result of results)
+        suppressClaimedGroupValidationResult(result);
+}
+/**
+ * Resolves after the device queue reports submitted work completion, when supported.
+ *
+ * This is feature-guarded because the mock and some compatibility environments
+ * may omit `onSubmittedWorkDone`.
+ */
+export function submittedWorkDone(device) {
+    return device.gpu.queue.onSubmittedWorkDone?.() ?? Promise.resolve();
+}
+/**
+ * Awaits raw claimed-bind-group validation collected during encode.
+ *
+ * No scopes remain open here: native scopes were already popped in LIFO order
+ * immediately after each protected encode operation. Validation errors are
+ * delivered to the supplied device-level error sink as `AIGPU-R4-GROUP-VALIDATION`;
+ * this promise resolves after delivery and never rejects.
+ */
+export function claimedGroupValidationDone(device, results = [], opts = {}) {
+    return settleClaimedGroupValidations(device, results, opts.errorSink ?? defaultErrorSink);
+}
+export function preferClaimedGroupValidationResult(preferred, fallback) {
+    return {
+        context: preferred.context,
+        error: preferValidationError(preferred.error, fallback.error),
+    };
+}
+async function preferValidationError(preferred, fallback) {
+    const results = await Promise.allSettled([preferred, fallback]);
+    for (const result of results) {
+        if (result.status === "fulfilled" && result.value)
+            return result.value;
+    }
+    const rejection = results.find((result) => result.status === "rejected");
+    if (rejection?.status === "rejected")
+        throw rejection.reason;
+    return null;
+}
+async function settleClaimedGroupValidations(device, results, errorSink) {
+    await submittedWorkDone(device);
+    for (const result of results) {
+        try {
+            const error = await result.error;
+            if (error)
+                await errorSink(claimedGroupNativeValidationError(result.context.label, result.context.group, error));
+        }
+        catch (error) {
+            await errorSink(claimedGroupNativeValidationError(result.context.label, result.context.group, error));
+        }
+    }
+}
+function suppressClaimedGroupValidationResult(result) {
+    void result.error.catch(() => undefined);
+}
+function defaultErrorSink(error) {
+    console.error(error);
+}
+//# sourceMappingURL=claim-validation.js.map

package/dist/claim-validation.js.map

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