aigpu 0.3.1

package/dist/set-resources.js

@@ -0,0 +1,140 @@
+import { Buffer, Texture } from "@aigpu/core";
+import { incompatibleResourceError, textureFilterabilityError } from "./errors.js";
+import { assertBufferUsable } from "./lifecycle.js";
+import { BINDING_RESOURCE, bindingResourceOf } from "./draw-protocols.js";
+let nextSyntheticResourceId = 1;
+const syntheticIds = new WeakMap();
+export function isPlainValue(value) {
+    if (value === null)
+        return true;
+    if (typeof value !== "object")
+        return true;
+    if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer || Array.isArray(value))
+        return true;
+    if (value instanceof Buffer || value instanceof Texture)
+        return false;
+    return !hasAnyResourceShape(value);
+}
+export function isPlainObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value) || ArrayBuffer.isView(value) || value instanceof ArrayBuffer)
+        return false;
+    if (value instanceof Buffer || value instanceof Texture)
+        return false;
+    return !hasAnyResourceShape(value);
+}
+/** Normalizes resources for the reflected binding kind and rejects incompatible values with aigpu fix-its. */
+export function normalizeResource(binding, value, context) {
+    switch (binding.bindingLayout?.kind) {
+        case "buffer": return normalizeBufferResource(binding, value, context);
+        case "texture": return normalizeTextureResource(binding, value, context);
+        case "sampler": return normalizeSamplerResource(binding, value);
+        case "storageTexture": throw incompatibleResourceError(binding, "storage texture", "Pass a storage-compatible texture.");
+        case "externalTexture": throw incompatibleResourceError(binding, "external texture", "Pass a compatible GPUExternalTexture.");
+        default: throw incompatibleResourceError(binding, "reflected resource", "Fix shader reflection bindingLayout.");
+    }
+}
+function normalizeBufferResource(binding, value, context) {
+    // Nominal protocol, not an instanceof: recognizing a shared uniforms block must not link it.
+    const provider = bindingResourceOf(value);
+    if (provider)
+        return provider[BINDING_RESOURCE](binding, context.sourceHint);
+    if (value instanceof Buffer) {
+        assertBufferUsable(value, `${context.sourceHint}.set`);
+        validateBufferUsage(binding, value.options.usage);
+        return { resource: { buffer: value.gpu }, identity: value.resourceIdentity, unsubscribe: (cb) => value.onDestroy(cb) };
+    }
+    if (isUniformLike(value)) {
+        assertBufferUsable(value.buffer, `${context.sourceHint}.set`);
+        return { resource: { buffer: value.gpu, offset: 0, size: value.size }, identity: value.buffer.resourceIdentity, unsubscribe: (cb) => value.buffer.onDestroy(cb) };
+    }
+    if (isGPUBufferBinding(value))
+        return { resource: value, identity: syntheticIdentity(value.buffer) };
+    if (isRawGPUBuffer(value))
+        return { resource: { buffer: value }, identity: syntheticIdentity(value) };
+    throw incompatibleResourceError(binding, "buffer", `Pass a compatible Buffer/Uniform: ${binding.name}.set({ ${binding.name}: gpu.device.createBuffer(...) }).`);
+}
+function normalizeTextureResource(binding, value, context) {
+    const target = asTarget(value);
+    if (target) {
+        const color = target.color;
+        validateTextureFilterability(binding, color, context);
+        const onTexturesRecreated = target.onTexturesRecreated?.bind(target);
+        return { resource: color.createView(), identity: color.resourceIdentity, unsubscribe: (cb) => target.onDestroy(cb), onRecreate: onTexturesRecreated ? (cb) => onTexturesRecreated(cb) : undefined };
+    }
+    if (value instanceof Texture) {
+        validateTextureUsage(binding, value.usage);
+        validateTextureFilterability(binding, value, context);
+        return { resource: value.createView(), identity: value.resourceIdentity, unsubscribe: (cb) => value.onDestroy(cb) };
+    }
+    if (isTextureLike(value))
+        return { resource: value.createView(), identity: value.resourceIdentity ?? syntheticIdentity(value) };
+    if (typeof value === "object" && value !== null)
+        return { resource: value, identity: syntheticIdentity(value) };
+    throw incompatibleResourceError(binding, "texture/target", `Pass a Texture or Target: ${binding.name}.set({ ${binding.name}: scene.color }) or set({ ${binding.name}: scene }).`);
+}
+function normalizeSamplerResource(binding, value) {
+    if (isSamplerLike(value))
+        return { resource: value, identity: syntheticIdentity(value) };
+    throw incompatibleResourceError(binding, "sampler", `Use the cached sampler: set({ ${binding.name}: sampler(gpu) }).`);
+}
+function isSamplerLike(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    if (value instanceof Buffer || value instanceof Texture)
+        return false;
+    return !isRawGPUBuffer(value) && !isGPUBufferBinding(value) && !isTextureLike(value) && !asTarget(value);
+}
+function validateBufferUsage(binding, usage) {
+    const expected = binding.bindingLayout?.kind === "buffer" ? binding.bindingLayout.buffer.type : undefined;
+    if (expected === "uniform" && !usage.includes("uniform"))
+        throw incompatibleResourceError(binding, "uniform buffer", "Create with usage: ['uniform','copy_dst'].");
+    if ((expected === "storage" || expected === "read-only-storage") && !usage.includes("storage"))
+        throw incompatibleResourceError(binding, "storage buffer", "Create with usage: ['storage','copy_dst'].");
+}
+function validateTextureUsage(binding, usage) {
+    if (!usage.includes("texture_binding") && !usage.includes("render_attachment")) {
+        throw incompatibleResourceError(binding, "sampled texture", "Use texture_binding usage or a sampleable Target.");
+    }
+}
+function validateTextureFilterability(binding, texture, context) {
+    if (!context.filterableTexture || context.float32Filterable)
+        return;
+    if (texture.format === "r32float" || texture.format === "rg32float" || texture.format === "rgba32float") {
+        throw textureFilterabilityError(context.sourceHint, binding, texture.format, texture.label ?? "texture", context.pairedSampler);
+    }
+}
+function asTarget(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const record = value;
+    if (!record.resourceIdentity || !record.color || typeof record.onDestroy !== "function")
+        return undefined;
+    return record;
+}
+function hasAnyResourceShape(value) {
+    const record = value;
+    return "gpu" in record || "bindGroup" in record || "createView" in record || "resourceIdentity" in record;
+}
+function syntheticIdentity(value) {
+    if (typeof value !== "object" || value === null)
+        return `value:${String(value)}`;
+    let id = syntheticIds.get(value);
+    if (!id) {
+        id = { kind: "external", id: nextSyntheticResourceId++ };
+        syntheticIds.set(value, id);
+    }
+    return id;
+}
+function isUniformLike(value) {
+    return typeof value === "object" && value !== null && "gpu" in value && "size" in value && "buffer" in value && value.buffer instanceof Buffer;
+}
+function isTextureLike(value) {
+    return typeof value === "object" && value !== null && typeof value.createView === "function";
+}
+function isGPUBufferBinding(value) {
+    return typeof value === "object" && value !== null && "buffer" in value && isRawGPUBuffer(value.buffer);
+}
+function isRawGPUBuffer(value) {
+    return typeof value === "object" && value !== null && "size" in value && "usage" in value && typeof value.destroy === "function";
+}
+//# sourceMappingURL=set-resources.js.map

