npm - @hyperframes/studio - Versions diffs - 0.7.57 → 0.7.59 - Mend

@hyperframes/studio 0.7.57 → 0.7.59

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (247) hide show

package/dist/assets/{hyperframes-player--Z69cEkE.js → hyperframes-player-Bm07FLkl.js} +1 -1
package/dist/assets/{index-KsfE1bUu.js → index-B995FG46.js} +1 -1
package/dist/assets/index-CrkAdJkb.js +426 -0
package/dist/assets/index-Dj5p8U_A.css +1 -0
package/dist/assets/{index-Bf1x1y8H.js → index-FvzmPhfG.js} +1 -1
package/dist/{chunk-5QSIMBEJ.js → chunk-OBAG3GWK.js} +33 -21
package/dist/chunk-OBAG3GWK.js.map +1 -0
package/dist/{domEditingLayers-6LQGKPOI.js → domEditingLayers-2CKWGEHS.js} +2 -2
package/dist/index.d.ts +27 -7
package/dist/index.html +2 -2
package/dist/index.js +18029 -11563
package/dist/index.js.map +1 -1
package/dist/styles/tailwind-preset.d.ts +5 -0
package/dist/styles/tailwind-preset.js +8 -1
package/dist/styles/tailwind-preset.js.map +1 -1
package/package.json +7 -7
package/src/App.tsx +6 -6
package/src/components/DesignPanelPromoteProvider.tsx +15 -2
package/src/components/StudioFeedbackBar.tsx +2 -2
package/src/components/StudioRightPanel.tsx +29 -51
package/src/components/editor/AnimationCard.test.tsx +134 -0
package/src/components/editor/AnimationCard.tsx +19 -4
package/src/components/editor/ArcPathControls.tsx +1 -0
package/src/components/editor/CanvasContextMenu.test.tsx +27 -14
package/src/components/editor/CanvasContextMenu.tsx +71 -6
package/src/components/editor/DomEditOverlay.tsx +5 -2
package/src/components/editor/GestureRecordControl.tsx +7 -1
package/src/components/editor/GsapAnimationSection.tsx +109 -14
package/src/components/editor/InspectorHeaderActions.tsx +42 -4
package/src/components/editor/LayersPanel.tsx +110 -99
package/src/components/editor/PropertyPanel.test.tsx +948 -0
package/src/components/editor/PropertyPanel.tsx +144 -148
package/src/components/editor/PropertyPanelEmptyState.test.tsx +74 -0
package/src/components/editor/PropertyPanelEmptyState.tsx +179 -1
package/src/components/editor/PropertyPanelFlat.tsx +580 -0
package/src/components/editor/PropertyPanelFlatFooter.test.tsx +83 -0
package/src/components/editor/PropertyPanelFlatFooter.tsx +73 -0
package/src/components/editor/PropertyPanelFlatHeader.test.tsx +79 -0
package/src/components/editor/PropertyPanelFlatHeader.tsx +112 -0
package/src/components/editor/canvasContextMenuZOrder.test.ts +57 -0
package/src/components/editor/canvasContextMenuZOrder.ts +40 -1
package/src/components/editor/domEditingDom.ts +5 -6
package/src/components/editor/domEditingElement.ts +15 -32
package/src/components/editor/gsapAnimationCallbacks.ts +27 -0
package/src/components/editor/gsapLivePreview.ts +34 -0
package/src/components/editor/layersPanelSort.ts +80 -0
package/src/components/editor/manualEditingAvailability.test.ts +10 -0
package/src/components/editor/manualEditingAvailability.ts +9 -0
package/src/components/editor/propertyPanel3dTransform.tsx +5 -0
package/src/components/editor/propertyPanelColor.test.tsx +28 -0
package/src/components/editor/propertyPanelColor.tsx +31 -1
package/src/components/editor/propertyPanelColorGradingControls.tsx +11 -2
package/src/components/editor/propertyPanelColorGradingSection.tsx +45 -365
package/src/components/editor/propertyPanelColorGradingSlider.tsx +19 -5
package/src/components/editor/propertyPanelFill.tsx +22 -5
package/src/components/editor/propertyPanelFlatColorGradingSection.test.tsx +622 -0
package/src/components/editor/propertyPanelFlatColorGradingSection.tsx +570 -0
package/src/components/editor/propertyPanelFlatLayoutSection.test.tsx +293 -0
package/src/components/editor/propertyPanelFlatLayoutSection.tsx +383 -0
package/src/components/editor/propertyPanelFlatMaskInsetRows.tsx +102 -0
package/src/components/editor/propertyPanelFlatMediaSection.test.tsx +436 -0
package/src/components/editor/propertyPanelFlatMediaSection.tsx +286 -0
package/src/components/editor/propertyPanelFlatMotionSection.test.tsx +272 -0
package/src/components/editor/propertyPanelFlatMotionSection.tsx +315 -0
package/src/components/editor/propertyPanelFlatPrimitives.test.tsx +1174 -0
package/src/components/editor/propertyPanelFlatPrimitives.tsx +563 -0
package/src/components/editor/propertyPanelFlatSelectRow.tsx +101 -0
package/src/components/editor/propertyPanelFlatStyleHelpers.test.ts +23 -0
package/src/components/editor/propertyPanelFlatStyleHelpers.ts +27 -0
package/src/components/editor/propertyPanelFlatStyleSections.test.tsx +598 -0
package/src/components/editor/propertyPanelFlatStyleSections.tsx +516 -0
package/src/components/editor/propertyPanelFlatTextSection.test.tsx +465 -0
package/src/components/editor/propertyPanelFlatTextSection.tsx +407 -0
package/src/components/editor/propertyPanelFlatTimingDerivation.test.ts +71 -0
package/src/components/editor/propertyPanelFlatTimingDerivation.ts +59 -0
package/src/components/editor/propertyPanelFlatToggle.test.tsx +63 -0
package/src/components/editor/propertyPanelFlatToggle.tsx +53 -0
package/src/components/editor/propertyPanelFont.test.tsx +30 -0
package/src/components/editor/propertyPanelFont.tsx +136 -95
package/src/components/editor/propertyPanelHelpers.ts +73 -0
package/src/components/editor/propertyPanelInputCoverage.test.tsx +587 -0
package/src/components/editor/propertyPanelMediaSection.tsx +10 -0
package/src/components/editor/propertyPanelPrimitives.tsx +60 -29
package/src/components/editor/propertyPanelSections.test.tsx +161 -0
package/src/components/editor/propertyPanelSections.tsx +154 -90
package/src/components/editor/propertyPanelStyleSections.tsx +12 -1
package/src/components/editor/propertyPanelTimingSection.tsx +1 -1
package/src/components/editor/propertyPanelTypes.ts +14 -1
package/src/components/editor/propertyPanelValueTier.test.ts +32 -0
package/src/components/editor/propertyPanelValueTier.ts +28 -0
package/src/components/editor/useColorGradingController.test.ts +418 -0
package/src/components/editor/useColorGradingController.ts +596 -0
package/src/components/editor/useLayerRevealOverride.test.ts +169 -0
package/src/components/editor/useLayerRevealOverride.ts +389 -0
package/src/components/nle/PreviewOverlays.tsx +27 -2
package/src/components/nle/TimelinePane.test.ts +3 -0
package/src/components/nle/TimelinePane.tsx +11 -1
package/src/components/nle/useCanvasZOrderTimelineMirror.test.tsx +440 -0
package/src/components/nle/useCanvasZOrderTimelineMirror.ts +191 -0
package/src/components/nle/useTimelineEditCallbacks.ts +1 -0
package/src/components/nle/zLaneGesture.test.ts +176 -0
package/src/components/nle/zLaneGesture.ts +77 -0
package/src/components/panels/VariablesPanel.tsx +4 -0
package/src/components/sidebar/CompositionsTab.test.ts +28 -2
package/src/components/sidebar/CompositionsTab.tsx +3 -1
package/src/components/storyboard/FramePoster.tsx +24 -4
package/src/components/storyboard/StoryboardFrameFocus.tsx +4 -0
package/src/components/storyboard/StoryboardFrameTile.tsx +30 -1
package/src/components/storyboard/StoryboardGrid.tsx +23 -1
package/src/components/storyboard/StoryboardLoaded.tsx +58 -2
package/src/components/storyboard/StoryboardView.tsx +9 -2
package/src/components/storyboard/frameComments.test.ts +95 -0
package/src/components/storyboard/frameComments.ts +115 -0
package/src/components/storyboard/useFrameComments.ts +82 -0
package/src/contexts/DesignPanelInputContext.test.tsx +81 -0
package/src/contexts/DesignPanelInputContext.tsx +48 -0
package/src/contexts/DomEditContext.tsx +4 -0
package/src/contexts/VariablePromoteContext.test.tsx +67 -0
package/src/contexts/VariablePromoteContext.tsx +10 -5
package/src/hooks/domEditCommitRunner.ts +11 -0
package/src/hooks/domEditCommitTypes.ts +17 -1
package/src/hooks/elementLifecycleOpsTestUtils.ts +25 -0
package/src/hooks/fetchStubTestUtils.ts +16 -0
package/src/hooks/gsapScriptCommitTypes.ts +6 -4
package/src/hooks/timelineEditingHelpers.test.ts +92 -1
package/src/hooks/timelineEditingHelpers.ts +32 -15
package/src/hooks/timelineMoveAdapter.ts +2 -1
package/src/hooks/timelineTimingSync.test.ts +703 -33
package/src/hooks/timelineTimingSync.ts +282 -97
package/src/hooks/timelineTrackVisibility.test.ts +55 -1
package/src/hooks/timelineTrackVisibility.ts +31 -13
package/src/hooks/useAppHotkeys.ts +9 -0
package/src/hooks/useClipboard.ts +19 -17
package/src/hooks/useDomEditAttributeCommits.ts +123 -1
package/src/hooks/useDomEditCommits.test.tsx +316 -38
package/src/hooks/useDomEditCommits.ts +81 -162
package/src/hooks/useDomEditCommitsHelpers.ts +158 -0
package/src/hooks/useDomEditSession.test.tsx +3 -1
package/src/hooks/useDomEditSession.ts +18 -6
package/src/hooks/useDomEditTextCommits.ts +14 -9
package/src/hooks/useDomEditWiring.ts +10 -9
package/src/hooks/useElementLifecycleOps.test.tsx +426 -60
package/src/hooks/useElementLifecycleOps.ts +182 -84
package/src/hooks/useFileManager.projectOwnership.test.tsx +98 -0
package/src/hooks/useFileManager.ts +82 -60
package/src/hooks/useGsapAnimationOps.ts +7 -6
package/src/hooks/useGsapKeyframeOps.ts +6 -5
package/src/hooks/useGsapPropertyDebounce.ts +43 -28
package/src/hooks/useGsapPropertyDebounceFlush.test.ts +35 -0
package/src/hooks/useGsapScriptCommits.test.tsx +48 -2
package/src/hooks/useGsapScriptCommits.ts +150 -50
package/src/hooks/useGsapSelectionHandlers.test.tsx +116 -0
package/src/hooks/useGsapSelectionHandlers.ts +94 -31
package/src/hooks/useInspectorSplitResize.ts +51 -0
package/src/hooks/usePersistentEditHistory.projectOwnership.test.tsx +60 -0
package/src/hooks/usePersistentEditHistory.test.ts +49 -1
package/src/hooks/usePersistentEditHistory.ts +71 -31
package/src/hooks/usePreviewPersistence.ts +2 -2
package/src/hooks/useProjectCompositionVariables.ts +10 -10
package/src/hooks/useProjectSignaturePoll.test.tsx +135 -0
package/src/hooks/useProjectSignaturePoll.ts +68 -0
package/src/hooks/useSdkSession.lifecycle.test.tsx +137 -0
package/src/hooks/useSdkSession.ts +155 -14
package/src/hooks/useSlideshowPersist.ts +7 -1
package/src/hooks/useStoryboard.ts +23 -4
package/src/hooks/useTimelineEditing.test.tsx +306 -155
package/src/hooks/useTimelineEditing.ts +111 -101
package/src/hooks/useTimelineEditingTypes.ts +4 -1
package/src/hooks/useTimelineGroupEditing.ts +51 -5
package/src/hooks/useVariablesPersist.ts +9 -7
package/src/icons/SystemIcons.tsx +2 -0
package/src/player/components/Timeline.test.ts +31 -21
package/src/player/components/Timeline.tsx +62 -91
package/src/player/components/TimelineCanvas.tsx +36 -5
package/src/player/components/TimelineLanes.tsx +32 -10
package/src/player/components/TimelineOverlays.tsx +36 -0
package/src/player/components/TimelineRuler.tsx +18 -5
package/src/player/components/TrackGapContextMenu.tsx +116 -0
package/src/player/components/timelineCallbacks.ts +4 -1
package/src/player/components/timelineClipDragCommit.test.ts +279 -3
package/src/player/components/timelineClipDragCommit.ts +173 -71
package/src/player/components/timelineGapCommit.test.ts +163 -0
package/src/player/components/timelineGapCommit.ts +103 -0
package/src/player/components/timelineGaps.test.ts +221 -0
package/src/player/components/timelineGaps.ts +182 -0
package/src/player/components/timelineLayout.test.ts +2 -1
package/src/player/components/timelineLayout.ts +22 -6
package/src/player/components/timelineMarquee.test.ts +20 -10
package/src/player/components/timelineMarquee.ts +9 -2
package/src/player/components/timelineStackingSync.test.ts +42 -1
package/src/player/components/timelineStackingSync.ts +31 -16
package/src/player/components/timelineZMirror.test.ts +667 -0
package/src/player/components/timelineZMirror.ts +393 -0
package/src/player/components/timelineZoom.test.ts +2 -2
package/src/player/components/timelineZoom.ts +7 -3
package/src/player/components/useTimelineClipDrag.ts +1 -1
package/src/player/components/useTimelineGapHighlights.test.ts +119 -0
package/src/player/components/useTimelineGapHighlights.ts +110 -0
package/src/player/components/useTimelinePlayhead.ts +4 -3
package/src/player/components/useTimelineRangeSelection.ts +6 -4
package/src/player/components/useTimelineScrollViewport.ts +73 -0
package/src/player/components/useTimelineStackingSync.test.tsx +0 -1
package/src/player/components/useTimelineStackingSync.ts +5 -3
package/src/player/components/useTimelineTrackDerivations.ts +38 -0
package/src/player/components/useTrackGapMenu.ts +155 -0
package/src/player/hooks/useExpandedTimelineElements.test.ts +67 -4
package/src/player/hooks/useExpandedTimelineElements.ts +12 -1
package/src/player/hooks/useTimelineSyncCallbacks.ts +2 -0
package/src/player/lib/layerOrdering.test.ts +1 -15
package/src/player/lib/layerOrdering.ts +5 -28
package/src/player/lib/timelineDOM.test.ts +72 -0
package/src/player/lib/timelineDOM.ts +3 -0
package/src/player/lib/timelineElementHelpers.ts +35 -11
package/src/player/store/playerStore.ts +12 -1
package/src/styles/studio.css +22 -0
package/src/styles/tailwind-preset.shared.js +7 -0
package/src/telemetry/events.test.ts +10 -0
package/src/telemetry/events.ts +1 -0
package/src/utils/designInputTracking.test.ts +97 -0
package/src/utils/designInputTracking.ts +80 -0
package/src/utils/domEditSaveQueue.ts +4 -3
package/src/utils/editHistory.test.ts +82 -0
package/src/utils/editHistory.ts +14 -2
package/src/utils/gsapSoftReload.test.ts +54 -115
package/src/utils/gsapSoftReload.ts +42 -152
package/src/utils/gsapUndoRestore.test.ts +269 -0
package/src/utils/gsapUndoRestore.ts +269 -0
package/src/utils/sdkCutover.gate.test.ts +7 -7
package/src/utils/sdkCutover.test.ts +490 -57
package/src/utils/sdkCutover.ts +181 -219
package/src/utils/sdkEditTransaction.ts +292 -0
package/src/utils/sdkResolverAttempts.ts +94 -0
package/src/utils/sdkResolverShadow.test.ts +148 -0
package/src/utils/sdkResolverShadow.ts +139 -106
package/src/utils/setSlideshowManifest.test.ts +0 -9
package/src/utils/setSlideshowManifest.ts +20 -27
package/src/utils/sourceScopedSelectorIndex.ts +29 -0
package/src/utils/studioFileHistory.test.ts +41 -0
package/src/utils/studioFileHistory.ts +30 -27
package/src/utils/studioFileMutationCoordinator.ts +45 -0
package/src/utils/studioHelpers.test.ts +45 -0
package/src/utils/studioHelpers.ts +45 -14
package/src/utils/studioSaveDiagnostics.ts +17 -0
package/dist/assets/index-DfmYkU44.js +0 -423
package/dist/assets/index-_pqzyxB1.css +0 -1
package/dist/chunk-5QSIMBEJ.js.map +0 -1
/package/dist/{domEditingLayers-6LQGKPOI.js.map → domEditingLayers-2CKWGEHS.js.map} +0 -0

