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

package/dist/lib/shader-plugin.js

@@ -0,0 +1,98 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { shaderTypeDecoder } from "../types.js";
+const SHADER_PLUGIN_INJECTION_TARGET_REGEX = /^(vs|fs):(?:#(?:decl|main-start|main-end)|[A-Za-z_][\w-]*)$/;
+/** Resolve shared and backend-specific contributions from shader plugins. */
+export 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 };
+}
+/** Preserve explicit module inputs while appending plugin modules by first-seen name. */
+export function mergeShaderPluginModules(modules = [], pluginModules = []) {
+    const mergedModules = [...modules];
+    const seenModuleNames = new Set(mergedModules.map(module => module.name));
+    for (const pluginModule of pluginModules) {
+        if (!seenModuleNames.has(pluginModule.name)) {
+            mergedModules.push(pluginModule);
+            seenModuleNames.add(pluginModule.name);
+        }
+    }
+    return mergedModules;
+}
+function appendShaderPluginVariant(resolved, variant) {
+    if (!variant) {
+        return;
+    }
+    if (variant.modules?.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 } = 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`);
+    }
+}
+//# sourceMappingURL=shader-plugin.js.map

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

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

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

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

@@ -0,0 +1,27 @@
+import type { PlatformInfo } from "../shader-assembly/platform-info.js";
+export type ShaderTranspilerEntryPoints = {
+    vertex?: string;
+    fragment?: string;
+    compute?: string;
+};
+/** One translation unit, including source-language module dependencies. */
+export type ShaderTranspileProps = {
+    source: string;
+    target: 'glsl' | 'wgsl';
+    /** GLSL compiles one stage at a time; WGSL may compile a unified render program. */
+    stage?: 'vertex' | 'fragment' | 'compute';
+    entryPoints: ShaderTranspilerEntryPoints;
+    platformInfo: PlatformInfo;
+};
+export type ShaderTranspileResult = {
+    code: string;
+    /** Generated names selected by subsequent interface scanning and pipeline creation. */
+    entryPoints?: ShaderTranspilerEntryPoints;
+};
+/** Application-owned compiler. Shaders has no dependency on its implementation. */
+export type ShaderTranspiler = {
+    name: string;
+    sourceLanguage: string;
+    transpile: (props: ShaderTranspileProps) => ShaderTranspileResult;
+};
+//# sourceMappingURL=shader-transpiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shader-transpiler.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-transpiler/shader-transpiler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,YAAY,EAAC,4CAAyC;AAEnE,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,oFAAoF;IACpF,KAAK,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,WAAW,EAAE,2BAA2B,CAAC;IACzC,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,WAAW,CAAC,EAAE,2BAA2B,CAAC;CAC3C,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,qBAAqB,CAAC;CACnE,CAAC"}

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

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

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

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

package/dist/lib/shader-transpiler/transpile-glsl-shader.cjs

@@ -0,0 +1,71 @@
+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 transpile_glsl_shader_exports = {};
+__export(transpile_glsl_shader_exports, {
+  transpileGLSLShader: () => transpileGLSLShader
+});
+module.exports = __toCommonJS(transpile_glsl_shader_exports);
+function transpileGLSLShader(source, stage) {
+  var _a;
+  const sourceGLSLVersion = Number(((_a = source.match(/^#version[ \t]+(\d+)/m)) == null ? void 0 : _a[1]) || 100);
+  if (sourceGLSLVersion !== 300) {
+    throw new Error("luma.gl v9 only supports GLSL 3.00 shader sources");
+  }
+  switch (stage) {
+    case "vertex":
+      source = convertShader(source, ES300_VERTEX_REPLACEMENTS);
+      return source;
+    case "fragment":
+      source = convertShader(source, ES300_FRAGMENT_REPLACEMENTS);
+      return source;
+    default:
+      throw new Error(stage);
+  }
+}
+const ES300_REPLACEMENTS = [
+  // Fix poorly formatted version directive
+  [/^(#version[ \t]+(100|300[ \t]+es))?[ \t]*\n/, "#version 300 es\n"],
+  // The individual `texture...()` functions were replaced with `texture()` overloads
+  [/\btexture(2D|2DProj|Cube)Lod(EXT)?\(/g, "textureLod("],
+  [/\btexture(2D|2DProj|Cube)(EXT)?\(/g, "texture("]
+];
+const ES300_VERTEX_REPLACEMENTS = [
+  ...ES300_REPLACEMENTS,
+  // `attribute` keyword replaced with `in`
+  [makeVariableTextRegExp("attribute"), "in $1"],
+  // `varying` keyword replaced with `out`
+  [makeVariableTextRegExp("varying"), "out $1"]
+];
+const ES300_FRAGMENT_REPLACEMENTS = [
+  ...ES300_REPLACEMENTS,
+  // `varying` keyword replaced with `in`
+  [makeVariableTextRegExp("varying"), "in $1"]
+];
+function convertShader(source, replacements) {
+  for (const [pattern, replacement] of replacements) {
+    source = source.replace(pattern, replacement);
+  }
+  return source;
+}
+function makeVariableTextRegExp(qualifier) {
+  return new RegExp(`\\b${qualifier}[ \\t]+(\\w+[ \\t]+\\w+(\\[\\w+\\])?;)`, "g");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  transpileGLSLShader
+});

package/dist/lib/shader-transpiler/transpile-glsl-shader.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Transpiles GLSL 3.00 shader source code to target GLSL version (3.00 or 1.00)
+ *
+ * @note We always run transpiler even if same version e.g. 3.00 => 3.00
+ * @note For texture sampling transpilation, apps need to use non-standard texture* calls in GLSL 3.00 source
+ * RFC: https://github.com/visgl/luma.gl/blob/7.0-release/dev-docs/RFCs/v6.0/portable-glsl-300-rfc.md
+ */
+export declare function transpileGLSLShader(source: string, stage: 'vertex' | 'fragment'): string;
+//# sourceMappingURL=transpile-glsl-shader.d.ts.map

package/dist/lib/shader-transpiler/transpile-glsl-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpile-glsl-shader.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-transpiler/transpile-glsl-shader.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAkBxF"}

package/dist/lib/shader-transpiler/transpile-glsl-shader.js

@@ -0,0 +1,69 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+// TRANSPILATION TABLES
+/**
+ * Transpiles GLSL 3.00 shader source code to target GLSL version (3.00 or 1.00)
+ *
+ * @note We always run transpiler even if same version e.g. 3.00 => 3.00
+ * @note For texture sampling transpilation, apps need to use non-standard texture* calls in GLSL 3.00 source
+ * RFC: https://github.com/visgl/luma.gl/blob/7.0-release/dev-docs/RFCs/v6.0/portable-glsl-300-rfc.md
+ */
+export function transpileGLSLShader(source, stage) {
+    const sourceGLSLVersion = Number(source.match(/^#version[ \t]+(\d+)/m)?.[1] || 100);
+    if (sourceGLSLVersion !== 300) {
+        // TODO - we splurge on a longer error message to help deck.gl custom layer developers
+        throw new Error('luma.gl v9 only supports GLSL 3.00 shader sources');
+    }
+    switch (stage) {
+        case 'vertex':
+            source = convertShader(source, ES300_VERTEX_REPLACEMENTS);
+            return source;
+        case 'fragment':
+            source = convertShader(source, ES300_FRAGMENT_REPLACEMENTS);
+            return source;
+        default:
+            // Unknown shader stage
+            throw new Error(stage);
+    }
+}
+/** Simple regex replacements for GLSL ES 1.00 syntax that has changed in GLSL ES 3.00 */
+const ES300_REPLACEMENTS = [
+    // Fix poorly formatted version directive
+    [/^(#version[ \t]+(100|300[ \t]+es))?[ \t]*\n/, '#version 300 es\n'],
+    // The individual `texture...()` functions were replaced with `texture()` overloads
+    [/\btexture(2D|2DProj|Cube)Lod(EXT)?\(/g, 'textureLod('],
+    [/\btexture(2D|2DProj|Cube)(EXT)?\(/g, 'texture(']
+];
+const ES300_VERTEX_REPLACEMENTS = [
+    ...ES300_REPLACEMENTS,
+    // `attribute` keyword replaced with `in`
+    [makeVariableTextRegExp('attribute'), 'in $1'],
+    // `varying` keyword replaced with `out`
+    [makeVariableTextRegExp('varying'), 'out $1']
+];
+/** Simple regex replacements for GLSL ES 1.00 syntax that has changed in GLSL ES 3.00 */
+const ES300_FRAGMENT_REPLACEMENTS = [
+    ...ES300_REPLACEMENTS,
+    // `varying` keyword replaced with `in`
+    [makeVariableTextRegExp('varying'), 'in $1']
+];
+function convertShader(source, replacements) {
+    for (const [pattern, replacement] of replacements) {
+        source = source.replace(pattern, replacement);
+    }
+    return source;
+}
+/**
+ * Creates a regexp that tests for a specific variable type
+ * @example
+ *   should match:
+ *     in float weight;
+ *     out vec4 positions[2];
+ *   should not match:
+ *     void f(out float a, in float b) {}
+ */
+function makeVariableTextRegExp(qualifier) {
+    return new RegExp(`\\b${qualifier}[ \\t]+(\\w+[ \\t]+\\w+(\\[\\w+\\])?;)`, 'g');
+}
+//# sourceMappingURL=transpile-glsl-shader.js.map

package/dist/lib/shader-transpiler/transpile-glsl-shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpile-glsl-shader.js","sourceRoot":"","sources":["../../../src/lib/shader-transpiler/transpile-glsl-shader.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,uBAAuB;AAEvB;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,KAA4B;IAC9E,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACpF,IAAI,iBAAiB,KAAK,GAAG,EAAE,CAAC;QAC9B,sFAAsF;QACtF,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,QAAQ;YACX,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC;QAChB,KAAK,UAAU;YACb,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;YAC5D,OAAO,MAAM,CAAC;QAChB;YACE,uBAAuB;YACvB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAID,yFAAyF;AACzF,MAAM,kBAAkB,GAAsB;IAC5C,yCAAyC;IACzC,CAAC,6CAA6C,EAAE,mBAAmB,CAAC;IACpE,mFAAmF;IACnF,CAAC,uCAAuC,EAAE,aAAa,CAAC;IACxD,CAAC,oCAAoC,EAAE,UAAU,CAAC;CACnD,CAAC;AAEF,MAAM,yBAAyB,GAAsB;IACnD,GAAG,kBAAkB;IACrB,yCAAyC;IACzC,CAAC,sBAAsB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC9C,wCAAwC;IACxC,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;CAC9C,CAAC;AAEF,yFAAyF;AACzF,MAAM,2BAA2B,GAAsB;IACrD,GAAG,kBAAkB;IACrB,uCAAuC;IACvC,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7C,CAAC;AAEF,SAAS,aAAa,CAAC,MAAc,EAAE,YAA+B;IACpE,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,YAAY,EAAE,CAAC;QAClD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,sBAAsB,CAAC,SAAiD;IAC/E,OAAO,IAAI,MAAM,CAAC,MAAM,SAAS,wCAAwC,EAAE,GAAG,CAAC,CAAC;AAClF,CAAC"}

package/dist/lib/utils/assert.cjs

@@ -0,0 +1,34 @@
+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 assert_exports = {};
+__export(assert_exports, {
+  assert: () => assert
+});
+module.exports = __toCommonJS(assert_exports);
+function assert(condition, message) {
+  var _a;
+  if (!condition) {
+    const error = new Error(message || "shaders: assertion failed.");
+    (_a = Error.captureStackTrace) == null ? void 0 : _a.call(Error, error, assert);
+    throw error;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assert
+});

package/dist/lib/utils/assert.d.ts

@@ -0,0 +1,2 @@
+export declare function assert(condition: unknown, message?: string): void;
+//# sourceMappingURL=assert.d.ts.map

package/dist/lib/utils/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/assert.ts"],"names":[],"mappings":"AAMA,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAMjE"}

package/dist/lib/utils/assert.js

@@ -0,0 +1,13 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+// Recommendation is to ignore message but current test suite checks against the
+// message so keep it for now.
+export function assert(condition, message) {
+    if (!condition) {
+        const error = new Error(message || 'shaders: assertion failed.');
+        Error.captureStackTrace?.(error, assert);
+        throw error;
+    }
+}
+//# sourceMappingURL=assert.js.map

package/dist/lib/utils/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../../src/lib/utils/assert.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,gFAAgF;AAChF,8BAA8B;AAC9B,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,OAAgB;IACzD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,IAAI,4BAA4B,CAAC,CAAC;QACjE,KAAK,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/utils/uniform-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 uniform_types_exports = {};
+module.exports = __toCommonJS(uniform_types_exports);

package/dist/lib/utils/uniform-types.d.ts

@@ -0,0 +1,18 @@
+import type { Matrix3, Matrix4, Vector2, Vector3, Vector4, NumberArray2, NumberArray3, NumberArray4, NumberArray6, NumberArray8, NumberArray9, NumberArray12, NumberArray16 } from '@math.gl/core';
+import type { CompositeShaderType } from "../../types.js";
+export type UniformValue = Readonly<number | boolean | NumberArray2 | NumberArray3 | NumberArray4 | NumberArray6 | NumberArray8 | NumberArray9 | NumberArray12 | NumberArray16 | Vector2 | Vector3 | Vector4 | Matrix3 | Matrix4>;
+export type ShaderModuleUniformValue = UniformValue | ShaderModuleUniformStruct | ShaderModuleUniformArray;
+export type ShaderModuleUniformStruct = {
+    [name: string]: ShaderModuleUniformValue | undefined;
+};
+export type ShaderModuleUniformArray = ReadonlyArray<ShaderModuleUniformValue | undefined>;
+type UniformLeafType<ValueT extends UniformValue> = ValueT extends number | boolean ? 'f32' | 'i32' | 'u32' : ValueT extends Readonly<NumberArray2 | Vector2> ? 'vec2<f32>' | 'vec2<i32>' | 'vec2<u32>' : ValueT extends Readonly<NumberArray3 | Vector3> ? 'vec3<f32>' | 'vec3<i32>' | 'vec3<u32>' : ValueT extends Readonly<NumberArray4 | Vector4> ? 'vec4<f32>' | 'vec4<i32>' | 'vec4<u32>' | 'mat2x2<f32>' : ValueT extends Readonly<NumberArray6> ? 'mat2x3<f32>' | 'mat3x2<f32>' : ValueT extends Readonly<NumberArray8> ? 'mat2x4<f32>' | 'mat4x2<f32>' : ValueT extends Readonly<NumberArray9 | Matrix3> ? 'mat3x3<f32>' : ValueT extends Readonly<NumberArray12> ? 'mat3x4<f32>' | 'mat4x3<f32>' : ValueT extends Readonly<NumberArray16 | Matrix4> ? 'mat4x4<f32>' : never;
+type UniformType<ValueT> = ValueT extends UniformValue ? UniformLeafType<ValueT> : ValueT extends ReadonlyArray<infer ElementT> ? readonly [UniformType<NonNullable<ElementT>>, number] : ValueT extends Record<string, unknown> ? {
+    [name in keyof ValueT]-?: UniformType<NonNullable<ValueT[name]>>;
+} : never;
+type UniformProps = Record<string, unknown>;
+export type UniformTypes<PropsT extends UniformProps> = {
+    [name in keyof PropsT]-?: UniformType<NonNullable<PropsT[name]>> & CompositeShaderType;
+};
+export {};
+//# sourceMappingURL=uniform-types.d.ts.map

package/dist/lib/utils/uniform-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniform-types.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/uniform-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACd,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAC,mBAAmB,EAAC,uBAAoB;AAOrD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAC/B,MAAM,GACN,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,aAAa,GACb,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,CACV,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC,YAAY,GACZ,yBAAyB,GACzB,wBAAwB,CAAC;AAE7B,MAAM,MAAM,yBAAyB,GAAG;IACtC,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,aAAa,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAAC;AAE3F,KAAK,eAAe,CAAC,MAAM,SAAS,YAAY,IAAI,MAAM,SAAS,MAAM,GAAG,OAAO,GAC/E,KAAK,GAAG,KAAK,GAAG,KAAK,GACrB,MAAM,SAAS,QAAQ,CAAC,YAAY,GAAG,OAAO,CAAC,GAC7C,WAAW,GAAG,WAAW,GAAG,WAAW,GACvC,MAAM,SAAS,QAAQ,CAAC,YAAY,GAAG,OAAO,CAAC,GAC7C,WAAW,GAAG,WAAW,GAAG,WAAW,GACvC,MAAM,SAAS,QAAQ,CAAC,YAAY,GAAG,OAAO,CAAC,GAC7C,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,GACvD,MAAM,SAAS,QAAQ,CAAC,YAAY,CAAC,GACnC,aAAa,GAAG,aAAa,GAC7B,MAAM,SAAS,QAAQ,CAAC,YAAY,CAAC,GACnC,aAAa,GAAG,aAAa,GAC7B,MAAM,SAAS,QAAQ,CAAC,YAAY,GAAG,OAAO,CAAC,GAC7C,aAAa,GACb,MAAM,SAAS,QAAQ,CAAC,aAAa,CAAC,GACpC,aAAa,GAAG,aAAa,GAC7B,MAAM,SAAS,QAAQ,CAAC,aAAa,GAAG,OAAO,CAAC,GAC9C,aAAa,GACb,KAAK,CAAC;AAE1B,KAAK,WAAW,CAAC,MAAM,IAAI,MAAM,SAAS,YAAY,GAClD,eAAe,CAAC,MAAM,CAAC,GACvB,MAAM,SAAS,aAAa,CAAC,MAAM,QAAQ,CAAC,GAC1C,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,GACrD,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC;KAAE,IAAI,IAAI,MAAM,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;CAAC,GAClE,KAAK,CAAC;AAEd,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5C,MAAM,MAAM,YAAY,CAAC,MAAM,SAAS,YAAY,IAAI;KACrD,IAAI,IAAI,MAAM,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,mBAAmB;CACvF,CAAC"}

package/dist/lib/utils/uniform-types.js

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

package/dist/lib/utils/uniform-types.js.map

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

package/dist/lib/wgsl-shader-assembler.cjs

@@ -0,0 +1,99 @@
+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 wgsl_shader_assembler_exports = {};
+__export(wgsl_shader_assembler_exports, {
+  WGSLShaderAssembler: () => WGSLShaderAssembler
+});
+module.exports = __toCommonJS(wgsl_shader_assembler_exports);
+var import_shader_assembler_base = require("./shader-assembler-base.cjs");
+var import_assemble_wgsl_shaders = require("./shader-assembly/assemble-wgsl-shaders.cjs");
+var import_wgsl_binding_debug = require("./shader-assembly/wgsl-binding-debug.cjs");
+var import_preprocessor = require("./preprocessor/preprocessor.cjs");
+var import_wgsl_interface_scan = require("./shader-assembly/wgsl-interface-scan.cjs");
+class WGSLShaderAssembler extends import_shader_assembler_base.ShaderAssembler {
+  shaderLanguage = "wgsl";
+  /** Stable per-run WGSL auto-binding assignments keyed by group/module/binding. */
+  _wgslBindingRegistry = /* @__PURE__ */ new Map();
+  /**
+   * Assemble a WGSL unified shader.
+   * @param props WGSL source, platform information, shader modules, defines, and injections.
+   * @returns Assembled WGSL source, resolved modules, uniforms, and binding debug metadata.
+   */
+  assembleWGSLShader(props) {
+    var _a, _b, _c;
+    const modules = this._getModuleList(props.modules);
+    const hookFunctions = this._hookFunctions;
+    const translated = this._transpileShader(props, modules, props.source, props.shaderStage ?? (props.computeEntryPoint ? "compute" : void 0));
+    const entryPoints = {
+      vertex: ((_a = translated.entryPoints) == null ? void 0 : _a.vertex) ?? props.vertexEntryPoint,
+      fragment: ((_b = translated.entryPoints) == null ? void 0 : _b.fragment) ?? props.fragmentEntryPoint,
+      compute: ((_c = translated.entryPoints) == null ? void 0 : _c.compute) ?? props.computeEntryPoint
+    };
+    const defines = WGSLShaderAssembler.getShaderPreprocessorDefines(props, modules);
+    const preprocessedApplicationSource = props.platformInfo.shaderLanguage === "wgsl" && translated.code ? (0, import_preprocessor.preprocess)(translated.code, { defines }) : translated.code;
+    const { source: assembledSource, getUniforms, bindingAssignments } = (0, import_assemble_wgsl_shaders.assembleWGSLSource)({
+      ...props,
+      source: preprocessedApplicationSource,
+      vertexEntryPoint: entryPoints.vertex,
+      fragmentEntryPoint: entryPoints.fragment,
+      defines,
+      _bindingRegistry: this._wgslBindingRegistry,
+      modules: translated.modules,
+      hookFunctions
+    });
+    const preprocessedSource = props.platformInfo.shaderLanguage === "wgsl" ? (0, import_preprocessor.preprocess)(assembledSource, { defines }) : assembledSource;
+    return {
+      source: preprocessedSource,
+      entryPoints,
+      getUniforms,
+      modules,
+      bindingAssignments,
+      bindingTable: (0, import_wgsl_binding_debug.getShaderBindingDebugRowsFromWGSL)(preprocessedSource, bindingAssignments),
+      shaderLayout: (0, import_wgsl_interface_scan.scanWGSLInterface)(preprocessedSource, {
+        vertexEntryPoint: entryPoints.vertex,
+        scanVertexAttributes: props.scanVertexAttributes
+      })
+    };
+  }
+  static getShaderPreprocessorDefines(props, modules) {
+    return {
+      ...WGSLShaderAssembler.getPlatformPreprocessorDefines(props.platformInfo),
+      ...modules.reduce((accumulator, module2) => {
+        Object.assign(accumulator, module2.defines);
+        return accumulator;
+      }, {}),
+      ...props.defines
+    };
+  }
+  static getPlatformPreprocessorDefines(platformInfo) {
+    const limits = platformInfo.limits || {};
+    return {
+      LUMA_SUPPORTS_VERTEX_STORAGE_BUFFERS: platformInfo.type === "webgpu" && (limits["maxStorageBuffersInVertexStage"] || 0) > 0,
+      // Native tan() does not provide enough precision on all WebGPU implementations.
+      LUMA_FP32_TAN_PRECISION_WORKAROUND: platformInfo.type === "webgpu" && platformInfo.gpu.toLowerCase() !== "nvidia" && platformInfo.gpu.toLowerCase() !== "amd",
+      // Metal may reassociate the floating-point transforms used by classic
+      // double-single arithmetic. The integer path makes each rounding point
+      // explicit while preserving the public vec2<f32> representation.
+      LUMA_FP64_INTEGER_ARITHMETIC: platformInfo.type === "webgpu" && platformInfo.gpu.toLowerCase() === "apple"
+    };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WGSLShaderAssembler
+});

package/dist/lib/wgsl-shader-assembler.d.ts

@@ -0,0 +1,34 @@
+import { ShaderAssembler } from "./shader-assembler-base.js";
+import type { ShaderModule } from "./shader-module/shader-module.js";
+import type { AssembleShaderProps, GetUniformsFunc } from "./shader-assembly/shader-assembly-types.js";
+import { type ShaderBindingDebugRow } from "./shader-assembly/wgsl-binding-debug.js";
+import type { ShaderLayout } from "../types.js";
+import type { ShaderTranspilerEntryPoints } from "./shader-transpiler/shader-transpiler.js";
+/** Stateful assembler for unified WGSL shaders. */
+export declare class WGSLShaderAssembler extends ShaderAssembler {
+    readonly shaderLanguage: 'wgsl';
+    /** Stable per-run WGSL auto-binding assignments keyed by group/module/binding. */
+    private readonly _wgslBindingRegistry;
+    /**
+     * Assemble a WGSL unified shader.
+     * @param props WGSL source, platform information, shader modules, defines, and injections.
+     * @returns Assembled WGSL source, resolved modules, uniforms, and binding debug metadata.
+     */
+    assembleWGSLShader(props: AssembleShaderProps): {
+        source: string;
+        getUniforms: GetUniformsFunc;
+        modules: ShaderModule[];
+        bindingAssignments: {
+            moduleName: string;
+            name: string;
+            group: number;
+            location: number;
+        }[];
+        bindingTable: ShaderBindingDebugRow[];
+        shaderLayout: ShaderLayout | null;
+        entryPoints: ShaderTranspilerEntryPoints;
+    };
+    private static getShaderPreprocessorDefines;
+    private static getPlatformPreprocessorDefines;
+}
+//# sourceMappingURL=wgsl-shader-assembler.d.ts.map

package/dist/lib/wgsl-shader-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgsl-shader-assembler.d.ts","sourceRoot":"","sources":["../../src/lib/wgsl-shader-assembler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,eAAe,EAAC,mCAAgC;AACxD,OAAO,KAAK,EAAC,YAAY,EAAC,yCAAsC;AAChE,OAAO,KAAK,EAAC,mBAAmB,EAAE,eAAe,EAAC,mDAAgD;AAElG,OAAO,EAEL,KAAK,qBAAqB,EAC3B,gDAA6C;AAG9C,OAAO,KAAK,EAAC,YAAY,EAAC,oBAAiB;AAC3C,OAAO,KAAK,EAAC,2BAA2B,EAAC,iDAA8C;AAEvF,mDAAmD;AACnD,qBAAa,mBAAoB,SAAQ,eAAe;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAU;IACzC,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAElE;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG;QAC9C,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,eAAe,CAAC;QAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;QACxB,kBAAkB,EAAE;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAC,EAAE,CAAC;QAC1F,YAAY,EAAE,qBAAqB,EAAE,CAAC;QACtC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;QAClC,WAAW,EAAE,2BAA2B,CAAC;KAC1C;IAoDD,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAc3C,OAAO,CAAC,MAAM,CAAC,8BAA8B;CAmB9C"}