@hyperframes/lint 0.9.20 → 0.9.22

package/dist/index.d.ts

@@ -107,9 +107,15 @@ interface ProjectLintResult {
     totalErrors: number;
     totalWarnings: number;
     totalInfos: number;
+    unmountedCompositions?: string[];
+}
+/** The one line a run prints when it left unmounted compositions out. */
+declare function unmountedNotice(count: number): string;
+interface ProjectLintOptions {
+    includeUnmounted?: boolean;
 }
 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>;
+declare function lintProject(projectDir: string, entryFile?: string, hostOptions?: Pick<HyperframeLinterOptions, "host" | "isSubComposition">, { includeUnmounted }?: ProjectLintOptions): Promise<ProjectLintResult>;
 
 /** What the project leaves out; ask with a relative `/` path, a folder with a trailing `/`. */
 declare function projectIgnore(projectDir: string): Ignore;
@@ -121,4 +127,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, linkedSources, lintHyperframeHtml, lintMediaUrls, lintProject, projectIgnore, shouldBlockRender };
+export { type AudioAttribute, type HyperframeLintFinding, type HyperframeLintResult, type HyperframeLintSeverity, type HyperframeLinterOptions, LINT_RULE_COUNT, LINT_RULE_GROUP_COUNTS, type LintTimings, type ProjectLintOptions, type ProjectLintResult, audioAttributeShapeError, linkedSources, lintHyperframeHtml, lintMediaUrls, lintProject, projectIgnore, shouldBlockRender, unmountedNotice };

package/dist/index.js

@@ -7616,6 +7616,10 @@ function querySelectorAllIncludingTemplates(root, selector) {
   }
   return matches;
 }
+function unmountedNotice(count) {
+  const skipped = count === 1 ? "1 file in compositions/ is" : `${count} files in compositions/ are`;
+  return `${skipped} not mounted from index.html, so not checked; --include-unmounted adds them.`;
+}
 function contentDigest(html) {
   return createHash("sha256").update(html).digest("hex").slice(0, 16);
 }
@@ -7755,7 +7759,7 @@ function declaredProjectFontFamilies(projectDir, sources) {
   }
   return [...families];
 }
-async function lintProject(projectDir, entryFile, hostOptions = {}) {
+async function lintProject(projectDir, entryFile, hostOptions = {}, { includeUnmounted = false } = {}) {
   const indexPath = entryFile ? resolve(entryFile) : resolve(projectDir, "index.html");
   if (entryFile && !isWithinProjectRoot2(projectDir, indexPath)) {
     throw new Error(`Explicit lint entry is outside the project directory: ${entryFile}`);
@@ -7767,10 +7771,11 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
   let totalWarnings = 0;
   let totalInfos = 0;
   const rootHtml = readTextFile(indexPath);
-  const projectFontFamilies = declaredProjectFontFamilies(
-    projectDir,
-    mountedSources(projectDir, rootHtml, rootCompSrcPath)
-  );
+  const mounted = mountedSources(projectDir, rootHtml, rootCompSrcPath);
+  const mountedPaths = new Set(mounted.map((source) => source.compSrcPath));
+  const unmountedCompositions = [];
+  const unmountedSources = [];
+  const projectFontFamilies = declaredProjectFontFamilies(projectDir, mounted);
   const rootResult = await lintHyperframeHtml(rootHtml, {
     ...hostOptions,
     filePath: indexPath,
@@ -7805,6 +7810,11 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
       const filePath = join4(compositionsDir, file);
       const html = readTextFile(filePath);
       const compSrcPath = `compositions/${file}`;
+      if (!includeUnmounted && !mountedPaths.has(compSrcPath)) {
+        unmountedSources.push({ html, compSrcPath });
+        if (!isSnippetFragment(html)) unmountedCompositions.push(compSrcPath);
+        continue;
+      }
       allHtmlSources.push({ html, compSrcPath });
       if (isSnippetFragment(html)) continue;
       const result = await lintHyperframeHtml(html, {
@@ -7833,7 +7843,7 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
     ...lintTextureMaskAssetNotFound(projectDir, allHtmlSources),
     ...lintLinkedStylesheetAssets(projectDir, allHtmlSources),
     ...!entryFile ? lintMultipleRootCompositions(projectDir) : [],
-    ...!entryFile ? lintBlankRootWithStandaloneComposition(rootHtml, allHtmlSources) : [],
+    ...!entryFile ? lintBlankRootWithStandaloneComposition(rootHtml, [...allHtmlSources, ...unmountedSources]) : [],
     ...lintDuplicateAudioTracks(projectDir, rootHtml),
     ...lintMissingOrEmptySubComposition(projectDir, rootHtml),
     ...await lintVideoMediaStartPastEof(projectDir, allHtmlSources),
@@ -7855,7 +7865,7 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
       totalInfos++;
     }
   }
-  return { results, totalErrors, totalWarnings, totalInfos };
+  return { results, totalErrors, totalWarnings, totalInfos, unmountedCompositions };
 }
 function lintBlankRootWithStandaloneComposition(rootHtml, htmlSources) {
   const { document: rootDocument } = parseHTML3(rootHtml);
@@ -8000,6 +8010,12 @@ function lintMissingLocalAsset(projectDir, htmlSources) {
   }
   return findings;
 }
+function localCssUrl(match) {
+  const rawUrl = match[1] ?? match[2] ?? match[3] ?? "";
+  if (isUnresolvedAssetPlaceholder2(rawUrl)) return void 0;
+  const url = cleanAssetUrl2(rawUrl);
+  return url && !isRemoteOrInlineUrl2(url) ? url : void 0;
+}
 function lintTextureMaskAssetNotFound(projectDir, htmlSources) {
   const missingByFile = /* @__PURE__ */ new Map();
   for (const { html, compSrcPath } of htmlSources) {
@@ -8015,10 +8031,8 @@ function lintTextureMaskAssetNotFound(projectDir, htmlSources) {
         matches = [...cssSource.content.matchAll(MASK_IMAGE_URL_RE)];
       }
       for (const match of matches) {
-        const rawUrl = match[1] ?? match[2] ?? match[3] ?? "";
-        if (isUnresolvedAssetPlaceholder2(rawUrl)) continue;
-        const url = cleanAssetUrl2(rawUrl);
-        if (!url || isRemoteOrInlineUrl2(url)) continue;
+        const url = localCssUrl(match);
+        if (!url) continue;
         const candidates = resolveCssAssetCandidates(
           projectDir,
           url,
@@ -8073,10 +8087,8 @@ function lintLinkedStylesheetAssets(projectDir, htmlSources) {
       root.walkDecls((declaration) => {
         if (/^(?:-webkit-)?mask-image$/i.test(declaration.prop)) return;
         for (const match of declaration.value.matchAll(CSS_URL_RE)) {
-          const rawUrl = match[1] ?? match[2] ?? match[3] ?? "";
-          if (isUnresolvedAssetPlaceholder2(rawUrl)) continue;
-          const url = cleanAssetUrl2(rawUrl);
-          if (!url || isRemoteOrInlineUrl2(url) || url.startsWith("/")) continue;
+          const url = localCssUrl(match);
+          if (!url || url.startsWith("/")) continue;
           if (resolveCssAssetCandidates(projectDir, url, void 0, rootRelativePath).some(existsSync3))
             continue;
           const key = `${rootRelativePath}\0${url}`;
@@ -8276,5 +8288,6 @@ export {
   lintMediaUrls,
   lintProject,
   projectIgnore,
-  shouldBlockRender
+  shouldBlockRender,
+  unmountedNotice
 };

package/package.json

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