@ignifx/core 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/dist/{environment-mr5wp69e.js → environment-BCjfp1jB.js} +2 -2
  2. package/dist/{environment-mr5wp69e.js.map → environment-BCjfp1jB.js.map} +1 -1
  3. package/dist/{ignifx-error-CRh89KUJ.js → ignifx-error-RpK-lWwE.js} +13 -2
  4. package/dist/ignifx-error-RpK-lWwE.js.map +1 -0
  5. package/dist/index.d.ts +1758 -807
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +2695 -467
  8. package/dist/index.js.map +1 -1
  9. package/dist/{instanced-mesh-instance-gguMoIeZ.js → instanced-mesh-instance-DYwH0vLi.js} +2 -2
  10. package/dist/{instanced-mesh-instance-gguMoIeZ.js.map → instanced-mesh-instance-DYwH0vLi.js.map} +1 -1
  11. package/dist/{material-plugin-Cfw_h_Mg.js → material-plugin-CWtV7DkH.js} +3 -3
  12. package/dist/material-plugin-CWtV7DkH.js.map +1 -0
  13. package/dist/overlay-CjVgsfrm.js +239 -0
  14. package/dist/overlay-CjVgsfrm.js.map +1 -0
  15. package/dist/{post-effect-compiler-Rce26Eue.js → post-effect-compiler-pOvXae-i.js} +2 -2
  16. package/dist/{post-effect-compiler-Rce26Eue.js.map → post-effect-compiler-pOvXae-i.js.map} +1 -1
  17. package/dist/{shader-material-U6BKZ8D1.js → shader-material-B6wwFCKB.js} +2 -2
  18. package/dist/{shader-material-U6BKZ8D1.js.map → shader-material-B6wwFCKB.js.map} +1 -1
  19. package/dist/{shader-material-BIG3UDyu.js → shader-material-C4VjLTfV.js} +3 -3
  20. package/dist/{shader-material-BIG3UDyu.js.map → shader-material-C4VjLTfV.js.map} +1 -1
  21. package/dist/{shader-pragma-tw6AKaQD.js → shader-pragma-qO9_6sTd.js} +2 -2
  22. package/dist/{shader-pragma-tw6AKaQD.js.map → shader-pragma-qO9_6sTd.js.map} +1 -1
  23. package/dist/{surface-shader-DAWIDdaa.js → surface-shader-BaR7Kg-F.js} +4 -4
  24. package/dist/{surface-shader-DAWIDdaa.js.map → surface-shader-BaR7Kg-F.js.map} +1 -1
  25. package/dist/{vec3-B31o_KF_.js → vec3-T2PasQZv.js} +2 -2
  26. package/dist/{vec3-B31o_KF_.js.map → vec3-T2PasQZv.js.map} +1 -1
  27. package/package.json +2 -2
  28. package/dist/ignifx-error-CRh89KUJ.js.map +0 -1
  29. package/dist/material-plugin-Cfw_h_Mg.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"shader-pragma-tw6AKaQD.js","names":[],"sources":["../src/render/shader-pragma.ts"],"sourcesContent":["import { CoreErrorCode } from \"../errors/error-codes.js\";\nimport { IgnifxError } from \"../errors/ignifx-error.js\";\nimport {\n IGNIFX_UNIFORM_NAMES,\n LITE_SYSTEM_UNIFORM_NAMES,\n SHADER_ATTRIBUTE_NAMES,\n SHADER_BLEND_MODES,\n SHADER_CULL_MODES,\n SHADER_INSTANCING_MODES,\n SHADER_TEXTURE_FALLBACKS,\n SHADER_UNIFORM_TYPES,\n} from \"./shader-declaration.js\";\nimport type {\n IgnifxUniformName,\n LiteSystemUniformName,\n ShaderAttributeName,\n ShaderBlendMode,\n ShaderCullMode,\n ShaderDeclaration,\n ShaderDefineDeclaration,\n ShaderInstancingMode,\n ShaderKind,\n ShaderStorageDeclaration,\n ShaderTextureDeclaration,\n ShaderTextureFallback,\n ShaderUniformDeclaration,\n ShaderUniformType,\n} from \"./shader-declaration.js\";\n\n/**\n * Reads the `// @ignifx …` comment pragmas of a `.wgsl` file into a {@link ShaderDeclaration}\n * (grammar: `docs/plan/2026-09-terrain-particles-shaders.md` §3.1; rationale: ADR-0024).\n *\n * Pure string work with no Babylon Lite import, so the build-time validator and the runtime loader\n * can share it. Four rules the grammar itself does not show:\n *\n * - `@ignifx system` mixes Lite's names with ignifx's, and the WGSL reads them from different\n * structs, so they are split into `declaration.system` and `declaration.ignifx`.\n * - An omitted `attributes` directive means `position`; Lite refuses a shader material without it\n * (`lib/material/shader/shader-material.js`, error 293).\n * - A `color(…)` default keeps the authored sRGB numbers; `./shader-material.ts` converts.\n * - `cull front` and `transmissive` on an opaque surface are refused here, with a line number,\n * because Lite has no front-face culling and throws on the second combination (error 295).\n */\n\n/** Matches an `// @ignifx …` line and captures the directive text after it. */\nconst PRAGMA_LINE = /^\\s*\\/\\/\\s*@ignifx\\b(.*)$/;\n\n/** Matches a WGSL identifier. */\nconst IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** Splits `name: type` at the colon, capturing the identifier and the rest of the line. */\nconst NAME_AND_TYPE = /^([A-Za-z_][A-Za-z0-9_]*)\\s*:\\s*(.*)$/;\n\n/** Matches a leading `tooltip(\"…\")` modifier, capturing the quoted text. */\nconst TOOLTIP_MODIFIER = /^tooltip\\(\\s*\"((?:[^\"\\\\]|\\\\.)*)\"\\s*\\)\\s*/;\n\n/** Matches a leading `range(…)`, `step(…)`, or `color(…)`/`color` modifier. */\nconst CALL_MODIFIER = /^(range|step|color)\\s*(?:\\(([^)]*)\\))?\\s*/;\n\n/** Matches a leading `color(…)` default value, capturing the arguments. */\nconst COLOR_DEFAULT = /^color\\s*\\(([^)]*)\\)\\s*/;\n\n/** Matches a leading parenthesised numeric list, capturing the arguments. */\nconst TUPLE_DEFAULT = /^\\(([^)]*)\\)\\s*/;\n\n/** Matches a leading decimal number, with optional sign and exponent. */\nconst NUMBER_DEFAULT = /^([+-]?(?:\\d+\\.?\\d*|\\.\\d+)(?:[eE][+-]?\\d+)?)\\s*/;\n\n/** How many elements each uniform type holds. */\nconst ELEMENT_COUNTS: Readonly<Record<ShaderUniformType, number>> = Object.freeze({\n f32: 1,\n u32: 1,\n i32: 1,\n \"vec2<f32>\": 2,\n \"vec3<f32>\": 3,\n \"vec4<f32>\": 4,\n \"mat4x4<f32>\": 16,\n});\n\n/** The identity matrix a `mat4x4<f32>` uniform starts at when the file declares no default. */\nconst IDENTITY_MATRIX: readonly number[] = Object.freeze([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);\n\n/** The mutable declaration the parser fills in, line by line. */\ninterface DeclarationDraft {\n kind: ShaderKind | null;\n attributes: ShaderAttributeName[] | null;\n readonly system: LiteSystemUniformName[];\n readonly ignifx: IgnifxUniformName[];\n readonly uniforms: ShaderUniformDeclaration[];\n readonly textures: ShaderTextureDeclaration[];\n readonly storage: ShaderStorageDeclaration[];\n readonly defines: ShaderDefineDeclaration[];\n readonly names: Set<string>;\n blend: ShaderBlendMode | null;\n cull: ShaderCullMode | null;\n depthWrite: boolean | null;\n depthTest: boolean | null;\n transmissive: boolean;\n instancing: ShaderInstancingMode | null;\n displace: number | null;\n}\n\n/**\n * Reads a `.wgsl` file's `// @ignifx` pragmas into the declaration the loader, the material\n * builder, and the inspector all read.\n *\n * @param source - The whole file, as text.\n * @param address - The asset address, so a failure names the file.\n * @returns The declaration, with every default filled in.\n * @throws IgnifxError with code `IGX-0719`, carrying the offending `line`, for an unknown directive,\n * a malformed one, a duplicate binding name, an attribute or uniform type Babylon Lite does not\n * have, or a combination it cannot express.\n *\n * @example\n * ```ts\n * const declaration = parseShaderDeclaration(\"// @ignifx shader\\n\", \"shaders/flat.wgsl\");\n * declaration.attributes; // [\"position\"]\n * ```\n *\n * @public\n */\nexport function parseShaderDeclaration(source: string, address: string): ShaderDeclaration {\n const draft: DeclarationDraft = {\n kind: null,\n attributes: null,\n system: [],\n ignifx: [],\n uniforms: [],\n textures: [],\n storage: [],\n defines: [],\n names: new Set<string>(),\n blend: null,\n cull: null,\n depthWrite: null,\n depthTest: null,\n transmissive: false,\n instancing: null,\n displace: null,\n };\n const lines = source.split(\"\\n\");\n for (let index = 0; index < lines.length; index += 1) {\n const matched = PRAGMA_LINE.exec(lines[index] ?? \"\");\n if (matched === null) {\n continue;\n }\n readDirective(draft, (matched[1] ?? \"\").trim(), address, index + 1);\n }\n return finish(draft, address);\n}\n\n/**\n * Applies one `// @ignifx …` line to the draft.\n *\n * @param draft - The declaration being built.\n * @param text - The directive text, already trimmed.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readDirective(draft: DeclarationDraft, text: string, address: string, line: number): void {\n if (text.length === 0) {\n throw pragmaError(address, line, \"an @ignifx comment declares no directive\");\n }\n const separator = text.search(/\\s/);\n const directive = separator < 0 ? text : text.slice(0, separator);\n const rest = separator < 0 ? \"\" : text.slice(separator + 1).trim();\n switch (directive) {\n case \"shader\":\n case \"surface\":\n case \"post\":\n readKind(draft, directive, rest, address, line);\n return;\n case \"attributes\":\n readAttributes(draft, rest, address, line);\n return;\n case \"system\":\n readSystem(draft, rest, address, line);\n return;\n case \"uniform\":\n draft.uniforms.push(readUniform(draft, rest, address, line));\n return;\n case \"texture\":\n draft.textures.push(readTexture(draft, rest, address, line));\n return;\n case \"storage\":\n draft.storage.push(readStorage(draft, rest, address, line));\n return;\n case \"define\":\n draft.defines.push(readDefine(draft, rest, address, line));\n return;\n case \"blend\":\n case \"cull\":\n case \"depthWrite\":\n case \"depthTest\":\n case \"transmissive\":\n case \"instancing\":\n readPipeline(draft, text, address, line);\n return;\n case \"displace\":\n readDisplace(draft, rest, address, line);\n return;\n default:\n throw pragmaError(address, line, `${JSON.stringify(directive)} is not an @ignifx directive`);\n }\n}\n\n/**\n * Records the file's form, refusing a second one.\n *\n * @param draft - The declaration being built.\n * @param kind - The declared form.\n * @param rest - Whatever followed it, which must be nothing.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readKind(draft: DeclarationDraft, kind: ShaderKind, rest: string, address: string, line: number): void {\n if (rest.length > 0) {\n throw pragmaError(address, line, `@ignifx ${kind} takes no arguments, but found ${JSON.stringify(rest)}`);\n }\n if (draft.kind !== null) {\n throw pragmaError(address, line, `the file already declared @ignifx ${draft.kind}`);\n }\n draft.kind = kind;\n}\n\n/**\n * Records the vertex attributes the vertex stage reads.\n *\n * @param draft - The declaration being built.\n * @param rest - The comma-separated attribute names.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readAttributes(draft: DeclarationDraft, rest: string, address: string, line: number): void {\n if (draft.attributes !== null) {\n throw pragmaError(address, line, \"the file already declared @ignifx attributes\");\n }\n const names = splitList(rest, address, line, \"attributes\");\n const attributes: ShaderAttributeName[] = [];\n for (const name of names) {\n const attribute = matchLiteral(SHADER_ATTRIBUTE_NAMES, name);\n if (attribute === null) {\n throw pragmaError(\n address,\n line,\n `${JSON.stringify(name)} is not a vertex attribute; Babylon Lite has ${SHADER_ATTRIBUTE_NAMES.join(\", \")}`,\n );\n }\n if (attributes.includes(attribute)) {\n throw pragmaError(address, line, `the attribute ${attribute} is declared twice`);\n }\n attributes.push(attribute);\n }\n draft.attributes = attributes;\n}\n\n/**\n * Records the system uniforms, splitting Babylon Lite's names from ignifx's own.\n *\n * @param draft - The declaration being built.\n * @param rest - The comma-separated uniform names.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readSystem(draft: DeclarationDraft, rest: string, address: string, line: number): void {\n const names = splitList(rest, address, line, \"system\");\n for (const name of names) {\n const lite = matchLiteral(LITE_SYSTEM_UNIFORM_NAMES, name);\n if (lite !== null) {\n claimName(draft, lite, address, line, \"system uniform\");\n draft.system.push(lite);\n continue;\n }\n const ignifx = matchLiteral(IGNIFX_UNIFORM_NAMES, name);\n if (ignifx !== null) {\n claimName(draft, ignifx, address, line, \"system uniform\");\n draft.ignifx.push(ignifx);\n continue;\n }\n throw pragmaError(\n address,\n line,\n `${JSON.stringify(name)} is not a system uniform; Babylon Lite has ${LITE_SYSTEM_UNIFORM_NAMES.join(\", \")} and ignifx adds ${IGNIFX_UNIFORM_NAMES.join(\", \")}`,\n );\n }\n}\n\n/**\n * Reads one `// @ignifx uniform name: type [= default] [modifiers]` line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readUniform(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderUniformDeclaration {\n const split = NAME_AND_TYPE.exec(rest);\n if (split === null) {\n throw pragmaError(address, line, `@ignifx uniform expects \"name: type\", but found ${JSON.stringify(rest)}`);\n }\n const name = split[1] ?? \"\";\n let tail = (split[2] ?? \"\").trim();\n const typeSeparator = tail.search(/[\\s=]/);\n const typeName = typeSeparator < 0 ? tail : tail.slice(0, typeSeparator);\n tail = (typeSeparator < 0 ? \"\" : tail.slice(typeName.length)).trim();\n const type = matchLiteral(SHADER_UNIFORM_TYPES, typeName);\n if (type === null) {\n throw pragmaError(\n address,\n line,\n `${JSON.stringify(typeName)} is not a uniform type; Babylon Lite has ${SHADER_UNIFORM_TYPES.join(\", \")}`,\n );\n }\n claimName(draft, name, address, line, \"uniform\");\n let defaultValue: number | readonly number[] | null = null;\n let isColor = false;\n if (tail.startsWith(\"=\")) {\n tail = tail.slice(1).trim();\n const parsed = readDefaultValue(tail, type, name, address, line);\n defaultValue = parsed.value;\n isColor = parsed.color;\n tail = parsed.tail;\n }\n const modifiers = readModifiers(tail, name, type, address, line);\n return {\n name,\n type,\n defaultValue: defaultValue ?? implicitDefault(type),\n color: isColor || modifiers.color,\n range: modifiers.range,\n step: modifiers.step,\n tooltip: modifiers.tooltip,\n };\n}\n\n/** A parsed `= …` default value and whatever followed it. */\ninterface ParsedDefault {\n /** The numbers the file wrote. */\n readonly value: number | readonly number[];\n /** Whether the value was written as `color(…)`. */\n readonly color: boolean;\n /** The rest of the line. */\n readonly tail: string;\n}\n\n/**\n * Reads the `= …` half of a uniform declaration.\n *\n * @param text - The text after the `=`.\n * @param type - The declared type, which fixes the element count.\n * @param name - The uniform's name, for diagnostics.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The value, whether it was a colour, and the rest of the line.\n */\nfunction readDefaultValue(\n text: string,\n type: ShaderUniformType,\n name: string,\n address: string,\n line: number,\n): ParsedDefault {\n const expected = ELEMENT_COUNTS[type];\n const colorMatch = COLOR_DEFAULT.exec(text);\n if (colorMatch !== null) {\n const numbers = readNumbers(colorMatch[1] ?? \"\", name, address, line);\n if (type !== \"vec3<f32>\" && type !== \"vec4<f32>\") {\n throw pragmaError(address, line, `${name} is a ${type}, so color(…) does not apply to it`);\n }\n assertArity(numbers.length, expected, name, type, address, line);\n return { value: numbers, color: true, tail: text.slice(colorMatch[0].length).trim() };\n }\n const tupleMatch = TUPLE_DEFAULT.exec(text);\n if (tupleMatch !== null) {\n const numbers = readNumbers(tupleMatch[1] ?? \"\", name, address, line);\n assertArity(numbers.length, expected, name, type, address, line);\n return { value: numbers, color: false, tail: text.slice(tupleMatch[0].length).trim() };\n }\n const numberMatch = NUMBER_DEFAULT.exec(text);\n if (numberMatch !== null) {\n assertArity(1, expected, name, type, address, line);\n return { value: Number(numberMatch[1]), color: false, tail: text.slice(numberMatch[0].length).trim() };\n }\n throw pragmaError(address, line, `${name} declares no readable default value after \"=\"`);\n}\n\n/** The optional hints an inspector renders a uniform with. */\ninterface ParsedModifiers {\n /** Whether the bare `color` modifier was present. */\n readonly color: boolean;\n /** The `range(a, b)` bounds, or `null`. */\n readonly range: readonly [number, number] | null;\n /** The `step(s)` increment, or `null`. */\n readonly step: number | null;\n /** The `tooltip(\"…\")` text, or `null`. */\n readonly tooltip: string | null;\n}\n\n/**\n * Reads the `range(…)`, `step(…)`, `color`, and `tooltip(\"…\")` modifiers that close a uniform line.\n *\n * @param text - What is left of the line.\n * @param name - The uniform's name, for diagnostics.\n * @param type - The declared type, which decides whether `color` applies.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The hints.\n */\nfunction readModifiers(\n text: string,\n name: string,\n type: ShaderUniformType,\n address: string,\n line: number,\n): ParsedModifiers {\n let rest = text;\n let color = false;\n let range: readonly [number, number] | null = null;\n let step: number | null = null;\n let tooltip: string | null = null;\n while (rest.length > 0) {\n const tooltipMatch = TOOLTIP_MODIFIER.exec(rest);\n if (tooltipMatch !== null) {\n if (tooltip !== null) {\n throw pragmaError(address, line, `${name} declares tooltip twice`);\n }\n tooltip = (tooltipMatch[1] ?? \"\").replaceAll('\\\\\"', '\"');\n rest = rest.slice(tooltipMatch[0].length);\n continue;\n }\n const callMatch = CALL_MODIFIER.exec(rest);\n if (callMatch === null) {\n throw pragmaError(address, line, `${name} declares ${JSON.stringify(rest)}, which is not a uniform modifier`);\n }\n const modifier = callMatch[1] ?? \"\";\n const argumentText = callMatch[2];\n if (modifier === \"color\") {\n if (argumentText !== undefined) {\n throw pragmaError(address, line, `${name} declares color(…) after its default value`);\n }\n if (type !== \"vec3<f32>\" && type !== \"vec4<f32>\") {\n throw pragmaError(address, line, `${name} is a ${type}, so color does not apply to it`);\n }\n color = true;\n } else if (modifier === \"range\") {\n if (range !== null) {\n throw pragmaError(address, line, `${name} declares range twice`);\n }\n const bounds = readNumbers(argumentText ?? \"\", name, address, line);\n const low = bounds[0];\n const high = bounds[1];\n if (bounds.length !== 2 || low === undefined || high === undefined) {\n throw pragmaError(address, line, `${name} declares range(…) with ${String(bounds.length)} bounds, not 2`);\n }\n range = [low, high];\n } else {\n if (step !== null) {\n throw pragmaError(address, line, `${name} declares step twice`);\n }\n const increments = readNumbers(argumentText ?? \"\", name, address, line);\n const increment = increments[0];\n if (increments.length !== 1 || increment === undefined) {\n throw pragmaError(address, line, `${name} declares step(…) with ${String(increments.length)} values, not 1`);\n }\n step = increment;\n }\n rest = rest.slice(callMatch[0].length);\n }\n return { color, range, step, tooltip };\n}\n\n/**\n * Reads one `// @ignifx texture name [srgb] [normal] [default white|black|transparent] [array]`\n * line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readTexture(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderTextureDeclaration {\n const tokens = rest.split(/\\s+/).filter((token) => token.length > 0);\n const name = tokens[0];\n if (name === undefined) {\n throw pragmaError(address, line, \"@ignifx texture declares no name\");\n }\n assertIdentifier(name, address, line, \"texture\");\n claimName(draft, name, address, line, \"texture\");\n claimName(draft, `${name}Sampler`, address, line, \"texture sampler\");\n let srgb = false;\n let normal = false;\n let array = false;\n let fallback: ShaderTextureFallback | null = null;\n for (let index = 1; index < tokens.length; index += 1) {\n const token = tokens[index] ?? \"\";\n if (token === \"srgb\") {\n srgb = true;\n } else if (token === \"normal\") {\n normal = true;\n } else if (token === \"array\") {\n array = true;\n } else if (token === \"default\") {\n index += 1;\n const named = matchLiteral(SHADER_TEXTURE_FALLBACKS, tokens[index] ?? \"\");\n if (named === null) {\n throw pragmaError(\n address,\n line,\n `${name} declares default ${JSON.stringify(tokens[index] ?? \"\")}; expected ${SHADER_TEXTURE_FALLBACKS.join(\", \")}`,\n );\n }\n fallback = named;\n } else {\n throw pragmaError(address, line, `${JSON.stringify(token)} is not a texture modifier`);\n }\n }\n return { name, srgb, normal, fallback, array };\n}\n\n/**\n * Reads one `// @ignifx storage name: array<T>` line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readStorage(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderStorageDeclaration {\n const split = NAME_AND_TYPE.exec(rest);\n if (split === null) {\n throw pragmaError(address, line, `@ignifx storage expects \"name: type\", but found ${JSON.stringify(rest)}`);\n }\n const name = split[1] ?? \"\";\n const type = (split[2] ?? \"\").trim();\n if (type.length === 0) {\n throw pragmaError(address, line, `${name} declares no storage buffer type`);\n }\n claimName(draft, name, address, line, \"storage buffer\");\n return { name, type };\n}\n\n/**\n * Reads one `// @ignifx define NAME = value` line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readDefine(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderDefineDeclaration {\n const equals = rest.indexOf(\"=\");\n if (equals < 0) {\n throw pragmaError(address, line, `@ignifx define expects \"NAME = value\", but found ${JSON.stringify(rest)}`);\n }\n const name = rest.slice(0, equals).trim();\n const text = rest.slice(equals + 1).trim();\n assertIdentifier(name, address, line, \"define\");\n claimName(draft, name, address, line, \"define\");\n if (text === \"true\" || text === \"false\") {\n return { name, value: text === \"true\" };\n }\n const numberMatch = NUMBER_DEFAULT.exec(text);\n if (numberMatch === null || numberMatch[0].trim().length !== text.length) {\n throw pragmaError(address, line, `${name} declares ${JSON.stringify(text)}; a define is true, false, or a number`);\n }\n return { name, value: Number(numberMatch[1]) };\n}\n\n/**\n * Reads the `// @ignifx displace <metres>` line: how far the vertex stage may move a vertex.\n *\n * @param draft - The declaration being built.\n * @param rest - The directive body, which must be one number of zero or more.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readDisplace(draft: DeclarationDraft, rest: string, address: string, line: number): void {\n if (draft.displace !== null) {\n throw pragmaError(address, line, \"displace is declared twice\");\n }\n const numberMatch = NUMBER_DEFAULT.exec(rest);\n const value = numberMatch === null ? Number.NaN : Number(numberMatch[1]);\n if (\n numberMatch === null ||\n numberMatch[0].trim().length !== rest.length ||\n !(value >= 0) ||\n !Number.isFinite(value)\n ) {\n throw pragmaError(\n address,\n line,\n `displace ${JSON.stringify(rest)} is not a distance; write the furthest a vertex moves, in metres, such as displace 0.25`,\n );\n }\n draft.displace = value;\n}\n\n/**\n * Reads a pipeline-state line, merging it into whatever earlier lines declared.\n *\n * @param draft - The declaration being built.\n * @param text - The whole directive text, starting at its first keyword.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readPipeline(draft: DeclarationDraft, text: string, address: string, line: number): void {\n const tokens = text.split(/\\s+/).filter((token) => token.length > 0);\n for (let index = 0; index < tokens.length; index += 1) {\n const keyword = tokens[index] ?? \"\";\n if (keyword === \"transmissive\") {\n draft.transmissive = true;\n continue;\n }\n index += 1;\n const value = tokens[index] ?? \"\";\n switch (keyword) {\n case \"blend\":\n draft.blend = readPipelineValue(SHADER_BLEND_MODES, draft.blend, keyword, value, address, line);\n break;\n case \"cull\": {\n const cull = readPipelineValue(SHADER_CULL_MODES, draft.cull, keyword, value, address, line);\n if (cull === \"front\") {\n throw pragmaError(\n address,\n line,\n \"Babylon Lite 1.27.0 has no front-face culling for a shader material; declare cull back or cull none and flip the winding\",\n );\n }\n draft.cull = cull;\n break;\n }\n case \"depthWrite\":\n draft.depthWrite = readToggle(draft.depthWrite, keyword, value, address, line);\n break;\n case \"depthTest\":\n draft.depthTest = readToggle(draft.depthTest, keyword, value, address, line);\n break;\n case \"instancing\":\n draft.instancing = readPipelineValue(SHADER_INSTANCING_MODES, draft.instancing, keyword, value, address, line);\n break;\n default:\n throw pragmaError(address, line, `${JSON.stringify(keyword)} is not a pipeline keyword`);\n }\n }\n}\n\n/**\n * Reads one pipeline keyword's value out of a fixed list, refusing a second declaration of it.\n *\n * @typeParam Value - The literal union the keyword accepts.\n * @param allowed - The accepted values.\n * @param current - What an earlier line declared, or `null`.\n * @param keyword - The keyword, for diagnostics.\n * @param value - The token that followed it.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The value.\n */\nfunction readPipelineValue<Value extends string>(\n allowed: readonly Value[],\n current: Value | null,\n keyword: string,\n value: string,\n address: string,\n line: number,\n): Value {\n if (current !== null) {\n throw pragmaError(address, line, `${keyword} is declared twice`);\n }\n const matched = matchLiteral(allowed, value);\n if (matched === null) {\n throw pragmaError(address, line, `${keyword} ${JSON.stringify(value)} is not one of ${allowed.join(\", \")}`);\n }\n return matched;\n}\n\n/**\n * Reads an `on`/`off` toggle, refusing a second declaration of it.\n *\n * @param current - What an earlier line declared, or `null`.\n * @param keyword - The keyword, for diagnostics.\n * @param value - The token that followed it.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns `true` for `on`, `false` for `off`.\n */\nfunction readToggle(current: boolean | null, keyword: string, value: string, address: string, line: number): boolean {\n if (current !== null) {\n throw pragmaError(address, line, `${keyword} is declared twice`);\n }\n if (value !== \"on\" && value !== \"off\") {\n throw pragmaError(address, line, `${keyword} ${JSON.stringify(value)} is not on or off`);\n }\n return value === \"on\";\n}\n\n/**\n * Fills in the defaults and checks the whole-file rules.\n *\n * @param draft - The declaration the parser built.\n * @param address - The asset address, for diagnostics.\n * @returns The finished declaration.\n */\nfunction finish(draft: DeclarationDraft, address: string): ShaderDeclaration {\n const kind = draft.kind;\n if (kind === null) {\n throw pragmaError(address, 1, \"the file declares no @ignifx shader, @ignifx surface, or @ignifx post directive\");\n }\n const declared = draft.attributes;\n if (declared !== null && kind === \"shader\" && !declared.includes(\"position\")) {\n throw pragmaError(address, 1, \"an @ignifx shader file must declare the position attribute\");\n }\n const attributes: readonly ShaderAttributeName[] = declared ?? (kind === \"shader\" ? [\"position\"] : []);\n if (kind === \"post\" && draft.displace !== null) {\n throw pragmaError(address, 1, \"an @ignifx post file draws no mesh, so it has nothing to displace\");\n }\n const blend = draft.blend ?? \"opaque\";\n if (draft.transmissive && blend === \"opaque\") {\n throw pragmaError(\n address,\n 1,\n \"transmissive needs a blended surface; declare blend alpha, additive, or premultiplied\",\n );\n }\n return {\n kind,\n attributes,\n system: draft.system,\n ignifx: draft.ignifx,\n uniforms: draft.uniforms,\n textures: draft.textures,\n storage: draft.storage,\n defines: draft.defines,\n pipeline: {\n blend,\n cull: draft.cull ?? \"back\",\n // Babylon Lite defaults a blended material to depth-read-only and lets an explicit value win\n // (`lib/material/shader/shader-material.js`), which is the rule reproduced here so the\n // declaration itself carries the effective value.\n depthWrite: draft.depthWrite ?? blend === \"opaque\",\n depthTest: draft.depthTest ?? true,\n transmissive: draft.transmissive,\n instancing: draft.instancing ?? \"none\",\n },\n displace: draft.displace ?? 0,\n };\n}\n\n/**\n * Splits a comma-separated directive body, refusing an empty entry.\n *\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @param directive - The directive name, for diagnostics.\n * @returns The trimmed entries.\n */\nfunction splitList(rest: string, address: string, line: number, directive: string): readonly string[] {\n if (rest.length === 0) {\n throw pragmaError(address, line, `@ignifx ${directive} declares nothing`);\n }\n const parts = rest.split(\",\");\n const names: string[] = [];\n for (let index = 0; index < parts.length; index += 1) {\n const name = (parts[index] ?? \"\").trim();\n if (name.length === 0) {\n throw pragmaError(address, line, `@ignifx ${directive} has an empty entry`);\n }\n names.push(name);\n }\n return names;\n}\n\n/**\n * Reads a comma-separated list of numbers.\n *\n * @param text - The argument text, without the parentheses.\n * @param name - The declaration's name, for diagnostics.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The numbers.\n */\nfunction readNumbers(text: string, name: string, address: string, line: number): readonly number[] {\n const parts = text.split(\",\");\n const numbers: number[] = [];\n for (let index = 0; index < parts.length; index += 1) {\n const part = (parts[index] ?? \"\").trim();\n const value = Number(part);\n if (part.length === 0 || !Number.isFinite(value)) {\n throw pragmaError(address, line, `${name} declares ${JSON.stringify(part)}, which is not a number`);\n }\n numbers.push(value);\n }\n return numbers;\n}\n\n/**\n * Checks that a default value has as many numbers as its type needs.\n *\n * @param actual - How many numbers the file wrote.\n * @param expected - How many the type holds.\n * @param name - The uniform's name, for diagnostics.\n * @param type - The uniform's type, for diagnostics.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction assertArity(\n actual: number,\n expected: number,\n name: string,\n type: ShaderUniformType,\n address: string,\n line: number,\n): void {\n if (actual !== expected) {\n throw pragmaError(\n address,\n line,\n `${name} is a ${type}, which takes ${String(expected)} numbers, but its default has ${String(actual)}`,\n );\n }\n}\n\n/**\n * The value a uniform starts at when the file declares no default: zeros, or the identity matrix.\n *\n * @param type - The declared type.\n * @returns The default.\n */\nfunction implicitDefault(type: ShaderUniformType): number | readonly number[] {\n if (type === \"mat4x4<f32>\") {\n return IDENTITY_MATRIX;\n }\n const count = ELEMENT_COUNTS[type];\n if (count === 1) {\n return 0;\n }\n const zeros: number[] = [];\n for (let index = 0; index < count; index += 1) {\n zeros.push(0);\n }\n return zeros;\n}\n\n/**\n * Claims one WGSL binding name, refusing a duplicate.\n *\n * @remarks\n * Babylon Lite puts uniforms, samplers, `<name>Sampler` pairs, storage buffers, and defines in one\n * namespace (`assertUniqueName`, `lib/material/shader/shader-material.js`), so the parser checks it\n * here and reports the line instead of letting Lite throw without one.\n *\n * @param draft - The declaration being built.\n * @param name - The name being claimed.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @param what - What kind of binding is claiming it, for diagnostics.\n */\nfunction claimName(draft: DeclarationDraft, name: string, address: string, line: number, what: string): void {\n if (draft.names.has(name)) {\n throw pragmaError(address, line, `${name} is already declared; the ${what} name must be unique in the file`);\n }\n draft.names.add(name);\n}\n\n/**\n * Checks that a name is a WGSL identifier.\n *\n * @param name - The candidate.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @param what - What kind of binding it names, for diagnostics.\n */\nfunction assertIdentifier(name: string, address: string, line: number, what: string): void {\n if (!IDENTIFIER.test(name)) {\n throw pragmaError(address, line, `${JSON.stringify(name)} is not a WGSL identifier for a ${what}`);\n }\n}\n\n/**\n * Narrows a token to one of a fixed list of literals.\n *\n * @typeParam Value - The literal union.\n * @param allowed - The accepted values.\n * @param token - The candidate.\n * @returns The matching literal, or `null`.\n */\nfunction matchLiteral<Value extends string>(allowed: readonly Value[], token: string): Value | null {\n for (let index = 0; index < allowed.length; index += 1) {\n const candidate = allowed[index];\n if (candidate !== undefined && candidate === token) {\n return candidate;\n }\n }\n return null;\n}\n\n/**\n * Builds the `IGX-0719` failure a malformed pragma produces.\n *\n * @param address - The asset address.\n * @param line - The 1-based line number.\n * @param message - What is wrong.\n * @returns The error to throw.\n */\nfunction pragmaError(address: string, line: number, message: string): IgnifxError {\n return new IgnifxError(CoreErrorCode.invalidShaderPragma, `${address} line ${String(line)}: ${message}.`, {\n context: { asset: address, line, message },\n hint: \"The @ignifx pragma grammar is in skills/ignifx/references/formats/wgsl.md.\",\n });\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"shader-pragma-qO9_6sTd.js","names":[],"sources":["../src/render/shader-pragma.ts"],"sourcesContent":["import { CoreErrorCode } from \"../errors/error-codes.js\";\nimport { IgnifxError } from \"../errors/ignifx-error.js\";\nimport {\n IGNIFX_UNIFORM_NAMES,\n LITE_SYSTEM_UNIFORM_NAMES,\n SHADER_ATTRIBUTE_NAMES,\n SHADER_BLEND_MODES,\n SHADER_CULL_MODES,\n SHADER_INSTANCING_MODES,\n SHADER_TEXTURE_FALLBACKS,\n SHADER_UNIFORM_TYPES,\n} from \"./shader-declaration.js\";\nimport type {\n IgnifxUniformName,\n LiteSystemUniformName,\n ShaderAttributeName,\n ShaderBlendMode,\n ShaderCullMode,\n ShaderDeclaration,\n ShaderDefineDeclaration,\n ShaderInstancingMode,\n ShaderKind,\n ShaderStorageDeclaration,\n ShaderTextureDeclaration,\n ShaderTextureFallback,\n ShaderUniformDeclaration,\n ShaderUniformType,\n} from \"./shader-declaration.js\";\n\n/**\n * Reads the `// @ignifx …` comment pragmas of a `.wgsl` file into a {@link ShaderDeclaration}\n * (grammar: `docs/plan/2026-09-terrain-particles-shaders.md` §3.1; rationale: ADR-0024).\n *\n * Pure string work with no Babylon Lite import, so the build-time validator and the runtime loader\n * can share it. Four rules the grammar itself does not show:\n *\n * - `@ignifx system` mixes Lite's names with ignifx's, and the WGSL reads them from different\n * structs, so they are split into `declaration.system` and `declaration.ignifx`.\n * - An omitted `attributes` directive means `position`; Lite refuses a shader material without it\n * (`lib/material/shader/shader-material.js`, error 293).\n * - A `color(…)` default keeps the authored sRGB numbers; `./shader-material.ts` converts.\n * - `cull front` and `transmissive` on an opaque surface are refused here, with a line number,\n * because Lite has no front-face culling and throws on the second combination (error 295).\n */\n\n/** Matches an `// @ignifx …` line and captures the directive text after it. */\nconst PRAGMA_LINE = /^\\s*\\/\\/\\s*@ignifx\\b(.*)$/;\n\n/** Matches a WGSL identifier. */\nconst IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** Splits `name: type` at the colon, capturing the identifier and the rest of the line. */\nconst NAME_AND_TYPE = /^([A-Za-z_][A-Za-z0-9_]*)\\s*:\\s*(.*)$/;\n\n/** Matches a leading `tooltip(\"…\")` modifier, capturing the quoted text. */\nconst TOOLTIP_MODIFIER = /^tooltip\\(\\s*\"((?:[^\"\\\\]|\\\\.)*)\"\\s*\\)\\s*/;\n\n/** Matches a leading `range(…)`, `step(…)`, or `color(…)`/`color` modifier. */\nconst CALL_MODIFIER = /^(range|step|color)\\s*(?:\\(([^)]*)\\))?\\s*/;\n\n/** Matches a leading `color(…)` default value, capturing the arguments. */\nconst COLOR_DEFAULT = /^color\\s*\\(([^)]*)\\)\\s*/;\n\n/** Matches a leading parenthesised numeric list, capturing the arguments. */\nconst TUPLE_DEFAULT = /^\\(([^)]*)\\)\\s*/;\n\n/** Matches a leading decimal number, with optional sign and exponent. */\nconst NUMBER_DEFAULT = /^([+-]?(?:\\d+\\.?\\d*|\\.\\d+)(?:[eE][+-]?\\d+)?)\\s*/;\n\n/** How many elements each uniform type holds. */\nconst ELEMENT_COUNTS: Readonly<Record<ShaderUniformType, number>> = Object.freeze({\n f32: 1,\n u32: 1,\n i32: 1,\n \"vec2<f32>\": 2,\n \"vec3<f32>\": 3,\n \"vec4<f32>\": 4,\n \"mat4x4<f32>\": 16,\n});\n\n/** The identity matrix a `mat4x4<f32>` uniform starts at when the file declares no default. */\nconst IDENTITY_MATRIX: readonly number[] = Object.freeze([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);\n\n/** The mutable declaration the parser fills in, line by line. */\ninterface DeclarationDraft {\n kind: ShaderKind | null;\n attributes: ShaderAttributeName[] | null;\n readonly system: LiteSystemUniformName[];\n readonly ignifx: IgnifxUniformName[];\n readonly uniforms: ShaderUniformDeclaration[];\n readonly textures: ShaderTextureDeclaration[];\n readonly storage: ShaderStorageDeclaration[];\n readonly defines: ShaderDefineDeclaration[];\n readonly names: Set<string>;\n blend: ShaderBlendMode | null;\n cull: ShaderCullMode | null;\n depthWrite: boolean | null;\n depthTest: boolean | null;\n transmissive: boolean;\n instancing: ShaderInstancingMode | null;\n displace: number | null;\n}\n\n/**\n * Reads a `.wgsl` file's `// @ignifx` pragmas into the declaration the loader, the material\n * builder, and the inspector all read.\n *\n * @param source - The whole file, as text.\n * @param address - The asset address, so a failure names the file.\n * @returns The declaration, with every default filled in.\n * @throws IgnifxError with code `IGX-0719`, carrying the offending `line`, for an unknown directive,\n * a malformed one, a duplicate binding name, an attribute or uniform type Babylon Lite does not\n * have, or a combination it cannot express.\n *\n * @example\n * ```ts\n * const declaration = parseShaderDeclaration(\"// @ignifx shader\\n\", \"shaders/flat.wgsl\");\n * declaration.attributes; // [\"position\"]\n * ```\n *\n * @public\n */\nexport function parseShaderDeclaration(source: string, address: string): ShaderDeclaration {\n const draft: DeclarationDraft = {\n kind: null,\n attributes: null,\n system: [],\n ignifx: [],\n uniforms: [],\n textures: [],\n storage: [],\n defines: [],\n names: new Set<string>(),\n blend: null,\n cull: null,\n depthWrite: null,\n depthTest: null,\n transmissive: false,\n instancing: null,\n displace: null,\n };\n const lines = source.split(\"\\n\");\n for (let index = 0; index < lines.length; index += 1) {\n const matched = PRAGMA_LINE.exec(lines[index] ?? \"\");\n if (matched === null) {\n continue;\n }\n readDirective(draft, (matched[1] ?? \"\").trim(), address, index + 1);\n }\n return finish(draft, address);\n}\n\n/**\n * Applies one `// @ignifx …` line to the draft.\n *\n * @param draft - The declaration being built.\n * @param text - The directive text, already trimmed.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readDirective(draft: DeclarationDraft, text: string, address: string, line: number): void {\n if (text.length === 0) {\n throw pragmaError(address, line, \"an @ignifx comment declares no directive\");\n }\n const separator = text.search(/\\s/);\n const directive = separator < 0 ? text : text.slice(0, separator);\n const rest = separator < 0 ? \"\" : text.slice(separator + 1).trim();\n switch (directive) {\n case \"shader\":\n case \"surface\":\n case \"post\":\n readKind(draft, directive, rest, address, line);\n return;\n case \"attributes\":\n readAttributes(draft, rest, address, line);\n return;\n case \"system\":\n readSystem(draft, rest, address, line);\n return;\n case \"uniform\":\n draft.uniforms.push(readUniform(draft, rest, address, line));\n return;\n case \"texture\":\n draft.textures.push(readTexture(draft, rest, address, line));\n return;\n case \"storage\":\n draft.storage.push(readStorage(draft, rest, address, line));\n return;\n case \"define\":\n draft.defines.push(readDefine(draft, rest, address, line));\n return;\n case \"blend\":\n case \"cull\":\n case \"depthWrite\":\n case \"depthTest\":\n case \"transmissive\":\n case \"instancing\":\n readPipeline(draft, text, address, line);\n return;\n case \"displace\":\n readDisplace(draft, rest, address, line);\n return;\n default:\n throw pragmaError(address, line, `${JSON.stringify(directive)} is not an @ignifx directive`);\n }\n}\n\n/**\n * Records the file's form, refusing a second one.\n *\n * @param draft - The declaration being built.\n * @param kind - The declared form.\n * @param rest - Whatever followed it, which must be nothing.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readKind(draft: DeclarationDraft, kind: ShaderKind, rest: string, address: string, line: number): void {\n if (rest.length > 0) {\n throw pragmaError(address, line, `@ignifx ${kind} takes no arguments, but found ${JSON.stringify(rest)}`);\n }\n if (draft.kind !== null) {\n throw pragmaError(address, line, `the file already declared @ignifx ${draft.kind}`);\n }\n draft.kind = kind;\n}\n\n/**\n * Records the vertex attributes the vertex stage reads.\n *\n * @param draft - The declaration being built.\n * @param rest - The comma-separated attribute names.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readAttributes(draft: DeclarationDraft, rest: string, address: string, line: number): void {\n if (draft.attributes !== null) {\n throw pragmaError(address, line, \"the file already declared @ignifx attributes\");\n }\n const names = splitList(rest, address, line, \"attributes\");\n const attributes: ShaderAttributeName[] = [];\n for (const name of names) {\n const attribute = matchLiteral(SHADER_ATTRIBUTE_NAMES, name);\n if (attribute === null) {\n throw pragmaError(\n address,\n line,\n `${JSON.stringify(name)} is not a vertex attribute; Babylon Lite has ${SHADER_ATTRIBUTE_NAMES.join(\", \")}`,\n );\n }\n if (attributes.includes(attribute)) {\n throw pragmaError(address, line, `the attribute ${attribute} is declared twice`);\n }\n attributes.push(attribute);\n }\n draft.attributes = attributes;\n}\n\n/**\n * Records the system uniforms, splitting Babylon Lite's names from ignifx's own.\n *\n * @param draft - The declaration being built.\n * @param rest - The comma-separated uniform names.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readSystem(draft: DeclarationDraft, rest: string, address: string, line: number): void {\n const names = splitList(rest, address, line, \"system\");\n for (const name of names) {\n const lite = matchLiteral(LITE_SYSTEM_UNIFORM_NAMES, name);\n if (lite !== null) {\n claimName(draft, lite, address, line, \"system uniform\");\n draft.system.push(lite);\n continue;\n }\n const ignifx = matchLiteral(IGNIFX_UNIFORM_NAMES, name);\n if (ignifx !== null) {\n claimName(draft, ignifx, address, line, \"system uniform\");\n draft.ignifx.push(ignifx);\n continue;\n }\n throw pragmaError(\n address,\n line,\n `${JSON.stringify(name)} is not a system uniform; Babylon Lite has ${LITE_SYSTEM_UNIFORM_NAMES.join(\", \")} and ignifx adds ${IGNIFX_UNIFORM_NAMES.join(\", \")}`,\n );\n }\n}\n\n/**\n * Reads one `// @ignifx uniform name: type [= default] [modifiers]` line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readUniform(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderUniformDeclaration {\n const split = NAME_AND_TYPE.exec(rest);\n if (split === null) {\n throw pragmaError(address, line, `@ignifx uniform expects \"name: type\", but found ${JSON.stringify(rest)}`);\n }\n const name = split[1] ?? \"\";\n let tail = (split[2] ?? \"\").trim();\n const typeSeparator = tail.search(/[\\s=]/);\n const typeName = typeSeparator < 0 ? tail : tail.slice(0, typeSeparator);\n tail = (typeSeparator < 0 ? \"\" : tail.slice(typeName.length)).trim();\n const type = matchLiteral(SHADER_UNIFORM_TYPES, typeName);\n if (type === null) {\n throw pragmaError(\n address,\n line,\n `${JSON.stringify(typeName)} is not a uniform type; Babylon Lite has ${SHADER_UNIFORM_TYPES.join(\", \")}`,\n );\n }\n claimName(draft, name, address, line, \"uniform\");\n let defaultValue: number | readonly number[] | null = null;\n let isColor = false;\n if (tail.startsWith(\"=\")) {\n tail = tail.slice(1).trim();\n const parsed = readDefaultValue(tail, type, name, address, line);\n defaultValue = parsed.value;\n isColor = parsed.color;\n tail = parsed.tail;\n }\n const modifiers = readModifiers(tail, name, type, address, line);\n return {\n name,\n type,\n defaultValue: defaultValue ?? implicitDefault(type),\n color: isColor || modifiers.color,\n range: modifiers.range,\n step: modifiers.step,\n tooltip: modifiers.tooltip,\n };\n}\n\n/** A parsed `= …` default value and whatever followed it. */\ninterface ParsedDefault {\n /** The numbers the file wrote. */\n readonly value: number | readonly number[];\n /** Whether the value was written as `color(…)`. */\n readonly color: boolean;\n /** The rest of the line. */\n readonly tail: string;\n}\n\n/**\n * Reads the `= …` half of a uniform declaration.\n *\n * @param text - The text after the `=`.\n * @param type - The declared type, which fixes the element count.\n * @param name - The uniform's name, for diagnostics.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The value, whether it was a colour, and the rest of the line.\n */\nfunction readDefaultValue(\n text: string,\n type: ShaderUniformType,\n name: string,\n address: string,\n line: number,\n): ParsedDefault {\n const expected = ELEMENT_COUNTS[type];\n const colorMatch = COLOR_DEFAULT.exec(text);\n if (colorMatch !== null) {\n const numbers = readNumbers(colorMatch[1] ?? \"\", name, address, line);\n if (type !== \"vec3<f32>\" && type !== \"vec4<f32>\") {\n throw pragmaError(address, line, `${name} is a ${type}, so color(…) does not apply to it`);\n }\n assertArity(numbers.length, expected, name, type, address, line);\n return { value: numbers, color: true, tail: text.slice(colorMatch[0].length).trim() };\n }\n const tupleMatch = TUPLE_DEFAULT.exec(text);\n if (tupleMatch !== null) {\n const numbers = readNumbers(tupleMatch[1] ?? \"\", name, address, line);\n assertArity(numbers.length, expected, name, type, address, line);\n return { value: numbers, color: false, tail: text.slice(tupleMatch[0].length).trim() };\n }\n const numberMatch = NUMBER_DEFAULT.exec(text);\n if (numberMatch !== null) {\n assertArity(1, expected, name, type, address, line);\n return { value: Number(numberMatch[1]), color: false, tail: text.slice(numberMatch[0].length).trim() };\n }\n throw pragmaError(address, line, `${name} declares no readable default value after \"=\"`);\n}\n\n/** The optional hints an inspector renders a uniform with. */\ninterface ParsedModifiers {\n /** Whether the bare `color` modifier was present. */\n readonly color: boolean;\n /** The `range(a, b)` bounds, or `null`. */\n readonly range: readonly [number, number] | null;\n /** The `step(s)` increment, or `null`. */\n readonly step: number | null;\n /** The `tooltip(\"…\")` text, or `null`. */\n readonly tooltip: string | null;\n}\n\n/**\n * Reads the `range(…)`, `step(…)`, `color`, and `tooltip(\"…\")` modifiers that close a uniform line.\n *\n * @param text - What is left of the line.\n * @param name - The uniform's name, for diagnostics.\n * @param type - The declared type, which decides whether `color` applies.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The hints.\n */\nfunction readModifiers(\n text: string,\n name: string,\n type: ShaderUniformType,\n address: string,\n line: number,\n): ParsedModifiers {\n let rest = text;\n let color = false;\n let range: readonly [number, number] | null = null;\n let step: number | null = null;\n let tooltip: string | null = null;\n while (rest.length > 0) {\n const tooltipMatch = TOOLTIP_MODIFIER.exec(rest);\n if (tooltipMatch !== null) {\n if (tooltip !== null) {\n throw pragmaError(address, line, `${name} declares tooltip twice`);\n }\n tooltip = (tooltipMatch[1] ?? \"\").replaceAll('\\\\\"', '\"');\n rest = rest.slice(tooltipMatch[0].length);\n continue;\n }\n const callMatch = CALL_MODIFIER.exec(rest);\n if (callMatch === null) {\n throw pragmaError(address, line, `${name} declares ${JSON.stringify(rest)}, which is not a uniform modifier`);\n }\n const modifier = callMatch[1] ?? \"\";\n const argumentText = callMatch[2];\n if (modifier === \"color\") {\n if (argumentText !== undefined) {\n throw pragmaError(address, line, `${name} declares color(…) after its default value`);\n }\n if (type !== \"vec3<f32>\" && type !== \"vec4<f32>\") {\n throw pragmaError(address, line, `${name} is a ${type}, so color does not apply to it`);\n }\n color = true;\n } else if (modifier === \"range\") {\n if (range !== null) {\n throw pragmaError(address, line, `${name} declares range twice`);\n }\n const bounds = readNumbers(argumentText ?? \"\", name, address, line);\n const low = bounds[0];\n const high = bounds[1];\n if (bounds.length !== 2 || low === undefined || high === undefined) {\n throw pragmaError(address, line, `${name} declares range(…) with ${String(bounds.length)} bounds, not 2`);\n }\n range = [low, high];\n } else {\n if (step !== null) {\n throw pragmaError(address, line, `${name} declares step twice`);\n }\n const increments = readNumbers(argumentText ?? \"\", name, address, line);\n const increment = increments[0];\n if (increments.length !== 1 || increment === undefined) {\n throw pragmaError(address, line, `${name} declares step(…) with ${String(increments.length)} values, not 1`);\n }\n step = increment;\n }\n rest = rest.slice(callMatch[0].length);\n }\n return { color, range, step, tooltip };\n}\n\n/**\n * Reads one `// @ignifx texture name [srgb] [normal] [default white|black|transparent] [array]`\n * line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readTexture(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderTextureDeclaration {\n const tokens = rest.split(/\\s+/).filter((token) => token.length > 0);\n const name = tokens[0];\n if (name === undefined) {\n throw pragmaError(address, line, \"@ignifx texture declares no name\");\n }\n assertIdentifier(name, address, line, \"texture\");\n claimName(draft, name, address, line, \"texture\");\n claimName(draft, `${name}Sampler`, address, line, \"texture sampler\");\n let srgb = false;\n let normal = false;\n let array = false;\n let fallback: ShaderTextureFallback | null = null;\n for (let index = 1; index < tokens.length; index += 1) {\n const token = tokens[index] ?? \"\";\n if (token === \"srgb\") {\n srgb = true;\n } else if (token === \"normal\") {\n normal = true;\n } else if (token === \"array\") {\n array = true;\n } else if (token === \"default\") {\n index += 1;\n const named = matchLiteral(SHADER_TEXTURE_FALLBACKS, tokens[index] ?? \"\");\n if (named === null) {\n throw pragmaError(\n address,\n line,\n `${name} declares default ${JSON.stringify(tokens[index] ?? \"\")}; expected ${SHADER_TEXTURE_FALLBACKS.join(\", \")}`,\n );\n }\n fallback = named;\n } else {\n throw pragmaError(address, line, `${JSON.stringify(token)} is not a texture modifier`);\n }\n }\n return { name, srgb, normal, fallback, array };\n}\n\n/**\n * Reads one `// @ignifx storage name: array<T>` line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readStorage(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderStorageDeclaration {\n const split = NAME_AND_TYPE.exec(rest);\n if (split === null) {\n throw pragmaError(address, line, `@ignifx storage expects \"name: type\", but found ${JSON.stringify(rest)}`);\n }\n const name = split[1] ?? \"\";\n const type = (split[2] ?? \"\").trim();\n if (type.length === 0) {\n throw pragmaError(address, line, `${name} declares no storage buffer type`);\n }\n claimName(draft, name, address, line, \"storage buffer\");\n return { name, type };\n}\n\n/**\n * Reads one `// @ignifx define NAME = value` line.\n *\n * @param draft - The declaration being built, for the name namespace.\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The declaration.\n */\nfunction readDefine(draft: DeclarationDraft, rest: string, address: string, line: number): ShaderDefineDeclaration {\n const equals = rest.indexOf(\"=\");\n if (equals < 0) {\n throw pragmaError(address, line, `@ignifx define expects \"NAME = value\", but found ${JSON.stringify(rest)}`);\n }\n const name = rest.slice(0, equals).trim();\n const text = rest.slice(equals + 1).trim();\n assertIdentifier(name, address, line, \"define\");\n claimName(draft, name, address, line, \"define\");\n if (text === \"true\" || text === \"false\") {\n return { name, value: text === \"true\" };\n }\n const numberMatch = NUMBER_DEFAULT.exec(text);\n if (numberMatch === null || numberMatch[0].trim().length !== text.length) {\n throw pragmaError(address, line, `${name} declares ${JSON.stringify(text)}; a define is true, false, or a number`);\n }\n return { name, value: Number(numberMatch[1]) };\n}\n\n/**\n * Reads the `// @ignifx displace <metres>` line: how far the vertex stage may move a vertex.\n *\n * @param draft - The declaration being built.\n * @param rest - The directive body, which must be one number of zero or more.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readDisplace(draft: DeclarationDraft, rest: string, address: string, line: number): void {\n if (draft.displace !== null) {\n throw pragmaError(address, line, \"displace is declared twice\");\n }\n const numberMatch = NUMBER_DEFAULT.exec(rest);\n const value = numberMatch === null ? Number.NaN : Number(numberMatch[1]);\n if (\n numberMatch === null ||\n numberMatch[0].trim().length !== rest.length ||\n !(value >= 0) ||\n !Number.isFinite(value)\n ) {\n throw pragmaError(\n address,\n line,\n `displace ${JSON.stringify(rest)} is not a distance; write the furthest a vertex moves, in metres, such as displace 0.25`,\n );\n }\n draft.displace = value;\n}\n\n/**\n * Reads a pipeline-state line, merging it into whatever earlier lines declared.\n *\n * @param draft - The declaration being built.\n * @param text - The whole directive text, starting at its first keyword.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction readPipeline(draft: DeclarationDraft, text: string, address: string, line: number): void {\n const tokens = text.split(/\\s+/).filter((token) => token.length > 0);\n for (let index = 0; index < tokens.length; index += 1) {\n const keyword = tokens[index] ?? \"\";\n if (keyword === \"transmissive\") {\n draft.transmissive = true;\n continue;\n }\n index += 1;\n const value = tokens[index] ?? \"\";\n switch (keyword) {\n case \"blend\":\n draft.blend = readPipelineValue(SHADER_BLEND_MODES, draft.blend, keyword, value, address, line);\n break;\n case \"cull\": {\n const cull = readPipelineValue(SHADER_CULL_MODES, draft.cull, keyword, value, address, line);\n if (cull === \"front\") {\n throw pragmaError(\n address,\n line,\n \"Babylon Lite 1.27.0 has no front-face culling for a shader material; declare cull back or cull none and flip the winding\",\n );\n }\n draft.cull = cull;\n break;\n }\n case \"depthWrite\":\n draft.depthWrite = readToggle(draft.depthWrite, keyword, value, address, line);\n break;\n case \"depthTest\":\n draft.depthTest = readToggle(draft.depthTest, keyword, value, address, line);\n break;\n case \"instancing\":\n draft.instancing = readPipelineValue(SHADER_INSTANCING_MODES, draft.instancing, keyword, value, address, line);\n break;\n default:\n throw pragmaError(address, line, `${JSON.stringify(keyword)} is not a pipeline keyword`);\n }\n }\n}\n\n/**\n * Reads one pipeline keyword's value out of a fixed list, refusing a second declaration of it.\n *\n * @typeParam Value - The literal union the keyword accepts.\n * @param allowed - The accepted values.\n * @param current - What an earlier line declared, or `null`.\n * @param keyword - The keyword, for diagnostics.\n * @param value - The token that followed it.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The value.\n */\nfunction readPipelineValue<Value extends string>(\n allowed: readonly Value[],\n current: Value | null,\n keyword: string,\n value: string,\n address: string,\n line: number,\n): Value {\n if (current !== null) {\n throw pragmaError(address, line, `${keyword} is declared twice`);\n }\n const matched = matchLiteral(allowed, value);\n if (matched === null) {\n throw pragmaError(address, line, `${keyword} ${JSON.stringify(value)} is not one of ${allowed.join(\", \")}`);\n }\n return matched;\n}\n\n/**\n * Reads an `on`/`off` toggle, refusing a second declaration of it.\n *\n * @param current - What an earlier line declared, or `null`.\n * @param keyword - The keyword, for diagnostics.\n * @param value - The token that followed it.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns `true` for `on`, `false` for `off`.\n */\nfunction readToggle(current: boolean | null, keyword: string, value: string, address: string, line: number): boolean {\n if (current !== null) {\n throw pragmaError(address, line, `${keyword} is declared twice`);\n }\n if (value !== \"on\" && value !== \"off\") {\n throw pragmaError(address, line, `${keyword} ${JSON.stringify(value)} is not on or off`);\n }\n return value === \"on\";\n}\n\n/**\n * Fills in the defaults and checks the whole-file rules.\n *\n * @param draft - The declaration the parser built.\n * @param address - The asset address, for diagnostics.\n * @returns The finished declaration.\n */\nfunction finish(draft: DeclarationDraft, address: string): ShaderDeclaration {\n const kind = draft.kind;\n if (kind === null) {\n throw pragmaError(address, 1, \"the file declares no @ignifx shader, @ignifx surface, or @ignifx post directive\");\n }\n const declared = draft.attributes;\n if (declared !== null && kind === \"shader\" && !declared.includes(\"position\")) {\n throw pragmaError(address, 1, \"an @ignifx shader file must declare the position attribute\");\n }\n const attributes: readonly ShaderAttributeName[] = declared ?? (kind === \"shader\" ? [\"position\"] : []);\n if (kind === \"post\" && draft.displace !== null) {\n throw pragmaError(address, 1, \"an @ignifx post file draws no mesh, so it has nothing to displace\");\n }\n const blend = draft.blend ?? \"opaque\";\n if (draft.transmissive && blend === \"opaque\") {\n throw pragmaError(\n address,\n 1,\n \"transmissive needs a blended surface; declare blend alpha, additive, or premultiplied\",\n );\n }\n return {\n kind,\n attributes,\n system: draft.system,\n ignifx: draft.ignifx,\n uniforms: draft.uniforms,\n textures: draft.textures,\n storage: draft.storage,\n defines: draft.defines,\n pipeline: {\n blend,\n cull: draft.cull ?? \"back\",\n // Babylon Lite defaults a blended material to depth-read-only and lets an explicit value win\n // (`lib/material/shader/shader-material.js`), which is the rule reproduced here so the\n // declaration itself carries the effective value.\n depthWrite: draft.depthWrite ?? blend === \"opaque\",\n depthTest: draft.depthTest ?? true,\n transmissive: draft.transmissive,\n instancing: draft.instancing ?? \"none\",\n },\n displace: draft.displace ?? 0,\n };\n}\n\n/**\n * Splits a comma-separated directive body, refusing an empty entry.\n *\n * @param rest - The directive body.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @param directive - The directive name, for diagnostics.\n * @returns The trimmed entries.\n */\nfunction splitList(rest: string, address: string, line: number, directive: string): readonly string[] {\n if (rest.length === 0) {\n throw pragmaError(address, line, `@ignifx ${directive} declares nothing`);\n }\n const parts = rest.split(\",\");\n const names: string[] = [];\n for (let index = 0; index < parts.length; index += 1) {\n const name = (parts[index] ?? \"\").trim();\n if (name.length === 0) {\n throw pragmaError(address, line, `@ignifx ${directive} has an empty entry`);\n }\n names.push(name);\n }\n return names;\n}\n\n/**\n * Reads a comma-separated list of numbers.\n *\n * @param text - The argument text, without the parentheses.\n * @param name - The declaration's name, for diagnostics.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @returns The numbers.\n */\nfunction readNumbers(text: string, name: string, address: string, line: number): readonly number[] {\n const parts = text.split(\",\");\n const numbers: number[] = [];\n for (let index = 0; index < parts.length; index += 1) {\n const part = (parts[index] ?? \"\").trim();\n const value = Number(part);\n if (part.length === 0 || !Number.isFinite(value)) {\n throw pragmaError(address, line, `${name} declares ${JSON.stringify(part)}, which is not a number`);\n }\n numbers.push(value);\n }\n return numbers;\n}\n\n/**\n * Checks that a default value has as many numbers as its type needs.\n *\n * @param actual - How many numbers the file wrote.\n * @param expected - How many the type holds.\n * @param name - The uniform's name, for diagnostics.\n * @param type - The uniform's type, for diagnostics.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n */\nfunction assertArity(\n actual: number,\n expected: number,\n name: string,\n type: ShaderUniformType,\n address: string,\n line: number,\n): void {\n if (actual !== expected) {\n throw pragmaError(\n address,\n line,\n `${name} is a ${type}, which takes ${String(expected)} numbers, but its default has ${String(actual)}`,\n );\n }\n}\n\n/**\n * The value a uniform starts at when the file declares no default: zeros, or the identity matrix.\n *\n * @param type - The declared type.\n * @returns The default.\n */\nfunction implicitDefault(type: ShaderUniformType): number | readonly number[] {\n if (type === \"mat4x4<f32>\") {\n return IDENTITY_MATRIX;\n }\n const count = ELEMENT_COUNTS[type];\n if (count === 1) {\n return 0;\n }\n const zeros: number[] = [];\n for (let index = 0; index < count; index += 1) {\n zeros.push(0);\n }\n return zeros;\n}\n\n/**\n * Claims one WGSL binding name, refusing a duplicate.\n *\n * @remarks\n * Babylon Lite puts uniforms, samplers, `<name>Sampler` pairs, storage buffers, and defines in one\n * namespace (`assertUniqueName`, `lib/material/shader/shader-material.js`), so the parser checks it\n * here and reports the line instead of letting Lite throw without one.\n *\n * @param draft - The declaration being built.\n * @param name - The name being claimed.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @param what - What kind of binding is claiming it, for diagnostics.\n */\nfunction claimName(draft: DeclarationDraft, name: string, address: string, line: number, what: string): void {\n if (draft.names.has(name)) {\n throw pragmaError(address, line, `${name} is already declared; the ${what} name must be unique in the file`);\n }\n draft.names.add(name);\n}\n\n/**\n * Checks that a name is a WGSL identifier.\n *\n * @param name - The candidate.\n * @param address - The asset address, for diagnostics.\n * @param line - The 1-based line number, for diagnostics.\n * @param what - What kind of binding it names, for diagnostics.\n */\nfunction assertIdentifier(name: string, address: string, line: number, what: string): void {\n if (!IDENTIFIER.test(name)) {\n throw pragmaError(address, line, `${JSON.stringify(name)} is not a WGSL identifier for a ${what}`);\n }\n}\n\n/**\n * Narrows a token to one of a fixed list of literals.\n *\n * @typeParam Value - The literal union.\n * @param allowed - The accepted values.\n * @param token - The candidate.\n * @returns The matching literal, or `null`.\n */\nfunction matchLiteral<Value extends string>(allowed: readonly Value[], token: string): Value | null {\n for (let index = 0; index < allowed.length; index += 1) {\n const candidate = allowed[index];\n if (candidate !== undefined && candidate === token) {\n return candidate;\n }\n }\n return null;\n}\n\n/**\n * Builds the `IGX-0719` failure a malformed pragma produces.\n *\n * @param address - The asset address.\n * @param line - The 1-based line number.\n * @param message - What is wrong.\n * @returns The error to throw.\n */\nfunction pragmaError(address: string, line: number, message: string): IgnifxError {\n return new IgnifxError(CoreErrorCode.invalidShaderPragma, `${address} line ${String(line)}: ${message}.`, {\n context: { asset: address, line, message },\n hint: \"The @ignifx pragma grammar is in skills/ignifx/references/formats/wgsl.md.\",\n });\n}\n"],"mappings":"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"}
