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

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-defines.js","sourceRoot":"","sources":["../../../src/lib/shader-assembly/platform-defines.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAI5D,gEAAgE;AAChE,MAAM,UAAU,wBAAwB,CAAC,YAA0B;IACjE,QAAQ,YAAY,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QACxC,KAAK,OAAO;YACV,OAAO,UAAU,CAAC;;;;;;;CAOvB,CAAC;QAEE,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC;;;;CAIvB,CAAC;QAEE,KAAK,OAAO;YACV,OAAO,UAAU,CAAC;;;;;;;;CAQvB,CAAC;QAEE,KAAK,KAAK;YACR,mCAAmC;YACnC,OAAO,UAAU,CAAC;;CAEvB,CAAC;QAEE;YACE,gEAAgE;YAChE,iEAAiE;YACjE,2BAA2B;YAC3B,OAAO,UAAU,CAAC;;;;;;;;CAQvB,CAAC;IACA,CAAC;AACH,CAAC"}

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, targetInjections, 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 : targetInjections;
+      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 ResolvedShaderInjection } 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, ResolvedShaderInjection[]>, targetInjections: Record<string, ResolvedShaderInjection[]>, declInjections: Record<string, ResolvedShaderInjection[]>, mainInjections: Record<string, ResolvedShaderInjection[]>): 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,uBAAuB,EAAC,+BAA4B;AAC5F,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,uBAAuB,EAAE,CAAC,EACrD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,EAC3D,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,EACzD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,GACxD,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, targetInjections, 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
+                : targetInjections;
+            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,132 @@
+import { type PlatformInfo } from "./platform-info.js";
+import { type ShaderModule } from "../shader-module/shader-module.js";
+import { type ShaderInjectionTarget } from "./shader-injection-targets.js";
+import { type ShaderInjection, type ResolvedShaderInjection } from "./shader-injections.js";
+import { type AttributeShaderType } from "../../types.js";
+import { type ResolvedShaderPluginInterStageVariable } 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>;
+    /** Per-call injection targets, appended after registered assembler targets; matching names override for this call. */
+    injectionTargets?: readonly ShaderInjectionTarget[];
+    /** Injection target declarations contributed by resolved plugins. */
+    pluginInjectionTargets?: readonly ShaderInjectionTarget[];
+    /** Code injections */
+    inject?: readonly ShaderInjection[] | Record<string, string | ResolvedShaderInjection>;
+    /** Ordered code injections contributed by ShaderPlugin descriptors. */
+    pluginInjections?: Record<string, ResolvedShaderInjection[]>;
+    /** Vertex inputs contributed by ShaderPlugin descriptors. */
+    pluginVertexInputs?: Record<string, AttributeShaderType>;
+    /** Inter-stage variables contributed by ShaderPlugin descriptors. */
+    pluginInterStageVariables?: Record<string, ResolvedShaderPluginInterStageVariable>;
+    /** 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>;
+    /** Per-call injection targets, appended after registered assembler targets; matching names override for this call. */
+    injectionTargets?: readonly ShaderInjectionTarget[];
+    /** Injection target declarations contributed by resolved plugins. */
+    pluginInjectionTargets?: readonly ShaderInjectionTarget[];
+    /** Code injections */
+    inject?: readonly ShaderInjection[] | Record<string, string | ResolvedShaderInjection>;
+    /** Ordered code injections contributed by ShaderPlugin descriptors. */
+    pluginInjections?: Record<string, ResolvedShaderInjection[]>;
+    /** Vertex inputs contributed by ShaderPlugin descriptors. */
+    pluginVertexInputs?: Record<string, AttributeShaderType>;
+    /** Inter-stage variables contributed by ShaderPlugin descriptors. */
+    pluginInterStageVariables?: Record<string, ResolvedShaderPluginInterStageVariable>;
+    /** 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-injection-targets.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_injection_targets_exports = {};
+__export(shader_injection_targets_exports, {
+  getShaderInjectionTargets: () => getShaderInjectionTargets,
+  isShaderInjectionTargetRegistered: () => isShaderInjectionTargetRegistered,
+  normalizeShaderInjectionTargets: () => normalizeShaderInjectionTargets,
+  validateShaderInjectionTargetInjections: () => validateShaderInjectionTargetInjections
+});
+module.exports = __toCommonJS(shader_injection_targets_exports);
+function getShaderInjectionTargets(injectionTargets, targetInjections, shaderLanguage = "glsl") {
+  let result = "";
+  for (const targetName in injectionTargets) {
+    const targetFunction = injectionTargets[targetName];
+    const returnType = targetFunction.returnType || "void";
+    const functionPrefix = shaderLanguage === "wgsl" ? "fn" : returnType;
+    const returnSuffix = shaderLanguage === "wgsl" && returnType !== "void" ? ` -> ${returnType}` : "";
+    result += `${functionPrefix} ${targetFunction.signature}${returnSuffix} {
+`;
+    if (targetFunction.header) {
+      result += `  ${targetFunction.header}`;
+    }
+    if (targetInjections[targetName]) {
+      const injections = targetInjections[targetName];
+      injections.sort((a, b) => a.order - b.order);
+      for (const injection of injections) {
+        result += `  ${injection.injection}
+`;
+      }
+    }
+    if (targetFunction.footer) {
+      result += `  ${targetFunction.footer}`;
+    }
+    result += "}\n";
+  }
+  return result;
+}
+function normalizeShaderInjectionTargets(injectionTargets, pluginInjectionTargets = [], language = "glsl") {
+  const result = { vertex: {}, fragment: {} };
+  for (const injectionTarget of injectionTargets) {
+    const implementation = injectionTarget[language];
+    if (implementation) {
+      const prefix = injectionTarget.stage === "vertex" ? "vs" : "fs";
+      result[injectionTarget.stage][`${prefix}:${injectionTarget.name}`] = {
+        ...implementation,
+        signature: `${injectionTarget.name}(${implementation.parameters})`
+      };
+    }
+  }
+  for (const injectionTarget of pluginInjectionTargets) {
+    const selected = normalizeShaderInjectionTargets([injectionTarget], [], language);
+    for (const stage of ["vertex", "fragment"]) {
+      for (const [name, declaration] of Object.entries(selected[stage])) {
+        const existing = result[stage][name];
+        if (existing && (existing.signature !== declaration.signature || (existing.returnType || "void") !== (declaration.returnType || "void"))) {
+          throw new Error(`Conflicting ShaderPlugin injection target ${name}`);
+        }
+        result[stage][name] = existing || declaration;
+      }
+    }
+  }
+  return result;
+}
+function isShaderInjectionTargetRegistered(registry, targetName) {
+  const stageRegistry = targetName.startsWith("vs:") ? registry.vertex : registry.fragment;
+  return Boolean(stageRegistry[targetName]);
+}
+function validateShaderInjectionTargetInjections(registry, targetInjections, stage) {
+  const stagePrefix = stage === "vertex" ? "vs:" : stage === "fragment" ? "fs:" : null;
+  for (const targetName in targetInjections) {
+    if (stagePrefix && !targetName.startsWith(stagePrefix)) {
+      continue;
+    }
+    if (!isShaderInjectionTargetRegistered(registry, targetName)) {
+      const pluginNames = [
+        ...new Set(targetInjections[targetName].map((injection) => injection.pluginName).filter(Boolean))
+      ];
+      throw new Error(`Unknown shader injection target ${targetName}${pluginNames.length ? ` (plugins: ${pluginNames.join(", ")})` : ""}`);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getShaderInjectionTargets,
+  isShaderInjectionTargetRegistered,
+  normalizeShaderInjectionTargets,
+  validateShaderInjectionTargetInjections
+});

package/dist/lib/shader-assembly/shader-injection-targets.d.ts

@@ -0,0 +1,46 @@
+import type { ResolvedShaderInjection } from "./shader-injections.js";
+/** A named callable target for shader source injections. */
+export type ShaderInjectionTarget = {
+    /** Function name shared by both shader languages. */
+    name: string;
+    /** Shader stage that calls the target. */
+    stage: 'vertex' | 'fragment';
+    /** GLSL signature and source surrounding injected statements. */
+    glsl?: {
+        parameters: string;
+        returnType?: string;
+        header?: string;
+        footer?: string;
+    };
+    /** WGSL signature and source surrounding injected statements. */
+    wgsl?: {
+        parameters: string;
+        returnType?: string;
+        header?: string;
+        footer?: string;
+    };
+};
+/** Language-selected target ready for source generation. */
+type ResolvedShaderInjectionTarget = NonNullable<ShaderInjectionTarget['glsl']> & {
+    signature: string;
+};
+/** Normalized shader injection targets per shader */
+export type ShaderInjectionTargetRegistry = {
+    /** Normalized shader injection targets for vertex shader */
+    vertex: Record<string, ResolvedShaderInjectionTarget>;
+    /** Normalized shader injection targets for fragment shader */
+    fragment: Record<string, ResolvedShaderInjectionTarget>;
+};
+/** Generate injection target source code */
+export declare function getShaderInjectionTargets(injectionTargets: Record<string, ResolvedShaderInjectionTarget>, targetInjections: Record<string, ResolvedShaderInjection[]>, shaderLanguage?: 'glsl' | 'wgsl'): string;
+/** Select language syntax and merge compatible plugin declarations without mutating descriptors. */
+export declare function normalizeShaderInjectionTargets(injectionTargets: readonly ShaderInjectionTarget[], pluginInjectionTargets?: readonly ShaderInjectionTarget[], language?: 'glsl' | 'wgsl'): ShaderInjectionTargetRegistry;
+/** Returns true if a stage-prefixed target name such as `vs:MY_HOOK` is declared. */
+export declare function isShaderInjectionTargetRegistered(registry: ShaderInjectionTargetRegistry, targetName: string): boolean;
+/**
+ * Throws if an injection into a named target refers to one that is not declared for this assembly.
+ * @param stage Only validate injections for this GLSL stage. WGSL validates both stages.
+ */
+export declare function validateShaderInjectionTargetInjections(registry: ShaderInjectionTargetRegistry, targetInjections: Record<string, ResolvedShaderInjection[]>, stage?: 'vertex' | 'fragment'): void;
+export {};
+//# sourceMappingURL=shader-injection-targets.d.ts.map

