@hyperframes/studio 0.8.149 → 0.8.151

package/dist/assets/{index-BybGk67U.js → index-DWIHrAY2.js}

@@ -1 +1 @@
-import{h as P}from"./index-ByJU5J6n.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 h=e[o+x]-t,_=r.some(function(g){if(g.interval===h)return g.count+=1});_||r.push({interval:h,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{h as P}from"./index-BGks9KLI.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 h=e[o+x]-t,_=r.some(function(g){if(g.interval===h)return g.count+=1});_||r.push({interval:h,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/assets/{index-Cfs2r3fz.js → index-DgbLblGR.js}

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

package/dist/index.d.ts

@@ -354,9 +354,10 @@ interface TimelineElement {
     /** Clip-edge fades from `data-fade-in` / `data-fade-out`, seconds; absent means none. */
     fadeIn?: number;
     fadeOut?: number;
-    /** Verbatim `data-fx-chain` / `data-automation`; see automationLaneData. */
+    /** Verbatim `data-fx-chain` / `data-automation` (`masterChain`: the root's); see automationLaneData. */
     fxChain?: string;
     automation?: string;
+    masterChain?: string;
     /** Path from data-composition-src — identifies sub-composition elements */
     compositionSrc?: string;
     /** Set by data-timeline-locked on the host element — disables move and trim in Studio. */

package/dist/index.html

@@ -14,7 +14,7 @@
         document.documentElement.dataset.theme = "paper";
       }
     </script>
-    <script type="module" crossorigin src="/assets/index-ByJU5J6n.js"></script>
+    <script type="module" crossorigin src="/assets/index-BGks9KLI.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-DkQKsFxx.css">
   </head>
   <body>

package/dist/index.js

@@ -5026,17 +5026,7 @@ function matchesSelector(tweenSelector, querySelector) {
 }
 
 // src/hooks/gsapShared.ts
-var PROPERTY_DEFAULTS = {
-  opacity: 1,
-  x: 0,
-  y: 0,
-  scale: 1,
-  scaleX: 1,
-  scaleY: 1,
-  rotation: 0,
-  width: 100,
-  height: 100
-};
+import { KEYFRAME_PROPERTY_DEFAULTS } from "@hyperframes/core/keyframe-defaults";
 function keyframeEases(anim) {
   if (!anim.keyframes) return { easeEach: anim.ease };
   return { ease: runEaseOf(anim), easeEach: anim.keyframes.easeEach };
@@ -5327,14 +5317,14 @@ function synthesizeFlatTweenKeyframes(anim) {
   if (anim.method === "from") {
     for (const [k, v] of Object.entries(toProps)) {
       rawStart[k] = v;
-      rawEnd[k] = PROPERTY_DEFAULTS[k] ?? 0;
+      rawEnd[k] = KEYFRAME_PROPERTY_DEFAULTS[k] ?? 0;
     }
   } else if (anim.method === "fromTo" && fromProps) {
     Object.assign(rawStart, fromProps);
     Object.assign(rawEnd, toProps);
   } else {
     for (const [k, v] of Object.entries(toProps)) {
-      rawStart[k] = PROPERTY_DEFAULTS[k] ?? 0;
+      rawStart[k] = KEYFRAME_PROPERTY_DEFAULTS[k] ?? 0;
       rawEnd[k] = v;
     }
   }
@@ -23030,7 +23020,7 @@ function propertyStops(animation2, property, start) {
   }));
   const first = stops[0];
   if (!first || first.percentage <= 0 || typeof first.value !== "number") return stops;
-  return [{ percentage: 0, value: start ?? PROPERTY_DEFAULTS[property] ?? 0 }, ...stops];
+  return [{ percentage: 0, value: start ?? KEYFRAME_PROPERTY_DEFAULTS[property] ?? 0 }, ...stops];
 }
 function interpolableEnds(before, after) {
   if (typeof before.value !== "number" || typeof after.value !== "number") return null;
@@ -29115,6 +29105,7 @@ import { useCallback as useCallback38, useRef as useRef46 } from "react";
 // src/player/lib/timelineDOM.ts
 import { resolveCssStackingContextId } from "@hyperframes/core/runtime/stacking-context";
 import { readClipTiming as readClipTiming2 } from "@hyperframes/core/composition-contract";
+import { readMasterFxChain } from "@hyperframes/core/audio-groups";
 import { linkScopeOf } from "@hyperframes/core/media-link";
 import { createRuntimeStartTimeResolver as createRuntimeStartTimeResolver2 } from "@hyperframes/core/runtime/start-resolver";
 
@@ -29693,6 +29684,8 @@ function createTimelineElementFromManifestClip(params) {
       if (info.fxChain) entry2.audioGroupFxChain = info.fxChain;
       if (info.automation) entry2.audioGroupAutomation = info.automation;
     }
+    const masterChain = readMasterFxChain(doc ?? hostEl.ownerDocument);
+    if (masterChain) entry2.masterChain = masterChain;
     const fxChain = hostEl.getAttribute("data-fx-chain");
     if (fxChain) entry2.fxChain = fxChain;
     const automation = hostEl.getAttribute("data-automation");
@@ -29815,6 +29808,8 @@ function parseTimelineFromDOM(doc, rootDuration, timelines) {
       const resolvedSrc = mediaEl.src || void 0;
       if (resolvedSrc) entry2.src = resolvedSrc;
     }
+    const domMasterChain = readMasterFxChain(doc);
+    if (domMasterChain) entry2.masterChain = domMasterChain;
     const domFxChain = el.getAttribute("data-fx-chain");
     if (domFxChain) entry2.fxChain = domFxChain;
     const domAutomation = el.getAttribute("data-automation");
@@ -47639,7 +47634,7 @@ async function commitWholePropertyOffset(selection, anim, newValues, currentPct,
   const ts = resolveTweenStart(effectiveAnim);
   const td = resolveTweenDuration(effectiveAnim);
   const keys = Object.keys(newValues);
-  const at = (props, key2) => typeof props[key2] === "number" ? props[key2] : PROPERTY_DEFAULTS[key2] ?? 0;
+  const at = (props, key2) => typeof props[key2] === "number" ? props[key2] : KEYFRAME_PROPERTY_DEFAULTS[key2] ?? 0;
   const kfs = effectiveAnim.keyframes?.keyframes ?? synthesizeFlatTweenKeyframes(effectiveAnim)?.keyframes;
   if (!kfs || kfs.length === 0) {
     await callbacks.commitMutation(
@@ -74831,7 +74826,9 @@ function claimHeld(reply, label) {
   if (reply.ok)
     return reply.body?.claimed?.id ?? null;
   if (reply.status !== 404)
-    console.error(`"${label}" was not recorded as your edit: ${reply.error}`);
+    console.error(
+      `[history] ${reply.status}: "${label}" was not recorded as your edit: ${reply.error}`
+    );
   return null;
 }
 async function overwroteVersions(files) {
@@ -82590,7 +82587,7 @@ async function commitKeyframeAtTimeImpl(selection, absoluteTime, animations, pro
     }
     const backfillDefaults = {};
     for (const key2 of Object.keys(properties)) {
-      backfillDefaults[key2] = PROPERTY_DEFAULTS[key2] ?? 0;
+      backfillDefaults[key2] = KEYFRAME_PROPERTY_DEFAULTS[key2] ?? 0;
     }
     await commitMutation(
       selection,
@@ -83011,7 +83008,7 @@ function useGsapPropertyDebounce(commitMutationSafely, sdk) {
   const addGsapProperty = useCallback137(
     // fallow-ignore-next-line complexity
     async (selection, animationId, property) => {
-      let defaultValue = PROPERTY_DEFAULTS[property] ?? 0;
+      let defaultValue = KEYFRAME_PROPERTY_DEFAULTS[property] ?? 0;
       const el = selection.element;
       if (property === "width" || property === "height") {
         const rect = el.getBoundingClientRect();
@@ -83133,7 +83130,7 @@ function useGsapPropertyDebounce(commitMutationSafely, sdk) {
   );
   const addGsapFromProperty = useCallback137(
     async (selection, animationId, property) => {
-      const defaultValue = PROPERTY_DEFAULTS[property] ?? 0;
+      const defaultValue = KEYFRAME_PROPERTY_DEFAULTS[property] ?? 0;
       const { sdkSession, sdkDeps, activeCompPath } = sdkRef.current ?? {};
       if (sdkSession && sdkDeps) {
         const targetPath = selection.sourceFile || activeCompPath || "index.html";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.8.149",
+  "version": "0.8.151",
   "description": "",
   "repository": {
     "type": "git",
@@ -60,12 +60,12 @@
     "dockview-react": "8.3.1",
     "gsap": "^3.13.0",
     "mediabunny": "^1.45.3",
-    "@hyperframes/core": "0.8.149",
-    "@hyperframes/player": "0.8.149",
-    "@hyperframes/parsers": "0.8.149",
-    "@hyperframes/shader-transitions": "0.8.149",
-    "@hyperframes/sdk": "0.8.149",
-    "@hyperframes/studio-server": "0.8.149"
+    "@hyperframes/player": "0.8.151",
+    "@hyperframes/sdk": "0.8.151",
+    "@hyperframes/core": "0.8.151",
+    "@hyperframes/shader-transitions": "0.8.151",
+    "@hyperframes/studio-server": "0.8.151",
+    "@hyperframes/parsers": "0.8.151"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.3.3",
@@ -82,7 +82,7 @@
     "vite": "^6.4.2",
     "vitest": "^4.1.11",
     "zustand": "^5.0.0",
-    "@hyperframes/producer": "0.8.149"
+    "@hyperframes/producer": "0.8.151"
   },
   "peerDependencies": {
     "react": "19",

package/src/hooks/gsapShared.ts

@@ -25,17 +25,7 @@ export interface IframeGsap {
 
 // ── Constants ─────────────────────────────────────────────────────────────────
 
-export const PROPERTY_DEFAULTS: Record<string, number> = {
-  opacity: 1,
-  x: 0,
-  y: 0,
-  scale: 1,
-  scaleX: 1,
-  scaleY: 1,
-  rotation: 0,
-  width: 100,
-  height: 100,
-};
+export { KEYFRAME_PROPERTY_DEFAULTS as PROPERTY_DEFAULTS } from "@hyperframes/core/keyframe-defaults";
 
 /** A tween's eases for re-writing it as keyframes: a flat tween's ease must become easeEach,
  *  since GSAP eases each percentage segment power1.inOut whatever the tween-level ease says. */

package/src/hooks/usePersistentEditHistory.test.ts

@@ -561,7 +561,9 @@ it("a claim the server refused is logged, and the write stays undoable as a chan
       files: { "index.html": { before: "A", after: "B" } },
     }),
   );
-  expect(logged).toHaveBeenCalledWith('"Moved Title" was not recorded as your edit: disk full');
+  expect(logged).toHaveBeenCalledWith(
+    '[history] 500: "Moved Title" was not recorded as your edit: disk full',
+  );
   restoreFetch();
   expect(await act(() => hook().undo({ readFile }))).toMatchObject({
     ok: true,
@@ -570,6 +572,46 @@ it("a claim the server refused is logged, and the write stays undoable as a chan
   expect(file()).toBe("A");
 });
 
+it.each([
+  [
+    "the server refused",
+    409,
+    () => answer("/history/claim", 409, { error: "newer edit" }),
+    "newer edit",
+  ],
+  [
+    "could not reach the server",
+    0,
+    () => {
+      const real = globalThis.fetch;
+      vi.stubGlobal("fetch", (url: string, init?: RequestInit) =>
+        url.endsWith("/history/claim")
+          ? Promise.reject(new TypeError("fetch failed"))
+          : real(url, init),
+      );
+    },
+    "Studio could not reach its server.",
+  ],
+] as const)(
+  "a claim that %s logs under [history] with its status",
+  async (_, status, stub, reason) => {
+    const { hook, save } = await studio();
+    const logged = vi.spyOn(console, "error").mockImplementation(() => {});
+    cleanup.push(() => logged.mockRestore());
+    stub();
+    save("B");
+    await act(() =>
+      hook().recordEdit({
+        label: "Moved Title",
+        files: { "index.html": { before: "A", after: "B" } },
+      }),
+    );
+    expect(logged).toHaveBeenCalledWith(
+      `[history] ${status}: "Moved Title" was not recorded as your edit: ${reason}`,
+    );
+  },
+);
+
 it("a step whose reply cannot be read says so, instead of throwing", async () => {
   const { hook, readFile } = await studio();
   answer("/history/step", 200, "<html>");

package/src/hooks/usePersistentEditHistory.ts

@@ -154,7 +154,9 @@ function claimHeld(reply: Awaited<ReturnType<typeof post>>, label: string): stri
   if (reply.ok)
     return (reply.body as { claimed: { id: string } | null } | null)?.claimed?.id ?? null;
   if (reply.status !== 404)
-    console.error(`"${label}" was not recorded as your edit: ${reply.error}`);
+    console.error(
+      `[history] ${reply.status}: "${label}" was not recorded as your edit: ${reply.error}`,
+    );
   return null;
 }
 

package/src/player/lib/timelineDOM.test.ts

@@ -632,6 +632,61 @@ describe("audio FX attributes on parsed elements", () => {
   });
 });
 
+describe("the master chain on parsed elements", () => {
+  const CHAIN = '{"version":1,"nodes":[{"type":"truepeak","id":"m1","params":{}}]}';
+  const parseVideo = (rootAttrs: string, inner = ""): TimelineElement | undefined => {
+    const doc = new DOMParser().parseFromString(
+      `<div data-composition-id="main" data-start="0" data-duration="10" ${rootAttrs}>
+         <video id="talk" data-start="0" data-duration="10" data-has-audio="true"></video>${inner}
+       </div>`,
+      "text/html",
+    );
+    return parseTimelineFromDOM(doc, 10).find((e) => e.domId === "talk");
+  };
+
+  it("copies the root's data-fx-chain onto an element that has none of its own", () => {
+    const talk = parseVideo(`data-fx-chain='${CHAIN}'`);
+    expect(talk?.masterChain).toBe(CHAIN);
+    expect(talk?.fxChain).toBeUndefined();
+  });
+
+  it("leaves it unset when the root carries none", () => {
+    expect(parseVideo("")?.masterChain).toBeUndefined();
+  });
+
+  it("ignores a sub-composition root's chain", () => {
+    const inner = `<div data-composition-id="inner" data-fx-chain='${CHAIN}'></div>`;
+    expect(parseVideo("", inner)?.masterChain).toBeUndefined();
+  });
+
+  it("carries it on the manifest path too", () => {
+    const doc = makeDoc(`
+      <div data-composition-id="main" data-fx-chain='${CHAIN}'>
+        <video id="talk" data-has-audio="true"></video>
+      </div>
+    `);
+    const element = createTimelineElementFromManifestClip({
+      clip: {
+        id: "talk",
+        label: "Talk",
+        kind: "video",
+        tagName: "video",
+        start: 0,
+        duration: 10,
+        track: 0,
+        compositionId: null,
+        parentCompositionId: "main",
+        compositionSrc: null,
+        assetUrl: null,
+      },
+      fallbackIndex: 0,
+      doc,
+      hostEl: doc.getElementById("talk"),
+    });
+    expect(element.masterChain).toBe(CHAIN);
+  });
+});
+
 // A composition clip trimmed by 30 px collapsed to its first nested video's 1.77 s: that length capped the trim.
 describe("a composition clip's source length", () => {
   const scene = `

package/src/player/lib/timelineDOM.ts

@@ -12,6 +12,7 @@ import type { TimelineElement } from "../store/playerStore";
 import type { ClipManifestClip, IframeWindow, TimelineLike } from "./playbackTypes";
 import { resolveCssStackingContextId } from "@hyperframes/core/runtime/stacking-context";
 import { readClipTiming } from "@hyperframes/core/composition-contract";
+import { readMasterFxChain } from "@hyperframes/core/audio-groups";
 import { linkScopeOf } from "@hyperframes/core/media-link";
 import { createRuntimeStartTimeResolver } from "@hyperframes/core/runtime/start-resolver";
 import { groupInfoFor } from "./timelineGroupInfo";
@@ -167,6 +168,8 @@ export function createTimelineElementFromManifestClip(params: {
       if (info.fxChain) entry.audioGroupFxChain = info.fxChain;
       if (info.automation) entry.audioGroupAutomation = info.automation;
     }
+    const masterChain = readMasterFxChain(doc ?? hostEl.ownerDocument);
+    if (masterChain) entry.masterChain = masterChain;
     const fxChain = hostEl.getAttribute("data-fx-chain");
     if (fxChain) entry.fxChain = fxChain;
     const automation = hostEl.getAttribute("data-automation");
@@ -330,6 +333,8 @@ export function parseTimelineFromDOM(
     // Read from the element, like the manifest path does: without these an audio
     // clip parsed straight from the DOM reserved no automation height and drew no
     // lanes, while the property panel still showed its chain.
+    const domMasterChain = readMasterFxChain(doc);
+    if (domMasterChain) entry.masterChain = domMasterChain;
     const domFxChain = el.getAttribute("data-fx-chain");
     if (domFxChain) entry.fxChain = domFxChain;
     const domAutomation = el.getAttribute("data-automation");

package/src/player/store/timelineElement.ts

@@ -62,9 +62,10 @@ export interface TimelineElement {
   /** Clip-edge fades from `data-fade-in` / `data-fade-out`, seconds; absent means none. */
   fadeIn?: number;
   fadeOut?: number;
-  /** Verbatim `data-fx-chain` / `data-automation`; see automationLaneData. */
+  /** Verbatim `data-fx-chain` / `data-automation` (`masterChain`: the root's); see automationLaneData. */
   fxChain?: string;
   automation?: string;
+  masterChain?: string;
   /** Path from data-composition-src — identifies sub-composition elements */
   compositionSrc?: string;
   /** Set by data-timeline-locked on the host element — disables move and trim in Studio. */

package/src/utils/audioMeterMath.test.ts

@@ -69,6 +69,15 @@ describe("hasProjectAudio", () => {
     expect(hasProjectAudio([clip({ tag: "video", hasAudio: true, ...fields })])).toBe(true);
   });
 
+  it("counts an audible video when the composition root carries a master chain", () => {
+    const masterChain = '{"version":1,"nodes":[]}';
+    expect(hasProjectAudio([clip({ tag: "video", hasAudio: true, masterChain })])).toBe(true);
+    expect(
+      hasProjectAudio([clip({ tag: "video", muted: true, hasAudio: true, masterChain })]),
+    ).toBe(false);
+    expect(hasProjectAudio([clip({ tag: "video", masterChain })])).toBe(false);
+  });
+
   it("ignores a muted video even when it carries processing", () => {
     expect(hasProjectAudio([clip({ tag: "video", hasAudio: true, muted: true, volume: 2 })])).toBe(
       false,