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

package/dist/lib/shader-generator/glsl/generate-glsl.cjs

@@ -0,0 +1,94 @@
+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 generate_glsl_exports = {};
+__export(generate_glsl_exports, {
+  generateGLSLForModule: () => generateGLSLForModule
+});
+module.exports = __toCommonJS(generate_glsl_exports);
+var import_capitalize = require("../utils/capitalize.cjs");
+function generateGLSLForModule(module2, options) {
+  return generateGLSLUniformDeclarations(module2, options);
+}
+function generateGLSLUniformDeclarations(module2, options) {
+  const glsl = [];
+  switch (options.uniforms) {
+    case "scoped-interface-blocks":
+    case "unscoped-interface-blocks":
+      glsl.push(`layout(std140) uniform ${(0, import_capitalize.capitalize)(module2.name)} {`);
+      break;
+    case "uniforms":
+  }
+  for (const [uniformName, uniformFormat] of Object.entries(module2.uniformTypes || {})) {
+    if (typeof uniformFormat !== "string") {
+      throw new Error(`Composite uniform types are not supported by GLSL shader generation: ${module2.name}.${uniformName}`);
+    }
+    const glslUniformType = getGLSLUniformType(uniformFormat);
+    switch (options.uniforms) {
+      case "scoped-interface-blocks":
+        glsl.push(`  ${glslUniformType} ${uniformName};`);
+        break;
+      case "unscoped-interface-blocks":
+        glsl.push(`  ${glslUniformType} ${module2.name}_${uniformName};`);
+        break;
+      case "uniforms":
+        glsl.push(`uniform ${glslUniformType} ${module2.name}_${uniformName};`);
+    }
+  }
+  switch (options.uniforms) {
+    case "scoped-interface-blocks":
+      glsl.push(`} ${module2.name};`);
+      break;
+    case "unscoped-interface-blocks":
+      glsl.push("};");
+      break;
+    case "uniforms":
+  }
+  glsl.push("");
+  return glsl.join("\n");
+}
+function getGLSLUniformType(uniformFormat) {
+  const UNIFORM_TYPE_TO_GLSL = {
+    f32: "float",
+    i32: "int",
+    u32: "uint",
+    "vec2<f32>": "vec2",
+    "vec3<f32>": "vec3",
+    "vec4<f32>": "vec4",
+    "vec2<i32>": "ivec2",
+    "vec3<i32>": "ivec3",
+    "vec4<i32>": "ivec4",
+    "vec2<u32>": "uvec2",
+    "vec3<u32>": "uvec3",
+    "vec4<u32>": "uvec4",
+    "mat2x2<f32>": "mat2",
+    "mat2x3<f32>": "mat2x3",
+    "mat2x4<f32>": "mat2x4",
+    "mat3x2<f32>": "mat3x2",
+    "mat3x3<f32>": "mat3",
+    "mat3x4<f32>": "mat3x4",
+    "mat4x2<f32>": "mat4x2",
+    "mat4x3<f32>": "mat4x3",
+    "mat4x4<f32>": "mat4"
+  };
+  const glsl = UNIFORM_TYPE_TO_GLSL[uniformFormat];
+  return glsl;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateGLSLForModule
+});

package/dist/lib/shader-generator/glsl/generate-glsl.d.ts

@@ -0,0 +1,7 @@
+import { ShaderModule } from "../../shader-module/shader-module.js";
+export type GLSLGenerationOptions = {
+    shaderLanguage: 'glsl';
+    uniforms: 'scoped-interface-blocks' | 'unscoped-interface-blocks' | 'uniforms';
+};
+export declare function generateGLSLForModule(module: ShaderModule, options: GLSLGenerationOptions): string;
+//# sourceMappingURL=generate-glsl.d.ts.map

package/dist/lib/shader-generator/glsl/generate-glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-glsl.d.ts","sourceRoot":"","sources":["../../../../src/lib/shader-generator/glsl/generate-glsl.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,YAAY,EAAC,6CAA0C;AAG/D,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,yBAAyB,GAAG,2BAA2B,GAAG,UAAU,CAAC;CAChF,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,UAEzF"}

