@yali-engine/render 0.0.0-stage → 0.4.0

package/dist/textures.d.ts

@@ -0,0 +1,165 @@
+/** A texture as the store takes it: square, power of two, every mip level, level 0 first (`@yali-engine/ktx2`'s `DecodedTexture`). */
+export interface TextureData {
+    readonly width: number;
+    readonly height: number;
+    readonly format: GPUTextureFormat;
+    readonly srgb: boolean;
+    readonly block: 1 | 4;
+    readonly blockBytes: number;
+    readonly levels: readonly Uint8Array[];
+}
+/** Which array a texture lives in: colour data is sRGB (base colour, emissive), the rest linear (normals, ORM). */
+export type ColorSpace = 'srgb' | 'linear';
+/**
+ * A texture in the store: an array layer, and the first array mip it may sample. A material
+ * refers to it; `minMip` falls as larger levels finish uploading (mips stream in smallest first).
+ */
+export declare class TextureRef {
+    #private;
+    readonly space: ColorSpace;
+    readonly layer: number;
+    /** Array mips above this texture's size (0 when it is the array's size). */
+    readonly sizeOffset: number;
+    /** The first array mip whose data is on the GPU (`sizeOffset` once fully uploaded). */
+    minMip: number;
+    /** Bytes the texture's levels hold (what the asset budget counts). */
+    readonly bytes: number;
+    /** Set when removed: the layer may hold another texture. */
+    released: boolean;
+    /** True when the texture lives in the RGBA8 arrays beside the device's compressed ones (ADR-0066). */
+    readonly rgba8: boolean;
+    constructor(space: ColorSpace, layer: number, sizeOffset: number, mips: number, bytes: number, rgba8?: boolean);
+    /** True once at least the smallest level is on the GPU. */
+    get resident(): boolean;
+    /** True when every level is on the GPU. */
+    get complete(): boolean;
+    /** @internal Marks nothing resident (the device was replaced). */
+    evict(): void;
+}
+/** The compressed family a store holds, chosen once per device (`@yali-engine/ktx2`'s `pickVariant`). */
+export type TextureFamily = 'bc7' | 'astc' | 'etc2' | 'rgba8';
+/** The device feature each family needs. */
+export declare const FAMILY_FEATURE: Readonly<Record<TextureFamily, GPUFeatureName | null>>;
+/** The first family in `prefer` a device with `features` can sample (BC7 on desktop, ASTC, ETC2, RGBA8). */
+export declare function pickFamily(features: ReadonlySet<string>, prefer?: readonly TextureFamily[]): TextureFamily;
+/**
+ * Where a `TextureStore`'s arrays live (ADR-0070): WebGPU (`webgpuTextureBackend`) or the
+ * WebGL2 backend's. The store keeps the layers, the data and the upload queue; a backend only
+ * creates, writes, copies and destroys arrays. Its handles are opaque to the store.
+ */
+export interface TextureBackend {
+    /** The device's most array layers. */
+    readonly maxLayers: number;
+    /** A `size`² array of `layers` layers and `mips` levels in `family`'s format for `space`. */
+    create(label: string, family: TextureFamily, space: ColorSpace, size: number, mips: number, layers: number): unknown;
+    destroy(texture: unknown): void;
+    /**
+     * Writes level `mip` of layer `layer`: `size`² texels, `physical`² as whole blocks (a level
+     * under 4×4 is one block: WebGPU copies the block, GL ES takes the level's true size), rows
+     * of `bytesPerRow`.
+     */
+    write(texture: unknown, family: TextureFamily, space: ColorSpace, mip: number, layer: number, data: Uint8Array, size: number, physical: number, bytesPerRow: number): void;
+    /**
+     * Copies every level of the first `layers` layers of `from` into `to` (an array that grew).
+     * Returns false when it cannot (WebGL2 copies compressed arrays no way): the store then
+     * uploads that array's textures again from their data.
+     */
+    copy(from: unknown, to: unknown, family: TextureFamily, size: number, mips: number, layers: number): boolean;
+    /** A 4×4 RGBA8 array, bound in place of an RGBA8 set nobody has used yet. */
+    placeholder(): unknown;
+}
+/** The WebGPU texture backend: arrays viewed as `2d-array` (compatibility mode fixes the view at creation). */
+export declare function webgpuTextureBackend(device: GPUDevice): TextureBackend;
+/**
+ * Material textures as `texture_2d_array`s of one size class (ADR-0060: DESIGN.md §11's
+ * material sets): sRGB for colour, linear for data, in the family the device samples, plus
+ * RGBA8 arrays created on the first uncompressed texture (decoded PNG / JPEG, ADR-0066) when
+ * the device's family is a compressed one. A texture takes one layer; a smaller one fills the
+ * lower mips of its layer and the shader clamps to them, a larger one drops its top levels.
+ * So one bind group serves every material, and per-instance materials need no draw splitting.
+ *
+ * Levels upload smallest first inside a per-frame budget (`pump`); a texture is sampled from
+ * its first resident mip meanwhile (`TextureRef.minMip`), so a large texture sharpens in
+ * instead of holding up a frame. Arrays grow by doubling (one GPU copy) up to the device's
+ * `maxTextureArrayLayers`.
+ *
+ * The store outlives devices: it keeps each texture's levels, and `attach` (at start and
+ * after device recovery) recreates the arrays and uploads them again.
+ *
+ * @example
+ * const textures = new TextureStore({ family: pickFamily(gpu.features), size: 1024 });
+ * textures.attach(gpu.device);
+ * const ref = textures.add(decoded); // a @yali-engine/ktx2 DecodedTexture
+ * materials.add({ baseColor: [1, 1, 1, 1], baseColorMap: ref });
+ */
+export declare class TextureStore {
+    #private;
+    readonly family: TextureFamily;
+    /** Texels per side of a layer (the tier's size class). */
+    readonly size: number;
+    /** Mip levels per layer (log2(size) + 1). */
+    readonly mips: number;
+    /** Bumped when a texture's resident mips change or the arrays change (materials re-pack). */
+    version: number;
+    /** Bumped when the GPU arrays are (re)created (bind groups must be rebuilt). */
+    arraysVersion: number;
+    readonly stats: {
+        uploads: number;
+        uploadBytes: number;
+        grows: number;
+        textures: number;
+    };
+    constructor(options: {
+        family: TextureFamily;
+        size: number;
+        layers?: number;
+    });
+    /** The GPU format of one of the device-family arrays. */
+    format(space: ColorSpace): GPUTextureFormat;
+    /** (Re)creates the arrays on a WebGPU `device` and queues every texture's levels again. */
+    attach(device: GPUDevice): void;
+    /** (Re)creates the arrays on `backend` (WebGPU or WebGL2) and queues every texture's levels again. */
+    attachBackend(backend: TextureBackend): void;
+    /** The device-family array of one colour space (bind it viewed as `2d-array`). WebGPU only. */
+    texture(space: ColorSpace): GPUTexture;
+    /**
+     * The backend's array of one colour space: the device family's, or (`rgba8`) the RGBA8 one,
+     * which is the device family's when that is RGBA8 and a 4×4 placeholder until the first
+     * uncompressed texture arrives (ADR-0066).
+     */
+    array(space: ColorSpace, rgba8: boolean): unknown;
+    /**
+     * The RGBA8 array of one colour space: the device-family array when the family is RGBA8, a
+     * 4×4 placeholder until the first uncompressed texture arrives (ADR-0066).
+     */
+    rgba8Texture(space: ColorSpace): GPUTexture;
+    /** The material sampler (trilinear, 4× anisotropic, repeat). */
+    get sampler(): GPUSampler;
+    /**
+     * Takes a layer for `t` and queues its levels (smallest first). A texture of the device's
+     * family goes to its arrays, an RGBA8 one to the RGBA8 arrays; any other format is refused.
+     * Throws when an array is full at the device's limit.
+     */
+    add(t: TextureData): TextureRef;
+    /** Frees a texture's layer for reuse (its queued uploads are dropped). */
+    remove(ref: TextureRef): void;
+    /** Uploads queued levels for about `budgetMs` (at least one when any is queued). Returns how many. */
+    pump(budgetMs?: number): number;
+    /** Levels waiting for upload. */
+    get queued(): number;
+    /** GPU bytes of the arrays (the memory counter). */
+    get gpuBytes(): number;
+    /** Destroys the GPU arrays (the textures' data stays for a later `attach`). */
+    detach(): void;
+}
+/** A texture slot's state for the shader: none, sampled, or missing (drawn as a magenta checker). */
+export declare const TEXTURE_SLOT: {
+    readonly none: 0;
+    readonly ok: 1;
+    readonly missing: 2;
+};
+/**
+ * Packs a material's texture slot for the shader: state << 24 | RGBA8 array << 21 | first mip
+ * << 16 | layer (bits 26–31 of the first slot carry the material's shader, ADR-0064).
+ */
+export declare function packTextureSlot(ref: TextureRef | null | undefined, missing?: boolean): number;