@@ -1,7 +1,7 @@
1
- import { t as shaderMaterialsOf } from "./shader-material-BIG3UDyu.js";
2
- import { o as CoreErrorCode, t as IgnifxError } from "./ignifx-error-CRh89KUJ.js";
1
+ import { t as shaderMaterialsOf } from "./shader-material-C4VjLTfV.js";
2
+ import { o as CoreErrorCode, t as IgnifxError } from "./ignifx-error-RpK-lWwE.js";
3
3
  import { t as Color } from "./color-DrR6GFTd.js";
4
- import { a as defineMaterialPlugin, f as markMaterialDirty, p as rebuildMaterialPipelines, s as uniformComponentCount } from "./material-plugin-Cfw_h_Mg.js";
4
+ import { a as defineMaterialPlugin, f as markMaterialDirty, p as rebuildMaterialPipelines, s as uniformComponentCount } from "./material-plugin-CWtV7DkH.js";
5
5
  import { d as SURFACE_HOOK_NAMES, f as SURFACE_UNIFORM_BLOCK } from "./shader-declaration-5q__jycG.js";
6
6
  //#region src/lite/gpu/material-plugin.ts
7
7
  /** The Lite point names that belong to the vertex stage. */
@@ -1396,4 +1396,4 @@ function describeNames(names) {
1396
1396
  //#endregion
1397
1397
  export { SurfaceShaderBinding, attachSurfaceShaders, detachSurfaceShaders, surfaceShaderBinding, surfaceShaderName, surfaceShaders };
1398
1398
 
1399
- //# sourceMappingURL=surface-shader-DAWIDdaa.js.map
1399
+ //# sourceMappingURL=surface-shader-BaR7Kg-F.js.map