@luma.gl/shaders 0.0.0-stage → 10.0.0-alpha.5

package/dist/lib/shader-assembly/platform-info.cjs

@@ -0,0 +1,15 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var platform_info_exports = {};
+module.exports = __toCommonJS(platform_info_exports);

package/dist/lib/shader-assembly/platform-info.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PlatformInfo
+ * @note Designed so that it can be easily created from a luma.gl Device instance
+ * Without having any actual dependency on `@luma.gl/core`
+ */
+export type PlatformInfo = {
+    /** Current Web GPU API backend */
+    type: 'webgl' | 'webgpu' | 'null' | 'unknown';
+    /** Which shader language is supported */
+    shaderLanguage: 'glsl' | 'wgsl';
+    /** Which shader language version is preferred */
+    shaderLanguageVersion: 100 | 300;
+    /** string identifying current GPU */
+    gpu: string;
+    /** Device limits exposed to shader preprocessing decisions such as platform capability defines. */
+    limits?: Record<string, number | undefined>;
+    /** Feature strings for feature detection */
+    features: Set<string>;
+};
+//# sourceMappingURL=platform-info.d.ts.map

package/dist/lib/shader-assembly/platform-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-info.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-assembly/platform-info.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,kCAAkC;IAClC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,yCAAyC;IACzC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,iDAAiD;IACjD,qBAAqB,EAAE,GAAG,GAAG,GAAG,CAAC;IACjC,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,mGAAmG;IACnG,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,4CAA4C;IAC5C,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC"}

package/dist/lib/shader-assembly/platform-info.js

@@ -0,0 +1,5 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=platform-info.js.map

package/dist/lib/shader-assembly/platform-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-info.js","sourceRoot":"","sources":["../../../src/lib/shader-assembly/platform-info.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D"}

package/dist/lib/shader-assembly/shader-assembly-shared.cjs

@@ -0,0 +1,96 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var shader_assembly_shared_exports = {};
+__export(shader_assembly_shared_exports, {
+  INJECT_SHADER_DECLARATIONS: () => INJECT_SHADER_DECLARATIONS,
+  appendInjections: () => appendInjections,
+  assembleGetUniforms: () => assembleGetUniforms,
+  getShaderModuleSource: () => getShaderModuleSource
+});
+module.exports = __toCommonJS(shader_assembly_shared_exports);
+var import_shader_injections = require("./shader-injections.cjs");
+var import_assert = require("../utils/assert.cjs");
+var import_shader_module_uniform_layout = require("../shader-module/shader-module-uniform-layout.cjs");
+const INJECT_SHADER_DECLARATIONS = `
+
+${import_shader_injections.DECLARATION_INJECT_MARKER}
+`;
+function assembleGetUniforms(modules) {
+  return function getUniforms(opts) {
+    var _a;
+    const uniforms = {};
+    for (const module2 of modules) {
+      const moduleUniforms = (_a = module2.getUniforms) == null ? void 0 : _a.call(module2, opts, uniforms);
+      Object.assign(uniforms, moduleUniforms);
+    }
+    return uniforms;
+  };
+}
+function appendInjections(injections, hookInjections, declInjections, mainInjections) {
+  for (const key in injections) {
+    const match = /^(v|f)s:(#)?([\w-]+)$/.exec(key);
+    if (match) {
+      const hash = match[2];
+      const name = match[3];
+      const injectionType = hash ? name === "decl" ? declInjections : mainInjections : hookInjections;
+      injectionType[key] = injectionType[key] || [];
+      injectionType[key].push(...injections[key]);
+    } else {
+      mainInjections[key] = mainInjections[key] || [];
+      mainInjections[key].push(...injections[key]);
+    }
+  }
+}
+function getShaderModuleSource(module2, stage, log) {
+  let moduleSource;
+  switch (stage) {
+    case "vertex":
+      moduleSource = module2.vs || "";
+      break;
+    case "fragment":
+      moduleSource = module2.fs || "";
+      break;
+    case "wgsl":
+      moduleSource = module2.source || "";
+      break;
+    default:
+      (0, import_assert.assert)(false);
+  }
+  if (!module2.name) {
+    throw new Error("Shader module must have a name");
+  }
+  (0, import_shader_module_uniform_layout.validateShaderModuleUniformLayout)(module2, stage, { log });
+  const moduleName = module2.name.toUpperCase().replace(/[^0-9a-z]/gi, "_");
+  let source = `// ----- MODULE ${module2.name} ---------------
+
+`;
+  if (stage !== "wgsl") {
+    source += `#define MODULE_${moduleName}
+`;
+  }
+  source += `${moduleSource}
+`;
+  return source;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  INJECT_SHADER_DECLARATIONS,
+  appendInjections,
+  assembleGetUniforms,
+  getShaderModuleSource
+});

