@nodetool-ai/gpu 0.8.1

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared shader-pool contracts. Pure types + small const tuples — no WebGPU
+ * runtime, Node-safe. The pool's atomic unit of reuse is a {@link
+ * ShaderModule} (see `module.ts`); these are the vocabulary its fields are
+ * built from.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/validate/wgslLinearity.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Load-time WGSL static validator for the premul-invariant `linearity` tag.
+ *
+ * Item 3 of the shader-pool invariant enforcement plan. Runs inside
+ * {@link defineModule} after `tgpu.resolve(...)` and rejects modules whose
+ * WGSL contradicts their declared {@link LinearityMode}. Failures are throws
+ * so a misclassified module never reaches the registry.
+ *
+ * ## What it checks
+ *
+ * | `linearity`         | rule                                                                   |
+ * |---------------------|------------------------------------------------------------------------|
+ * | `"source"`          | skipped — no input to validate                                         |
+ * | `"alpha-only"`      | output RGB must be literal zero (no `.r/.g/.b/.rgb` written to return) |
+ * | `"linear-in-rgb"`   | flag nonlinear tokens (`pow|log|sqrt|step|smoothstep|floor|...`) on    |
+ * |                     | the same line as a `.rgb` access                                       |
+ * | `"nonlinear-in-rgb"`| must show the unpremul handshake (`unpremul` token, `.rgb /` divide,   |
+ * |                     | or all inputs declared `alpha: "straight"`) whenever a sample variable |
+ * |                     | is dereferenced with `.rgb`                                            |
+ *
+ * ## Brittleness — read before tightening
+ *
+ * Pure string analysis, no AST. The WGSL grammar is rich (block comments,
+ * raw strings, multi-line expressions, identifier shadowing) and this scanner
+ * cannot follow any of it. Concrete known limits:
+ *
+ * - **Line-level scope.** Co-occurrence rules ("`pow` and `.rgb` on the same
+ *   line") miss multi-line expressions and over-trigger on dense lines.
+ * - **Per-file unpremul check.** The nonlinear-in-rgb rule treats a single
+ *   `unpremul` or `.rgb /` token anywhere in the file as the handshake — it
+ *   does not prove the unpremul happens **before** the `.rgb` read. A shader
+ *   that unpremuls at the end after using `.rgb` will spuriously pass.
+ * - **Sample variable detection.** We look for `let X = textureSample(...)` /
+ *   `let X = textureLoad(...)` (also `var X = ...`); only those `X.rgb`
+ *   references are treated as "premul .rgb access". Direct `textureSample(...).rgb`
+ *   without an intermediate name is also recognized. Params-field references
+ *   like `p.color.rgb` are intentionally not flagged.
+ * - **Block comments.** `/* … *​/` blocks are not stripped. A nonlinear token
+ *   buried in a comment will be treated as code. Same-line `//` comments are
+ *   preserved so the suppression token below works.
+ *
+ * False positives are the failure mode — they break the build. The suppression
+ * token (`// premul: ok`) is the escape hatch. False negatives merely defer the
+ * catch to the runtime debug pass.
+ *
+ * ## Suppression
+ *
+ * Add one of these tokens as a `//` comment on the same line as the offending
+ * op to silence the validator for that line:
+ *
+ * - `// premul: ok`
+ * - `// premul: linear-safe`
+ * - `// premul: handled`
+ *
+ * Pair the suppression with a TODO comment when the underlying shader is
+ * actually buggy (so the deferred work is still tracked).
+ *
+ * ## Cost
+ *
+ * Module-load-time: regex over a ~200-line string, done once per `defineModule`
+ * call. Target: under 1 ms per module on modern hardware.
+ *
+ * ## Escape hatch
+ *
+ * Set `NODETOOL_GPU_VALIDATE=off` to disable the validator entirely. Useful for
+ * hotfixes where a misclassified module must ship before the WGSL can be
+ * corrected. Read once at module load via `globalThis.process?.env`.
+ */
+import type { InputContract, LinearityMode } from "../types.js";
+interface LinearityValidationResult {
+    ok: boolean;
+    violations: string[];
+}
+interface LinearityValidationArgs {
+    id: string;
+    linearity: LinearityMode;
+    wgsl: string;
+    inputs: Record<string, InputContract>;
+}
+/**
+ * Validate that the resolved WGSL is consistent with its declared
+ * {@link LinearityMode}. Returns `{ ok, violations }`; the caller throws.
+ */
+export declare function validateWgslLinearity(args: LinearityValidationArgs): LinearityValidationResult;
+export {};
+//# sourceMappingURL=wgslLinearity.d.ts.map

package/dist/validate/wgslLinearity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgslLinearity.d.ts","sourceRoot":"","sources":["../../src/validate/wgslLinearity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuChE,UAAU,yBAAyB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,UAAU,uBAAuB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACvC;AA4KD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,uBAAuB,GAC5B,yBAAyB,CA6B3B"}

package/dist/validate/wgslLinearity.js

@@ -0,0 +1,298 @@
+/**
+ * Load-time WGSL static validator for the premul-invariant `linearity` tag.
+ *
+ * Item 3 of the shader-pool invariant enforcement plan. Runs inside
+ * {@link defineModule} after `tgpu.resolve(...)` and rejects modules whose
+ * WGSL contradicts their declared {@link LinearityMode}. Failures are throws
+ * so a misclassified module never reaches the registry.
+ *
+ * ## What it checks
+ *
+ * | `linearity`         | rule                                                                   |
+ * |---------------------|------------------------------------------------------------------------|
+ * | `"source"`          | skipped — no input to validate                                         |
+ * | `"alpha-only"`      | output RGB must be literal zero (no `.r/.g/.b/.rgb` written to return) |
+ * | `"linear-in-rgb"`   | flag nonlinear tokens (`pow|log|sqrt|step|smoothstep|floor|...`) on    |
+ * |                     | the same line as a `.rgb` access                                       |
+ * | `"nonlinear-in-rgb"`| must show the unpremul handshake (`unpremul` token, `.rgb /` divide,   |
+ * |                     | or all inputs declared `alpha: "straight"`) whenever a sample variable |
+ * |                     | is dereferenced with `.rgb`                                            |
+ *
+ * ## Brittleness — read before tightening
+ *
+ * Pure string analysis, no AST. The WGSL grammar is rich (block comments,
+ * raw strings, multi-line expressions, identifier shadowing) and this scanner
+ * cannot follow any of it. Concrete known limits:
+ *
+ * - **Line-level scope.** Co-occurrence rules ("`pow` and `.rgb` on the same
+ *   line") miss multi-line expressions and over-trigger on dense lines.
+ * - **Per-file unpremul check.** The nonlinear-in-rgb rule treats a single
+ *   `unpremul` or `.rgb /` token anywhere in the file as the handshake — it
+ *   does not prove the unpremul happens **before** the `.rgb` read. A shader
+ *   that unpremuls at the end after using `.rgb` will spuriously pass.
+ * - **Sample variable detection.** We look for `let X = textureSample(...)` /
+ *   `let X = textureLoad(...)` (also `var X = ...`); only those `X.rgb`
+ *   references are treated as "premul .rgb access". Direct `textureSample(...).rgb`
+ *   without an intermediate name is also recognized. Params-field references
+ *   like `p.color.rgb` are intentionally not flagged.
+ * - **Block comments.** `/* … *​/` blocks are not stripped. A nonlinear token
+ *   buried in a comment will be treated as code. Same-line `//` comments are
+ *   preserved so the suppression token below works.
+ *
+ * False positives are the failure mode — they break the build. The suppression
+ * token (`// premul: ok`) is the escape hatch. False negatives merely defer the
+ * catch to the runtime debug pass.
+ *
+ * ## Suppression
+ *
+ * Add one of these tokens as a `//` comment on the same line as the offending
+ * op to silence the validator for that line:
+ *
+ * - `// premul: ok`
+ * - `// premul: linear-safe`
+ * - `// premul: handled`
+ *
+ * Pair the suppression with a TODO comment when the underlying shader is
+ * actually buggy (so the deferred work is still tracked).
+ *
+ * ## Cost
+ *
+ * Module-load-time: regex over a ~200-line string, done once per `defineModule`
+ * call. Target: under 1 ms per module on modern hardware.
+ *
+ * ## Escape hatch
+ *
+ * Set `NODETOOL_GPU_VALIDATE=off` to disable the validator entirely. Useful for
+ * hotfixes where a misclassified module must ship before the WGSL can be
+ * corrected. Read once at module load via `globalThis.process?.env`.
+ */
+/** Comment tokens that suppress a line-level violation. */
+const SUPPRESSION_TOKENS = [
+    "premul: ok",
+    "premul: linear-safe",
+    "premul: handled"
+];
+/**
+ * Tokens treated as nonlinear ops for the `linear-in-rgb` heuristic. The check
+ * looks for any of these followed by `(` on the same line as a `.rgb` access.
+ * `clamp` is intentionally absent — `clamp(x, 0, 1)` is a saturate (linear-safe).
+ */
+const NONLINEAR_TOKENS = [
+    "pow",
+    "log",
+    "log2",
+    "exp",
+    "exp2",
+    "sqrt",
+    "smoothstep",
+    "step",
+    "floor",
+    "ceil",
+    "round",
+    "trunc",
+    "fract"
+];
+const NONLINEAR_RE = new RegExp(`\\b(?:${NONLINEAR_TOKENS.join("|")})\\s*\\(`);
+const RGB_RE = /\.rgb\b/;
+// `[^=\n]+` keeps the optional type annotation from chewing across newlines —
+// without the `\n` exclusion, `var source: texture_2d<f32>;` would greedily
+// match past intervening lines until it found a later `= textureSample(...)`,
+// polluting the sample-variable set with binding-declaration names.
+const SAMPLE_DECL_RE = /\b(?:let|var)\s+([A-Za-z_][A-Za-z0-9_]*)\s*(?::\s*[^=\n]+)?=\s*(?:textureSample|textureLoad)\b/g;
+/**
+ * Read the env-flag once per process. `off` disables the validator entirely.
+ * Anything else (including unset) leaves it enabled.
+ */
+function validatorDisabled() {
+    // SAFETY: this package compiles without @types/node, so `process` is not a
+    // declared global here. The asserted shape only claims optional members, and
+    // the optional chain reads the flag as unset in a host that has no
+    // `process` (browser, worker) — which leaves the validator enabled.
+    const env = globalThis
+        .process?.env;
+    return env?.NODETOOL_GPU_VALIDATE === "off";
+}
+/** True if the line contains one of the suppression tokens in a `//` comment. */
+function lineSuppressed(line) {
+    const slash = line.indexOf("//");
+    if (slash === -1)
+        return false;
+    const comment = line.slice(slash).toLowerCase();
+    return SUPPRESSION_TOKENS.some((token) => comment.includes(token));
+}
+/**
+ * Find every variable name declared as `let X = textureSample(...)` or
+ * `let X = textureLoad(...)` (also `var X = …`). Returned in declaration
+ * order, deduplicated.
+ */
+function findSampleVariables(wgsl) {
+    const out = new Set();
+    for (const match of wgsl.matchAll(SAMPLE_DECL_RE)) {
+        out.add(match[1]);
+    }
+    return out;
+}
+/**
+ * True iff `line` reads `.rgb` from one of the named sample variables, or
+ * directly off `textureSample(...).rgb` / `textureLoad(...).rgb`.
+ */
+function lineReadsSampleRgb(line, samples) {
+    // Direct textureSample(...).rgb / textureLoad(...).rgb.
+    if (/\btexture(?:Sample|Load)\b[\s\S]*\)\s*\.rgb\b/.test(line)) {
+        return true;
+    }
+    for (const name of samples) {
+        // `\bNAME\.rgb\b` — matches `src.rgb` but not `p.color.rgb`.
+        const re = new RegExp(`(?<![.\\w])${name}\\.rgb\\b`);
+        if (re.test(line))
+            return true;
+    }
+    return false;
+}
+/**
+ * Detect the `nonlinear-in-rgb` unpremul handshake at file scope. Returns
+ * `true` if the module contains any plausible unpremul mechanism — token
+ * `unpremul`, `.rgb /` divide pattern, or all inputs declared
+ * `alpha: "straight"`.
+ */
+function hasUnpremulHandshake(wgsl, inputs) {
+    if (/unpremul/i.test(wgsl))
+        return true;
+    if (/\.rgb\s*\/\s*/.test(wgsl))
+        return true;
+    // Per-channel unpremul: `.r / a`, `.g / a`, `.b / a` patterns count too.
+    if (/\.[rgb]\s*\/\s*[A-Za-z_]/.test(wgsl))
+        return true;
+    const inputNames = Object.keys(inputs);
+    if (inputNames.length === 0)
+        return true; // no premul input to violate
+    const allStraight = inputNames.every((name) => inputs[name].alpha === "straight");
+    return allStraight;
+}
+/**
+ * `alpha-only`: scan the WGSL for any `vec4f(...)` returned-as-output whose
+ * first three components look non-zero. Permissive — only flags the obvious
+ * `vec4f(src.rgb, ...)` / `vec4f(src.r, src.g, src.b, ...)` shapes.
+ */
+function checkAlphaOnly(wgsl) {
+    const violations = [];
+    const lines = wgsl.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (lineSuppressed(line))
+            continue;
+        // Looking for `return vec4f(...)` or `textureStore(..., vec4...(...))`.
+        if (!/\b(?:return|textureStore)\b/.test(line))
+            continue;
+        // Strip out an inline comment so we don't false-positive on `// foo.rgb`.
+        const code = stripLineComment(line);
+        // `vec4<f32>(0.0, 0.0, 0.0, ...)` and `vec4f(0.0, 0.0, 0.0, ...)` are the
+        // canonical zero-RGB form. Any other RGB shape is suspect.
+        if (/\bvec4(?:<f32>|f)\s*\(\s*0(?:\.0+)?\s*,\s*0(?:\.0+)?\s*,\s*0(?:\.0+)?\s*,/.test(code)) {
+            continue;
+        }
+        // `vec4f(0.0)` splats zero everywhere — also fine.
+        if (/\bvec4(?:<f32>|f)\s*\(\s*0(?:\.0+)?\s*\)/.test(code))
+            continue;
+        // No vec4 here at all — not the output line.
+        if (!/\bvec4(?:<f32>|f)\s*\(/.test(code))
+            continue;
+        // Has vec4 and isn't a known zero-RGB form: flag if it references RGB-bearing tokens.
+        if (/\.rgb\b/.test(code) || /\.(?:r|g|b)\b/.test(code)) {
+            violations.push(`line ${i + 1}: alpha-only module writes non-zero RGB to output (\`${line.trim()}\`)`);
+        }
+    }
+    return violations;
+}
+/**
+ * `linear-in-rgb`: flag any line that combines a nonlinear-op token with a
+ * `.rgb` access. Heuristic, brittle on multi-line expressions; that's the
+ * trade-off documented at the top of the file.
+ */
+function checkLinear(wgsl) {
+    const violations = [];
+    const lines = wgsl.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (lineSuppressed(line))
+            continue;
+        const code = stripLineComment(line);
+        if (!RGB_RE.test(code))
+            continue;
+        if (!NONLINEAR_RE.test(code))
+            continue;
+        violations.push(`line ${i + 1}: linear-in-rgb module applies nonlinear op to \`.rgb\` (\`${line.trim()}\`)`);
+    }
+    return violations;
+}
+/**
+ * `nonlinear-in-rgb`: the module must show the unpremul handshake whenever a
+ * sample variable's `.rgb` is read. If no handshake exists at file scope and
+ * any sample `.rgb` access is found, flag once per offending line.
+ */
+function checkNonlinear(wgsl, inputs) {
+    if (hasUnpremulHandshake(wgsl, inputs))
+        return [];
+    const samples = findSampleVariables(wgsl);
+    if (samples.size === 0 && !/\btexture(?:Sample|Load)\b[\s\S]*\.rgb\b/.test(wgsl)) {
+        return [];
+    }
+    const violations = [];
+    const lines = wgsl.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (lineSuppressed(line))
+            continue;
+        const code = stripLineComment(line);
+        if (!lineReadsSampleRgb(code, samples))
+            continue;
+        violations.push(`line ${i + 1}: nonlinear-in-rgb module reads \`.rgb\` from a premul sample without an unpremul handshake (\`${line.trim()}\`)`);
+    }
+    if (violations.length === 0)
+        return [];
+    // Always include the file-level summary first so the error message names
+    // the missing mechanism even when the per-line list is long.
+    return [
+        "module tagged `nonlinear-in-rgb` but no `unpremul` / `.rgb /` divide / all-straight-inputs handshake found",
+        ...violations
+    ];
+}
+/** Strip a trailing `// ...` comment so suppression tokens don't trip pattern matches. */
+function stripLineComment(line) {
+    const slash = line.indexOf("//");
+    if (slash === -1)
+        return line;
+    return line.slice(0, slash);
+}
+/**
+ * Validate that the resolved WGSL is consistent with its declared
+ * {@link LinearityMode}. Returns `{ ok, violations }`; the caller throws.
+ */
+export function validateWgslLinearity(args) {
+    if (validatorDisabled()) {
+        return { ok: true, violations: [] };
+    }
+    const { linearity, wgsl, inputs } = args;
+    let violations = [];
+    switch (linearity) {
+        case "source":
+            // Generators have no premul input to violate; trust the source.
+            break;
+        case "alpha-only":
+            violations = checkAlphaOnly(wgsl);
+            break;
+        case "linear-in-rgb":
+            violations = checkLinear(wgsl);
+            break;
+        case "nonlinear-in-rgb":
+            violations = checkNonlinear(wgsl, inputs);
+            break;
+        default: {
+            // Exhaustiveness: a new mode without a check is a defect, not a silent pass.
+            const _exhaustive = linearity;
+            void _exhaustive;
+        }
+    }
+    return { ok: violations.length === 0, violations };
+}
+//# sourceMappingURL=wgslLinearity.js.map

