@nodetool-ai/gpu 0.8.1

package/dist/recipe.d.ts

@@ -0,0 +1,148 @@
+/**
+ * `RecipeModule` + `RecipeRunner` — multi-pass orchestration.
+ *
+ * A recipe module is a registry-visible operation whose work is expressed as
+ * a small DAG of single-pass `ShaderModule` invocations rather than a single
+ * shader. `RecipeRunner.encode` walks the passes, acquires intermediate
+ * textures from `ctx.scratch`, dispatches each pass through the shared
+ * `Executor`, and releases intermediates in reverse order on return.
+ *
+ * Intermediate formats are declared in the module — not chosen by the host —
+ * so a recipe like `filters.glow` produces the same output everywhere.
+ *
+ * Like `Executor.encode`, the runner encodes GPU work only: no readback, no
+ * `copyTextureToBuffer`, no `mapAsync`. The host owns submission and the
+ * final output texture's lifetime.
+ */
+import type { AnyVecInstance } from "typegpu/data";
+import type { GPUContext } from "./context.js";
+import type { Executor } from "./executor.js";
+import { type ShaderModule } from "./module.js";
+import type { ShaderRegistry } from "./registry.js";
+import type { LabeledTexture } from "./texture.js";
+import type { IOContract, ShaderCategory, ShaderSurface, UiHint } from "./types.js";
+/** A JSON path into the recipe's params, e.g. `"$.radius"`. */
+export type ParamRef = `$.${string}`;
+/**
+ * A literal param value: what a module's WGSL uniform field can hold — a
+ * scalar, or a TypeGPU vector instance such as `d.vec2f(1, 0)`.
+ */
+export type RecipeParamLiteral = number | boolean | AnyVecInstance;
+/** A recipe's own params: a flat bag of uniform literals, addressed by `$.name`. */
+export type RecipeParams = Record<string, RecipeParamLiteral>;
+/** A pass's param value: a literal, or a {@link ParamRef} into the recipe's params. */
+export type RecipeParamValue = ParamRef | RecipeParamLiteral;
+/** Intermediate texture specification. Sizes default to the input source. */
+export interface IntermediateSpec {
+    format: GPUTextureFormat;
+    usage: GPUTextureUsageFlags;
+    /** Defaults to the source dimensions if omitted. */
+    width?: number;
+    height?: number;
+    label?: string;
+}
+/** A single Executor dispatch inside a recipe. */
+export interface RecipePass {
+    /** `(id, version)` of the `ShaderModule` to invoke. */
+    op: {
+        id: string;
+        version: number;
+    };
+    /**
+     * Map a module input name to either `"source"` (the recipe's main input,
+     * the same `source` the recipe was called with) or a named intermediate.
+     * Use `{ name, from }` to bind a recipe input under a different key — that
+     * supports `mask` and other non-`source` slots without forcing renames.
+     */
+    in: Record<string, "source" | {
+        kind: "intermediate";
+        name: string;
+    } | {
+        kind: "input";
+        name: string;
+    }>;
+    /** `"output"` (the recipe's final target) or a named intermediate. */
+    out: "output" | {
+        kind: "intermediate";
+        name: string;
+    };
+    /** Param values: literals or `ParamRef`s into the recipe's params object. */
+    params: Record<string, RecipeParamValue>;
+    /**
+     * Compute dispatch sizing. Fragment passes omit it (always full-screen).
+     * If the workgroup size is `[wx, wy, 1]`, set `kind: "compute"` and the
+     * runner derives `(ceil(width/wx), ceil(height/wy))` from the **output**
+     * texture's dimensions; pass an explicit `x`/`y` to override.
+     */
+    dispatch?: {
+        kind: "fragment";
+    } | {
+        kind: "compute";
+        x?: number;
+        y?: number;
+        z?: number;
+    };
+}
+/** Declarative recipe payload bundled with a {@link RecipeModule}. */
+export interface Recipe<Params> {
+    intermediates: Record<string, IntermediateSpec>;
+    passes: readonly RecipePass[];
+    /**
+     * Optional resolver. Default uses the `(id, version)` registry. Recipes
+     * may pass a partial registry (a `Map`) for unit testing.
+     */
+    resolve?: (op: {
+        id: string;
+        version: number;
+    }) => ShaderModule;
+    /**
+     * Optional type-only marker so `Recipe<P>` instances retain the params type
+     * after registration. Never read at runtime.
+     */
+    readonly _params?: Params;
+}
+/**
+ * A module whose execution is a recipe of single-pass `ShaderModule` calls.
+ * Lives in the same registry as `ShaderModule` (Phase 3 onward), but has no
+ * own WGSL — its `kind` is `"recipe"`.
+ */
+export interface RecipeModule<Params = RecipeParams> {
+    readonly id: string;
+    readonly version: number;
+    readonly surface: ShaderSurface;
+    readonly category: ShaderCategory;
+    readonly kind: "recipe";
+    readonly paramDefaults: Params;
+    readonly paramUi?: Readonly<Record<string, UiHint>>;
+    readonly io: IOContract;
+    readonly recipe: Recipe<Params>;
+}
+/** Build a frozen {@link RecipeModule}. */
+export declare function defineRecipe<Params extends RecipeParams>(spec: {
+    id: string;
+    version: number;
+    surface: ShaderSurface;
+    category: ShaderCategory;
+    paramDefaults: Params;
+    paramUi?: Record<string, UiHint>;
+    io: IOContract;
+    recipe: Recipe<Params>;
+}): RecipeModule<Params>;
+/** Run a recipe end-to-end against a context, encoder, and output target. */
+export interface RecipeRunner {
+    encode<P>(args: {
+        ctx: GPUContext;
+        module: RecipeModule<P>;
+        encoder: GPUCommandEncoder;
+        inputs: Record<string, LabeledTexture>;
+        output: LabeledTexture;
+        params: P;
+        /** Optional registry for op resolution; falls back to `recipe.resolve`. */
+        registry?: ShaderRegistry;
+        /** Optional executor; default `createExecutor()` is fine for most cases. */
+        executor?: Executor;
+    }): void;
+}
+/** Default {@link RecipeRunner}: scratch-pool intermediates, sequential passes. */
+export declare function createRecipeRunner(): RecipeRunner;
+//# sourceMappingURL=recipe.d.ts.map

