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

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

@@ -0,0 +1,51 @@
+import type { ShaderModule } from "./shader-module/shader-module.js";
+import type { AssembleShaderProps } from "./shader-assembly/shader-assembly-types.js";
+import type { ShaderInjectionTarget } from "./shader-assembly/shader-injection-targets.js";
+import type { ShaderTranspiler, ShaderTranspileResult } from "./shader-transpiler/shader-transpiler.js";
+/**
+ * A stateful version of `assembleShaders` that can be used to assemble shaders.
+ * Supports setting of default modules and hooks.
+ */
+export declare abstract class ShaderAssembler {
+    /** Shader language accepted by this assembler. */
+    abstract readonly shaderLanguage: 'glsl' | 'wgsl';
+    /** Compilers registered by the application, isolated to this assembler. */
+    private readonly _shaderTranspilers;
+    /** Hook functions */
+    protected readonly _injectionTargets: ShaderInjectionTarget[];
+    /** Shader modules */
+    protected _defaultModules: ShaderModule[];
+    /** Register or replace the compiler for one input language. */
+    addShaderTranspiler(transpiler: ShaderTranspiler): void;
+    /** Remove the compiler for one input language. */
+    removeShaderTranspiler(sourceLanguage: string): void;
+    /** Translate application and reusable module source together before native assembly. */
+    protected _transpileShader(props: AssembleShaderProps, modules: ShaderModule[], source: string | null | undefined, stage?: 'vertex' | 'fragment' | 'compute'): ShaderTranspileResult & {
+        modules: ShaderModule[];
+    };
+    /**
+     * Add a default module that does not have to be provided with every assembly call.
+     * @param module Shader module to include in later assembly calls.
+     */
+    addDefaultModule(module: ShaderModule): void;
+    /**
+     * Remove a default module
+     * @param module Shader module to remove from later assembly calls.
+     */
+    removeDefaultModule(module: ShaderModule): void;
+    /**
+     * Register a shader injection target
+     * @param injectionTarget Shared stage and name with language-specific parameters, return type, and source.
+     */
+    addShaderInjectionTarget(injectionTarget: ShaderInjectionTarget): void;
+    /**
+     * Remove all registered shader injection targets, for example before re-registering targets for a new
+     * application configuration. Default modules are not affected.
+     */
+    resetShaderInjectionTargets(): void;
+    /**
+     * Dedupe and combine with default modules
+     */
+    _getModuleList(appModules?: ShaderModule[]): ShaderModule[];
+}
+//# sourceMappingURL=shader-assembler-base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shader-assembler-base.d.ts","sourceRoot":"","sources":["../../src/lib/shader-assembler-base.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,YAAY,EAAC,yCAAsC;AAEhE,OAAO,KAAK,EAAC,mBAAmB,EAAC,mDAAgD;AACjF,OAAO,KAAK,EAAC,qBAAqB,EAAC,sDAAmD;AAEtF,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EAEtB,iDAA8C;AAG/C;;;GAGG;AACH,8BAAsB,eAAe;IACnC,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAClD,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuC;IAC1E,qBAAqB;IACrB,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,CAAM;IACnE,qBAAqB;IACrB,SAAS,CAAC,eAAe,EAAE,YAAY,EAAE,CAAM;IAE/C,+DAA+D;IAC/D,mBAAmB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAIvD,kDAAkD;IAClD,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAIpD,wFAAwF;IACxF,SAAS,CAAC,gBAAgB,CACxB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,KAAK,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GACxC,qBAAqB,GAAG;QAAC,OAAO,EAAE,YAAY,EAAE,CAAA;KAAC;IAsDpD;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAU5C;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAK/C;;;OAGG;IACH,wBAAwB,CAAC,eAAe,EAAE,qBAAqB,GAAG,IAAI;IAItE;;;OAGG;IACH,2BAA2B,IAAI,IAAI;IAInC;;OAEG;IACH,cAAc,CAAC,UAAU,GAAE,YAAY,EAAO,GAAG,YAAY,EAAE;CA0BhE"}