package/dist/lib/shader-assembly/shader-assembly-shared.d.ts

@@ -0,0 +1,16 @@
+import { type ShaderInjection } from "./shader-injections.js";
+import { type ShaderModule } from "../shader-module/shader-module.js";
+export declare const INJECT_SHADER_DECLARATIONS = "\n\n__LUMA_INJECT_DECLARATIONS__\n";
+/**
+ * Returns a combined `getUniforms` covering the options for all the modules,
+ * the created function will pass on options to the inidividual `getUniforms`
+ * function of each shader module and combine the results into one object that
+ * can be passed to setUniforms.
+ * @param modules
+ * @returns
+ */
+export declare function assembleGetUniforms(modules: ShaderModule[]): (opts: Record<string, any>) => Record<string, any>;
+export declare function appendInjections(injections: Record<string, ShaderInjection[]>, hookInjections: Record<string, ShaderInjection[]>, declInjections: Record<string, ShaderInjection[]>, mainInjections: Record<string, ShaderInjection[]>): void;
+/** Extracts the source code chunk for the specified shader type from the named shader module */
+export declare function getShaderModuleSource(module: ShaderModule, stage: 'vertex' | 'fragment' | 'wgsl', log?: any): string;
+//# sourceMappingURL=shader-assembly-shared.d.ts.map

package/dist/lib/shader-assembly/shader-assembly-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-assembly-shared.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-assembly/shader-assembly-shared.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,eAAe,EAAC,+BAA4B;AACpF,OAAO,EAAC,KAAK,YAAY,EAAC,0CAAuC;AAIjE,eAAO,MAAM,0BAA0B,uCAAuC,CAAC;AAE/E;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,IAC7B,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAU5E;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EAC7C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EACjD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EACjD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,GAChD,IAAI,CAkBN;AAED,gGAAgG;AAChG,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,EACrC,GAAG,CAAC,EAAE,GAAG,GACR,MAAM,CAgCR"}

package/dist/lib/shader-assembly/shader-assembly-shared.js

