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

package/dist/lib/shader-module/shader-module.cjs

@@ -0,0 +1,105 @@
+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_module_exports = {};
+__export(shader_module_exports, {
+  checkShaderModuleDeprecations: () => checkShaderModuleDeprecations,
+  getShaderModuleUniforms: () => getShaderModuleUniforms,
+  initializeShaderModule: () => initializeShaderModule,
+  initializeShaderModules: () => initializeShaderModules
+});
+module.exports = __toCommonJS(shader_module_exports);
+var import_prop_types = require("../filters/prop-types.cjs");
+var import_shader_injections = require("../shader-assembly/shader-injections.cjs");
+function initializeShaderModules(modules) {
+  modules.map((module2) => initializeShaderModule(module2));
+}
+function initializeShaderModule(module2) {
+  if (module2.instance) {
+    return;
+  }
+  initializeShaderModules(module2.dependencies || []);
+  const {
+    propTypes = {},
+    deprecations = [],
+    // defines = {},
+    inject = {}
+  } = module2;
+  const instance = {
+    normalizedInjections: (0, import_shader_injections.normalizeInjections)(inject),
+    parsedDeprecations: parseDeprecationDefinitions(deprecations)
+  };
+  if (propTypes) {
+    instance.propValidators = (0, import_prop_types.makePropValidators)(propTypes);
+  }
+  module2.instance = instance;
+  let defaultProps = {};
+  if (propTypes) {
+    defaultProps = Object.entries(propTypes).reduce((obj, [key, propType]) => {
+      const value = propType == null ? void 0 : propType.value;
+      if (value) {
+        obj[key] = value;
+      }
+      return obj;
+    }, {});
+  }
+  module2.defaultUniforms = {
+    ...module2.defaultUniforms,
+    ...defaultProps
+  };
+}
+function getShaderModuleUniforms(module2, props, oldUniforms) {
+  var _a;
+  initializeShaderModule(module2);
+  const uniforms = oldUniforms || { ...module2.defaultUniforms };
+  if (props && module2.getUniforms) {
+    return module2.getUniforms(props, uniforms);
+  }
+  return (0, import_prop_types.getValidatedProperties)(props, (_a = module2.instance) == null ? void 0 : _a.propValidators, module2.name);
+}
+function checkShaderModuleDeprecations(shaderModule, shaderSource, log) {
+  var _a;
+  (_a = shaderModule.deprecations) == null ? void 0 : _a.forEach((def) => {
+    var _a2;
+    if ((_a2 = def.regex) == null ? void 0 : _a2.test(shaderSource)) {
+      if (def.deprecated) {
+        log.deprecated(def.old, def.new)();
+      } else {
+        log.removed(def.old, def.new)();
+      }
+    }
+  });
+}
+function parseDeprecationDefinitions(deprecations) {
+  deprecations.forEach((def) => {
+    switch (def.type) {
+      case "function":
+        def.regex = new RegExp(`\\b${def.old}\\(`);
+        break;
+      default:
+        def.regex = new RegExp(`${def.type} ${def.old};`);
+    }
+  });
+  return deprecations;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  checkShaderModuleDeprecations,
+  getShaderModuleUniforms,
+  initializeShaderModule,
+  initializeShaderModules
+});

package/dist/lib/shader-module/shader-module.d.ts

