hyperframes 0.8.37 → 0.8.38

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.8.37" : "0.0.0-dev";
+    VERSION = true ? "0.8.38" : "0.0.0-dev";
   }
 });
 
@@ -80970,10 +80970,6 @@ function targetHasNoStableIdentity(selector, identity) {
   if (identity) return false;
   return selector === UNRESOLVED_TARGET || selector === "dwell/hold" || selector.startsWith("proxy \u2192 ");
 }
-function readRegisteredTimelineCompositionId(script) {
-  const match = script.match(WINDOW_TIMELINE_ASSIGN_PATTERN);
-  return match?.[1] || match?.[2] || null;
-}
 function unwrapRaw(value) {
   if (typeof value === "number") return value;
   if (typeof value !== "string") return void 0;
@@ -81140,21 +81136,6 @@ function makesOverlayVisible(win) {
   if (win.method === "from" && isHiddenGsapState(win.propertyValues)) return true;
   return isVisibleGsapState(win.propertyValues);
 }
-function isSceneBoundaryExit(win) {
-  if (win.end <= win.position) return false;
-  if (win.method !== "to" && win.method !== "fromTo") return false;
-  return isHiddenGsapState(win.propertyValues);
-}
-function isHardKillSet(win, selector, boundary) {
-  return win.method === "set" && win.targetSelector === selector && Math.abs(win.position - boundary) <= SCENE_BOUNDARY_EPSILON_SECONDS && isHiddenGsapState(win.propertyValues);
-}
-function hiddenStateLiteral(values) {
-  if (zeroValue(values.autoAlpha)) return "{ autoAlpha: 0 }";
-  if (zeroValue(values.opacity)) return "{ opacity: 0 }";
-  if (stringValue(values.visibility)?.toLowerCase() === "hidden") return '{ visibility: "hidden" }';
-  if (stringValue(values.display)?.toLowerCase() === "none") return '{ display: "none" }';
-  return "{ opacity: 0 }";
-}
 function findTagEnd2(source, tag) {
   const escapedTagName = tag.name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const pattern = new RegExp(`<\\/?${escapedTagName}\\b[^>]*>`, "gi");
@@ -81171,56 +81152,11 @@ function findTagEnd2(source, tag) {
   }
   return source.length;
 }
-function collectCompositionRanges(source, tags) {
-  return tags.map((tag) => {
-    const id = readDecodedAttr(tag.raw, "data-composition-id");
-    if (!id) return null;
-    return {
-      id,
-      start: tag.index,
-      end: findTagEnd2(source, tag)
-    };
-  }).filter((range) => range !== null);
-}
-function findContainingCompositionId(tag, ranges) {
-  let match = null;
-  for (const range of ranges) {
-    if (tag.index < range.start || tag.index >= range.end) continue;
-    if (!match || range.start >= match.start) match = range;
-  }
-  return match?.id || null;
-}
 function getClipTagClasses(tag) {
   const classAttr = readAttr(tag.raw, "class") || "";
   const classes = classAttr.split(/\s+/).filter(Boolean);
   return classes.includes("clip") ? { classAttr, classes } : null;
 }
-function collectClipStartBoundariesByComposition(source, tags) {
-  const ranges = collectCompositionRanges(source, tags);
-  const boundaries = /* @__PURE__ */ new Map();
-  for (const tag of tags) {
-    if (!getClipTagClasses(tag)) continue;
-    const compositionId = findContainingCompositionId(tag, ranges);
-    if (!compositionId) continue;
-    const start = numberValue(readAttr(tag.raw, "data-start") ?? void 0);
-    if (start == null || start <= 0) continue;
-    const compositionBoundaries = boundaries.get(compositionId) ?? /* @__PURE__ */ new Set();
-    compositionBoundaries.add(start);
-    boundaries.set(compositionId, compositionBoundaries);
-  }
-  return new Map(
-    [...boundaries.entries()].map(([compositionId, values]) => [
-      compositionId,
-      [...values].sort((a, b2) => a - b2)
-    ])
-  );
-}
-function findMatchingSceneBoundary(time, boundaries) {
-  for (const boundary of boundaries) {
-    if (Math.abs(time - boundary) <= SCENE_BOUNDARY_EPSILON_SECONDS) return boundary;
-  }
-  return null;
-}
 function readStyleProperty(style, property) {
   const escapedProperty = property.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const match = style.match(new RegExp(`(?:^|;)\\s*${escapedProperty}\\s*:\\s*([^;]+)`, "i"));
@@ -84143,7 +84079,7 @@ ${allInlineStyles}`.replace(/\/\*[\s\S]*?\*\//g, "");
       },
       // overlapping_gsap_tweens + gsap_animates_clip_element
       // fallow-ignore-next-line complexity
-      async ({ source, tags, scripts, styles, rootCompositionId }) => {
+      async ({ tags, scripts, styles }) => {
         const findings = [];
         const authoredHiddenSelectors = new Set(
           scripts.flatMap((script) => [...extractStandaloneHiddenSelectors(script.content)])
@@ -84164,13 +84100,10 @@ ${allInlineStyles}`.replace(/\/\*[\s\S]*?\*\//g, "");
             if (cls !== "clip") clipClasses.set(`.${cls}`, info);
           }
         }
-        const clipStartBoundariesByComposition = collectClipStartBoundariesByComposition(source, tags);
         const styleRules = collectSimpleStyleRules(styles);
         const reportedVisibleOverlayKeys = /* @__PURE__ */ new Set();
         for (const script of scripts) {
-          const localTimelineCompId = readRegisteredTimelineCompositionId(script.content);
           const gsapWindows = await cachedExtractGsapWindows(script.content);
-          const clipStartBoundaries = clipStartBoundariesByComposition.get(localTimelineCompId || rootCompositionId || "") ?? [];
           for (let i2 = 0; i2 < gsapWindows.length; i2++) {
             const left = gsapWindows[i2];
             if (!left) continue;
@@ -84232,28 +84165,6 @@ ${right.raw}`)
               snippet: truncateSnippet(fromToWindows.map((win) => win.raw).join("\n"))
             });
           }
-          if (clipStartBoundaries.length > 0) {
-            for (const win of gsapWindows) {
-              if (win.targetSelector === UNRESOLVED_TARGET) continue;
-              if (!isSceneBoundaryExit(win)) continue;
-              const boundary = findMatchingSceneBoundary(win.end, clipStartBoundaries);
-              if (boundary == null) continue;
-              const hasHardKill = gsapWindows.some(
-                (candidate) => isHardKillSet(candidate, win.targetSelector, boundary)
-              );
-              if (hasHardKill) continue;
-              const exitClipInfo = clipIds.get(win.targetSelector) || clipClasses.get(win.targetSelector);
-              const fixHint = exitClipInfo ? `"${win.targetSelector}" is a clip element \u2014 the framework already manages its visibility. Wrap the scene's content in an inner non-clip <div>, move the exit tween and the hard kill (\`tl.set("<inner-selector>", ${hiddenStateLiteral(win.propertyValues)}, ${boundary.toFixed(2)})\`) onto that wrapper instead.` : `Add \`tl.set("${win.targetSelector}", ${hiddenStateLiteral(win.propertyValues)}, ${boundary.toFixed(2)})\` after the exit tween.`;
-              findings.push({
-                code: "gsap_exit_missing_hard_kill",
-                severity: "error",
-                message: `GSAP exit on "${win.targetSelector}" ends at the ${boundary.toFixed(2)}s clip start boundary without a matching tl.set hard kill. Non-linear seeking can land after the fade and leave stale visibility state.`,
-                selector: win.targetSelector,
-                fixHint,
-                snippet: truncateSnippet(win.raw)
-              });
-            }
-          }
           for (const tag of tags) {
             const selectors = tagSimpleSelectors(tag);
             if (selectors.length === 0) continue;
@@ -106332,7 +106243,7 @@ var init_generators = __esm({
       {
         id: "blank",
         label: "Blank",
-        hint: "Empty composition \u2014 just the scaffolding",
+        hint: "Centered Inter stage, paused timeline",
         source: "bundled"
       }
     ];
@@ -110272,6 +110183,27 @@ function formatRenderSummaryDetail(input2) {
   const renderTime = `rendered in ${formatDuration(input2.elapsedMs)}`;
   return [middle, renderTime].filter(Boolean).join(" \xB7 ");
 }
+function resolvePrintedCaptureMode(sessionMode, observabilityCaptureMode) {
+  if (sessionMode && sessionMode !== "unknown") return sessionMode;
+  return observabilityCaptureMode;
+}
+function formatRenderPipelineDetail(input2) {
+  const parts = [];
+  if (input2.captureMode) parts.push(`${input2.captureMode} capture`);
+  if (input2.browserGpuMode) parts.push(`${input2.browserGpuMode} gpu`);
+  for (const [key2, stageLabel] of PIPELINE_STAGES) {
+    const ms = input2.stages[key2];
+    if (ms == null) continue;
+    const label2 = key2 === "encodeMs" && input2.streamingEncode ? "encode (during capture)" : stageLabel;
+    parts.push(`${label2} ${formatDuration(ms)}`);
+  }
+  return parts.length > 0 ? parts.join(" \xB7 ") : void 0;
+}
+function formatScreenshotFallbackHint(input2) {
+  if (input2.platform !== "linux" || input2.requestedGpuMode !== "auto") return void 0;
+  if (input2.captureMode !== "screenshot" || input2.browserGpuMode !== "software") return void 0;
+  return "Screenshot capture (slower): BeginFrame did not run. Needs chrome-headless-shell and no --resolution upscale. Heavy compositions can stall on software GL.";
+}
 function label(name, value) {
   const pad4 = 14 - name.length;
   return `   ${c.dim(name)}${" ".repeat(Math.max(1, pad4))}${c.bold(value)}`;
@@ -110287,10 +110219,21 @@ ${c.dim(indented)}`);
   if (suggestion) console.error(`   ${c.accent(suggestion)}`);
   console.error();
 }
+var PIPELINE_STAGES;
 var init_format = __esm({
   "src/ui/format.ts"() {
     "use strict";
     init_colors();
+    PIPELINE_STAGES = [
+      ["compileMs", "compile"],
+      ["videoExtractMs", "extract"],
+      ["audioProcessMs", "audio"],
+      ["browserProbeMs", "probe"],
+      ["captureSetupMs", "setup"],
+      ["captureFrameMs", "capture"],
+      ["encodeMs", "encode"],
+      ["assembleMs", "assemble"]
+    ];
   }
 });
 
@@ -149098,6 +149041,12 @@ import {
 import { resolve as resolve43, basename as basename16, join as join87, dirname as dirname37 } from "path";
 import { fileURLToPath as fileURLToPath9 } from "url";
 import { execFileSync as execFileSync10, spawn as spawn14 } from "child_process";
+function resolveScaffoldTemplateId(exampleFlag, hasMediaFile) {
+  const example = exampleFlag === "agent" ? "blank" : exampleFlag;
+  if (example && example !== "blank") return example;
+  if (hasMediaFile) return "from-file";
+  return "blank";
+}
 function resolveVideoDurationSeconds({
   streamDuration,
   frameDuration,
@@ -149534,14 +149483,11 @@ var init_init = __esm({
       ["Scaffold a portrait video", "hyperframes init my-video --resolution portrait"],
       ["Start from an existing video file", "hyperframes init my-video --video clip.mp4"],
       ["Start from an audio file", "hyperframes init my-video --audio track.mp3"],
-      ["Scaffold with Tailwind CSS", "hyperframes init my-video --example blank --tailwind"],
-      [
-        "Non-interactive mode (for CI or AI agents)",
-        "hyperframes init my-video --example blank --non-interactive"
-      ],
+      ["Scaffold with Tailwind CSS", "hyperframes init my-video --tailwind"],
+      ["Non-interactive mode (for CI or AI agents)", "hyperframes init my-video --non-interactive"],
       [
         "Opt out of the GitHub skills check (CI/tests only)",
-        "HYPERFRAMES_SKIP_SKILLS=1 hyperframes init my-video --example blank --non-interactive"
+        "HYPERFRAMES_SKIP_SKILLS=1 hyperframes init my-video --non-interactive"
       ]
     ];
     WEB_CODECS = /* @__PURE__ */ new Set(["h264", "vp8", "vp9", "av1", "theora"]);
@@ -149611,6 +149557,11 @@ var init_init = __esm({
           type: "boolean",
           description: "Disable interactive prompts (for CI/agents)"
         },
+        agent: {
+          type: "boolean",
+          hidden: true,
+          description: "Deprecated alias; default init is the centered blank"
+        },
         "skip-skills": {
           type: "boolean",
           description: "[temporarily ignored] init always checks AI skills against GitHub while the skills.sh registry catches up; set HYPERFRAMES_SKIP_SKILLS=1 to opt out (CI/tests)"
@@ -149658,7 +149609,7 @@ var init_init = __esm({
         const skipSkills = process.env.HYPERFRAMES_SKIP_SKILLS === "1";
         const skipSkillsFlagIgnored = args["skip-skills"] === true && !skipSkills;
         const tailwind = args.tailwind === true;
-        const nonInteractive = args["non-interactive"] === true;
+        const nonInteractive = args["non-interactive"] === true || args.agent === true;
         const modelFlag = args.model;
         const languageFlag = args.language;
         const initialTranscriptionModel = initialModelForLanguage(
@@ -149686,15 +149637,7 @@ var init_init = __esm({
           }
         }
         if (!interactive) {
-          if (!exampleFlag && !videoFlag && !audioFlag) {
-            console.error(
-              c.error(
-                "Non-interactive init requires --example, --video, or --audio. For an empty starter project, pass --example blank explicitly."
-              )
-            );
-            failCommand();
-          }
-          const templateId2 = exampleFlag ?? "blank";
+          const templateId2 = resolveScaffoldTemplateId(exampleFlag, Boolean(videoFlag || audioFlag));
           const name2 = args.name ?? "my-video";
           const destDir2 = resolve43(name2);
           if (existsSync71(destDir2) && readdirSync27(destDir2).length > 0) {
@@ -149916,8 +149859,8 @@ var init_init = __esm({
           }
         }
         let templateId;
-        if (exampleFlag) {
-          templateId = exampleFlag;
+        if (exampleFlag || videoFlag || audioFlag) {
+          templateId = resolveScaffoldTemplateId(exampleFlag, Boolean(videoFlag || audioFlag));
         } else {
           const allTemplates = await resolveTemplateList();
           const defaultTemplate = "blank";
@@ -154352,12 +154295,16 @@ function createRenderPlan(args, now = /* @__PURE__ */ new Date()) {
     failUsage();
   }
   let fps = fpsParse.value;
-  const qualityRaw = args.quality ?? "standard";
-  if (!VALID_QUALITY.has(qualityRaw)) {
-    errorBox("Invalid quality", `Got "${qualityRaw}". Must be draft, standard, or high.`);
+  const qualityRaw = args.quality ?? "looks";
+  if (!(qualityRaw in QUALITY_ALIASES)) {
+    errorBox(
+      "Invalid quality",
+      `Got "${qualityRaw}". Must be draft, looks, delivery, standard, or high.`
+    );
     failUsage();
   }
-  const quality = qualityRaw;
+  const qualityAlias = QUALITY_ALIASES[qualityRaw];
+  const quality = qualityAlias.quality;
   const flagSkill = normalizeSkillSlug(args.skill);
   const authoringSkill = flagSkill ?? loadProjectConfig(project.dir).authoringSkill;
   const invalidAuthoringSkill = typeof args.skill === "string" && args.skill.trim() !== "" && !flagSkill ? args.skill : void 0;
@@ -154505,7 +154452,7 @@ function createRenderPlan(args, now = /* @__PURE__ */ new Date()) {
     "Invalid crf",
     `Got "${args.crf}". Must be a non-negative integer.`,
     0
-  ) : void 0;
+  ) : format === "mov" || args["video-bitrate"] ? void 0 : "crf" in qualityAlias ? qualityAlias.crf : void 0;
   let vp9CpuUsed;
   if (args["vp9-cpu-used"] != null) {
     const parsed = Number(args["vp9-cpu-used"]);
@@ -154596,7 +154543,7 @@ function resolveBrowserGpuForCli(useDocker, browserGpuArg, envMode = process.env
   if (envMode === "hardware" || envMode === "software" || envMode === "auto") return envMode;
   return "auto";
 }
-var VALID_QUALITY, RENDER_FORMATS, VALID_FORMAT, RENDER_FORMAT_LABEL, FORMAT_EXT;
+var QUALITY_ALIASES, RENDER_FORMATS, VALID_FORMAT, RENDER_FORMAT_LABEL, FORMAT_EXT;
 var init_plan2 = __esm({
   "src/commands/render/plan.ts"() {
     "use strict";
@@ -154609,7 +154556,13 @@ var init_plan2 = __esm({
     init_skill();
     init_projectConfig();
     init_catalogUsage();
-    VALID_QUALITY = /* @__PURE__ */ new Set(["draft", "standard", "high"]);
+    QUALITY_ALIASES = {
+      draft: { quality: "draft" },
+      standard: { quality: "standard" },
+      high: { quality: "high" },
+      looks: { quality: "standard", crf: 16 },
+      delivery: { quality: "high" }
+    };
     RENDER_FORMATS = ["mp4", "webm", "mov", "png-sequence", "gif"];
     VALID_FORMAT = new Set(RENDER_FORMATS);
     RENDER_FORMAT_LABEL = "mp4, webm, mov, png-sequence, or gif";
@@ -156032,6 +155985,9 @@ async function renderLocal(projectDir, outputPath, options) {
   );
   const engineConfig = producer.resolveConfig({
     browserGpuMode: options.browserGpuMode ?? "software",
+    // Local auto opts out of the software-GPU screenshot clamp. Docker and
+    // --no-browser-gpu request software; --resolution supersamples via screenshot.
+    ...options.browserGpuMode === "auto" && options.outputResolution == null && process.env.PRODUCER_FORCE_SCREENSHOT !== "true" ? { forceScreenshot: false } : {},
     ...options.pageNavigationTimeoutMs != null ? { pageNavigationTimeout: options.pageNavigationTimeoutMs } : {},
     ...options.protocolTimeout != null && { protocolTimeout: options.protocolTimeout },
     ...options.playerReadyTimeout != null && { playerReadyTimeout: options.playerReadyTimeout },
@@ -156094,8 +156050,8 @@ async function renderLocal(projectDir, outputPath, options) {
       outputPath,
       elapsed,
       options.quiet,
-      job.perfSummary?.compositionDurationSeconds,
-      job.perfSummary?.totalFrames
+      job.perfSummary,
+      options.browserGpuMode
     )
   );
   runPostRenderStep(
@@ -156446,37 +156402,57 @@ function trackRenderMetrics(job, elapsedMs, options, docker) {
     ...getMemorySnapshot()
   });
 }
-function printRenderComplete(outputPath, elapsedMs, quiet, outputDurationSeconds, frameCount) {
-  if (quiet) return;
-  let fileSize = "unknown";
-  let isDirectory = false;
+function readOutputFootprint(outputPath) {
   try {
     const stat3 = statSync31(outputPath);
-    isDirectory = stat3.isDirectory();
-    if (stat3.isDirectory()) {
-      let total = 0;
-      for (const entry of readdirSync29(outputPath, { withFileTypes: true })) {
-        if (!entry.isFile()) continue;
-        try {
-          total += statSync31(join97(outputPath, entry.name)).size;
-        } catch {
-        }
+    if (!stat3.isDirectory()) return { fileSize: formatBytes(stat3.size), isDirectory: false };
+    let total = 0;
+    for (const entry of readdirSync29(outputPath, { withFileTypes: true })) {
+      if (!entry.isFile()) continue;
+      try {
+        total += statSync31(join97(outputPath, entry.name)).size;
+      } catch {
       }
-      fileSize = formatBytes(total);
-    } else {
-      fileSize = formatBytes(stat3.size);
     }
+    return { fileSize: formatBytes(total), isDirectory: true };
   } catch {
+    return { fileSize: "unknown", isDirectory: false };
   }
+}
+function printRenderComplete(outputPath, elapsedMs, quiet, perf, requestedGpuMode) {
+  if (quiet) return;
+  const { fileSize, isDirectory } = readOutputFootprint(outputPath);
   const detail = formatRenderSummaryDetail({
     elapsedMs,
-    outputDurationSeconds,
+    outputDurationSeconds: perf?.compositionDurationSeconds,
     isDirectory,
-    frameCount
+    frameCount: perf?.totalFrames
   });
   console.log("");
   console.log(c.success("\u25C7") + "  " + c.accent(outputPath));
   console.log("   " + c.bold(fileSize) + c.dim(" \xB7 " + detail));
+  if (perf) printRenderPipeline(perf, requestedGpuMode);
+}
+function printRenderPipeline(perf, requestedGpuMode) {
+  const capture2 = {
+    captureMode: resolvePrintedCaptureMode(
+      perf.drawElement?.mode,
+      perf.observability?.capture.captureMode
+    ),
+    browserGpuMode: perf.observability?.capture.browserGpuMode
+  };
+  const pipeline5 = formatRenderPipelineDetail({
+    ...capture2,
+    streamingEncode: perf.observability?.capture.useStreamingEncode,
+    stages: perf.stages
+  });
+  if (pipeline5) console.log("   " + c.dim(pipeline5));
+  const hint2 = formatScreenshotFallbackHint({
+    ...capture2,
+    requestedGpuMode,
+    platform: process.platform
+  });
+  if (hint2) console.log("   " + c.dim(hint2));
 }
 var examples9, render_default, DOCKER_IMAGE_PREFIX, deParallelRouterUserManaged, deParallelRouterUserManagedResolved, deParallelRouterBreakerTrippedThisProcess;
 var init_render = __esm({
@@ -156583,8 +156559,8 @@ var init_render = __esm({
         quality: {
           type: "string",
           alias: "q",
-          description: "Quality: draft, standard, high. MOV always uses the fixed alpha-preserving ProRes 4444 profile.",
-          default: "standard"
+          description: "Quality: draft, looks, delivery, or standard/high. looks is the default (CRF 16). delivery is high. MOV always uses the fixed alpha-preserving ProRes 4444 profile.",
+          default: "looks"
         },
         skill: {
           type: "string",
@@ -219968,7 +219944,7 @@ async function streamVideo(url, destPath, asJson) {
     failCommand();
   }
 }
-var VALID_QUALITY2, VALID_FORMAT2, VALID_RESOLUTION, VALID_ASPECT_RATIO, DIRECT_UPLOAD_LIMIT_BYTES, ARCHIVE_DIAGNOSTIC_THRESHOLD_BYTES, LARGEST_FILE_COUNT, FORMAT_EXT2, examples36, render_default2, IDEMPOTENCY_KEY_RE, ASPECT_FALLBACK_HINT;
+var VALID_QUALITY, VALID_FORMAT2, VALID_RESOLUTION, VALID_ASPECT_RATIO, DIRECT_UPLOAD_LIMIT_BYTES, ARCHIVE_DIAGNOSTIC_THRESHOLD_BYTES, LARGEST_FILE_COUNT, FORMAT_EXT2, examples36, render_default2, IDEMPOTENCY_KEY_RE, ASPECT_FALLBACK_HINT;
 var init_render3 = __esm({
   "src/commands/cloud/render.ts"() {
     "use strict";
@@ -219987,7 +219963,7 @@ var init_render3 = __esm({
     init_parsing();
     init_upload();
     init_statusColor();
-    VALID_QUALITY2 = ["draft", "standard", "high"];
+    VALID_QUALITY = ["draft", "standard", "high"];
     VALID_FORMAT2 = ["mp4", "webm", "mov"];
     VALID_RESOLUTION = ["1080p", "4k"];
     VALID_ASPECT_RATIO = ["16:9", "9:16", "1:1"];
@@ -220109,7 +220085,7 @@ var init_render3 = __esm({
       async run({ args }) {
         const asJson = Boolean(args.json);
         const fps = parseIntFlag3(args.fps, { flag: "--fps", min: 1, max: 240 });
-        const quality = parseEnumFlag(args.quality, VALID_QUALITY2, { flag: "--quality" });
+        const quality = parseEnumFlag(args.quality, VALID_QUALITY, { flag: "--quality" });
         const format = parseEnumFlag(args.format, VALID_FORMAT2, { flag: "--format" });
         const resolution = parseEnumFlag(args.resolution, VALID_RESOLUTION, {
           flag: "--resolution"

package/dist/docs/examples.md

@@ -4,7 +4,7 @@ Built-in templates available via `npx hyperframes init --example <name>`.
 
 ## blank
 
-Empty 1920x1080 composition with GSAP timeline wired up. Start from scratch.
+Centered Inter stage, paused GSAP timeline. Default `hyperframes init` scaffold.
 
 ## title-card
 

package/dist/fontLocalizeCli.js

@@ -69963,10 +69963,6 @@ function targetHasNoStableIdentity(selector, identity) {
   if (identity) return false;
   return selector === UNRESOLVED_TARGET || selector === "dwell/hold" || selector.startsWith("proxy \u2192 ");
 }
-function readRegisteredTimelineCompositionId(script) {
-  const match = script.match(WINDOW_TIMELINE_ASSIGN_PATTERN);
-  return match?.[1] || match?.[2] || null;
-}
 function unwrapRaw(value) {
   if (typeof value === "number") return value;
   if (typeof value !== "string") return void 0;
@@ -70133,21 +70129,6 @@ function makesOverlayVisible(win) {
   if (win.method === "from" && isHiddenGsapState(win.propertyValues)) return true;
   return isVisibleGsapState(win.propertyValues);
 }
-function isSceneBoundaryExit(win) {
-  if (win.end <= win.position) return false;
-  if (win.method !== "to" && win.method !== "fromTo") return false;
-  return isHiddenGsapState(win.propertyValues);
-}
-function isHardKillSet(win, selector, boundary) {
-  return win.method === "set" && win.targetSelector === selector && Math.abs(win.position - boundary) <= SCENE_BOUNDARY_EPSILON_SECONDS && isHiddenGsapState(win.propertyValues);
-}
-function hiddenStateLiteral(values) {
-  if (zeroValue(values.autoAlpha)) return "{ autoAlpha: 0 }";
-  if (zeroValue(values.opacity)) return "{ opacity: 0 }";
-  if (stringValue(values.visibility)?.toLowerCase() === "hidden") return '{ visibility: "hidden" }';
-  if (stringValue(values.display)?.toLowerCase() === "none") return '{ display: "none" }';
-  return "{ opacity: 0 }";
-}
 function findTagEnd2(source, tag) {
   const escapedTagName = tag.name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const pattern = new RegExp(`<\\/?${escapedTagName}\\b[^>]*>`, "gi");
@@ -70164,56 +70145,11 @@ function findTagEnd2(source, tag) {
   }
   return source.length;
 }
-function collectCompositionRanges(source, tags) {
-  return tags.map((tag) => {
-    const id = readDecodedAttr(tag.raw, "data-composition-id");
-    if (!id) return null;
-    return {
-      id,
-      start: tag.index,
-      end: findTagEnd2(source, tag)
-    };
-  }).filter((range) => range !== null);
-}
-function findContainingCompositionId(tag, ranges) {
-  let match = null;
-  for (const range of ranges) {
-    if (tag.index < range.start || tag.index >= range.end) continue;
-    if (!match || range.start >= match.start) match = range;
-  }
-  return match?.id || null;
-}
 function getClipTagClasses(tag) {
   const classAttr = readAttr(tag.raw, "class") || "";
   const classes = classAttr.split(/\s+/).filter(Boolean);
   return classes.includes("clip") ? { classAttr, classes } : null;
 }
-function collectClipStartBoundariesByComposition(source, tags) {
-  const ranges = collectCompositionRanges(source, tags);
-  const boundaries = /* @__PURE__ */ new Map();
-  for (const tag of tags) {
-    if (!getClipTagClasses(tag)) continue;
-    const compositionId = findContainingCompositionId(tag, ranges);
-    if (!compositionId) continue;
-    const start = numberValue(readAttr(tag.raw, "data-start") ?? void 0);
-    if (start == null || start <= 0) continue;
-    const compositionBoundaries = boundaries.get(compositionId) ?? /* @__PURE__ */ new Set();
-    compositionBoundaries.add(start);
-    boundaries.set(compositionId, compositionBoundaries);
-  }
-  return new Map(
-    [...boundaries.entries()].map(([compositionId, values]) => [
-      compositionId,
-      [...values].sort((a, b) => a - b)
-    ])
-  );
-}
-function findMatchingSceneBoundary(time, boundaries) {
-  for (const boundary of boundaries) {
-    if (Math.abs(time - boundary) <= SCENE_BOUNDARY_EPSILON_SECONDS) return boundary;
-  }
-  return null;
-}
 function readStyleProperty(style, property) {
   const escapedProperty = property.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const match = style.match(new RegExp(`(?:^|;)\\s*${escapedProperty}\\s*:\\s*([^;]+)`, "i"));
@@ -72548,7 +72484,7 @@ ${allInlineStyles}`.replace(/\/\*[\s\S]*?\*\//g, "");
       },
       // overlapping_gsap_tweens + gsap_animates_clip_element
       // fallow-ignore-next-line complexity
-      async ({ source, tags, scripts, styles, rootCompositionId }) => {
+      async ({ tags, scripts, styles }) => {
         const findings = [];
         const authoredHiddenSelectors = new Set(
           scripts.flatMap((script) => [...extractStandaloneHiddenSelectors(script.content)])
@@ -72569,13 +72505,10 @@ ${allInlineStyles}`.replace(/\/\*[\s\S]*?\*\//g, "");
             if (cls !== "clip") clipClasses.set(`.${cls}`, info);
           }
         }
-        const clipStartBoundariesByComposition = collectClipStartBoundariesByComposition(source, tags);
         const styleRules = collectSimpleStyleRules(styles);
         const reportedVisibleOverlayKeys = /* @__PURE__ */ new Set();
         for (const script of scripts) {
-          const localTimelineCompId = readRegisteredTimelineCompositionId(script.content);
           const gsapWindows = await cachedExtractGsapWindows(script.content);
-          const clipStartBoundaries = clipStartBoundariesByComposition.get(localTimelineCompId || rootCompositionId || "") ?? [];
           for (let i = 0; i < gsapWindows.length; i++) {
             const left = gsapWindows[i];
             if (!left) continue;
@@ -72637,28 +72570,6 @@ ${right.raw}`)
               snippet: truncateSnippet(fromToWindows.map((win) => win.raw).join("\n"))
             });
           }
-          if (clipStartBoundaries.length > 0) {
-            for (const win of gsapWindows) {
-              if (win.targetSelector === UNRESOLVED_TARGET) continue;
-              if (!isSceneBoundaryExit(win)) continue;
-              const boundary = findMatchingSceneBoundary(win.end, clipStartBoundaries);
-              if (boundary == null) continue;
-              const hasHardKill = gsapWindows.some(
-                (candidate) => isHardKillSet(candidate, win.targetSelector, boundary)
-              );
-              if (hasHardKill) continue;
-              const exitClipInfo = clipIds.get(win.targetSelector) || clipClasses.get(win.targetSelector);
-              const fixHint = exitClipInfo ? `"${win.targetSelector}" is a clip element \u2014 the framework already manages its visibility. Wrap the scene's content in an inner non-clip <div>, move the exit tween and the hard kill (\`tl.set("<inner-selector>", ${hiddenStateLiteral(win.propertyValues)}, ${boundary.toFixed(2)})\`) onto that wrapper instead.` : `Add \`tl.set("${win.targetSelector}", ${hiddenStateLiteral(win.propertyValues)}, ${boundary.toFixed(2)})\` after the exit tween.`;
-              findings.push({
-                code: "gsap_exit_missing_hard_kill",
-                severity: "error",
-                message: `GSAP exit on "${win.targetSelector}" ends at the ${boundary.toFixed(2)}s clip start boundary without a matching tl.set hard kill. Non-linear seeking can land after the fade and leave stale visibility state.`,
-                selector: win.targetSelector,
-                fixHint,
-                snippet: truncateSnippet(win.raw)
-              });
-            }
-          }
           for (const tag of tags) {
             const selectors = tagSimpleSelectors(tag);
             if (selectors.length === 0) continue;
@@ -99656,8 +99567,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.37" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.37" : "0.0.0-dev";
+var VERSION = true ? "0.8.38" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.38" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {

package/dist/hyperframes-player.global.js

@@ -1,4 +1,4 @@
-"use strict";var HyperframesPlayer=(()=>{var ee=Object.defineProperty;var et=Object.getOwnPropertyDescriptor;var tt=Object.getOwnPropertyNames;var it=Object.prototype.hasOwnProperty;var rt=(r,e)=>{for(var t in e)ee(r,t,{get:e[t],enumerable:!0})},nt=(r,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of tt(e))!it.call(r,n)&&n!==t&&ee(r,n,{get:()=>e[n],enumerable:!(i=et(e,n))||i.enumerable});return r};var ot=r=>nt(ee({},"__esModule",{value:!0}),r);var Ht={};rt(Ht,{HyperframesPlayer:()=>K,SPEED_PRESETS:()=>re,formatSpeed:()=>O,formatTime:()=>q});function we(r){return r.hasRuntime||r.runtimeInjected?!1:!!(r.hasNestedCompositions||r.hasTimelines&&r.attempts>=5)}function P(r){return typeof r=="object"&&r!==null}function Ae(r){return P(r)&&typeof r.getDuration=="function"}function Ce(r){return P(r)&&typeof r.duration=="function"&&typeof r.time=="function"&&typeof r.seek=="function"&&typeof r.play=="function"&&typeof r.pause=="function"}var k="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.8.37/dist/hyperframe.runtime.iife.js";function N(r){if(r===null)return null;let e=Number.parseInt(r,10);return Number.isFinite(e)&&e>0?e:null}function at(r){let e=r?.querySelector("[data-composition-id][data-width][data-height]")??r?.querySelector("[data-width][data-height]");if(!e)return null;let t=N(e.getAttribute("data-width")),i=N(e.getAttribute("data-height"));return t!==null&&i!==null?{width:t,height:i}:null}var W=class{constructor(e,t){this._iframe=e;this._callbacks=t}_iframe;_callbacks;_interval=null;_runtimeInjected=!1;get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let e=0;this._interval=setInterval(()=>{e++;try{let t=this._iframe.contentWindow;if(!t)return;let i=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(we({hasRuntime:i,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!i)return;let d=this._resolvePlaybackDurationAdapter(t);if(d&&d.getDuration()>0){this.stop();let s=at(this._iframe.contentDocument);this._callbacks.onReady({duration:d.getDuration(),adapter:d,compositionSize:s});return}}catch{}e>=40&&(this.stop(),this._callbacks.onError("Composition timeline not found after 8s"))},200)}stop(){this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{let e=this._iframe.contentWindow;return e?this._resolveDirectTimelineAdapterFromWindow(e):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(e){return this._resolveDirectTimelineAdapterFromWindow(e)}hasRuntimeBridge(e){return Reflect.get(e,"__hf")!==void 0||P(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=k,(e.head||e.documentElement).appendChild(t),this._callbacks.onRuntimeInjected?.()}catch{}}_resolveDirectTimelineAdapterFromWindow(e){if(this.hasRuntimeBridge(e))return null;let t=Reflect.get(e,"__timelines");if(!P(t))return null;let i=Object.keys(t);if(i.length===0)return null;let n=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=n&&n in t?n:i[i.length-1],d=t[o];return Ce(d)?d:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(Ae(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let i=this._resolveDirectTimelineAdapterFromWindow(e);return i?{kind:"direct-timeline",timeline:i,getDuration:()=>i.duration()}:null}};var Re=`
+"use strict";var HyperframesPlayer=(()=>{var ee=Object.defineProperty;var et=Object.getOwnPropertyDescriptor;var tt=Object.getOwnPropertyNames;var it=Object.prototype.hasOwnProperty;var rt=(r,e)=>{for(var t in e)ee(r,t,{get:e[t],enumerable:!0})},nt=(r,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of tt(e))!it.call(r,n)&&n!==t&&ee(r,n,{get:()=>e[n],enumerable:!(i=et(e,n))||i.enumerable});return r};var ot=r=>nt(ee({},"__esModule",{value:!0}),r);var Ht={};rt(Ht,{HyperframesPlayer:()=>K,SPEED_PRESETS:()=>re,formatSpeed:()=>O,formatTime:()=>q});function we(r){return r.hasRuntime||r.runtimeInjected?!1:!!(r.hasNestedCompositions||r.hasTimelines&&r.attempts>=5)}function P(r){return typeof r=="object"&&r!==null}function Ae(r){return P(r)&&typeof r.getDuration=="function"}function Ce(r){return P(r)&&typeof r.duration=="function"&&typeof r.time=="function"&&typeof r.seek=="function"&&typeof r.play=="function"&&typeof r.pause=="function"}var k="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.8.38/dist/hyperframe.runtime.iife.js";function N(r){if(r===null)return null;let e=Number.parseInt(r,10);return Number.isFinite(e)&&e>0?e:null}function at(r){let e=r?.querySelector("[data-composition-id][data-width][data-height]")??r?.querySelector("[data-width][data-height]");if(!e)return null;let t=N(e.getAttribute("data-width")),i=N(e.getAttribute("data-height"));return t!==null&&i!==null?{width:t,height:i}:null}var W=class{constructor(e,t){this._iframe=e;this._callbacks=t}_iframe;_callbacks;_interval=null;_runtimeInjected=!1;get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let e=0;this._interval=setInterval(()=>{e++;try{let t=this._iframe.contentWindow;if(!t)return;let i=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(we({hasRuntime:i,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!i)return;let d=this._resolvePlaybackDurationAdapter(t);if(d&&d.getDuration()>0){this.stop();let s=at(this._iframe.contentDocument);this._callbacks.onReady({duration:d.getDuration(),adapter:d,compositionSize:s});return}}catch{}e>=40&&(this.stop(),this._callbacks.onError("Composition timeline not found after 8s"))},200)}stop(){this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{let e=this._iframe.contentWindow;return e?this._resolveDirectTimelineAdapterFromWindow(e):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(e){return this._resolveDirectTimelineAdapterFromWindow(e)}hasRuntimeBridge(e){return Reflect.get(e,"__hf")!==void 0||P(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=k,(e.head||e.documentElement).appendChild(t),this._callbacks.onRuntimeInjected?.()}catch{}}_resolveDirectTimelineAdapterFromWindow(e){if(this.hasRuntimeBridge(e))return null;let t=Reflect.get(e,"__timelines");if(!P(t))return null;let i=Object.keys(t);if(i.length===0)return null;let n=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=n&&n in t?n:i[i.length-1],d=t[o];return Ce(d)?d:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(Ae(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let i=this._resolveDirectTimelineAdapterFromWindow(e);return i?{kind:"direct-timeline",timeline:i,getDuration:()=>i.duration()}:null}};var Re=`
   :host {
     display: block;
     position: relative;