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

package/dist/lib/shader-assembly/wgsl-binding-scan.js

@@ -0,0 +1,151 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+export const WGSL_BINDABLE_VARIABLE_PATTERN = '(?:var<\\s*(uniform|storage(?:\\s*,\\s*[A-Za-z_][A-Za-z0-9_]*)?)\\s*>|var)\\s+([A-Za-z_][A-Za-z0-9_]*)';
+const WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN = '\\s*';
+export const MODULE_WGSL_BINDING_DECLARATION_REGEXES = [
+    new RegExp(`@binding\\(\\s*(auto|\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}@group\\(\\s*(\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}${WGSL_BINDABLE_VARIABLE_PATTERN}`, 'g'),
+    new RegExp(`@group\\(\\s*(\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}@binding\\(\\s*(auto|\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}${WGSL_BINDABLE_VARIABLE_PATTERN}`, 'g')
+];
+export const WGSL_BINDING_DECLARATION_REGEXES = [
+    new RegExp(`@binding\\(\\s*(auto|\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}@group\\(\\s*(\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}${WGSL_BINDABLE_VARIABLE_PATTERN}`, 'g'),
+    new RegExp(`@group\\(\\s*(\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}@binding\\(\\s*(auto|\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}${WGSL_BINDABLE_VARIABLE_PATTERN}`, 'g')
+];
+export const WGSL_EXPLICIT_BINDING_DECLARATION_REGEXES = [
+    new RegExp(`@binding\\(\\s*(\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}@group\\(\\s*(\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}${WGSL_BINDABLE_VARIABLE_PATTERN}`, 'g'),
+    new RegExp(`@group\\(\\s*(\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}@binding\\(\\s*(\\d+)\\s*\\)${WGSL_BINDING_DECLARATION_SEPARATOR_PATTERN}${WGSL_BINDABLE_VARIABLE_PATTERN}`, 'g')
+];
+const WGSL_AUTO_BINDING_DECLARATION_REGEXES = [
+    new RegExp(`@binding\\(\\s*(auto)\\s*\\)\\s*@group\\(\\s*(\\d+)\\s*\\)\\s*${WGSL_BINDABLE_VARIABLE_PATTERN}`, 'g'),
+    new RegExp(`@group\\(\\s*(\\d+)\\s*\\)\\s*@binding\\(\\s*(auto)\\s*\\)\\s*${WGSL_BINDABLE_VARIABLE_PATTERN}`, 'g'),
+    new RegExp(`@binding\\(\\s*(auto)\\s*\\)\\s*@group\\(\\s*(\\d+)\\s*\\)(?:[\\s\\n\\r]*@[A-Za-z_][^\\n\\r]*)*[\\s\\n\\r]*${WGSL_BINDABLE_VARIABLE_PATTERN}`, 'g'),
+    new RegExp(`@group\\(\\s*(\\d+)\\s*\\)\\s*@binding\\(\\s*(auto)\\s*\\)(?:[\\s\\n\\r]*@[A-Za-z_][^\\n\\r]*)*[\\s\\n\\r]*${WGSL_BINDABLE_VARIABLE_PATTERN}`, 'g')
+];
+export function maskWGSLComments(source) {
+    const maskedCharacters = source.split('');
+    let index = 0;
+    let blockCommentDepth = 0;
+    let inLineComment = false;
+    let inString = false;
+    let isEscaped = false;
+    while (index < source.length) {
+        const character = source[index];
+        const nextCharacter = source[index + 1];
+        if (inString) {
+            if (isEscaped) {
+                isEscaped = false;
+            }
+            else if (character === '\\') {
+                isEscaped = true;
+            }
+            else if (character === '"') {
+                inString = false;
+            }
+            index++;
+            continue;
+        }
+        if (inLineComment) {
+            if (character === '\n' || character === '\r') {
+                inLineComment = false;
+            }
+            else {
+                maskedCharacters[index] = ' ';
+            }
+            index++;
+            continue;
+        }
+        if (blockCommentDepth > 0) {
+            if (character === '/' && nextCharacter === '*') {
+                maskedCharacters[index] = ' ';
+                maskedCharacters[index + 1] = ' ';
+                blockCommentDepth++;
+                index += 2;
+                continue;
+            }
+            if (character === '*' && nextCharacter === '/') {
+                maskedCharacters[index] = ' ';
+                maskedCharacters[index + 1] = ' ';
+                blockCommentDepth--;
+                index += 2;
+                continue;
+            }
+            if (character !== '\n' && character !== '\r') {
+                maskedCharacters[index] = ' ';
+            }
+            index++;
+            continue;
+        }
+        if (character === '"') {
+            inString = true;
+            index++;
+            continue;
+        }
+        if (character === '/' && nextCharacter === '/') {
+            maskedCharacters[index] = ' ';
+            maskedCharacters[index + 1] = ' ';
+            inLineComment = true;
+            index += 2;
+            continue;
+        }
+        if (character === '/' && nextCharacter === '*') {
+            maskedCharacters[index] = ' ';
+            maskedCharacters[index + 1] = ' ';
+            blockCommentDepth = 1;
+            index += 2;
+            continue;
+        }
+        index++;
+    }
+    return maskedCharacters.join('');
+}
+export function getWGSLBindingDeclarationMatches(source, regexes) {
+    const maskedSource = maskWGSLComments(source);
+    const matches = [];
+    for (const regex of regexes) {
+        regex.lastIndex = 0;
+        let match;
+        match = regex.exec(maskedSource);
+        while (match) {
+            const isBindingFirst = regex === regexes[0];
+            const index = match.index;
+            const length = match[0].length;
+            matches.push({
+                match: source.slice(index, index + length),
+                index,
+                length,
+                bindingToken: match[isBindingFirst ? 1 : 2],
+                groupToken: match[isBindingFirst ? 2 : 1],
+                accessDeclaration: match[3]?.trim(),
+                name: match[4]
+            });
+            match = regex.exec(maskedSource);
+        }
+    }
+    return matches.sort((left, right) => left.index - right.index);
+}
+export function replaceWGSLBindingDeclarationMatches(source, regexes, replacer) {
+    const matches = getWGSLBindingDeclarationMatches(source, regexes);
+    if (!matches.length) {
+        return source;
+    }
+    let relocatedSource = '';
+    let lastIndex = 0;
+    for (const match of matches) {
+        relocatedSource += source.slice(lastIndex, match.index);
+        relocatedSource += replacer(match);
+        lastIndex = match.index + match.length;
+    }
+    relocatedSource += source.slice(lastIndex);
+    return relocatedSource;
+}
+export function hasWGSLAutoBinding(source) {
+    return /@binding\(\s*auto\s*\)/.test(maskWGSLComments(source));
+}
+export function getFirstWGSLAutoBindingDeclarationMatch(source, regexes) {
+    const autoBindingRegexes = regexes === MODULE_WGSL_BINDING_DECLARATION_REGEXES ||
+        regexes === WGSL_BINDING_DECLARATION_REGEXES
+        ? WGSL_AUTO_BINDING_DECLARATION_REGEXES
+        : regexes;
+    return getWGSLBindingDeclarationMatches(source, autoBindingRegexes).find(declarationMatch => declarationMatch.bindingToken === 'auto');
+}
+//# sourceMappingURL=wgsl-binding-scan.js.map

