@hyperframes/lint 0.9.16 → 0.9.18

package/dist/browser.js

@@ -2797,6 +2797,9 @@ function findAudioGroupCarveAttrFindings(ctx) {
   return findings;
 }
 
+// src/rules/gsap.ts
+import postcss2 from "postcss";
+
 // src/scriptPositions.ts
 import { parse as parse3 } from "acorn";
 import { simple as simple3 } from "acorn-walk";
@@ -4920,17 +4923,30 @@ function indexInsideNonIifeRange(index, source, ranges) {
     (range) => index > range.start && index < range.end && !isIifeBody(source, range)
   );
 }
+function cssRuleSubjects(styles) {
+  const rules = [];
+  for (const style of styles) {
+    let root;
+    try {
+      root = postcss2.parse(style.content);
+    } catch {
+      continue;
+    }
+    root.walkRules((rule) => {
+      const subjects = rule.selectors.flatMap(
+        (selector) => /[#.][a-zA-Z0-9_-]+$/.exec(selector.trim())?.[0] ?? []
+      );
+      if (subjects.length) rules.push({ declarations: rule.nodes.map(String), subjects });
+    });
+  }
+  return rules;
+}
 function collectCssOpacityZeroSelectors(styles, tags) {
   const selectors = /* @__PURE__ */ new Set();
   const opacityExactlyZero = /opacity\s*:\s*0(?:\.0+)?\s*(?:;|$)/;
-  for (const style of styles) {
-    for (const [, selector, body] of style.content.matchAll(
-      /([#.][a-zA-Z0-9_-]+)\s*\{([^}]+)\}/g
-    )) {
-      if (body && opacityExactlyZero.test(body)) {
-        selectors.add((selector ?? "").trim());
-      }
-    }
+  for (const { declarations, subjects } of cssRuleSubjects(styles)) {
+    if (!declarations.some((declaration) => opacityExactlyZero.test(declaration))) continue;
+    for (const subject of subjects) selectors.add(subject);
   }
   for (const tag of tags) {
     const inlineStyle = readAttr(tag.raw, "style");
@@ -5138,17 +5154,13 @@ ${right.raw}`)
     const findings = [];
     const cssTranslateSelectors = /* @__PURE__ */ new Map();
     const cssScaleSelectors = /* @__PURE__ */ new Map();
-    for (const style of styles) {
-      for (const [, selector, body] of style.content.matchAll(
-        /([#.][a-zA-Z0-9_-]+)\s*\{([^}]+)\}/g
-      )) {
-        const tMatch = body?.match(/transform\s*:\s*([^;]+)/);
-        if (!tMatch || !tMatch[1]) continue;
-        const transformVal = tMatch[1].trim();
-        if (/translate/i.test(transformVal))
-          cssTranslateSelectors.set((selector ?? "").trim(), transformVal);
-        if (/scale/i.test(transformVal))
-          cssScaleSelectors.set((selector ?? "").trim(), transformVal);
+    for (const { declarations, subjects } of cssRuleSubjects(styles)) {
+      const tMatch = declarations.join(";").match(/transform\s*:\s*([^;]+)/);
+      if (!tMatch || !tMatch[1]) continue;
+      const transformVal = tMatch[1].trim();
+      for (const subject of subjects) {
+        if (/translate/i.test(transformVal)) cssTranslateSelectors.set(subject, transformVal);
+        if (/scale/i.test(transformVal)) cssScaleSelectors.set(subject, transformVal);
       }
     }
     for (const tag of tags) {
@@ -6308,7 +6320,7 @@ var adapterRules = [
 ];
 
 // src/rules/textures.ts
-import postcss2 from "postcss";
+import postcss3 from "postcss";
 var TEXTURE_BASE_CLASS = "hf-texture-text";
 var TEXTURE_CLASS_PREFIX = "hf-texture-";
 function classNames(tag) {
@@ -6355,7 +6367,7 @@ function collectTextureCss(styles) {
   for (const style of styles) {
     let root;
     try {
-      root = postcss2.parse(style.content);
+      root = postcss3.parse(style.content);
     } catch {
       continue;
     }
@@ -6485,7 +6497,7 @@ var textureRules = [
 ];
 
 // src/rules/fonts.ts
-import postcss3 from "postcss";
+import postcss4 from "postcss";
 import {
   FONT_ALIAS_KEYS,
   parseFontShorthand,
@@ -6518,7 +6530,7 @@ var GENERIC_FAMILIES = /* @__PURE__ */ new Set([
 ]);
 function parseFontCss(css) {
   try {
-    return postcss3.parse(css);
+    return postcss4.parse(css);
   } catch {
     return null;
   }
@@ -6560,7 +6572,7 @@ function collectFontCustomProperties(styles) {
   return properties;
 }
 function resolveUsedFontNames(value, properties, resolving = /* @__PURE__ */ new Set()) {
-  return postcss3.list.comma(value).flatMap((part) => {
+  return postcss4.list.comma(value).flatMap((part) => {
     const variable = /^var\(\s*(--[^\s,()]+)\s*(?:,[\s\S]*)?\)$/i.exec(part.trim());
     if (!variable) {
       const name = normalizeUsedFontName(part);
@@ -6722,7 +6734,7 @@ function uniqueFontLocation(styles, families, locate) {
   const properties = collectFontCustomProperties(styles);
   for (const style of styles) {
     try {
-      postcss3.parse(style.content).walkDecls(FONT_FAMILY_PROPS, (decl) => {
+      postcss4.parse(style.content).walkDecls(FONT_FAMILY_PROPS, (decl) => {
         const named = resolveUsedFontNames(usedFamilyList(decl), properties);
         if (!named.some((name) => families.includes(name))) return;
         locations.push(locate(style, decl.source?.start?.offset));

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { Ignore } from 'ignore';
+
 type HyperframeLintSeverity = "error" | "warning" | "info";
 type HyperframeLintFinding = {
     code: string;
@@ -106,9 +108,12 @@ interface ProjectLintResult {
     totalWarnings: number;
     totalInfos: number;
 }
-declare function collectExternalStyles(projectDir: string, html: string, compSrcPath?: string): NonNullable<HyperframeLinterOptions["externalStyles"]>;
+declare function linkedSources(projectDir: string, html: string, compSrcPath?: string): Pick<HyperframeLinterOptions, "externalStyles" | "externalScripts">;
 declare function lintProject(projectDir: string, entryFile?: string, hostOptions?: Pick<HyperframeLinterOptions, "host" | "isSubComposition">): Promise<ProjectLintResult>;
 
+/** What the project leaves out; ask with a relative `/` path, a folder with a trailing `/`. */
+declare function projectIgnore(projectDir: string): Ignore;
+
 type AudioAttribute = "data-automation" | "data-fx-chain";
 /**
  * Why the renderer would refuse an audio attribute's value before reading any lane or effect, or null when the
@@ -116,4 +121,4 @@ type AudioAttribute = "data-automation" | "data-fx-chain";
  */
 declare function audioAttributeShapeError(attr: AudioAttribute, json: string): string | null;
 
-export { type AudioAttribute, type HyperframeLintFinding, type HyperframeLintResult, type HyperframeLintSeverity, type HyperframeLinterOptions, LINT_RULE_COUNT, LINT_RULE_GROUP_COUNTS, type LintTimings, type ProjectLintResult, audioAttributeShapeError, collectExternalStyles, lintHyperframeHtml, lintMediaUrls, lintProject, shouldBlockRender };
+export { type AudioAttribute, type HyperframeLintFinding, type HyperframeLintResult, type HyperframeLintSeverity, type HyperframeLinterOptions, LINT_RULE_COUNT, LINT_RULE_GROUP_COUNTS, type LintTimings, type ProjectLintResult, audioAttributeShapeError, linkedSources, lintHyperframeHtml, lintMediaUrls, lintProject, projectIgnore, shouldBlockRender };

package/dist/index.js

@@ -2803,6 +2803,9 @@ function findAudioGroupCarveAttrFindings(ctx) {
   return findings;
 }
 
+// src/rules/gsap.ts
+import postcss2 from "postcss";
+
 // src/scriptPositions.ts
 import { parse as parse3 } from "acorn";
 import { simple as simple3 } from "acorn-walk";
@@ -4926,17 +4929,30 @@ function indexInsideNonIifeRange(index, source, ranges) {
     (range) => index > range.start && index < range.end && !isIifeBody(source, range)
   );
 }
+function cssRuleSubjects(styles) {
+  const rules = [];
+  for (const style of styles) {
+    let root;
+    try {
+      root = postcss2.parse(style.content);
+    } catch {
+      continue;
+    }
+    root.walkRules((rule) => {
+      const subjects = rule.selectors.flatMap(
+        (selector) => /[#.][a-zA-Z0-9_-]+$/.exec(selector.trim())?.[0] ?? []
+      );
+      if (subjects.length) rules.push({ declarations: rule.nodes.map(String), subjects });
+    });
+  }
+  return rules;
+}
 function collectCssOpacityZeroSelectors(styles, tags) {
   const selectors = /* @__PURE__ */ new Set();
   const opacityExactlyZero = /opacity\s*:\s*0(?:\.0+)?\s*(?:;|$)/;
-  for (const style of styles) {
-    for (const [, selector, body] of style.content.matchAll(
-      /([#.][a-zA-Z0-9_-]+)\s*\{([^}]+)\}/g
-    )) {
-      if (body && opacityExactlyZero.test(body)) {
-        selectors.add((selector ?? "").trim());
-      }
-    }
+  for (const { declarations, subjects } of cssRuleSubjects(styles)) {
+    if (!declarations.some((declaration) => opacityExactlyZero.test(declaration))) continue;
+    for (const subject of subjects) selectors.add(subject);
   }
   for (const tag of tags) {
     const inlineStyle = readAttr(tag.raw, "style");
@@ -5144,17 +5160,13 @@ ${right.raw}`)
     const findings = [];
     const cssTranslateSelectors = /* @__PURE__ */ new Map();
     const cssScaleSelectors = /* @__PURE__ */ new Map();
-    for (const style of styles) {
-      for (const [, selector, body] of style.content.matchAll(
-        /([#.][a-zA-Z0-9_-]+)\s*\{([^}]+)\}/g
-      )) {
-        const tMatch = body?.match(/transform\s*:\s*([^;]+)/);
-        if (!tMatch || !tMatch[1]) continue;
-        const transformVal = tMatch[1].trim();
-        if (/translate/i.test(transformVal))
-          cssTranslateSelectors.set((selector ?? "").trim(), transformVal);
-        if (/scale/i.test(transformVal))
-          cssScaleSelectors.set((selector ?? "").trim(), transformVal);
+    for (const { declarations, subjects } of cssRuleSubjects(styles)) {
+      const tMatch = declarations.join(";").match(/transform\s*:\s*([^;]+)/);
+      if (!tMatch || !tMatch[1]) continue;
+      const transformVal = tMatch[1].trim();
+      for (const subject of subjects) {
+        if (/translate/i.test(transformVal)) cssTranslateSelectors.set(subject, transformVal);
+        if (/scale/i.test(transformVal)) cssScaleSelectors.set(subject, transformVal);
       }
     }
     for (const tag of tags) {
@@ -6314,7 +6326,7 @@ var adapterRules = [
 ];
 
 // src/rules/textures.ts
-import postcss2 from "postcss";
+import postcss3 from "postcss";
 var TEXTURE_BASE_CLASS = "hf-texture-text";
 var TEXTURE_CLASS_PREFIX = "hf-texture-";
 function classNames(tag) {
@@ -6361,7 +6373,7 @@ function collectTextureCss(styles) {
   for (const style of styles) {
     let root;
     try {
-      root = postcss2.parse(style.content);
+      root = postcss3.parse(style.content);
     } catch {
       continue;
     }
@@ -6491,7 +6503,7 @@ var textureRules = [
 ];
 
 // src/rules/fonts.ts
-import postcss3 from "postcss";
+import postcss4 from "postcss";
 import {
   FONT_ALIAS_KEYS,
   parseFontShorthand,
@@ -6524,7 +6536,7 @@ var GENERIC_FAMILIES = /* @__PURE__ */ new Set([
 ]);
 function parseFontCss(css) {
   try {
-    return postcss3.parse(css);
+    return postcss4.parse(css);
   } catch {
     return null;
   }
@@ -6566,7 +6578,7 @@ function collectFontCustomProperties(styles) {
   return properties;
 }
 function resolveUsedFontNames(value, properties, resolving = /* @__PURE__ */ new Set()) {
-  return postcss3.list.comma(value).flatMap((part) => {
+  return postcss4.list.comma(value).flatMap((part) => {
     const variable = /^var\(\s*(--[^\s,()]+)\s*(?:,[\s\S]*)?\)$/i.exec(part.trim());
     if (!variable) {
       const name = normalizeUsedFontName(part);
@@ -6728,7 +6740,7 @@ function uniqueFontLocation(styles, families, locate) {
   const properties = collectFontCustomProperties(styles);
   for (const style of styles) {
     try {
-      postcss3.parse(style.content).walkDecls(FONT_FAMILY_PROPS, (decl) => {
+      postcss4.parse(style.content).walkDecls(FONT_FAMILY_PROPS, (decl) => {
         const named = resolveUsedFontNames(usedFamilyList(decl), properties);
         if (!named.some((name) => families.includes(name))) return;
         locations.push(locate(style, decl.source?.start?.offset));
@@ -7249,8 +7261,22 @@ function shouldBlockRender(strictErrors, strictAll, totalErrors, totalWarnings)
 
 // src/project.ts
 import { createHash } from "crypto";
-import { existsSync as existsSync2, readdirSync } from "fs";
-import { dirname as dirname2, extname, join as join3, relative as relative2, resolve } from "path";
+import { existsSync as existsSync3, readdirSync } from "fs";
+
+// src/projectIgnore.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import ignore from "ignore";
+var DEFAULT_PROJECT_IGNORE = ["/renders/", "/snapshots/", ".*"];
+function projectIgnore(projectDir) {
+  const matcher = ignore().add(DEFAULT_PROJECT_IGNORE);
+  const ignorePath = join(projectDir, ".hyperframesignore");
+  if (existsSync(ignorePath)) matcher.add(readFileSync(ignorePath, "utf-8"));
+  return matcher;
+}
+
+// src/project.ts
+import { dirname as dirname2, extname, join as join4, relative as relative2, resolve } from "path";
 import { rewriteAssetPath as rewriteAssetPath2 } from "@hyperframes/parsers/asset-paths";
 import { spansOverlap } from "@hyperframes/parsers/time-spans";
 import {
@@ -7266,7 +7292,7 @@ import {
 } from "@hyperframes/parsers/reference-resolver";
 import { checkSubCompositionUsability } from "@hyperframes/parsers/sub-composition-validity";
 import { parseHTML as parseHTML3 } from "linkedom";
-import postcss4 from "postcss";
+import postcss5 from "postcss";
 import {
   cleanAssetUrl as cleanAssetUrl2,
   collectSubCompositionSrcs,
@@ -7284,8 +7310,8 @@ import { encodeUrlPath } from "@hyperframes/parsers";
 
 // src/hevcPreviewLint.ts
 import { execFile } from "child_process";
-import { existsSync } from "fs";
-import { join } from "path";
+import { existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
 import { rewriteAssetPath } from "@hyperframes/parsers/asset-paths";
 import { parseNumeric } from "@hyperframes/parsers/composition-contract";
 import { findFfBinary } from "@hyperframes/parsers/ff-binaries";
@@ -7326,7 +7352,7 @@ function resolveLocalVideoReference(projectDir, rawSrc, compSrcPath) {
   if (isUnresolvedAssetPlaceholder(rawSrc)) return null;
   const src = cleanAssetUrl(rawSrc);
   if (!src || isRemoteOrInlineUrl(src)) return null;
-  const rootRelative = compSrcPath ? rewriteAssetPath(compSrcPath, src, (path) => existsSync(join(projectDir, path))) : src;
+  const rootRelative = compSrcPath ? rewriteAssetPath(compSrcPath, src, (path) => existsSync2(join2(projectDir, path))) : src;
   const asset = resolveExistingLocalAsset(projectDir, rootRelative);
   return asset ? { resolved: asset.resolved, src } : null;
 }
@@ -7520,7 +7546,7 @@ async function lintHevcPreviewCodec(candidates) {
 
 // src/projectShaders.ts
 import { realpathSync } from "fs";
-import { dirname, join as join2, relative } from "path";
+import { dirname, join as join3, relative } from "path";
 import {
   isWithinProjectRoot,
   readProjectFile,
@@ -7531,7 +7557,7 @@ function isAuthoredScript(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 besideFile = src.startsWith("/") ? src : join3(dirname(compSrcPath ?? "index.html"), src);
   const asset = resolveExistingLocalAsset2(projectDir, besideFile);
   if (!asset) return;
   try {
@@ -7604,7 +7630,7 @@ 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 ? join3(dirname2(compSrcPath), href) : href;
+    const besideFile = compSrcPath ? join4(dirname2(compSrcPath), href) : href;
     const stylesheet = resolveExistingLocalAsset3(projectDir, besideFile) ?? (compSrcPath && staysInsideProjectRoot(href) ? resolveExistingLocalAsset3(projectDir, href) : null);
     if (!stylesheet) continue;
     const read = readProjectFile2(stylesheet.resolved);
@@ -7621,11 +7647,17 @@ function collectExternalStyles(projectDir, html, compSrcPath) {
     document,
     compSrcPath
   )) {
-    styles.push({ href, content, file: join3(projectDir, rootRelativePath), rootRelativePath });
+    styles.push({ href, content, file: join4(projectDir, rootRelativePath), rootRelativePath });
   }
   return styles;
 }
 var MAX_EXTERNAL_SCRIPT_BYTES = 1e6;
+function linkedSources(projectDir, html, compSrcPath) {
+  return {
+    externalStyles: collectExternalStyles(projectDir, html, compSrcPath),
+    externalScripts: collectExternalScripts(projectDir, html, compSrcPath)
+  };
+}
 function collectExternalScripts(projectDir, html, compSrcPath) {
   const scripts = [];
   const { document } = parseHTML3(html);
@@ -7633,7 +7665,7 @@ function collectExternalScripts(projectDir, html, compSrcPath) {
     const src = element.getAttribute("src") ?? "";
     if (!isLocalStylesheetHref(src) || /\.min\.m?js(?:[?#]|$)/i.test(src)) continue;
     const path = src.split(/[?#]/)[0] ?? src;
-    const besideFile = compSrcPath ? join3(dirname2(compSrcPath), path) : path;
+    const besideFile = compSrcPath ? join4(dirname2(compSrcPath), path) : path;
     const script = resolveExistingLocalAsset3(projectDir, besideFile) ?? (compSrcPath && staysInsideProjectRoot(path) ? resolveExistingLocalAsset3(projectDir, path) : null);
     if (!script) continue;
     const read = readProjectFile2(script.resolved);
@@ -7643,7 +7675,7 @@ function collectExternalScripts(projectDir, html, compSrcPath) {
       src,
       attrs,
       content: read.text,
-      file: join3(projectDir, script.rootRelativePath),
+      file: join4(projectDir, script.rootRelativePath),
       rootRelativePath: script.rootRelativePath
     });
   }
@@ -7672,12 +7704,12 @@ function collectCssSources(projectDir, html, compSrcPath) {
 function resolveCssAssetCandidates(projectDir, url, htmlCompSrcPath, cssRootRelativePath) {
   if (url.startsWith("/")) return resolveLocalAssetCandidates(projectDir, url);
   if (cssRootRelativePath) {
-    return resolveLocalAssetCandidates(projectDir, join3(dirname2(cssRootRelativePath), url));
+    return resolveLocalAssetCandidates(projectDir, join4(dirname2(cssRootRelativePath), url));
   }
   if (htmlCompSrcPath) {
     return resolveLocalAssetCandidates(
       projectDir,
-      rewriteAssetPath2(htmlCompSrcPath, url, (path) => existsSync2(join3(projectDir, path)))
+      rewriteAssetPath2(htmlCompSrcPath, url, (path) => existsSync3(join4(projectDir, path)))
     );
   }
   return resolveLocalAssetCandidates(projectDir, url);
@@ -7738,9 +7770,8 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
     ...hostOptions,
     filePath: indexPath,
     compSrcPath: rootFile,
-    externalStyles: collectExternalStyles(projectDir, rootHtml, rootCompSrcPath),
-    projectFontFamilies,
-    externalScripts: collectExternalScripts(projectDir, rootHtml, rootCompSrcPath)
+    ...linkedSources(projectDir, rootHtml, rootCompSrcPath),
+    projectFontFamilies
   });
   results.push({ file: rootFile, result: rootResult, contentHash: contentDigest(rootHtml) });
   totalErrors += rootResult.errorCount;
@@ -7748,14 +7779,16 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
   totalInfos += rootResult.infoCount;
   const allHtmlSources = [{ html: rootHtml, compSrcPath: rootCompSrcPath }];
   const compositionsDir = resolve(projectDir, "compositions");
-  if (!entryFile && existsSync2(compositionsDir)) {
+  if (!entryFile && existsSync3(compositionsDir)) {
+    const ignored = projectIgnore(projectDir);
     const collectHtmlFiles = (dir, rel) => {
       const out = [];
       for (const entry of readdirSync(dir, { withFileTypes: true })) {
         const relPath = rel ? `${rel}/${entry.name}` : entry.name;
+        if (ignored.ignores(`compositions/${relPath}${entry.isDirectory() ? "/" : ""}`)) continue;
         if (entry.isDirectory()) {
           if (!rel && entry.name === "components") continue;
-          out.push(...collectHtmlFiles(join3(dir, entry.name), relPath));
+          out.push(...collectHtmlFiles(join4(dir, entry.name), relPath));
         } else if (entry.isFile() && entry.name.endsWith(".html") && !entry.name.startsWith("._")) {
           out.push(relPath);
         }
@@ -7764,7 +7797,7 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
     };
     const files = collectHtmlFiles(compositionsDir, "").sort();
     for (const file of files) {
-      const filePath = join3(compositionsDir, file);
+      const filePath = join4(compositionsDir, file);
       const html = readTextFile(filePath);
       const compSrcPath = `compositions/${file}`;
       allHtmlSources.push({ html, compSrcPath });
@@ -7774,9 +7807,8 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
         filePath,
         isSubComposition: true,
         compSrcPath,
-        externalStyles: collectExternalStyles(projectDir, html, compSrcPath),
-        projectFontFamilies,
-        externalScripts: collectExternalScripts(projectDir, html, compSrcPath)
+        ...linkedSources(projectDir, html, compSrcPath),
+        projectFontFamilies
       });
       results.push({
         file: `compositions/${file}`,
@@ -7878,7 +7910,7 @@ function lintProjectAudioFiles(projectDir, htmlSources) {
 function urlSafeSrcOf(projectDir, rootRelative) {
   if (!/[?#]/.test(rootRelative)) return null;
   const literal = resolve(projectDir, rootRelative.replace(/^\//, ""));
-  if (!existsSync2(literal)) return null;
+  if (!existsSync3(literal)) return null;
   return encodeUrlPath(rootRelative);
 }
 var urlSafeHint = (safe) => `The file exists, but a "#" or "?" in a src ends the file name there. Write the src as "${safe}".`;
@@ -7894,8 +7926,8 @@ 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(join3(projectDir, path))) : src;
-      if (!existsSync2(resolveProjectRelativeSrc(rootRelative, projectDir))) {
+      const rootRelative = compSrcPath ? rewriteAssetPath2(compSrcPath, src, (path) => existsSync3(join4(projectDir, path))) : src;
+      if (!existsSync3(resolveProjectRelativeSrc(rootRelative, projectDir))) {
         const safe = urlSafeSrcOf(projectDir, rootRelative);
         if (safe) urlSafe.set(src, safe);
         const file = sourceFile(projectDir, compSrcPath);
@@ -7931,13 +7963,13 @@ function lintMissingLocalAsset(projectDir, htmlSources) {
       const src = cleanAssetUrl2(rawSrc);
       if (!src) continue;
       if (isRemoteOrInlineUrl2(src)) continue;
-      const rootRelative = compSrcPath ? rewriteAssetPath2(compSrcPath, src, (path) => existsSync2(join3(projectDir, path))) : src;
+      const rootRelative = compSrcPath ? rewriteAssetPath2(compSrcPath, src, (path) => existsSync3(join4(projectDir, path))) : src;
       const resolvedAsset = resolveExistingLocalAsset3(projectDir, rootRelative);
       if (resolvedAsset) continue;
       const rawRoot = rawSrc.trim();
       const safe = urlSafeSrcOf(
         projectDir,
-        compSrcPath ? rewriteAssetPath2(compSrcPath, rawRoot, (path) => existsSync2(join3(projectDir, path))) : rawRoot
+        compSrcPath ? rewriteAssetPath2(compSrcPath, rawRoot, (path) => existsSync3(join4(projectDir, path))) : rawRoot
       );
       if (safe) urlSafe.set(src, safe);
       const resolvedKey = resolve(projectDir, rootRelative);
@@ -7970,11 +8002,11 @@ function lintTextureMaskAssetNotFound(projectDir, htmlSources) {
     for (const cssSource of collectCssSources(projectDir, html, compSrcPath)) {
       let matches = [];
       try {
-        postcss4.parse(cssSource.content).walkDecls(/^(?:-webkit-)?mask-image$/i, (declaration) => {
+        postcss5.parse(cssSource.content).walkDecls(/^(?:-webkit-)?mask-image$/i, (declaration) => {
           matches.push(...declaration.value.matchAll(CSS_URL_RE));
         });
       } catch (error) {
-        if (!(error instanceof postcss4.CssSyntaxError)) throw error;
+        if (!(error instanceof postcss5.CssSyntaxError)) throw error;
         matches = [...cssSource.content.matchAll(MASK_IMAGE_URL_RE)];
       }
       for (const match of matches) {
@@ -7988,7 +8020,7 @@ function lintTextureMaskAssetNotFound(projectDir, htmlSources) {
           compSrcPath,
           cssSource.rootRelativePath
         );
-        if (candidates.some(existsSync2)) continue;
+        if (candidates.some(existsSync3)) continue;
         missingByFile.set(file, (missingByFile.get(file) ?? /* @__PURE__ */ new Set()).add(url));
       }
     }
@@ -8008,8 +8040,8 @@ function nearestAncestorMatch(projectDir, cssRootRelativePath, url) {
   const root = resolve(projectDir);
   for (let dir = resolve(root, dirname2(cssRootRelativePath), ".."); ; dir = dirname2(dir)) {
     if (!isWithinProjectRoot2(projectDir, dir)) return null;
-    if (resolveLocalAssetCandidates(projectDir, relative2(root, join3(dir, url))).some(existsSync2)) {
-      return relative2(dirname2(resolve(root, cssRootRelativePath)), join3(dir, url)).replace(
+    if (resolveLocalAssetCandidates(projectDir, relative2(root, join4(dir, url))).some(existsSync3)) {
+      return relative2(dirname2(resolve(root, cssRootRelativePath)), join4(dir, url)).replace(
         /\\/g,
         "/"
       );
@@ -8028,9 +8060,9 @@ function lintLinkedStylesheetAssets(projectDir, htmlSources) {
     )) {
       let root;
       try {
-        root = postcss4.parse(content);
+        root = postcss5.parse(content);
       } catch (error) {
-        if (!(error instanceof postcss4.CssSyntaxError)) throw error;
+        if (!(error instanceof postcss5.CssSyntaxError)) throw error;
         continue;
       }
       root.walkDecls((declaration) => {
@@ -8040,7 +8072,7 @@ function lintLinkedStylesheetAssets(projectDir, htmlSources) {
           if (isUnresolvedAssetPlaceholder2(rawUrl)) continue;
           const url = cleanAssetUrl2(rawUrl);
           if (!url || isRemoteOrInlineUrl2(url) || url.startsWith("/")) continue;
-          if (resolveCssAssetCandidates(projectDir, url, void 0, rootRelativePath).some(existsSync2))
+          if (resolveCssAssetCandidates(projectDir, url, void 0, rootRelativePath).some(existsSync3))
             continue;
           const key = `${rootRelativePath}\0${url}`;
           if (seen.has(key)) continue;
@@ -8049,7 +8081,7 @@ function lintLinkedStylesheetAssets(projectDir, htmlSources) {
           findings.push({
             code: "missing_stylesheet_asset",
             severity: "warning",
-            file: join3(projectDir, rootRelativePath),
+            file: join4(projectDir, rootRelativePath),
             message: `${rootRelativePath} references url(${url}), which is not found beside the stylesheet (looked in ${dirname2(rootRelativePath)}/). The browser resolves url() from the stylesheet, so the file will 404.`,
             fixHint: found ? `A file exists at "${found}" relative to the stylesheet. Change the url() to that path.` : `Add "${url}" beside the stylesheet, or point the url() at an existing file.`
           });
@@ -8069,7 +8101,7 @@ function lintMultipleRootCompositions(projectDir) {
     const rootCompositions = [];
     for (const file of rootHtmlFiles) {
       if (PAGES_OPENED_BESIDE_INDEX.has(file)) continue;
-      const content = readTextFile(join3(projectDir, file));
+      const content = readTextFile(join4(projectDir, file));
       if (/data-composition-id/i.test(content)) {
         rootCompositions.push(file);
       }
@@ -8234,9 +8266,10 @@ export {
   LINT_RULE_COUNT,
   LINT_RULE_GROUP_COUNTS,
   audioAttributeShapeError,
-  collectExternalStyles,
+  linkedSources,
   lintHyperframeHtml,
   lintMediaUrls,
   lintProject,
+  projectIgnore,
   shouldBlockRender
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.9.16",
+  "version": "0.9.18",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -32,10 +32,11 @@
     "acorn": "^8.17.0",
     "acorn-walk": "^8.3.5",
     "htmlparser2": "^10.1.0",
+    "ignore": "^5.3.2",
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.4",
-    "@hyperframes/parsers": "0.9.16"
+    "@hyperframes/parsers": "0.9.18"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",