@hyperframes/studio 0.8.148 → 0.8.150

package/dist/assets/{index-DARhiE_i.js → index-DQ5jGodF.js}

@@ -1,4 +1,4 @@
-import{n as Qi}from"./index-BJIpZeuk.js";/*!
+import{n as Qi}from"./index-CS_m0TkX.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-BJIpZeuk.js"></script>
+    <script type="module" crossorigin src="/assets/index-CS_m0TkX.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-DkQKsFxx.css">
   </head>
   <body>

package/dist/index.js

@@ -29115,6 +29115,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 +29694,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 +29818,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");
@@ -74831,7 +74836,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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.8.148",
+  "version": "0.8.150",
   "description": "",
   "repository": {
     "type": "git",
@@ -60,12 +60,12 @@
     "dockview-react": "8.3.1",
     "gsap": "^3.13.0",
     "mediabunny": "^1.45.3",
-    "@hyperframes/parsers": "0.8.148",
-    "@hyperframes/core": "0.8.148",
-    "@hyperframes/sdk": "0.8.148",
-    "@hyperframes/player": "0.8.148",
-    "@hyperframes/shader-transitions": "0.8.148",
-    "@hyperframes/studio-server": "0.8.148"
+    "@hyperframes/parsers": "0.8.150",
+    "@hyperframes/player": "0.8.150",
+    "@hyperframes/sdk": "0.8.150",
+    "@hyperframes/studio-server": "0.8.150",
+    "@hyperframes/core": "0.8.150",
+    "@hyperframes/shader-transitions": "0.8.150"
   },
   "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.148"
+    "@hyperframes/producer": "0.8.150"
   },
   "peerDependencies": {
     "react": "19",

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,