package/dist/textures.js

@@ -0,0 +1,361 @@
+import { YaliError } from '@yali-engine/core';
+/**
+ * A texture in the store: an array layer, and the first array mip it may sample. A material
+ * refers to it; `minMip` falls as larger levels finish uploading (mips stream in smallest first).
+ */
+export class TextureRef {
+    space;
+    layer;
+    /** Array mips above this texture's size (0 when it is the array's size). */
+    sizeOffset;
+    /** The first array mip whose data is on the GPU (`sizeOffset` once fully uploaded). */
+    minMip;
+    /** Bytes the texture's levels hold (what the asset budget counts). */
+    bytes;
+    /** Set when removed: the layer may hold another texture. */
+    released = false;
+    #mips;
+    /** True when the texture lives in the RGBA8 arrays beside the device's compressed ones (ADR-0066). */
+    rgba8;
+    constructor(space, layer, sizeOffset, mips, bytes, rgba8 = false) {
+        this.space = space;
+        this.layer = layer;
+        this.rgba8 = rgba8;
+        this.sizeOffset = sizeOffset;
+        this.bytes = bytes;
+        this.#mips = mips;
+        this.minMip = mips; // nothing resident yet
+    }
+    /** True once at least the smallest level is on the GPU. */
+    get resident() {
+        return this.minMip < this.#mips;
+    }
+    /** True when every level is on the GPU. */
+    get complete() {
+        return this.minMip === this.sizeOffset;
+    }
+    /** @internal Marks nothing resident (the device was replaced). */
+    evict() {
+        this.minMip = this.#mips;
+    }
+}
+const FORMATS = {
+    bc7: { srgb: 'bc7-rgba-unorm-srgb', linear: 'bc7-rgba-unorm' },
+    astc: { srgb: 'astc-4x4-unorm-srgb', linear: 'astc-4x4-unorm' },
+    etc2: { srgb: 'etc2-rgba8unorm-srgb', linear: 'etc2-rgba8unorm' },
+    rgba8: { srgb: 'rgba8unorm-srgb', linear: 'rgba8unorm' },
+};
+/** The device feature each family needs. */
+export const FAMILY_FEATURE = {
+    bc7: 'texture-compression-bc',
+    astc: 'texture-compression-astc',
+    etc2: 'texture-compression-etc2',
+    rgba8: null,
+};
+/** The first family in `prefer` a device with `features` can sample (BC7 on desktop, ASTC, ETC2, RGBA8). */
+export function pickFamily(features, prefer = ['bc7', 'astc', 'etc2', 'rgba8']) {
+    return prefer.find((f) => FAMILY_FEATURE[f] === null || features.has(FAMILY_FEATURE[f])) ?? 'rgba8';
+}
+/** The WebGPU texture backend: arrays viewed as `2d-array` (compatibility mode fixes the view at creation). */
+export function webgpuTextureBackend(device) {
+    return {
+        maxLayers: device.limits.maxTextureArrayLayers,
+        create: (label, family, space, size, mips, layers) => device.createTexture({
+            label,
+            size: { width: size, height: size, depthOrArrayLayers: layers },
+            mipLevelCount: mips,
+            format: FORMATS[family][space],
+            usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.COPY_SRC,
+            textureBindingViewDimension: '2d-array',
+        }),
+        destroy: (t) => t.destroy(),
+        write: (t, _family, _space, mip, layer, data, _size, physical, bytesPerRow) => device.queue.writeTexture({ texture: t, mipLevel: mip, origin: { x: 0, y: 0, z: layer } }, data, { bytesPerRow, rowsPerImage: data.byteLength / bytesPerRow }, { width: physical, height: physical, depthOrArrayLayers: 1 }),
+        copy: (from, to, family, size, mips, layers) => {
+            const enc = device.createCommandEncoder({ label: 'yali:textures:grow' });
+            for (let m = 0; m < mips; m++) {
+                const s = Math.max(1, size >> m);
+                const physical = family === 'rgba8' ? s : Math.ceil(s / 4) * 4;
+                enc.copyTextureToTexture({ texture: from, mipLevel: m }, { texture: to, mipLevel: m }, { width: physical, height: physical, depthOrArrayLayers: layers });
+            }
+            device.queue.submit([enc.finish()]);
+            return true;
+        },
+        placeholder: () => device.createTexture({
+            label: 'yali:textures:placeholder',
+            size: { width: 4, height: 4, depthOrArrayLayers: 1 },
+            format: 'rgba8unorm',
+            usage: GPUTextureUsage.TEXTURE_BINDING,
+            textureBindingViewDimension: '2d-array',
+        }),
+    };
+}
+/**
+ * Material textures as `texture_2d_array`s of one size class (ADR-0060: DESIGN.md §11's
+ * material sets): sRGB for colour, linear for data, in the family the device samples, plus
+ * RGBA8 arrays created on the first uncompressed texture (decoded PNG / JPEG, ADR-0066) when
+ * the device's family is a compressed one. A texture takes one layer; a smaller one fills the
+ * lower mips of its layer and the shader clamps to them, a larger one drops its top levels.
+ * So one bind group serves every material, and per-instance materials need no draw splitting.
+ *
+ * Levels upload smallest first inside a per-frame budget (`pump`); a texture is sampled from
+ * its first resident mip meanwhile (`TextureRef.minMip`), so a large texture sharpens in
+ * instead of holding up a frame. Arrays grow by doubling (one GPU copy) up to the device's
+ * `maxTextureArrayLayers`.
+ *
+ * The store outlives devices: it keeps each texture's levels, and `attach` (at start and
+ * after device recovery) recreates the arrays and uploads them again.
+ *
+ * @example
+ * const textures = new TextureStore({ family: pickFamily(gpu.features), size: 1024 });
+ * textures.attach(gpu.device);
+ * const ref = textures.add(decoded); // a @yali-engine/ktx2 DecodedTexture
+ * materials.add({ baseColor: [1, 1, 1, 1], baseColorMap: ref });
+ */
+export class TextureStore {
+    family;
+    /** Texels per side of a layer (the tier's size class). */
+    size;
+    /** Mip levels per layer (log2(size) + 1). */
+    mips;
+    /** Bumped when a texture's resident mips change or the arrays change (materials re-pack). */
+    version = 0;
+    /** Bumped when the GPU arrays are (re)created (bind groups must be rebuilt). */
+    arraysVersion = 0;
+    stats = { uploads: 0, uploadBytes: 0, grows: 0, textures: 0 };
+    #backend = null;
+    #sampler = null;
+    /** `srgb`, `linear` (the device's family) and, once used, `srgb+rgba8`, `linear+rgba8`. */
+    #sets = new Map();
+    /** Bound in place of an RGBA8 set nobody has used yet. */
+    #placeholder = null;
+    #data = new Map();
+    #queue = [];
+    #initialLayers;
+    constructor(options) {
+        const pow2 = (n) => n > 0 && (n & (n - 1)) === 0;
+        if (!pow2(options.size))
+            throw new YaliError('TEXTURE_SIZE', `The texture size class ${options.size} is not a power of two.`, 'Use 256, 512, 1024 or 2048.');
+        this.family = options.family;
+        this.size = options.size;
+        this.mips = Math.log2(options.size) + 1;
+        this.#initialLayers = Math.max(1, options.layers ?? 1);
+        for (const space of ['srgb', 'linear'])
+            this.#set(space, this.family);
+    }
+    /** The GPU format of one of the device-family arrays. */
+    format(space) {
+        return FORMATS[this.family][space];
+    }
+    #key(space, family) {
+        return family === this.family ? space : `${space}+${family}`;
+    }
+    #set(space, family) {
+        const key = this.#key(space, family);
+        let s = this.#sets.get(key);
+        if (!s) {
+            s = { space, family, texture: null, count: this.#initialLayers, free: [], next: 0 };
+            this.#sets.set(key, s);
+            if (this.#backend) {
+                s.texture = this.#create(s, s.count);
+                this.arraysVersion++;
+            }
+        }
+        return s;
+    }
+    /** (Re)creates the arrays on a WebGPU `device` and queues every texture's levels again. */
+    attach(device) {
+        this.attachBackend(webgpuTextureBackend(device));
+        this.#sampler = device.createSampler({ label: 'yali:textures', addressModeU: 'repeat', addressModeV: 'repeat', magFilter: 'linear', minFilter: 'linear', mipmapFilter: 'linear', maxAnisotropy: 4 });
+    }
+    /** (Re)creates the arrays on `backend` (WebGPU or WebGL2) and queues every texture's levels again. */
+    attachBackend(backend) {
+        this.#release();
+        this.#backend = backend;
+        this.#sampler = null;
+        for (const s of this.#sets.values()) {
+            s.count = Math.min(Math.max(s.count, s.next), backend.maxLayers);
+            s.texture = this.#create(s, s.count);
+        }
+        this.#placeholder = backend.placeholder();
+        this.#queue = [];
+        for (const [ref, t] of this.#data) {
+            ref.evict();
+            this.#enqueue(ref, t);
+        }
+        this.arraysVersion++;
+        this.version++;
+    }
+    /** The device-family array of one colour space (bind it viewed as `2d-array`). WebGPU only. */
+    texture(space) {
+        return this.array(space, false);
+    }
+    /**
+     * The backend's array of one colour space: the device family's, or (`rgba8`) the RGBA8 one,
+     * which is the device family's when that is RGBA8 and a 4×4 placeholder until the first
+     * uncompressed texture arrives (ADR-0066).
+     */
+    array(space, rgba8) {
+        const t = rgba8 && this.family !== 'rgba8' ? (this.#sets.get(this.#key(space, 'rgba8'))?.texture ?? this.#placeholder) : this.#sets.get(space)?.texture;
+        if (!t)
+            throw new YaliError('TEXTURES_DETACHED', 'The texture store has no device yet.', 'Call textures.attach(device) first (the render plugin does).');
+        return t;
+    }
+    /**
+     * The RGBA8 array of one colour space: the device-family array when the family is RGBA8, a
+     * 4×4 placeholder until the first uncompressed texture arrives (ADR-0066).
+     */
+    rgba8Texture(space) {
+        return this.array(space, true);
+    }
+    /** The material sampler (trilinear, 4× anisotropic, repeat). */
+    get sampler() {
+        if (!this.#sampler)
+            throw new YaliError('TEXTURES_DETACHED', 'The texture store has no device yet.', 'Call textures.attach(device) first (the render plugin does).');
+        return this.#sampler;
+    }
+    #create(s, layers) {
+        return this.#backend.create(`yali:textures:${s.space}:${s.family}`, s.family, s.space, this.size, this.mips, layers);
+    }
+    /**
+     * Takes a layer for `t` and queues its levels (smallest first). A texture of the device's
+     * family goes to its arrays, an RGBA8 one to the RGBA8 arrays; any other format is refused.
+     * Throws when an array is full at the device's limit.
+     */
+    add(t) {
+        const space = t.srgb ? 'srgb' : 'linear';
+        const family = t.format === FORMATS[this.family][space] ? this.family : t.format === FORMATS.rgba8[space] ? 'rgba8' : null;
+        if (!family) {
+            throw new YaliError('TEXTURE_FORMAT', `The texture is ${t.format}; this device's ${space} textures are ${this.format(space)} (or ${FORMATS.rgba8[space]}).`, 'Load the variant for this device (`variantPath(path, pickVariant(features))` from @yali-engine/ktx2), or convert the texture (`yali convert`).');
+        }
+        const s = this.#set(space, family);
+        let layer = s.free.pop();
+        if (layer === undefined) {
+            if (s.next === s.count)
+                this.#grow(s, s.count * 2);
+            layer = s.next++;
+        }
+        const sizeOffset = Math.max(0, this.mips - 1 - Math.log2(t.width));
+        const ref = new TextureRef(space, layer, sizeOffset, this.mips, t.levels.reduce((n, lv) => n + lv.byteLength, 0), family === 'rgba8' && this.family !== 'rgba8');
+        this.#data.set(ref, t);
+        if (this.#backend)
+            this.#enqueue(ref, t);
+        this.stats.textures++;
+        return ref;
+    }
+    #enqueue(ref, t) {
+        const drop = Math.max(0, Math.log2(t.width) - (this.mips - 1)); // levels too large for the array
+        for (let lv = t.levels.length - 1; lv >= drop; lv--) {
+            this.#queue.push({ ref, mip: ref.sizeOffset + lv - drop, data: t.levels[lv], size: Math.max(1, t.width >> lv), block: t.block, blockBytes: t.blockBytes });
+        }
+    }
+    #setOf(ref) {
+        return this.#sets.get(this.#key(ref.space, ref.rgba8 ? 'rgba8' : this.family));
+    }
+    /** Frees a texture's layer for reuse (its queued uploads are dropped). */
+    remove(ref) {
+        if (ref.released)
+            return;
+        ref.released = true;
+        this.#data.delete(ref);
+        this.#queue = this.#queue.filter((u) => u.ref !== ref);
+        this.#setOf(ref).free.push(ref.layer);
+        this.stats.textures--;
+        this.version++;
+    }
+    /** Uploads queued levels for about `budgetMs` (at least one when any is queued). Returns how many. */
+    pump(budgetMs = 1) {
+        if (this.#queue.length === 0 || !this.#backend)
+            return 0;
+        const start = performance.now();
+        let n = 0;
+        while (this.#queue.length > 0 && (n === 0 || performance.now() - start < budgetMs)) {
+            const u = this.#queue.shift();
+            const blocks = Math.ceil(u.size / u.block);
+            const physical = blocks * u.block; // a mip under 4×4 is copied as one whole block
+            const s = this.#setOf(u.ref);
+            this.#backend.write(s.texture, s.family, s.space, u.mip, u.ref.layer, u.data, u.size, physical, blocks * u.blockBytes);
+            u.ref.minMip = Math.min(u.ref.minMip, u.mip);
+            this.stats.uploads++;
+            this.stats.uploadBytes += u.data.byteLength;
+            n++;
+        }
+        this.version++;
+        return n;
+    }
+    /** Levels waiting for upload. */
+    get queued() {
+        return this.#queue.length;
+    }
+    #grow(s, layers) {
+        const max = this.#backend?.maxLayers ?? 256;
+        if (s.count >= max) {
+            throw new YaliError('TEXTURES_FULL', `The ${s.space} ${s.family} texture array is full: ${s.count} layers, the device's maxTextureArrayLayers.`, 'Lower the texture count, or let the asset budget evict unused textures.');
+        }
+        const count = Math.min(layers, max);
+        const old = s.texture;
+        if (this.#backend && old) {
+            const next = this.#create(s, count);
+            const copied = this.#backend.copy(old, next, s.family, this.size, this.mips, s.count);
+            this.#backend.destroy(old);
+            s.texture = next;
+            if (!copied) {
+                for (const [ref, t] of this.#data) {
+                    if (this.#setOf(ref) !== s)
+                        continue;
+                    ref.evict();
+                    this.#queue = this.#queue.filter((u) => u.ref !== ref);
+                    this.#enqueue(ref, t);
+                }
+            }
+            this.arraysVersion++;
+            this.version++;
+        }
+        s.count = count;
+        this.stats.grows++;
+    }
+    /** GPU bytes of the arrays (the memory counter). */
+    get gpuBytes() {
+        let n = 0;
+        for (const s of this.#sets.values()) {
+            if (!s.texture)
+                continue;
+            for (let m = 0; m < this.mips; m++) {
+                const size = Math.max(1, this.size >> m);
+                n += (s.family === 'rgba8' ? size * size * 4 : Math.ceil(size / 4) ** 2 * 16) * s.count;
+            }
+        }
+        return n;
+    }
+    #release() {
+        const b = this.#backend;
+        for (const s of this.#sets.values()) {
+            if (b && s.texture)
+                b.destroy(s.texture);
+            s.texture = null;
+        }
+        if (b && this.#placeholder)
+            b.destroy(this.#placeholder);
+        this.#placeholder = null;
+    }
+    /** Destroys the GPU arrays (the textures' data stays for a later `attach`). */
+    detach() {
+        this.#release();
+        this.#backend = null;
+        this.#sampler = null;
+        this.#queue = [];
+    }
+}
+/** A texture slot's state for the shader: none, sampled, or missing (drawn as a magenta checker). */
+export const TEXTURE_SLOT = { none: 0, ok: 1, missing: 2 };
+/**
+ * Packs a material's texture slot for the shader: state << 24 | RGBA8 array << 21 | first mip
+ * << 16 | layer (bits 26–31 of the first slot carry the material's shader, ADR-0064).
+ */
+export function packTextureSlot(ref, missing = false) {
+    if (missing)
+        return TEXTURE_SLOT.missing << 24;
+    if (!ref || ref.released || !ref.resident)
+        return TEXTURE_SLOT.none;
+    return (TEXTURE_SLOT.ok << 24) | ((ref.rgba8 ? 1 : 0) << 21) | ((ref.minMip & 0x1f) << 16) | (ref.layer & 0xffff);
+}
+//# sourceMappingURL=textures.js.map

package/dist/textures.js.map

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

package/dist/tonemap.d.ts

@@ -0,0 +1,45 @@
+import type { FrameGraph } from './frame-graph.ts';
+import type { PipelineCache } from './pipeline-cache.ts';
+import { type GradingOptions } from './post-options.ts';
+/** Tone curves (`shaders/post/curves.wesl`). */
+export type ToneCurve = 'neutral' | 'aces' | 'none';
+/** Each curve's number in the shaders. */
+export declare const CURVES: Readonly<Record<ToneCurve, number>>;
+/**
+ * `tone_map` of `shaders/post/curves.wesl` in TS: linear `rgb` times `exposure`, through
+ * `curve`, sRGB-encoded, into `out`. For colours the CPU hands the display directly (the clear
+ * colour when the draw tone-maps inline, ADR-0071).
+ */
+export declare function toneMapColor(rgb: readonly number[], exposure: number, curve: ToneCurve, out?: number[]): number[];
+/** Bytes of `ToneParams` (`shaders/post/tonemap.wesl`). */
+export declare const TONE_PARAMS_BYTES = 80;
+/**
+ * Writes `ToneParams`: exposure and curve, the bloom's weight (0: none) and the grading
+ * (`grading.enabled` false: none, so the pass is the plain tone map).
+ */
+export declare function writeToneParams(out: DataView, exposure: number, curve: ToneCurve, bloom: number, grading: (Required<GradingOptions> & {
+    enabled: boolean;
+}) | null): void;
+/**
+ * The tone-mapping pass (M2 increment 5): reads the scene's linear HDR target and writes the
+ * swapchain through exposure, a curve (Khronos PBR Neutral by default) and the sRGB transfer
+ * function. One full-screen triangle; its bind group follows the graph's reallocations.
+ */
+export declare class ToneMapper {
+    #private;
+    readonly device: GPUDevice;
+    /** Linear multiplier before the curve. */
+    exposure: number;
+    curve: ToneCurve;
+    /** The bloom chain's weight (set by the post chain; 0 without bloom). */
+    bloom: number;
+    /** Colour grading (ADR-0092), or null. */
+    grading: (Required<GradingOptions> & {
+        enabled: boolean;
+    }) | null;
+    constructor(device: GPUDevice, format: GPUTextureFormat);
+    init(cache: PipelineCache): Promise<void>;
+    /** Adds `post.tonemap`, reading `input` (and `bloom`'s chain, if any) and writing `output`. */
+    addPass(graph: FrameGraph, input: string, output: string, bloom?: string): void;
+    destroy(): void;
+}