@@ -0,0 +1,98 @@
+import { UniformFormat } from "../../types.js";
+import { PropType, PropValidator } from "../filters/prop-types.js";
+import type { ShaderModuleUniformValue, UniformTypes, UniformValue } from "../utils/uniform-types.js";
+import { ShaderInjection } from "../shader-assembly/shader-injections.js";
+import type { ShaderBinding as Binding } from "../../types.js";
+export type UniformInfo = {
+    format?: UniformFormat;
+} & PropType;
+export type ShaderModuleBindingLayout = {
+    name: string;
+    group: number;
+    /** Which shader stages can access this binding. Uses GPUShaderStage bit flags. */
+    visibility?: number;
+};
+type BindingKeys<T> = {
+    [K in keyof T]: T[K] extends UniformValue ? never : K;
+}[keyof T];
+type UniformKeys<T> = {
+    [K in keyof T]: T[K] extends UniformValue ? K : never;
+}[keyof T];
+export type PickBindings<T> = {
+    [K in BindingKeys<Required<T>>]: T[K];
+};
+export type PickUniforms<T> = {
+    [K in UniformKeys<Required<T>>]: T[K];
+};
+/**
+ * A shader module definition object
+ *
+ * @note Needs to be initialized with `initializeShaderModules`
+ * @note `UniformsT` & `BindingsT` are deduced from `PropsT` by default. If
+ * a custom type for `UniformsT` is used, `BindingsT` should be also be provided.
+ */
+export type ShaderModule<PropsT extends Record<string, any> = Record<string, any>, UniformsT extends Record<string, ShaderModuleUniformValue> = PickUniforms<PropsT>, BindingsT extends Record<string, Binding> = PickBindings<PropsT>> = {
+    /** Used for type inference not for values */
+    props?: PropsT;
+    /** Used for type inference, not currently used for values */
+    uniforms?: UniformsT;
+    /** Used for type inference, not currently used for values */
+    bindings?: BindingsT;
+    /** Logical bind-group assignment for bindings declared by this module */
+    bindingLayout?: readonly ShaderModuleBindingLayout[];
+    /** Preferred starting binding slot for this module's WGSL `@binding(auto)` declarations. */
+    firstBindingSlot?: number;
+    name: string;
+    /** Exclusive named shader interface provided by this module. */
+    implements?: string;
+    /** Language of source when an application-owned transpiler is required. */
+    sourceLanguage?: string;
+    /** WGSL code, or reusable code in sourceLanguage combined with the application source. */
+    source?: string;
+    /** GLSL fragment shader code */
+    fs?: string;
+    /** GLSL vertex shader code */
+    vs?: string;
+    /** Uniform shader types @note: Both order and types MUST match uniform block declarations in shader */
+    uniformTypes?: Required<UniformTypes<UniformsT>>;
+    /** Uniform JS prop types  */
+    propTypes?: Record<keyof UniformsT, UniformInfo>;
+    /** Default uniform values */
+    defaultUniforms?: Required<UniformsT>;
+    /** Function that maps props to uniforms & bindings */
+    getUniforms?: (props: Partial<PropsT>, prevUniforms?: UniformsT) => Partial<UniformsT & BindingsT>;
+    /** Boolean or numeric preprocessor defines contributed by this shader module. */
+    defines?: Record<string, boolean | number>;
+    /** Injections */
+    inject?: Record<string, string | {
+        injection: string;
+        order: number;
+    }>;
+    dependencies?: ShaderModule<any, any>[];
+    /** Information on deprecated properties */
+    deprecations?: ShaderModuleDeprecation[];
+    /** The instance field contains information that is generated at run-time */
+    instance?: {
+        propValidators?: Record<string, PropValidator>;
+        parsedDeprecations: ShaderModuleDeprecation[];
+        normalizedInjections: {
+            vertex: Record<string, ShaderInjection>;
+            fragment: Record<string, ShaderInjection>;
+        };
+    };
+};
+/** Use to generate deprecations when shader module is used */
+export type ShaderModuleDeprecation = {
+    type: string;
+    regex?: RegExp;
+    new: string;
+    old: string;
+    deprecated?: boolean;
+};
+export declare function initializeShaderModules(modules: ShaderModule[]): void;
+export declare function initializeShaderModule(module: ShaderModule): void;
+/** Convert module props to uniforms */
+export declare function getShaderModuleUniforms<ShaderModuleT extends ShaderModule<Record<string, unknown>, Record<string, ShaderModuleUniformValue>>>(module: ShaderModuleT, props?: ShaderModuleT['props'], oldUniforms?: ShaderModuleT['uniforms']): Record<string, Binding | ShaderModuleUniformValue>;
+export declare function checkShaderModuleDeprecations(shaderModule: ShaderModule, shaderSource: string, log: any): void;
+export {};
+//# sourceMappingURL=shader-module.d.ts.map