package/dist/lib/shader-generator/glsl/generate-glsl.js

@@ -0,0 +1,79 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { capitalize } from "../utils/capitalize.js";
+export function generateGLSLForModule(module, options) {
+    return generateGLSLUniformDeclarations(module, options);
+}
+function generateGLSLUniformDeclarations(module, options) {
+    const glsl = [];
+    // => layout(std140) uniform UniformBlockName {
+    switch (options.uniforms) {
+        case 'scoped-interface-blocks':
+        case 'unscoped-interface-blocks':
+            glsl.push(`layout(std140) uniform ${capitalize(module.name)} {`);
+            break;
+        case 'uniforms':
+        // ignore
+    }
+    for (const [uniformName, uniformFormat] of Object.entries(module.uniformTypes || {})) {
+        if (typeof uniformFormat !== 'string') {
+            throw new Error(`Composite uniform types are not supported by GLSL shader generation: ${module.name}.${uniformName}`);
+        }
+        const glslUniformType = getGLSLUniformType(uniformFormat);
+        switch (options.uniforms) {
+            case 'scoped-interface-blocks':
+                // => layout(std140) uniform UniformBlockName {
+                glsl.push(`  ${glslUniformType} ${uniformName};`);
+                break;
+            case 'unscoped-interface-blocks':
+                // => layout(std140) uniform UniformBlockName {
+                glsl.push(`  ${glslUniformType} ${module.name}_${uniformName};`);
+                break;
+            case 'uniforms':
+                glsl.push(`uniform ${glslUniformType} ${module.name}_${uniformName};`);
+        }
+    }
+    switch (options.uniforms) {
+        case 'scoped-interface-blocks':
+            glsl.push(`} ${module.name};`);
+            break;
+        case 'unscoped-interface-blocks':
+            glsl.push('};');
+            break;
+        case 'uniforms':
+        // ignore
+    }
+    // final new line
+    glsl.push('');
+    return glsl.join('\n');
+}
+/** Map a luma.gl WebGPU style uniform type to GLSL */
+function getGLSLUniformType(uniformFormat) {
+    const UNIFORM_TYPE_TO_GLSL = {
+        f32: 'float',
+        i32: 'int',
+        u32: 'uint',
+        'vec2<f32>': 'vec2',
+        'vec3<f32>': 'vec3',
+        'vec4<f32>': 'vec4',
+        'vec2<i32>': 'ivec2',
+        'vec3<i32>': 'ivec3',
+        'vec4<i32>': 'ivec4',
+        'vec2<u32>': 'uvec2',
+        'vec3<u32>': 'uvec3',
+        'vec4<u32>': 'uvec4',
+        'mat2x2<f32>': 'mat2',
+        'mat2x3<f32>': 'mat2x3',
+        'mat2x4<f32>': 'mat2x4',
+        'mat3x2<f32>': 'mat3x2',
+        'mat3x3<f32>': 'mat3',
+        'mat3x4<f32>': 'mat3x4',
+        'mat4x2<f32>': 'mat4x2',
+        'mat4x3<f32>': 'mat4x3',
+        'mat4x4<f32>': 'mat4'
+    };
+    const glsl = UNIFORM_TYPE_TO_GLSL[uniformFormat];
+    return glsl;
+}
+//# sourceMappingURL=generate-glsl.js.map

package/dist/lib/shader-generator/glsl/generate-glsl.js.map

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

package/dist/lib/shader-generator/utils/capitalize.cjs

@@ -0,0 +1,29 @@
+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 capitalize_exports = {};
+__export(capitalize_exports, {
+  capitalize: () => capitalize
+});
+module.exports = __toCommonJS(capitalize_exports);
+function capitalize(str) {
+  return typeof str === "string" ? str.charAt(0).toUpperCase() + str.slice(1) : str;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  capitalize
+});

package/dist/lib/shader-generator/utils/capitalize.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Capitalize first letter of a string
+ * @param {string} str
+ * @returns {string}
+ */
+export declare function capitalize(str: string): string;
+//# sourceMappingURL=capitalize.d.ts.map