package/dist/validate/wgslLinearity.js.map

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

package/dist/webgpu/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @nodetool-ai/gpu/webgpu — Browser/WebGPU runtime entry point.
+ *
+ * Kept separate from the package root so the pure blend catalog + pool
+ * contracts (the root export) stay importable by Node-side consumers without
+ * pulling in `navigator.gpu`. This entry adds the browser `GPUContext`
+ * adapter and the shared layer-compositing engine.
+ */
+export * from "../compositor/index.js";
+export { createBrowserGPUContext } from "../context.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/webgpu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webgpu/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/dist/webgpu/index.js

@@ -0,0 +1,11 @@
+/**
+ * @nodetool-ai/gpu/webgpu — Browser/WebGPU runtime entry point.
+ *
+ * Kept separate from the package root so the pure blend catalog + pool
+ * contracts (the root export) stay importable by Node-side consumers without
+ * pulling in `navigator.gpu`. This entry adds the browser `GPUContext`
+ * adapter and the shared layer-compositing engine.
+ */
+export * from "../compositor/index.js";
+export { createBrowserGPUContext } from "../context.js";
+//# sourceMappingURL=index.js.map

package/dist/webgpu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/webgpu/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@nodetool-ai/gpu",
+  "version": "0.8.1",
+  "description": "Canonical blend-mode catalog and shared WGSL blend functions for NodeTool compositors (sketch, timeline, Compositor node)",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "node ../../scripts/build-typescript-workspace.mjs",
+    "test": "node ../../scripts/run-vitest.mjs run",
+    "test:watch": "node ../../scripts/run-vitest.mjs",
+    "lint": "node ../../scripts/run-tsc.mjs --noEmit"
+  },
+  "dependencies": {
+    "@nodetool-ai/protocol": "^0.8.1",
+    "typegpu": "^0.11.6"
+  },
+  "optionalDependencies": {
+    "webgpu": "^0.4.0"
+  },
+  "devDependencies": {
+    "@webgpu/types": "^0.1.70",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "^5.0.1"
+  },
+  "exports": {
+    ".": {
+      "nodetool-dev": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./pool": {
+      "nodetool-dev": "./src/pool.ts",
+      "types": "./dist/pool.d.ts",
+      "import": "./dist/pool.js",
+      "default": "./dist/pool.js"
+    },
+    "./webgpu": {
+      "nodetool-dev": "./src/webgpu/index.ts",
+      "types": "./dist/webgpu/index.d.ts",
+      "import": "./dist/webgpu/index.js",
+      "default": "./dist/webgpu/index.js"
+    },
+    "./node": {
+      "nodetool-dev": "./src/node.ts",
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "default": "./dist/node.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodetool-ai/nodetool.git",
+    "directory": "packages/gpu"
+  },
+  "homepage": "https://nodetool.ai",
+  "bugs": {
+    "url": "https://github.com/nodetool-ai/nodetool/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "nodetool",
+    "ai",
+    "workflow",
+    "workflow-automation",
+    "typescript",
+    "gpu",
+    "webgpu",
+    "wgsl",
+    "blend-modes",
+    "compositor",
+    "shaders"
+  ]
+}