hyperframes 0.6.108 → 0.6.110

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.6.108" : "0.0.0-dev";
+    VERSION = true ? "0.6.110" : "0.0.0-dev";
   }
 });
 
@@ -48396,7 +48396,10 @@ var init_core = __esm({
         return findings;
       },
       // missing_timeline_registry + timeline_registry_missing_init
-      ({ source }) => {
+      ({ source, rawSource, options }) => {
+        if (options.isSubComposition || rawSource.trimStart().toLowerCase().startsWith("<template")) {
+          return [];
+        }
         const findings = [];
         if (!TIMELINE_REGISTRY_INIT_PATTERN.test(source) && !TIMELINE_REGISTRY_ASSIGN_PATTERN.test(source)) {
           findings.push({
@@ -48607,6 +48610,7 @@ var init_core = __esm({
         return findings;
       },
       // pointer_events_none
+      // fallow-ignore-next-line complexity
       ({ tags, styles }) => {
         const findings = [];
         const reported = /* @__PURE__ */ new Set();
@@ -56637,7 +56641,7 @@ ${right.raw}`)
               if (hasHardKill) continue;
               findings.push({
                 code: "gsap_exit_missing_hard_kill",
-                severity: "warning",
+                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: `Add \`tl.set("${win.targetSelector}", ${hiddenStateLiteral(win.propertyValues)}, ${boundary.toFixed(2)})\` after the exit tween.`,
@@ -56671,7 +56675,7 @@ ${right.raw}`)
             if (className && (classUsage.get(className) || 0) < 2) continue;
             findings.push({
               code: "unscoped_gsap_selector",
-              severity: "warning",
+              severity: "error",
               message: `Timeline "${localTimelineCompId}" uses unscoped selector "${win.targetSelector}" that will target elements in ALL compositions when bundled, causing data loss (opacity, transforms, etc.).`,
               selector: win.targetSelector,
               fixHint: `Scope the selector: \`[data-composition-id="${localTimelineCompId}"] ${win.targetSelector}\` or use a unique id.`,
@@ -56725,7 +56729,7 @@ ${right.raw}`)
           const windows = await cachedExtractGsapWindows(script.content);
           const conflicts = /* @__PURE__ */ new Map();
           for (const win of windows) {
-            if (win.method === "fromTo") continue;
+            if (win.method === "fromTo" || win.method === "from") continue;
             const sel = win.targetSelector;
             const cssKey = sel.startsWith("#") || sel.startsWith(".") ? sel : `#${sel}`;
             const translateProps = win.properties.filter(
@@ -56749,7 +56753,7 @@ ${right.raw}`)
             const fixHint = gsapEquivalent ? `Remove \`transform: ${cssTransform}\` from CSS and replace with GSAP properties: ${gsapEquivalent}. Example: tl.fromTo('${sel}', { ${gsapEquivalent} }, { ${gsapEquivalent}, ...yourAnimation }). tl.fromTo is exempt from this rule.` : `Remove the transform from CSS and use tl.fromTo('${sel}', { xPercent: -50, x: -1000 }, { xPercent: -50, x: 0 }) so GSAP owns the full transform state. tl.fromTo is exempt from this rule.`;
             findings.push({
               code: "gsap_css_transform_conflict",
-              severity: "warning",
+              severity: "error",
               message: `"${sel}" has CSS \`transform: ${cssTransform}\` and a GSAP tween animates ${propList}. GSAP will overwrite the full CSS transform, discarding any translateX(-50%) centering or CSS scale value.`,
               selector: sel,
               fixHint,
@@ -56861,7 +56865,7 @@ ${right.raw}`)
         });
         if (sceneElements.length < 2) return findings;
         for (const script of scripts) {
-          const content = script.content;
+          const content = stripJsComments(script.content);
           for (const tag of sceneElements) {
             const id = readAttr(tag.raw, "id") || "";
             const exitPattern = new RegExp(`["']#${id}["'][^)]*opacity\\s*:\\s*0`);
@@ -56872,7 +56876,7 @@ ${right.raw}`)
             if (!hasKill) {
               findings.push({
                 code: "scene_layer_missing_visibility_kill",
-                severity: "warning",
+                severity: "error",
                 elementId: id,
                 message: `Scene layer "#${id}" exits via opacity tween but has no visibility: hidden hard kill. When scrubbing or when tweens conflict, the scene may remain partially visible and overlap the next scene.`,
                 fixHint: `Add \`tl.set("#${id}", { visibility: "hidden" }, <exit-end-time>)\` after the scene's exit tweens.`
@@ -56893,7 +56897,7 @@ ${right.raw}`)
           if (hasRegistration || canInheritFromHost) continue;
           findings.push({
             code: "gsap_timeline_not_registered",
-            severity: "warning",
+            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.",
             fixHint: 'Add `window.__timelines = window.__timelines || {};` and `window.__timelines["root"] = tl;` after creating the timeline (use the composition\'s data-composition-id as the key).'
           });
@@ -56929,6 +56933,7 @@ ${right.raw}`)
           for (const win of windows) {
             if (win.method !== "from") continue;
             if (!win.properties.includes("opacity")) continue;
+            if (win.propertyValues["opacity"] !== 0) continue;
             const sel = win.targetSelector;
             const cssKey = sel.startsWith("#") || sel.startsWith(".") ? sel : `#${sel}`;
             if (!cssOpacityZeroSelectors.has(cssKey)) continue;
@@ -57000,6 +57005,31 @@ ${right.raw}`)
 });
 
 // ../core/src/lint/rules/captions.ts
+function extractArrayLiteral(src, varMatch) {
+  const openIdx = varMatch.index + varMatch[0].length - 1;
+  let depth = 0;
+  let inStr = false;
+  let strChar = "";
+  for (let i2 = openIdx; i2 < src.length; i2++) {
+    const c3 = src[i2];
+    if (inStr) {
+      if (c3 === "\\") {
+        i2++;
+        continue;
+      }
+      if (c3 === strChar) inStr = false;
+    } else if (c3 === '"' || c3 === "'") {
+      inStr = true;
+      strChar = c3;
+    } else if (c3 === "[") {
+      depth++;
+    } else if (c3 === "]") {
+      depth--;
+      if (depth === 0) return src.slice(openIdx, i2 + 1);
+    }
+  }
+  return null;
+}
 var captionRules;
 var init_captions = __esm({
   "../core/src/lint/rules/captions.ts"() {
@@ -57018,7 +57048,7 @@ var init_captions = __esm({
           if (hasCaptionLoop && hasExitTween && !hasHardKill) {
             findings.push({
               code: "caption_exit_missing_hard_kill",
-              severity: "warning",
+              severity: "error",
               message: "Caption exit animations (tl.to with opacity: 0) detected without a hard tl.set kill. Exit tweens can fail when karaoke word-level tweens conflict, leaving captions stuck on screen.",
               fixHint: 'Add `tl.set(groupEl, { opacity: 0, visibility: "hidden" }, group.end)` after every exit tl.to animation as a deterministic kill.'
             });
@@ -57051,6 +57081,7 @@ var init_captions = __esm({
         return findings;
       },
       // caption_transcript_not_inline
+      // fallow-ignore-next-line complexity
       ({ scripts, styles, options }) => {
         const findings = [];
         const isCaptionFile = options.filePath && /caption/i.test(options.filePath) || styles.some((s2) => /\.caption[-_]?(?:group|word)/i.test(s2.content));
@@ -57063,21 +57094,21 @@ var init_captions = __esm({
         if (!hasInlineTranscript && hasFetchTranscript) {
           findings.push({
             code: "caption_transcript_not_inline",
-            severity: "warning",
+            severity: "error",
             message: "Captions composition loads transcript via fetch(). The studio caption editor requires an inline `var TRANSCRIPT = [...]` array to detect and edit captions.",
             fixHint: 'Embed the transcript as `var TRANSCRIPT = [{ "text": "...", "start": 0, "end": 1 }, ...]` with JSON-quoted property keys. See the captions skill for details.'
           });
         }
         if (hasInlineTranscript) {
-          const varPattern = /(?:const|let|var)\s+(?:TRANSCRIPT|script)\s*=\s*(\[[\s\S]*?\]);/;
-          const match = allScript.match(varPattern);
-          if (match?.[1]) {
+          const varStart = /(?:const|let|var)\s+(?:TRANSCRIPT|script)\s*=\s*\[/.exec(allScript);
+          const transcriptJson = varStart ? extractArrayLiteral(allScript, varStart) : null;
+          if (transcriptJson) {
             try {
-              JSON.parse(match[1]);
+              JSON.parse(transcriptJson);
             } catch {
               findings.push({
                 code: "caption_transcript_parse_error",
-                severity: "warning",
+                severity: "error",
                 message: "Inline TRANSCRIPT array is not valid JSON. The studio caption editor may fail to parse it. Common cause: unquoted property keys with apostrophes in text.",
                 fixHint: `Use JSON-quoted keys: { "text": "don't", "start": 0, "end": 1 } instead of { text: "don't", start: 0, end: 1 }.`
               });
@@ -57098,7 +57129,7 @@ var init_captions = __esm({
             if (/position\s*:\s*relative/i.test(body)) {
               findings.push({
                 code: "caption_container_relative_position",
-                severity: "warning",
+                severity: "error",
                 selector: (selector ?? "").trim(),
                 message: `Caption selector "${(selector ?? "").trim()}" uses position: relative which causes overflow and breaks caption stacking.`,
                 fixHint: "Use position: absolute for all caption elements."
@@ -57124,7 +57155,7 @@ var init_captions = __esm({
             if (/overflow\s*:\s*hidden/i.test(body)) {
               findings.push({
                 code: "caption_overflow_clips_scaled_words",
-                severity: "warning",
+                severity: "error",
                 selector: (selector ?? "").trim(),
                 message: `"${(selector ?? "").trim()}" has overflow: hidden but GSAP scales caption words above 1.0x. Scaled emphasis words and their glow effects will be clipped.`,
                 fixHint: "Use overflow: visible on caption containers. Rely on fitTextFontSize with reduced maxWidth to prevent overflow instead."
@@ -57154,6 +57185,7 @@ var init_captions = __esm({
         return findings;
       },
       // caption_fittext_scale_mismatch
+      // fallow-ignore-next-line complexity
       ({ scripts }) => {
         const findings = [];
         for (const script of scripts) {
@@ -57252,6 +57284,7 @@ var init_composition = __esm({
         ];
       },
       // timeline_track_too_dense
+      // fallow-ignore-next-line complexity
       ({ tags, options }) => {
         const trackCounts = /* @__PURE__ */ new Map();
         for (const tag of tags) {
@@ -57276,6 +57309,7 @@ var init_composition = __esm({
         return findings;
       },
       // timed_element_missing_visibility_hidden
+      // fallow-ignore-next-line complexity
       ({ tags }) => {
         const findings = [];
         for (const tag of tags) {
@@ -57302,6 +57336,7 @@ var init_composition = __esm({
         return findings;
       },
       // deprecated_data_layer + deprecated_data_end
+      // fallow-ignore-next-line complexity
       ({ tags }) => {
         const findings = [];
         for (const tag of tags) {
@@ -57309,7 +57344,7 @@ var init_composition = __esm({
             const elementId = readAttr(tag.raw, "id") || void 0;
             findings.push({
               code: "deprecated_data_layer",
-              severity: "warning",
+              severity: "error",
               message: `<${tag.name}${elementId ? ` id="${elementId}"` : ""}> uses data-layer instead of data-track-index.`,
               elementId,
               fixHint: "Replace data-layer with data-track-index. The runtime reads data-track-index.",
@@ -57320,7 +57355,7 @@ var init_composition = __esm({
             const elementId = readAttr(tag.raw, "id") || void 0;
             findings.push({
               code: "deprecated_data_end",
-              severity: "warning",
+              severity: "error",
               message: `<${tag.name}${elementId ? ` id="${elementId}"` : ""}> uses data-end without data-duration. Use data-duration in source HTML.`,
               elementId,
               fixHint: "Replace data-end with data-duration. The compiler generates data-end from data-duration automatically.",
@@ -57373,27 +57408,8 @@ var init_composition = __esm({
         }
         return findings;
       },
-      // external_script_dependency
-      ({ source }) => {
-        const findings = [];
-        const externalScriptRe = /<script\b[^>]*\bsrc=["'](https?:\/\/[^"']+)["'][^>]*>/gi;
-        let match;
-        const seen = /* @__PURE__ */ new Set();
-        while ((match = externalScriptRe.exec(source)) !== null) {
-          const src = match[1] ?? "";
-          if (seen.has(src)) continue;
-          seen.add(src);
-          findings.push({
-            code: "external_script_dependency",
-            severity: "info",
-            message: `This composition loads an external script from \`${src}\`. The HyperFrames bundler automatically hoists CDN scripts from sub-compositions into the parent document. In unbundled runtime mode, \`loadExternalCompositions\` re-injects them. If you're using a custom pipeline that bypasses both, you'll need to include this script manually.`,
-            fixHint: "No action needed when using `hyperframes preview` or `hyperframes render`. If using a custom pipeline, add this script tag to your root composition or HTML page.",
-            snippet: truncateSnippet(match[0] ?? "")
-          });
-        }
-        return findings;
-      },
       // timed_element_missing_clip_class
+      // fallow-ignore-next-line complexity
       ({ tags }) => {
         const findings = [];
         const skipTags = /* @__PURE__ */ new Set(["audio", "video", "script", "style", "template"]);
@@ -57403,15 +57419,14 @@ var init_composition = __esm({
           if (readAttr(tag.raw, "data-composition-src")) continue;
           const hasStart = readAttr(tag.raw, "data-start") !== null;
           const hasDuration = readAttr(tag.raw, "data-duration") !== null;
-          const hasTrackIndex = readAttr(tag.raw, "data-track-index") !== null;
-          if (!hasStart && !hasDuration && !hasTrackIndex) continue;
+          if (!hasStart && !hasDuration) continue;
           const classAttr = readAttr(tag.raw, "class") || "";
           const hasClip = classAttr.split(/\s+/).includes("clip");
           if (hasClip) continue;
           const elementId = readAttr(tag.raw, "id") || void 0;
           findings.push({
             code: "timed_element_missing_clip_class",
-            severity: "warning",
+            severity: "error",
             message: `<${tag.name}${elementId ? ` id="${elementId}"` : ""}> has timing attributes but no class="clip". The element will be visible for the entire composition instead of only during its scheduled time range.`,
             elementId,
             fixHint: 'Add class="clip" to the element. The HyperFrames runtime uses .clip to control visibility based on data-start/data-duration.',
@@ -57421,6 +57436,7 @@ var init_composition = __esm({
         return findings;
       },
       // overlapping_clips_same_track
+      // fallow-ignore-next-line complexity
       ({ tags }) => {
         const findings = [];
         const trackMap = /* @__PURE__ */ new Map();
@@ -57471,7 +57487,7 @@ var init_composition = __esm({
         if (!hasStart) {
           findings.push({
             code: "root_composition_missing_data_start",
-            severity: "warning",
+            severity: "error",
             message: `Root composition "${compId}" is missing data-start. The runtime needs data-start="0" on the root element to begin playback.`,
             fixHint: 'Add data-start="0" to the root composition element.',
             snippet: truncateSnippet(rootTag.raw)
@@ -57487,7 +57503,7 @@ var init_composition = __esm({
         if (trimmed.startsWith("<template")) {
           findings.push({
             code: "standalone_composition_wrapped_in_template",
-            severity: "warning",
+            severity: "error",
             message: "Root index.html is wrapped in a <template> tag. Only sub-compositions loaded via data-composition-src should use <template> wrappers. The runtime cannot play a standalone composition inside a template.",
             fixHint: "Remove the <template> wrapper. Use <!DOCTYPE html><html>...<div data-composition-id>...</div>...</html> instead."
           });
@@ -57514,14 +57530,15 @@ var init_composition = __esm({
         return findings;
       },
       // requestanimationframe_in_composition
-      ({ scripts }) => {
+      ({ scripts, rawSource, options }) => {
+        if (isRegistrySourceFile(options.filePath) || isRegistryInstalledFile(rawSource)) return [];
         const findings = [];
         for (const script of scripts) {
           const stripped = stripJsComments(script.content);
           if (/requestAnimationFrame\s*\(/.test(stripped)) {
             findings.push({
               code: "requestanimationframe_in_composition",
-              severity: "warning",
+              severity: "error",
               message: "`requestAnimationFrame` runs on wall-clock time, not the GSAP timeline. It will not sync with frame capture and may cause flickering or missed frames during rendering.",
               fixHint: "Use GSAP tweens or onUpdate callbacks instead of requestAnimationFrame for animation logic.",
               snippet: truncateSnippet(script.content)
@@ -57535,6 +57552,7 @@ var init_composition = __esm({
       // `data-variable-values`. The runtime swallows JSON errors silently and
       // falls back to declared defaults, which masks typos. This rule surfaces
       // the parse failure so authors notice before render time.
+      // fallow-ignore-next-line complexity
       ({ tags }) => {
         const findings = [];
         for (const tag of tags) {
@@ -57547,7 +57565,7 @@ var init_composition = __esm({
             const reason = err instanceof Error ? err.message : "unknown";
             findings.push({
               code: "invalid_variable_values_json",
-              severity: "warning",
+              severity: "error",
               message: `data-variable-values is not valid JSON (${reason}).`,
               fixHint: `Wrap the attribute value in single quotes and the JSON keys/values in double quotes, e.g. data-variable-values='{"title":"Hello"}'.`,
               elementId: readAttr(tag.raw, "id") || void 0,
@@ -57558,7 +57576,7 @@ var init_composition = __esm({
           if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
             findings.push({
               code: "invalid_variable_values_json",
-              severity: "warning",
+              severity: "error",
               message: 'data-variable-values must be a JSON object keyed by variable id (e.g. {"title":"Hello"}).',
               fixHint: "Replace the value with a JSON object whose keys are variable ids declared in the sub-composition's data-composition-variables.",
               elementId: readAttr(tag.raw, "id") || void 0,
@@ -57573,6 +57591,7 @@ var init_composition = __esm({
       // on any structural problem. Surface JSON / shape failures so authors
       // catch them at lint time rather than wondering why their `getVariables()`
       // defaults aren't applied.
+      // fallow-ignore-next-line complexity
       ({ source }) => {
         const htmlTag = findHtmlTag(source);
         if (!htmlTag) return [];
@@ -57586,7 +57605,7 @@ var init_composition = __esm({
           return [
             {
               code: "invalid_composition_variables_declaration",
-              severity: "warning",
+              severity: "error",
               message: `data-composition-variables is not valid JSON (${reason}).`,
               fixHint: `Provide a JSON array of variable declarations: data-composition-variables='[{"id":"title","type":"string","label":"Title","default":"Hello"}]'.`,
               snippet: truncateSnippet(htmlTag.raw)
@@ -57597,7 +57616,7 @@ var init_composition = __esm({
           return [
             {
               code: "invalid_composition_variables_declaration",
-              severity: "warning",
+              severity: "error",
               message: "data-composition-variables must be a JSON array of variable declarations.",
               fixHint: `Wrap declarations in [] and give each an id, type, label, and default: '[{"id":"title","type":"string","label":"Title","default":"Hello"}]'.`,
               snippet: truncateSnippet(htmlTag.raw)
@@ -57611,7 +57630,7 @@ var init_composition = __esm({
           if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
             findings.push({
               code: "invalid_composition_variables_declaration",
-              severity: "warning",
+              severity: "error",
               message: `data-composition-variables entry [${i2}] must be an object with id, type, label, and default.`,
               snippet: truncateSnippet(htmlTag.raw)
             });
@@ -57626,7 +57645,7 @@ var init_composition = __esm({
           if (missing.length > 0) {
             findings.push({
               code: "invalid_composition_variables_declaration",
-              severity: "warning",
+              severity: "error",
               message: `data-composition-variables entry [${i2}] is missing or has invalid: ${missing.join(", ")}. Type must be one of string, number, color, boolean, enum.`,
               snippet: truncateSnippet(htmlTag.raw)
             });
@@ -57833,7 +57852,7 @@ var init_textures = __esm({
             if (definedTextureClasses.has(textureClass)) continue;
             findings.push({
               code: "texture_class_unknown",
-              severity: "warning",
+              severity: "error",
               message: `Texture material class \`${textureClass}\` is not defined by local CSS.`,
               elementId: readAttr(tag.raw, "id") || void 0,
               fixHint: "Paste the Texture Mask Text component `<style>...</style>` block into the composition, or fix the texture class typo.",
@@ -58036,6 +58055,7 @@ var init_fonts = __esm({
   "../core/src/lint/rules/fonts.ts"() {
     "use strict";
     init_aliases2();
+    init_composition();
     GENERIC_FAMILIES = /* @__PURE__ */ new Set([
       "serif",
       "sans-serif",
@@ -58057,7 +58077,8 @@ var init_fonts = __esm({
     ]);
     fontRules = [
       // google_fonts_import
-      ({ styles, source }) => {
+      ({ styles, source, rawSource, options }) => {
+        if (isRegistrySourceFile(options.filePath) || isRegistryInstalledFile(rawSource)) return [];
         const findings = [];
         const googleFontsInLink = /<link\b[^>]*fonts\.googleapis\.com[^>]*>/i.test(source);
         const googleFontsInImport = styles.some(
@@ -58066,7 +58087,7 @@ var init_fonts = __esm({
         if (googleFontsInLink || googleFontsInImport) {
           findings.push({
             code: "google_fonts_import",
-            severity: "warning",
+            severity: "error",
             message: "Composition loads fonts from fonts.googleapis.com. External font requests fail in sandboxed/offline renders and add latency. Use local @font-face declarations with captured .woff2 files instead.",
             fixHint: "Replace the Google Fonts <link> or @import with @font-face { font-family: '...'; src: url('capture/assets/fonts/Font.woff2'); } pointing to captured font files."
           });
@@ -58089,7 +58110,8 @@ var init_fonts = __esm({
         ];
       },
       // font_family_without_font_face
-      ({ styles }) => {
+      ({ styles, rawSource, options }) => {
+        if (isRegistrySourceFile(options.filePath) || isRegistryInstalledFile(rawSource)) return [];
         const findings = [];
         const declared = extractFontFaceFamilies(styles);
         const used = extractUsedFontFamilies(styles);
@@ -58097,7 +58119,7 @@ var init_fonts = __esm({
         if (undeclared.length === 0) return findings;
         findings.push({
           code: "font_family_without_font_face",
-          severity: "warning",
+          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.`,
           fixHint: "Add @font-face { font-family: '...'; src: url('capture/assets/fonts/...woff2'); } for each font family, pointing to the captured .woff2 files."
         });
@@ -74869,10 +74891,17 @@ function findOnPath2(name) {
     return void 0;
   }
 }
+function findInCommonDirs(name) {
+  for (const dir of COMMON_BIN_DIRS) {
+    const candidate = `${dir}/${name}`;
+    if (existsSync19(candidate)) return candidate;
+  }
+  return void 0;
+}
 function findConfiguredBinary(envName, binaryName) {
   const configured = process.env[envName]?.trim();
   if (configured) return existsSync19(configured) ? resolve10(configured) : void 0;
-  return findOnPath2(binaryName);
+  return findOnPath2(binaryName) ?? findInCommonDirs(binaryName);
 }
 function findFFmpeg() {
   return findConfiguredBinary(FFMPEG_PATH_ENV2, "ffmpeg");
@@ -74892,12 +74921,13 @@ function getFFmpegInstallHint() {
       return "https://ffmpeg.org/download.html";
   }
 }
-var FFMPEG_PATH_ENV2, FFPROBE_PATH_ENV2;
+var FFMPEG_PATH_ENV2, FFPROBE_PATH_ENV2, COMMON_BIN_DIRS;
 var init_ffmpeg = __esm({
   "src/browser/ffmpeg.ts"() {
     "use strict";
     FFMPEG_PATH_ENV2 = "HYPERFRAMES_FFMPEG_PATH";
     FFPROBE_PATH_ENV2 = "HYPERFRAMES_FFPROBE_PATH";
+    COMMON_BIN_DIRS = process.platform === "win32" ? [] : ["/opt/homebrew/bin", "/usr/local/bin", "/usr/bin", "/bin", "/snap/bin"];
   }
 });
 
@@ -100563,7 +100593,12 @@ function resolveAssetDir(devSegments, builtSegments) {
   return existsSync54(devPath) ? devPath : builtPath;
 }
 function getStaticTemplateDir(templateId) {
-  return resolveAssetDir(["..", "templates", templateId], ["templates", templateId]);
+  const base2 = dirname23(fileURLToPath7(import.meta.url));
+  const devPath = resolve31(base2, "..", "templates", templateId);
+  if (existsSync54(devPath)) return devPath;
+  const registryPath = resolve31(base2, "..", "..", "..", "..", "registry", "examples", templateId);
+  if (existsSync54(registryPath)) return registryPath;
+  return resolve31(base2, "templates", templateId);
 }
 function getSharedTemplateDir() {
   return resolveAssetDir(["..", "templates", "_shared"], ["templates", "_shared"]);
@@ -101002,20 +101037,25 @@ var init_init = __esm({
             console.error(c.error(`Directory already exists and is not empty: ${name2}`));
             process.exit(1);
           }
-          mkdirSync33(destDir2, { recursive: true });
-          let localVideoName2;
-          let videoDuration2;
-          let sourceFilePath2;
           if (videoFlag && audioFlag) {
             console.error(c.error("Cannot use --video and --audio together"));
             process.exit(1);
           }
-          if (videoFlag) {
-            const videoPath = resolve31(videoFlag);
-            if (!existsSync54(videoPath)) {
-              console.error(c.error(`Video file not found: ${videoFlag}`));
-              process.exit(1);
-            }
+          const videoPath = videoFlag ? resolve31(videoFlag) : void 0;
+          if (videoPath && !existsSync54(videoPath)) {
+            console.error(c.error(`Video file not found: ${videoFlag}`));
+            process.exit(1);
+          }
+          const audioPath = audioFlag ? resolve31(audioFlag) : void 0;
+          if (audioPath && !existsSync54(audioPath)) {
+            console.error(c.error(`Audio file not found: ${audioFlag}`));
+            process.exit(1);
+          }
+          mkdirSync33(destDir2, { recursive: true });
+          let localVideoName2;
+          let videoDuration2;
+          let sourceFilePath2;
+          if (videoPath) {
             sourceFilePath2 = videoPath;
             const result = await handleVideoFile(videoPath, destDir2, false);
             localVideoName2 = result.localVideoName;
@@ -101024,12 +101064,7 @@ var init_init = __esm({
               `Video: ${result.meta.width}x${result.meta.height}, ${result.meta.durationSeconds.toFixed(1)}s`
             );
           }
-          if (audioFlag) {
-            const audioPath = resolve31(audioFlag);
-            if (!existsSync54(audioPath)) {
-              console.error(c.error(`Audio file not found: ${audioFlag}`));
-              process.exit(1);
-            }
+          if (audioPath) {
             sourceFilePath2 = audioPath;
             copyFileSync6(audioPath, resolve31(destDir2, basename10(audioPath)));
             console.log(`Audio: ${basename10(audioPath)}`);
@@ -149232,8 +149267,8 @@ var init_snapshot = __esm({
     init_ffmpeg();
     FFMPEG_EXTRACT_TIMEOUT_MS = 3e4;
     examples24 = [
-      ["Capture 5 key frames from a composition", "snapshot captures/stripe"],
-      ["Capture 10 evenly-spaced frames", "snapshot captures/stripe --frames 10"]
+      ["Capture 5 key frames from a composition", "snapshot capture"],
+      ["Capture 10 evenly-spaced frames", "snapshot capture --frames 10"]
     ];
     snapshot_default = defineCommand({
       meta: {
@@ -153088,8 +153123,8 @@ var init_capture2 = __esm({
     "use strict";
     init_dist();
     examples25 = [
-      ["Capture a website", "hyperframes capture https://stripe.com"],
-      ["Capture to a specific directory", "hyperframes capture https://linear.app -o linear-video"],
+      ["Capture a website into ./capture/", "hyperframes capture https://stripe.com"],
+      ["Capture to a different directory", "hyperframes capture https://linear.app -o linear-video"],
       ["JSON output for AI agents", "hyperframes capture https://example.com --json"],
       [
         "Pull a video from the captured manifest by index",
@@ -153113,7 +153148,7 @@ var init_capture2 = __esm({
         },
         output: {
           type: "string",
-          description: "Output directory name",
+          description: "Output directory name (default: ./capture, then ./capture-2/, ./capture-3/, \u2026)",
           alias: "o"
         },
         "skip-assets": {
@@ -153152,6 +153187,7 @@ var init_capture2 = __esm({
           default: false
         }
       },
+      // fallow-ignore-next-line complexity
       async run({ args }) {
         if (args.video) {
           const { runVideoMode: runVideoMode2 } = await Promise.resolve().then(() => (init_video(), video_exports));
@@ -153176,17 +153212,30 @@ var init_capture2 = __esm({
           console.error(`Invalid URL: ${url}`);
           process.exit(1);
         }
-        let outputName = args.output;
-        if (!outputName) {
-          const hostname = new URL(url).hostname.replace(/^www\./, "");
-          outputName = `captures/${hostname.replace(/\./g, "-")}`;
+        const isDefaultOutput = !args.output;
+        let outputName = args.output ?? "capture";
+        let outputDir = resolve52(outputName);
+        if (isDefaultOutput) {
+          const { existsSync: existsSync92 } = await import("fs");
+          let n2 = 2;
+          while (existsSync92(outputDir) && n2 < 100) {
+            outputName = `capture-${n2}`;
+            outputDir = resolve52(outputName);
+            n2++;
+          }
+          if (existsSync92(outputDir)) {
+            console.error(`./capture-{2..99} are all taken. Pass -o <name> to pick a directory.`);
+            process.exit(1);
+          }
         }
-        const outputDir = resolve52(outputName);
         const isJson = args.json;
         if (!isJson) {
           const { c: c3 } = await Promise.resolve().then(() => (init_colors(), colors_exports));
           console.log();
           console.log(c3.dim("\u25C6") + "  Capturing " + c3.bold(url));
+          if (isDefaultOutput && outputName !== "capture") {
+            console.log(`  ${c3.dim(`(./capture/ exists; writing to ./${outputName}/)`)}`);
+          }
           console.log();
         }
         const { captureWebsite: captureWebsite2 } = await Promise.resolve().then(() => (init_capture(), capture_exports));