@hyperframes/lint 0.8.205 → 0.8.207

package/dist/index.js

@@ -7066,6 +7066,7 @@ import {
   resolveLocalAssetCandidates,
   resolveProjectRelativeSrc
 } from "@hyperframes/parsers/asset-resolution";
+import { encodeUrlPath } from "@hyperframes/parsers";
 
 // src/hevcPreviewLint.ts
 import { execFile } from "child_process";
@@ -7591,10 +7592,18 @@ function lintProjectAudioFiles(projectDir, htmlSources) {
   }
   return findings;
 }
+function urlSafeSrcOf(projectDir, rootRelative) {
+  if (!/[?#]/.test(rootRelative)) return null;
+  const literal = resolve(projectDir, rootRelative.replace(/^\//, ""));
+  if (!existsSync2(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}".`;
 function lintAudioSrcNotFound(projectDir, htmlSources) {
   const findings = [];
   const audioSrcRe = mediaSrcTagRe("audio");
   const missingByFile = /* @__PURE__ */ new Map();
+  const urlSafe = /* @__PURE__ */ new Map();
   for (const { html, compSrcPath } of htmlSources) {
     const scannable = maskNonScannableRanges2(html);
     let match;
@@ -7604,6 +7613,8 @@ function lintAudioSrcNotFound(projectDir, htmlSources) {
       if (isUnresolvedAssetPlaceholder2(src)) continue;
       const rootRelative = compSrcPath ? rewriteAssetPath2(compSrcPath, src, (path) => existsSync2(join3(projectDir, path))) : src;
       if (!existsSync2(resolveProjectRelativeSrc(rootRelative, projectDir))) {
+        const safe = urlSafeSrcOf(projectDir, rootRelative);
+        if (safe) urlSafe.set(src, safe);
         const file = sourceFile(projectDir, compSrcPath);
         missingByFile.set(file, (missingByFile.get(file) ?? /* @__PURE__ */ new Set()).add(src));
       }
@@ -7616,7 +7627,7 @@ function lintAudioSrcNotFound(projectDir, htmlSources) {
       severity: "error",
       file,
       message: `<audio> element references file(s) not found in the project: ${unique.join(", ")}. The rendered video will be silent.`,
-      fixHint: unique.length === 1 ? `Add the file "${unique[0]}" to the project directory, or update the src attribute to point to an existing file.` : `Add the missing files to the project directory, or update the src attributes to point to existing files.`
+      fixHint: unique.length === 1 && urlSafe.has(unique[0]) ? urlSafeHint(urlSafe.get(unique[0])) : unique.length === 1 ? `Add the file "${unique[0]}" to the project directory, or update the src attribute to point to an existing file.` : `Add the missing files to the project directory, or update the src attributes to point to existing files.`
     });
   }
   return findings;
@@ -7625,6 +7636,7 @@ function lintMissingLocalAsset(projectDir, htmlSources) {
   const findings = [];
   const localAssetSrcRe = mediaSrcTagRe("video|img|source");
   const missingByTag = /* @__PURE__ */ new Map();
+  const urlSafe = /* @__PURE__ */ new Map();
   for (const { html, compSrcPath } of htmlSources) {
     const scannable = maskNonScannableRanges2(html);
     const re = new RegExp(localAssetSrcRe.source, localAssetSrcRe.flags);
@@ -7639,6 +7651,12 @@ function lintMissingLocalAsset(projectDir, htmlSources) {
       const rootRelative = compSrcPath ? rewriteAssetPath2(compSrcPath, src, (path) => existsSync2(join3(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
+      );
+      if (safe) urlSafe.set(src, safe);
       const resolvedKey = resolve(projectDir, rootRelative);
       const file = sourceFile(projectDir, compSrcPath);
       const bucketKey = `${file}\0${tagName}`;
@@ -7657,7 +7675,7 @@ function lintMissingLocalAsset(projectDir, htmlSources) {
       severity: "error",
       file,
       message: `<${tagName}> element references local file(s) not found in the project: ${unique.join(", ")}. The renderer will silently skip these and produce a video with missing visuals.`,
-      fixHint: unique.length === 1 ? `Add "${unique[0]}" to the project directory, or update the src attribute to point to an existing file. Common cause: captured asset filenames are unreliable (heygen-logo.svg often contains Google, nvidia-logo.svg may contain Autodesk, etc.). Open the contact sheets and verify the file actually exists at this path before referencing it.` : "Add the missing files to the project directory, or update the src attributes to point to existing files. Captured asset filenames are unreliable. Verify against capture/contact-sheets/ and capture/extracted/asset-descriptions.md."
+      fixHint: unique.length === 1 && urlSafe.has(unique[0]) ? urlSafeHint(urlSafe.get(unique[0])) : unique.length === 1 ? `Add "${unique[0]}" to the project directory, or update the src attribute to point to an existing file. Common cause: captured asset filenames are unreliable (heygen-logo.svg often contains Google, nvidia-logo.svg may contain Autodesk, etc.). Open the contact sheets and verify the file actually exists at this path before referencing it.` : "Add the missing files to the project directory, or update the src attributes to point to existing files. Captured asset filenames are unreliable. Verify against capture/contact-sheets/ and capture/extracted/asset-descriptions.md."
     });
   }
   return findings;

package/package.json

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