@@ -0,0 +1,79 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { DECLARATION_INJECT_MARKER } from "./shader-injections.js";
+import { assert } from "../utils/assert.js";
+import { validateShaderModuleUniformLayout } from "../shader-module/shader-module-uniform-layout.js";
+export const INJECT_SHADER_DECLARATIONS = `\n\n${DECLARATION_INJECT_MARKER}\n`;
+/**
+ * Returns a combined `getUniforms` covering the options for all the modules,
+ * the created function will pass on options to the inidividual `getUniforms`
+ * function of each shader module and combine the results into one object that
+ * can be passed to setUniforms.
+ * @param modules
+ * @returns
+ */
+export function assembleGetUniforms(modules) {
+    return function getUniforms(opts) {
+        const uniforms = {};
+        for (const module of modules) {
+            // `modules` is already sorted by dependency level. This guarantees that
+            // modules have access to the uniforms that are generated by their dependencies.
+            const moduleUniforms = module.getUniforms?.(opts, uniforms);
+            Object.assign(uniforms, moduleUniforms);
+        }
+        return uniforms;
+    };
+}
+export function appendInjections(injections, hookInjections, declInjections, mainInjections) {
+    for (const key in injections) {
+        const match = /^(v|f)s:(#)?([\w-]+)$/.exec(key);
+        if (match) {
+            const hash = match[2];
+            const name = match[3];
+            const injectionType = hash
+                ? name === 'decl'
+                    ? declInjections
+                    : mainInjections
+                : hookInjections;
+            injectionType[key] = injectionType[key] || [];
+            injectionType[key].push(...injections[key]);
+        }
+        else {
+            mainInjections[key] = mainInjections[key] || [];
+            mainInjections[key].push(...injections[key]);
+        }
+    }
+}
+/** Extracts the source code chunk for the specified shader type from the named shader module */
+export function getShaderModuleSource(module, stage, log) {
+    let moduleSource;
+    switch (stage) {
+        case 'vertex':
+            moduleSource = module.vs || '';
+            break;
+        case 'fragment':
+            moduleSource = module.fs || '';
+            break;
+        case 'wgsl':
+            moduleSource = module.source || '';
+            break;
+        default:
+            assert(false);
+    }
+    if (!module.name) {
+        throw new Error('Shader module must have a name');
+    }
+    validateShaderModuleUniformLayout(module, stage, { log });
+    const moduleName = module.name.toUpperCase().replace(/[^0-9a-z]/gi, '_');
+    let source = `\
+// ----- MODULE ${module.name} ---------------
+
+`;
+    if (stage !== 'wgsl') {
+        source += `#define MODULE_${moduleName}\n`;
+    }
+    source += `${moduleSource}\n`;
+    return source;
+}
+//# sourceMappingURL=shader-assembly-shared.js.map

package/dist/lib/shader-assembly/shader-assembly-shared.js.map

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

package/dist/lib/shader-assembly/shader-assembly-types.cjs

@@ -0,0 +1,15 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var shader_assembly_types_exports = {};
+module.exports = __toCommonJS(shader_assembly_types_exports);

package/dist/lib/shader-assembly/shader-assembly-types.d.ts

@@ -0,0 +1,128 @@
+import { type PlatformInfo } from "./platform-info.js";
+import { type ShaderModule } from "../shader-module/shader-module.js";
+import { type ShaderHook } from "./shader-hooks.js";
+import { type ShaderInjection } from "./shader-injections.js";
+import { type AttributeShaderType } from "../../types.js";
+import { type ResolvedShaderPluginVarying } from "../shader-plugin.js";
+export type ShaderAssemblyLog = {
+    deprecated?: (...args: unknown[]) => () => unknown;
+    removed?: (...args: unknown[]) => () => unknown;
+    warn?: (...args: unknown[]) => () => unknown;
+};
+/** Props accepted by `ShaderAssembler` assembly methods. */
+export type AssembleShaderProps = AssembleShaderOptions & {
+    platformInfo: PlatformInfo;
+    /** WGSL: single shader source. */
+    source?: string | null;
+    /** GLSL vertex shader source. */
+    vs?: string | null;
+    /** GLSL fragment shader source. */
+    fs?: string | null;
+};
+/** Shared shader assembly options. */
+export type AssembleShaderOptions = {
+    /** information about the platform (which shader language & version, extensions etc.) */
+    platformInfo: PlatformInfo;
+    /** Inject shader id #defines */
+    id?: string;
+    /** Input language compiled by a registered ShaderAssembler transpiler. Defaults to the target language. */
+    sourceLanguage?: string;
+    /** Select compute compilation independently of an optional WGSL entry-point name. */
+    shaderStage?: 'compute';
+    /** WGSL compute entry point selected by the compute pipeline. */
+    computeEntryPoint?: string;
+    /** Modules to be injected */
+    modules?: ShaderModule[];
+    /** Boolean or numeric preprocessor defines evaluated before shader assembly. */
+    defines?: Record<string, boolean | number>;
+    /** GLSL only: Overrides to be injected. In WGSL these are supplied during Pipeline creation time */
+    constants?: Record<string, number>;
+    /** Hook functions */
+    hookFunctions?: readonly (ShaderHook | string)[];
+    /** Code injections */
+    inject?: Record<string, string | ShaderInjection>;
+    /** Ordered code injections contributed by ShaderPlugin descriptors. */
+    pluginInjections?: Record<string, ShaderInjection[]>;
+    /** Vertex inputs contributed by ShaderPlugin descriptors. */
+    pluginVertexInputs?: Record<string, AttributeShaderType>;
+    /** Cross-stage varyings contributed by ShaderPlugin descriptors. */
+    pluginVaryings?: Record<string, ResolvedShaderPluginVarying>;
+    /** WGSL vertex entry point selected by the render pipeline. */
+    vertexEntryPoint?: string;
+    /** Whether WGSL interface scanning should include vertex attributes. */
+    scanVertexAttributes?: boolean;
+    /** WGSL fragment entry point selected by the render pipeline. */
+    fragmentEntryPoint?: string;
+    /** Whether to inject prologue */
+    prologue?: boolean;
+    /** logger object */
+    log?: ShaderAssemblyLog;
+};
+export type AssembleStageOptions = {
+    /** Inject shader id #defines */
+    id?: string;
+    /** Vertex shader */
+    source: string;
+    stage: 'vertex' | 'fragment';
+    /** Modules to be injected */
+    modules: any[];
+    /** Boolean or numeric preprocessor defines evaluated before shader assembly. */
+    defines?: Record<string, boolean | number>;
+    /** GLSL only: Overrides to be injected. In WGSL these are supplied during Pipeline creation time */
+    constants?: Record<string, number>;
+    /** Hook functions */
+    hookFunctions?: readonly (ShaderHook | string)[];
+    /** Code injections */
+    inject?: Record<string, string | ShaderInjection>;
+    /** Ordered code injections contributed by ShaderPlugin descriptors. */
+    pluginInjections?: Record<string, ShaderInjection[]>;
+    /** Vertex inputs contributed by ShaderPlugin descriptors. */
+    pluginVertexInputs?: Record<string, AttributeShaderType>;
+    /** Cross-stage varyings contributed by ShaderPlugin descriptors. */
+    pluginVaryings?: Record<string, ResolvedShaderPluginVarying>;
+    /** WGSL vertex entry point selected by the render pipeline. */
+    vertexEntryPoint?: string;
+    /** WGSL fragment entry point selected by the render pipeline. */
+    fragmentEntryPoint?: string;
+    /** Whether to inject prologue */
+    prologue?: boolean;
+    /** logger object */
+    log?: ShaderAssemblyLog;
+    /** @internal Stable per-assembler WGSL binding assignments. */
+    _bindingRegistry?: Map<string, number>;
+};
+/**
+ * getUniforms function returned from the shader module system
+ */
+export type GetUniformsFunc = (opts: Record<string, any>) => Record<string, any>;
+export type AssembleWGSLShaderOptions = AssembleShaderOptions & {
+    /** Single WGSL shader */
+    source: string;
+    /** @internal Stable per-assembler WGSL binding assignments. */
+    _bindingRegistry?: Map<string, number>;
+};
+export type BindingRelocationContext = {
+    usedBindingsByGroup: Map<number, Set<number>>;
+    bindingRegistry?: Map<string, number>;
+    reservedBindingKeysByGroup: Map<number, Map<number, string>>;
+};
+export type WGSLBindingAssignment = {
+    moduleName: string;
+    name: string;
+    group: number;
+    location: number;
+};
+export type WGSLApplicationRelocationState = {
+    sawSupportedBindingDeclaration: boolean;
+};
+export type WGSLRelocationState = {
+    sawSupportedBindingDeclaration: boolean;
+    nextHintedBindingLocation: number | null;
+};
+export type WGSLRelocationParams = {
+    module: ShaderModule;
+    context: BindingRelocationContext;
+    bindingAssignments: WGSLBindingAssignment[];
+    relocationState: WGSLRelocationState;
+};
+//# sourceMappingURL=shader-assembly-types.d.ts.map

package/dist/lib/shader-assembly/shader-assembly-types.d.ts.map

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

package/dist/lib/shader-assembly/shader-assembly-types.js

@@ -0,0 +1,5 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=shader-assembly-types.js.map

package/dist/lib/shader-assembly/shader-assembly-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-assembly-types.js","sourceRoot":"","sources":["../../../src/lib/shader-assembly/shader-assembly-types.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D"}

package/dist/lib/shader-assembly/shader-hooks.cjs

@@ -0,0 +1,103 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var shader_hooks_exports = {};
+__export(shader_hooks_exports, {
+  getShaderHooks: () => getShaderHooks,
+  isShaderHookRegistered: () => isShaderHookRegistered,
+  normalizeShaderHooks: () => normalizeShaderHooks,
+  validateShaderHookInjections: () => validateShaderHookInjections
+});
+module.exports = __toCommonJS(shader_hooks_exports);
+function getShaderHooks(hookFunctions, hookInjections, shaderLanguage = "glsl") {
+  let result = "";
+  for (const hookName in hookFunctions) {
+    const hookFunction = hookFunctions[hookName];
+    const functionPrefix = shaderLanguage === "wgsl" ? "fn" : "void";
+    result += `${functionPrefix} ${hookFunction.signature} {
+`;
+    if (hookFunction.header) {
+      result += `  ${hookFunction.header}`;
+    }
+    if (hookInjections[hookName]) {
+      const injections = hookInjections[hookName];
+      injections.sort((a, b) => a.order - b.order);
+      for (const injection of injections) {
+        result += `  ${injection.injection}
+`;
+      }
+    }
+    if (hookFunction.footer) {
+      result += `  ${hookFunction.footer}`;
+    }
+    result += "}\n";
+  }
+  return result;
+}
+function normalizeShaderHooks(hookFunctions) {
+  const result = { vertex: {}, fragment: {} };
+  for (const hookFunction of hookFunctions) {
+    addShaderHookToRegistry(result, hookFunction);
+  }
+  return result;
+}
+function isShaderHookRegistered(registry, hookName) {
+  const stageRegistry = hookName.startsWith("vs:") ? registry.vertex : registry.fragment;
+  return Boolean(stageRegistry[hookName]);
+}
+function validateShaderHookInjections(registry, hookInjections, stage) {
+  const stagePrefix = stage === "vertex" ? "vs:" : stage === "fragment" ? "fs:" : null;
+  for (const hookName in hookInjections) {
+    if (stagePrefix && !hookName.startsWith(stagePrefix)) {
+      continue;
+    }
+    if (!isShaderHookRegistered(registry, hookName)) {
+      throw new Error(`Unknown shader hook ${hookName}`);
+    }
+  }
+}
+function addShaderHookToRegistry(registry, hookFunction) {
+  const options = typeof hookFunction === "string" ? {} : hookFunction;
+  const hook = (typeof hookFunction === "string" ? hookFunction : hookFunction.hook).trim();
+  const stageSeparatorIndex = hook.indexOf(":");
+  const shaderStage = hook.slice(0, stageSeparatorIndex);
+  const signature = hook.slice(stageSeparatorIndex + 1);
+  const name = hook.replace(/\(.+/, "");
+  const normalizedHook = {
+    hook: name,
+    signature,
+    header: options.header || "",
+    footer: options.footer || ""
+  };
+  switch (shaderStage) {
+    case "vs":
+      registry.vertex[name] = normalizedHook;
+      break;
+    case "fs":
+      registry.fragment[name] = normalizedHook;
+      break;
+    default:
+      throw new Error(shaderStage);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getShaderHooks,
+  isShaderHookRegistered,
+  normalizeShaderHooks,
+  validateShaderHookInjections
+});

package/dist/lib/shader-assembly/shader-hooks.d.ts

@@ -0,0 +1,45 @@
+import type { ShaderInjection } from "./shader-injections.js";
+/**
+ * The shader hook mechanism allows the application to create shaders
+ * that can be automatically extended by the shader modules the application
+ * includes.
+ *
+ * A shader hook function that shader modules can inject code into.
+ * Shaders can call these functions, which will be no-ops by default.
+ *
+ * If a shader module injects code it will be executed upon the hook
+ * function call.
+ */
+export type ShaderHook = {
+    /** `vs:` or `fs:` followed by the name and arguments of the function, e.g. `vs:MYHOOK_func(inout vec4 value)`. Hook name without arguments
+    will also be used as the name of the shader hook */
+    hook: string;
+    /** Code always included at the beginning of a hook function */
+    header?: string;
+    /** Code always included at the end of a hook function */
+    footer?: string;
+    /** To Be Documented */
+    signature?: string;
+};
+/** Optional source included before or after every injection in a hook function. */
+export type ShaderHookOptions = Pick<ShaderHook, 'header' | 'footer'>;
+/** Shader hook declarations grouped by shader stage. */
+export type ShaderHookRegistry = {
+    vertex: Record<string, Required<ShaderHook>>;
+    fragment: Record<string, Required<ShaderHook>>;
+};
+/** Generate hook source code */
+export declare function getShaderHooks(hookFunctions: Record<string, Required<ShaderHook>>, hookInjections: Record<string, ShaderInjection[]>, shaderLanguage?: 'glsl' | 'wgsl'): string;
+/**
+ * Parse string based hook functions and split them per shader stage.
+ * A later declaration of the same stage-prefixed hook name replaces an earlier one.
+ */
+export declare function normalizeShaderHooks(hookFunctions: readonly (ShaderHook | string)[]): ShaderHookRegistry;
+/** Returns true if a stage-prefixed hook name such as `vs:MY_HOOK` is declared. */
+export declare function isShaderHookRegistered(registry: ShaderHookRegistry, hookName: string): boolean;
+/**
+ * Throws if a named hook injection targets a hook that is not declared for this assembly.
+ * @param stage Only validate injections for this GLSL stage. WGSL validates both stages.
+ */
+export declare function validateShaderHookInjections(registry: ShaderHookRegistry, hookInjections: Record<string, ShaderInjection[]>, stage?: 'vertex' | 'fragment'): void;
+//# sourceMappingURL=shader-hooks.d.ts.map

package/dist/lib/shader-assembly/shader-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-hooks.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-assembly/shader-hooks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,eAAe,EAAC,+BAA4B;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;uDACmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAEtE,wDAAwD;AACxD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,gCAAgC;AAChC,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,EACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EACjD,cAAc,GAAE,MAAM,GAAG,MAAe,GACvC,MAAM,CAuBR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,GAC9C,kBAAkB,CAQpB;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG9F;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,kBAAkB,EAC5B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EACjD,KAAK,CAAC,EAAE,QAAQ,GAAG,UAAU,GAC5B,IAAI,CAaN"}

package/dist/lib/shader-assembly/shader-hooks.js

@@ -0,0 +1,84 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+/** Generate hook source code */
+export function getShaderHooks(hookFunctions, hookInjections, shaderLanguage = 'glsl') {
+    let result = '';
+    for (const hookName in hookFunctions) {
+        const hookFunction = hookFunctions[hookName];
+        const functionPrefix = shaderLanguage === 'wgsl' ? 'fn' : 'void';
+        result += `${functionPrefix} ${hookFunction.signature} {\n`;
+        if (hookFunction.header) {
+            result += `  ${hookFunction.header}`;
+        }
+        if (hookInjections[hookName]) {
+            const injections = hookInjections[hookName];
+            injections.sort((a, b) => a.order - b.order);
+            for (const injection of injections) {
+                result += `  ${injection.injection}\n`;
+            }
+        }
+        if (hookFunction.footer) {
+            result += `  ${hookFunction.footer}`;
+        }
+        result += '}\n';
+    }
+    return result;
+}
+/**
+ * Parse string based hook functions and split them per shader stage.
+ * A later declaration of the same stage-prefixed hook name replaces an earlier one.
+ */
+export function normalizeShaderHooks(hookFunctions) {
+    const result = { vertex: {}, fragment: {} };
+    for (const hookFunction of hookFunctions) {
+        addShaderHookToRegistry(result, hookFunction);
+    }
+    return result;
+}
+/** Returns true if a stage-prefixed hook name such as `vs:MY_HOOK` is declared. */
+export function isShaderHookRegistered(registry, hookName) {
+    const stageRegistry = hookName.startsWith('vs:') ? registry.vertex : registry.fragment;
+    return Boolean(stageRegistry[hookName]);
+}
+/**
+ * Throws if a named hook injection targets a hook that is not declared for this assembly.
+ * @param stage Only validate injections for this GLSL stage. WGSL validates both stages.
+ */
+export function validateShaderHookInjections(registry, hookInjections, stage) {
+    const stagePrefix = stage === 'vertex' ? 'vs:' : stage === 'fragment' ? 'fs:' : null;
+    for (const hookName in hookInjections) {
+        if (stagePrefix && !hookName.startsWith(stagePrefix)) {
+            continue;
+        }
+        if (!isShaderHookRegistered(registry, hookName)) {
+            // The injection targets a hook that was not declared for this stage.
+            throw new Error(`Unknown shader hook ${hookName}`);
+        }
+    }
+}
+function addShaderHookToRegistry(registry, hookFunction) {
+    const options = typeof hookFunction === 'string' ? {} : hookFunction;
+    const hook = (typeof hookFunction === 'string' ? hookFunction : hookFunction.hook).trim();
+    const stageSeparatorIndex = hook.indexOf(':');
+    const shaderStage = hook.slice(0, stageSeparatorIndex);
+    const signature = hook.slice(stageSeparatorIndex + 1);
+    const name = hook.replace(/\(.+/, '');
+    const normalizedHook = {
+        hook: name,
+        signature,
+        header: options.header || '',
+        footer: options.footer || ''
+    };
+    switch (shaderStage) {
+        case 'vs':
+            registry.vertex[name] = normalizedHook;
+            break;
+        case 'fs':
+            registry.fragment[name] = normalizedHook;
+            break;
+        default:
+            throw new Error(shaderStage);
+    }
+}
+//# sourceMappingURL=shader-hooks.js.map