package/dist/lib/shader-module/shader-module.d.ts.map

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

package/dist/lib/shader-module/shader-module.js

@@ -0,0 +1,104 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { makePropValidators, getValidatedProperties } from "../filters/prop-types.js";
+import { normalizeInjections } from "../shader-assembly/shader-injections.js";
+// SHNDER MODULE API
+export function initializeShaderModules(modules) {
+    modules.map((module) => initializeShaderModule(module));
+}
+export function initializeShaderModule(module) {
+    if (module.instance) {
+        return;
+    }
+    initializeShaderModules(module.dependencies || []);
+    const { propTypes = {}, deprecations = [], 
+    // defines = {},
+    inject = {} } = module;
+    const instance = {
+        normalizedInjections: normalizeInjections(inject),
+        parsedDeprecations: parseDeprecationDefinitions(deprecations)
+    };
+    if (propTypes) {
+        instance.propValidators = makePropValidators(propTypes);
+    }
+    module.instance = instance;
+    // TODO(ib) - we need to apply the original prop types to the default uniforms
+    let defaultProps = {};
+    if (propTypes) {
+        defaultProps = Object.entries(propTypes).reduce((obj, [key, propType]) => {
+            // @ts-expect-error
+            const value = propType?.value;
+            if (value) {
+                // @ts-expect-error
+                obj[key] = value;
+            }
+            return obj;
+        }, {});
+    }
+    // Merge validated default props with existing uniforms. Type assertion needed due to complex generics.
+    module.defaultUniforms = {
+        ...module.defaultUniforms,
+        ...defaultProps
+    };
+}
+/** Convert module props to uniforms */
+export function getShaderModuleUniforms(module, props, oldUniforms) {
+    initializeShaderModule(module);
+    const uniforms = oldUniforms || { ...module.defaultUniforms };
+    // If module has a getUniforms function, use it
+    if (props && module.getUniforms) {
+        return module.getUniforms(props, uniforms);
+    }
+    // Build uniforms from the uniforms array
+    // @ts-expect-error
+    return getValidatedProperties(props, module.instance?.propValidators, module.name);
+}
+/* TODO this looks like it was unused code
+  _defaultGetUniforms(opts: Record<string, any> = {}): Record<string, any> {
+    const uniforms: Record<string, any> = {};
+    const propTypes = this.uniforms;
+
+    for (const key in propTypes) {
+      const propDef = propTypes[key];
+      if (key in opts && !propDef.private) {
+        if (propDef.validate) {
+          assert(propDef.validate(opts[key], propDef), `${this.name}: invalid ${key}`);
+        }
+        uniforms[key] = opts[key];
+      } else {
+        uniforms[key] = propDef.value;
+      }
+    }
+
+    return uniforms;
+  }
+}
+*/
+// Warn about deprecated uniforms or functions
+export function checkShaderModuleDeprecations(shaderModule, shaderSource, log) {
+    shaderModule.deprecations?.forEach(def => {
+        if (def.regex?.test(shaderSource)) {
+            if (def.deprecated) {
+                log.deprecated(def.old, def.new)();
+            }
+            else {
+                log.removed(def.old, def.new)();
+            }
+        }
+    });
+}
+// HELPERS
+function parseDeprecationDefinitions(deprecations) {
+    deprecations.forEach(def => {
+        switch (def.type) {
+            case 'function':
+                def.regex = new RegExp(`\\b${def.old}\\(`);
+                break;
+            default:
+                def.regex = new RegExp(`${def.type} ${def.old};`);
+        }
+    });
+    return deprecations;
+}
+//# sourceMappingURL=shader-module.js.map

