hyperframes 0.2.4 → 0.3.0

package/dist/cli.js

@@ -54,7 +54,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.2.4" : "0.0.0-dev";
+    VERSION = true ? "0.3.0" : "0.0.0-dev";
   }
 });
 
@@ -4577,8 +4577,30 @@ ${right.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 match;
+          while ((match = pattern.exec(content)) !== null) {
+            const contextStart = Math.max(0, match.index - 40);
+            const contextEnd = Math.min(content.length, match.index + match[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)
             });
           }
@@ -4991,6 +5013,24 @@ var init_composition = __esm({
         }
         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 = [];
@@ -5007,18 +5047,20 @@ var init_composition = __esm({
         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;
@@ -20180,17 +20222,25 @@ var init_gsap2 = __esm({
   }
 });
 
-// ../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/bidi.js
+// ../../node_modules/.bun/@chenglou+pretext@0.0.5/node_modules/@chenglou/pretext/dist/generated/bidi-data.js
+var init_bidi_data = __esm({
+  "../../node_modules/.bun/@chenglou+pretext@0.0.5/node_modules/@chenglou/pretext/dist/generated/bidi-data.js"() {
+    "use strict";
+  }
+});
+
+// ../../node_modules/.bun/@chenglou+pretext@0.0.5/node_modules/@chenglou/pretext/dist/bidi.js
 var init_bidi = __esm({
-  "../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/bidi.js"() {
+  "../../node_modules/.bun/@chenglou+pretext@0.0.5/node_modules/@chenglou/pretext/dist/bidi.js"() {
     "use strict";
+    init_bidi_data();
   }
 });
 
-// ../../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, combiningMarkRe, decimalDigitRe;
 var init_analysis = __esm({
-  "../../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"() {
     "use strict";
     arabicScriptRe = new RegExp("\\p{Script=Arabic}", "u");
     combiningMarkRe = new RegExp("\\p{M}", "u");
@@ -20198,27 +20248,27 @@ var init_analysis = __esm({
   }
 });
 
-// ../../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;
 var init_measurement = __esm({
-  "../../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"() {
     "use strict";
     init_analysis();
     emojiPresentationRe = new RegExp("\\p{Emoji_Presentation}", "u");
   }
 });
 
-// ../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/line-break.js
+// ../../node_modules/.bun/@chenglou+pretext@0.0.5/node_modules/@chenglou/pretext/dist/line-break.js
 var init_line_break = __esm({
-  "../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/line-break.js"() {
+  "../../node_modules/.bun/@chenglou+pretext@0.0.5/node_modules/@chenglou/pretext/dist/line-break.js"() {
     "use strict";
     init_measurement();
   }
 });
 
-// ../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/layout.js
+// ../../node_modules/.bun/@chenglou+pretext@0.0.5/node_modules/@chenglou/pretext/dist/layout.js
 var init_layout = __esm({
-  "../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/layout.js"() {
+  "../../node_modules/.bun/@chenglou+pretext@0.0.5/node_modules/@chenglou/pretext/dist/layout.js"() {
     "use strict";
     init_bidi();
     init_analysis();
@@ -30671,7 +30721,8 @@ var init_help = __esm({
           [
             "transcribe",
             "Transcribe audio/video to word-level timestamps, or import an existing transcript"
-          ]
+          ],
+          ["tts", "Generate speech audio from text using a local AI model (Kokoro-82M)"]
         ]
       },
       {