package/dist/set-resources.js.map

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

package/dist/shader-source.d.ts

@@ -0,0 +1,4 @@
+import type { ShaderSource } from "@aigpu/wgsl";
+/** Normalizes public ring-1 shader inputs to raw WGSL. Strings remain first-class; ShaderSource is the loader artifact. */
+export declare function toWgsl(input: string | ShaderSource): string;
+//# sourceMappingURL=shader-source.d.ts.map

package/dist/shader-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-source.d.ts","sourceRoot":"","sources":["../src/shader-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,2HAA2H;AAC3H,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAS3D"}

package/dist/shader-source.js

@@ -0,0 +1,21 @@
+import { malformedShaderSourceError } from "./errors.js";
+/** Normalizes public ring-1 shader inputs to raw WGSL. Strings remain first-class; ShaderSource is the loader artifact. */
+export function toWgsl(input) {
+    if (typeof input === "string")
+        return input;
+    if (!isObject(input))
+        throw malformedShaderSourceError(input);
+    if (!("version" in input))
+        throw malformedShaderSourceError(input);
+    const version = input.version;
+    if (version !== 1)
+        throw malformedShaderSourceError(input);
+    const wgsl = input.wgsl;
+    if (typeof wgsl !== "string")
+        throw malformedShaderSourceError(input);
+    return wgsl;
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=shader-source.js.map

package/dist/shader-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-source.js","sourceRoot":"","sources":["../src/shader-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,2HAA2H;AAC3H,MAAM,UAAU,MAAM,CAAC,KAA4B;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC;QAAE,MAAM,0BAA0B,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,OAAO,GAAI,KAAuC,CAAC,OAAO,CAAC;IACjE,IAAI,OAAO,KAAK,CAAC;QAAE,MAAM,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAI,KAAqC,CAAC,IAAI,CAAC;IACzD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,MAAM,0BAA0B,CAAC,KAAK,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,38 @@
+import { Buffer, type Device } from "@aigpu/core";
+import type { StorageAccess, StorageBuffer, StorageOptions } from "./api-types.ts";
+import type { Gpu } from "./kernel.ts";
+/**
+ * Storage buffer owned by this gpu: `read()`/`write()` from the host, bindable from any shader.
+ *
+ * `access` accepts the shorthand string or the options bag; `{ indirect: true }` adds the "indirect"
+ * usage so the buffer can supply GPU-read draw/dispatch arguments. The buffer is destroyed by
+ * `gpu.dispose()` — or earlier, by hand, through the internal handle.
+ */
+export declare function storage(gpu: Gpu, bytes: number, access?: StorageAccess | StorageOptions): StorageBuffer;
+/**
+ * Ring-1 StorageBuffer facade backed by a core Buffer.
+ *
+ * @internal
+ */
+export declare class RingStorageBuffer implements StorageBuffer {
+    readonly size: number;
+    readonly access: StorageAccess;
+    readonly buffer: Buffer;
+    constructor(buffer: Buffer, access: StorageAccess);
+    static create(device: Device, bytes: number, access: StorageAccess, label?: string, indirect?: boolean): RingStorageBuffer;
+    read(): Promise<ArrayBuffer>;
+    write(data: BufferSource, offset?: number): void;
+    get gpu(): GPUBuffer;
+    get resourceIdentity(): import("@aigpu/core").ResourceIdentity;
+    onDestroy(cb: (buffer: Buffer) => void): import("@aigpu/core").UnsubscribeResourceDestroy;
+    /** Frees the GPU allocation. Idempotent; bind groups holding it are invalidated through the buffer's destroy signal. */
+    destroy(): void;
+}
+export declare function createStorageBuffer(device: Device, bytes: number, access: StorageAccess, label?: string, indirect?: boolean): RingStorageBuffer;
+/**
+ * Wraps an existing core buffer as an internal StorageBuffer facade.
+ *
+ * @internal
+ */
+export declare function wrapStorageBuffer(buffer: Buffer, access: StorageAccess): RingStorageBuffer;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA8C,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGvC;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,aAAa,GAAG,cAA6B,GAAG,aAAa,CAKrH;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;IAMjD,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,iBAAiB;IAUxH,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAI5B,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,SAAI,GAAG,IAAI;IAI3C,IAAI,GAAG,IAAI,SAAS,CAEnB;IAED,IAAI,gBAAgB,2CAEnB;IAED,SAAS,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI;IAItC,wHAAwH;IACxH,OAAO,IAAI,IAAI;CAGhB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,iBAAiB,CAE7I;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAE1F"}

package/dist/storage.js

@@ -0,0 +1,76 @@
+import { liveKernel, ownResource } from "./live-kernel.js";
+/**
+ * Storage buffer owned by this gpu: `read()`/`write()` from the host, bindable from any shader.
+ *
+ * `access` accepts the shorthand string or the options bag; `{ indirect: true }` adds the "indirect"
+ * usage so the buffer can supply GPU-read draw/dispatch arguments. The buffer is destroyed by
+ * `gpu.dispose()` — or earlier, by hand, through the internal handle.
+ */
+export function storage(gpu, bytes, access = "read-write") {
+    const kernel = liveKernel(gpu, "storage");
+    const opts = typeof access === "string" ? { access } : access;
+    const buffer = createStorageBuffer(kernel.device, bytes, opts.access ?? "read-write", undefined, opts.indirect ?? false);
+    return ownResource(kernel, buffer, (owned) => owned.destroy(), (cb) => { buffer.onDestroy(cb); });
+}
+/**
+ * Ring-1 StorageBuffer facade backed by a core Buffer.
+ *
+ * @internal
+ */
+export class RingStorageBuffer {
+    size;
+    access;
+    buffer;
+    constructor(buffer, access) {
+        this.buffer = buffer;
+        this.access = access;
+        this.size = buffer.options.size;
+    }
+    static create(device, bytes, access, label, indirect = false) {
+        const usage = indirect ? ["storage", "copy_dst", "copy_src", "indirect"] : ["storage", "copy_dst", "copy_src"];
+        const buffer = device.createBuffer({
+            size: bytes,
+            usage,
+            label,
+        });
+        return new RingStorageBuffer(buffer, access);
+    }
+    read() {
+        return this.buffer.read(this.size);
+    }
+    write(data, offset = 0) {
+        this.buffer.write(asWriteData(data), offset);
+    }
+    get gpu() {
+        return this.buffer.gpu;
+    }
+    get resourceIdentity() {
+        return this.buffer.resourceIdentity;
+    }
+    onDestroy(cb) {
+        return this.buffer.onDestroy(cb);
+    }
+    /** Frees the GPU allocation. Idempotent; bind groups holding it are invalidated through the buffer's destroy signal. */
+    destroy() {
+        this.buffer.destroy();
+    }
+}
+export function createStorageBuffer(device, bytes, access, label, indirect = false) {
+    return RingStorageBuffer.create(device, bytes, access, label, indirect);
+}
+/**
+ * Wraps an existing core buffer as an internal StorageBuffer facade.
+ *
+ * @internal
+ */
+export function wrapStorageBuffer(buffer, access) {
+    return new RingStorageBuffer(buffer, access);
+}
+function asWriteData(data) {
+    if (data instanceof ArrayBuffer)
+        return data;
+    if (ArrayBuffer.isView(data))
+        return data;
+    throw new TypeError("StorageBuffer.write() requires ArrayBuffer or ArrayBufferView.");
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/surface.d.ts

@@ -0,0 +1,89 @@
+import { Texture, type Device, type ResourceDestroyCallback, type ResourceIdentity, type UnsubscribeResourceDestroy } from "@aigpu/core";
+import { type ClearColor } from "./target-utils.ts";
+import type { RenderPassDescriptorOptions, Target } from "./target.ts";
+import { type Gpu } from "./kernel.ts";
+export interface SurfaceOptions {
+    readonly autoResize?: boolean;
+    /**
+     * Default clear color of this surface, used by passes that clear without naming a color.
+     * Defaults to `[0, 0, 0, 1]`; mutable at runtime through `surface.clearColor`.
+     */
+    readonly clearColor?: ClearColor;
+    readonly dpr?: number | readonly [number, number];
+    readonly size?: readonly [number, number];
+    readonly format?: GPUTextureFormat;
+    readonly alphaMode?: GPUCanvasAlphaMode;
+    readonly colorSpace?: PredefinedColorSpace;
+    readonly label?: string;
+}
+export interface SurfaceResizeEvent {
+    readonly width: number;
+    readonly height: number;
+    readonly dpr: number;
+    readonly surface: Surface;
+}
+export interface Surface extends Target {
+    readonly canvas: HTMLCanvasElement | OffscreenCanvas;
+    readonly context: GPUCanvasContext;
+    readonly autoResize: boolean;
+    readonly layoutBacked: boolean;
+    readonly dpr: number;
+    readonly disposed: boolean;
+    onResize(cb: (event: SurfaceResizeEvent) => void): () => void;
+    dispose(): void;
+}
+export type SurfaceCanvas = HTMLCanvasElement | OffscreenCanvas;
+/**
+ * Canvas render target of this gpu: configures the canvas context and keeps it sized.
+ *
+ * One live surface per canvas — a second `surface(gpu, canvas)` on the same canvas throws
+ * `AIGPU-SURFACE-DUPLICATE`, because reconfiguring a context out from under a live surface silently
+ * invalidates its textures. Disposing the surface frees the canvas for a new one.
+ *
+ * Lifecycle: the surface resizes itself right after the frame clock advances (auto-resize is a
+ * frame-state hook, so no rAF of its own), and it goes down with the gpu in the `resource` phase —
+ * after the loops stopped, before the caches and the device.
+ */
+export declare function surface(gpu: Gpu, canvas: SurfaceCanvas, opts?: SurfaceOptions): Surface;
+export declare function isSurfaceResizeCallbackActive(): boolean;
+export declare function isFrameActive(): boolean;
+export declare function enterFrame(): void;
+export declare function leaveFrame(): void;
+export declare function isSurface(target: unknown): target is CanvasSurface;
+export declare class CanvasSurface implements Surface {
+    #private;
+    private readonly device;
+    readonly canvas: SurfaceCanvas;
+    private readonly options;
+    private readonly unregister;
+    readonly resourceIdentity: ResourceIdentity;
+    readonly label: string | undefined;
+    readonly context: GPUCanvasContext;
+    readonly autoResize: boolean;
+    readonly layoutBacked: boolean;
+    readonly format: GPUTextureFormat;
+    constructor(device: Device, canvas: SurfaceCanvas, options: SurfaceOptions, unregister: (surface: CanvasSurface) => void);
+    get gpu(): unknown;
+    get size(): readonly [number, number];
+    get texelSize(): readonly [number, number];
+    get color(): Texture;
+    get colors(): readonly [Texture, ...Texture[]];
+    get depth(): undefined;
+    get sampleCount(): 1;
+    get dpr(): number;
+    /** Default clear color of this surface; passes that clear without naming a color use it. */
+    get clearColor(): ClearColor;
+    set clearColor(value: ClearColor);
+    get disposed(): boolean;
+    resize(size: readonly [number, number]): void;
+    applyAutoResize(): void;
+    onResize(cb: (event: SurfaceResizeEvent) => void): () => void;
+    read(): Promise<Uint8Array>;
+    readFloats(): Promise<Float32Array>;
+    onDestroy(cb: ResourceDestroyCallback<Target>): UnsubscribeResourceDestroy;
+    onTexturesRecreated(cb: () => void): () => void;
+    renderPassDescriptor(opts?: RenderPassDescriptorOptions): GPURenderPassDescriptor;
+    dispose(): void;
+}
+export declare function isLayoutBacked(canvas: unknown): boolean;
+//# sourceMappingURL=surface.d.ts.map

package/dist/surface.d.ts.map

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

package/dist/surface.js

@@ -0,0 +1,243 @@
+import { Texture, createResourceIdentity, DestroySignal } from "@aigpu/core";
+import { BUILT_IN_CLEAR_COLOR, colorValue, copyClearColor, sameSize, validateClearColor } from "./target-utils.js";
+import { surfaceAutoResizeUnsupportedError, surfaceContextError, surfaceDisposedError, surfaceDuplicateError, surfaceResizeReentrantError, } from "./errors.js";
+import { frameState } from "./frame-state.js";
+import { liveKernel } from "./live-kernel.js";
+import { serviceToken } from "./kernel.js";
+/**
+ * Canvas render target of this gpu: configures the canvas context and keeps it sized.
+ *
+ * One live surface per canvas — a second `surface(gpu, canvas)` on the same canvas throws
+ * `AIGPU-SURFACE-DUPLICATE`, because reconfiguring a context out from under a live surface silently
+ * invalidates its textures. Disposing the surface frees the canvas for a new one.
+ *
+ * Lifecycle: the surface resizes itself right after the frame clock advances (auto-resize is a
+ * frame-state hook, so no rAF of its own), and it goes down with the gpu in the `resource` phase —
+ * after the loops stopped, before the caches and the device.
+ */
+export function surface(gpu, canvas, opts = {}) {
+    const kernel = liveKernel(gpu, "surface");
+    const open = openSurfaces(kernel);
+    const existing = open.get(canvas);
+    if (existing && !existing.disposed)
+        throw surfaceDuplicateError(existing.label);
+    const created = new CanvasSurface(kernel.device, canvas, opts, (disposed) => {
+        if (open.get(disposed.canvas) === disposed)
+            open.delete(disposed.canvas);
+        releaseAutoResize();
+        releaseOwnership();
+    });
+    const releaseAutoResize = frameState(kernel).onAdvance(() => created.applyAutoResize());
+    const releaseOwnership = kernel.own("resource", () => created.dispose());
+    open.set(canvas, created);
+    return created;
+}
+/** Live surfaces of a gpu, keyed by canvas: the duplicate-configure guard, created on first surface. */
+const openSurfacesToken = serviceToken("surfaces");
+function openSurfaces(kernel) {
+    return kernel.service(openSurfacesToken, () => new Map());
+}
+let resizeCallbackDepth = 0;
+let frameDepth = 0;
+export function isSurfaceResizeCallbackActive() { return resizeCallbackDepth > 0; }
+export function isFrameActive() { return frameDepth > 0; }
+export function enterFrame() { frameDepth += 1; }
+export function leaveFrame() { frameDepth -= 1; }
+export function isSurface(target) { return target instanceof CanvasSurface; }
+export class CanvasSurface {
+    device;
+    canvas;
+    options;
+    unregister;
+    resourceIdentity = createResourceIdentity("render-target");
+    label;
+    context;
+    autoResize;
+    layoutBacked;
+    format;
+    #destroySignal = new DestroySignal();
+    #callbacks = new Set();
+    #texturesRecreatedCallbacks = new Set();
+    #currentDpr;
+    #clearColor;
+    #isDisposed = false;
+    #notifying = false;
+    constructor(device, canvas, options, unregister) {
+        this.device = device;
+        this.canvas = canvas;
+        this.options = options;
+        this.unregister = unregister;
+        this.label = options.label;
+        this.#clearColor = options.clearColor === undefined ? BUILT_IN_CLEAR_COLOR : validateClearColor(options.clearColor, "surface.clearColor");
+        const context = canvas.getContext("webgpu");
+        if (!context)
+            throw surfaceContextError();
+        this.context = context;
+        this.layoutBacked = isLayoutBacked(canvas);
+        if (options.autoResize === true && !this.layoutBacked)
+            throw surfaceAutoResizeUnsupportedError();
+        this.autoResize = options.autoResize ?? (options.size ? false : this.layoutBacked);
+        this.#currentDpr = effectiveDpr(options.dpr);
+        this.format = options.format ?? preferredCanvasFormat();
+        const initialSize = initialCanvasSize(canvas, options, this.layoutBacked, this.#currentDpr);
+        if (options.size || this.layoutBacked)
+            setCanvasSize(canvas, initialSize);
+        context.configure({
+            device: device.gpu,
+            format: this.format,
+            alphaMode: options.alphaMode ?? "premultiplied",
+            colorSpace: options.colorSpace ?? "srgb",
+            usage: canvasTextureUsage(),
+        });
+    }
+    get gpu() { return this.context; }
+    get size() { this.#assertLive(); return canvasSize(this.canvas); }
+    get texelSize() { const size = this.size; return [1 / size[0], 1 / size[1]]; }
+    get color() {
+        this.#assertLive();
+        return new Texture(this.device, this.context.getCurrentTexture(), {
+            size: this.size,
+            format: this.format,
+            usage: ["render_attachment", "texture_binding", "copy_src"],
+            label: this.options.label ? `${this.options.label}.color` : "surface.color",
+        }, "external");
+    }
+    get colors() { return [this.color]; }
+    get depth() { this.#assertLive(); return undefined; }
+    get sampleCount() { this.#assertLive(); return 1; }
+    get dpr() { return this.#currentDpr; }
+    /** Default clear color of this surface; passes that clear without naming a color use it. */
+    get clearColor() { return copyClearColor(this.#clearColor); }
+    set clearColor(value) { this.#clearColor = validateClearColor(value, "surface.clearColor"); }
+    get disposed() { return this.#isDisposed; }
+    resize(size) {
+        this.#assertLive();
+        if (this.#notifying)
+            throw surfaceResizeReentrantError(this.options.label);
+        this.#applyResize(sanitizeSize(size), this.#currentDpr, true);
+    }
+    applyAutoResize() {
+        if (this.#isDisposed || !this.autoResize || !this.layoutBacked)
+            return;
+        const nextDpr = effectiveDpr(this.options.dpr);
+        const nextSize = layoutCanvasSize(this.canvas, nextDpr);
+        this.#applyResize(nextSize, nextDpr, true);
+    }
+    onResize(cb) {
+        this.#assertLive();
+        this.#callbacks.add(cb);
+        this.#notifying = true;
+        resizeCallbackDepth += 1;
+        try {
+            cb(this.#event());
+        }
+        finally {
+            resizeCallbackDepth -= 1;
+            this.#notifying = false;
+        }
+        return () => { this.#callbacks.delete(cb); };
+    }
+    async read() { this.#assertLive(); return this.color.read(); }
+    async readFloats() { this.#assertLive(); return this.color.readFloats(); }
+    onDestroy(cb) { this.#assertLive(); return this.#destroySignal.onDestroy(this, cb); }
+    onTexturesRecreated(cb) { this.#assertLive(); this.#texturesRecreatedCallbacks.add(cb); return () => { this.#texturesRecreatedCallbacks.delete(cb); }; }
+    renderPassDescriptor(opts = {}) {
+        // Surfaces have no depth attachment; clearDepth, clearStencil, and depthReadOnly cannot apply.
+        const { clear = [0, 0, 0, 1], preserve } = opts;
+        this.#assertLive();
+        const attachment = { view: this.context.getCurrentTexture().createView(), loadOp: preserve ? "load" : "clear", storeOp: "store" };
+        if (!preserve)
+            attachment.clearValue = colorValue(clear);
+        return { colorAttachments: [attachment] };
+    }
+    dispose() {
+        if (this.#isDisposed)
+            return;
+        this.#isDisposed = true;
+        try {
+            this.context.unconfigure?.();
+        }
+        catch { /* ignore native cleanup failures */ }
+        this.unregister(this);
+        this.#callbacks.clear();
+        this.#texturesRecreatedCallbacks.clear();
+        this.#destroySignal.emit(this);
+    }
+    #applyResize(size, dpr, notify) {
+        const changed = !sameSize(canvasSize(this.canvas), size);
+        this.#currentDpr = dpr;
+        if (!changed)
+            return;
+        setCanvasSize(this.canvas, size);
+        this.#emitTexturesRecreated();
+        if (notify)
+            this.#notify();
+    }
+    #emitTexturesRecreated() {
+        for (const cb of [...this.#texturesRecreatedCallbacks])
+            cb();
+    }
+    #notify() {
+        this.#notifying = true;
+        resizeCallbackDepth += 1;
+        try {
+            const event = this.#event();
+            for (const cb of [...this.#callbacks])
+                cb(event);
+        }
+        finally {
+            resizeCallbackDepth -= 1;
+            this.#notifying = false;
+        }
+    }
+    #event() {
+        const size = canvasSize(this.canvas);
+        return { width: size[0], height: size[1], dpr: this.#currentDpr, surface: this };
+    }
+    #assertLive() {
+        if (this.#isDisposed)
+            throw surfaceDisposedError(this.options.label);
+    }
+}
+export function isLayoutBacked(canvas) {
+    return typeof canvas.clientWidth === "number";
+}
+function initialCanvasSize(canvas, options, layoutBacked, dpr) {
+    if (options.size)
+        return sanitizeSize(options.size);
+    if (layoutBacked)
+        return layoutCanvasSize(canvas, dpr);
+    return sanitizeSize(canvasSize(canvas));
+}
+function layoutCanvasSize(canvasLike, dpr) {
+    const canvas = canvasLike;
+    return sanitizeSize([Math.round(canvas.clientWidth * dpr), Math.round(canvas.clientHeight * dpr)]);
+}
+function canvasSize(canvasLike) {
+    const canvas = canvasLike;
+    return [canvas.width, canvas.height];
+}
+function setCanvasSize(canvasLike, size) {
+    const canvas = canvasLike;
+    canvas.width = size[0];
+    canvas.height = size[1];
+}
+function sanitizeSize(size) {
+    return [Math.max(1, Math.floor(size[0])), Math.max(1, Math.floor(size[1]))];
+}
+function effectiveDpr(dpr) {
+    const raw = globalThis.devicePixelRatio ?? 1;
+    if (Array.isArray(dpr))
+        return Math.min(dpr[1], Math.max(dpr[0], raw));
+    if (typeof dpr === "number")
+        return dpr;
+    return raw;
+}
+function preferredCanvasFormat() {
+    return globalThis.navigator?.gpu?.getPreferredCanvasFormat?.() ?? "bgra8unorm";
+}
+function canvasTextureUsage() {
+    const usage = globalThis.GPUTextureUsage;
+    return usage ? usage.RENDER_ATTACHMENT | usage.TEXTURE_BINDING | usage.COPY_SRC : undefined;
+}
+//# sourceMappingURL=surface.js.map