@hyperframes/producer 0.2.4 → 0.3.0

package/dist/index.js

@@ -100088,8 +100088,30 @@ ${right2.raw}`)
         findings.push({
           code: "gsap_infinite_repeat",
           severity: "error",
-          message: "GSAP tween uses `repeat: -1` (infinite). Infinite repeats break the deterministic capture engine which seeks to exact frame times. Use a finite repeat count calculated from the composition duration: `repeat: Math.ceil(duration / cycleDuration) - 1`.",
-          fixHint: "Replace `repeat: -1` with a finite count, e.g. `repeat: Math.ceil(totalDuration / singleCycleDuration) - 1`.",
+          message: "GSAP tween uses `repeat: -1` (infinite). Infinite repeats break the deterministic capture engine which seeks to exact frame times. Use a finite repeat count calculated from the composition duration: `repeat: Math.floor(duration / cycleDuration) - 1`.",
+          fixHint: "Replace `repeat: -1` with a finite count, e.g. `repeat: Math.floor(totalDuration / singleCycleDuration) - 1`. Use Math.floor (not Math.ceil) to ensure the animation fits within the total duration.",
+          snippet: truncateSnippet(snippet)
+        });
+      }
+    }
+    return findings;
+  },
+  // gsap_repeat_ceil_overshoot
+  ({ scripts }) => {
+    const findings = [];
+    for (const script of scripts) {
+      const content = script.content;
+      const pattern = /repeat\s*:\s*Math\.ceil\s*\([^)]+\)\s*-\s*1/g;
+      let match2;
+      while ((match2 = pattern.exec(content)) !== null) {
+        const contextStart = Math.max(0, match2.index - 40);
+        const contextEnd = Math.min(content.length, match2.index + match2[0].length + 40);
+        const snippet = content.slice(contextStart, contextEnd).trim();
+        findings.push({
+          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.",
+          fixHint: "Use `Math.floor` instead of `Math.ceil` to ensure the animation fits within the duration: `repeat: Math.floor(totalDuration / cycleDuration) - 1`. Math.floor(10.5 / 2) - 1 = 4 repeats \u2192 5 cycles \xD7 2s = 10s \u2713",
           snippet: truncateSnippet(snippet)
         });
       }
@@ -100489,6 +100511,24 @@ var compositionRules = [
     }
     return findings;
   },
+  // root_composition_missing_data_duration
+  ({ rootTag }) => {
+    const findings = [];
+    if (!rootTag) return findings;
+    const compId = readAttr(rootTag.raw, "data-composition-id");
+    if (!compId) return findings;
+    const hasDuration = readAttr(rootTag.raw, "data-duration") !== null;
+    if (!hasDuration) {
+      findings.push({
+        code: "root_composition_missing_data_duration",
+        severity: "warning",
+        message: `Root composition "${compId}" is missing data-duration. Without an explicit duration, the runtime may infer Infinity for compositions with repeating animations, causing playback issues.`,
+        fixHint: 'Add data-duration="X" to the root composition element, where X is the total duration in seconds.',
+        snippet: truncateSnippet(rootTag.raw)
+      });
+    }
+    return findings;
+  },
   // standalone_composition_wrapped_in_template
   ({ rawSource, options }) => {
     const findings = [];
@@ -100505,18 +100545,20 @@ var compositionRules = [
     return findings;
   },
   // root_composition_missing_html_wrapper
-  ({ rawSource, options }) => {
+  ({ rawSource, rootTag, options }) => {
     const findings = [];
     if (options.isSubComposition) return findings;
     const trimmed = rawSource.trimStart().toLowerCase();
+    if (trimmed.startsWith("<template")) return findings;
     const hasDoctype = trimmed.startsWith("<!doctype") || trimmed.startsWith("<html");
     const hasComposition = rawSource.includes("data-composition-id");
     if (hasComposition && !hasDoctype) {
       findings.push({
         code: "root_composition_missing_html_wrapper",
-        severity: "warning",
-        message: "Composition is missing <!DOCTYPE html> and <html> wrapper. The bundler and preview expect a complete HTML document for index.html files.",
-        fixHint: 'Wrap the composition in <!DOCTYPE html><html><head><meta charset="UTF-8"></head><body>...</body></html>.'
+        severity: "error",
+        message: "Composition starts with a bare element instead of a proper HTML document. An index.html that contains data-composition-id but no <!DOCTYPE html>, <html>, or <body> is a fragment \u2014 browsers quirks-mode it, the preview server cannot load it, and the bundler will fail to inject runtime scripts.",
+        fixHint: 'Wrap the composition in <!DOCTYPE html><html><head><meta charset="UTF-8"></head><body>...</body></html>.',
+        snippet: rootTag ? truncateSnippet(rootTag.raw) : void 0
       });
     }
     return findings;
@@ -100702,12 +100744,12 @@ function quantizeTimeToFrame(timeSeconds, fps) {
   return frameIndex / safeFps;
 }
 
-// ../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/analysis.js
+// ../../node_modules/.bun/@chenglou+pretext@0.0.5/node_modules/@chenglou/pretext/dist/analysis.js
 var arabicScriptRe = new RegExp("\\p{Script=Arabic}", "u");
 var combiningMarkRe = new RegExp("\\p{M}", "u");
 var decimalDigitRe = new RegExp("\\p{Nd}", "u");
 
-// ../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/measurement.js
+// ../../node_modules/.bun/@chenglou+pretext@0.0.5/node_modules/@chenglou/pretext/dist/measurement.js
 var emojiPresentationRe = new RegExp("\\p{Emoji_Presentation}", "u");
 
 // ../engine/src/services/screenshotService.ts