package/dist/lib/shader-assembly/wgsl-binding-scan.js.map

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

package/dist/lib/shader-assembly/wgsl-interface-scan.cjs

@@ -0,0 +1,502 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var wgsl_interface_scan_exports = {};
+__export(wgsl_interface_scan_exports, {
+  scanWGSLInterface: () => scanWGSLInterface
+});
+module.exports = __toCommonJS(wgsl_interface_scan_exports);
+var import_wgsl_binding_scan = require("./wgsl-binding-scan.cjs");
+function scanWGSLInterface(source, options = {}) {
+  const tokens = tokenizeWGSL(source);
+  const braceDepths = getBraceDepths(tokens);
+  if (!braceDepths) {
+    return null;
+  }
+  const aliases = scanWGSLAliases(tokens, braceDepths);
+  if (!aliases) {
+    return null;
+  }
+  const bindings = scanWGSLBindings(tokens, braceDepths, aliases);
+  if (!bindings) {
+    return null;
+  }
+  if (options.scanVertexAttributes === false) {
+    return { attributes: [], bindings };
+  }
+  const structures = scanWGSLStructures(tokens, braceDepths);
+  if (!structures) {
+    return null;
+  }
+  const attributes = scanWGSLVertexAttributes(tokens, braceDepths, aliases, structures, options.vertexEntryPoint);
+  return attributes ? { attributes, bindings } : null;
+}
+function tokenizeWGSL(source) {
+  const maskedSource = (0, import_wgsl_binding_scan.maskWGSLComments)(source);
+  const tokenPattern = /[A-Za-z_][A-Za-z0-9_]*|(?:0[xX][0-9A-Fa-f]+|\d+)|[@(){}<>\[\]:,;=]/g;
+  const tokens = [];
+  let match = tokenPattern.exec(maskedSource);
+  while (match) {
+    tokens.push({ value: match[0], index: match.index });
+    match = tokenPattern.exec(maskedSource);
+  }
+  return tokens;
+}
+function getBraceDepths(tokens) {
+  const depths = [];
+  let depth = 0;
+  for (const token of tokens) {
+    if (token.value === "}" && depth === 0) {
+      return null;
+    }
+    depths.push(depth);
+    if (token.value === "{") {
+      depth++;
+    } else if (token.value === "}") {
+      depth--;
+    }
+  }
+  return depth === 0 ? depths : null;
+}
+function scanWGSLAliases(tokens, braceDepths) {
+  var _a, _b;
+  const aliases = /* @__PURE__ */ new Map();
+  for (let tokenIndex = 0; tokenIndex < tokens.length; tokenIndex++) {
+    if (braceDepths[tokenIndex] !== 0 || tokens[tokenIndex].value !== "alias") {
+      continue;
+    }
+    const name = (_a = tokens[tokenIndex + 1]) == null ? void 0 : _a.value;
+    if (!isWGSLIdentifier(name) || ((_b = tokens[tokenIndex + 2]) == null ? void 0 : _b.value) !== "=" || aliases.has(name)) {
+      return null;
+    }
+    const semicolonIndex = findTopLevelToken(tokens, braceDepths, tokenIndex + 3, ";");
+    if (semicolonIndex < 0 || semicolonIndex === tokenIndex + 3) {
+      return null;
+    }
+    aliases.set(name, formatWGSLTokens(tokens.slice(tokenIndex + 3, semicolonIndex)));
+    tokenIndex = semicolonIndex;
+  }
+  return aliases;
+}
+function scanWGSLStructures(tokens, braceDepths) {
+  var _a, _b;
+  const structures = /* @__PURE__ */ new Map();
+  for (let tokenIndex = 0; tokenIndex < tokens.length; tokenIndex++) {
+    if (braceDepths[tokenIndex] !== 0 || tokens[tokenIndex].value !== "struct") {
+      continue;
+    }
+    const name = (_a = tokens[tokenIndex + 1]) == null ? void 0 : _a.value;
+    const openBraceIndex = tokenIndex + 2;
+    if (!isWGSLIdentifier(name) || structures.has(name) || ((_b = tokens[openBraceIndex]) == null ? void 0 : _b.value) !== "{") {
+      return null;
+    }
+    const closeBraceIndex = findMatchingToken(tokens, openBraceIndex, "{", "}");
+    if (closeBraceIndex < 0) {
+      return null;
+    }
+    structures.set(name, tokens.slice(openBraceIndex + 1, closeBraceIndex));
+    tokenIndex = closeBraceIndex;
+  }
+  return structures;
+}
+function scanWGSLBindings(tokens, braceDepths, aliases) {
+  var _a, _b, _c;
+  const bindings = [];
+  const bindingLocations = /* @__PURE__ */ new Set();
+  const bindingNames = /* @__PURE__ */ new Set();
+  for (let tokenIndex = 0; tokenIndex < tokens.length; tokenIndex++) {
+    if (braceDepths[tokenIndex] !== 0 || tokens[tokenIndex].value !== "var") {
+      continue;
+    }
+    const statementStart = findTopLevelStatementStart(tokens, braceDepths, tokenIndex);
+    const attributes = tokens.slice(statementStart, tokenIndex);
+    const group = getNumericWGSLAttribute(attributes, "group");
+    const location = getNumericWGSLAttribute(attributes, "binding");
+    if (group === null || location === null || group === void 0 !== (location === void 0)) {
+      return null;
+    }
+    if (group === void 0 || location === void 0) {
+      continue;
+    }
+    let cursor = tokenIndex + 1;
+    let addressSpace = [];
+    if (((_a = tokens[cursor]) == null ? void 0 : _a.value) === "<") {
+      const closeAngleIndex = findMatchingToken(tokens, cursor, "<", ">");
+      if (closeAngleIndex < 0) {
+        return null;
+      }
+      const addressParts = splitTopLevelTokens(tokens.slice(cursor + 1, closeAngleIndex), ",");
+      if (!addressParts) {
+        return null;
+      }
+      addressSpace = addressParts.map(formatWGSLTokens);
+      cursor = closeAngleIndex + 1;
+    }
+    const name = (_b = tokens[cursor]) == null ? void 0 : _b.value;
+    if (!isWGSLIdentifier(name) || ((_c = tokens[cursor + 1]) == null ? void 0 : _c.value) !== ":") {
+      return null;
+    }
+    const semicolonIndex = findTopLevelToken(tokens, braceDepths, cursor + 2, ";");
+    if (semicolonIndex < 0 || semicolonIndex === cursor + 2) {
+      return null;
+    }
+    const resourceType = resolveWGSLTypeAliases(formatWGSLTokens(tokens.slice(cursor + 2, semicolonIndex)), aliases);
+    if (!resourceType) {
+      return null;
+    }
+    const binding = getWGSLBindingDeclaration({
+      name,
+      group,
+      location,
+      addressSpace,
+      resourceType
+    });
+    const bindingKey = `${group}:${location}`;
+    if (!binding || bindingLocations.has(bindingKey) || bindingNames.has(name)) {
+      return null;
+    }
+    bindings.push(binding);
+    bindingLocations.add(bindingKey);
+    bindingNames.add(name);
+    tokenIndex = semicolonIndex;
+  }
+  normalizeWGSLSamplerBindings(bindings);
+  return bindings.sort((left, right) => left.group - right.group || left.location - right.location || left.name.localeCompare(right.name));
+}
+function getWGSLBindingDeclaration(options) {
+  const { name, group, location, addressSpace, resourceType } = options;
+  const base = { name, group, location };
+  if (addressSpace[0] === "uniform" && addressSpace.length === 1) {
+    return { ...base, type: "uniform" };
+  }
+  if (addressSpace[0] === "storage" && addressSpace.length <= 2) {
+    const access = addressSpace[1] || "read";
+    if (access === "read") {
+      return { ...base, type: "read-only-storage" };
+    }
+    return access === "read_write" ? { ...base, type: "storage" } : null;
+  }
+  if (addressSpace.length > 0) {
+    return null;
+  }
+  if (resourceType === "sampler" || resourceType === "sampler_comparison") {
+    return {
+      ...base,
+      type: "sampler",
+      ...resourceType === "sampler_comparison" ? { samplerType: "comparison" } : {}
+    };
+  }
+  if (resourceType === "texture_external") {
+    return { ...base, type: "external-texture" };
+  }
+  return getWGSLStorageTextureBinding(base, resourceType) || getWGSLTextureBinding(base, resourceType);
+}
+function getWGSLStorageTextureBinding(base, resourceType) {
+  const match = /^texture_storage_(1d|2d|2d_array|3d)<([A-Za-z0-9_]+),(read|write|read_write)>$/.exec(resourceType);
+  if (!match) {
+    return null;
+  }
+  const access = {
+    read: "read-only",
+    write: "write-only",
+    read_write: "read-write"
+  }[match[3]];
+  return {
+    ...base,
+    type: "storage",
+    format: match[2],
+    access,
+    viewDimension: getWGSLTextureViewDimension(match[1])
+  };
+}
+function getWGSLTextureBinding(base, resourceType) {
+  const sampledTexture = /^texture_(multisampled_)?(1d|2d|2d_array|cube|cube_array|3d)<(f32|i32|u32)>$/.exec(resourceType);
+  if (sampledTexture) {
+    if (sampledTexture[1] && sampledTexture[2] !== "2d") {
+      return null;
+    }
+    const sampleType = { f32: "float", i32: "sint", u32: "uint" }[sampledTexture[3]];
+    return {
+      ...base,
+      type: "texture",
+      viewDimension: getWGSLTextureViewDimension(sampledTexture[2]),
+      sampleType,
+      multisampled: Boolean(sampledTexture[1])
+    };
+  }
+  const depthTexture = /^texture_depth_(multisampled_)?(2d|2d_array|cube|cube_array)$/.exec(resourceType);
+  if (!depthTexture || depthTexture[1] && depthTexture[2] !== "2d") {
+    return null;
+  }
+  return {
+    ...base,
+    type: "texture",
+    viewDimension: getWGSLTextureViewDimension(depthTexture[2]),
+    sampleType: "depth",
+    multisampled: Boolean(depthTexture[1])
+  };
+}
+function normalizeWGSLSamplerBindings(bindings) {
+  for (const binding of bindings) {
+    if (binding.type !== "sampler" || binding.samplerType || !binding.name.endsWith("Sampler")) {
+      continue;
+    }
+    const textureName = binding.name.slice(0, -"Sampler".length);
+    const pairedTexture = bindings.find((candidate) => candidate.type === "texture" && candidate.name === textureName && candidate.group === binding.group);
+    if ((pairedTexture == null ? void 0 : pairedTexture.sampleType) === "depth") {
+      binding.samplerType = "non-filtering";
+    }
+  }
+}
+function scanWGSLVertexAttributes(tokens, braceDepths, aliases, structures, vertexEntryPoint) {
+  const functions = scanWGSLFunctions(tokens, braceDepths);
+  if (!functions) {
+    return null;
+  }
+  const vertexFunctions = functions.filter((shaderFunction) => shaderFunction.vertex);
+  const selectedFunction = vertexEntryPoint ? vertexFunctions.find((shaderFunction) => shaderFunction.name === vertexEntryPoint) : vertexFunctions.length === 1 ? vertexFunctions[0] : void 0;
+  if (!selectedFunction) {
+    return vertexFunctions.length === 0 && !vertexEntryPoint ? [] : null;
+  }
+  const parameterDeclarations = splitTopLevelTokens(selectedFunction.parameters, ",");
+  if (!parameterDeclarations) {
+    return null;
+  }
+  const attributes = [];
+  const attributeLocations = /* @__PURE__ */ new Set();
+  const attributeNames = /* @__PURE__ */ new Set();
+  const visitedStructures = /* @__PURE__ */ new Set();
+  for (const declaration of parameterDeclarations) {
+    if (declaration.length > 0 && !scanWGSLVertexInputDeclaration({
+      declaration,
+      aliases,
+      structures,
+      attributes,
+      attributeLocations,
+      attributeNames,
+      visitedStructures
+    })) {
+      return null;
+    }
+  }
+  return attributes.sort((left, right) => left.location - right.location || left.name.localeCompare(right.name));
+}
+function scanWGSLFunctions(tokens, braceDepths) {
+  var _a, _b;
+  const functions = [];
+  const functionNames = /* @__PURE__ */ new Set();
+  for (let tokenIndex = 0; tokenIndex < tokens.length; tokenIndex++) {
+    if (braceDepths[tokenIndex] !== 0 || tokens[tokenIndex].value !== "fn") {
+      continue;
+    }
+    const name = (_a = tokens[tokenIndex + 1]) == null ? void 0 : _a.value;
+    const openParenthesisIndex = tokenIndex + 2;
+    if (!isWGSLIdentifier(name) || functionNames.has(name) || ((_b = tokens[openParenthesisIndex]) == null ? void 0 : _b.value) !== "(") {
+      return null;
+    }
+    const closeParenthesisIndex = findMatchingToken(tokens, openParenthesisIndex, "(", ")");
+    if (closeParenthesisIndex < 0) {
+      return null;
+    }
+    const statementStart = findTopLevelStatementStart(tokens, braceDepths, tokenIndex);
+    functions.push({
+      name,
+      vertex: hasWGSLAttribute(tokens.slice(statementStart, tokenIndex), "vertex"),
+      parameters: tokens.slice(openParenthesisIndex + 1, closeParenthesisIndex)
+    });
+    functionNames.add(name);
+    tokenIndex = closeParenthesisIndex;
+  }
+  return functions;
+}
+function scanWGSLVertexInputDeclaration(options) {
+  const { declaration, aliases, structures, attributes, attributeLocations, attributeNames, visitedStructures } = options;
+  const colonIndex = findTopLevelTokenInSlice(declaration, ":");
+  if (colonIndex < 1 || colonIndex === declaration.length - 1) {
+    return false;
+  }
+  const name = findLastWGSLIdentifier(declaration.slice(0, colonIndex));
+  const location = getNumericWGSLAttribute(declaration.slice(0, colonIndex), "location");
+  const builtin = hasWGSLAttribute(declaration.slice(0, colonIndex), "builtin");
+  const resolvedType = resolveWGSLTypeAliases(formatWGSLTokens(declaration.slice(colonIndex + 1)), aliases);
+  if (!name || location === null || !resolvedType || location !== void 0 && builtin) {
+    return false;
+  }
+  if (location !== void 0) {
+    const attributeType = getWGSLAttributeShaderType(resolvedType);
+    if (!attributeType || attributeLocations.has(location) || attributeNames.has(name)) {
+      return false;
+    }
+    attributes.push({ name, location, type: attributeType });
+    attributeLocations.add(location);
+    attributeNames.add(name);
+    return true;
+  }
+  if (builtin) {
+    return true;
+  }
+  const structureMembers = structures.get(resolvedType);
+  if (!structureMembers || visitedStructures.has(resolvedType)) {
+    return false;
+  }
+  const memberDeclarations = splitTopLevelTokens(structureMembers, ",");
+  if (!memberDeclarations) {
+    return false;
+  }
+  visitedStructures.add(resolvedType);
+  for (const memberDeclaration of memberDeclarations) {
+    if (memberDeclaration.length > 0 && !scanWGSLVertexInputDeclaration({ ...options, declaration: memberDeclaration })) {
+      return false;
+    }
+  }
+  visitedStructures.delete(resolvedType);
+  return true;
+}
+function resolveWGSLTypeAliases(type, aliases, resolvingAliases = /* @__PURE__ */ new Set()) {
+  const tokens = tokenizeWGSL(type);
+  let resolvedType = "";
+  for (const token of tokens) {
+    const alias = aliases.get(token.value);
+    if (!alias) {
+      resolvedType += normalizeWGSLBuiltinTypeAlias(token.value);
+      continue;
+    }
+    if (resolvingAliases.has(token.value)) {
+      return null;
+    }
+    const nextResolvingAliases = new Set(resolvingAliases);
+    nextResolvingAliases.add(token.value);
+    const resolvedAlias = resolveWGSLTypeAliases(alias, aliases, nextResolvingAliases);
+    if (!resolvedAlias) {
+      return null;
+    }
+    resolvedType += resolvedAlias;
+  }
+  return resolvedType;
+}
+function normalizeWGSLBuiltinTypeAlias(type) {
+  const aliasMatch = /^(vec[234]|mat[234]x[234])([fiuh])$/.exec(type);
+  if (!aliasMatch) {
+    return type;
+  }
+  const primitiveType = { f: "f32", i: "i32", u: "u32", h: "f16" }[aliasMatch[2]];
+  return `${aliasMatch[1]}<${primitiveType}>`;
+}
+function getWGSLAttributeShaderType(type) {
+  return /^(?:i32|u32|f32|f16|vec[234]<(?:i32|u32|f32|f16)>)$/.test(type) ? type : null;
+}
+function getNumericWGSLAttribute(tokens, name) {
+  var _a, _b, _c, _d;
+  let value;
+  for (let tokenIndex = 0; tokenIndex < tokens.length; tokenIndex++) {
+    if (tokens[tokenIndex].value !== "@" || ((_a = tokens[tokenIndex + 1]) == null ? void 0 : _a.value) !== name) {
+      continue;
+    }
+    if (value !== void 0 || ((_b = tokens[tokenIndex + 2]) == null ? void 0 : _b.value) !== "(" || !/^\d+$/.test(((_c = tokens[tokenIndex + 3]) == null ? void 0 : _c.value) || "") || ((_d = tokens[tokenIndex + 4]) == null ? void 0 : _d.value) !== ")") {
+      return null;
+    }
+    value = Number(tokens[tokenIndex + 3].value);
+  }
+  return value;
+}
+function hasWGSLAttribute(tokens, name) {
+  return tokens.some((token, tokenIndex) => {
+    var _a;
+    return token.value === "@" && ((_a = tokens[tokenIndex + 1]) == null ? void 0 : _a.value) === name;
+  });
+}
+function getWGSLTextureViewDimension(dimension) {
+  return dimension.replace("_", "-");
+}
+function findMatchingToken(tokens, openTokenIndex, openValue, closeValue) {
+  let depth = 0;
+  for (let tokenIndex = openTokenIndex; tokenIndex < tokens.length; tokenIndex++) {
+    if (tokens[tokenIndex].value === openValue) {
+      depth++;
+    } else if (tokens[tokenIndex].value === closeValue && --depth === 0) {
+      return tokenIndex;
+    }
+  }
+  return -1;
+}
+function splitTopLevelTokens(tokens, delimiter) {
+  const parts = [];
+  let partStart = 0;
+  const delimiterDepths = { "(": 0, "<": 0, "[": 0, "{": 0 };
+  const openingValues = Object.keys(delimiterDepths);
+  const closingToOpening = { ")": "(", ">": "<", "]": "[", "}": "{" };
+  for (let tokenIndex = 0; tokenIndex < tokens.length; tokenIndex++) {
+    const value = tokens[tokenIndex].value;
+    if (value === delimiter && openingValues.every((opening) => delimiterDepths[opening] === 0)) {
+      parts.push(tokens.slice(partStart, tokenIndex));
+      partStart = tokenIndex + 1;
+      continue;
+    }
+    if (value in delimiterDepths) {
+      delimiterDepths[value]++;
+    } else if (value in closingToOpening) {
+      const opening = closingToOpening[value];
+      delimiterDepths[opening]--;
+      if (delimiterDepths[opening] < 0) {
+        return null;
+      }
+    }
+  }
+  if (!openingValues.every((opening) => delimiterDepths[opening] === 0)) {
+    return null;
+  }
+  parts.push(tokens.slice(partStart));
+  return parts;
+}
+function findTopLevelTokenInSlice(tokens, value) {
+  const parts = splitTopLevelTokens(tokens, value);
+  return parts && parts.length === 2 ? parts[0].length : -1;
+}
+function findTopLevelToken(tokens, braceDepths, startIndex, value) {
+  for (let tokenIndex = startIndex; tokenIndex < tokens.length; tokenIndex++) {
+    if (braceDepths[tokenIndex] === 0 && tokens[tokenIndex].value === value) {
+      return tokenIndex;
+    }
+  }
+  return -1;
+}
+function findTopLevelStatementStart(tokens, braceDepths, beforeIndex) {
+  for (let tokenIndex = beforeIndex - 1; tokenIndex >= 0; tokenIndex--) {
+    if (tokens[tokenIndex].value === ";" && braceDepths[tokenIndex] === 0 || tokens[tokenIndex].value === "}" && braceDepths[tokenIndex] === 1) {
+      return tokenIndex + 1;
+    }
+  }
+  return 0;
+}
+function findLastWGSLIdentifier(tokens) {
+  for (let tokenIndex = tokens.length - 1; tokenIndex >= 0; tokenIndex--) {
+    if (isWGSLIdentifier(tokens[tokenIndex].value)) {
+      return tokens[tokenIndex].value;
+    }
+  }
+  return null;
+}
+function formatWGSLTokens(tokens) {
+  return tokens.map((token) => token.value).join("");
+}
+function isWGSLIdentifier(value) {
+  return Boolean(value && /^[A-Za-z_][A-Za-z0-9_]*$/.test(value));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  scanWGSLInterface
+});

