@nodetool-ai/gpu 0.8.1

package/dist/module.d.ts

@@ -0,0 +1,162 @@
+/**
+ * `ShaderModule` — the atomic unit of reuse in the shared shader pool.
+ *
+ * A module bundles hand-written WGSL with a TypeGPU bind group layout, a
+ * TypeGPU `d.struct` uniform schema, sampler descriptors, and a declared I/O
+ * contract. There is no way to import "just the WGSL": the layout, the
+ * uniform packer, and the I/O contract travel with it so later phases never
+ * re-derive uniform layouts or bind group layouts by hand.
+ *
+ * WGSL stays hand-written; {@link defineModule} runs `tgpu.resolve(...)` to
+ * connect it to the typed layout (the TS-to-WGSL compiler is not adopted).
+ */
+import tgpu from "typegpu";
+import type { TgpuBindGroupLayout } from "typegpu";
+import type { AnyWgslStruct, Infer } from "typegpu/data";
+import type { BindingKind, IOContract, LinearityMode, ShaderCategory, ShaderKind, ShaderSurface, UiHint } from "./types.js";
+/**
+ * One value `tgpu.resolve` can inline into WGSL — a schema, a layout, a
+ * buffer usage, a TypeGPU function. Read off the resolver's own signature so
+ * the two never drift.
+ */
+export type ResolveExternal = Parameters<typeof tgpu.resolve>[0][number];
+/** Named resolve externals, as `tgpu.resolve` takes them. */
+export type ResolveExternals = Record<string, ResolveExternal>;
+/** Host-capability constraints a variant requires (Phase 3 scaffolding). */
+export interface VariantRequirements {
+    /** Requires `texture_external` binding (browser camera/video fast path). */
+    textureExternal?: boolean;
+    /** Requires `shader-f16` feature (half-precision storage). */
+    f16Storage?: boolean;
+}
+/**
+ * Alternate `(layout, wgsl, entryPoint, samplers, workgroupSize)` for the
+ * same `ShaderModule`. Added in Phase 3 to handle distinct binding kinds
+ * (e.g. `texture_external` vs `texture_2d` for camera/video) without
+ * spawning duplicate module ids.
+ *
+ * Variants only appear when a concrete second binding kind / capability /
+ * quality split exists; modules without alternatives leave `variants`
+ * undefined and the Executor uses the module's primary layout.
+ */
+export interface ShaderVariant {
+    /** Stable short name (`"external"`, `"f16"`). */
+    readonly name: string;
+    /** Binding kind the variant's main input expects, by input name. */
+    readonly bindingKinds?: Readonly<Record<string, BindingKind>>;
+    /** Required device capabilities. */
+    readonly requires?: VariantRequirements;
+    readonly layout: TgpuBindGroupLayout;
+    readonly wgsl: string;
+    readonly entryPoint: string;
+    readonly samplers?: Readonly<Record<string, GPUSamplerDescriptor>>;
+    readonly workgroupSize?: readonly [number, number, number];
+}
+/** Default key, within a module's layout, that holds the params uniform. */
+export declare const DEFAULT_UNIFORM_BINDING = "params";
+/**
+ * A registered, version-pinned GPU operation. Identity is `(id, version)`;
+ * renames/splits ship as a new version, never in-place.
+ */
+export interface ShaderModule<Schema extends AnyWgslStruct = AnyWgslStruct> {
+    readonly id: string;
+    readonly version: number;
+    readonly surface: ShaderSurface;
+    readonly category: ShaderCategory;
+    readonly kind: ShaderKind;
+    /**
+     * Premul-invariant classification. Drives the static WGSL validator
+     * (load-time) and runtime debug pass (per-dispatch). See
+     * {@link LinearityMode}.
+     */
+    readonly linearity: LinearityMode;
+    /** TypeGPU uniform schema — source of truth for the WGSL struct + packer. */
+    readonly params: Schema;
+    readonly paramDefaults: Infer<Schema>;
+    readonly paramUi?: Readonly<Record<string, UiHint>>;
+    /** TypeGPU bind group layout; `root.unwrap(layout)` is the GPU layout. */
+    readonly layout: TgpuBindGroupLayout;
+    /** Layout key holding the params uniform (`""` if the module has none). */
+    readonly uniformBinding: string;
+    /** Sampler descriptors bundled with the module, keyed by layout binding. */
+    readonly samplers: Readonly<Record<string, GPUSamplerDescriptor>>;
+    /** Resolved WGSL (layout + uniform struct injected). */
+    readonly wgsl: string;
+    readonly entryPoint: string;
+    readonly workgroupSize: readonly [number, number, number];
+    readonly io: IOContract;
+    /**
+     * Alternate `(layout, wgsl, ...)` for distinct binding kinds or
+     * capabilities. Resolved by the Executor against bound inputs and
+     * `GPUContext.capabilities`. `undefined` ⇒ the module's primary
+     * `(layout, wgsl, entryPoint, samplers)` is the only variant.
+     */
+    readonly variants?: readonly ShaderVariant[];
+}
+/** Authoring input for {@link defineModule}. */
+export interface ShaderModuleSpec<Schema extends AnyWgslStruct> {
+    id: string;
+    version: number;
+    surface: ShaderSurface;
+    category: ShaderCategory;
+    /** Defaults to `"fragment"` — the image-in/image-out default. */
+    kind?: ShaderKind;
+    /**
+     * Premul-invariant classification. Required — no default, so shader
+     * authors must classify their RGB math explicitly. See {@link LinearityMode}.
+     */
+    linearity: LinearityMode;
+    params: Schema;
+    paramDefaults: Infer<Schema>;
+    paramUi?: Record<string, UiHint>;
+    layout: TgpuBindGroupLayout;
+    /** Layout key for the params uniform. Defaults to `"params"`. */
+    uniformBinding?: string;
+    samplers?: Record<string, GPUSamplerDescriptor>;
+    /**
+     * Hand-written WGSL template referencing the layout (and any extra
+     * `externals`) by name. `tgpu.resolve` replaces those references with the
+     * generated bindings + struct definitions.
+     */
+    wgsl: string;
+    /** Extra resolve externals (shared snippets). The layout is auto-included. */
+    externals?: ResolveExternals;
+    /** Fragment entry point. Defaults to `"fs_main"` (fragment) / `"main"`. */
+    entryPoint?: string;
+    /** Compute workgroup size. Ignored for fragment modules. */
+    workgroupSize?: readonly [number, number, number];
+    io: IOContract;
+    /**
+     * Alternate-binding variants (Phase 3). Each variant gets its own resolved
+     * WGSL: `defineModule` runs `tgpu.resolve` over `variant.wgsl` with that
+     * variant's layout in scope, so the resolved string in the returned module
+     * already has variant-correct bindings injected.
+     */
+    variants?: ReadonlyArray<{
+        name: string;
+        bindingKinds?: Record<string, BindingKind>;
+        requires?: VariantRequirements;
+        layout: TgpuBindGroupLayout;
+        wgsl: string;
+        externals?: ResolveExternals;
+        entryPoint?: string;
+        samplers?: Record<string, GPUSamplerDescriptor>;
+        workgroupSize?: readonly [number, number, number];
+        /**
+         * Opt out of `tgpu.resolve` for this variant's WGSL. Needed for bindings
+         * TypeGPU's resolver can't inline (e.g. `texture_external`); the variant
+         * supplies fully-formed WGSL with hand-written `@group/@binding` decls.
+         * Defaults to `false` (the primary path runs resolve).
+         */
+        rawWgsl?: boolean;
+    }>;
+}
+/**
+ * Build a {@link ShaderModule}, resolving its WGSL against the typed layout
+ * at definition time. Resolution is device-free (pure string generation), so
+ * this runs at module load — failures surface before any GPU work.
+ */
+export declare function defineModule<Schema extends AnyWgslStruct>(spec: ShaderModuleSpec<Schema>): ShaderModule<Schema>;
+/** `(id, version)` rendered as a stable string key. */
+export declare function moduleKey(id: string, version: number): string;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

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