package/dist/lib/shader-module/shader-module.js.map

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

package/dist/lib/shader-module/shader-pass.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_pass_exports = {};
+module.exports = __toCommonJS(shader_pass_exports);

package/dist/lib/shader-module/shader-pass.d.ts

@@ -0,0 +1,48 @@
+import type { ShaderBinding as Binding, SamplerProps, TextureFormat } from "../../types.js";
+import type { PickBindings, PickUniforms, ShaderModule } from "./shader-module.js";
+import type { UniformValue } from "../utils/uniform-types.js";
+export type ShaderPassRenderTarget = {
+    /** Width and height scale relative to the renderer output size. */
+    scale?: [number, number];
+    /** Render target format. Defaults to the device preferred color format. */
+    format?: TextureFormat;
+    /** Optional sampling behavior when later passes read this target. */
+    sampler?: SamplerProps;
+    /** Reuse an earlier transient target with an identical size, format, and sampler. */
+    aliasFor?: string;
+    /** Allow WebGPU compute shaders to write this target as a storage texture. */
+    storage?: boolean;
+    /** Resource lifetime. History targets retain their last successfully rendered value. */
+    lifetime?: 'transient' | 'history';
+    /** Initial value used after construction, resize, or an explicit history reset. */
+    initialize?: 'original' | {
+        clearColor: [number, number, number, number];
+    };
+};
+export type ShaderPassInputSource<TargetNameT extends string = string> = 'original' | 'previous' | TargetNameT;
+/**
+ * A ShaderPass is a ShaderModule that can be run "standalone" (e.g. post processing effects)
+ * It adds additional information on how to run the module.
+ * A ShaderPass can require one or more sub passes.
+ */
+export type ShaderPass<PropsT extends Record<string, any> = Record<string, any>, UniformsT extends Record<string, UniformValue> = PickUniforms<PropsT>, BindingsT extends Record<string, Binding> = PickBindings<PropsT>, RenderTargetNameT extends string = never> = ShaderModule<PropsT, UniformsT, BindingsT> & {
+    /** A shader pass can run multiple sub passes */
+    passes?: ShaderSubPass<UniformsT, Extract<keyof BindingsT, string>, RenderTargetNameT>[];
+};
+/** Information on how to run a specific sub pass */
+export type ShaderSubPass<UniformsT extends Record<string, UniformValue> = Record<string, UniformValue>, BindingNameT extends string = string, RenderTargetNameT extends string = string> = {
+    /**
+     * Action indicates whether this pass:
+     * - filters the color in each pixel (provides a `<pass.name>_filterColor()` shader function)
+     * - performs its own sampling (provides a `<pass.name>_sampleColor()` shader function)
+     */
+    action?: 'filter' | 'sample';
+    sampler?: boolean;
+    filter?: boolean;
+    uniforms?: UniformsT;
+    /** Mapping from shader binding name to the logical texture source. */
+    inputs?: Partial<Record<BindingNameT | 'sourceTexture', ShaderPassInputSource<RenderTargetNameT>>>;
+    /** Output target for this sub pass. Defaults to the shared "previous" chain. */
+    output?: 'previous' | RenderTargetNameT;
+};
+//# sourceMappingURL=shader-pass.d.ts.map