package/dist/lib/shader-assembler-base.js

@@ -0,0 +1,127 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { initializeShaderModules } from "./shader-module/shader-module.js";
+import { assert } from "./utils/assert.js";
+import { getShaderModuleDependencies } from "./shader-module/shader-module-dependencies.js";
+/**
+ * A stateful version of `assembleShaders` that can be used to assemble shaders.
+ * Supports setting of default modules and hooks.
+ */
+export class ShaderAssembler {
+    /** Compilers registered by the application, isolated to this assembler. */
+    _shaderTranspilers = new Map();
+    /** Hook functions */
+    _injectionTargets = [];
+    /** Shader modules */
+    _defaultModules = [];
+    /** Register or replace the compiler for one input language. */
+    addShaderTranspiler(transpiler) {
+        this._shaderTranspilers.set(transpiler.sourceLanguage, transpiler);
+    }
+    /** Remove the compiler for one input language. */
+    removeShaderTranspiler(sourceLanguage) {
+        this._shaderTranspilers.delete(sourceLanguage);
+    }
+    /** Translate application and reusable module source together before native assembly. */
+    _transpileShader(props, modules, source, stage) {
+        const sourceLanguage = props.sourceLanguage || this.shaderLanguage;
+        if (sourceLanguage === this.shaderLanguage) {
+            // Foreign module code requires an application translation unit in the same language.
+            assert(!getShaderModuleDependencies(modules).some(module => module.sourceLanguage && module.sourceLanguage !== this.shaderLanguage));
+            return { code: source || '', modules };
+        }
+        const transpiler = this._shaderTranspilers.get(sourceLanguage);
+        // The application must register a transpiler before assembling a foreign input language.
+        assert(transpiler);
+        const dependencies = getShaderModuleDependencies(modules);
+        // A translation unit can contain only one foreign source language.
+        assert(!dependencies.some(module => module.sourceLanguage &&
+            module.sourceLanguage !== sourceLanguage &&
+            module.sourceLanguage !== this.shaderLanguage));
+        const moduleSource = dependencies
+            .filter(module => module.sourceLanguage === sourceLanguage)
+            .map(module => module.source || '')
+            .join('\n');
+        const entryPoints = {
+            vertex: props.vertexEntryPoint,
+            fragment: props.fragmentEntryPoint,
+            compute: props.computeEntryPoint
+        };
+        const result = source === undefined || source === null
+            ? { code: '' }
+            : transpiler.transpile({
+                source: [moduleSource, source].filter(Boolean).join('\n'),
+                target: this.shaderLanguage,
+                stage,
+                entryPoints,
+                platformInfo: props.platformInfo
+            });
+        // Preserve uniform metadata and target-language code without emitting foreign source twice.
+        const nativeModules = dependencies.map(module => ({
+            ...module,
+            dependencies: undefined,
+            ...(module.sourceLanguage === sourceLanguage
+                ? { source: undefined, vs: undefined, fs: undefined }
+                : {})
+        }));
+        return { ...result, modules: nativeModules };
+    }
+    /**
+     * Add a default module that does not have to be provided with every assembly call.
+     * @param module Shader module to include in later assembly calls.
+     */
+    addDefaultModule(module) {
+        if (!this._defaultModules.find(m => m.name === (typeof module === 'string' ? module : module.name))) {
+            this._defaultModules.push(module);
+        }
+    }
+    /**
+     * Remove a default module
+     * @param module Shader module to remove from later assembly calls.
+     */
+    removeDefaultModule(module) {
+        const moduleName = typeof module === 'string' ? module : module.name;
+        this._defaultModules = this._defaultModules.filter(m => m.name !== moduleName);
+    }
+    /**
+     * Register a shader injection target
+     * @param injectionTarget Shared stage and name with language-specific parameters, return type, and source.
+     */
+    addShaderInjectionTarget(injectionTarget) {
+        this._injectionTargets.push(injectionTarget);
+    }
+    /**
+     * Remove all registered shader injection targets, for example before re-registering targets for a new
+     * application configuration. Default modules are not affected.
+     */
+    resetShaderInjectionTargets() {
+        this._injectionTargets.length = 0;
+    }
+    /**
+     * Dedupe and combine with default modules
+     */
+    _getModuleList(appModules = []) {
+        const modules = new Array(this._defaultModules.length + appModules.length);
+        const seen = {};
+        let count = 0;
+        for (let i = 0, len = this._defaultModules.length; i < len; ++i) {
+            const module = this._defaultModules[i];
+            const name = module.name;
+            modules[count++] = module;
+            seen[name] = true;
+        }
+        for (let i = 0, len = appModules.length; i < len; ++i) {
+            const module = appModules[i];
+            const name = module.name;
+            if (!seen[name]) {
+                modules[count++] = module;
+                seen[name] = true;
+            }
+        }
+        modules.length = count;
+        initializeShaderModules(modules);
+        return modules;
+    }
+}
+//# sourceMappingURL=shader-assembler-base.js.map