package/src/utils/gsapSoftReload.test.ts CHANGED Viewed

@@ -3,9 +3,8 @@
 import { describe, it, expect, vi } from "vitest";
 import {
   applySoftReload,
+  applySoftReloadFinalization,
   ensureMotionPathPluginLoaded,
-  diffSoftReloadableRestore,
-  applyUndoRestoreToPreview,
 } from "./gsapSoftReload";
 const SCRIPT_TEXT = `
@@ -66,6 +65,7 @@ function buildMockIframe(overrides: Record<string, unknown> = {}) {
     iframe: { contentWindow, contentDocument } as unknown as HTMLIFrameElement,
     contentWindow,
     mockTimeline,
+    container,
   };
 }
@@ -288,6 +288,58 @@ describe("applySoftReload", () => {
   });
 });
+// ── Finalization-only path: seek → rebind → manual edits, with NO script
+// execution — the flashless sync for timing edits that changed no script.
+describe("applySoftReloadFinalization", () => {
+  it("seeks, rebinds, and reapplies manual edits without touching any script", () => {
+    const { iframe, contentWindow, container, mockTimeline } = buildMockIframe();
+    const scriptsBefore = container.querySelectorAll("script").length;
+    expect(applySoftReloadFinalization(iframe, 2.0)).toBe(true);
+    expect(contentWindow.__player.seek).toHaveBeenCalledWith(2.0);
+    expect(contentWindow.__hfForceTimelineRebind).toHaveBeenCalledTimes(1);
+    expect(contentWindow.__hfStudioManualEditsApply).toHaveBeenCalledTimes(1);
+    // No script executed or removed; the live timeline was never killed.
+    expect(container.querySelectorAll("script").length).toBe(scriptsBefore);
+    expect(mockTimeline.kill).not.toHaveBeenCalled();
+    expect(contentWindow.__timelines.root).toBe(mockTimeline);
+  });
+  it("runs inside __hfSuppressSceneMutations when the runtime provides it", () => {
+    const suppress = vi.fn(<T>(fn: () => T): T => fn());
+    const { iframe, contentWindow } = buildMockIframe({
+      __hfSuppressSceneMutations: suppress,
+    });
+    expect(applySoftReloadFinalization(iframe, 1.5)).toBe(true);
+    expect(suppress).toHaveBeenCalledTimes(1);
+    expect(contentWindow.__hfForceTimelineRebind).toHaveBeenCalledTimes(1);
+  });
+  it("does NOT require gsap — a script-less runtime with the rebind hook works", () => {
+    const { iframe, contentWindow } = buildMockIframe({ gsap: undefined });
+    expect(applySoftReloadFinalization(iframe, 0)).toBe(true);
+    expect(contentWindow.__hfForceTimelineRebind).toHaveBeenCalledTimes(1);
+  });
+  it("returns false when the iframe or the rebind hook is unavailable", () => {
+    expect(applySoftReloadFinalization(null, 0)).toBe(false);
+    const { iframe } = buildMockIframe({ __hfForceTimelineRebind: undefined });
+    expect(applySoftReloadFinalization(iframe, 0)).toBe(false);
+  });
+  it("returns false when the rebind throws (caller full-reloads)", () => {
+    const { iframe } = buildMockIframe({
+      __hfForceTimelineRebind: vi.fn(() => {
+        throw new Error("runtime mid-teardown");
+      }),
+    });
+    expect(applySoftReloadFinalization(iframe, 0)).toBe(false);
+  });
+});
 function buildBootstrapIframe(overrides: Record<string, unknown> = {}) {
   const head = document.createElement("div");
   const appendedScripts: HTMLScriptElement[] = [];
@@ -452,116 +504,3 @@ describe("applySoftReload authored-opacity restore", () => {
     expect(restoreOpacity(el)).toBe("");
   });
 });
-// ── Bug 2: undo/redo restore soft-apply ──────────────────────────────────────
-const wrap = (body: string) => `<html><body>${body}</body></html>`;
-describe("diffSoftReloadableRestore", () => {
-  it("reports the changed id for an attribute/inline-style-only diff", () => {
-    const prev = wrap(`<div id="a" style="translate: 10px 10px">t</div>`);
-    const next = wrap(`<div id="a" style="translate: 0px 0px">t</div>`);
-    expect(diffSoftReloadableRestore(prev, next)).toEqual({ changedElementIds: ["a"] });
-  });
-  it("treats a structural change (added element) as NOT soft-reloadable", () => {
-    const prev = wrap(`<div id="a">t</div>`);
-    const next = wrap(`<div id="a">t</div><div id="a-split">t</div>`);
-    expect(diffSoftReloadableRestore(prev, next)).toBeNull();
-  });
-  it("treats an element text/child change as NOT soft-reloadable", () => {
-    const prev = wrap(`<div id="a">one</div>`);
-    const next = wrap(`<div id="a">two</div>`);
-    expect(diffSoftReloadableRestore(prev, next)).toBeNull();
-  });
-  it("allows a GSAP-script-only change (no id'd-attribute diff)", () => {
-    const prev = wrap(
-      `<div id="a">t</div><script>window.__timelines["root"]=gsap.timeline().to("#a",{x:1});</script>`,
-    );
-    const next = wrap(
-      `<div id="a">t</div><script>window.__timelines["root"]=gsap.timeline().to("#a",{x:9});</script>`,
-    );
-    expect(diffSoftReloadableRestore(prev, next)).toEqual({ changedElementIds: [] });
-  });
-});
-function buildLiveIframe(bodyHtml: string) {
-  const doc = document.implementation.createHTMLDocument("");
-  doc.body.innerHTML = bodyHtml;
-  const contentWindow = {
-    gsap: { timeline: () => {} },
-    __hfForceTimelineRebind: () => {},
-    __timelines: {} as Record<string, unknown>,
-    __player: { getTime: () => 3, seek: vi.fn() },
-    __hfStudioManualEditsApply: vi.fn(),
-  };
-  return {
-    iframe: { contentWindow, contentDocument: doc } as unknown as HTMLIFrameElement,
-    contentWindow,
-    doc,
-  };
-}
-describe("applyUndoRestoreToPreview", () => {
-  const ROOT = "index.html";
-  it("soft-applies an attribute/style-only restore: syncs the live element, no full reload", () => {
-    const { iframe, contentWindow, doc } = buildLiveIframe(
-      `<div id="a" style="translate: 10px 10px" data-hf-path-offset="true">t</div>`,
-    );
-    const reloadPreview = vi.fn();
-    const files = {
-      [ROOT]: {
-        previous: wrap(
-          `<div id="a" style="translate: 10px 10px" data-hf-path-offset="true">t</div>`,
-        ),
-        restored: wrap(`<div id="a" style="translate: 0px 0px" data-hf-path-offset="true">t</div>`),
-      },
-    };
-    const outcome = applyUndoRestoreToPreview(iframe, ROOT, files, 3, reloadPreview);
-    expect(outcome).toBe("soft");
-    expect(reloadPreview).not.toHaveBeenCalled();
-    // Live element reverted to the restored inline style.
-    expect(doc.getElementById("a")!.getAttribute("style")).toBe("translate: 0px 0px");
-    // No GSAP script in the restore → the manual-edit reapply runs, playhead held.
-    expect(contentWindow.__player.seek).toHaveBeenCalledWith(3);
-    expect(contentWindow.__hfStudioManualEditsApply).toHaveBeenCalled();
-  });
-  it("full-reloads a multi-file restore", () => {
-    const { iframe } = buildLiveIframe(`<div id="a">t</div>`);
-    const reloadPreview = vi.fn();
-    const files = {
-      [ROOT]: {
-        previous: wrap(`<div id="a" style="x">t</div>`),
-        restored: wrap(`<div id="a">t</div>`),
-      },
-      "scenes/intro.html": { previous: "a", restored: "b" },
-    };
-    expect(applyUndoRestoreToPreview(iframe, ROOT, files, 3, reloadPreview)).toBe("full");
-    expect(reloadPreview).toHaveBeenCalledTimes(1);
-  });
-  it("full-reloads a structural restore (split/delete undo)", () => {
-    const { iframe } = buildLiveIframe(`<div id="a">t</div><div id="a-split">t</div>`);
-    const reloadPreview = vi.fn();
-    const files = {
-      [ROOT]: {
-        previous: wrap(`<div id="a">t</div><div id="a-split">t</div>`),
-        restored: wrap(`<div id="a">t</div>`),
-      },
-    };
-    expect(applyUndoRestoreToPreview(iframe, ROOT, files, 3, reloadPreview)).toBe("full");
-    expect(reloadPreview).toHaveBeenCalledTimes(1);
-  });
-  it("full-reloads when the restore touches a sub-comp, not the active comp", () => {
-    const { iframe } = buildLiveIframe(`<div id="a">t</div>`);
-    const reloadPreview = vi.fn();
-    const files = { "scenes/intro.html": { previous: "a", restored: "b" } };
-    expect(applyUndoRestoreToPreview(iframe, ROOT, files, 3, reloadPreview)).toBe("full");
-    expect(reloadPreview).toHaveBeenCalledTimes(1);
-  });
-});

package/src/utils/gsapSoftReload.ts CHANGED Viewed

@@ -90,7 +90,7 @@ function isGsapScript(text: string): boolean {
   );
 }
-function findGsapScriptElements(doc: Document): HTMLScriptElement[] {
+export function findGsapScriptElements(doc: Document): HTMLScriptElement[] {
   const results: HTMLScriptElement[] = [];
   const scripts = doc.querySelectorAll<HTMLScriptElement>("script:not([src])");
   for (const script of scripts) {
@@ -102,8 +102,9 @@ function findGsapScriptElements(doc: Document): HTMLScriptElement[] {
 /**
  * Extract the GSAP timeline script text from a serialized HTML document, for
  * feeding into applySoftReload. Returns null when zero or multiple GSAP scripts
- * are present (ambiguous — caller should fall back to a full reload), matching
- * applySoftReload's own single-script requirement.
+ * are present (ambiguous — a serialized snapshot can't say WHICH script a
+ * single rewritten text corresponds to; caller should fall back to a full
+ * reload), matching applySoftReload's own single-script requirement.
  */
 export function extractGsapScriptText(html: string): string | null {
   const doc = new DOMParser().parseFromString(html, "text/html");
@@ -183,157 +184,53 @@ export interface SoftReloadOptions {
   authoredHtml?: string;
 }
-/** One file's restore from the edit-history store: before (live) / after (target) bytes. */
-export interface UndoRestoreFile {
-  previous: string;
-  restored: string;
-}
-function idElementMap(doc: Document): Map<string, Element> {
-  const map = new Map<string, Element>();
-  for (const el of doc.querySelectorAll("[id]")) {
-    const id = el.getAttribute("id");
-    if (id) map.set(id, el);
-  }
-  return map;
-}
-// Strip id'd elements to bare `id` and blank GSAP scripts, in place: docs that
-// differ only in id'd attributes/inline-style/script text normalize equal; any
-// residual difference is beyond soft-reload's reach → caller full-reloads.
-function normalizeSoftResidual(doc: Document): void {
-  for (const el of doc.querySelectorAll("[id]")) {
-    const id = el.getAttribute("id");
-    for (const name of [...el.getAttributeNames()]) {
-      if (name !== "id") el.removeAttribute(name);
-    }
-    if (id) el.setAttribute("id", id);
-  }
-  for (const script of findGsapScriptElements(doc)) script.textContent = "";
-}
-// Soft-reloadable iff the docs differ SOLELY in id'd-element attributes/inline
-// style and/or the GSAP script; returns the changed ids to sync onto the live
-// DOM. Structural/text diffs → null → the caller full-reloads. Pure.
-export function diffSoftReloadableRestore(
-  previous: string,
-  restored: string,
-): { changedElementIds: string[] } | null {
-  let prevDoc: Document;
-  let nextDoc: Document;
-  try {
-    prevDoc = new DOMParser().parseFromString(previous, "text/html");
-    nextDoc = new DOMParser().parseFromString(restored, "text/html");
-  } catch {
-    return null;
-  }
-  const prevById = idElementMap(prevDoc);
-  const nextById = idElementMap(nextDoc);
-  // A different id set means an element was added or removed (e.g. a split, a
-  // delete) — structural, so soft-reload can't express it.
-  if (prevById.size !== nextById.size) return null;
-  const changedElementIds: string[] = [];
-  for (const [id, nextEl] of nextById) {
-    const prevEl = prevById.get(id);
-    if (!prevEl || prevEl.tagName !== nextEl.tagName) return null;
-    // A change inside the element (text / children) is out of soft scope; only
-    // its own attributes may differ. (GSAP scripts are handled via re-run.)
-    if (prevEl.innerHTML !== nextEl.innerHTML) return null;
-    if (prevEl.outerHTML !== nextEl.outerHTML) changedElementIds.push(id);
-  }
-  // Confirm nothing OUTSIDE id'd-element attributes and GSAP scripts changed.
-  normalizeSoftResidual(prevDoc);
-  normalizeSoftResidual(nextDoc);
-  if (prevDoc.documentElement.outerHTML !== nextDoc.documentElement.outerHTML) return null;
-  return { changedElementIds };
-}
-/** Copy every attribute from `source` onto the live `target`, dropping extras. */
-function syncElementAttributes(target: Element, source: Element): void {
-  for (const name of [...target.getAttributeNames()]) {
-    if (!source.hasAttribute(name)) target.removeAttribute(name);
-  }
-  for (const name of source.getAttributeNames()) {
-    target.setAttribute(name, source.getAttribute(name) ?? "");
-  }
+/**
+ * The soft reload's finalization step, shared with the rebind-only preview sync
+ * below: seek → force timeline rebind → reapply studio manual edits.
+ *
+ * Seek BEFORE rebind: __hfForceTimelineRebind's own internal force-render
+ * (see init.ts) renders the freshly-created timeline at whatever the
+ * runtime's internal scrub position already is, not at whatever we pass
+ * here afterward — a redundant seek() call after rebind can be a GSAP
+ * no-op if the timeline already reports being at that time internally.
+ */
+function finalizeSoftReload(win: IframeWindow, currentTime: number): void {
+  win.__player?.seek?.(currentTime);
+  win.__hfForceTimelineRebind?.();
+  win.__hfStudioManualEditsApply?.();
 }
 /**
- * Soft-apply an undo/redo restore to the live preview WITHOUT a full iframe
- * remount (which blanks the frame black and re-flashes the WebGL context). Only
- * the active composition — the document living in the root iframe — is eligible;
- * a sub-comp or multi-file restore falls back to `reloadPreview`.
+ * Run ONLY applySoftReload's finalization (seek → __hfForceTimelineRebind →
+ * manual-edits reapply) against the live iframe — executing NO scripts and
+ * touching NO script elements. `__hfForceTimelineRebind` makes the runtime
+ * re-derive every clip's visibility window from the live DOM's `data-start` /
+ * `data-duration` attributes (init.ts: bindRootTimelineIfAvailable +
+ * syncTimedElementVisibility), so this is the flashless sync for a timing edit
+ * whose attributes were already live-patched and whose GSAP scripts are
+ * unchanged (`window.__timelines` still valid). Works for compositions with
+ * zero GSAP scripts too — the rebind hook is installed unconditionally by the
+ * runtime, independent of any animation library.
  *
- * The restore is soft-applied when its only differences are id'd-element
- * attributes / inline-style and/or the GSAP script (see diffSoftReloadableRestore):
- *   1. Each changed element's attribute surface (inline style, data-start /
- *      -duration, the studio manual-offset props + flags) is synced onto the live
- *      element — so a canvas-position revert lands on the live DOM the runtime's
- *      seek-reapply reads from, not just on disk.
- *   2. The restored GSAP script is re-run in place via applySoftReload, which
- *      re-seeks to `currentTime` (playhead-invariant) and re-folds manual edits.
- *      With no single script, the manual-edit reapply is invoked directly.
- *
- * Returns "soft" when applied in place, "full" when it escalated to reloadPreview
- * (ineligible restore, missing target, or a permanent soft-reload failure).
+ * Returns false when the iframe/runtime hook is unavailable or the run threw —
+ * the caller should escalate to a full reload.
  */
-export function applyUndoRestoreToPreview(
+export function applySoftReloadFinalization(
   iframe: HTMLIFrameElement | null,
-  activeCompPath: string | null,
-  files: Record<string, UndoRestoreFile> | undefined,
   currentTime: number,
-  reloadPreview: () => void,
-): "soft" | "full" {
-  const paths = files ? Object.keys(files) : [];
-  // Soft path only covers the single active-comp document in the root iframe.
-  if (!iframe || !activeCompPath || !files || paths.length !== 1 || paths[0] !== activeCompPath) {
-    reloadPreview();
-    return "full";
-  }
-  const doc = iframe.contentDocument;
-  const win = iframe.contentWindow as IframeWindow | null;
-  if (!doc || !win) {
-    reloadPreview();
-    return "full";
-  }
-  const { previous, restored } = files[activeCompPath]!;
-  const diff = diffSoftReloadableRestore(previous, restored);
-  if (!diff) {
-    reloadPreview();
-    return "full";
-  }
-  // Sync each changed element's attributes onto the live DOM from the restored
-  // markup, so the runtime's seek-reapply (which reads inline offset props off
-  // the live element) folds the REVERTED values, not the stale current ones.
-  const restoredById = idElementMap(new DOMParser().parseFromString(restored, "text/html"));
-  for (const id of diff.changedElementIds) {
-    const liveEl = doc.getElementById(id);
-    const restoredEl = restoredById.get(id);
-    if (liveEl && restoredEl) syncElementAttributes(liveEl, restoredEl);
-  }
-  const script = extractGsapScriptText(restored);
-  if (script) {
-    const result = applySoftReload(iframe, script, {
-      onAsyncFailure: reloadPreview,
-      currentTimeOverride: currentTime,
-    });
-    if (result === "cannot-soft-reload") {
-      reloadPreview();
-      return "full";
-    }
-    return "soft";
-  }
-  // No single GSAP script to re-run — the change was pure attribute/style. Re-fold
-  // manual edits and hold the playhead so the synced attributes take visible effect.
+): boolean {
+  const win = iframe?.contentWindow as IframeWindow | null;
+  if (!win?.__hfForceTimelineRebind) return false;
   try {
-    win.__player?.seek?.(currentTime);
-    win.__hfStudioManualEditsApply?.();
+    if (win.__hfSuppressSceneMutations) {
+      win.__hfSuppressSceneMutations(() => finalizeSoftReload(win, currentTime));
+    } else {
+      finalizeSoftReload(win, currentTime);
+    }
+    return true;
   } catch {
-    reloadPreview();
-    return "full";
+    return false;
   }
-  return "soft";
 }
 export function applySoftReload(
@@ -523,14 +420,7 @@ export function applySoftReload(
       const s = doc.createElement("script");
       s.textContent = `(function(){${scriptText}\n})();`;
       doc.body.appendChild(s);
-      // Seek BEFORE rebind: __hfForceTimelineRebind's own internal force-render
-      // (see init.ts) renders the freshly-created timeline at whatever the
-      // runtime's internal scrub position already is, not at whatever we pass
-      // here afterward — a redundant seek() call after rebind can be a GSAP
-      // no-op if the timeline already reports being at that time internally.
-      win.__player?.seek?.(currentTime);
-      win.__hfForceTimelineRebind?.();
-      win.__hfStudioManualEditsApply?.();
+      finalizeSoftReload(win, currentTime);
     };
     const needsMotionPath = /motionPath\s*[:{]/.test(scriptText);