hyperframes 0.8.49 → 0.8.50

package/dist/renderSetupWorker.js

@@ -56074,6 +56074,40 @@ function isSceneLikeCompositionId(compositionId) {
   return true;
 }
 
+// ../parsers/dist/topLevelElements.js
+var NON_RENDERED_TAGS = /* @__PURE__ */ new Set(["script", "style", "template", "noscript", "link", "meta"]);
+var MEDIA_TAGS = /* @__PURE__ */ new Set(["video", "audio", "img"]);
+var TRACK_KINDS = ["video", "audio", "captions", "graphics"];
+function isSubCompositionHost(node) {
+  return node.attrs["data-composition-src"] !== void 0 || node.attrs["data-composition-id"] !== void 0;
+}
+function isTimedElement(node) {
+  const { attrs } = node;
+  return attrs["data-start"] !== void 0 || attrs["data-track-index"] !== void 0 && attrs["data-duration"] !== void 0 || MEDIA_TAGS.has(node.tag.toLowerCase());
+}
+function topLevelElements(root) {
+  const rows = [];
+  const visit = (node) => {
+    if (NON_RENDERED_TAGS.has(node.tag.toLowerCase())) return;
+    if (isSubCompositionHost(node) || isTimedElement(node)) rows.push(node);
+    else node.children.forEach(visit);
+  };
+  root.children.forEach(visit);
+  return rows;
+}
+function trackKindOf(node) {
+  const explicit = node.attrs["data-track-kind"]?.trim().toLowerCase();
+  if (explicit && TRACK_KINDS.includes(explicit))
+    return { kind: explicit, source: "attribute" };
+  const tag = node.tag.toLowerCase();
+  if (tag === "video" || tag === "audio") return { kind: tag, source: "tag" };
+  if (isSubCompositionHost(node)) {
+    const legacy = node.attrs["data-composition-id"] === "captions" || /(?:^|\s)caption[-_]/.test(node.attrs.class ?? "");
+    return legacy ? { kind: "captions", source: "legacy-captions" } : { kind: "graphics", source: "sub-composition" };
+  }
+  return { kind: "graphics", source: "tag" };
+}
+
 // ../lint/dist/index.js
 import { createHash } from "crypto";
 import { existsSync as existsSync22, readFileSync as readFileSync3, readdirSync as readdirSync3 } from "fs";
@@ -61641,6 +61675,152 @@ var slideshowRules = [
     return findings;
   }
 ];
