@hyperframes/lint 0.8.222 → 0.8.223

package/dist/browser.d.ts

@@ -43,6 +43,13 @@ type HyperframeLinterOptions = {
         file?: string;
         rootRelativePath?: string;
     }>;
+    externalScripts?: Array<{
+        src: string;
+        attrs: string;
+        content: string;
+        file: string;
+        rootRelativePath: string;
+    }>;
     /**
      * Set to `true` when linting compositions destined for distributed / Lambda
      * rendering, where system-font capture (`allowSystemFontCapture`) is

package/dist/browser.js

@@ -786,7 +786,17 @@ function buildLintContext(html, options = {}) {
       rootRelativePath: style.rootRelativePath
     }))
   ];
-  const scripts = structure.scripts;
+  const scripts = [
+    ...structure.scripts,
+    ...(options.externalScripts ?? []).map((script) => ({
+      attrs: script.attrs,
+      content: script.content,
+      raw: script.content,
+      index: -1,
+      file: script.file,
+      rootRelativePath: script.rootRelativePath
+    }))
+  ];
   const compositionIds = collectCompositionIds(tags);
   const rootTag = findRootTag(source, tags);
   const rootCompositionId = readDecodedAttr(rootTag?.raw || "", "data-composition-id");
@@ -1389,7 +1399,10 @@ var coreRules = [
     }
     if (/(?:^|\s)data-no-timeline(?=[\s=/]|$)/i.test(rootTag?.attrs || "")) return [];
     const findings = [];
-    if (!TIMELINE_REGISTRY_INIT_PATTERN.test(source) && !TIMELINE_REGISTRY_ASSIGN_PATTERN.test(source) && !TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN.test(source)) {
+    const registered = [source, ...(options.externalScripts ?? []).map((script) => script.content)];
+    if (!registered.some(
+      (text) => TIMELINE_REGISTRY_INIT_PATTERN.test(text) || TIMELINE_REGISTRY_ASSIGN_PATTERN.test(text) || TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN.test(text)
+    )) {
       findings.push({
         code: "missing_timeline_registry",
         severity: "error",
@@ -1560,9 +1573,9 @@ var coreRules = [
   ({ scripts, locate }) => {
     const findings = [];
     for (const script of scripts) {
-      const type = readDecodedAttr(script.raw, "type")?.trim().toLowerCase() ?? "";
-      if (readDecodedAttr(script.raw, "src") !== null || SCRIPT_SYNTAX_EXEMPT_TYPES.has(type))
-        continue;
+      const tag = `<script ${script.attrs}>`;
+      const type = readDecodedAttr(tag, "type")?.trim().toLowerCase() ?? "";
+      if (readDecodedAttr(tag, "src") !== null || SCRIPT_SYNTAX_EXEMPT_TYPES.has(type)) continue;
       const syntaxError = getInlineScriptSyntaxError(script.content);
       if (!syntaxError) continue;
       findings.push({

package/dist/index.d.ts

@@ -43,6 +43,13 @@ type HyperframeLinterOptions = {
         file?: string;
         rootRelativePath?: string;
     }>;
+    externalScripts?: Array<{
+        src: string;
+        attrs: string;
+        content: string;
+        file: string;
+        rootRelativePath: string;
+    }>;
     /**
      * Set to `true` when linting compositions destined for distributed / Lambda
      * rendering, where system-font capture (`allowSystemFontCapture`) is

package/dist/index.js

@@ -792,7 +792,17 @@ function buildLintContext(html, options = {}) {
       rootRelativePath: style.rootRelativePath
     }))
   ];
-  const scripts = structure.scripts;
+  const scripts = [
+    ...structure.scripts,
+    ...(options.externalScripts ?? []).map((script) => ({
+      attrs: script.attrs,
+      content: script.content,
+      raw: script.content,
+      index: -1,
+      file: script.file,
+      rootRelativePath: script.rootRelativePath
+    }))
+  ];
   const compositionIds = collectCompositionIds(tags);
   const rootTag = findRootTag(source, tags);
   const rootCompositionId = readDecodedAttr(rootTag?.raw || "", "data-composition-id");
@@ -1395,7 +1405,10 @@ var coreRules = [
     }
     if (/(?:^|\s)data-no-timeline(?=[\s=/]|$)/i.test(rootTag?.attrs || "")) return [];
     const findings = [];
-    if (!TIMELINE_REGISTRY_INIT_PATTERN.test(source) && !TIMELINE_REGISTRY_ASSIGN_PATTERN.test(source) && !TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN.test(source)) {
+    const registered = [source, ...(options.externalScripts ?? []).map((script) => script.content)];
+    if (!registered.some(
+      (text) => TIMELINE_REGISTRY_INIT_PATTERN.test(text) || TIMELINE_REGISTRY_ASSIGN_PATTERN.test(text) || TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN.test(text)
+    )) {
       findings.push({
         code: "missing_timeline_registry",
         severity: "error",
@@ -1566,9 +1579,9 @@ var coreRules = [
   ({ scripts, locate }) => {
     const findings = [];
     for (const script of scripts) {
-      const type = readDecodedAttr(script.raw, "type")?.trim().toLowerCase() ?? "";
-      if (readDecodedAttr(script.raw, "src") !== null || SCRIPT_SYNTAX_EXEMPT_TYPES.has(type))
-        continue;
+      const tag = `<script ${script.attrs}>`;
+      const type = readDecodedAttr(tag, "type")?.trim().toLowerCase() ?? "";
+      if (readDecodedAttr(tag, "src") !== null || SCRIPT_SYNTAX_EXEMPT_TYPES.has(type)) continue;
       const syntaxError = getInlineScriptSyntaxError(script.content);
       if (!syntaxError) continue;
       findings.push({
@@ -7492,6 +7505,30 @@ function collectExternalStyles(projectDir, html, compSrcPath) {
   }
   return styles;
 }
+var MAX_EXTERNAL_SCRIPT_BYTES = 1e6;
+function collectExternalScripts(projectDir, html, compSrcPath) {
+  const scripts = [];
+  const { document } = parseHTML3(html);
+  for (const element of querySelectorAllIncludingTemplates(document, "script[src]")) {
+    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 script = resolveExistingLocalAsset3(projectDir, besideFile) ?? (compSrcPath && staysInsideProjectRoot(path) ? resolveExistingLocalAsset3(projectDir, path) : null);
+    if (!script) continue;
+    const read = readProjectFile2(script.resolved);
+    if (read.kind !== "file" || read.text.length > MAX_EXTERNAL_SCRIPT_BYTES) continue;
+    const attrs = Array.from(element.attributes).map(({ name, value }) => `${name}="${value.replace(/&/g, "&amp;").replace(/"/g, "&quot;")}"`).join(" ");
+    scripts.push({
+      src,
+      attrs,
+      content: read.text,
+      file: join3(projectDir, script.rootRelativePath),
+      rootRelativePath: script.rootRelativePath
+    });
+  }
+  return scripts;
+}
 function collectCssSources(projectDir, html, compSrcPath) {
   const sources = [];
   const { document } = parseHTML3(html);
@@ -7582,7 +7619,8 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
     filePath: indexPath,
     compSrcPath: rootFile,
     externalStyles: collectExternalStyles(projectDir, rootHtml, rootCompSrcPath),
-    projectFontFamilies
+    projectFontFamilies,
+    externalScripts: collectExternalScripts(projectDir, rootHtml, rootCompSrcPath)
   });
   results.push({ file: rootFile, result: rootResult, contentHash: contentDigest(rootHtml) });
   totalErrors += rootResult.errorCount;
@@ -7617,7 +7655,8 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
         isSubComposition: true,
         compSrcPath,
         externalStyles: collectExternalStyles(projectDir, html, compSrcPath),
-        projectFontFamilies
+        projectFontFamilies,
+        externalScripts: collectExternalScripts(projectDir, html, compSrcPath)
       });
       results.push({
         file: `compositions/${file}`,
@@ -7900,6 +7939,7 @@ function lintLinkedStylesheetAssets(projectDir, htmlSources) {
   }
   return findings;
 }
+var PAGES_OPENED_BESIDE_INDEX = /* @__PURE__ */ new Set(["caption-skin.html", "podcast-lanes.html"]);
 function lintMultipleRootCompositions(projectDir) {
   const findings = [];
   try {
@@ -7908,7 +7948,7 @@ function lintMultipleRootCompositions(projectDir) {
     );
     const rootCompositions = [];
     for (const file of rootHtmlFiles) {
-      if (file === "caption-skin.html") continue;
+      if (PAGES_OPENED_BESIDE_INDEX.has(file)) continue;
       const content = readFileSync(join3(projectDir, file), "utf-8");
       if (/data-composition-id/i.test(content)) {
         rootCompositions.push(file);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.8.222",
+  "version": "0.8.223",
   "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.222"
+    "@hyperframes/parsers": "0.8.223"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",