package/dist/lib/shader-assembler-base.js.map

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

package/dist/lib/shader-assembler.cjs

@@ -0,0 +1,33 @@
+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_assembler_exports = {};
+__export(shader_assembler_exports, {
+  GLSLShaderAssembler: () => import_glsl_shader_assembler.GLSLShaderAssembler,
+  ShaderAssembler: () => import_shader_assembler_base.ShaderAssembler,
+  WGSLShaderAssembler: () => import_wgsl_shader_assembler.WGSLShaderAssembler
+});
+module.exports = __toCommonJS(shader_assembler_exports);
+var import_shader_assembler_base = require("./shader-assembler-base.cjs");
+var import_glsl_shader_assembler = require("./glsl-shader-assembler.cjs");
+var import_wgsl_shader_assembler = require("./wgsl-shader-assembler.cjs");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GLSLShaderAssembler,
+  ShaderAssembler,
+  WGSLShaderAssembler
+});

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

@@ -0,0 +1,4 @@
+export { ShaderAssembler } from "./shader-assembler-base.js";
+export { GLSLShaderAssembler } from "./glsl-shader-assembler.js";
+export { WGSLShaderAssembler } from "./wgsl-shader-assembler.js";
+//# sourceMappingURL=shader-assembler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shader-assembler.d.ts","sourceRoot":"","sources":["../../src/lib/shader-assembler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,eAAe,EAAC,mCAAgC;AACxD,OAAO,EAAC,mBAAmB,EAAC,mCAAgC;AAC5D,OAAO,EAAC,mBAAmB,EAAC,mCAAgC"}

package/dist/lib/shader-assembler.js

@@ -0,0 +1,7 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+export { ShaderAssembler } from "./shader-assembler-base.js";
+export { GLSLShaderAssembler } from "./glsl-shader-assembler.js";
+export { WGSLShaderAssembler } from "./wgsl-shader-assembler.js";
+//# sourceMappingURL=shader-assembler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shader-assembler.js","sourceRoot":"","sources":["../../src/lib/shader-assembler.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,OAAO,EAAC,eAAe,EAAC,mCAAgC;AACxD,OAAO,EAAC,mBAAmB,EAAC,mCAAgC;AAC5D,OAAO,EAAC,mBAAmB,EAAC,mCAAgC"}

package/dist/lib/shader-assembly/assemble-glsl-shaders.cjs