package/dist/lib/shader-module/shader-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-pass.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-module/shader-pass.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,IAAI,OAAO,EAAE,YAAY,EAAE,aAAa,EAAC,uBAAoB;AACvF,OAAO,KAAK,EAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAC,2BAAwB;AAC9E,OAAO,KAAK,EAAC,YAAY,EAAC,kCAA+B;AAEzD,MAAM,MAAM,sBAAsB,GAAG;IACnC,mEAAmE;IACnE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,qEAAqE;IACrE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACnC,mFAAmF;IACnF,UAAU,CAAC,EAAE,UAAU,GAAG;QAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,IACjE,UAAU,GACV,UAAU,GACV,WAAW,CAAC;AAEhB;;;;GAIG;AACH,MAAM,MAAM,UAAU,CACpB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxD,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,EACrE,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,EAChE,iBAAiB,SAAS,MAAM,GAAG,KAAK,IACtC,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG;IAC/C,gDAAgD;IAChD,MAAM,CAAC,EAAE,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,SAAS,EAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC,EAAE,CAAC;CAG1F,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,aAAa,CACvB,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC7E,YAAY,SAAS,MAAM,GAAG,MAAM,EACpC,iBAAiB,SAAS,MAAM,GAAG,MAAM,IACvC;IACF;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CACd,MAAM,CAAC,YAAY,GAAG,eAAe,EAAE,qBAAqB,CAAC,iBAAiB,CAAC,CAAC,CACjF,CAAC;IACF,gFAAgF;IAChF,MAAM,CAAC,EAAE,UAAU,GAAG,iBAAiB,CAAC;CACzC,CAAC"}

package/dist/lib/shader-module/shader-pass.js

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

package/dist/lib/shader-module/shader-pass.js.map

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

package/dist/lib/shader-plugin.cjs