package/dist/recipe.d.ts.map

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

package/dist/recipe.js

@@ -0,0 +1,181 @@
+/**
+ * `RecipeModule` + `RecipeRunner` — multi-pass orchestration.
+ *
+ * A recipe module is a registry-visible operation whose work is expressed as
+ * a small DAG of single-pass `ShaderModule` invocations rather than a single
+ * shader. `RecipeRunner.encode` walks the passes, acquires intermediate
+ * textures from `ctx.scratch`, dispatches each pass through the shared
+ * `Executor`, and releases intermediates in reverse order on return.
+ *
+ * Intermediate formats are declared in the module — not chosen by the host —
+ * so a recipe like `filters.glow` produces the same output everywhere.
+ *
+ * Like `Executor.encode`, the runner encodes GPU work only: no readback, no
+ * `copyTextureToBuffer`, no `mapAsync`. The host owns submission and the
+ * final output texture's lifetime.
+ */
+import { createExecutor } from "./executor.js";
+import { moduleKey } from "./module.js";
+/** Build a frozen {@link RecipeModule}. */
+export function defineRecipe(spec) {
+    if (!spec.id) {
+        throw new Error("defineRecipe: id is required");
+    }
+    if (!Number.isInteger(spec.version) || spec.version < 1) {
+        throw new Error(`defineRecipe(${spec.id}): version must be a positive integer`);
+    }
+    if (spec.recipe.passes.length === 0) {
+        throw new Error(`defineRecipe(${spec.id}): recipe must have ≥1 pass`);
+    }
+    return Object.freeze({
+        id: spec.id,
+        version: spec.version,
+        surface: spec.surface,
+        category: spec.category,
+        kind: "recipe",
+        paramDefaults: spec.paramDefaults,
+        paramUi: spec.paramUi,
+        io: spec.io,
+        recipe: spec.recipe
+    });
+}
+function isParamRef(value) {
+    return typeof value === "string" && value.startsWith("$.");
+}
+function readPath(params, path) {
+    // Strip leading `$.`; recipes are intentionally shallow (no nesting yet).
+    return params[path.slice(2)];
+}
+function resolveParams(raw, recipeParams) {
+    const out = {};
+    for (const [name, value] of Object.entries(raw)) {
+        out[name] = isParamRef(value) ? readPath(recipeParams, value) : value;
+    }
+    return out;
+}
+function resolveOp(pass, recipe, registry, recipeKey) {
+    if (recipe.resolve) {
+        return recipe.resolve(pass.op);
+    }
+    if (!registry) {
+        throw new Error(`RecipeRunner(${recipeKey}): no registry or recipe.resolve to resolve ${pass.op.id}@${pass.op.version}`);
+    }
+    return registry.getShader(pass.op);
+}
+/** Default {@link RecipeRunner}: scratch-pool intermediates, sequential passes. */
+export function createRecipeRunner() {
+    return {
+        encode({ ctx, module, encoder, inputs, output, params, registry, executor }) {
+            const ex = executor ?? createExecutor();
+            const recipe = module.recipe;
+            const key = moduleKey(module.id, module.version);
+            const source = inputs.source;
+            if (!source) {
+                throw new Error(`RecipeRunner(${key}): missing "source" input`);
+            }
+            // Resolve intermediates, defaulting unspecified dimensions to source.
+            const intermediates = new Map();
+            const acquired = [];
+            for (const [name, spec] of Object.entries(recipe.intermediates)) {
+                const fullSpec = {
+                    width: spec.width ?? source.width,
+                    height: spec.height ?? source.height,
+                    // Exact size, not bucketed: passes derive dispatch size and texel
+                    // bounds from the texture's physical dimensions, and fragment
+                    // passes always cover the whole attachment. A bucketed intermediate
+                    // therefore either leaves an unwritten margin that the next pass's
+                    // clamped taps blend in (compute) or stretches the image to the
+                    // bucket and back, rescaling pixel-unit params like blur radius
+                    // (fragment). Physical size must equal logical size.
+                    exact: true,
+                    format: spec.format,
+                    usage: spec.usage,
+                    label: spec.label ?? `${key}-${name}`
+                };
+                const tex = ctx.scratch.acquire(fullSpec);
+                intermediates.set(name, tex);
+                acquired.push(tex);
+            }
+            try {
+                for (const pass of recipe.passes) {
+                    const op = resolveOp(pass, recipe, registry, key);
+                    // Map declared `in` bindings to actual labeled textures.
+                    const passInputs = {};
+                    for (const [bindName, ref] of Object.entries(pass.in)) {
+                        if (ref === "source") {
+                            passInputs[bindName] = source;
+                            continue;
+                        }
+                        if (ref.kind === "intermediate") {
+                            const tex = intermediates.get(ref.name);
+                            if (!tex) {
+                                throw new Error(`RecipeRunner(${key}): unknown intermediate "${ref.name}"`);
+                            }
+                            passInputs[bindName] = tex;
+                            continue;
+                        }
+                        // ref.kind === "input"
+                        const tex = inputs[ref.name];
+                        if (!tex) {
+                            throw new Error(`RecipeRunner(${key}): pass binds "${bindName}" to recipe input "${ref.name}" but that input is unbound`);
+                        }
+                        passInputs[bindName] = tex;
+                    }
+                    const target = pass.out === "output"
+                        ? output
+                        : intermediates.get(pass.out.name) ??
+                            (() => {
+                                throw new Error(`RecipeRunner(${key}): unknown intermediate "${pass.out.name}"`);
+                            })();
+                    // SAFETY: `defineRecipe` constrains a recipe's params to
+                    // `RecipeParams` — a flat bag of uniform literals. `P` is
+                    // unconstrained here only so hosts can thread their own generic
+                    // through `encode`; every module that reaches this line was built
+                    // by `defineRecipe`.
+                    const resolvedParams = resolveParams(pass.params, params);
+                    const dispatch = resolveDispatch(pass, op, target);
+                    ex.encode({
+                        ctx,
+                        module: op,
+                        encoder,
+                        inputs: passInputs,
+                        output: target,
+                        params: resolvedParams,
+                        dispatch
+                    });
+                }
+            }
+            finally {
+                for (const tex of acquired.reverse()) {
+                    ctx.scratch.release(tex);
+                }
+            }
+        }
+    };
+}
+function resolveDispatch(pass, op, target) {
+    if (op.kind === "fragment") {
+        return { kind: "fragment" };
+    }
+    if (op.kind !== "compute") {
+        throw new Error(`RecipeRunner: op "${op.id}@${op.version}" has unsupported kind "${op.kind}"`);
+    }
+    const dispatch = pass.dispatch;
+    if (dispatch && dispatch.kind === "compute") {
+        const [wx, wy] = op.workgroupSize;
+        return {
+            kind: "compute",
+            x: dispatch.x ?? Math.ceil(target.width / wx),
+            y: dispatch.y ?? Math.ceil(target.height / wy),
+            z: dispatch.z ?? 1
+        };
+    }
+    const [wx, wy] = op.workgroupSize;
+    return {
+        kind: "compute",
+        x: Math.ceil(target.width / wx),
+        y: Math.ceil(target.height / wy),
+        z: 1
+    };
+}
+//# sourceMappingURL=recipe.js.map

