@hyperframes/lint 0.8.7 → 0.8.8

package/dist/index.js

@@ -287,6 +287,9 @@ function truncateSnippet(value, maxLength = 220) {
   if (normalized.length <= maxLength) return normalized;
   return `${normalized.slice(0, maxLength - 3)}...`;
 }
+function mediaSrcTagRe(tagAlternation) {
+  return new RegExp(`<(${tagAlternation})\\b[^>]*\\ssrc\\s*=\\s*["']([^"']+)["'][^>]*>`, "gi");
+}
 
 // src/context.ts
 function buildLintContext(html, options = {}) {
@@ -3266,7 +3269,7 @@ var captionRules = [
 ];
 
 // src/rules/composition.ts
-import { COMPOSITION_VARIABLE_TYPES } from "@hyperframes/parsers/composition";
+import { COMPOSITION_VARIABLE_TYPES, isSafeMediaUrl } from "@hyperframes/parsers/composition";
 import { COMPOSITION_ATTRIBUTES, readClipTiming } from "@hyperframes/parsers/composition-contract";
 var MAX_COMPOSITION_LINES = 300;
 var MAX_TIMED_ELEMENTS_PER_TRACK = 3;
@@ -3434,6 +3437,7 @@ var compositionRules = [
     const tagsByCompositionId = /* @__PURE__ */ new Map();
     for (const tag of tags) {
       if (isInsideInertTemplate(tag, tags)) continue;
+      if (readAttr(tag.raw, "data-composition-src")) continue;
       const compositionId = readDecodedAttr(tag.raw, "data-composition-id");
       if (!compositionId || compositionId.trim().length === 0) continue;
       const matchingTags = tagsByCompositionId.get(compositionId) ?? [];
@@ -3836,6 +3840,11 @@ var compositionRules = [
     }
     const findings = [];
     const knownTypes = new Set(COMPOSITION_VARIABLE_TYPES);
+    const varSrcIds = /* @__PURE__ */ new Set();
+    for (const tag of tags) {
+      const bound = readAttr(tag.raw, "data-var-src");
+      if (bound) varSrcIds.add(bound);
+    }
     for (let i = 0; i < parsed.length; i += 1) {
       const entry = parsed[i];
       if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
@@ -3860,6 +3869,17 @@ var compositionRules = [
           message: `data-composition-variables entry [${i}] is missing or has invalid: ${missing.join(", ")}. Type must be one of string, number, color, boolean, enum, font, image.`,
           snippet: truncateSnippet(htmlTag.raw)
         });
+        continue;
+      }
+      const id = String(e.id);
+      if ((e.type === "image" || varSrcIds.has(id)) && typeof e.default === "string" && e.default.length > 0 && !isSafeMediaUrl(e.default)) {
+        findings.push({
+          code: "unloadable_media_variable_default",
+          severity: "error",
+          message: `Variable "${id}" defaults to a URL the runtime will refuse to load, so any element bound to it renders its authored fallback src instead and the render still exits 0.`,
+          fixHint: `Media URLs must be relative, http(s), blob:, or a data:image/* URI. Copy the file into the project and reference it relatively (e.g. "assets/bg.png") rather than by absolute path.`,
+          snippet: truncateSnippet(htmlTag.raw)
+        });
       }
     }
     return findings;
@@ -4771,13 +4791,13 @@ async function probeIsHevc(ffprobePath, filePath) {
 }
 function collectLocalVideoCandidates(projectDir, htmlSources) {
   const candidates = /* @__PURE__ */ new Map();
-  const videoSrcRe = /<video\b[^>]*\bsrc\s*=\s*["']([^"']+)["'][^>]*>/gi;
+  const videoSrcRe = mediaSrcTagRe("video");
   for (const { html, compSrcPath } of htmlSources) {
     const scannable = maskNonScannableRanges(html);
     const re = new RegExp(videoSrcRe.source, videoSrcRe.flags);
     let match;
     while ((match = re.exec(scannable)) !== null) {
-      const rawSrc = match[1] ?? "";
+      const rawSrc = match[2] ?? "";
       if (isUnresolvedAssetPlaceholder(rawSrc)) continue;
       const src = cleanAssetUrl(rawSrc);
       if (!src) continue;
@@ -5041,12 +5061,12 @@ function lintProjectAudioFiles(projectDir, htmlSources) {
 }
 function lintAudioSrcNotFound(projectDir, htmlSources) {
   const findings = [];
-  const audioSrcRe = /<audio\b[^>]*\bsrc\s*=\s*["']([^"']+)["'][^>]*>/gi;
+  const audioSrcRe = mediaSrcTagRe("audio");
   const missingSrcs = [];
   for (const { html, compSrcPath } of htmlSources) {
     let match;
     while ((match = audioSrcRe.exec(html)) !== null) {
-      const src = match[1];
+      const src = match[2];
       if (/^(https?:|data:|blob:)/i.test(src)) continue;
       if (isUnresolvedAssetPlaceholder2(src)) continue;
       const rootRelative = compSrcPath ? rewriteAssetPath2(compSrcPath, src, (path) => existsSync2(join2(projectDir, path))) : src;
@@ -5068,7 +5088,7 @@ function lintAudioSrcNotFound(projectDir, htmlSources) {
 }
 function lintMissingLocalAsset(projectDir, htmlSources) {
   const findings = [];
-  const localAssetSrcRe = /<(video|img|source)\b[^>]*\bsrc\s*=\s*["']([^"']+)["'][^>]*>/gi;
+  const localAssetSrcRe = mediaSrcTagRe("video|img|source");
   const missingByTag = /* @__PURE__ */ new Map();
   for (const { html, compSrcPath } of htmlSources) {
     const scannable = maskNonScannableRanges2(html);