hyperframes 0.8.67 → 0.8.68

package/dist/fontLocalizeCli.js

@@ -31227,13 +31227,13 @@ var require_lib2 = __commonJS({
       DeclareClassFieldInitializer: "Initializers are not allowed in fields with the `declare` modifier.",
       DuplicateDeclareModuleExports: "Duplicate `declare module.exports` statement.",
       EnumBooleanMemberNotInitialized: ({
-        memberName: memberName2,
+        memberName: memberName3,
         enumName
-      }) => `Boolean enum members need to be initialized. Use either \`${memberName2} = true,\` or \`${memberName2} = false,\` in enum \`${enumName}\`.`,
+      }) => `Boolean enum members need to be initialized. Use either \`${memberName3} = true,\` or \`${memberName3} = false,\` in enum \`${enumName}\`.`,
       EnumDuplicateMemberName: ({
-        memberName: memberName2,
+        memberName: memberName3,
         enumName
-      }) => `Enum member names need to be unique, but the name \`${memberName2}\` has already been used before in enum \`${enumName}\`.`,
+      }) => `Enum member names need to be unique, but the name \`${memberName3}\` has already been used before in enum \`${enumName}\`.`,
       EnumInconsistentMemberValues: ({
         enumName
       }) => `Enum \`${enumName}\` has inconsistent member initializers. Either use no initializers, or consistently use literals (either booleans, numbers, or strings) for all member initializers.`,
@@ -31246,26 +31246,26 @@ var require_lib2 = __commonJS({
       }) => `Supplied enum type is not valid. Use one of \`boolean\`, \`number\`, \`string\`, or \`symbol\` in enum \`${enumName}\`.`,
       EnumInvalidMemberInitializerPrimaryType: ({
         enumName,
-        memberName: memberName2,
+        memberName: memberName3,
         explicitType
-      }) => `Enum \`${enumName}\` has type \`${explicitType}\`, so the initializer of \`${memberName2}\` needs to be a ${explicitType} literal.`,
+      }) => `Enum \`${enumName}\` has type \`${explicitType}\`, so the initializer of \`${memberName3}\` needs to be a ${explicitType} literal.`,
       EnumInvalidMemberInitializerSymbolType: ({
         enumName,
-        memberName: memberName2
-      }) => `Symbol enum members cannot be initialized. Use \`${memberName2},\` in enum \`${enumName}\`.`,
+        memberName: memberName3
+      }) => `Symbol enum members cannot be initialized. Use \`${memberName3},\` in enum \`${enumName}\`.`,
       EnumInvalidMemberInitializerUnknownType: ({
         enumName,
-        memberName: memberName2
-      }) => `The enum member initializer for \`${memberName2}\` needs to be a literal (either a boolean, number, or string) in enum \`${enumName}\`.`,
+        memberName: memberName3
+      }) => `The enum member initializer for \`${memberName3}\` needs to be a literal (either a boolean, number, or string) in enum \`${enumName}\`.`,
       EnumInvalidMemberName: ({
         enumName,
-        memberName: memberName2,
+        memberName: memberName3,
         suggestion
-      }) => `Enum member names cannot start with lowercase 'a' through 'z'. Instead of using \`${memberName2}\`, consider using \`${suggestion}\`, in enum \`${enumName}\`.`,
+      }) => `Enum member names cannot start with lowercase 'a' through 'z'. Instead of using \`${memberName3}\`, consider using \`${suggestion}\`, in enum \`${enumName}\`.`,
       EnumNumberMemberNotInitialized: ({
         enumName,
-        memberName: memberName2
-      }) => `Number enum members need to be initialized, e.g. \`${memberName2} = 1\` in enum \`${enumName}\`.`,
+        memberName: memberName3
+      }) => `Number enum members need to be initialized, e.g. \`${memberName3} = 1\` in enum \`${enumName}\`.`,
       EnumStringMemberInconsistentlyInitialized: ({
         enumName
       }) => `String enum members need to consistently either all use initializers, or use no initializers, in enum \`${enumName}\`.`,