package/dist/lib/shader-generator/utils/capitalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.d.ts","sourceRoot":"","sources":["../../../../src/lib/shader-generator/utils/capitalize.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/lib/shader-generator/utils/capitalize.js

@@ -0,0 +1,12 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+/**
+ * Capitalize first letter of a string
+ * @param {string} str
+ * @returns {string}
+ */
+export function capitalize(str) {
+    return typeof str === 'string' ? str.charAt(0).toUpperCase() + str.slice(1) : str;
+}
+//# sourceMappingURL=capitalize.js.map

package/dist/lib/shader-generator/utils/capitalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.js","sourceRoot":"","sources":["../../../../src/lib/shader-generator/utils/capitalize.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACpF,CAAC"}

package/dist/lib/shader-generator/wgsl/generate-wgsl.cjs

@@ -0,0 +1,46 @@
+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 generate_wgsl_exports = {};
+__export(generate_wgsl_exports, {
+  generateWGSLForModule: () => generateWGSLForModule,
+  generateWGSLUniformDeclarations: () => generateWGSLUniformDeclarations
+});
+module.exports = __toCommonJS(generate_wgsl_exports);
+var import_capitalize = require("../utils/capitalize.cjs");
+function generateWGSLForModule(module2, options) {
+  return generateWGSLUniformDeclarations(module2, options);
+}
+function generateWGSLUniformDeclarations(module2, options) {
+  const wgsl = [];
+  wgsl.push(`struct ${(0, import_capitalize.capitalize)(module2.name)} {`);
+  for (const [uniformName, uniformFormat] of Object.entries((module2 == null ? void 0 : module2.uniformTypes) || {})) {
+    if (typeof uniformFormat !== "string") {
+      throw new Error(`Composite uniform types are not supported by WGSL shader generation: ${module2.name}.${uniformName}`);
+    }
+    const wgslUniformType = uniformFormat;
+    wgsl.push(`  ${uniformName} : ${wgslUniformType};`);
+  }
+  wgsl.push("};");
+  wgsl.push(`var<uniform> ${module2.name} : ${(0, import_capitalize.capitalize)(module2.name)};`);
+  return wgsl.join("\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateWGSLForModule,
+  generateWGSLUniformDeclarations
+});

package/dist/lib/shader-generator/wgsl/generate-wgsl.d.ts

@@ -0,0 +1,7 @@
+import { ShaderModule } from "../../shader-module/shader-module.js";
+export type WGSLGenerationOptions = {
+    shaderLanguage: 'wgsl';
+};
+export declare function generateWGSLForModule(module: ShaderModule, options: WGSLGenerationOptions): string;
+export declare function generateWGSLUniformDeclarations(module: ShaderModule, options: WGSLGenerationOptions): string;
+//# sourceMappingURL=generate-wgsl.d.ts.map

package/dist/lib/shader-generator/wgsl/generate-wgsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-wgsl.d.ts","sourceRoot":"","sources":["../../../../src/lib/shader-generator/wgsl/generate-wgsl.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAC,6CAA0C;AAG/D,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,UAEzF;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,qBAAqB,UAsB/B"}

package/dist/lib/shader-generator/wgsl/generate-wgsl.js

@@ -0,0 +1,23 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { capitalize } from "../utils/capitalize.js";
+export function generateWGSLForModule(module, options) {
+    return generateWGSLUniformDeclarations(module, options);
+}
+export function generateWGSLUniformDeclarations(module, options) {
+    const wgsl = [];
+    // => uniform UniformBlockName {
+    wgsl.push(`struct ${capitalize(module.name)} {`);
+    for (const [uniformName, uniformFormat] of Object.entries(module?.uniformTypes || {})) {
+        if (typeof uniformFormat !== 'string') {
+            throw new Error(`Composite uniform types are not supported by WGSL shader generation: ${module.name}.${uniformName}`);
+        }
+        const wgslUniformType = uniformFormat;
+        wgsl.push(`  ${uniformName} : ${wgslUniformType};`);
+    }
+    wgsl.push('};');
+    wgsl.push(`var<uniform> ${module.name} : ${capitalize(module.name)};`);
+    return wgsl.join('\n');
+}
+//# sourceMappingURL=generate-wgsl.js.map

package/dist/lib/shader-generator/wgsl/generate-wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-wgsl.js","sourceRoot":"","sources":["../../../../src/lib/shader-generator/wgsl/generate-wgsl.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAG5D,OAAO,EAAC,UAAU,EAAC,+BAA4B;AAM/C,MAAM,UAAU,qBAAqB,CAAC,MAAoB,EAAE,OAA8B;IACxF,OAAO,+BAA+B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,MAAoB,EACpB,OAA8B;IAE9B,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,gCAAgC;IAChC,IAAI,CAAC,IAAI,CAAC,UAAU,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjD,KAAK,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;QACtF,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,wEAAwE,MAAM,CAAC,IAAI,IAAI,WAAW,EAAE,CACrG,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,aAAa,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,KAAK,WAAW,MAAM,eAAe,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhB,IAAI,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

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

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

@@ -0,0 +1,41 @@
+import type { UniformValue } from "../utils/uniform-types.js";
+import type { ShaderPass, ShaderPassInputSource, ShaderPassRenderTarget } from "./shader-pass.js";
+/** One ordered step in a {@link CompositeShaderPass}. */
+export type CompositeShaderPassStep<TargetNameT extends string = string> = {
+    shaderPass: ShaderPass<any, any, any, any>;
+    inputs?: Record<string, ShaderPassInputSource<TargetNameT>>;
+    output?: 'previous' | TargetNameT;
+    uniforms?: Record<string, UniformValue>;
+};
+/** Optional WebGPU compute stage that replaces equivalent fragment-only fallback passes. */
+export type CompositeShaderPassComputeOptimization<TargetNameT extends string = string> = {
+    /** Stable identifier used for compute resources and command labels. */
+    name: string;
+    /** Complete WGSL compute entry point with explicit binding locations. */
+    source: string;
+    /** Existing fragment module that owns the scalar runtime uniforms. */
+    uniformModule: string;
+    /** Explicit WGSL uniform-buffer binding name used by the compute entry point. */
+    uniformBinding: string;
+    /** Scalar uniform packing order used by the compute shader. */
+    uniformNames: readonly string[];
+    /** Composite-pass scalar defaults layered below per-frame runtime overrides. */
+    uniforms: Record<string, number>;
+    /** Logical source image consumed by the fused compute dispatch. */
+    input: ShaderPassInputSource<TargetNameT>;
+    /** Mapping from compute storage-texture names to owned render targets. */
+    outputs: Record<string, TargetNameT>;
+    /** Fragment pass names removed when the WebGPU optimization is supported. */
+    replacedPasses: readonly string[];
+    /** Compute workgroup width and height in highest-resolution output texels. */
+    workgroupSize: readonly [number, number];
+};
+/** Declarative composition of shader passes with owned targets and optional compute execution. */
+export type CompositeShaderPass<TargetNameT extends string = string> = {
+    name: string;
+    renderTargets?: Record<TargetNameT, ShaderPassRenderTarget>;
+    steps: CompositeShaderPassStep<TargetNameT>[];
+    /** Optional fused WebGPU dispatch; existing fragment steps remain the portable fallback. */
+    compute?: CompositeShaderPassComputeOptimization<TargetNameT>;
+};
+//# sourceMappingURL=composite-shader-pass.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composite-shader-pass.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-module/composite-shader-pass.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,YAAY,EAAC,kCAA+B;AACzD,OAAO,KAAK,EAAC,UAAU,EAAE,qBAAqB,EAAE,sBAAsB,EAAC,yBAAsB;AAE7F,yDAAyD;AACzD,MAAM,MAAM,uBAAuB,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,IAAI;IACzE,UAAU,EAAE,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5D,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,MAAM,sCAAsC,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,IAAI;IACxF,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mEAAmE;IACnE,KAAK,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,6EAA6E;IAC7E,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,8EAA8E;IAC9E,aAAa,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,CAAC;AAEF,kGAAkG;AAClG,MAAM,MAAM,mBAAmB,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,IAAI;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;IAC5D,KAAK,EAAE,uBAAuB,CAAC,WAAW,CAAC,EAAE,CAAC;IAC9C,4FAA4F;IAC5F,OAAO,CAAC,EAAE,sCAAsC,CAAC,WAAW,CAAC,CAAC;CAC/D,CAAC"}

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

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

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

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

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

@@ -0,0 +1,83 @@
+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_dependencies_exports = {};
+__export(shader_module_dependencies_exports, {
+  getShaderDependencies: () => getShaderDependencies,
+  getShaderModuleDependencies: () => getShaderModuleDependencies,
+  resolveModules: () => resolveModules
+});
+module.exports = __toCommonJS(shader_module_dependencies_exports);
+var import_shader_module = require("./shader-module.cjs");
+var import_assert = require("../utils/assert.cjs");
+function getShaderModuleDependencies(modules) {
+  const visited = /* @__PURE__ */ new Set();
+  const recursionStack = /* @__PURE__ */ new Set();
+  const result = [];
+  const nameToModule = /* @__PURE__ */ new Map();
+  function checkNameCollision(module2) {
+    const existing = nameToModule.get(module2.name);
+    if (existing && existing !== module2) {
+      throw new Error(`Shader module name collision: Multiple different module objects share the name "${module2.name}". Each module object must have a unique name.`);
+    }
+    nameToModule.set(module2.name, module2);
+  }
+  function visit(module2, path) {
+    if (recursionStack.has(module2)) {
+      const cyclePath = [...path, module2.name].join(" -> ");
+      throw new Error(`Shader module dependency cycle detected: ${cyclePath}`);
+    }
+    if (visited.has(module2)) {
+      return;
+    }
+    checkNameCollision(module2);
+    recursionStack.add(module2);
+    const newPath = [...path, module2.name];
+    if (module2.dependencies) {
+      for (const dep of module2.dependencies) {
+        visit(dep, newPath);
+      }
+    }
+    recursionStack.delete(module2);
+    visited.add(module2);
+    result.push(module2);
+  }
+  for (const module2 of modules) {
+    visit(module2, []);
+  }
+  const interfaceProviders = /* @__PURE__ */ new Set();
+  for (const module2 of result) {
+    if (module2.implements !== void 0) {
+      (0, import_assert.assert)(!interfaceProviders.has(module2.implements));
+      interfaceProviders.add(module2.implements);
+    }
+  }
+  (0, import_shader_module.initializeShaderModules)(result);
+  return result;
+}
+function getShaderDependencies(modules) {
+  return getShaderModuleDependencies(modules);
+}
+function resolveModules(modules) {
+  return getShaderDependencies(modules);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getShaderDependencies,
+  getShaderModuleDependencies,
+  resolveModules
+});

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

@@ -0,0 +1,39 @@
+import { ShaderModule } from "./shader-module.js";
+type AbstractModule = {
+    name: string;
+    implements?: string;
+    dependencies?: AbstractModule[];
+};
+/**
+ * Takes a list of shader module names and returns a new list of
+ * shader module names that includes all dependencies, sorted so
+ * that modules that are dependencies of other modules come first.
+ *
+ * If the shader glsl code from the returned modules is concatenated
+ * in the reverse order, it is guaranteed that all functions be resolved and
+ * that all function and variable definitions come before use.
+ *
+ * @param modules - Array of modules (inline modules or module names)
+ * @return - Array of modules
+ */
+export declare function getShaderModuleDependencies<T extends AbstractModule>(modules: T[]): T[];
+/**
+ * Takes a list of shader module names and returns a new list of
+ * shader module names that includes all dependencies, sorted so
+ * that modules that are dependencies of other modules come first.
+ *
+ * If the shader glsl code from the returned modules is concatenated
+ * in the reverse order, it is guaranteed that all functions be resolved and
+ * that all function and variable definitions come before use.
+ *
+ * @param modules - Array of modules (inline modules or module names)
+ * @return - Array of modules
+ */
+export declare function getShaderDependencies(modules: ShaderModule[]): ShaderModule[];
+/**
+ * Instantiate shader modules and resolve any dependencies
+ * @deprecated Use getShaderDpendencies
+ */
+export declare function resolveModules(modules: ShaderModule[]): ShaderModule[];
+export {};
+//# sourceMappingURL=shader-module-dependencies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shader-module-dependencies.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-module/shader-module-dependencies.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAA0B,2BAAwB;AAKtE,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;CACjC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CA0EvF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE7E;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAEtE"}

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