@@ -0,0 +1,181 @@
+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 assemble_glsl_shaders_exports = {};
+__export(assemble_glsl_shaders_exports, {
+  FRAGMENT_SHADER_PROLOGUE: () => FRAGMENT_SHADER_PROLOGUE,
+  assembleGLSLShaderPair: () => assembleGLSLShaderPair,
+  assembleShaderGLSL: () => assembleShaderGLSL,
+  getApplicationDefines: () => getApplicationDefines
+});
+module.exports = __toCommonJS(assemble_glsl_shaders_exports);
+var import_shader_module_dependencies = require("../shader-module/shader-module-dependencies.cjs");
+var import_shader_assembly_shared = require("./shader-assembly-shared.cjs");
+var import_shader_module = require("../shader-module/shader-module.cjs");
+var import_shader_injection_targets = require("./shader-injection-targets.cjs");
+var import_shader_injections = require("./shader-injections.cjs");
+var import_assert = require("../utils/assert.cjs");
+var import_get_shader_info = require("../glsl-utils/get-shader-info.cjs");
+var import_platform_defines = require("./platform-defines.cjs");
+var import_shader_plugin_vertex_inputs = require("./shader-plugin-vertex-inputs.cjs");
+var import_shader_plugin_varyings = require("./shader-plugin-varyings.cjs");
+var import_transpile_glsl_shader = require("../shader-transpiler/transpile-glsl-shader.cjs");
+var import_shader_module_uniform_layout = require("../shader-module/shader-module-uniform-layout.cjs");
+const FRAGMENT_SHADER_PROLOGUE = (
+  /* glsl */
+  `precision highp float;
+`
+);
+function assembleGLSLShaderPair(options) {
+  const { vs, fs } = options;
+  const modules = (0, import_shader_module_dependencies.getShaderModuleDependencies)(options.modules || []);
+  return {
+    vs: assembleShaderGLSL(options.platformInfo, {
+      ...options,
+      source: vs,
+      stage: "vertex",
+      modules
+    }),
+    fs: assembleShaderGLSL(options.platformInfo, {
+      ...options,
+      // @ts-expect-error
+      source: fs,
+      stage: "fragment",
+      modules
+    }),
+    getUniforms: (0, import_shader_assembly_shared.assembleGetUniforms)(modules)
+  };
+}
+function assembleShaderGLSL(platformInfo, options) {
+  const { source, stage, language = "glsl", modules, defines = {}, injectionTargets = [], inject = {}, pluginInjections = {}, pluginVertexInputs = {}, pluginInterStageVariables = {}, prologue = true, log } = options;
+  (0, import_assert.assert)(typeof source === "string", "shader source must be a string");
+  const sourceVersion = language === "glsl" ? (0, import_get_shader_info.getShaderInfo)(source).version : -1;
+  const targetVersion = platformInfo.shaderLanguageVersion;
+  const sourceVersionDirective = sourceVersion === 100 ? "#version 100" : "#version 300 es";
+  const sourceLines = source.split("\n");
+  const coreSource = sourceLines.slice(1).join("\n");
+  const allDefines = {};
+  modules.forEach((module2) => {
+    Object.assign(allDefines, module2.defines);
+  });
+  Object.assign(allDefines, defines);
+  let assembledSource = "";
+  switch (language) {
+    case "wgsl":
+      break;
+    case "glsl":
+      assembledSource = prologue ? `${sourceVersionDirective}
+
+// ----- PROLOGUE -------------------------
+${`#define SHADER_TYPE_${stage.toUpperCase()}`}
+
+${(0, import_platform_defines.getPlatformShaderDefines)(platformInfo)}
+${stage === "fragment" ? FRAGMENT_SHADER_PROLOGUE : ""}
+
+// ----- APPLICATION DEFINES -------------------------
+
+${getApplicationDefines(allDefines)}
+
+` : `${sourceVersionDirective}
+`;
+      break;
+  }
+  const injectionTargetMap = (0, import_shader_injection_targets.normalizeShaderInjectionTargets)(injectionTargets, options.pluginInjectionTargets, "glsl");
+  const targetInjections = {};
+  const declInjections = {};
+  const mainInjections = {};
+  (0, import_shader_assembly_shared.appendInjections)(pluginInjections, targetInjections, declInjections, mainInjections);
+  const applicationInjections = Array.isArray(inject) ? (0, import_shader_injections.resolveShaderInjections)(inject, "glsl") : {};
+  (0, import_shader_assembly_shared.appendInjections)(applicationInjections, targetInjections, declInjections, mainInjections);
+  const injectionMap = Array.isArray(inject) ? {} : inject;
+  for (const key in injectionMap) {
+    const injection = typeof injectionMap[key] === "string" ? { injection: injectionMap[key], order: 0 } : injectionMap[key];
+    const match = /^(v|f)s:(#)?([\w-]+)$/.exec(key);
+    if (match) {
+      const hash = match[2];
+      const name = match[3];
+      if (hash) {
+        if (name === "decl") {
+          declInjections[key] = [...declInjections[key] || [], injection];
+        } else {
+          mainInjections[key] = [...mainInjections[key] || [], injection];
+        }
+      } else {
+        targetInjections[key] = [...targetInjections[key] || [], injection];
+      }
+    } else {
+      mainInjections[key] = [...mainInjections[key] || [], injection];
+    }
+  }
+  if (stage === "vertex") {
+    const declarations = (0, import_shader_plugin_vertex_inputs.getShaderPluginVertexInputDeclarationsGLSL)(coreSource, pluginVertexInputs);
+    if (declarations)
+      assembledSource += `${declarations}
+`;
+  }
+  const pluginVaryingAssembly = (0, import_shader_plugin_varyings.assembleShaderPluginInterStageVariablesGLSL)(coreSource, stage, pluginInterStageVariables);
+  if (pluginVaryingAssembly.declarations) {
+    assembledSource += `${pluginVaryingAssembly.declarations}
+`;
+  }
+  if (pluginVaryingAssembly.initialization) {
+    mainInjections["vs:#main-start"] = mainInjections["vs:#main-start"] || [];
+    mainInjections["vs:#main-start"].push({
+      injection: pluginVaryingAssembly.initialization,
+      order: Number.MIN_SAFE_INTEGER
+    });
+  }
+  for (const module2 of modules) {
+    if (log) {
+      (0, import_shader_module.checkShaderModuleDeprecations)(module2, coreSource, log);
+    }
+    const moduleSource = (0, import_shader_assembly_shared.getShaderModuleSource)(module2, stage, log);
+    assembledSource += moduleSource;
+  }
+  (0, import_shader_injection_targets.validateShaderInjectionTargetInjections)(injectionTargetMap, targetInjections, stage);
+  assembledSource += "// ----- MAIN SHADER SOURCE -------------------------";
+  assembledSource += import_shader_assembly_shared.INJECT_SHADER_DECLARATIONS;
+  assembledSource = (0, import_shader_injections.injectShader)(assembledSource, stage, declInjections);
+  assembledSource += (0, import_shader_injection_targets.getShaderInjectionTargets)(injectionTargetMap[stage], targetInjections);
+  assembledSource += coreSource;
+  assembledSource = (0, import_shader_injections.injectShader)(assembledSource, stage, mainInjections);
+  if (language === "glsl" && sourceVersion !== targetVersion) {
+    assembledSource = (0, import_transpile_glsl_shader.transpileGLSLShader)(assembledSource, stage);
+  }
+  if (language === "glsl") {
+    (0, import_shader_module_uniform_layout.warnIfGLSLUniformBlocksAreNotStd140)(assembledSource, stage, log);
+  }
+  return assembledSource.trim();
+}
+function getApplicationDefines(defines = {}) {
+  let sourceText = "";
+  for (const define in defines) {
+    const value = defines[define];
+    if (value || Number.isFinite(value)) {
+      sourceText += `#define ${define.toUpperCase()} ${defines[define]}
+`;
+    }
+  }
+  return sourceText;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FRAGMENT_SHADER_PROLOGUE,
+  assembleGLSLShaderPair,
+  assembleShaderGLSL,
+  getApplicationDefines
+});

package/dist/lib/shader-assembly/assemble-glsl-shaders.d.ts

@@ -0,0 +1,70 @@
+import { type AssembleShaderOptions, type GetUniformsFunc, type ShaderAssemblyLog } from "./shader-assembly-types.js";
+import { PlatformInfo } from "./platform-info.js";
+import { type ShaderModule } from "../shader-module/shader-module.js";
+import { type ShaderInjectionTarget } from "./shader-injection-targets.js";
+import { type ShaderInjection, type ResolvedShaderInjection } from "./shader-injections.js";
+import { type AttributeShaderType } from "../../types.js";
+import { type ResolvedShaderPluginInterStageVariable } from "../shader-plugin.js";
+/**
+ * Precision prologue to inject before functions are injected in shader
+ * TODO - extract any existing prologue in the fragment source and move it up...
+ */
+export declare const FRAGMENT_SHADER_PROLOGUE = "precision highp float;\n";
+/**
+ * Injects dependent shader module sources into pair of main vertex/fragment shader sources for GLSL
+ */
+export declare function assembleGLSLShaderPair(options: AssembleShaderOptions & {
+    /** Vertex shader */
+    vs: string;
+    /** Fragment shader */
+    fs?: string;
+}): {
+    vs: string;
+    fs: string;
+    getUniforms: GetUniformsFunc;
+};
+/**
+ * Pulls together complete source code for either a vertex or a fragment shader
+ * adding prologues, requested module chunks, and any final injections.
+ * @param gl
+ * @param options
+ * @returns
+ */
+export declare function assembleShaderGLSL(platformInfo: PlatformInfo, options: {
+    id?: string;
+    source: string;
+    language?: 'glsl' | 'wgsl';
+    stage: 'vertex' | 'fragment';
+    modules: ShaderModule[];
+    defines?: Record<string, boolean | number>;
+    injectionTargets?: readonly ShaderInjectionTarget[];
+    pluginInjectionTargets?: readonly ShaderInjectionTarget[];
+    inject?: readonly ShaderInjection[] | Record<string, string | ResolvedShaderInjection>;
+    pluginInjections?: Record<string, ResolvedShaderInjection[]>;
+    pluginVertexInputs?: Record<string, AttributeShaderType>;
+    pluginInterStageVariables?: Record<string, ResolvedShaderPluginInterStageVariable>;
+    prologue?: boolean;
+    log?: ShaderAssemblyLog;
+}): string;
+/**
+ * NOTE: Removed as id injection defeated caching of shaders
+ *
+ * Generate "glslify-compatible" SHADER_NAME defines
+ * These are understood by the GLSL error parsing function
+ * If id is provided and no SHADER_NAME constant is present in source, create one
+ unction getShaderNameDefine(options: {
+  id?: string;
+  source: string;
+  stage: 'vertex' | 'fragment';
+}): string {
+  const {id, source, stage} = options;
+  const injectShaderName = id && source.indexOf('SHADER_NAME') === -1;
+  return injectShaderName
+    ? `
+#define SHADER_NAME ${id}_${stage}`
+    : '';
+}
+*/
+/** Generates application defines from an object of key value pairs */
+export declare function getApplicationDefines(defines?: Record<string, boolean | number>): string;
+//# sourceMappingURL=assemble-glsl-shaders.d.ts.map

package/dist/lib/shader-assembly/assemble-glsl-shaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble-glsl-shaders.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-assembly/assemble-glsl-shaders.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,mCAAgC;AAOjC,OAAO,EAAC,YAAY,EAAC,2BAAwB;AAC7C,OAAO,EAAC,KAAK,YAAY,EAAgC,0CAAuC;AAChG,OAAO,EACL,KAAK,qBAAqB,EAI3B,sCAAmC;AACpC,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAG7B,+BAA4B;AAC7B,OAAO,EAAC,KAAK,mBAAmB,EAAC,uBAAoB;AACrD,OAAO,EAAC,KAAK,sCAAsC,EAAC,4BAAyB;AAS7E;;;GAGG;AACH,eAAO,MAAM,wBAAwB,6BAEpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,qBAAqB,GAAG;IAC/B,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GACA;IACD,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,eAAe,CAAC;CAC9B,CAoBA;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE;IACP,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,sBAAsB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1D,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAAC,CAAC;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACzD,yBAAyB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sCAAsC,CAAC,CAAC;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB,UAoKF;AAED;;;;;;;;;;;;;;;;;;EAkBE;AAEF,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAM,GAAG,MAAM,CAS5F"}