package/dist/lib/shader-assembly/wgsl-interface-scan.d.ts

@@ -0,0 +1,14 @@
+import type { ShaderLayout } from "../../types.js";
+export type ScanWGSLInterfaceOptions = {
+    /** Selected render-pipeline vertex entry point. Required when WGSL declares multiple vertices. */
+    vertexEntryPoint?: string;
+    /** Whether to scan vertex attributes. Disable for compute pipelines that only need bindings. */
+    scanVertexAttributes?: boolean;
+};
+/**
+ * Scans the pipeline interface needed to create a WebGPU shader layout without a full WGSL parser.
+ * Returns `null` when an interface is ambiguous or uses unsupported syntax, signaling that the
+ * caller must provide an explicit layout.
+ */
+export declare function scanWGSLInterface(source: string, options?: ScanWGSLInterfaceOptions): ShaderLayout | null;
+//# sourceMappingURL=wgsl-interface-scan.d.ts.map

package/dist/lib/shader-assembly/wgsl-interface-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgsl-interface-scan.d.ts","sourceRoot":"","sources":["../../../src/lib/shader-assembly/wgsl-interface-scan.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAKV,YAAY,EAIb,uBAAoB;AAIrB,MAAM,MAAM,wBAAwB,GAAG;IACrC,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAaF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,YAAY,GAAG,IAAI,CAgCrB"}