package/dist/module.js

@@ -0,0 +1,100 @@
+/**
+ * `ShaderModule` — the atomic unit of reuse in the shared shader pool.
+ *
+ * A module bundles hand-written WGSL with a TypeGPU bind group layout, a
+ * TypeGPU `d.struct` uniform schema, sampler descriptors, and a declared I/O
+ * contract. There is no way to import "just the WGSL": the layout, the
+ * uniform packer, and the I/O contract travel with it so later phases never
+ * re-derive uniform layouts or bind group layouts by hand.
+ *
+ * WGSL stays hand-written; {@link defineModule} runs `tgpu.resolve(...)` to
+ * connect it to the typed layout (the TS-to-WGSL compiler is not adopted).
+ */
+import tgpu from "typegpu";
+import { validateWgslLinearity } from "./validate/wgslLinearity.js";
+/** Default key, within a module's layout, that holds the params uniform. */
+export const DEFAULT_UNIFORM_BINDING = "params";
+/**
+ * Build a {@link ShaderModule}, resolving its WGSL against the typed layout
+ * at definition time. Resolution is device-free (pure string generation), so
+ * this runs at module load — failures surface before any GPU work.
+ */
+export function defineModule(spec) {
+    if (!spec.id) {
+        throw new Error("defineModule: id is required");
+    }
+    if (!Number.isInteger(spec.version) || spec.version < 1) {
+        throw new Error(`defineModule(${spec.id}): version must be a positive integer`);
+    }
+    const kind = spec.kind ?? "fragment";
+    const wgsl = tgpu.resolve({
+        template: spec.wgsl,
+        externals: { layout: spec.layout, ...spec.externals },
+        names: "strict"
+    });
+    // Item 3 of the invariant-enforcement plan: static premul check against the
+    // declared `linearity` tag, run on the resolved WGSL so it sees the final
+    // bindings. Failures throw — a misclassified module never reaches the
+    // registry. `NODETOOL_GPU_VALIDATE=off` disables it for emergency hotfixes.
+    const linearityCheck = validateWgslLinearity({
+        id: spec.id,
+        linearity: spec.linearity,
+        wgsl,
+        inputs: spec.io.inputs
+    });
+    if (!linearityCheck.ok) {
+        throw new Error(`defineModule(${spec.id}): premul-invariant validation failed:\n  - ${linearityCheck.violations.join("\n  - ")}`);
+    }
+    const variants = spec.variants?.map((v) => {
+        const variantWgsl = v.rawWgsl
+            ? v.wgsl
+            : tgpu.resolve({
+                template: v.wgsl,
+                externals: { layout: v.layout, ...v.externals },
+                names: "strict"
+            });
+        const variantCheck = validateWgslLinearity({
+            id: `${spec.id}#${v.name}`,
+            linearity: spec.linearity,
+            wgsl: variantWgsl,
+            inputs: spec.io.inputs
+        });
+        if (!variantCheck.ok) {
+            throw new Error(`defineModule(${spec.id}, variant=${v.name}): premul-invariant validation failed:\n  - ${variantCheck.violations.join("\n  - ")}`);
+        }
+        return Object.freeze({
+            name: v.name,
+            bindingKinds: v.bindingKinds,
+            requires: v.requires,
+            layout: v.layout,
+            wgsl: variantWgsl,
+            entryPoint: v.entryPoint ?? (kind === "compute" ? "main" : "fs_main"),
+            samplers: v.samplers,
+            workgroupSize: v.workgroupSize
+        });
+    });
+    return Object.freeze({
+        id: spec.id,
+        version: spec.version,
+        surface: spec.surface,
+        category: spec.category,
+        kind,
+        linearity: spec.linearity,
+        params: spec.params,
+        paramDefaults: spec.paramDefaults,
+        paramUi: spec.paramUi,
+        layout: spec.layout,
+        uniformBinding: spec.uniformBinding ?? DEFAULT_UNIFORM_BINDING,
+        samplers: spec.samplers ?? {},
+        wgsl,
+        entryPoint: spec.entryPoint ?? (kind === "compute" ? "main" : "fs_main"),
+        workgroupSize: spec.workgroupSize ?? [1, 1, 1],
+        io: spec.io,
+        variants: variants ? Object.freeze(variants) : undefined
+    });
+}
+/** `(id, version)` rendered as a stable string key. */
+export function moduleKey(id, version) {
+    return `${id}@${version}`;
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

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

package/dist/node.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @nodetool-ai/gpu/node — Node.js (Dawn) host adapter.
+ *
+ * Acquires a `GPUDevice` from the optional `webgpu` (Dawn) npm package and
+ * exposes the headless compositing path on top of it. Kept in its own entry
+ * so the native Dawn binding is only loaded when a Node consumer actually
+ * asks for server-side GPU work — the pure catalog (`.`), the pool (`./pool`),
+ * and the browser engine (`./webgpu`) never pull it in.
+ *
+ * WebGPU is required for this path; there is no silent CPU fallback. If Dawn
+ * is unavailable the device acquisition fails loud and the caller decides
+ * whether to fall back (e.g. to a Sharp-based node).
+ */
+import { type GPUContext } from "./context.js";
+import { compositeLayersHeadless, type HeadlessLayer, type HeadlessCompositeResult } from "./compositor/headless.js";
+import type { LayerTransform2D } from "./compositor/transform.js";
+/**
+ * Acquire a fresh `GPUDevice` from Dawn. Throws a clear error if the optional
+ * `webgpu` package is not installed or no adapter is available.
+ */
+export declare function createNodeGPUDevice(): Promise<GPUDevice>;
+/**
+ * Cached `GPUDevice` — acquiring a Dawn device is expensive, so a node that
+ * runs repeatedly reuses one across executions. A failed acquisition clears
+ * the cache so a later call can retry.
+ */
+export declare function getNodeGPUDevice(): Promise<GPUDevice>;
+/** Build a {@link GPUContext} backed by a Dawn device (for pool/Executor use). */
+export declare function createNodeGPUContext(): Promise<GPUContext>;
+/**
+ * Composite image layers on the GPU using the cached Dawn device. The
+ * convenience entry server-side nodes call: pass decoded straight-alpha RGBA
+ * layers, get back composited straight-alpha RGBA.
+ */
+export declare function compositeImageLayers(layers: HeadlessLayer[], canvasWidth: number, canvasHeight: number): Promise<HeadlessCompositeResult>;
+export { compositeLayersHeadless };
+export type { HeadlessLayer, HeadlessCompositeResult, LayerTransform2D };
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AA+DlE;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,SAAS,CAAC,CAkC9D;AAkBD;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC,CAQ3D;AAED,kFAAkF;AAClF,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,CAEhE;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EAAE,EACvB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAGlC;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/node.js

@@ -0,0 +1,140 @@
+/**
+ * @nodetool-ai/gpu/node — Node.js (Dawn) host adapter.
+ *
+ * Acquires a `GPUDevice` from the optional `webgpu` (Dawn) npm package and
+ * exposes the headless compositing path on top of it. Kept in its own entry
+ * so the native Dawn binding is only loaded when a Node consumer actually
+ * asks for server-side GPU work — the pure catalog (`.`), the pool (`./pool`),
+ * and the browser engine (`./webgpu`) never pull it in.
+ *
+ * WebGPU is required for this path; there is no silent CPU fallback. If Dawn
+ * is unavailable the device acquisition fails loud and the caller decides
+ * whether to fall back (e.g. to a Sharp-based node).
+ */
+import { createGPUContextFromDevice } from "./context.js";
+import { compositeLayersHeadless } from "./compositor/headless.js";
+let devicePromise = null;
+/**
+ * Dawn instances we've created, kept alive for the process lifetime.
+ *
+ * dawn.node's `AsyncRunner` schedules `InstanceBase::ProcessEvents()` on the
+ * Node event loop (via setImmediate) for as long as the GPU instance lives.
+ * Only the resulting `GPUDevice` is cached below — the instance itself is a
+ * local in {@link createNodeGPUDevice}, so once it returns, the instance is
+ * unreferenced and eligible for GC. If a queued `ProcessEvents()` callback
+ * then fires after the instance is finalized, it locks a freed mutex and the
+ * process dies with `SIGSEGV` in `dawn::native::InstanceBase::ProcessEvents`
+ * (no JS error, just a hard crash). Retaining every instance prevents that.
+ *
+ * The cost of retaining is that **the Node event loop never drains again**: the
+ * re-scheduled `ProcessEvents()` stays an active handle for the process
+ * lifetime. A long-lived host (the server, the Electron backend) does not care.
+ * A one-shot host must call `process.exit()` once its work is done rather than
+ * setting `process.exitCode` and returning, or it hangs after printing its
+ * results — with the workflow having completed perfectly. `nodetool workflows
+ * run` and `scripts/run-workflow.mjs` both exit explicitly for this reason.
+ *
+ * There is deliberately no teardown export here: destroying the device does not
+ * stop the runner, and releasing the instance is the SIGSEGV above.
+ */
+const retainedDawnInstances = [];
+/**
+ * Install the WebGPU flag namespaces Dawn provides onto `globalThis`. In a
+ * browser these are ambient globals; under Node/Dawn they live on the module's
+ * `globals` export and must be assigned before anything references them. Both
+ * our own descriptors and typegpu's bind-group-layout builder read them as
+ * globals (e.g. `GPUShaderStage.FRAGMENT`), so a missing assignment surfaces as
+ * a `ReferenceError: GPUShaderStage is not defined` only once a layout is
+ * materialized. Existing globals are left untouched.
+ */
+function installWebGPUGlobals(dawn) {
+    if (!dawn.globals)
+        return;
+    for (const [key, value] of Object.entries(dawn.globals)) {
+        if (!(key in globalThis)) {
+            Object.defineProperty(globalThis, key, {
+                value,
+                writable: true,
+                enumerable: true,
+                configurable: true
+            });
+        }
+    }
+}
+/**
+ * Acquire a fresh `GPUDevice` from Dawn. Throws a clear error if the optional
+ * `webgpu` package is not installed or no adapter is available.
+ */
+export async function createNodeGPUDevice() {
+    // Variable specifier keeps bundlers (and tsc) from trying to resolve the
+    // native module at build time — it's an optional, runtime-only dependency.
+    const spec = "webgpu";
+    let dawn;
+    try {
+        // SAFETY: a dynamic import with a non-literal specifier is untyped, and
+        // `DawnModule` claims only `create` and `globals` — both optional, and
+        // both guarded at their use sites — so a `webgpu` build that ships
+        // neither fails on the explicit checks below rather than here.
+        dawn = (await import(/* @vite-ignore */ spec));
+    }
+    catch (err) {
+        throw new Error("Node WebGPU support requires the optional 'webgpu' (Dawn) package. " +
+            "Install it with `npm install webgpu`.", { cause: err });
+    }
+    installWebGPUGlobals(dawn);
+    const gpu = dawn.create?.([]);
+    if (!gpu) {
+        throw new Error("Failed to create a Dawn GPU instance (webgpu.create)");
+    }
+    // Keep the instance alive: its AsyncRunner keeps scheduling ProcessEvents()
+    // on the event loop, which segfaults if the instance is GC'd out from under
+    // it (see retainedDawnInstances).
+    retainedDawnInstances.push(gpu);
+    const adapter = await gpu.requestAdapter();
+    if (!adapter) {
+        throw new Error("No WebGPU adapter available (Node/Dawn). " + adapterHelpForPlatform());
+    }
+    return adapter.requestDevice();
+}
+/**
+ * Dawn reaches the GPU through a platform driver and ships no software
+ * fallback, so "no adapter" almost always means a missing driver rather than a
+ * missing GPU. On Linux that is a Vulkan ICD: with none installed the loader
+ * fails `vkCreateInstance` with `VK_ERROR_INCOMPATIBLE_DRIVER`, which surfaces
+ * here as a null adapter and says nothing about the cause. Name the fix.
+ */
+function adapterHelpForPlatform() {
+    return ("On headless Linux this usually means no Vulkan driver (ICD) is installed — " +
+        "Dawn has no software fallback of its own. Install a software rasterizer " +
+        "with `apt-get install mesa-vulkan-drivers` (lavapipe), or point the loader " +
+        "at an existing one with VK_DRIVER_FILES=/path/to/icd.json.");
+}
+/**
+ * Cached `GPUDevice` — acquiring a Dawn device is expensive, so a node that
+ * runs repeatedly reuses one across executions. A failed acquisition clears
+ * the cache so a later call can retry.
+ */
+export async function getNodeGPUDevice() {
+    if (!devicePromise) {
+        devicePromise = createNodeGPUDevice().catch((err) => {
+            devicePromise = null;
+            throw err;
+        });
+    }
+    return devicePromise;
+}
+/** Build a {@link GPUContext} backed by a Dawn device (for pool/Executor use). */
+export async function createNodeGPUContext() {
+    return createGPUContextFromDevice(await getNodeGPUDevice());
+}
+/**
+ * Composite image layers on the GPU using the cached Dawn device. The
+ * convenience entry server-side nodes call: pass decoded straight-alpha RGBA
+ * layers, get back composited straight-alpha RGBA.
+ */
+export async function compositeImageLayers(layers, canvasWidth, canvasHeight) {
+    const device = await getNodeGPUDevice();
+    return compositeLayersHeadless(device, layers, canvasWidth, canvasHeight);
+}
+export { compositeLayersHeadless };
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/pool.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @nodetool-ai/gpu/pool — TypeGPU-backed shader pool (Phase 1+).
+ *
+ * The shared GPU operation catalog with a tiny runtime: `ShaderModule`
+ * (WGSL + typed bind group layout + typed uniform schema + sampler config +
+ * I/O contract), `LabeledTexture`, the `GPUContext` adapter, the registry,
+ * and the small `Executor`. From Phase 3 the catalog also exports
+ * `RecipeModule` + `RecipeRunner` for multi-pass operations. All TypeGPU-backed.
+ *
+ * Kept out of the package's pure root so that Node consumers of the blend
+ * catalog don't pull in TypeGPU. This entry is device-agnostic — the same
+ * module code runs against browser, Electron, and Node.js Dawn devices. The
+ * `navigator.gpu` adapter (`createBrowserGPUContext`) lives behind `./webgpu`.
+ */
+export * from "./types.js";
+export * from "./module.js";
+export * from "./texture.js";
+export * from "./registry.js";
+export * from "./executor.js";
+export * from "./recipe.js";
+export * from "./fullscreenQuad.js";
+export { consumePremulDebugWarnings, isPremulDebugEnabled, setPremulDebugEnabled, resetPremulDebugCache } from "./debug/premulValidator.js";
+export type { DebugViolation, DebugReadback, DebugSink, EncodeValidationArgs } from "./debug/premulValidator.js";
+export { ceilToBucket, makeScratchPool, makeUniformRing, createGPUContextFromDevice } from "./context.js";
+export type { GPUContext, GPUCapabilities, PipelineCache, CachedPipeline, ScratchPool, ScratchSpec, UniformRing } from "./context.js";
+export { ALL_SHADERS, ALL_RECIPES, ALL_CATALOG, passthroughV1, colorGradeV1, colorInvertV1, colorBrightnessContrastV1, colorHsbV1, colorExposureV1, colorPosterizeV1, colorCubeLutV1, colorChannelSplitV1, colorChannelShuffleV1, colorChannelMergeV1, colorGrayscaleV1, colorSolarizeV1, colorColorBalanceV1, colorExposureToneV1, colorLiftGammaGainV1, colorCdlV1, colorCurvesV1, colorHslAdjustV1, colorSplitToningV1, colorFilmLookV1, colorLevelsV1, blurGaussianV1, sharpenUnsharpMaskV1, vignetteV1, filtersGrainV1, filtersPixelateV1, filtersVisualFxV1, filtersThresholdV1, filtersConvolve3x3V1, filtersGlowV1, filtersBlurSeparableV1, chromaKeyV1, keyerLumaKeyV1, maskApplyV1, maskFromImageV1, maskInvertV1, sourcesSolidV1, sourcesLinearGradientV1, sourcesCheckerboardV1, sourcesRadialGradientV1, sourcesAngularGradientV1, sourcesDiamondGradientV1, sourcesGaussianNoiseV1, mixerAddV1, mixerColorOverlayV1, mixerOutlineV1, mixerShadowComposeV1, mixerDropShadowV1, mixerOverV1, transformMirrorV1, transformOffsetV1, transformCropV1, transformPadV1, transformTileV1, transformResizeV1, transformRotate90V1, transformAffineV1, transformCornerPinV1, transformPolarRemapV1, transformDisplaceV1, transformSpherizeV1, alphaStraightToPremulV1, alphaPremulToStraightV1 } from "./shaders/index.js";
+import { ShaderRegistry } from "./registry.js";
+/** A {@link ShaderRegistry} preloaded with every catalog module (shaders + recipes). */
+export declare function createDefaultRegistry(): ShaderRegistry;
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,0BAA0B,EAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,UAAU,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,WAAW,EACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,yBAAyB,EACzB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,wFAAwF;AACxF,wBAAgB,qBAAqB,IAAI,cAAc,CAItD"}

package/dist/pool.js

@@ -0,0 +1,33 @@
+/**
+ * @nodetool-ai/gpu/pool — TypeGPU-backed shader pool (Phase 1+).
+ *
+ * The shared GPU operation catalog with a tiny runtime: `ShaderModule`
+ * (WGSL + typed bind group layout + typed uniform schema + sampler config +
+ * I/O contract), `LabeledTexture`, the `GPUContext` adapter, the registry,
+ * and the small `Executor`. From Phase 3 the catalog also exports
+ * `RecipeModule` + `RecipeRunner` for multi-pass operations. All TypeGPU-backed.
+ *
+ * Kept out of the package's pure root so that Node consumers of the blend
+ * catalog don't pull in TypeGPU. This entry is device-agnostic — the same
+ * module code runs against browser, Electron, and Node.js Dawn devices. The
+ * `navigator.gpu` adapter (`createBrowserGPUContext`) lives behind `./webgpu`.
+ */
+export * from "./types.js";
+export * from "./module.js";
+export * from "./texture.js";
+export * from "./registry.js";
+export * from "./executor.js";
+export * from "./recipe.js";
+export * from "./fullscreenQuad.js";
+export { consumePremulDebugWarnings, isPremulDebugEnabled, setPremulDebugEnabled, resetPremulDebugCache } from "./debug/premulValidator.js";
+export { ceilToBucket, makeScratchPool, makeUniformRing, createGPUContextFromDevice } from "./context.js";
+export { ALL_SHADERS, ALL_RECIPES, ALL_CATALOG, passthroughV1, colorGradeV1, colorInvertV1, colorBrightnessContrastV1, colorHsbV1, colorExposureV1, colorPosterizeV1, colorCubeLutV1, colorChannelSplitV1, colorChannelShuffleV1, colorChannelMergeV1, colorGrayscaleV1, colorSolarizeV1, colorColorBalanceV1, colorExposureToneV1, colorLiftGammaGainV1, colorCdlV1, colorCurvesV1, colorHslAdjustV1, colorSplitToningV1, colorFilmLookV1, colorLevelsV1, blurGaussianV1, sharpenUnsharpMaskV1, vignetteV1, filtersGrainV1, filtersPixelateV1, filtersVisualFxV1, filtersThresholdV1, filtersConvolve3x3V1, filtersGlowV1, filtersBlurSeparableV1, chromaKeyV1, keyerLumaKeyV1, maskApplyV1, maskFromImageV1, maskInvertV1, sourcesSolidV1, sourcesLinearGradientV1, sourcesCheckerboardV1, sourcesRadialGradientV1, sourcesAngularGradientV1, sourcesDiamondGradientV1, sourcesGaussianNoiseV1, mixerAddV1, mixerColorOverlayV1, mixerOutlineV1, mixerShadowComposeV1, mixerDropShadowV1, mixerOverV1, transformMirrorV1, transformOffsetV1, transformCropV1, transformPadV1, transformTileV1, transformResizeV1, transformRotate90V1, transformAffineV1, transformCornerPinV1, transformPolarRemapV1, transformDisplaceV1, transformSpherizeV1, alphaStraightToPremulV1, alphaPremulToStraightV1 } from "./shaders/index.js";
+import { ShaderRegistry } from "./registry.js";
+import { ALL_CATALOG } from "./shaders/index.js";
+/** A {@link ShaderRegistry} preloaded with every catalog module (shaders + recipes). */
+export function createDefaultRegistry() {
+    const registry = new ShaderRegistry();
+    registry.registerAll(ALL_CATALOG);
+    return registry;
+}
+//# sourceMappingURL=pool.js.map

package/dist/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,0BAA0B,EAC3B,MAAM,cAAc,CAAC;AAUtB,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,yBAAyB,EACzB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,wFAAwF;AACxF,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC"}