@hyperframes/lint 0.8.159 → 0.8.160

package/dist/browser.js

@@ -1495,10 +1495,10 @@ var coreRules = [
       }
     ];
     for (const script of scripts) {
-      const withoutComments = stripJsComments(script.content);
-      const executable = stripStringLiterals(withoutComments);
+      const withoutComments2 = stripJsComments(script.content);
+      const executable = stripStringLiterals(withoutComments2);
       for (const { pattern, label, hint, scansStrings } of patterns) {
-        const match = pattern.exec(scansStrings ? withoutComments : executable);
+        const match = pattern.exec(scansStrings ? withoutComments2 : executable);
         if (match) {
           findings.push({
             ...locate(script, match.index),
@@ -3878,8 +3878,8 @@ function collectStaticCssVariableDefinitions(tags, styles) {
   ];
   const definitionPattern = /(?:^|[;{])\s*(--[A-Za-z0-9_-]+)\s*:/gm;
   for (const source of sources) {
-    const withoutComments = source.replace(/\/\*[\s\S]*?\*\//g, " ");
-    for (const match of withoutComments.matchAll(definitionPattern)) {
+    const withoutComments2 = source.replace(/\/\*[\s\S]*?\*\//g, " ");
+    for (const match of withoutComments2.matchAll(definitionPattern)) {
       if (match[1]) definitions.add(match[1]);
     }
   }
@@ -4073,8 +4073,8 @@ function targetedSelectorTokens(selector) {
     const compounds = group.trim().split(/[\s>+~]+/).filter(Boolean);
     const last = compounds[compounds.length - 1];
     if (!last) continue;
-    const simple2 = last.match(/[#.][A-Za-z0-9_-]+/g);
-    if (simple2) for (const token of simple2) tokens.add(token);
+    const simple3 = last.match(/[#.][A-Za-z0-9_-]+/g);
+    if (simple3) for (const token of simple3) tokens.add(token);
   }
   return tokens;
 }
@@ -4276,8 +4276,8 @@ function firstParamMemberAccessHazard(fn) {
   while ((match = pattern.exec(fn.body)) !== null) {
     const member = match[1] ?? "";
     const after = fn.body.slice(match.index + match[0].length);
-    const isCall = /^\s*\(/.test(after);
-    if (isCall && NUMBER_METHODS.has(member)) continue;
+    const isCall2 = /^\s*\(/.test(after);
+    if (isCall2 && NUMBER_METHODS.has(member)) continue;
     return member;
   }
   return null;
@@ -6367,6 +6367,116 @@ var structureRules = [
   }
 ];
 
+// src/shaderDomains.ts
+import { parse as parse3, parseExpressionAt } from "acorn";
+import { simple as simple2 } from "acorn-walk";
+function withoutComments(source) {
+  return source.replace(/\/\*[\s\S]*?\*\/|\/\/[^\r\n]*/g, (text) => text.replace(/[^\r\n]/g, " "));
+}
+function staticShaders(source) {
+  const shaders = [];
+  try {
+    const ast = parse3(source, {
+      ecmaVersion: "latest",
+      sourceType: "module",
+      allowReturnOutsideFunction: true
+    });
+    simple2(ast, {
+      Literal(node) {
+        if (typeof node.value !== "string") return;
+        shaders.push({
+          text: node.value,
+          start: node.start + 1,
+          exactOffsets: source.slice(node.start + 1, node.end - 1) === node.value
+        });
+      },
+      TemplateLiteral(node) {
+        if (node.expressions.length !== 0) return;
+        const value = node.quasis[0]?.value;
+        if (value?.cooked == null) return;
+        shaders.push({
+          text: value.cooked,
+          start: node.start + 1,
+          exactOffsets: source.slice(node.start + 1, node.end - 1) === value.cooked
+        });
+      }
+    });
+  } catch {
+  }
+  return shaders.filter(({ text }) => /\bvoid\s+main\s*\(/.test(withoutComments(text)));
+}
+function isNumber(node, value) {
+  return node?.type === "Literal" && node.value === value;
+}
+function isCall(node, name) {
+  return node?.type === "CallExpression" && node.callee.type === "Identifier" && node.callee.name === name;
+}
+function unboundedCosine(node) {
+  if (node.type !== "CallExpression") return false;
+  if (isCall(node, "dot")) return node.arguments.length === 2;
+  if (!isCall(node, "max") || node.arguments.length !== 2) return false;
+  const a = argumentAt(node, 0);
+  const b = argumentAt(node, 1);
+  return zeroFlooredDot(a, b) || zeroFlooredDot(b, a);
+}
+function argumentAt(call, index) {
+  const node = call.arguments[index];
+  return node?.type === "SpreadElement" ? void 0 : node;
+}
+function zeroFlooredDot(a, b) {
+  return isCall(a, "dot") && isNumber(b, 0);
+}
+function unsafeCosinePower(call) {
+  if (call.arguments.length !== 2) return false;
+  const [base] = call.arguments;
+  return base?.type === "BinaryExpression" && base.operator === "-" && base.left.type !== "PrivateIdentifier" && isNumber(base.left, 1) && unboundedCosine(base.right);
+}
+function unsafePowOffsets(source) {
+  const offsets = [];
+  const masked = withoutComments(source);
+  for (const match of masked.matchAll(/\bpow\s*\(/g)) {
+    try {
+      const expression = parseExpressionAt(masked, match.index, { ecmaVersion: "latest" });
+      simple2(expression, {
+        CallExpression(node) {
+          if (node.start === match.index && unsafeCosinePower(node)) offsets.push(node.start);
+        }
+      });
+    } catch {
+    }
+  }
+  return offsets;
+}
+function shaderDomainOffsets(source, glsl = false) {
+  const shaders = glsl ? [{ text: source, start: 0, exactOffsets: true }] : staticShaders(source);
+  return shaders.flatMap(
+    ({ text, start, exactOffsets }) => unsafePowOffsets(text).map((offset) => exactOffsets ? start + offset : void 0)
+  );
+}
+
+// src/rules/shaders.ts
+function shaderDomainWarning() {
+  return {
+    code: "shader_unbounded_cosine_pow",
+    severity: "warning",
+    message: "Shader pow(1 - dot(...), ...) can receive a negative base when the cosine exceeds 1, including through GPU rounding. Undefined GLSL results can spread through glow or transmission textures as black artifacts.",
+    fixHint: "Bound the cosine on both sides: pow(1.0 - clamp(dot(normal, view), 0.0, 1.0), exponent). A lower-only max(dot(...), 0.0) does not bound the upper end. Inspect the affected frames on the target GPU."
+  };
+}
+var shaderRules = [
+  ({ scripts, locate }) => scripts.flatMap((script) => {
+    const tag = `<script ${script.attrs}>`;
+    if (readAttr(tag, "src") !== null) return [];
+    const type = readAttr(tag, "type") ?? "";
+    const glsl = /^(?:x-shader\/x-(?:fragment|vertex)|text\/glsl)$/i.test(type);
+    if (type && !glsl && !/^(?:module|(?:text|application)\/javascript)$/i.test(type)) return [];
+    return shaderDomainOffsets(script.content, glsl).map((offset) => ({
+      ...shaderDomainWarning(),
+      ...locate(script, offset)
+    }));
+  })
+];
+
 // src/hyperframeLinter.ts
 var RULE_GROUPS = [
   { group: "core", rules: coreRules },
@@ -6378,7 +6488,8 @@ var RULE_GROUPS = [
   { group: "textures", rules: textureRules },
   { group: "fonts", rules: fontRules },
   { group: "slideshow", rules: slideshowRules },
-  { group: "structure", rules: structureRules }
+  { group: "structure", rules: structureRules },
+  { group: "shaders", rules: shaderRules }
 ];
 var LINT_RULE_COUNT = RULE_GROUPS.reduce((n, g) => n + g.rules.length, 0);
 var LINT_RULE_GROUP_COUNTS = Object.fromEntries(
@@ -6390,7 +6501,8 @@ function dedupeKeyFor(finding) {
     finding.severity,
     finding.selector || "",
     finding.elementId || "",
-    finding.message
+    finding.message,
+    ...finding.code === "shader_unbounded_cosine_pow" ? [finding.line, finding.column] : []
   ].join("|");
 }
 async function runRules(ctx, filePath) {
@@ -6428,7 +6540,7 @@ async function lintHyperframeHtml(html, options = {}) {
   const { findings: rawFindings, timings } = await runRules(ctx, options.filePath);
   const locate = createSourceLocator(html);
   const findings = rawFindings.map((finding) => {
-    if (finding.line !== void 0 || finding.code === "invalid_inline_script_syntax" || finding.code === "non_deterministic_code" || [
+    if (finding.line !== void 0 || finding.code === "shader_unbounded_cosine_pow" || finding.code === "invalid_inline_script_syntax" || finding.code === "non_deterministic_code" || [
       "gsap_infinite_repeat",
       "gsap_repeat_ceil_overshoot",
       "gsap_repeat_floor_unclamped"

package/dist/index.js

@@ -1501,10 +1501,10 @@ var coreRules = [
       }
     ];
     for (const script of scripts) {
-      const withoutComments = stripJsComments(script.content);
-      const executable = stripStringLiterals(withoutComments);
+      const withoutComments2 = stripJsComments(script.content);
+      const executable = stripStringLiterals(withoutComments2);
       for (const { pattern, label, hint, scansStrings } of patterns) {
-        const match = pattern.exec(scansStrings ? withoutComments : executable);
+        const match = pattern.exec(scansStrings ? withoutComments2 : executable);
         if (match) {
           findings.push({
             ...locate(script, match.index),
@@ -3884,8 +3884,8 @@ function collectStaticCssVariableDefinitions(tags, styles) {
   ];
   const definitionPattern = /(?:^|[;{])\s*(--[A-Za-z0-9_-]+)\s*:/gm;
   for (const source of sources) {
-    const withoutComments = source.replace(/\/\*[\s\S]*?\*\//g, " ");
-    for (const match of withoutComments.matchAll(definitionPattern)) {
+    const withoutComments2 = source.replace(/\/\*[\s\S]*?\*\//g, " ");
+    for (const match of withoutComments2.matchAll(definitionPattern)) {
       if (match[1]) definitions.add(match[1]);
     }
   }
@@ -4079,8 +4079,8 @@ function targetedSelectorTokens(selector) {
     const compounds = group.trim().split(/[\s>+~]+/).filter(Boolean);
     const last = compounds[compounds.length - 1];
     if (!last) continue;
-    const simple2 = last.match(/[#.][A-Za-z0-9_-]+/g);
-    if (simple2) for (const token of simple2) tokens.add(token);
+    const simple3 = last.match(/[#.][A-Za-z0-9_-]+/g);
+    if (simple3) for (const token of simple3) tokens.add(token);
   }
   return tokens;
 }
@@ -4282,8 +4282,8 @@ function firstParamMemberAccessHazard(fn) {
   while ((match = pattern.exec(fn.body)) !== null) {
     const member = match[1] ?? "";
     const after = fn.body.slice(match.index + match[0].length);
-    const isCall = /^\s*\(/.test(after);
-    if (isCall && NUMBER_METHODS.has(member)) continue;
+    const isCall2 = /^\s*\(/.test(after);
+    if (isCall2 && NUMBER_METHODS.has(member)) continue;
     return member;
   }
   return null;
@@ -6373,6 +6373,116 @@ var structureRules = [
   }
 ];
 
+// src/shaderDomains.ts
+import { parse as parse3, parseExpressionAt } from "acorn";
+import { simple as simple2 } from "acorn-walk";
+function withoutComments(source) {
+  return source.replace(/\/\*[\s\S]*?\*\/|\/\/[^\r\n]*/g, (text) => text.replace(/[^\r\n]/g, " "));
+}
+function staticShaders(source) {
+  const shaders = [];
+  try {
+    const ast = parse3(source, {
+      ecmaVersion: "latest",
+      sourceType: "module",
+      allowReturnOutsideFunction: true
+    });
+    simple2(ast, {
+      Literal(node) {
+        if (typeof node.value !== "string") return;
+        shaders.push({
+          text: node.value,
+          start: node.start + 1,
+          exactOffsets: source.slice(node.start + 1, node.end - 1) === node.value
+        });
+      },
+      TemplateLiteral(node) {
+        if (node.expressions.length !== 0) return;
+        const value = node.quasis[0]?.value;
+        if (value?.cooked == null) return;
+        shaders.push({
+          text: value.cooked,
+          start: node.start + 1,
+          exactOffsets: source.slice(node.start + 1, node.end - 1) === value.cooked
+        });
+      }
+    });
+  } catch {
+  }
+  return shaders.filter(({ text }) => /\bvoid\s+main\s*\(/.test(withoutComments(text)));
+}
+function isNumber(node, value) {
+  return node?.type === "Literal" && node.value === value;
+}
+function isCall(node, name) {
+  return node?.type === "CallExpression" && node.callee.type === "Identifier" && node.callee.name === name;
+}
+function unboundedCosine(node) {
+  if (node.type !== "CallExpression") return false;
+  if (isCall(node, "dot")) return node.arguments.length === 2;
+  if (!isCall(node, "max") || node.arguments.length !== 2) return false;
+  const a = argumentAt(node, 0);
+  const b = argumentAt(node, 1);
+  return zeroFlooredDot(a, b) || zeroFlooredDot(b, a);
+}
+function argumentAt(call, index) {
+  const node = call.arguments[index];
+  return node?.type === "SpreadElement" ? void 0 : node;
+}
+function zeroFlooredDot(a, b) {
+  return isCall(a, "dot") && isNumber(b, 0);
+}
+function unsafeCosinePower(call) {
+  if (call.arguments.length !== 2) return false;
+  const [base] = call.arguments;
+  return base?.type === "BinaryExpression" && base.operator === "-" && base.left.type !== "PrivateIdentifier" && isNumber(base.left, 1) && unboundedCosine(base.right);
+}
+function unsafePowOffsets(source) {
+  const offsets = [];
+  const masked = withoutComments(source);
+  for (const match of masked.matchAll(/\bpow\s*\(/g)) {
+    try {
+      const expression = parseExpressionAt(masked, match.index, { ecmaVersion: "latest" });
+      simple2(expression, {
+        CallExpression(node) {
+          if (node.start === match.index && unsafeCosinePower(node)) offsets.push(node.start);
+        }
+      });
+    } catch {
+    }
+  }
+  return offsets;
+}
+function shaderDomainOffsets(source, glsl = false) {
+  const shaders = glsl ? [{ text: source, start: 0, exactOffsets: true }] : staticShaders(source);
+  return shaders.flatMap(
+    ({ text, start, exactOffsets }) => unsafePowOffsets(text).map((offset) => exactOffsets ? start + offset : void 0)
+  );
+}
+
+// src/rules/shaders.ts
+function shaderDomainWarning() {
+  return {
+    code: "shader_unbounded_cosine_pow",
+    severity: "warning",
+    message: "Shader pow(1 - dot(...), ...) can receive a negative base when the cosine exceeds 1, including through GPU rounding. Undefined GLSL results can spread through glow or transmission textures as black artifacts.",
+    fixHint: "Bound the cosine on both sides: pow(1.0 - clamp(dot(normal, view), 0.0, 1.0), exponent). A lower-only max(dot(...), 0.0) does not bound the upper end. Inspect the affected frames on the target GPU."
+  };
+}
+var shaderRules = [
+  ({ scripts, locate }) => scripts.flatMap((script) => {
+    const tag = `<script ${script.attrs}>`;
+    if (readAttr(tag, "src") !== null) return [];
+    const type = readAttr(tag, "type") ?? "";
+    const glsl = /^(?:x-shader\/x-(?:fragment|vertex)|text\/glsl)$/i.test(type);
+    if (type && !glsl && !/^(?:module|(?:text|application)\/javascript)$/i.test(type)) return [];
+    return shaderDomainOffsets(script.content, glsl).map((offset) => ({
+      ...shaderDomainWarning(),
+      ...locate(script, offset)
+    }));
+  })
+];
+
 // src/hyperframeLinter.ts
 var RULE_GROUPS = [
   { group: "core", rules: coreRules },
@@ -6384,7 +6494,8 @@ var RULE_GROUPS = [
   { group: "textures", rules: textureRules },
   { group: "fonts", rules: fontRules },
   { group: "slideshow", rules: slideshowRules },
-  { group: "structure", rules: structureRules }
+  { group: "structure", rules: structureRules },
+  { group: "shaders", rules: shaderRules }
 ];
 var LINT_RULE_COUNT = RULE_GROUPS.reduce((n, g) => n + g.rules.length, 0);
 var LINT_RULE_GROUP_COUNTS = Object.fromEntries(
@@ -6396,7 +6507,8 @@ function dedupeKeyFor(finding) {
     finding.severity,
     finding.selector || "",
     finding.elementId || "",
-    finding.message
+    finding.message,
+    ...finding.code === "shader_unbounded_cosine_pow" ? [finding.line, finding.column] : []
   ].join("|");
 }
 async function runRules(ctx, filePath) {
@@ -6434,7 +6546,7 @@ async function lintHyperframeHtml(html, options = {}) {
   const { findings: rawFindings, timings } = await runRules(ctx, options.filePath);
   const locate = createSourceLocator(html);
   const findings = rawFindings.map((finding) => {
-    if (finding.line !== void 0 || finding.code === "invalid_inline_script_syntax" || finding.code === "non_deterministic_code" || [
+    if (finding.line !== void 0 || finding.code === "shader_unbounded_cosine_pow" || finding.code === "invalid_inline_script_syntax" || finding.code === "non_deterministic_code" || [
       "gsap_infinite_repeat",
       "gsap_repeat_ceil_overshoot",
       "gsap_repeat_floor_unclamped"
@@ -6530,7 +6642,7 @@ function shouldBlockRender(strictErrors, strictAll, totalErrors, totalWarnings)
 // src/project.ts
 import { createHash } from "crypto";
 import { existsSync as existsSync2, readFileSync, readdirSync } from "fs";
-import { dirname, extname, join as join2, relative, resolve } from "path";
+import { dirname as dirname2, extname, join as join3, relative as relative2, resolve } from "path";
 import { rewriteAssetPath as rewriteAssetPath2 } from "@hyperframes/parsers/asset-paths";
 import { checkSubCompositionUsability } from "@hyperframes/parsers/sub-composition-validity";
 import { parseHTML as parseHTML3 } from "linkedom";
@@ -6539,10 +6651,10 @@ import {
   collectSubCompositionSrcs,
   isRemoteOrInlineUrl as isRemoteOrInlineUrl2,
   isUnresolvedAssetPlaceholder as isUnresolvedAssetPlaceholder2,
-  isWithinProjectRoot,
+  isWithinProjectRoot as isWithinProjectRoot2,
   maskNonScannableRanges as maskNonScannableRanges2,
-  readProjectFile,
-  resolveExistingLocalAsset as resolveExistingLocalAsset2,
+  readProjectFile as readProjectFile2,
+  resolveExistingLocalAsset as resolveExistingLocalAsset3,
   resolveLocalAssetCandidates,
   resolveProjectRelativeSrc
 } from "@hyperframes/parsers/asset-resolution";
@@ -6783,6 +6895,60 @@ async function lintHevcPreviewCodec(candidates) {
   ];
 }
 
+// src/projectShaders.ts
+import { realpathSync } from "fs";
+import { dirname, join as join2, relative } from "path";
+import {
+  isWithinProjectRoot,
+  readProjectFile,
+  resolveExistingLocalAsset as resolveExistingLocalAsset2
+} from "@hyperframes/parsers/asset-resolution";
+function isAuthoredScript(path) {
+  return /\.(?:js|mjs|cjs)$/i.test(path) && !/(?:\.min\.js$|(?:^|[/\\])(?:vendor|node_modules)[/\\])/i.test(path);
+}
+function localScript(projectDir, src, compSrcPath) {
+  if (/^(?:[a-z][a-z\d+.-]*:|\/\/|#)/i.test(src)) return;
+  const besideFile = src.startsWith("/") ? src : join2(dirname(compSrcPath ?? "index.html"), src);
+  const asset = resolveExistingLocalAsset2(projectDir, besideFile);
+  if (!asset) return;
+  try {
+    const file = realpathSync(asset.resolved);
+    if (!isWithinProjectRoot(realpathSync(projectDir), file)) return;
+    if (!isAuthoredScript(relative(projectDir, file))) return;
+    return file;
+  } catch {
+    return;
+  }
+}
+function linkedScripts(projectDir, { html, compSrcPath }) {
+  const files = [];
+  for (const script of parseHtmlStructure(html).scripts) {
+    const tag = `<script ${script.attrs}>`;
+    const type = readDecodedAttr(tag, "type") ?? "";
+    if (type && !/^(?:module|(?:text|application)\/javascript)$/i.test(type)) continue;
+    const src = readDecodedAttr(tag, "src");
+    if (!src) continue;
+    const file = localScript(projectDir, src, compSrcPath);
+    if (file) files.push(file);
+  }
+  return files;
+}
+function lintProjectShaderScripts(projectDir, sources) {
+  const files = new Set(sources.flatMap((source) => linkedScripts(projectDir, source)));
+  const findings = [];
+  for (const file of files) {
+    const read = readProjectFile(file);
+    if (read.kind !== "file") continue;
+    for (const offset of shaderDomainOffsets(read.text)) {
+      findings.push({
+        ...shaderDomainWarning(),
+        ...offset === void 0 ? { file } : sourcePosition(read.text, offset, file)
+      });
+    }
+  }
+  return findings;
+}
+
 // src/project.ts
 function parseSubCompHtml(html) {
   return parseHTML3(html).document;
@@ -6814,10 +6980,10 @@ function collectLocalStylesheets(projectDir, document, compSrcPath) {
     if (!rel.split(/\s+/).some((part) => part.toLowerCase() === "stylesheet")) continue;
     const href = link.getAttribute("href") ?? "";
     if (!isLocalStylesheetHref(href)) continue;
-    const besideFile = compSrcPath ? join2(dirname(compSrcPath), href) : href;
-    const stylesheet = resolveExistingLocalAsset2(projectDir, besideFile) ?? (compSrcPath && staysInsideProjectRoot(href) ? resolveExistingLocalAsset2(projectDir, href) : null);
+    const besideFile = compSrcPath ? join3(dirname2(compSrcPath), href) : href;
+    const stylesheet = resolveExistingLocalAsset3(projectDir, besideFile) ?? (compSrcPath && staysInsideProjectRoot(href) ? resolveExistingLocalAsset3(projectDir, href) : null);
     if (!stylesheet) continue;
-    const read = readProjectFile(stylesheet.resolved);
+    const read = readProjectFile2(stylesheet.resolved);
     if (read.kind !== "file") continue;
     styles.push({ href, content: read.text, rootRelativePath: stylesheet.rootRelativePath });
   }
@@ -6831,7 +6997,7 @@ function collectExternalStyles(projectDir, html, compSrcPath) {
     document,
     compSrcPath
   )) {
-    styles.push({ href, content, file: join2(projectDir, rootRelativePath), rootRelativePath });
+    styles.push({ href, content, file: join3(projectDir, rootRelativePath), rootRelativePath });
   }
   return styles;
 }
@@ -6858,22 +7024,22 @@ function collectCssSources(projectDir, html, compSrcPath) {
 function resolveCssAssetCandidates(projectDir, url, htmlCompSrcPath, cssRootRelativePath) {
   if (url.startsWith("/")) return resolveLocalAssetCandidates(projectDir, url);
   if (cssRootRelativePath) {
-    return resolveLocalAssetCandidates(projectDir, join2(dirname(cssRootRelativePath), url));
+    return resolveLocalAssetCandidates(projectDir, join3(dirname2(cssRootRelativePath), url));
   }
   if (htmlCompSrcPath) {
     return resolveLocalAssetCandidates(
       projectDir,
-      rewriteAssetPath2(htmlCompSrcPath, url, (path) => existsSync2(join2(projectDir, path)))
+      rewriteAssetPath2(htmlCompSrcPath, url, (path) => existsSync2(join3(projectDir, path)))
     );
   }
   return resolveLocalAssetCandidates(projectDir, url);
 }
 async function lintProject(projectDir, entryFile, hostOptions = {}) {
   const indexPath = entryFile ? resolve(entryFile) : resolve(projectDir, "index.html");
-  if (entryFile && !isWithinProjectRoot(projectDir, indexPath)) {
+  if (entryFile && !isWithinProjectRoot2(projectDir, indexPath)) {
     throw new Error(`Explicit lint entry is outside the project directory: ${entryFile}`);
   }
-  const rootFile = relative(resolve(projectDir), indexPath).replace(/\\/g, "/") || "index.html";
+  const rootFile = relative2(resolve(projectDir), indexPath).replace(/\\/g, "/") || "index.html";
   const rootCompSrcPath = rootFile === "index.html" ? void 0 : rootFile;
   const results = [];
   let totalErrors = 0;
@@ -6899,7 +7065,7 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
         const relPath = rel ? `${rel}/${entry.name}` : entry.name;
         if (entry.isDirectory()) {
           if (!rel && entry.name === "components") continue;
-          out.push(...collectHtmlFiles(join2(dir, entry.name), relPath));
+          out.push(...collectHtmlFiles(join3(dir, entry.name), relPath));
         } else if (entry.isFile() && entry.name.endsWith(".html") && !entry.name.startsWith("._")) {
           out.push(relPath);
         }
@@ -6908,7 +7074,7 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
     };
     const files = collectHtmlFiles(compositionsDir, "").sort();
     for (const file of files) {
-      const filePath = join2(compositionsDir, file);
+      const filePath = join3(compositionsDir, file);
       const html = readFileSync(filePath, "utf-8");
       const compSrcPath = `compositions/${file}`;
       allHtmlSources.push({ html, compSrcPath });
@@ -6931,6 +7097,7 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
     }
   }
   const projectFindings = [
+    ...lintProjectShaderScripts(projectDir, allHtmlSources),
     ...lintProjectAudioFiles(projectDir, allHtmlSources),
     ...lintAudioSrcNotFound(projectDir, allHtmlSources),
     ...lintMissingLocalAsset(projectDir, allHtmlSources),
@@ -7026,7 +7193,7 @@ function lintAudioSrcNotFound(projectDir, htmlSources) {
       const src = mediaSrcOf(match);
       if (/^(https?:|data:|blob:)/i.test(src)) continue;
       if (isUnresolvedAssetPlaceholder2(src)) continue;
-      const rootRelative = compSrcPath ? rewriteAssetPath2(compSrcPath, src, (path) => existsSync2(join2(projectDir, path))) : src;
+      const rootRelative = compSrcPath ? rewriteAssetPath2(compSrcPath, src, (path) => existsSync2(join3(projectDir, path))) : src;
       if (!existsSync2(resolveProjectRelativeSrc(rootRelative, projectDir))) {
         const file = sourceFile(projectDir, compSrcPath);
         missingByFile.set(file, (missingByFile.get(file) ?? /* @__PURE__ */ new Set()).add(src));
@@ -7060,8 +7227,8 @@ function lintMissingLocalAsset(projectDir, htmlSources) {
       const src = cleanAssetUrl2(rawSrc);
       if (!src) continue;
       if (isRemoteOrInlineUrl2(src)) continue;
-      const rootRelative = compSrcPath ? rewriteAssetPath2(compSrcPath, src, (path) => existsSync2(join2(projectDir, path))) : src;
-      const resolvedAsset = resolveExistingLocalAsset2(projectDir, rootRelative);
+      const rootRelative = compSrcPath ? rewriteAssetPath2(compSrcPath, src, (path) => existsSync2(join3(projectDir, path))) : src;
+      const resolvedAsset = resolveExistingLocalAsset3(projectDir, rootRelative);
       if (resolvedAsset) continue;
       const resolvedKey = resolve(projectDir, rootRelative);
       const file = sourceFile(projectDir, compSrcPath);
@@ -7129,7 +7296,7 @@ function lintMultipleRootCompositions(projectDir) {
     const rootCompositions = [];
     for (const file of rootHtmlFiles) {
       if (file === "caption-skin.html") continue;
-      const content = readFileSync(join2(projectDir, file), "utf-8");
+      const content = readFileSync(join3(projectDir, file), "utf-8");
       if (/data-composition-id/i.test(content)) {
         rootCompositions.push(file);
       }
@@ -7195,7 +7362,7 @@ function lintMissingOrEmptySubComposition(projectDir, rootHtml) {
       const filePath = resolve(projectDir, srcPath);
       if (visited.has(filePath)) continue;
       visited.add(filePath);
-      const read = readProjectFile(filePath);
+      const read = readProjectFile2(filePath);
       if (read.kind === "missing") {
         if (!checked.has(srcPath)) {
           checked.set(srcPath, { srcPath, problem: "the file does not exist" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.8.159",
+  "version": "0.8.160",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -35,7 +35,7 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.4",
-    "@hyperframes/parsers": "0.8.159"
+    "@hyperframes/parsers": "0.8.160"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",