@@ -0,0 +1,103 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { initializeShaderModules } from "./shader-module.js";
+import { assert } from "../utils/assert.js";
+/**
+ * Takes a list of shader module names and returns a new list of
+ * shader module names that includes all dependencies, sorted so
+ * that modules that are dependencies of other modules come first.
+ *
+ * If the shader glsl code from the returned modules is concatenated
+ * in the reverse order, it is guaranteed that all functions be resolved and
+ * that all function and variable definitions come before use.
+ *
+ * @param modules - Array of modules (inline modules or module names)
+ * @return - Array of modules
+ */
+export function getShaderModuleDependencies(modules) {
+    // Data structures for topological sort
+    const visited = new Set(); // Fully processed modules (black nodes)
+    const recursionStack = new Set(); // Modules in current DFS path (gray nodes)
+    const result = []; // Post-order traversal result
+    const nameToModule = new Map(); // Name collision detection
+    /**
+     * Check for name collisions between distinct module objects
+     */
+    function checkNameCollision(module) {
+        const existing = nameToModule.get(module.name);
+        if (existing && existing !== module) {
+            throw new Error(`Shader module name collision: Multiple different module objects share the name "${module.name}". ` +
+                `Each module object must have a unique name.`);
+        }
+        nameToModule.set(module.name, module);
+    }
+    /**
+     * DFS visit function for topological sort with cycle detection
+     */
+    function visit(module, path) {
+        // Cycle detection: if module is in recursion stack, we've found a back edge
+        if (recursionStack.has(module)) {
+            const cyclePath = [...path, module.name].join(' -> ');
+            throw new Error(`Shader module dependency cycle detected: ${cyclePath}`);
+        }
+        // Already processed: skip if visited
+        if (visited.has(module)) {
+            return;
+        }
+        // Check for name collision before processing
+        checkNameCollision(module);
+        // Mark as visiting (white -> gray)
+        recursionStack.add(module);
+        const newPath = [...path, module.name];
+        // Recursively visit all dependencies
+        if (module.dependencies) {
+            for (const dep of module.dependencies) {
+                visit(dep, newPath);
+            }
+        }
+        // Mark as visited (gray -> black)
+        recursionStack.delete(module);
+        visited.add(module);
+        // Post-order: add to result after all dependencies processed
+        result.push(module);
+    }
+    // Start DFS from each root module
+    for (const module of modules) {
+        visit(module, []);
+    }
+    const interfaceProviders = new Set();
+    for (const module of result) {
+        if (module.implements !== undefined) {
+            // Distinct modules cannot provide the same exclusive shader interface.
+            assert(!interfaceProviders.has(module.implements));
+            interfaceProviders.add(module.implements);
+        }
+    }
+    initializeShaderModules(result);
+    return result;
+}
+/**
+ * Takes a list of shader module names and returns a new list of
+ * shader module names that includes all dependencies, sorted so
+ * that modules that are dependencies of other modules come first.
+ *
+ * If the shader glsl code from the returned modules is concatenated
+ * in the reverse order, it is guaranteed that all functions be resolved and
+ * that all function and variable definitions come before use.
+ *
+ * @param modules - Array of modules (inline modules or module names)
+ * @return - Array of modules
+ */
+export function getShaderDependencies(modules) {
+    return getShaderModuleDependencies(modules);
+}
+// DEPRECATED
+/**
+ * Instantiate shader modules and resolve any dependencies
+ * @deprecated Use getShaderDpendencies
+ */
+export function resolveModules(modules) {
+    return getShaderDependencies(modules);
+}
+//# sourceMappingURL=shader-module-dependencies.js.map