+var INLINE_TEXT_TAGS = /* @__PURE__ */ new Set([
+  "br",
+  "wbr",
+  "b",
+  "i",
+  "u",
+  "s",
+  "em",
+  "strong",
+  "small",
+  "sub",
+  "sup",
+  "mark",
+  "span",
+  "a",
+  "code",
+  "abbr"
+]);
+var OPAQUE_TAGS = /* @__PURE__ */ new Set([
+  "svg",
+  "canvas",
+  "picture",
+  "video",
+  "audio",
+  "select",
+  "textarea",
+  "iframe",
+  "object"
+]);
+var NON_LAYOUT_TAGS = /* @__PURE__ */ new Set(["style", "script", "template", "noscript"]);
+var MEDIA_TAGS2 = /* @__PURE__ */ new Set(["img", "video", "audio"]);
+var NODE_ATTRS = [
+  "id",
+  "class",
+  "data-start",
+  "data-duration",
+  "data-end",
+  "data-track",
+  "data-track-index",
+  "data-track-kind",
+  "data-composition-id",
+  "data-composition-src"
+];
+function toNode(open) {
+  const attrs = {};
+  for (const name of NODE_ATTRS) attrs[name] = readDecodedAttr(open.raw, name) ?? void 0;
+  return { tag: open.name, attrs, children: [], open };
+}
+function enclosing(stack, root, index) {
+  let top = stack.at(-1);
+  while (top && stack.length > 1 && index >= top.end) {
+    stack.pop();
+    top = stack.at(-1);
+  }
+  return top?.node ?? root;
+}
+function buildTree(ctx) {
+  const { rootTag } = ctx;
+  const rootEnd = rootTag?.closeIndex;
+  if (!rootTag || rootEnd == null) return null;
+  const root = toNode(rootTag);
+  const stack = [{ node: root, end: rootEnd }];
+  for (const tag of ctx.tags.filter((t) => t.index > rootTag.index && t.index < rootEnd)) {
+    const node = toNode(tag);
+    enclosing(stack, root, tag.index).children.push(node);
+    if (tag.closeIndex != null) stack.push({ node, end: tag.closeIndex });
+  }
+  return root;
+}
+function hasNestedStructure(node) {
+  if (OPAQUE_TAGS.has(node.tag)) return null;
+  for (const child of node.children) {
+    if (NON_LAYOUT_TAGS.has(child.tag)) continue;
+    if (!INLINE_TEXT_TAGS.has(child.tag)) return child;
+    const deeper = hasNestedStructure(child);
+    if (deeper) return deeper;
+  }
+  return null;
+}
+var describe = (node) => `<${node.tag}${node.attrs.id ? ` id="${node.attrs.id}"` : ""}>`;
+function nestedStructureFindings(rows, severity) {
+  return rows.flatMap((row) => {
+    const nested = isSubCompositionHost(row) ? null : hasNestedStructure(row);
+    if (!nested) return [];
+    return [
+      {
+        code: "nested_structure_needs_subcomposition",
+        severity,
+        message: `${describe(row)} is a timeline element that contains nested ${describe(nested)}. The timeline shows one row per top-level element, and the root composition is built only from sub-compositions.`,
+        elementId: row.attrs.id,
+        fixHint: `Move ${describe(row)} and its contents into a sub-composition file and mount it with data-composition-src.`
+      }
+    ];
+  });
+}
+function missingDurationFindings(rows, severity) {
+  const intendedClip = (row) => !MEDIA_TAGS2.has(row.tag) || row.attrs["data-start"] !== void 0 || row.attrs["data-track-index"] !== void 0;
+  return rows.filter(
+    (row) => row.attrs["data-duration"] === void 0 && row.attrs["data-end"] === void 0 && !isSubCompositionHost(row) && intendedClip(row)
+  ).map((row) => {
+    const isMedia = MEDIA_TAGS2.has(row.tag);
+    return {
+      code: isMedia ? "media_missing_duration" : "timeline_element_missing_timing",
+      severity,
+      message: isMedia ? `${describe(row)} is media on the timeline without data-duration, so its clip has no length.` : `${describe(row)} is a timeline element without data-duration, so the timeline cannot draw where it ends.`,
+      elementId: row.attrs.id,
+      fixHint: `Add data-duration (in seconds) to ${describe(row)}.`
+    };
+  });
+}
+function captionFindings(rows, severity) {
+  const captionRows = rows.filter((row) => trackKindOf(row).kind === "captions");
+  const findings = captionRows.filter((row) => trackKindOf(row).source === "legacy-captions").map((row) => ({
+    code: "caption_track_kind_missing",
+    severity,
+    message: `${describe(row)} looks like captions but is not marked as such, so the timeline cannot group it on the caption track.`,
+    elementId: row.attrs.id,
+    fixHint: `Add data-track-kind="captions" to ${describe(row)}.`
+  }));
+  const lanes = new Set(
+    captionRows.flatMap((row) => row.attrs["data-track-index"] ?? row.attrs["data-track"] ?? [])
+  );
+  if (lanes.size > 1) {
+    findings.push({
+      code: "multiple_caption_tracks",
+      severity,
+      message: `Captions are spread across ${lanes.size} timeline tracks. Keep all captions on one track.`,
+      fixHint: "Give every caption element the same data-track-index."
+    });
+  }
+  return findings;
+}
+var structureRules = [
+  (ctx) => {
+    if (ctx.options.isSubComposition) return [];
+    const root = buildTree(ctx);
+    if (!root) return [];
+    const severity = ctx.options.host === "studio" ? "error" : "warning";
+    const rows = topLevelElements(root);
+    return [
+      ...nestedStructureFindings(rows, severity),
+      ...missingDurationFindings(rows, severity),
+      ...captionFindings(rows, severity)
+    ];
+  }
+];
 var RULE_GROUPS = [
   { group: "core", rules: coreRules },
   { group: "media", rules: mediaRules },
@@ -61650,7 +61830,8 @@ var RULE_GROUPS = [
   { group: "adapters", rules: adapterRules },
   { group: "textures", rules: textureRules },
   { group: "fonts", rules: fontRules },
-  { group: "slideshow", rules: slideshowRules }
+  { group: "slideshow", rules: slideshowRules },
+  { group: "structure", rules: structureRules }
 ];
 var LINT_RULE_COUNT = RULE_GROUPS.reduce((n, g) => n + g.rules.length, 0);
 var LINT_RULE_GROUP_COUNTS = Object.fromEntries(
@@ -62008,7 +62189,7 @@ function resolveCssAssetCandidates(projectDir, url, htmlCompSrcPath, cssRootRela
   }
   return resolveLocalAssetCandidates(projectDir, url);
 }
-async function lintProject(projectDir, entryFile) {
+async function lintProject(projectDir, entryFile, hostOptions = {}) {
   const indexPath = entryFile ? resolve4(entryFile) : resolve4(projectDir, "index.html");
   if (entryFile && !isWithinProjectRoot(projectDir, indexPath)) {
     throw new Error(`Explicit lint entry is outside the project directory: ${entryFile}`);
@@ -62021,6 +62202,7 @@ async function lintProject(projectDir, entryFile) {
   let totalInfos = 0;
   const rootHtml = readFileSync3(indexPath, "utf-8");
   const rootResult = await lintHyperframeHtml(rootHtml, {
+    ...hostOptions,
     filePath: indexPath,
     externalStyles: collectExternalStyles(projectDir, rootHtml, rootCompSrcPath)
   });
@@ -62052,6 +62234,7 @@ async function lintProject(projectDir, entryFile) {
       allHtmlSources.push({ html, compSrcPath });
       if (isSnippetFragment(html)) continue;
       const result2 = await lintHyperframeHtml(html, {
+        ...hostOptions,
         filePath,
         isSubComposition: true,
         externalStyles: collectExternalStyles(projectDir, html, compSrcPath)

package/dist/studio/assets/{hyperframes-player-CqON2Rzo.js → hyperframes-player-CxxDxHTW.js}

@@ -1,4 +1,4 @@
-var we=Object.defineProperty;var Ae=(s,i,e)=>i in s?we(s,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[i]=e;var u=(s,i,e)=>Ae(s,typeof i!="symbol"?i+"":i,e);import{r as ue,i as w,a as he,b as Ee,c as Te,s as Ce,d as Re}from"./index-Bgmx2h7W.js";function Se(s){return s.hasRuntime||s.runtimeInjected?!1:!!(s.hasNestedCompositions||s.hasTimelines&&s.attempts>=5)}function $(s){return typeof s=="object"&&s!==null}function xe(s){return $(s)&&typeof s.getDuration=="function"}function Le(s){return $(s)&&typeof s.duration=="function"&&typeof s.time=="function"&&typeof s.seek=="function"&&typeof s.play=="function"&&typeof s.pause=="function"}function Me(s){if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(s))throw new Error(`Invalid HyperFrames runtime version: ${s}`);return`https://cdn.jsdelivr.net/npm/@hyperframes/core@${s}/dist/hyperframe.runtime.iife.js`}const H=typeof __HYPERFRAMES_RUNTIME_CDN_URL__=="string"?__HYPERFRAMES_RUNTIME_CDN_URL__:Me("0.0.0-dev");function V(s){if(s===null)return null;const i=Number.parseInt(s,10);return Number.isFinite(i)&&i>0?i:null}function De(s){const i=(s==null?void 0:s.querySelector("[data-composition-id][data-width][data-height]"))??(s==null?void 0:s.querySelector("[data-width][data-height]"));if(!i)return null;const e=V(i.getAttribute("data-width")),t=V(i.getAttribute("data-height"));return e!==null&&t!==null?{width:e,height:t}:null}class Pe{constructor(i,e){u(this,"_interval",null);u(this,"_runtimeInjected",!1);this._iframe=i,this._callbacks=e}get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let i=0;this._interval=setInterval(()=>{var e;i++;try{const t=this._iframe.contentWindow;if(!t)return;const r=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!((e=this._iframe.contentDocument)!=null&&e.querySelector("[data-composition-src]"));if(Se({hasRuntime:r,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:i})){this._injectRuntime();return}if(this._runtimeInjected&&!r)return;const d=this._resolvePlaybackDurationAdapter(t);if(d&&d.getDuration()>0){this.stop();const c=De(this._iframe.contentDocument);this._callbacks.onReady({duration:d.getDuration(),adapter:d,compositionSize:c});return}}catch{}i>=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{const i=this._iframe.contentWindow;return i?this._resolveDirectTimelineAdapterFromWindow(i):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(i){return this._resolveDirectTimelineAdapterFromWindow(i)}hasRuntimeBridge(i){return Reflect.get(i,"__hf")!==void 0||$(Reflect.get(i,"__player"))}_injectRuntime(){var i,e;this._runtimeInjected=!0;try{const t=this._iframe.contentDocument;if(!t)return;const r=t.createElement("script");r.src=H,(t.head||t.documentElement).appendChild(r),(e=(i=this._callbacks).onRuntimeInjected)==null||e.call(i)}catch{}}_resolveDirectTimelineAdapterFromWindow(i){var d,c;if(this.hasRuntimeBridge(i))return null;const e=Reflect.get(i,"__timelines");if(!$(e))return null;const t=Object.keys(e);if(t.length===0)return null;const r=(c=(d=this._iframe.contentDocument)==null?void 0:d.querySelector("[data-composition-id]"))==null?void 0:c.getAttribute("data-composition-id"),n=r&&r in e?r:t[t.length-1],o=e[n];return Le(o)?o:null}_resolvePlaybackDurationAdapter(i){const e=Reflect.get(i,"__player");if(xe(e))return{kind:"runtime",getDuration:()=>e.getDuration()};const t=this._resolveDirectTimelineAdapterFromWindow(i);return t?{kind:"direct-timeline",timeline:t,getDuration:()=>t.duration()}:null}}const ke=`
+var we=Object.defineProperty;var Ae=(s,i,e)=>i in s?we(s,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[i]=e;var u=(s,i,e)=>Ae(s,typeof i!="symbol"?i+"":i,e);import{r as ue,i as w,a as he,b as Ee,c as Te,s as Ce,d as Re}from"./index-n2ml4tUn.js";function Se(s){return s.hasRuntime||s.runtimeInjected?!1:!!(s.hasNestedCompositions||s.hasTimelines&&s.attempts>=5)}function $(s){return typeof s=="object"&&s!==null}function xe(s){return $(s)&&typeof s.getDuration=="function"}function Le(s){return $(s)&&typeof s.duration=="function"&&typeof s.time=="function"&&typeof s.seek=="function"&&typeof s.play=="function"&&typeof s.pause=="function"}function Me(s){if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(s))throw new Error(`Invalid HyperFrames runtime version: ${s}`);return`https://cdn.jsdelivr.net/npm/@hyperframes/core@${s}/dist/hyperframe.runtime.iife.js`}const H=typeof __HYPERFRAMES_RUNTIME_CDN_URL__=="string"?__HYPERFRAMES_RUNTIME_CDN_URL__:Me("0.0.0-dev");function V(s){if(s===null)return null;const i=Number.parseInt(s,10);return Number.isFinite(i)&&i>0?i:null}function De(s){const i=(s==null?void 0:s.querySelector("[data-composition-id][data-width][data-height]"))??(s==null?void 0:s.querySelector("[data-width][data-height]"));if(!i)return null;const e=V(i.getAttribute("data-width")),t=V(i.getAttribute("data-height"));return e!==null&&t!==null?{width:e,height:t}:null}class Pe{constructor(i,e){u(this,"_interval",null);u(this,"_runtimeInjected",!1);this._iframe=i,this._callbacks=e}get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let i=0;this._interval=setInterval(()=>{var e;i++;try{const t=this._iframe.contentWindow;if(!t)return;const r=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!((e=this._iframe.contentDocument)!=null&&e.querySelector("[data-composition-src]"));if(Se({hasRuntime:r,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:i})){this._injectRuntime();return}if(this._runtimeInjected&&!r)return;const d=this._resolvePlaybackDurationAdapter(t);if(d&&d.getDuration()>0){this.stop();const c=De(this._iframe.contentDocument);this._callbacks.onReady({duration:d.getDuration(),adapter:d,compositionSize:c});return}}catch{}i>=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{const i=this._iframe.contentWindow;return i?this._resolveDirectTimelineAdapterFromWindow(i):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(i){return this._resolveDirectTimelineAdapterFromWindow(i)}hasRuntimeBridge(i){return Reflect.get(i,"__hf")!==void 0||$(Reflect.get(i,"__player"))}_injectRuntime(){var i,e;this._runtimeInjected=!0;try{const t=this._iframe.contentDocument;if(!t)return;const r=t.createElement("script");r.src=H,(t.head||t.documentElement).appendChild(r),(e=(i=this._callbacks).onRuntimeInjected)==null||e.call(i)}catch{}}_resolveDirectTimelineAdapterFromWindow(i){var d,c;if(this.hasRuntimeBridge(i))return null;const e=Reflect.get(i,"__timelines");if(!$(e))return null;const t=Object.keys(e);if(t.length===0)return null;const r=(c=(d=this._iframe.contentDocument)==null?void 0:d.querySelector("[data-composition-id]"))==null?void 0:c.getAttribute("data-composition-id"),n=r&&r in e?r:t[t.length-1],o=e[n];return Le(o)?o:null}_resolvePlaybackDurationAdapter(i){const e=Reflect.get(i,"__player");if(xe(e))return{kind:"runtime",getDuration:()=>e.getDuration()};const t=this._resolveDirectTimelineAdapterFromWindow(i);return t?{kind:"direct-timeline",timeline:t,getDuration:()=>t.duration()}:null}}const ke=`
   :host {
     display: block;
     position: relative;

package/dist/studio/assets/{index-mIgSsKqs.js → index-DUAIWxkI.js}

@@ -1 +1 @@
-import{g as P}from"./index-Bgmx2h7W.js";function j(c,d){for(var s=0;s<d.length;s++){const a=d[s];if(typeof a!="string"&&!Array.isArray(a)){for(const i in a)if(i!=="default"&&!(i in c)){const l=Object.getOwnPropertyDescriptor(a,i);l&&Object.defineProperty(c,i,l.get?l:{enumerable:!0,get:()=>a[i]})}}}return Object.freeze(Object.defineProperty(c,Symbol.toStringTag,{value:"Module"}))}var v={},w;function k(){if(w)return v;w=1,Object.defineProperty(v,"__esModule",{value:!0}),v.default=d;var c=window.OfflineAudioContext||window.webkitOfflineAudioContext;function d(e){var r=a(e);return r.start(0),[i,y,O(e.sampleRate),s].reduce(function(t,o){return o(t)},r.buffer.getChannelData(0))}function s(e){return e.sort(function(r,t){return t.count-r.count}).splice(0,5)[0].tempo}function a(e){var r=e.length,t=e.numberOfChannels,o=e.sampleRate,n=new c(t,r,o),u=n.createBufferSource();u.buffer=e;var f=n.createBiquadFilter();return f.type="lowpass",u.connect(f),f.connect(n.destination),u}function i(e){for(var r=[],t=.9,o=.3,n=15;r.length<n&&t>=o;)r=l(e,t),t-=.05;if(r.length<n)throw new Error("Could not find enough samples for a reliable detection.");return r}function l(e,r){for(var t=[],o=0,n=e.length;o<n;o+=1)e[o]>r&&(t.push(o),o+=1e4);return t}function y(e){var r=[];return e.forEach(function(t,o){for(var n=function(x){var g=e[o+x]-t,_=r.some(function(h){if(h.interval===g)return h.count+=1});_||r.push({interval:g,count:1})},u=0;u<10;u+=1)n(u)}),r}function O(e){return function(r){var t=[];return r.forEach(function(o){if(o.interval!==0){for(var n=60/(o.interval/e);n<90;)n*=2;for(;n>180;)n/=2;n=Math.round(n);var u=t.some(function(f){if(f.tempo===n)return f.count+=o.count});u||t.push({tempo:n,count:o.count})}}),t}}return v}var p,b;function q(){return b||(b=1,p=k().default),p}var m=q();const A=P(m),D=j({__proto__:null,default:A},[m]);export{D as i};
+import{g as P}from"./index-n2ml4tUn.js";function j(c,d){for(var s=0;s<d.length;s++){const a=d[s];if(typeof a!="string"&&!Array.isArray(a)){for(const i in a)if(i!=="default"&&!(i in c)){const l=Object.getOwnPropertyDescriptor(a,i);l&&Object.defineProperty(c,i,l.get?l:{enumerable:!0,get:()=>a[i]})}}}return Object.freeze(Object.defineProperty(c,Symbol.toStringTag,{value:"Module"}))}var v={},w;function k(){if(w)return v;w=1,Object.defineProperty(v,"__esModule",{value:!0}),v.default=d;var c=window.OfflineAudioContext||window.webkitOfflineAudioContext;function d(e){var r=a(e);return r.start(0),[i,y,O(e.sampleRate),s].reduce(function(t,o){return o(t)},r.buffer.getChannelData(0))}function s(e){return e.sort(function(r,t){return t.count-r.count}).splice(0,5)[0].tempo}function a(e){var r=e.length,t=e.numberOfChannels,o=e.sampleRate,n=new c(t,r,o),u=n.createBufferSource();u.buffer=e;var f=n.createBiquadFilter();return f.type="lowpass",u.connect(f),f.connect(n.destination),u}function i(e){for(var r=[],t=.9,o=.3,n=15;r.length<n&&t>=o;)r=l(e,t),t-=.05;if(r.length<n)throw new Error("Could not find enough samples for a reliable detection.");return r}function l(e,r){for(var t=[],o=0,n=e.length;o<n;o+=1)e[o]>r&&(t.push(o),o+=1e4);return t}function y(e){var r=[];return e.forEach(function(t,o){for(var n=function(x){var g=e[o+x]-t,_=r.some(function(h){if(h.interval===g)return h.count+=1});_||r.push({interval:g,count:1})},u=0;u<10;u+=1)n(u)}),r}function O(e){return function(r){var t=[];return r.forEach(function(o){if(o.interval!==0){for(var n=60/(o.interval/e);n<90;)n*=2;for(;n>180;)n/=2;n=Math.round(n);var u=t.some(function(f){if(f.tempo===n)return f.count+=o.count});u||t.push({tempo:n,count:o.count})}}),t}}return v}var p,b;function q(){return b||(b=1,p=k().default),p}var m=q();const A=P(m),D=j({__proto__:null,default:A},[m]);export{D as i};

package/dist/studio/assets/{index-BGovDksE.js → index-Dt3qBI-9.js}

@@ -1,4 +1,4 @@
-import{n as Qi}from"./index-Bgmx2h7W.js";/*!
+import{n as Qi}from"./index-n2ml4tUn.js";/*!
  * Copyright (c) 2026-present, Vanilagy and contributors
  *
  * This Source Code Form is subject to the terms of the Mozilla Public