@hyperframes/studio 0.8.35 → 0.8.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.8.35",
+  "version": "0.8.36",
   "description": "",
   "repository": {
     "type": "git",
@@ -48,11 +48,11 @@
     "gsap": "^3.13.0",
     "marked": "^14.1.4",
     "mediabunny": "^1.45.3",
-    "@hyperframes/core": "0.8.35",
-    "@hyperframes/parsers": "0.8.35",
-    "@hyperframes/player": "0.8.35",
-    "@hyperframes/studio-server": "0.8.35",
-    "@hyperframes/sdk": "0.8.35"
+    "@hyperframes/core": "0.8.36",
+    "@hyperframes/player": "0.8.36",
+    "@hyperframes/parsers": "0.8.36",
+    "@hyperframes/studio-server": "0.8.36",
+    "@hyperframes/sdk": "0.8.36"
   },
   "devDependencies": {
     "@types/react": "19",
@@ -69,7 +69,7 @@
     "vite": "^6.4.2",
     "vitest": "^4.1.11",
     "zustand": "^5.0.0",
-    "@hyperframes/producer": "0.8.35"
+    "@hyperframes/producer": "0.8.36"
   },
   "peerDependencies": {
     "react": "19",

package/src/App.tsx

@@ -104,7 +104,6 @@ export function StudioApp() {
     rightPanelTab: initialUrlStateRef.current.rightPanelTab,
   });
   const editHistory = usePersistentEditHistory({ projectId });
-  const domEditSaveTimestampRef = useRef(0);
   const handleDomZIndexReorderCommitRef = useRef<TimelineZIndexReorderCommit | null>(null);
   const pendingTimelineEditPathRef = useRef(new Set<string>());
   const isGestureRecordingRef = useRef(false);