package/dist/recipe.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Shader registry — the lookup surface for `(id, version)` modules.
+ *
+ * Population is via an explicit barrel (`ALL_CATALOG`), not `import.meta.glob`:
+ * Node-bundling-safe, grep-able, tree-shakeable. A module's identity is
+ * `(id, version)`; registering the same pair twice is a programming error
+ * and throws.
+ *
+ * From Phase 3 the registry stores both single-pass {@link ShaderModule}s and
+ * multi-pass {@link RecipeModule}s under the same key space — they share the
+ * `(id, version, surface, category)` identity. Consumers that only want
+ * one kind can use the narrower `getShader` / `getRecipe` helpers.
+ */
+import type { ShaderModule } from "./module.js";
+import type { RecipeModule } from "./recipe.js";
+import type { ShaderCategory, ShaderSurface } from "./types.js";
+/** Either kind of registry entry. Discriminated by `.kind`. */
+export type AnyShader = ShaderModule | RecipeModule;
+export interface ShaderQuery {
+    id: string;
+    /** Pin a version. Omit to resolve the highest registered version. */
+    version?: number;
+    /** Require a surface (e.g. `"published"` for workflow nodes). */
+    surface?: ShaderSurface;
+}
+export interface ShaderListFilter {
+    surface?: ShaderSurface;
+    category?: ShaderCategory;
+}
+export declare class ShaderRegistry {
+    private readonly byKey;
+    register(module: AnyShader): void;
+    registerAll(modules: readonly AnyShader[]): void;
+    /** Resolve a module or `undefined`. Pins version when given; else latest. */
+    tryGet(query: ShaderQuery): AnyShader | undefined;
+    /**
+     * Resolve a module or throw, naming the missing `(id, version)`. This is
+     * the workflow-load failure mode: no silent fallback to another version.
+     */
+    get(query: ShaderQuery): AnyShader;
+    /** Narrowed `get` for the Executor path; throws if the entry is a recipe. */
+    getShader(query: ShaderQuery): ShaderModule;
+    /** Narrowed `get` for the RecipeRunner path; throws if the entry is single-pass. */
+    getRecipe(query: ShaderQuery): RecipeModule;
+    has(query: ShaderQuery): boolean;
+    list(filter?: ShaderListFilter): AnyShader[];
+    private latest;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,YAAY,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAEtD,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAMhC;IAED,WAAW,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAI/C;IAED,6EAA6E;IAC7E,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAYhD;IAED;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAQjC;IAED,6EAA6E;IAC7E,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAQ1C;IAED,oFAAoF;IACpF,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAQ1C;IAED,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAE/B;IAED,IAAI,CAAC,MAAM,GAAE,gBAAqB,GAAG,SAAS,EAAE,CAY/C;IAED,OAAO,CAAC,MAAM;CAYf"}

package/dist/registry.js

@@ -0,0 +1,100 @@
+/**
+ * Shader registry — the lookup surface for `(id, version)` modules.
+ *
+ * Population is via an explicit barrel (`ALL_CATALOG`), not `import.meta.glob`:
+ * Node-bundling-safe, grep-able, tree-shakeable. A module's identity is
+ * `(id, version)`; registering the same pair twice is a programming error
+ * and throws.
+ *
+ * From Phase 3 the registry stores both single-pass {@link ShaderModule}s and
+ * multi-pass {@link RecipeModule}s under the same key space — they share the
+ * `(id, version, surface, category)` identity. Consumers that only want
+ * one kind can use the narrower `getShader` / `getRecipe` helpers.
+ */
+import { moduleKey } from "./module.js";
+export class ShaderRegistry {
+    byKey = new Map();
+    register(module) {
+        const key = moduleKey(module.id, module.version);
+        if (this.byKey.has(key)) {
+            throw new Error(`Shader module already registered: ${key}`);
+        }
+        this.byKey.set(key, module);
+    }
+    registerAll(modules) {
+        for (const module of modules) {
+            this.register(module);
+        }
+    }
+    /** Resolve a module or `undefined`. Pins version when given; else latest. */
+    tryGet(query) {
+        const candidate = query.version !== undefined
+            ? this.byKey.get(moduleKey(query.id, query.version))
+            : this.latest(query.id);
+        if (!candidate) {
+            return undefined;
+        }
+        if (query.surface && candidate.surface !== query.surface) {
+            return undefined;
+        }
+        return candidate;
+    }
+    /**
+     * Resolve a module or throw, naming the missing `(id, version)`. This is
+     * the workflow-load failure mode: no silent fallback to another version.
+     */
+    get(query) {
+        const found = this.tryGet(query);
+        if (!found) {
+            const ver = query.version !== undefined ? `@${query.version}` : "";
+            const surf = query.surface ? ` (surface=${query.surface})` : "";
+            throw new Error(`Shader module not found: ${query.id}${ver}${surf}`);
+        }
+        return found;
+    }
+    /** Narrowed `get` for the Executor path; throws if the entry is a recipe. */
+    getShader(query) {
+        const entry = this.get(query);
+        if (entry.kind === "recipe") {
+            throw new Error(`Shader registry: ${entry.id}@${entry.version} is a recipe; use getRecipe or RecipeRunner`);
+        }
+        return entry;
+    }
+    /** Narrowed `get` for the RecipeRunner path; throws if the entry is single-pass. */
+    getRecipe(query) {
+        const entry = this.get(query);
+        if (entry.kind !== "recipe") {
+            throw new Error(`Shader registry: ${entry.id}@${entry.version} is a single-pass module; use getShader or Executor`);
+        }
+        return entry;
+    }
+    has(query) {
+        return this.tryGet(query) !== undefined;
+    }
+    list(filter = {}) {
+        const out = [];
+        for (const module of this.byKey.values()) {
+            if (filter.surface && module.surface !== filter.surface) {
+                continue;
+            }
+            if (filter.category && module.category !== filter.category) {
+                continue;
+            }
+            out.push(module);
+        }
+        return out;
+    }
+    latest(id) {
+        let best;
+        for (const module of this.byKey.values()) {
+            if (module.id !== id) {
+                continue;
+            }
+            if (!best || module.version > best.version) {
+                best = module;
+            }
+        }
+        return best;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/shaders/_canary/passthrough/v1/module.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Canary module — `_canary.passthrough@1`.
+ *
+ * Copies an input texture to an output texture, modulated by a `tint` uniform
+ * that defaults to white (an identity copy). It exists to prove the whole
+ * Phase 1 chain end-to-end in one file: TypeGPU schema → bind group layout →
+ * WGSL resolution → executor → labeled output. Not a published operation.
+ */
+import * as d from "typegpu/data";
+export declare const passthroughV1: import("../../../../module.js").ShaderModule<d.WgslStruct<{
+    tint: d.Vec4f;
+}>>;
+//# sourceMappingURL=module.d.ts.map

package/dist/shaders/_canary/passthrough/v1/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../../src/shaders/_canary/passthrough/v1/module.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAclC,eAAO,MAAM,aAAa;;GAiDxB,CAAC"}

package/dist/shaders/_canary/passthrough/v1/module.js

@@ -0,0 +1,71 @@
+/**
+ * Canary module — `_canary.passthrough@1`.
+ *
+ * Copies an input texture to an output texture, modulated by a `tint` uniform
+ * that defaults to white (an identity copy). It exists to prove the whole
+ * Phase 1 chain end-to-end in one file: TypeGPU schema → bind group layout →
+ * WGSL resolution → executor → labeled output. Not a published operation.
+ */
+import tgpu from "typegpu";
+import * as d from "typegpu/data";
+import { defineModule } from "../../../../module.js";
+import { WGSL_PREMUL_HELPERS } from "../../../../shared/premulWgsl.js";
+const PassthroughParams = d.struct({
+    tint: d.vec4f
+});
+const layout = tgpu.bindGroupLayout({
+    params: { uniform: PassthroughParams },
+    source: { texture: "float" },
+    samp: { sampler: "filtering" }
+});
+export const passthroughV1 = defineModule({
+    id: "_canary.passthrough",
+    version: 1,
+    surface: "internal",
+    category: "_canary",
+    linearity: "linear-in-rgb",
+    kind: "fragment",
+    params: PassthroughParams,
+    paramDefaults: { tint: d.vec4f(1, 1, 1, 1) },
+    paramUi: {
+        tint: { label: "Tint", notes: "RGBA multiplier; white = identity copy" }
+    },
+    layout,
+    samplers: {
+        samp: {
+            magFilter: "nearest",
+            minFilter: "nearest",
+            addressModeU: "clamp-to-edge",
+            addressModeV: "clamp-to-edge"
+        }
+    },
+    wgsl: /* wgsl */ `
+${WGSL_PREMUL_HELPERS}
+
+@fragment
+fn fs_main(@location(0) uv: vec2f) -> @location(0) vec4f {
+  let src = samplePremul(layout.$.source, layout.$.samp, uv);
+  // Tint is a per-channel multiplier applied in premul space — a linear op,
+  // so the typed Premul value passes through without an unpremul round-trip.
+  let tinted = Premul(src.v * layout.$.params.tint);
+  return tinted.v;
+}
+`,
+    io: {
+        inputs: {
+            source: {
+                colorSpace: "linear",
+                alpha: "premultiplied",
+                bindingKinds: ["texture_2d"]
+            }
+        },
+        output: {
+            colorSpace: "linear",
+            alpha: "premultiplied",
+            format: "rgba8unorm",
+            dimensions: "same-as:source"
+        },
+        rod: "same-as:source"
+    }
+});
+//# sourceMappingURL=module.js.map

package/dist/shaders/_canary/passthrough/v1/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../../../src/shaders/_canary/passthrough/v1/module.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,KAAK;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC;IAClC,MAAM,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE;IACtC,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;IAC5B,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;IACxC,EAAE,EAAE,qBAAqB;IACzB,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,UAAU;IACnB,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,eAAe;IAC1B,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,iBAAiB;IACzB,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAC5C,OAAO,EAAE;QACP,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,wCAAwC,EAAE;KACzE;IACD,MAAM;IACN,QAAQ,EAAE;QACR,IAAI,EAAE;YACJ,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,SAAS;YACpB,YAAY,EAAE,eAAe;YAC7B,YAAY,EAAE,eAAe;SAC9B;KACF;IACD,IAAI,EAAE,UAAU,CAAC;EACjB,mBAAmB;;;;;;;;;;CAUpB;IACC,EAAE,EAAE;QACF,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,UAAU,EAAE,QAAQ;gBACpB,KAAK,EAAE,eAAe;gBACtB,YAAY,EAAE,CAAC,YAAY,CAAC;aAC7B;SACF;QACD,MAAM,EAAE;YACN,UAAU,EAAE,QAAQ;YACpB,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,YAAY;YACpB,UAAU,EAAE,gBAAgB;SAC7B;QACD,GAAG,EAAE,gBAAgB;KACtB;CACF,CAAC,CAAC"}

package/dist/shaders/alpha/premulToStraight/v1/module.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `alpha.premulToStraight@1` — convert premultiplied-alpha RGB to straight.
+ *
+ * Per-pixel `vec4(rgb, a) → vec4(rgb / a, a)` (transparent pixels collapse to
+ * `vec4(0)`). The inverse of
+ * {@link ./../straightToPremul/v1/module alphaStraightToPremulV1}; the two
+ * exist so hosts can bridge straight↔premultiplied boundaries explicitly
+ * instead of letting metadata drift.
+ *
+ * Output color space matches input — this module touches association only.
+ */
+import * as d from "typegpu/data";
+export declare const alphaPremulToStraightV1: import("../../../../module.js").ShaderModule<d.WgslStruct<{
+    _unused: d.F32;
+}>>;
+//# sourceMappingURL=module.d.ts.map

package/dist/shaders/alpha/premulToStraight/v1/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../../src/shaders/alpha/premulToStraight/v1/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAUlC,eAAO,MAAM,uBAAuB;;GAyClC,CAAC"}