hyperframes 0.8.68 → 0.8.69

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.8.68" : "0.0.0-dev";
+    VERSION = true ? "0.8.69" : "0.0.0-dev";
   }
 });
 
@@ -84131,17 +84131,17 @@ function mediaSrcTagRe(tagAlternation) {
   return new RegExp(`<(${tagAlternation})\\b[^>]*\\ssrc\\s*=\\s*["']([^"']+)["'][^>]*>`, "gi");
 }
 function normalized(source) {
-  let text2 = "";
+  const chars2 = [];
   const offsets = [];
+  let lastWasSpace = false;
   for (let i = 0; i < source.length; i++) {
-    const char = source[i];
-    if (/\s/.test(char)) {
-      if (text2.endsWith(" ")) continue;
-      text2 += " ";
-    } else text2 += char;
+    const isSpace = /\s/.test(source[i]);
+    if (isSpace && lastWasSpace) continue;
+    chars2.push(isSpace ? " " : source[i]);
     offsets.push(i);
+    lastWasSpace = isSpace;
   }
-  return { text: text2, offsets };
+  return { text: chars2.join(""), offsets };
 }
 function createSourceLocator(source) {
   const tags = parseHtmlStructure(source).tags;
@@ -92408,6 +92408,15 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
       `FFmpeg exited successfully but produced no frames (start=${startTime}, duration=${duration})`
     );
   }