@@ -0,0 +1,117 @@
+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_plugin_exports = {};
+__export(shader_plugin_exports, {
+  mergeShaderPluginModules: () => mergeShaderPluginModules,
+  resolveShaderPlugins: () => resolveShaderPlugins
+});
+module.exports = __toCommonJS(shader_plugin_exports);
+var import_types = require("../types.cjs");
+const SHADER_PLUGIN_INJECTION_TARGET_REGEX = /^(vs|fs):(?:#(?:decl|main-start|main-end)|[A-Za-z_][\w-]*)$/;
+function resolveShaderPlugins(plugins = [], shaderLanguage) {
+  const modules = [];
+  const defines = {};
+  const injections = {};
+  const vertexInputs = {};
+  const varyings = {};
+  for (const plugin of plugins) {
+    appendShaderPluginVariant({ modules, defines, injections, vertexInputs, varyings }, plugin);
+    appendShaderPluginVariant({ modules, defines, injections, vertexInputs, varyings }, plugin[shaderLanguage]);
+  }
+  for (const name of Object.keys(varyings)) {
+    if (vertexInputs[name]) {
+      throw new Error(`ShaderPlugin name "${name}" cannot be both a vertex input and a varying`);
+    }
+  }
+  return { modules, defines, injections, vertexInputs, varyings };
+}
+function mergeShaderPluginModules(modules = [], pluginModules = []) {
+  const mergedModules = [...modules];
+  const seenModuleNames = new Set(mergedModules.map((module2) => module2.name));
+  for (const pluginModule of pluginModules) {
+    if (!seenModuleNames.has(pluginModule.name)) {
+      mergedModules.push(pluginModule);
+      seenModuleNames.add(pluginModule.name);
+    }
+  }
+  return mergedModules;
+}
+function appendShaderPluginVariant(resolved, variant) {
+  var _a;
+  if (!variant) {
+    return;
+  }
+  if ((_a = variant.modules) == null ? void 0 : _a.length) {
+    resolved.modules.push(...variant.modules);
+  }
+  if (variant.defines) {
+    Object.assign(resolved.defines, variant.defines);
+  }
+  for (const [name, type] of Object.entries(variant.vertexInputs || {})) {
+    assertShaderPluginInterfaceName(name, "vertex input");
+    const existingType = resolved.vertexInputs[name];
+    if (existingType && existingType !== type) {
+      throw new Error(`ShaderPlugin vertex input "${name}" has conflicting types "${existingType}" and "${type}"`);
+    }
+    resolved.vertexInputs[name] = type;
+  }
+  for (const [name, varying] of Object.entries(variant.varyings || {})) {
+    assertShaderPluginInterfaceName(name, "varying");
+    const normalizedVarying = normalizeShaderPluginVarying(name, varying);
+    const existingVarying = resolved.varyings[name];
+    if (existingVarying && (existingVarying.type !== normalizedVarying.type || existingVarying.interpolation !== normalizedVarying.interpolation)) {
+      throw new Error(`ShaderPlugin varying "${name}" has conflicting declarations "${existingVarying.type}/${existingVarying.interpolation}" and "${normalizedVarying.type}/${normalizedVarying.interpolation}"`);
+    }
+    resolved.varyings[name] = normalizedVarying;
+  }
+  for (const injection of variant.injections || []) {
+    assertNamedShaderPluginInjectionTarget(injection.target);
+    if (!resolved.injections[injection.target]) {
+      resolved.injections[injection.target] = [];
+    }
+    const injections = resolved.injections[injection.target];
+    injections.push({
+      injection: injection.injection,
+      order: injection.order ?? 0
+    });
+  }
+}
+function assertShaderPluginInterfaceName(name, kind) {
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name) || name.startsWith("_luma_")) {
+    throw new Error(`ShaderPlugin ${kind} "${name}" must be a valid non-reserved identifier`);
+  }
+}
+function normalizeShaderPluginVarying(name, varying) {
+  const { primitiveType } = import_types.shaderTypeDecoder.getAttributeShaderTypeInfo(varying.type);
+  const integerType = primitiveType === "i32" || primitiveType === "u32";
+  const interpolation = varying.interpolation || (integerType ? "flat" : "smooth");
+  if (integerType && interpolation === "smooth") {
+    throw new Error(`ShaderPlugin integer varying "${name}" must use flat interpolation`);
+  }
+  return { type: varying.type, interpolation };
+}
+function assertNamedShaderPluginInjectionTarget(target) {
+  if (!SHADER_PLUGIN_INJECTION_TARGET_REGEX.test(target)) {
+    throw new Error(`ShaderPlugin injection target "${target}" must be a named shader anchor or hook`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  mergeShaderPluginModules,
+  resolveShaderPlugins
+});

package/dist/lib/shader-plugin.d.ts

@@ -0,0 +1,68 @@
+import type { ShaderInjection } from "./shader-assembly/shader-injections.js";
+import type { ShaderModule } from "./shader-module/shader-module.js";
+import { type AttributeShaderType } from "../types.js";
+/** Named shader anchor or hook target accepted by ShaderPlugin injections. */
+export type ShaderPluginInjectionTarget = 'vs:#decl' | 'vs:#main-start' | 'vs:#main-end' | 'fs:#decl' | 'fs:#main-start' | 'fs:#main-end' | `vs:${string}` | `fs:${string}`;
+/** Named shader source injection contributed by a ShaderPlugin. */
+export type ShaderPluginInjection = {
+    /** Named shader anchor or hook that receives this source. */
+    target: ShaderPluginInjectionTarget;
+    /** Shader source to inject at the target. */
+    injection: string;
+    /** Relative injection order within the target. */
+    order?: number;
+};
+/** Portable interpolation modes for ShaderPlugin varyings. */
+export type ShaderPluginVaryingInterpolation = 'smooth' | 'flat';
+/** Cross-stage value contributed by a ShaderPlugin. */
+export type ShaderPluginVarying = {
+    /** Portable scalar or vector shader type. */
+    type: AttributeShaderType;
+    /** Defaults to smooth for floating-point types and flat for integer types. */
+    interpolation?: ShaderPluginVaryingInterpolation;
+};
+/** Fully normalized ShaderPlugin varying declaration. */
+export type ResolvedShaderPluginVarying = {
+    type: AttributeShaderType;
+    interpolation: ShaderPluginVaryingInterpolation;
+};
+/** Shared or backend-specific shader assembly contributions. */
+export type ShaderPluginVariant = {
+    /** Shader modules added to shader assembly. */
+    modules?: ShaderModule[];
+    /** Boolean preprocessor defines added to shader assembly. */
+    defines?: Record<string, boolean>;
+    /** Named code injections added to shader assembly. */
+    injections?: ShaderPluginInjection[];
+    /** Shader-facing vertex inputs added by this plugin. Buffer ownership remains with the caller. */
+    vertexInputs?: Record<string, AttributeShaderType>;
+    /** Values transported from the selected vertex entry point to the fragment entry point. */
+    varyings?: Record<string, ShaderPluginVarying>;
+};
+/** Reusable cross-backend shader assembly descriptor. */
+export type ShaderPlugin = ShaderPluginVariant & {
+    /** Stable plugin identifier. */
+    name: string;
+    /** GLSL-only shader assembly contributions. */
+    glsl?: ShaderPluginVariant;
+    /** WGSL-only shader assembly contributions. */
+    wgsl?: ShaderPluginVariant;
+};
+/** ShaderPlugin contributions resolved for one shader language. */
+export type ResolvedShaderPlugins = {
+    /** Resolved shader modules in plugin declaration order. */
+    modules: ShaderModule[];
+    /** Resolved boolean preprocessor defines. */
+    defines: Record<string, boolean>;
+    /** Resolved named code injections grouped by target. */
+    injections: Record<string, ShaderInjection[]>;
+    /** Resolved shader-facing vertex inputs in plugin declaration order. */
+    vertexInputs: Record<string, AttributeShaderType>;
+    /** Resolved cross-stage varyings in plugin declaration order. */
+    varyings: Record<string, ResolvedShaderPluginVarying>;
+};
+/** Resolve shared and backend-specific contributions from shader plugins. */
+export declare function resolveShaderPlugins(plugins: readonly ShaderPlugin[] | undefined, shaderLanguage: 'glsl' | 'wgsl'): ResolvedShaderPlugins;
+/** Preserve explicit module inputs while appending plugin modules by first-seen name. */
+export declare function mergeShaderPluginModules(modules?: readonly ShaderModule[], pluginModules?: readonly ShaderModule[]): ShaderModule[];
+//# sourceMappingURL=shader-plugin.d.ts.map

package/dist/lib/shader-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-plugin.d.ts","sourceRoot":"","sources":["../../src/lib/shader-plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,eAAe,EAAC,+CAA4C;AACzE,OAAO,KAAK,EAAC,YAAY,EAAC,yCAAsC;AAChE,OAAO,EAAoB,KAAK,mBAAmB,EAAC,oBAAiB;AAErE,8EAA8E;AAC9E,MAAM,MAAM,2BAA2B,GACnC,UAAU,GACV,gBAAgB,GAChB,cAAc,GACd,UAAU,GACV,gBAAgB,GAChB,cAAc,GACd,MAAM,MAAM,EAAE,GACd,MAAM,MAAM,EAAE,CAAC;AAEnB,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG;IAClC,6DAA6D;IAC7D,MAAM,EAAE,2BAA2B,CAAC;IACpC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,gCAAgC,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjE,uDAAuD;AACvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,6CAA6C;IAC7C,IAAI,EAAE,mBAAmB,CAAC;IAC1B,8EAA8E;IAC9E,aAAa,CAAC,EAAE,gCAAgC,CAAC;CAClD,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,aAAa,EAAE,gCAAgC,CAAC;CACjD,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG;IAChC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,sDAAsD;IACtD,UAAU,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACrC,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACnD,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAChD,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG;IAC/C,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,+CAA+C;IAC/C,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG;IAClC,2DAA2D;IAC3D,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAC9C,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAClD,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;CACvD,CAAC;AAKF,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,YAAY,EAAE,YAAK,EACrC,cAAc,EAAE,MAAM,GAAG,MAAM,GAC9B,qBAAqB,CAsBvB;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,SAAS,YAAY,EAAO,EACrC,aAAa,GAAE,SAAS,YAAY,EAAO,GAC1C,YAAY,EAAE,CAYhB"}