package/dist/lib/shader-assembly/shader-injection-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-injection-targets.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-assembly/shader-injection-targets.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,uBAAuB,EAAC,+BAA4B;AAEjE,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG;IAClC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,iEAAiE;IACjE,IAAI,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,iEAAiE;IACjE,IAAI,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,4DAA4D;AAC5D,KAAK,6BAA6B,GAAG,WAAW,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,GAAG;IAChF,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,6BAA6B,GAAG;IAC1C,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;IACtD,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;CACzD,CAAC;AAEF,4CAA4C;AAC5C,wBAAgB,yBAAyB,CACvC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,EAC/D,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,EAC3D,cAAc,GAAE,MAAM,GAAG,MAAe,GACvC,MAAM,CA0BR;AAED,oGAAoG;AACpG,wBAAgB,+BAA+B,CAC7C,gBAAgB,EAAE,SAAS,qBAAqB,EAAE,EAClD,sBAAsB,GAAE,SAAS,qBAAqB,EAAO,EAC7D,QAAQ,GAAE,MAAM,GAAG,MAAe,GACjC,6BAA6B,CA6B/B;AAED,qFAAqF;AACrF,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,6BAA6B,EACvC,UAAU,EAAE,MAAM,GACjB,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,6BAA6B,EACvC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,EAC3D,KAAK,CAAC,EAAE,QAAQ,GAAG,UAAU,GAC5B,IAAI,CAoBN"}