@@ -113,7 +112,6 @@ export function StudioApp() {
     projectId,
     showToast,
     recordEdit: editHistory.recordEdit,
-    domEditSaveTimestampRef,
     setRefreshKey,
   });
   const masterCompPath = useMemo(
@@ -161,7 +159,6 @@ export function StudioApp() {
     writeProjectFile: fileManager.writeProjectFile,
     observeProjectFileVersion: fileManager.observeProjectFileVersion,
     recordEdit: editHistory.recordEdit,
-    domEditSaveTimestampRef,
     reloadPreview,
     previewIframeRef,
     pendingTimelineEditPathRef,
@@ -224,7 +221,6 @@ export function StudioApp() {
     showToast,
     writeProjectFile: fileManager.writeProjectFile,
     recordEdit: editHistory.recordEdit,
-    domEditSaveTimestampRef,
     reloadPreview,
     handleTimelineElementDelete: timelineEditing.handleTimelineElementDelete,
     handleDomEditElementDelete: domEditDeleteBridge,
@@ -240,7 +236,6 @@ export function StudioApp() {
     readOptionalProjectFile: fileManager.readOptionalProjectFile,
     readProjectFile: fileManager.readProjectFile,
     writeProjectFile: fileManager.writeProjectFile,
-    domEditSaveTimestampRef,
     showToast,
     syncHistoryPreviewAfterApply: previewPersistence.syncHistoryPreviewAfterApply,
     waitForPendingDomEditSaves: previewPersistence.waitForPendingDomEditSaves,
@@ -281,7 +276,6 @@ export function StudioApp() {
     readProjectFile: fileManager.readProjectFile,
     writeProjectFile: fileManager.writeProjectFile,
     updateEditingFileContent: fileManager.updateEditingFileContent,
-    domEditSaveTimestampRef,
     editHistory: { recordEdit: editHistory.recordEdit },
     fileTree: fileManager.fileTree,
     importedFontAssetsRef: fileManager.importedFontAssetsRef,
@@ -526,7 +520,6 @@ export function StudioApp() {
                           publishSdkSession={sdkHandle.publish}
                           forceReloadSdkSession={sdkHandle.forceReload}
                           reloadPreview={reloadPreview}
-                          domEditSaveTimestampRef={domEditSaveTimestampRef}
                           recordEdit={editHistory.recordEdit}
                           onToggleElementHidden={timelineEditing.handleToggleElementHidden}
                           onAutoGroupCarveSources={timelineEditing.handleAutoGroupCarveSources}

package/src/components/StudioRightPanel.tsx

@@ -42,7 +42,6 @@ export function StudioRightPanel({
   publishSdkSession,
   forceReloadSdkSession,
   reloadPreview,
-  domEditSaveTimestampRef,
   recordEdit,
   onToggleElementHidden,
   onAutoGroupCarveSources,
@@ -139,7 +138,6 @@ export function StudioRightPanel({
     writeProjectFile,
     recordEdit,
     reloadPreview,
-    domEditSaveTimestampRef,
     publishSdkSession,
   });
 
@@ -152,7 +150,6 @@ export function StudioRightPanel({
     writeProjectFile,
     recordEdit,
     reloadPreview,
-    domEditSaveTimestampRef,
     publishSdkSession,
     coalesceKey: activeCompPath ? `slideshow-notes:${activeCompPath}` : "slideshow-notes",
   });
@@ -201,7 +198,6 @@ export function StudioRightPanel({
         selectedSourceFile: domEditSelection?.sourceFile || activeCompPath || "index.html",
         fileTree,
         projectId,
-        domEditSaveTimestampRef,
         waitForPendingDomEditSaves,
         readProjectFile,
         writeProjectFile,
@@ -217,7 +213,6 @@ export function StudioRightPanel({
       }),
     [
       activeCompPath,
-      domEditSaveTimestampRef,
       domEditSelection?.sourceFile,
       fileTree,
       projectId,
@@ -272,7 +267,6 @@ export function StudioRightPanel({
       writeProjectFile={writeProjectFile}
       recordEdit={recordEdit}
       reloadPreview={reloadPreview}
-      domEditSaveTimestampRef={domEditSaveTimestampRef}
       forceReloadSharedSdkSession={forceReloadSdkSession}
     >
       <PropertyPanel
@@ -436,7 +430,6 @@ export function StudioRightPanel({
                   sdkSession={sdkSession}
                   publishSdkSession={publishSdkSession}
                   reloadPreview={reloadPreview}
-                  domEditSaveTimestampRef={domEditSaveTimestampRef}
                   recordEdit={recordEdit}
                 />
               ) : layersPaneOpen && designPaneOpen && !STUDIO_FLAT_INSPECTOR_ENABLED ? (

package/src/components/StudioRightPanel.types.ts

@@ -6,7 +6,6 @@
  * component's own diffs small and readable.
  */
 
-import type { MutableRefObject } from "react";
 import type { StudioEditPersistenceProps } from "./panels/VariablesPanel";
 import type { BlockParam } from "@hyperframes/core/registry";
 import type { Composition } from "@hyperframes/sdk";
@@ -44,7 +43,6 @@ export interface StudioRightPanelProps extends StudioEditPersistenceProps {
    */
   forceReloadSdkSession?: () => void;
   reloadPreview: () => void;
-  domEditSaveTimestampRef: MutableRefObject<number>;
   recordEdit: (entry: {
     label: string;
     kind: EditHistoryKind;

package/src/components/editor/SnapToolbar.test.tsx

@@ -30,7 +30,6 @@ function renderToolbar(onSnapChange = vi.fn()) {
 function AppHotkeyHarness() {
   const domEditSelectionRef = useRef<DomEditSelection | null>(null);
   const clearDomSelectionRef = useRef<() => void>(() => undefined);
-  const domEditSaveTimestampRef = useRef(0);
   const leftSidebarRef = useRef<LeftSidebarHandle | null>(null);
 
   useAppHotkeys({
@@ -47,7 +46,6 @@ function AppHotkeyHarness() {
     readOptionalProjectFile: vi.fn(async () => ""),
     readProjectFile: vi.fn(async () => ""),
     writeProjectFile: vi.fn(async () => undefined),
-    domEditSaveTimestampRef,
     showToast: vi.fn(),
     syncHistoryPreviewAfterApply: vi.fn(async () => undefined),
     waitForPendingDomEditSaves: vi.fn(async () => undefined),

package/src/components/editor/manualEdits.test.ts

@@ -62,9 +62,9 @@ describe("studio manual edits", () => {
     expect(readStudioFileChangePath({ path: ".hyperframes/studio-manual-edits.json" })).toBe(
       ".hyperframes/studio-manual-edits.json",
     );
-    expect(readStudioFileChangePath({ data: '{"path":"nested/file.html"}' })).toBe(
-      "nested/file.html",
-    );
+    expect(readStudioFileChangePath({ filePath: "/nested/file.html" })).toBe("nested/file.html");
+    // A still-wrapped delivery is a decoding bug upstream, never a path.
+    expect(readStudioFileChangePath({ data: { path: "nested/file.html" } })).toBeNull();
   });
 
   it("applies offsets through CSS translate longhand", () => {

package/src/components/editor/manualEdits.ts

@@ -9,7 +9,7 @@ export {
   type StudioPathOffsetSnapshot,
 } from "./manualEditsTypes";
 
-export { readStudioFileChangePath } from "./manualEditsParsing";
+export { readFileChangeField, readStudioFileChangePath } from "./manualEditsParsing";
 
 export {
   beginStudioManualEditGesture,

package/src/components/editor/manualEditsParsing.ts

@@ -15,28 +15,19 @@ function normalizeStudioFileChangePath(path: string): string {
     .replace(/^\.?\//, "");
 }
 
-function readStudioFileChangePathFromValue(value: unknown): string | null {
-  if (typeof value === "string") {
-    const trimmed = value.trim();
-    if (!trimmed) return null;
-    if (trimmed.startsWith("{")) {
-      try {
-        return readStudioFileChangePathFromValue(JSON.parse(trimmed) as unknown);
-      } catch {
-        return normalizeStudioFileChangePath(trimmed);
-      }
-    }
-    return normalizeStudioFileChangePath(trimmed);
-  }
-
-  if (!value || typeof value !== "object") return null;
-  const record = value as Record<string, unknown>;
-  if (typeof record.path === "string") return normalizeStudioFileChangePath(record.path);
-  if (typeof record.filePath === "string") return normalizeStudioFileChangePath(record.filePath);
-  if ("data" in record) return readStudioFileChangePathFromValue(record.data);
-  return null;
+/**
+ * Read one string field out of an ALREADY-DECODED file-change payload. Every
+ * reader of that payload goes through here, so no reader can disagree with its
+ * siblings about the shape. Decoding a raw delivery is the transport's job.
+ */
+export function readFileChangeField(payload: unknown, key: string): string | null {
+  if (!payload || typeof payload !== "object") return null;
+  const record = payload as Record<string, unknown>;
+  const value = record[key];
+  return typeof value === "string" ? value : null;
 }
 
 export function readStudioFileChangePath(payload: unknown): string | null {
-  return readStudioFileChangePathFromValue(payload);
+  const path = readFileChangeField(payload, "path") ?? readFileChangeField(payload, "filePath");
+  return path === null ? null : normalizeStudioFileChangePath(path);
 }

package/src/components/panels/VariablesOtherCompositions.tsx

@@ -6,7 +6,7 @@
  * follow-up (values are per-composition-scope), so no preview control is shown.
  */
 
-import { useCallback, useState, type MutableRefObject } from "react";
+import { useCallback, useState } from "react";
 import type { Composition, CompositionVariable } from "@hyperframes/sdk";
 import {
   useEditVariablesInFile,
@@ -92,7 +92,6 @@ export function VariablesOtherCompositions({
   writeProjectFile,
   recordEdit,
   reloadPreview,
-  domEditSaveTimestampRef,
 }: {
   fileTree: string[];
   excludePath: string;
@@ -101,7 +100,6 @@ export function VariablesOtherCompositions({
   writeProjectFile: (path: string, content: string) => Promise<void>;
   recordEdit: RecordEditFn;
   reloadPreview: () => void;
-  domEditSaveTimestampRef: MutableRefObject<number>;
 }) {
   const [selfRefresh, setSelfRefresh] = useState(0);
   const groups = useProjectCompositionVariables(
@@ -115,7 +113,6 @@ export function VariablesOtherCompositions({
     writeProjectFile,
     recordEdit,
     reloadPreview,
-    domEditSaveTimestampRef,
   });
   const [editingKey, setEditingKey] = useState<string | null>(null);
 

package/src/components/panels/VariablesPanel.tsx

@@ -1,4 +1,4 @@
-import { memo, useCallback, useEffect, useMemo, useState, type MutableRefObject } from "react";
+import { memo, useCallback, useEffect, useMemo, useState } from "react";
 import type {
   Composition,
   CompositionVariable,
@@ -35,7 +35,6 @@ export interface StudioEditPersistenceProps {
   sdkSession: Composition | null;
   publishSdkSession: PublishSdkSession;
   reloadPreview: () => void;
-  domEditSaveTimestampRef: MutableRefObject<number>;
   recordEdit: (entry: {
     label: string;
     kind: EditHistoryKind;
@@ -253,7 +252,6 @@ export const VariablesPanel = memo(function VariablesPanel({
   sdkSession,
   publishSdkSession,
   reloadPreview,
-  domEditSaveTimestampRef,
   recordEdit,
 }: VariablesPanelProps) {
   const { activeCompPath, showToast } = useStudioShellContext();
@@ -289,7 +287,6 @@ export const VariablesPanel = memo(function VariablesPanel({
     writeProjectFile,
     recordEdit,
     reloadPreview,
-    domEditSaveTimestampRef,
     publishSdkSession,
   });
 
@@ -552,7 +549,6 @@ export const VariablesPanel = memo(function VariablesPanel({
           writeProjectFile={writeProjectFile}
           recordEdit={recordEdit}
           reloadPreview={reloadPreview}
-          domEditSaveTimestampRef={domEditSaveTimestampRef}
         />
       </div>
     </div>

package/src/components/studioColorGradingScope.ts

@@ -1,4 +1,3 @@
-import type { MutableRefObject } from "react";
 import type { EditHistoryKind } from "../utils/editHistory";
 import { saveProjectFilesWithHistory } from "../utils/studioFileHistory";
 import { patchMediaColorGradingInHtml } from "./editor/colorGradingScopePatch";
@@ -27,7 +26,6 @@ interface ApplyColorGradingScopeOptions {
   selectedSourceFile: string;
   fileTree: string[];
   projectId: string;
-  domEditSaveTimestampRef: MutableRefObject<number>;
   waitForPendingDomEditSaves: () => Promise<void>;
   readProjectFile: ProjectFileReader;
   writeProjectFile: ProjectFileWriter;
@@ -78,7 +76,6 @@ export async function applyColorGradingScopeUpdate({
   selectedSourceFile,
   fileTree,
   projectId,
-  domEditSaveTimestampRef,
   waitForPendingDomEditSaves,
   readProjectFile,
   writeProjectFile,
@@ -105,7 +102,6 @@ export async function applyColorGradingScopeUpdate({
     return EMPTY_COLOR_GRADING_SCOPE_RESULT;
   }
 
-  domEditSaveTimestampRef.current = Date.now();
   const changedPaths = await saveProjectFilesWithHistory({
     projectId,
     label: value ? "Apply color grading" : "Clear color grading",

package/src/hooks/elementLifecycleOpsTestUtils.ts

@@ -15,7 +15,6 @@ export function makeLifecycleOpsParams(
     activeCompPath: "index.html",
     showToast: vi.fn(),
     writeProjectFile: vi.fn(async () => {}),
-    domEditSaveTimestampRef: { current: 0 },
     editHistory: { recordEdit: vi.fn(async () => {}) },
     projectIdRef: { current: null },
     reloadPreview: vi.fn(),

package/src/hooks/externalFileChangeOwnership.test.ts

@@ -1,5 +1,6 @@
 import { readFileSync } from "node:fs";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it, vi } from "vitest";
+import { sseFileChangeChannel } from "./useExternalFileChangeCoordinator";
 
 describe("external file-change subscription ownership", () => {
   it("has one subscriber instead of independent Preview and SDK listeners", () => {
@@ -14,4 +15,42 @@ describe("external file-change subscription ownership", () => {
     expect(sdk).not.toContain('hot.on("hf:file-change"');
     expect(coordinator.match(/hot\.on\("hf:file-change"/g)).toHaveLength(1);
   });
+
+  it("selects the SSE channel for production and hands it the shared handler", () => {
+    const coordinator = readFileSync(
+      new URL("./useExternalFileChangeCoordinator.ts", import.meta.url),
+      "utf8",
+    );
+    // vitest defines `import.meta.hot`, so the selection is the one claim left to
+    // the source; the channel's own behaviour is exercised below.
+    expect(coordinator.match(/sseFileChangeChannel\(handler\)/g)).toHaveLength(1);
+  });
+
+  it("delivers the raw file-change event from EventSource to the handler and closes on cleanup", () => {
+    const listeners = new Map<string, (event: unknown) => void>();
+    const close = vi.fn();
+    const opened: string[] = [];
+    class FakeEventSource {
+      constructor(url: string) {
+        opened.push(url);
+      }
+      addEventListener(type: string, listener: (event: unknown) => void) {
+        listeners.set(type, listener);
+      }
+      close = close;
+    }
+    vi.stubGlobal("EventSource", FakeEventSource);
+    try {
+      const onDelivery = vi.fn();
+      const stop = sseFileChangeChannel(onDelivery);
+      const event = new MessageEvent("file-change", { data: JSON.stringify({ path: "a.html" }) });
+      listeners.get("file-change")?.(event);
+      expect(opened).toEqual(["/api/events"]);
+      expect(onDelivery).toHaveBeenCalledWith(event);
+      stop();
+      expect(close).toHaveBeenCalledTimes(1);
+    } finally {
+      vi.unstubAllGlobals();
+    }
+  });
 });

package/src/hooks/gsapScriptCommitTypes.ts

@@ -102,7 +102,6 @@ export interface GsapScriptCommitsParams {
       files: Record<string, { before: string; after: string }>;
     }) => Promise<void>;
   };
-  domEditSaveTimestampRef: React.MutableRefObject<number>;
   reloadPreview: () => void;
   onCacheInvalidate: () => void;
   onFileContentChanged?: (path: string, content: string) => void;

package/src/hooks/sdkSelfWriteRegistry.ts

@@ -3,7 +3,7 @@
  * external write (notably undo/redo) in the file-change reload-suppression path.
  *
  * The old suppression was purely time-based: any file-change within 2 s of the
- * shared `domEditSaveTimestampRef` was swallowed. But BOTH an SDK cutover
+ * shared save timestamp was swallowed. But BOTH an SDK cutover
  * self-write AND an undo write set that same timestamp, so the window could not
  * tell "the echo of the bytes I just wrote" (suppress) from "the reverted bytes
  * an undo just wrote" (must reload). An undo that landed inside the window was

package/src/hooks/timelineAudioGroupCreate.ts

@@ -143,7 +143,6 @@ interface CreateAudioGroupAndAssignMembersInput {
   previewIframe: HTMLIFrameElement | null;
   writeProjectFile: (path: string, content: string) => Promise<void>;
   recordEdit: (input: RecordEditInput) => Promise<void>;
-  domEditSaveTimestampRef: MutableRef<number>;
   pendingTimelineEditPathRef: MutableRef<Set<string>>;
 }
 
@@ -164,7 +163,6 @@ export async function createAudioGroupAndAssignMembers({
   previewIframe,
   writeProjectFile,
   recordEdit,
-  domEditSaveTimestampRef,
   pendingTimelineEditPathRef,
 }: CreateAudioGroupAndAssignMembersInput): Promise<string[]> {
   // Throws rather than returning empty: the carve's auto-group awaits this and
@@ -222,7 +220,6 @@ export async function createAudioGroupAndAssignMembers({
       pendingTimelineEditPathRef.current.add(groupPath);
     }
 
-    domEditSaveTimestampRef.current = Date.now();
     const changedPaths = await saveProjectFilesWithHistory({
       projectId,
       label: groupLabel
@@ -238,7 +235,6 @@ export async function createAudioGroupAndAssignMembers({
       writeFile: writeProjectFile,
       recordEdit,
     });
-    domEditSaveTimestampRef.current = Date.now();
     for (const element of elements) {
       usePlayerStore.getState().updateElement(element.key ?? element.id, { audioGroup: groupId });
     }
@@ -268,7 +264,6 @@ export function useAudioGroupCarveAssignment({
   showToast,
   writeProjectFile,
   recordEdit,
-  domEditSaveTimestampRef,
   previewIframeRef,
   pendingTimelineEditPathRef,
   isRecordingRef,
@@ -314,7 +309,6 @@ export function useAudioGroupCarveAssignment({
           previewIframe: previewIframeRef.current,
           writeProjectFile,
           recordEdit,
-          domEditSaveTimestampRef,
           pendingTimelineEditPathRef,
         });
       } catch (error) {
@@ -335,7 +329,6 @@ export function useAudioGroupCarveAssignment({
       previewIframeRef,
       writeProjectFile,
       recordEdit,
-      domEditSaveTimestampRef,
       pendingTimelineEditPathRef,
       isRecordingRef,
       showToast,

package/src/hooks/timelineAudioGroupVolume.test.ts

@@ -45,7 +45,6 @@ function makeSetter() {
     showToast: () => {},
     writeProjectFile: async () => {},
     recordEdit: async () => {},
-    domEditSaveTimestampRef: { current: 0 },
     pendingTimelineEditPathRef: { current: new Set<string>() },
     previewIframeRef: { current: null },
   };

package/src/hooks/timelineAudioGroupVolume.ts

@@ -143,7 +143,6 @@ interface SetAudioGroupAttributeInput {
   previewIframe: HTMLIFrameElement | null;
   writeProjectFile: (path: string, content: string) => Promise<void>;
   recordEdit: (input: RecordEditInput) => Promise<void>;
-  domEditSaveTimestampRef: MutableRef<number>;
   pendingTimelineEditPathRef: MutableRef<Set<string>>;
 }
 
@@ -163,7 +162,6 @@ async function setAudioGroupAttribute({
   previewIframe,
   writeProjectFile,
   recordEdit,
-  domEditSaveTimestampRef,
   pendingTimelineEditPathRef,
 }: SetAudioGroupAttributeInput): Promise<string[]> {
   // The file that actually CONTAINS the group element, not just the active
@@ -188,7 +186,6 @@ async function setAudioGroupAttribute({
     label,
     writeProjectFile,
     recordEdit,
-    domEditSaveTimestampRef,
     pendingTimelineEditPathRef,
     patchLive: (v) => patchLiveGroupAttribute(previewIframe, groupId, attr, v),
   });
@@ -207,7 +204,6 @@ export function useSetAudioGroupAttribute({
   showToast,
   writeProjectFile,
   recordEdit,
-  domEditSaveTimestampRef,
   previewIframeRef,
   pendingTimelineEditPathRef,
   isRecordingRef,
@@ -244,7 +240,6 @@ export function useSetAudioGroupAttribute({
           previewIframe: previewIframeRef.current,
           writeProjectFile,
           recordEdit,
-          domEditSaveTimestampRef,
           pendingTimelineEditPathRef,
         });
         syncStoredGroupAttribute(groupId, attr, value);
@@ -269,7 +264,6 @@ export function useSetAudioGroupAttribute({
       previewIframeRef,
       writeProjectFile,
       recordEdit,
-      domEditSaveTimestampRef,
       pendingTimelineEditPathRef,
       isRecordingRef,
       showToast,

package/src/hooks/timelineEditingHelpers.test.ts

@@ -243,7 +243,6 @@ describe("persistTimelineBatchEdit", () => {
         writes.push([path, content]);
       },
       recordEdit: async () => {},
-      domEditSaveTimestampRef: { current: 0 },
       pendingTimelineEditPathRef: { current: new Set<string>() },
     };
   }
@@ -452,7 +451,6 @@ describe("persistElementAttribute", () => {
         label: "Set volume",
         writeProjectFile,
         recordEdit: vi.fn(),
-        domEditSaveTimestampRef: { current: 0 },
         pendingTimelineEditPathRef: { current: new Set() },
         patchLive,
       }),
@@ -496,7 +494,6 @@ describe("persistElementAttribute — unwind value", () => {
         label: "Set volume",
         writeProjectFile,
         recordEdit: vi.fn(),
-        domEditSaveTimestampRef: { current: 0 },
         pendingTimelineEditPathRef: { current: new Set() },
         // The live DOM is ALREADY at the new value when the commit runs — that
         // is what `setLive` does on every drag frame.

package/src/hooks/timelineEditingHelpers.ts

@@ -285,7 +285,6 @@ export interface PersistTimelineEditInput {
   buildPatches: (original: string, target: PatchTarget) => string;
   writeProjectFile: (path: string, content: string, expectedContent?: string) => Promise<void>;
   recordEdit: (input: RecordEditInput) => Promise<void>;
-  domEditSaveTimestampRef: React.MutableRefObject<number>;
   pendingTimelineEditPathRef: React.MutableRefObject<Set<string>>;
   coalesceKey?: string;
 }
@@ -305,7 +304,6 @@ export async function persistTimelineEdit(input: PersistTimelineEditInput): Prom
   }
 
   input.pendingTimelineEditPathRef.current.add(targetPath);
-  input.domEditSaveTimestampRef.current = Date.now();
   await saveProjectFilesWithHistory({
     projectId: input.projectId,
     label: input.label,
@@ -316,7 +314,6 @@ export async function persistTimelineEdit(input: PersistTimelineEditInput): Prom
     writeFile: input.writeProjectFile,
     recordEdit: input.recordEdit,
   });
-  input.domEditSaveTimestampRef.current = Date.now();
 }
 
 export interface PersistTimelineBatchChange {
@@ -331,7 +328,6 @@ export interface PersistTimelineBatchEditInput {
   changes: PersistTimelineBatchChange[];
   writeProjectFile: (path: string, content: string, expectedContent?: string) => Promise<void>;
   recordEdit: (input: RecordEditInput) => Promise<void>;
-  domEditSaveTimestampRef: React.MutableRefObject<number>;
   pendingTimelineEditPathRef: React.MutableRefObject<Set<string>>;
   coalesceKey?: string;
   /** Per-entry undo coalesce window override (ms) — see EditHistoryEntry.coalesceMs. */
@@ -378,7 +374,6 @@ export async function persistTimelineBatchEdit(
   for (const targetPath of Object.keys(files)) {
     input.pendingTimelineEditPathRef.current.add(targetPath);
   }
-  input.domEditSaveTimestampRef.current = Date.now();
   await saveProjectFilesWithHistory({
     projectId: input.projectId,
     label: input.label,
@@ -390,7 +385,6 @@ export async function persistTimelineBatchEdit(
     writeFile: input.writeProjectFile,
     recordEdit: input.recordEdit,
   });
-  input.domEditSaveTimestampRef.current = Date.now();
 }
 
 export { applyPatchByTarget, formatTimelineAttributeNumber };
@@ -406,7 +400,6 @@ export interface PersistElementAttributeInput {
   label: string;
   writeProjectFile: (path: string, content: string) => Promise<void>;
   recordEdit: (input: RecordEditInput) => Promise<void>;
-  domEditSaveTimestampRef: { current: number };
   pendingTimelineEditPathRef: { current: Set<string> };
   /** Write the attribute directly on the live preview DOM node. */
   patchLive: (value: string | null) => void;
@@ -429,7 +422,6 @@ export async function persistElementAttribute({
   label,
   writeProjectFile,
   recordEdit,
-  domEditSaveTimestampRef,
   pendingTimelineEditPathRef,
   patchLive,
 }: PersistElementAttributeInput): Promise<string[]> {
@@ -459,7 +451,6 @@ export async function persistElementAttribute({
   const patched = applyPatchByTarget(before, patchTarget, operation);
 
   pendingTimelineEditPathRef.current.add(targetPath);
-  domEditSaveTimestampRef.current = Date.now();
   try {
     const changedPaths = await saveProjectFilesWithHistory({
       projectId,
@@ -470,7 +461,6 @@ export async function persistElementAttribute({
       writeFile: writeProjectFile,
       recordEdit,
     });
-    domEditSaveTimestampRef.current = Date.now();
     return changedPaths;
   } catch (error) {
     // The optimistic live write already ran; unwind it on a save failure so