+  if (framePaths.size > 0 && duration > 0 && !options.finalFrameOnly) {
+    const expectedAtFps = extractionFrameCountForDuration(duration, normalizedFps, metadata.isVFR);
+    if (expectedAtFps > 0 && framePaths.size <= expectedAtFps * 0.6) {
+      const correctedDuration = startTime + framePaths.size / fps;
+      if (correctedDuration < metadata.videoStreamDurationSeconds) {
+        metadata.videoStreamDurationSeconds = correctedDuration;
+      }
+    }
+  }
   return {
     videoId,
     srcPath: videoPath,
@@ -109389,14 +109398,6 @@ function decode(raw) {
 function encode2(json, quote) {
   return quote === "'" ? json.replace(/'/g, "&#39;") : json.replace(/"/g, "&quot;");
 }
-function optionValues(decl) {
-  return decl.type === "enum" ? decl.options.map((option) => option.value) : null;
-}
-function rejectEnum(decl, value) {
-  const options = optionValues(decl);
-  if (!options) return null;
-  return options.includes(String(value)) ? null : `not one of ${options.join(", ")}`;
-}
 function rejectNumber(decl, value) {
   if (decl.type !== "number") return null;
   const n3 = typeof value === "number" ? value : Number(value);
@@ -109406,7 +109407,12 @@ function rejectNumber(decl, value) {
   return null;
 }
 function reject(decl, value) {
-  return rejectEnum(decl, value) ?? rejectNumber(decl, value);
+  if (decl.type === "number") return rejectNumber(decl, value);
+  const [issue] = validateVariables({ [decl.id]: value }, [decl]);
+  if (!issue) return null;
+  if (issue.kind === "enum-out-of-range") return `not one of ${issue.allowed.join(", ")}`;
+  if (issue.kind === "type-mismatch") return `expected ${issue.expected}, got ${issue.actual}`;
+  return null;
 }
 function applyVariableDefaults(source, values) {
   const ids = Object.keys(values);
@@ -109436,7 +109442,7 @@ function applyVariableDefaults(source, values) {
       invalid.push({ id, reason });
       continue;
     }
-    updated.set(id, decl.type === "number" ? Number(value) : String(value));
+    updated.set(id, decl.type === "number" ? Number(value) : value);
     applied.push(id);
   }
   const unknown = ids.filter((id) => !byId2.has(id));
@@ -109452,11 +109458,19 @@ ${body}
   const html = source.slice(0, found.start) + rewritten + source.slice(found.end);
   return { html, applied, unknown, invalid };
 }
-var ATTR;
+var InvalidVariableValuesError, ATTR;
 var init_variableDefaults = __esm({
   "src/registry/variableDefaults.ts"() {
     "use strict";
     init_variables();
+    InvalidVariableValuesError = class extends Error {
+      constructor(invalid) {
+        super(`--vars refused: ${invalid.map(({ id, reason }) => `${id}: ${reason}`).join("; ")}`);
+        this.invalid = invalid;
+        this.name = "InvalidVariableValuesError";
+      }
+      invalid;
+    };
     ATTR = "data-composition-variables";
   }
 });
@@ -109465,7 +109479,9 @@ var init_variableDefaults = __esm({
 var installer_exports = {};
 __export(installer_exports, {
   hasLocalEdits: () => hasLocalEdits,
-  installItem: () => installItem
+  installItem: () => installItem,
+  prepareItem: () => prepareItem,
+  publishItem: () => publishItem
 });
 import { createHash as createHash5 } from "crypto";
 import { existsSync as existsSync23, readFileSync as readFileSync14 } from "fs";
@@ -109498,6 +109514,9 @@ function hasLocalEdits(record2, target, onDisk) {
   if (!installed) return true;
   return installed !== digest(onDisk);
 }
+function keptByProject(record2, destPath, target, force) {
+  return !force && existsSync23(destPath) && hasLocalEdits(record2, target, readFileSync14(destPath));
+}
 function assertSafeTarget(destDir, target) {
   if (isAbsolute6(target)) {
     throw new Error(`Unsafe target "${target}": absolute paths are not allowed.`);
@@ -109527,30 +109546,40 @@ function addRegistryItemMarker(source, item) {
   return `<!-- hyperframes-registry-item: ${item.name} -->
 ${source}`;
 }
-async function installOneFile(item, file, destDir, baseUrl, record2, options, budget) {
+function bakeVariables(item, file, bytes, values) {
+  const component = isInstalledComponentSnippet(item, file);
+  if (!values || !(component || isInstalledRegistryBlockComposition(item, file))) {
+    return { bytes, vars: null };
+  }
+  const vars = applyVariableDefaults(bytes.toString("utf8"), values);
+  const rewrite = component && vars.applied.length > 0;
+  return { bytes: rewrite ? Buffer.from(vars.html) : bytes, vars };
+}
+async function prepareOneFile(item, file, destDir, baseUrl, record2, options, budget) {
   const destPath = registryTargetPath(destDir, file.target);
-  if (!options.force && existsSync23(destPath) && hasLocalEdits(record2, file.target, readFileSync14(destPath))) {
-    return { destPath, target: file.target, preserved: true, hash: null, vars: null };
+  if (keptByProject(record2, destPath, file.target, options.force)) {
+    return { destPath, target: file.target, preserved: true, hash: null, vars: null, bytes: null };
   }
   let bytes = await fetchItemFile(item, file, baseUrl, budget);
   if (isInstalledRegistryBlockComposition(item, file)) {
     bytes = Buffer.from(addRegistryItemMarker(bytes.toString("utf8"), item));
   }
-  let vars = null;
-  if (options.variableValues && isInstalledComponentSnippet(item, file)) {
-    vars = applyVariableDefaults(bytes.toString("utf8"), options.variableValues);
-    if (vars.applied.length > 0) bytes = Buffer.from(vars.html);
-  }
-  publishRegistryFile(destDir, file.target, bytes);
+  const baked = bakeVariables(item, file, bytes, options.variableValues);
+  bytes = baked.bytes;
+  const vars = baked.vars;
   return {
     destPath,
     target: file.target,
     preserved: false,
     hash: digest(bytes),
-    vars
+    vars,
+    bytes
   };
 }
 async function installItem(item, options) {
+  return publishItem(await prepareItem(item, options));
+}
+async function prepareItem(item, options) {
   if (!validRegistryItem(item, item.name, item.type)) throw new Error("Invalid registry item");
   const baseUrl = options.baseUrl ?? DEFAULT_REGISTRY_URL;
   const destDir = resolve11(options.destDir);
@@ -109563,8 +109592,20 @@ async function installItem(item, options) {
   const budget = { remainingBytes: 512 * 1024 * 1024 };
   const outcomes = await installFileBatches(
     item.files,
-    (file) => installOneFile(item, file, root, baseUrl, record2, options, budget)
+    (file) => prepareOneFile(item, file, root, baseUrl, record2, options, budget)
+  );
+  const invalid = outcomes.flatMap((o) => o.vars?.invalid ?? []);
+  if (invalid.length > 0) throw new InvalidVariableValuesError(invalid);
+  return { root, outcomes, force: options.force ?? false };
+}
+function publishItem({ root, outcomes: prepared, force }) {
+  const record2 = readInstallRecord(root);
+  const outcomes = prepared.map(
+    (o) => o.bytes && keptByProject(record2, o.destPath, o.target, force) ? { ...o, preserved: true, hash: null, vars: null, bytes: null } : o
   );
+  for (const outcome of outcomes) {
+    if (outcome.bytes) publishRegistryFile(root, outcome.target, outcome.bytes);
+  }
   const written = outcomes.filter((o) => !o.preserved).map((o) => o.destPath);
   const preserved = outcomes.filter((o) => o.preserved).map((o) => o.destPath);
   if (written.length > 0) {
@@ -109583,8 +109624,7 @@ async function installItem(item, options) {
     variablesUnknown: vars.length ? vars.reduce(
       (acc, v2) => acc.filter((id) => v2.unknown.includes(id)),
       vars[0].unknown
-    ) : [],
-    variablesInvalid: vars.flatMap((v2) => v2.invalid)
+    ) : []
   };
 }
 function validatePhysicalTargets(root, files) {
@@ -109599,10 +109639,10 @@ function validatePhysicalTargets(root, files) {
     targets.add(key2);
   }
 }
-async function installFileBatches(files, install2) {
+async function installFileBatches(files, prepare2) {
   const outcomes = [];
   for (let at4 = 0; at4 < files.length; at4 += 4) {
-    const batch = await Promise.allSettled(files.slice(at4, at4 + 4).map(install2));
+    const batch = await Promise.allSettled(files.slice(at4, at4 + 4).map(prepare2));
     for (const result of batch) {
       if (result.status === "rejected") throw result.reason;
       outcomes.push(result.value);
@@ -127640,6 +127680,7 @@ function createProjectWatcher(projectDir) {
   const listeners = /* @__PURE__ */ new Set();
   const pendingPaths = /* @__PURE__ */ new Set();
   let debounceTimer = null;
+  let lastFlushAt = Number.NEGATIVE_INFINITY;
   let closeTree = null;
   try {
     closeTree = watchProjectTree(projectDir, (relativePath) => {
@@ -127648,16 +127689,18 @@ function createProjectWatcher(projectDir) {
       }
       pendingPaths.add(relativePath);
       if (debounceTimer) clearTimeout(debounceTimer);
+      const delay2 = Math.max(QUIET_MS, lastFlushAt + BURST_MS - Date.now());
       debounceTimer = setTimeout(() => {
         const changedPaths = [...pendingPaths];
         pendingPaths.clear();
         debounceTimer = null;
+        lastFlushAt = Date.now();
         for (const changedPath of changedPaths) {
           for (const fn of listeners) {
             fn(changedPath);
           }
         }
-      }, DEBOUNCE_MS);
+      }, delay2);
     });
   } catch {
   }
@@ -127676,7 +127719,7 @@ function createProjectWatcher(projectDir) {
     }
   };
 }
-var WATCHER_EXCLUDED_DIRS, DEBOUNCE_MS;
+var WATCHER_EXCLUDED_DIRS, QUIET_MS, BURST_MS;
 var init_fileWatcher = __esm({
   "src/server/fileWatcher.ts"() {
     "use strict";
@@ -127697,7 +127740,8 @@ var init_fileWatcher = __esm({
       "outputs",
       "renders"
     ]);
-    DEBOUNCE_MS = 300;
+    QUIET_MS = 30;
+    BURST_MS = 300;
   }
 });
 
@@ -138837,6 +138881,12 @@ function resolveFontFetchRetryPolicy(configured) {
     )
   };
 }
+function placeAfterEveryStylesheet(document2, head, styleEl) {
+  const stylesheets = document2.querySelectorAll("style, link[rel~=stylesheet]");
+  const lastStylesheet = stylesheets[stylesheets.length - 1];
+  if (lastStylesheet) lastStylesheet.after(styleEl);
+  else head.appendChild(styleEl);
+}
 async function injectDeterministicFontFaces(html, options = {}) {
   const failClosedFontFetch = options.failClosedFontFetch === true;
   const fetchImpl = options.fetchImpl ?? fetch;
@@ -138887,7 +138937,7 @@ async function injectDeterministicFontFaces(html, options = {}) {
   const styleEl = document2.createElement("style");
   styleEl.setAttribute("data-hyperframes-deterministic-fonts", "true");
   styleEl.textContent = css;
-  head.insertBefore(styleEl, head.firstChild);
+  placeAfterEveryStylesheet(document2, head, styleEl);
   defaultLogger.info(
     `[Compiler] Injected deterministic @font-face rules for ${pendingFamilies.size - unresolved.length} requested font families`
   );
@@ -155594,29 +155644,34 @@ async function installAll(installPlan, destDir, baseUrl, force, requestedName, v
   const preserved = [];
   let variablesApplied = [];
   let variablesUnknown = [];
-  let variablesInvalid = [];
   try {
+    const prepared = [];
     for (const planItem of installPlan) {
-      const result = await installItem(planItem, {
-        destDir,
-        baseUrl,
-        force,
-        // Only the item the user named. A dependency dragged in behind it never
-        // declared these variables and must not be rewritten by them.
-        variableValues: planItem.name === requestedName ? variableValues : null
-      });
+      prepared.push(
+        await prepareItem(planItem, {
+          destDir,
+          baseUrl,
+          force,
+          // Only the item the user named. A dependency dragged in behind it never
+          // declared these variables and must not be rewritten by them.
+          variableValues: planItem.name === requestedName ? variableValues : null
+        })
+      );
+    }
+    for (const [i, planItem] of installPlan.entries()) {
+      const result = publishItem(prepared[i]);
       written.push(...result.written);
       preserved.push(...result.preserved);
       if (planItem.name === requestedName) {
         variablesApplied = result.variablesApplied;
         variablesUnknown = result.variablesUnknown;
-        variablesInvalid = result.variablesInvalid;
       }
     }
   } catch (err) {
+    if (err instanceof InvalidVariableValuesError) throw new AddError(err.message, "invalid-vars");
     throw new AddError(describeInstallFailure(err, baseUrl), "install-failed");
   }
-  return { written, preserved, variablesApplied, variablesUnknown, variablesInvalid };
+  return { written, preserved, variablesApplied, variablesUnknown };
 }
 function describeInstallFailure(err, registry) {
   const message = err instanceof Error ? err.message : String(err);
@@ -155659,7 +155714,7 @@ async function runAdd(opts) {
     }))
   }));
   const variableValues = parseVariableValues(opts.vars);
-  const { written, preserved, variablesApplied, variablesUnknown, variablesInvalid } = await installAll(
+  const { written, preserved, variablesApplied, variablesUnknown } = await installAll(
     installPlan,
     projectDir,
     config.registry,
@@ -155686,9 +155741,6 @@ async function runAdd(opts) {
   const snippetTargetRel = primaryInstalledTarget(itemForInstall);
   const snippet = buildSnippet(item, snippetTargetRel, variableValues);
   const clipboardCopied = !opts.skipClipboard && snippet ? copyToClipboard(snippet) : false;
-  for (const { id, reason } of variablesInvalid) {
-    warnings.push(`--vars ${id} ignored: ${reason}`);
-  }
   if (variablesUnknown.length > 0) {
     warnings.push(`--vars ignored (not declared by ${item.name}): ${variablesUnknown.join(", ")}`);
   }
@@ -155716,6 +155768,7 @@ var init_add = __esm({
     init_colors();
     init_registry3();
     init_resolver();
+    init_variableDefaults();
     init_compatibility();
     init_projectConfig();
     init_clipboard();
@@ -155870,8 +155923,9 @@ var init_add = __esm({
                 if (!json) console.log(`  ${c.warn("Warning:")} ${warning}`);
               }
               if (!json) console.log(`  ${c.success("\u2713")} ${result.name}`);
-            } catch {
-              if (!json) console.log(`  ${c.error("\u2717")} ${item.name} (skipped)`);
+            } catch (err) {
+              const reason = err instanceof Error ? err.message : String(err);
+              if (!json) console.log(`  ${c.error("\u2717")} ${item.name} (skipped: ${reason})`);
             }
           }
           if (json) {

package/dist/fontLocalizeCli.js

@@ -72911,17 +72911,17 @@ function truncateSnippet(value, maxLength = 220) {
   return `${normalized2.slice(0, maxLength - 3)}...`;
 }
 function normalized(source) {
-  let text = "";
+  const chars = [];
   const offsets = [];
+  let lastWasSpace = false;
   for (let i = 0; i < source.length; i++) {
-    const char = source[i];
-    if (/\s/.test(char)) {
-      if (text.endsWith(" ")) continue;
-      text += " ";
-    } else text += char;
+    const isSpace = /\s/.test(source[i]);
+    if (isSpace && lastWasSpace) continue;
+    chars.push(isSpace ? " " : source[i]);
     offsets.push(i);
+    lastWasSpace = isSpace;
   }
-  return { text, offsets };
+  return { text: chars.join(""), offsets };
 }
 function createSourceLocator(source) {
   const tags = parseHtmlStructure(source).tags;
@@ -79430,6 +79430,15 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
       `FFmpeg exited successfully but produced no frames (start=${startTime}, duration=${duration})`
     );
   }
+  if (framePaths.size > 0 && duration > 0 && !options.finalFrameOnly) {
+    const expectedAtFps = extractionFrameCountForDuration(duration, normalizedFps, metadata.isVFR);
+    if (expectedAtFps > 0 && framePaths.size <= expectedAtFps * 0.6) {
+      const correctedDuration = startTime + framePaths.size / fps;
+      if (correctedDuration < metadata.videoStreamDurationSeconds) {
+        metadata.videoStreamDurationSeconds = correctedDuration;
+      }
+    }
+  }
   return {
     videoId,
     srcPath: videoPath,
@@ -94205,6 +94214,12 @@ function resolveFontFetchRetryPolicy(configured) {
     )
   };
 }
+function placeAfterEveryStylesheet(document2, head, styleEl) {
+  const stylesheets = document2.querySelectorAll("style, link[rel~=stylesheet]");
+  const lastStylesheet = stylesheets[stylesheets.length - 1];
+  if (lastStylesheet) lastStylesheet.after(styleEl);
+  else head.appendChild(styleEl);
+}
 async function injectDeterministicFontFaces(html, options = {}) {
   const failClosedFontFetch = options.failClosedFontFetch === true;
   const fetchImpl = options.fetchImpl ?? fetch;
@@ -94255,7 +94270,7 @@ async function injectDeterministicFontFaces(html, options = {}) {
   const styleEl = document2.createElement("style");
   styleEl.setAttribute("data-hyperframes-deterministic-fonts", "true");
   styleEl.textContent = css;
-  head.insertBefore(styleEl, head.firstChild);
+  placeAfterEveryStylesheet(document2, head, styleEl);
   defaultLogger.info(
     `[Compiler] Injected deterministic @font-face rules for ${pendingFamilies.size - unresolved.length} requested font families`
   );
@@ -103722,8 +103737,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.68" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.68" : "0.0.0-dev";
+var VERSION = true ? "0.8.69" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.69" : "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 Se=Object.defineProperty;var fn=Object.getOwnPropertyDescriptor;var hn=Object.getOwnPropertyNames;var bn=Object.prototype.hasOwnProperty;var gn=(n,e)=>{for(var t in e)Se(n,t,{get:e[t],enumerable:!0})},_n=(n,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of hn(e))!bn.call(n,r)&&r!==t&&Se(n,r,{get:()=>e[r],enumerable:!(i=fn(e,r))||i.enumerable});return n};var yn=n=>_n(Se({},"__esModule",{value:!0}),n);var Xi={};gn(Xi,{HyperframesPlayer:()=>Ee,SPEED_PRESETS:()=>we,formatSpeed:()=>G,formatTime:()=>ie});function ct(n){return n.hasRuntime||n.runtimeInjected?!1:!!(n.hasNestedCompositions||n.hasTimelines&&n.attempts>=5)}function H(n){return typeof n=="object"&&n!==null}function mt(n){return H(n)&&typeof n.getDuration=="function"}function pt(n){return H(n)&&typeof n.duration=="function"&&typeof n.time=="function"&&typeof n.seek=="function"&&typeof n.play=="function"&&typeof n.pause=="function"}var L="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.8.68/dist/hyperframe.runtime.iife.js";function V(n){if(n===null)return null;let e=Number.parseInt(n,10);return Number.isFinite(e)&&e>0?e:null}function vn(n){let e=n?.querySelector("[data-composition-id][data-width][data-height]")??n?.querySelector("[data-width][data-height]");if(!e)return null;let t=V(e.getAttribute("data-width")),i=V(e.getAttribute("data-height"));return t!==null&&i!==null?{width:t,height:i}:null}var ne=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),r=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(ct({hasRuntime:i,hasTimelines:r,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!i)return;let a=this._resolvePlaybackDurationAdapter(t);if(a&&a.getDuration()>0){this.stop();let s=vn(this._iframe.contentDocument);this._callbacks.onReady({duration:a.getDuration(),adapter:a,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||H(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=L,(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(!H(t))return null;let i=Object.keys(t);if(i.length===0)return null;let r=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=r&&r in t?r:i[i.length-1],a=t[o];return pt(a)?a:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(mt(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let i=this._resolveDirectTimelineAdapterFromWindow(e);return i?{kind:"direct-timeline",timeline:i,getDuration:()=>i.duration()}:null}};var ft=`
+"use strict";var HyperframesPlayer=(()=>{var Se=Object.defineProperty;var fn=Object.getOwnPropertyDescriptor;var hn=Object.getOwnPropertyNames;var bn=Object.prototype.hasOwnProperty;var gn=(n,e)=>{for(var t in e)Se(n,t,{get:e[t],enumerable:!0})},_n=(n,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of hn(e))!bn.call(n,r)&&r!==t&&Se(n,r,{get:()=>e[r],enumerable:!(i=fn(e,r))||i.enumerable});return n};var yn=n=>_n(Se({},"__esModule",{value:!0}),n);var Xi={};gn(Xi,{HyperframesPlayer:()=>Ee,SPEED_PRESETS:()=>we,formatSpeed:()=>G,formatTime:()=>ie});function ct(n){return n.hasRuntime||n.runtimeInjected?!1:!!(n.hasNestedCompositions||n.hasTimelines&&n.attempts>=5)}function H(n){return typeof n=="object"&&n!==null}function mt(n){return H(n)&&typeof n.getDuration=="function"}function pt(n){return H(n)&&typeof n.duration=="function"&&typeof n.time=="function"&&typeof n.seek=="function"&&typeof n.play=="function"&&typeof n.pause=="function"}var L="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.8.69/dist/hyperframe.runtime.iife.js";function V(n){if(n===null)return null;let e=Number.parseInt(n,10);return Number.isFinite(e)&&e>0?e:null}function vn(n){let e=n?.querySelector("[data-composition-id][data-width][data-height]")??n?.querySelector("[data-width][data-height]");if(!e)return null;let t=V(e.getAttribute("data-width")),i=V(e.getAttribute("data-height"));return t!==null&&i!==null?{width:t,height:i}:null}var ne=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),r=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(ct({hasRuntime:i,hasTimelines:r,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!i)return;let a=this._resolvePlaybackDurationAdapter(t);if(a&&a.getDuration()>0){this.stop();let s=vn(this._iframe.contentDocument);this._callbacks.onReady({duration:a.getDuration(),adapter:a,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||H(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=L,(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(!H(t))return null;let i=Object.keys(t);if(i.length===0)return null;let r=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=r&&r in t?r:i[i.length-1],a=t[o];return pt(a)?a:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(mt(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let i=this._resolveDirectTimelineAdapterFromWindow(e);return i?{kind:"direct-timeline",timeline:i,getDuration:()=>i.duration()}:null}};var ft=`
   :host {
     display: block;
     position: relative;

package/dist/renderSetupWorker.js

@@ -25768,17 +25768,17 @@ function mediaSrcTagRe(tagAlternation) {
   return new RegExp(`<(${tagAlternation})\\b[^>]*\\ssrc\\s*=\\s*["']([^"']+)["'][^>]*>`, "gi");
 }
 function normalized(source) {
-  let text = "";
+  const chars = [];
   const offsets = [];
+  let lastWasSpace = false;
   for (let i = 0; i < source.length; i++) {
-    const char = source[i];
-    if (/\s/.test(char)) {
-      if (text.endsWith(" ")) continue;
-      text += " ";
-    } else text += char;
+    const isSpace = /\s/.test(source[i]);
+    if (isSpace && lastWasSpace) continue;
+    chars.push(isSpace ? " " : source[i]);
     offsets.push(i);
+    lastWasSpace = isSpace;
   }
-  return { text, offsets };
+  return { text: chars.join(""), offsets };
 }
 function createSourceLocator(source) {
   const tags = parseHtmlStructure(source).tags;

package/dist/skills/hyperframes/scripts/lib/frame-packets-core.mjs

@@ -1,20 +1,6 @@
-// Shared frame-packet builder — the script half of the frame-worker core/delta split.
-//
-// Each narrative workflow ships a thin `scripts/frame-packets.mjs` wrapper that pins
-// its own paths (animation skill, role delta, design-truth resolution, extra packet
-// sections) and delegates everything else here, exactly as the markdown half already
-// does with `references/frame-worker-core.md` + each workflow's delta. One owner for
-// the packet-building logic; the wrappers own only what genuinely differs per workflow.
-//
-// Packet (<frame_id>.md) = project inputs + the frame's exact `## Frame N` block
-// + the blueprint body + every cited rule recipe, inlined — so a worker never opens
-// the shared STORYBOARD.md or any skill document. Cited motions are found
-// mechanically: the explicit `- rules:` field when present, plus every valid rule id
-// (a filename under the animation skill's rules/) mentioned in the block.
-//
-// _role.md = frame-worker-core.md + the workflow's sub-agents/frame-worker.md,
-// concatenated verbatim — the complete worker role, assembled from the two source
-// documents so nothing is hand-maintained twice.
+// Frame packets inline the storyboard frame, blueprint and cited recipes.
+// Workflow wrappers supply resource paths and workflow-specific sections.
+// The role combines the shared worker contract with the workflow delta.
 
 import {
   existsSync,
@@ -100,12 +86,8 @@ export function resourceSections(block, { animationDir, ruleIds, frameId }) {
   if (blueprint) {
     const blueprintsDir = join(animationDir, "blueprints");
     const path = join(blueprintsDir, `${blueprint}.md`);
-    // A blueprint that resolved to nothing used to inline an empty string, so the
-    // packet shipped without the one document the frame was designed against and
-    // the run still reported success. Name it instead — but only when the library
-    // is actually there to be named against. The animation skill installs on
-    // demand, so an absent blueprints/ is a missing install, not a bad id, and it
-    // degrades with a warning exactly like an absent rules/ (see knownRuleIds).
+    // An installed library must contain the named blueprint.
+    // An absent on-demand library warns, like missing motion rules.
     if (!existsSync(blueprintsDir)) {
       console.warn(
         `frame-packets: no blueprints dir at ${blueprintsDir} — packets will inline no blueprint`,

package/dist/skills/media-use/audio/scripts/lib/bgm-volume.mjs

@@ -0,0 +1,4 @@
+// Music sits under narration; a silent film brings music forward.
+export const BGM_BED_VOLUME = 0.12;
+export const BGM_SILENT_VOLUME = 0.9;
+export const bgmDefaultVolume = (hasVoice) => (hasVoice ? BGM_BED_VOLUME : BGM_SILENT_VOLUME);

package/dist/skills/media-use/audio/scripts/lib/bgm.mjs

@@ -20,12 +20,8 @@ import { pythonInvocation } from "./python.mjs";
 const r3 = (x) => Number(x.toFixed(3));
 const lyriaKey = () => process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY || "";
 
-// Default BGM level. Under narration music is a bed that must stay under the
-// voice — 0.12 linear ≈ -18 dB. A silent film (no voice) has no voice to duck
-// beneath, so BGM sits forward at 0.9. Callers may override per composition.
-export const BGM_BED_VOLUME = 0.12;
-export const BGM_SILENT_VOLUME = 0.9;
-export const bgmDefaultVolume = (hasVoice) => (hasVoice ? BGM_BED_VOLUME : BGM_SILENT_VOLUME);
+import { bgmDefaultVolume } from "./bgm-volume.mjs";
+export { BGM_BED_VOLUME, BGM_SILENT_VOLUME, bgmDefaultVolume } from "./bgm-volume.mjs";
 
 const BGM_PY_DEPS = ["transformers", "torch", "soundfile", "numpy"];
 const BGM_PY_PROBE =

package/dist/skills/media-use/scripts/compatibility.test.mjs

@@ -1,8 +1,10 @@
-import { cpSync, mkdtempSync, rmSync } from "node:fs";
+import assert from "node:assert/strict";
+import { cpSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { execFileSync } from "node:child_process";
 import test from "node:test";
+import { pathToFileURL } from "node:url";
 
 function run(scriptsDir, script, args) {
   return execFileSync(process.execPath, [join(scriptsDir, script), ...args], {
@@ -25,3 +27,68 @@ test("published memory scripts run without reaching outside the skill", () => {
     rmSync(scratchDir, { recursive: true, force: true });
   }
 });
+
+test("published audio helpers import without the CLI package tree", () => {
+  const root = mkdtempSync(join(tmpdir(), "media-use-audio-"));
+  const skill = join(root, "media-use");
+  try {
+    cpSync(new URL("..", import.meta.url), skill, { recursive: true });
+    for (const helper of ["heygen.mjs", "tts.mjs"])
+      run(join(skill, "audio/scripts/lib"), helper, []);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+for (const name of ["faceless-explainer", "pr-to-video", "product-launch-video"]) {
+  test(name + " assembles from its installed directory alone", () => {
+    const root = mkdtempSync(join(tmpdir(), "installed-workflow-"));
+    try {
+      const skill = join(root, name);
+      cpSync(new URL("../../" + name, import.meta.url), skill, { recursive: true });
+      const project = join(root, "project");
+      mkdirSync(join(project, "compositions/frames"), { recursive: true });
+      writeFileSync(
+        join(project, "STORYBOARD.md"),
+        "---\nformat: 1920x1080\nmessage: Test\n---\n\n## Frame 1\n- duration: 3s\n- src: compositions/frames/01-a.html\n",
+      );
+      writeFileSync(
+        join(project, "compositions/frames/01-a.html"),
+        '<template><div data-composition-id="01-a" data-duration="3" data-width="1920" data-height="1080"><section class="clip" data-start="0" data-duration="3"></section></div></template>',
+      );
+      run(join(skill, "scripts"), "assemble-index.mjs", [
+        "--hyperframes",
+        project,
+        "--storyboard",
+        join(project, "STORYBOARD.md"),
+      ]);
+      assert.match(readFileSync(join(project, "index.html"), "utf8"), /01-a/);
+      importPacketBuilder(join(skill, "scripts/frame-packets.mjs"));
+    } finally {
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+}
+
+test("general-video packet builder starts from its installed directory alone", () => {
+  const root = mkdtempSync(join(tmpdir(), "installed-packets-"));
+  try {
+    cpSync(new URL("../../general-video", import.meta.url), root, { recursive: true });
+    importPacketBuilder(join(root, "scripts/frame-packets.mjs"));
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+function importPacketBuilder(path) {
+  execFileSync(
+    process.execPath,
+    [
+      "--input-type=module",
+      "-e",
+      'const m = await import(process.argv[1]); if (typeof m.buildFramePackets !== "function") throw new Error("missing builder");',
+      pathToFileURL(path).href,
+    ],
+    { stdio: "pipe" },
+  );
+}