@@ -33262,10 +33262,10 @@ var require_lib2 = __commonJS({
       }
       flowEnumErrorBooleanMemberNotInitialized(loc, {
         enumName,
-        memberName: memberName2
+        memberName: memberName3
       }) {
         this.raise(FlowErrors.EnumBooleanMemberNotInitialized, loc, {
-          memberName: memberName2,
+          memberName: memberName3,
           enumName
         });
       }
@@ -33377,28 +33377,28 @@ var require_lib2 = __commonJS({
             id,
             init
           } = this.flowEnumMemberRaw();
-          const memberName2 = id.name;
-          if (memberName2 === "") {
+          const memberName3 = id.name;
+          if (memberName3 === "") {
             continue;
           }
-          if (/^[a-z]/.test(memberName2)) {
+          if (/^[a-z]/.test(memberName3)) {
             this.raise(FlowErrors.EnumInvalidMemberName, id, {
-              memberName: memberName2,
-              suggestion: memberName2[0].toUpperCase() + memberName2.slice(1),
+              memberName: memberName3,
+              suggestion: memberName3[0].toUpperCase() + memberName3.slice(1),
               enumName
             });
           }
-          if (seenNames.has(memberName2)) {
+          if (seenNames.has(memberName3)) {
             this.raise(FlowErrors.EnumDuplicateMemberName, id, {
-              memberName: memberName2,
+              memberName: memberName3,
               enumName
             });
           }
-          seenNames.add(memberName2);
+          seenNames.add(memberName3);
           const context = {
             enumName,
             explicitType,
-            memberName: memberName2
+            memberName: memberName3
           };
           memberNode.id = id;
           switch (init.type) {
@@ -50287,7 +50287,7 @@ function resolveAliasDisplayName(alias) {
   if (!slug) return void 0;
   return CANONICAL_FONT_DISPLAY_NAMES[slug];
 }
-var recast, import_parser2, CANVAS_DIMENSIONS, VALID_CANVAS_RESOLUTIONS, RESOLUTION_ALIASES, ASPECT_AGNOSTIC_RESOLUTION_ALIASES, PROPERTY_GROUPS, PROP_TO_GROUP, COMPOSITION_ATTRIBUTES, CANONICAL_AUTHORED_TIMING_ATTRIBUTES, DERIVED_TIMING_ATTRIBUTES, LEGACY_TIMING_ATTRIBUTES, OK, HTML_BODY_CSS_WIDTH_FIRST_RE, HTML_BODY_CSS_HEIGHT_FIRST_RE, VIEWPORT_META_SIZE_RE, FONT_ALIAS_MAP, FONT_ALIAS_KEYS, CANONICAL_FONT_DISPLAY_NAMES;
+var recast, import_parser2, CANVAS_DIMENSIONS, VALID_CANVAS_RESOLUTIONS, RESOLUTION_ALIASES, ASPECT_AGNOSTIC_RESOLUTION_ALIASES, PROPERTY_GROUPS, PROP_TO_GROUP, COMPOSITION_ATTRIBUTES, CANONICAL_AUTHORED_TIMING_ATTRIBUTES, DERIVED_TIMING_ATTRIBUTES, LEGACY_TIMING_ATTRIBUTES, OK, HTML_BODY_CSS_WIDTH_FIRST_RE, HTML_BODY_CSS_HEIGHT_FIRST_RE, FONT_ALIAS_MAP, FONT_ALIAS_KEYS, CANONICAL_FONT_DISPLAY_NAMES;
 var init_dist = __esm({
   "../parsers/dist/index.js"() {
     "use strict";
@@ -50367,7 +50367,6 @@ var init_dist = __esm({
     OK = { ok: true };
     HTML_BODY_CSS_WIDTH_FIRST_RE = /(html\s*,\s*body\s*\{[^}]*?width:\s*)(\d+)px([^}]*?height:\s*)(\d+)px/i;
     HTML_BODY_CSS_HEIGHT_FIRST_RE = /(html\s*,\s*body\s*\{[^}]*?height:\s*)(\d+)px([^}]*?width:\s*)(\d+)px/i;
-    VIEWPORT_META_SIZE_RE = /(<meta[^>]*name=["']viewport["'][^>]*content=["']width=)(\d+)(,\s*height=)(\d+)/i;
     FONT_ALIAS_MAP = {
       // ── Canonical bundled fonts (self-referencing) ────────────────────────
       inter: "inter",
@@ -65981,12 +65980,84 @@ function isSafeMediaUrl(url) {
   if (proto === "data") return /^data:image\//i.test(normalized2);
   return false;
 }
-var CANVAS_DIMENSIONS2, VALID_CANVAS_RESOLUTIONS2, COMPOSITION_VARIABLE_TYPES2, FONT_ALIAS_MAP2, FONT_ALIAS_KEYS2, CANONICAL_FONT_DISPLAY_NAMES2, COMPOSITION_ATTRIBUTES4, CANONICAL_AUTHORED_TIMING_ATTRIBUTES4, DERIVED_TIMING_ATTRIBUTES4, LEGACY_TIMING_ATTRIBUTES4;
+function parseProgram(script) {
+  try {
+    return parse7(script, { ecmaVersion: "latest", sourceType: "script" });
+  } catch {
+    return parse7(script, { ecmaVersion: "latest", sourceType: "module" });
+  }
+}
+function literalString2(node) {
+  if (node?.type === "Literal" && typeof node.value === "string") return node.value;
+  if (node?.type === "TemplateLiteral" && node.expressions?.length === 0) {
+    return node.quasis?.[0]?.value?.cooked;
+  }
+  return void 0;
+}
+function memberName2(node) {
+  if (node?.type !== "MemberExpression") return void 0;
+  if (!node.computed && node.property?.type === "Identifier") return node.property.name;
+  return literalString2(node.property);
+}
+function lookupSelector2(node, bindings) {
+  if (node?.type === "Identifier") return bindings.get(node.name);
+  if (node?.type !== "CallExpression" || node.callee?.type !== "MemberExpression") {
+    return void 0;
+  }
+  const method = memberName2(node.callee);
+  if (method !== "getElementById" && method !== "querySelector") return void 0;
+  const value = literalString2(node.arguments?.[0]);
+  if (!value) return void 0;
+  return method === "getElementById" ? `#${value}` : value;
+}
+function extractMediaSrcMutations2(script) {
+  try {
+    const ast = parseProgram(script);
+    const bindings = /* @__PURE__ */ new Map();
+    simple(ast, {
+      VariableDeclarator(node) {
+        if (node.id?.type !== "Identifier") return;
+        const selector = lookupSelector2(node.init, bindings);
+        if (selector) bindings.set(node.id.name, selector);
+      }
+    });
+    const mutations = [];
+    simple(ast, {
+      AssignmentExpression(node) {
+        if (node.operator !== "=" || memberName2(node.left) !== "src") return;
+        const selector = lookupSelector2(node.left.object, bindings);
+        if (!selector) return;
+        mutations.push({
+          selector,
+          operation: "src_assignment",
+          raw: script.slice(node.start, node.end)
+        });
+      },
+      CallExpression(node) {
+        if (memberName2(node.callee) !== "setAttribute") return;
+        if (literalString2(node.arguments?.[0])?.toLowerCase() !== "src") return;
+        const selector = lookupSelector2(node.callee.object, bindings);
+        if (!selector) return;
+        mutations.push({
+          selector,
+          operation: "set_attribute",
+          raw: script.slice(node.start, node.end)
+        });
+      }
+    });
+    return mutations;
+  } catch {
+    return [];
+  }
+}
+var CANVAS_DIMENSIONS2, VALID_CANVAS_RESOLUTIONS2, COMPOSITION_VARIABLE_TYPES2, FONT_ALIAS_MAP2, FONT_ALIAS_KEYS2, CANONICAL_FONT_DISPLAY_NAMES2, COMPOSITION_ATTRIBUTES4, CANONICAL_AUTHORED_TIMING_ATTRIBUTES4, DERIVED_TIMING_ATTRIBUTES4, LEGACY_TIMING_ATTRIBUTES4, HTML_BODY_CSS_WIDTH_FIRST_RE2, HTML_BODY_CSS_HEIGHT_FIRST_RE2, VIEWPORT_META_SIZE_RE;
 var init_composition = __esm({
   "../parsers/dist/composition.js"() {
     "use strict";
     init_acorn();
     init_walk();
+    init_acorn();
+    init_walk();
     CANVAS_DIMENSIONS2 = {
       landscape: { width: 1920, height: 1080 },
       portrait: { width: 1080, height: 1920 },
@@ -66125,6 +66196,9 @@ var init_composition = __esm({
       COMPOSITION_ATTRIBUTES4.derivedEnd,
       COMPOSITION_ATTRIBUTES4.legacyTrack
     ]);
+    HTML_BODY_CSS_WIDTH_FIRST_RE2 = /(html\s*,\s*body\s*\{[^}]*?width:\s*)(\d+)px([^}]*?height:\s*)(\d+)px/i;
+    HTML_BODY_CSS_HEIGHT_FIRST_RE2 = /(html\s*,\s*body\s*\{[^}]*?height:\s*)(\d+)px([^}]*?width:\s*)(\d+)px/i;
+    VIEWPORT_META_SIZE_RE = /(<meta[^>]*name=["']viewport["'][^>]*content=["']width=)(\d+)(,\s*height=)(\d+)/i;
   }
 });
 
@@ -70930,7 +71004,7 @@ function getObjectArrayKeyframeTiming(durations) {
     )
   };
 }
-function parseProgram(script) {
+function parseProgram3(script) {
   try {
     return parse7(script, {
       ecmaVersion: "latest",
@@ -72087,7 +72161,7 @@ function parseGsapScriptAcornForWrite(script) {
 }
 function parseGsapScriptAcorn(script) {
   try {
-    const ast = parseProgram(script);
+    const ast = parseProgram3(script);
     const scope = collectScopeBindings(ast);
     const detection = findTimelineVar(ast, scope);
     const ref2 = detection.ref ?? { kind: "identifier", name: "tl" };
@@ -72135,7 +72209,7 @@ function parseGsapScriptAcorn(script) {
 }
 function gsapScriptMotionPathFirstUseIndex(script) {
   try {
-    const ast = parseProgram(script);
+    const ast = parseProgram3(script);
     const scope = collectScopeBindings(ast);
     const identifierBindings = collectIdentifierBindingIndex(ast);
     const timelineRef = findTimelineVar(ast, scope).ref;
@@ -72319,6 +72393,7 @@ var init_gsapParserAcorn = __esm({
 // ../lint/dist/index.js
 import postcss2 from "postcss";
 import postcss22 from "postcss";
+import postcss3 from "postcss";
 function parseHtmlStructure(source) {
   const tags = [];
   const blocks = { script: [], style: [] };
@@ -72363,6 +72438,7 @@ function parseHtmlStructure(source) {
         blocks[name].push({
           attrs: block.attrs,
           content: source.slice(block.contentStart, parser.startIndex),
+          contentStart: block.contentStart,
           raw: source.slice(block.index, parser.endIndex + 1),
           index: block.index
         });
@@ -72512,11 +72588,17 @@ function readTimelineRegistryTopLevelKeys(source) {
 function getInlineScriptSyntaxError(source) {
   if (!source.trim()) return null;
   try {
-    new Function(source);
+    parse7(source, {
+      ecmaVersion: "latest",
+      sourceType: "script",
+      allowReturnOutsideFunction: true
+    });
     return null;
   } catch (error) {
-    if (error instanceof Error) return error.message;
-    return String(error);
+    return {
+      message: error instanceof Error ? error.message : String(error),
+      offset: error instanceof SyntaxError && "pos" in error && typeof error.pos === "number" ? error.pos : void 0
+    };
   }
 }
 function stripStringLiterals(source) {
@@ -72788,7 +72870,7 @@ function stripCssComments(source) {
   }
   return out;
 }
-function stripHtmlCommentsOnce(source) {
+function stripHtmlCommentsOnce(source, removed) {
   let out = "";
   let i = 0;
   for (; ; ) {
@@ -72797,14 +72879,17 @@ function stripHtmlCommentsOnce(source) {
     const end = source.indexOf("-->", start + 4);
     if (end < 0) return out + source.slice(i);
     out += source.slice(i, start);
+    removed?.(start, end + 3);
     i = end + 3;
   }
 }
-function stripHtmlComments(source) {
+function stripHtmlComments(source, pass) {
   let out = source;
   for (let prev = ""; prev !== out; ) {
     prev = out;
-    out = stripHtmlCommentsOnce(out);
+    const ranges = [];
+    out = stripHtmlCommentsOnce(out, pass ? (start, end) => ranges.push([start, end]) : void 0);
+    if (ranges.length) pass?.(ranges);
   }
   return out;
 }
@@ -72875,9 +72960,39 @@ function snippetOffset(source, snippet) {
   if (index < 0 || source.text.indexOf(needle, index + 1) >= 0) return void 0;
   return source.offsets[index];
 }
+function mappedHtmlSource(original) {
+  let offsets;
+  const source = stripHtmlComments(original, (ranges) => {
+    const previous = offsets;
+    const length = (previous?.length ?? original.length + 1) - ranges.reduce((n, [a, b]) => n + b - a, 0);
+    offsets = new Uint32Array(length);
+    let target = 0;
+    let start = 0;
+    const spans = [
+      ...ranges,
+      [previous ? previous.length : original.length + 1, 0]
+    ];
+    for (const [a, b] of spans) {
+      for (let i = start; i < a; i++) offsets[target++] = previous ? previous[i] : i;
+      start = b;
+    }
+  });
+  return { source, originalOffset: (index) => offsets ? offsets[index] : index };
+}
+function sourcePosition(source, offset3, file) {
+  if (!Number.isInteger(offset3) || offset3 < 0 || offset3 > source.length) return {};
+  const before2 = source.slice(0, offset3);
+  return {
+    ...file ? { file } : {},
+    line: before2.split(/\r\n|\r|\n/).length,
+    column: offset3 - Math.max(before2.lastIndexOf("\n"), before2.lastIndexOf("\r"))
+  };
+}
 function buildLintContext(html, options = {}) {
   const rawSource = html || "";
-  let source = stripHtmlComments(rawSource);
+  const mapped = mappedHtmlSource(rawSource);
+  let source = mapped.source;
+  let sourceStart = 0;
   const initialStructure = parseHtmlStructure(source);
   const templateTags = initialStructure.tags.filter(
     (tag) => tag.name === "template" && tag.closeIndex != null
@@ -72890,7 +73005,8 @@ function buildLintContext(html, options = {}) {
   const template = templateTags[0];
   let structure = initialStructure;
   if (template && !findRootTag(sourceWithoutTemplates)) {
-    source = source.slice(template.index + template.raw.length, template.closeIndex);
+    sourceStart = template.index + template.raw.length;
+    source = source.slice(sourceStart, template.closeIndex);
     structure = parseHtmlStructure(source);
   }
   const tags = structure.tags;
@@ -72900,14 +73016,23 @@ function buildLintContext(html, options = {}) {
       attrs: `href="${style.href}"`,
       content: style.content,
       raw: style.content,
-      index: -1
+      index: -1,
+      file: style.file ?? style.href
     }))
   ];
   const scripts = structure.scripts;
   const compositionIds = collectCompositionIds(tags);
   const rootTag = findRootTag(source, tags);
   const rootCompositionId = readDecodedAttr(rootTag?.raw || "", "data-composition-id");
+  const locate = (block, offset3) => {
+    if (offset3 === void 0 || offset3 < 0 || offset3 > block.content.length) return {};
+    if (block.index === -1) return sourcePosition(block.content, offset3, block.file);
+    if (block.contentStart === void 0) return {};
+    const originalOffset = mapped.originalOffset(sourceStart + block.contentStart + offset3);
+    return originalOffset === void 0 ? {} : sourcePosition(rawSource, originalOffset, options.filePath);
+  };
   return {
+    locate,
     source,
     rawSource,
     tags,
@@ -73090,12 +73215,12 @@ function findVisibleMarkupCommentLeak(source) {
   return null;
 }
 function readHtmlBodyCssSize(source) {
-  const widthFirst = source.match(HTML_BODY_CSS_WIDTH_FIRST_RE);
+  const widthFirst = source.match(HTML_BODY_CSS_WIDTH_FIRST_RE2);
   if (widthFirst) {
     const [, , width = "", , height = ""] = widthFirst;
     return { width, height };
   }
-  const heightFirst = source.match(HTML_BODY_CSS_HEIGHT_FIRST_RE);
+  const heightFirst = source.match(HTML_BODY_CSS_HEIGHT_FIRST_RE2);
   if (heightFirst) {
     const [, , height = "", , width = ""] = heightFirst;
     return { width, height };
@@ -73139,6 +73264,20 @@ function describeRootDimensionsDrift(source, dataWidth, dataHeight) {
     fixHint: "update html/body CSS and the meta viewport to match, or scaffold with `hyperframes init --resolution portrait`"
   };
 }
+function cssErrorOffset(source, error) {
+  if (error.input && "offset" in error.input && typeof error.input.offset === "number")
+    return error.input.offset;
+  const { line, column } = error;
+  if (line === void 0 || column === void 0) return void 0;
+  let offset3 = 0;
+  let currentLine = 1;
+  for (const match of source.matchAll(/\n/g)) {
+    if (currentLine >= line) break;
+    offset3 = match.index + 1;
+    currentLine++;
+  }
+  return currentLine === line ? offset3 + column - 1 : void 0;
+}
 function tweensVolumeInSameCall(script, id) {
   const selector = new RegExp(`#${escapeRegExp3(id)}(?![\\w-])`, "g");
   for (let hit = selector.exec(script); hit; hit = selector.exec(script)) {
@@ -73398,7 +73537,7 @@ function findRuntimeMediaSrcMutationFindings(ctx) {
   const { document: document2 } = parseHTML(ctx.source);
   const findings = [];
   for (const script of ctx.scripts) {
-    for (const mutation of extractMediaSrcMutations(script.content)) {
+    for (const mutation of extractMediaSrcMutations2(script.content)) {
       let targets;
       try {
         const id = /^#[A-Za-z_][\w-]*$/.test(mutation.selector) ? mutation.selector.slice(1) : null;
@@ -73577,6 +73716,40 @@ function findAudioGroupCarveAttrFindings(ctx) {
   }
   return findings;
 }
+function callsFor(script) {
+  const cached2 = callIndexes.get(script);
+  if (cached2) return cached2;
+  const calls = [];
+  try {
+    const ast = parse7(script.content, {
+      ecmaVersion: "latest",
+      sourceType: "script",
+      allowReturnOutsideFunction: true
+    });
+    simple(ast, {
+      CallExpression: (node) => {
+        calls.push(node);
+      }
+    });
+  } catch {
+  }
+  calls.sort((a, b) => a.start - b.start);
+  callIndexes.set(script, calls);
+  return calls;
+}
+function gsapCallOffset(script, method) {
+  return callsFor(script).find(
+    ({ callee }) => callee.type === "MemberExpression" && !callee.computed && callee.object.type === "Identifier" && callee.object.name === "gsap" && callee.property.type === "Identifier" && callee.property.name === method
+  )?.start;
+}
+function containingCallOffset(script, tokenOffset) {
+  let start;
+  for (const call of callsFor(script)) {
+    if (call.start > tokenOffset) break;
+    if (call.end > tokenOffset) start = call.start;
+  }
+  return start;
+}
 function readTagTiming(rawTag) {
   return readClipTiming({ getAttribute: (name) => readAttr(rawTag, name) });
 }
@@ -74074,7 +74247,7 @@ function scanScriptsForRegexMatches(scripts, pattern, options) {
         content.length,
         match.index + match[0].length + options.contextAfter
       );
-      hits.push({ match, snippet: content.slice(contextStart, contextEnd) });
+      hits.push({ match, snippet: content.slice(contextStart, contextEnd), script });
     }
   }
   return hits;
@@ -74581,6 +74754,26 @@ function collectGoogleFontFamilies(source, styles) {
   }
   return families;
 }
+function uniqueFontLocation(styles, families, locate) {
+  const locations = [];
+  for (const style of styles) {
+    try {
+      postcss3.parse(style.content).walkDecls(/^font-family$/i, (decl) => {
+        let parent = decl.parent;
+        while (parent) {
+          if (parent.type === "atrule" && parent.name.toLowerCase() === "font-face") return;
+          parent = parent.parent;
+        }
+        if (!decl.value.split(",").some((part) => families.includes(normalizeUsedFontName(part) ?? "")))
+          return;
+        locations.push(locate(style, decl.source?.start?.offset));
+      });
+    } catch {
+      return {};
+    }
+  }
+  return locations.length === 1 ? locations[0] : {};
+}
 function parseTiming(raw) {
   const startStr = readAttr(raw, "data-start");
   if (startStr === null) return null;
@@ -74734,7 +74927,7 @@ function collectFindings(produced, seen, filePath, into) {
     const dedupeKey = dedupeKeyFor(finding);
     if (seen.has(dedupeKey)) continue;
     seen.add(dedupeKey);
-    into.push(filePath ? { ...finding, file: filePath } : finding);
+    into.push(filePath ? { ...finding, file: finding.file ?? filePath } : finding);
   }
 }
 async function lintHyperframeHtml(html, options = {}) {
@@ -74743,6 +74936,12 @@ async function lintHyperframeHtml(html, options = {}) {
   const { findings: rawFindings, timings } = await runRules(ctx, options.filePath);
   const locate = createSourceLocator(html);
   const findings = rawFindings.map((finding) => {
+    if (finding.line !== void 0 || finding.code === "invalid_inline_script_syntax" || finding.code === "non_deterministic_code" || [
+      "gsap_infinite_repeat",
+      "gsap_repeat_ceil_overshoot",
+      "gsap_repeat_floor_unclamped"
+    ].includes(finding.code))
+      return finding;
     if (finding.snippet && options.externalStyles?.some(
       (style) => style.content.replace(/\s+/g, " ").includes(finding.snippet.replace(/\.\.\.$/, ""))
     ))
@@ -74761,17 +74960,20 @@ async function lintHyperframeHtml(html, options = {}) {
     timings: { totalMs: performance.now() - startedAt, ...timings }
   };
 }
-var import_postcss_selector_parser, COMPOSITION_ID_IN_CSS_PATTERN, TIMELINE_REGISTRY_INIT_PATTERN, TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN, TIMELINE_REGISTRY_ASSIGN_PATTERN, WINDOW_TIMELINE_ASSIGN_PATTERN, INVALID_SCRIPT_CLOSE_PATTERN, TIMELINE_REGISTRY_KEY_PATTERN, TIMELINE_REGISTRY_OBJECT_OPEN_PATTERN, TIMELINE_REGISTRY_OBJECT_ENTRY_PATTERN, REGEX_ALLOWED_BEFORE, REGEX_ALLOWED_KEYWORDS, WORD_CHAR, CodeContext, VISIBLE_MARKUP_COMMENT_PATTERN, VISIBLE_MARKUP_COMMENT_PROTECTED_BLOCK_PATTERN, coreRules, IMAGE_SRC_EXT, VIDEO_SRC_EXT, AUDIO_SRC_EXT, SRC_KIND_NOUN, mediaRules, AUDIO_GROUP_TIMING_ATTRS, MAX_COMPOSITION_LINES, MAX_TIMED_ELEMENTS_PER_TRACK, TRACK_DENSITY_EXEMPT_TAGS, CAPTION_CUE_TOKEN, HEAVY_OVERLAY_ELEMENT_COUNT_WARN, HEAVY_OVERLAY_EXEMPT_TAGS, HEAVY_OVERLAY_CSS_PATTERN, INLINE_STYLE_DISPLAY_NONE_PATTERN, compositionRules, CLIP_MEDIA_TAGS, SCENE_BOUNDARY_EPSILON_SECONDS, UNRESOLVED_TARGET, gsapWindowsCache, CONFLICTING_TRANSLATE_PROPS, CONFLICTING_SCALE_PROPS, RELATIVE_TWEEN_VALUE, TRANSFORM_SENSITIVE_READ, TRANSFORM_INVARIANT_READ, CALLBACK_MEASUREMENT_PATTERN, NUMBER_METHODS, gsapRules, captionRules, adapterRules, TEXTURE_BASE_CLASS, TEXTURE_CLASS_PREFIX, textureRules, GENERIC_FAMILIES, fontRules, slideshowRules, INLINE_TEXT_TAGS, OPAQUE_TAGS, NON_LAYOUT_TAGS, MEDIA_TAGS2, NODE_ATTRS, describe, structureRules, RULE_GROUPS, LINT_RULE_COUNT, LINT_RULE_GROUP_COUNTS;
+var import_postcss_selector_parser, COMPOSITION_ID_IN_CSS_PATTERN, TIMELINE_REGISTRY_INIT_PATTERN, TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN, TIMELINE_REGISTRY_ASSIGN_PATTERN, WINDOW_TIMELINE_ASSIGN_PATTERN, INVALID_SCRIPT_CLOSE_PATTERN, TIMELINE_REGISTRY_KEY_PATTERN, TIMELINE_REGISTRY_OBJECT_OPEN_PATTERN, TIMELINE_REGISTRY_OBJECT_ENTRY_PATTERN, REGEX_ALLOWED_BEFORE, REGEX_ALLOWED_KEYWORDS, WORD_CHAR, CodeContext, VISIBLE_MARKUP_COMMENT_PATTERN, VISIBLE_MARKUP_COMMENT_PROTECTED_BLOCK_PATTERN, coreRules, IMAGE_SRC_EXT, VIDEO_SRC_EXT, AUDIO_SRC_EXT, SRC_KIND_NOUN, mediaRules, AUDIO_GROUP_TIMING_ATTRS, callIndexes, MAX_COMPOSITION_LINES, MAX_TIMED_ELEMENTS_PER_TRACK, TRACK_DENSITY_EXEMPT_TAGS, CAPTION_CUE_TOKEN, HEAVY_OVERLAY_ELEMENT_COUNT_WARN, HEAVY_OVERLAY_EXEMPT_TAGS, HEAVY_OVERLAY_CSS_PATTERN, INLINE_STYLE_DISPLAY_NONE_PATTERN, compositionRules, CLIP_MEDIA_TAGS, SCENE_BOUNDARY_EPSILON_SECONDS, UNRESOLVED_TARGET, gsapWindowsCache, CONFLICTING_TRANSLATE_PROPS, CONFLICTING_SCALE_PROPS, RELATIVE_TWEEN_VALUE, TRANSFORM_SENSITIVE_READ, TRANSFORM_INVARIANT_READ, CALLBACK_MEASUREMENT_PATTERN, NUMBER_METHODS, gsapRules, captionRules, adapterRules, TEXTURE_BASE_CLASS, TEXTURE_CLASS_PREFIX, textureRules, GENERIC_FAMILIES, fontRules, slideshowRules, INLINE_TEXT_TAGS, OPAQUE_TAGS, NON_LAYOUT_TAGS, MEDIA_TAGS2, NODE_ATTRS, describe, structureRules, RULE_GROUPS, LINT_RULE_COUNT, LINT_RULE_GROUP_COUNTS;
 var init_dist3 = __esm({
   "../lint/dist/index.js"() {
     "use strict";
     init_esm6();
     init_esm6();
+    init_acorn();
     import_postcss_selector_parser = __toESM(require_dist(), 1);
-    init_dist();
+    init_composition();
     init_colorGradingContract();
-    init_dist();
+    init_composition();
     init_esm10();
+    init_acorn();
+    init_walk();
     init_composition();
     init_compositionContract();
     init_compositionDuration();
@@ -74994,7 +75196,7 @@ var init_dist3 = __esm({
         return findings;
       },
       // CSS selector safety
-      ({ styles }) => {
+      ({ styles, locate }) => {
         const findings = [];
         const reportedRepeatedIds = /* @__PURE__ */ new Set();
         const reportedHiddenStyleSelectors = /* @__PURE__ */ new Set();
@@ -75004,6 +75206,10 @@ var init_dist3 = __esm({
             root = postcss2.parse(style.content);
           } catch (error) {
             findings.push({
+              ...locate(
+                style,
+                error instanceof postcss2.CssSyntaxError ? cssErrorOffset(style.content, error) : void 0
+              ),
               code: "css_parse_error",
               severity: "error",
               message: `CSS parse error: ${error instanceof Error ? error.message : "unknown"}`
@@ -75069,7 +75275,7 @@ var init_dist3 = __esm({
         ];
       },
       // invalid_inline_script_syntax (JS parse error)
-      ({ scripts }) => {
+      ({ scripts, locate }) => {
         const findings = [];
         for (const script of scripts) {
           const attrs = script.attrs || "";
@@ -75080,9 +75286,10 @@ var init_dist3 = __esm({
           const syntaxError = getInlineScriptSyntaxError(script.content);
           if (!syntaxError) continue;
           findings.push({
+            ...locate(script, syntaxError.offset),
             code: "invalid_inline_script_syntax",
             severity: "error",
-            message: `Inline script has invalid syntax: ${syntaxError}`,
+            message: `Inline script has invalid syntax: ${syntaxError.message}`,
             fixHint: "Fix the inline script syntax before render verification.",
             snippet: truncateSnippet(script.content)
           });
@@ -75148,7 +75355,7 @@ var init_dist3 = __esm({
         return findings;
       },
       // non_deterministic_code
-      ({ scripts }) => {
+      ({ scripts, locate }) => {
         const findings = [];
         const patterns = [
           {
@@ -75199,8 +75406,10 @@ var init_dist3 = __esm({
           const withoutComments = stripJsComments(script.content);
           const executable = stripStringLiterals(withoutComments);
           for (const { pattern, label, hint, scansStrings } of patterns) {
-            if (pattern.test(scansStrings ? withoutComments : executable)) {
+            const match = pattern.exec(scansStrings ? withoutComments : executable);
+            if (match) {
               findings.push({
+                ...locate(script, match.index),
                 code: "non_deterministic_code",
                 severity: "error",
                 message: `Script contains \`${label}\` which produces non-deterministic output. Renders may differ between frames or runs.`,
@@ -75631,6 +75840,7 @@ var init_dist3 = __esm({
       findAudioGroupCarveAttrFindings
     ];
     AUDIO_GROUP_TIMING_ATTRS = ["data-start", "data-duration", "data-track-index"];
+    callIndexes = /* @__PURE__ */ new WeakMap();
     MAX_COMPOSITION_LINES = 300;
     MAX_TIMED_ELEMENTS_PER_TRACK = 3;
     TRACK_DENSITY_EXEMPT_TAGS = /* @__PURE__ */ new Set(["audio", "script", "style", "video"]);
@@ -76763,19 +76973,20 @@ ${right.raw}`)
         return findings;
       },
       // gsap_infinite_repeat
-      ({ scripts, rootTag }) => {
+      ({ scripts, rootTag, locate }) => {
         const findings = [];
         const declaredDuration = Number.parseFloat(
           rootTag ? readAttr(rootTag.raw, "data-duration") ?? "" : ""
         );
         const hasFiniteCompositionWindow = Number.isFinite(declaredDuration) && declaredDuration > 0;
         const pattern = /repeat\s*:\s*-1(?!\d)/g;
-        for (const { snippet } of scanScriptsForRegexMatches(scripts, pattern, {
+        for (const { snippet, match, script } of scanScriptsForRegexMatches(scripts, pattern, {
           stripComments: true,
           contextBefore: 60,
           contextAfter: 60
         })) {
           findings.push({
+            ...locate(script, containingCallOffset(script, match.index)),
             code: "gsap_infinite_repeat",
             severity: hasFiniteCompositionWindow ? "warning" : "error",
             message: hasFiniteCompositionWindow ? `GSAP tween uses \`repeat: -1\` (infinite), but the composition declares a finite ${declaredDuration}s window. HyperFrames clips deterministic seeking and export to that explicit duration.` : "GSAP tween uses `repeat: -1` (infinite) without a finite composition `data-duration`. The timeline can report an unbounded duration and make render planning fail.",
@@ -76786,15 +76997,16 @@ ${right.raw}`)
         return findings;
       },
       // gsap_repeat_ceil_overshoot
-      ({ scripts }) => {
+      ({ scripts, locate }) => {
         const findings = [];
         const pattern = /repeat\s*:\s*Math\.ceil\s*\([^)]+\)\s*-\s*1/g;
-        for (const { snippet } of scanScriptsForRegexMatches(scripts, pattern, {
+        for (const { snippet, match, script } of scanScriptsForRegexMatches(scripts, pattern, {
           stripComments: false,
           contextBefore: 40,
           contextAfter: 40
         })) {
           findings.push({
+            ...locate(script, containingCallOffset(script, match.index)),
             code: "gsap_repeat_ceil_overshoot",
             severity: "warning",
             message: "GSAP repeat calculation uses `Math.ceil` which can overshoot the composition duration. For example, Math.ceil(10.5 / 2) - 1 = 5 repeats \u2192 6 cycles \xD7 2s = 12s, exceeding 10.5s.",
@@ -76805,15 +77017,16 @@ ${right.raw}`)
         return findings;
       },
       // gsap_repeat_floor_unclamped
-      ({ scripts }) => {
+      ({ scripts, locate }) => {
         const findings = [];
         const pattern = /repeat\s*:\s*Math\.floor\s*\([^)]+\)\s*-\s*1/g;
-        for (const { snippet } of scanScriptsForRegexMatches(scripts, pattern, {
+        for (const { snippet, match, script } of scanScriptsForRegexMatches(scripts, pattern, {
           stripComments: false,
           contextBefore: 40,
           contextAfter: 40
         })) {
           findings.push({
+            ...locate(script, containingCallOffset(script, match.index)),
             code: "gsap_repeat_floor_unclamped",
             severity: "warning",
             message: "GSAP repeat calculation can evaluate to -1 when the composition is shorter than one cycle, which GSAP interprets as an infinite repeat.",
@@ -76824,7 +77037,7 @@ ${right.raw}`)
         return findings;
       },
       // gsap_timeline_not_registered
-      ({ scripts, rawSource, options }) => {
+      ({ scripts, rawSource, options, locate }) => {
         const findings = [];
         const canInheritFromHost = options.isSubComposition || rawSource.trimStart().toLowerCase().startsWith("<template");
         for (const script of scripts) {
@@ -76833,6 +77046,7 @@ ${right.raw}`)
           const hasRegistration = WINDOW_TIMELINE_ASSIGN_PATTERN.test(content) || TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN.test(content);
           if (hasRegistration || canInheritFromHost) continue;
           findings.push({
+            ...locate(script, gsapCallOffset(script, "timeline")),
             code: "gsap_timeline_not_registered",
             severity: "error",
             message: "GSAP timeline is created but never registered in window.__timelines. The runtime discovers timelines from this registry \u2014 without registration, animations will not play during preview or render.",
@@ -77820,7 +78034,7 @@ ${other.raw}`)
         ];
       },
       // font_family_without_font_face
-      ({ styles, source, rawSource, options }) => {
+      ({ styles, source, rawSource, options, locate }) => {
         if (isRegistrySourceFile(options.filePath) || isRegistryInstalledFile(rawSource)) return [];
         const findings = [];
         const declared = extractFontFaceFamilies(styles);
@@ -77831,6 +78045,7 @@ ${other.raw}`)
         );
         if (undeclared.length === 0) return findings;
         findings.push({
+          ...uniqueFontLocation(styles, undeclared, locate),
           code: "font_family_without_font_face",
           severity: "error",
           message: `Font ${undeclared.length === 1 ? "family" : "families"} used without @font-face declaration: ${undeclared.join(", ")}. These are not in the auto-resolved font list, so the renderer cannot supply them automatically. Text will fall back to a generic font, producing incorrect typography in the video.`,
@@ -93068,7 +93283,7 @@ function dedupeVariants(variants) {
 init_esm10();
 init_fontData_generated();
 init_fontCompression();
-import postcss3 from "postcss";
+import postcss4 from "postcss";
 var GENERIC_FAMILIES2 = /* @__PURE__ */ new Set([
   "sans-serif",
   "serif",
@@ -93127,7 +93342,7 @@ function systemPrimaryReplacement(value, deterministicPrimary) {
 }
 function parseCssRoot(css) {
   try {
-    return postcss3.parse(css);
+    return postcss4.parse(css);
   } catch {
     return null;
   }
@@ -103507,8 +103722,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.67" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.67" : "0.0.0-dev";
+var VERSION = true ? "0.8.68" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.68" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {