@hyperframes/studio 0.8.108 → 0.8.110

package/dist/index.d.ts

@@ -374,6 +374,9 @@ interface TimelineElement {
     /** The owning group's serialized `data-fx-chain`, when set — resolved once per parse. */
     audioGroupFxChain?: string;
     audioGroupAutomation?: string;
+    link?: string;
+    compositionScope?: string;
+    syncOrigin?: string;
     /**
      * Master start of the composition this row runs in, which its tweens and its
      * `data-start` are local to; 0 at the root. Writes go through toAuthoredStart.
@@ -1058,6 +1061,28 @@ interface TimelineDropCallbacks {
         track: number;
     }) => Promise<void> | void;
 }
+type TimelineLinkEdit = {
+    kind: "unlink";
+    elements: readonly TimelineElement[];
+} | {
+    kind: "link";
+    elements: readonly TimelineElement[];
+} | {
+    kind: "detach";
+    element: TimelineElement;
+} | {
+    kind: "merge";
+    video: TimelineElement;
+    audio: TimelineElement;
+} | {
+    kind: "move-into-sync";
+    element: TimelineElement;
+    start: number;
+} | {
+    kind: "slip-into-sync";
+    element: TimelineElement;
+    mediaStart: number;
+};
 interface TimelineEditCallbacks {
     onMoveElement?: (element: TimelineElement, updates: Pick<TimelineElement, "start" | "track">) => Promise<void> | void;
     /** Atomic multi-clip move (single undo) for main-track ripple + track-insert.
@@ -1102,11 +1127,19 @@ interface TimelineEditCallbacks {
     onSetElementAttributeLive?: (element: TimelineElement, attr: string, value: string | null) => void;
     onRevertElementAttributeLive?: (element: TimelineElement, attr: string) => void;
     onSetElementAttributeQuiet?: (element: TimelineElement, attr: string, value: string | null, label: string) => Promise<TimelineEditOutcome | void>;
+    /** One attribute on several clips, saved as one undo step. */
+    onSetElementsAttributeQuiet?: (edits: ReadonlyArray<{
+        element: TimelineElement;
+        value: string | null;
+    }>, attr: string, label: string) => Promise<TimelineEditOutcome | void>;
     onBlockedEditAttempt?: (element: TimelineElement, intent: BlockedTimelineEditIntent) => void;
+    onLinkEdit?: (edit: TimelineLinkEdit) => Promise<void> | void;
+    onDeleteElementOnly?: (element: TimelineElement) => Promise<void> | void;
     onSplitElement?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
     onRazorSplit?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
     onRazorSplitAll?: (splitTime: number) => Promise<void> | void;
     onFreezeFrame?: (element: TimelineElement, time: number) => Promise<void> | void;
+    onNotice?: (message: string, tone?: "error" | "info") => void;
     onDeleteKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
     onDeleteAllKeyframes?: (element: TimelineElement, animationId?: string) => void;
     onMoveKeyframeToPlayhead?: (element: TimelineElement, keyframe: TimelineKeyframeTarget) => void;
@@ -1303,6 +1336,7 @@ interface DraggedClipState {
     snapTime: number | null;
     snapType: TimelineSnapType | null;
     started: boolean;
+    altKey?: boolean;
 }
 interface ResizingClipState {
     /** Pointer captured by the stable viewport coordinator for this gesture. */
@@ -1332,6 +1366,7 @@ interface ResizingClipState {
         playbackStart?: number;
     }[];
     started: boolean;
+    altKey?: boolean;
 }
 interface BlockedClipState {
     pointerId: number;
@@ -1492,11 +1527,6 @@ interface TimelineLaneBaseProps {
     setResizingClip: (v: ResizingClipState | null) => void;
     setDraggedClip: (v: DraggedClipState | null) => void;
     setSelectedElementId: (id: string | null) => void;
-    shiftClickClipRef: React.RefObject<{
-        element: TimelineElement;
-        anchorX: number;
-        anchorY: number;
-    } | null>;
     getPreviewElement: (element: TimelineElement) => TimelineElement;
     getTrackStyle: (tag: string) => TrackVisualStyle;
     keyframeCache?: Map<string, KeyframeCacheEntry>;
@@ -1910,6 +1940,8 @@ interface TimelineEditCallbackDeps {
     handleRazorSplit: (element: TimelineElement, splitTime: number) => Promise<void> | void;
     handleRazorSplitAll: (splitTime: number) => Promise<void> | void;
     handleFreezeFrame?: (element: TimelineElement, time: number) => Promise<void> | void;
+    handleLinkEdit?: TimelineEditCallbacks["onLinkEdit"];
+    handleTimelineElementDeleteOnly?: TimelineEditCallbacks["onDeleteElementOnly"];
     /** C1's ungrouped-track FX pointer — same auto-grouping write B6's carve uses. */
     handleGroupClips?: (clipIds: readonly string[], groupId: string, groupLabel?: string) => Promise<void>;
     /** C1's single-clip FX write, addressed by the clip itself. */
@@ -1917,6 +1949,7 @@ interface TimelineEditCallbackDeps {
         setLive: (element: TimelineElement, attr: string, value: string | null) => void;
         revertLive?: (element: TimelineElement, attr: string) => void;
         setQuiet: (element: TimelineElement, attr: string, value: string | null, label: string) => Promise<TimelineEditOutcome | void>;
+        setMany?: TimelineEditCallbacks["onSetElementsAttributeQuiet"];
     };
 }
 
@@ -1969,7 +2002,7 @@ interface EditorShellProps extends TimelineEditCallbackDeps {
     /** Short text shown on disabled hand-edit controls while `readOnlyPreview` is set. */
     readOnlyPreviewReason?: string;
 }
-declare function EditorShell({ panels, timelineToolbar, renderClipContent, handleTimelineElementDelete, handleTimelineAssetDrop, handleTimelineBlockDrop, handleTimelineCompositionDrop, handlePreviewBlockDrop, handleTimelineFileDrop, handleTimelineElementMove, handleTimelineElementsMove, handleTimelineElementResize, handleTimelineGroupResize, handleToggleTrackHidden, setAudioGroupAttribute, handleGroupClips, setElementFxAttribute, handleBlockedTimelineEdit, handleTimelineElementSplit, handleRazorSplit, handleRazorSplitAll, handleFreezeFrame, onCopyClip, onPasteClip, onDuplicateClip, canPasteClip, clipMenuItems, setCompIdToSrc, setCompositionLoading, shouldShowMotionPath, shouldShowSelectedDomBounds, isGestureRecording, recordingState, onToggleRecording, blockPreview, gestureOverlay, readOnlyPreview, readOnlyPreviewReason, }: EditorShellProps): react_jsx_runtime.JSX.Element;
+declare function EditorShell({ panels, timelineToolbar, renderClipContent, handleTimelineElementDelete, handleTimelineAssetDrop, handleTimelineBlockDrop, handleTimelineCompositionDrop, handlePreviewBlockDrop, handleTimelineFileDrop, handleTimelineElementMove, handleTimelineElementsMove, handleTimelineElementResize, handleTimelineGroupResize, handleToggleTrackHidden, setAudioGroupAttribute, handleGroupClips, setElementFxAttribute, handleBlockedTimelineEdit, handleTimelineElementSplit, handleRazorSplit, handleRazorSplitAll, handleFreezeFrame, handleLinkEdit, handleTimelineElementDeleteOnly, onCopyClip, onPasteClip, onDuplicateClip, canPasteClip, clipMenuItems, setCompIdToSrc, setCompositionLoading, shouldShowMotionPath, shouldShowSelectedDomBounds, isGestureRecording, recordingState, onToggleRecording, blockPreview, gestureOverlay, readOnlyPreview, readOnlyPreviewReason, }: EditorShellProps): react_jsx_runtime.JSX.Element;
 
 interface PreviewCompositionSize {
     width: number;
@@ -2100,6 +2133,23 @@ interface DockLayoutState extends DockSnapshot {
 }
 declare const useDockLayoutStore: zustand.UseBoundStore<zustand.StoreApi<DockLayoutState>>;
 
+interface PreviewIframeState {
+    iframe: HTMLIFrameElement | null;
+    setIframe: (iframe: HTMLIFrameElement | null) => void;
+}
+/** The one owner of "the live preview iframe element"; a promoted reload replaces it. */
+declare const usePreviewIframeStore: zustand.UseBoundStore<zustand.StoreApi<PreviewIframeState>>;
+
+interface AudioGainDialogState {
+    targetKeys: readonly string[] | null;
+    open: (keys: readonly string[]) => void;
+    close: () => void;
+}
+/** Which clips the Audio Gain dialog (G) is open for. */
+declare const useAudioGainDialogStore: zustand.UseBoundStore<zustand.StoreApi<AudioGainDialogState>>;
+/** Open Audio Gain for the selection (or the clicked clip); false when none of it has sound. */
+declare function openAudioGainDialog(clicked?: TimelineElement): boolean;
+
 interface AudioWaveformProps {
     audioUrl: string;
     waveformUrl?: string;
@@ -2112,8 +2162,7 @@ interface AudioWaveformProps {
     priority: ThumbnailPriority;
     /** `data-hidden` or a muted audio group. Greys the pill; the clip stays. */
     muted?: boolean;
-    /** Same media file as a video clip. Draws the 1px parent tick. */
-    linked?: boolean;
+    labelInset?: number;
 }
 /** Bounded waveform subscriber; cache, cancellation and dedupe live in one scheduler. */
 declare const AudioWaveform: react.NamedExoticComponent<AudioWaveformProps>;
@@ -2690,6 +2739,10 @@ declare function useTimelineEditing({ projectId, activeCompPath, timelineElement
         restoreLive: (restore: LiveLaneRestore) => void;
     };
     setElementFxAttribute: {
+        setMany: (edits: readonly {
+            element: TimelineElement;
+            value: string | null;
+        }[], attr: string, label: string) => Promise<TimelineEditOutcome>;
         setQuiet: (element: TimelineElement, attr: string, value: string | null, label: string) => Promise<TimelineEditOutcome>;
         setLive: (element: TimelineElement, attr: string, value: string | null) => void;
         revertLive: (element: TimelineElement, attr: string) => void;
@@ -2697,6 +2750,8 @@ declare function useTimelineEditing({ projectId, activeCompPath, timelineElement
     };
     handleTimelineElementDelete: (element: TimelineElement) => Promise<void>;
     handleTimelineElementsDelete: (selection: TimelineElement[]) => Promise<void>;
+    handleTimelineElementDeleteOnly: (element: TimelineElement) => Promise<void>;
+    handleLinkEdit: (edit: TimelineLinkEdit) => Promise<void>;
     handleTimelineElementSplit: (element: TimelineElement, splitTime: number) => Promise<void>;
     handleRazorSplit: (element: TimelineElement, splitTime: number) => Promise<void>;
     handleFreezeFrame: (element: TimelineElement, playhead: number) => Promise<void>;
@@ -4005,4 +4060,4 @@ declare function buildStudioTools(depsRef: {
     readonly current: StudioAgentToolsDeps;
 }): ModelContextTool[];
 
-export { type AgentModalAnchorPoint, type AgentPromptElementInfo, AskAgentModal, type AskAgentModalProps, AudioMeterStrip, type AudioMeterStripProps, AudioWaveform, type AudioWaveformProps, type BlockedTimelineEditIntent, type CanEditTimelineElement, CompositionBreadcrumb, type CompositionDimensions, type CompositionLevel, CompositionThumbnail, ConnectedDomEditOverlay, type ConnectedDomEditOverlayProps, DEFAULT_SHORTCUT_SECTIONS, Dock, type DockController, type DomEditCapabilities, type DomEditCommitDeclineReason, type DomEditCommitOutcome, type DomEditGroupPathOffsetCommit, DomEditOverlay, type DomEditOverlayProps, DomEditProvider, type DomEditSelection, type DomEditZOrder, type DomGeometryCommits, type EditHistoryHandle, EditorShell, type EditorShellProps, type ExternalFileChangeBlockedState, type ExternalFileChangeCoordinatorHandle, ExternalFileConflictBanner, type FfmpegStatus, FileTree, GridOverlay, ImageThumbnail, type ImageThumbnailProps, type MarqueeGestures, type MarqueeGesturesDeps, MarqueeOverlay, type MarqueeOverlayProps, type Rect$1 as MarqueeRect, type ModelContextTool, NLEPreview, type PanelId, type PatchOperation, type PersistedRenderSettings, type PickedElement, PlayerControls, type PlayerHandle, type PlayerHandleElement, type PlayerHandleListener, type PlayerHandleTimeListener, type DomEditCompositionRect as PreviewCompositionRect, PreviewGuides, PreviewOverlayProvider, type PreviewOverlayProviderProps, type PreviewPromotion, PreviewReadOnlyProvider, type PreviewSnapPreferences, PropertyPanel, type RenderJob, RenderQueue, type RenderQueueProps, type ResolutionPreset, SNAP_THRESHOLD_PX, type ShortcutHint, type ShortcutSection, ShortcutsButton, type ShortcutsButtonProps, type SnapContext, type SnapEdge, type SnapGuide, SnapGuideOverlay, type SnapGuideOverlayProps, type SnapGuidesState, type Rect as SnapRect, type SnapResult, type SnapTarget, SnapToolbar, SourceEditor, type SpacingGuide, type StartRenderOptions, type StudioAgentToolsDeps, StudioApp, StudioFileConflictError, type StudioLookSnapshot, type StudioPendingEditsDrainResult, TRACK_H, type ThumbnailPriority, Timeline, TimelineClipMenu, type TimelineClipMenuItem, type TimelineClipRenderContext, type TimelineEditCallbacks, type TimelineEditOutcome, type TimelineEditPermission, TimelineEditPopover, TimelineEditProvider, type TimelineElement, TimelineEmptyStatePart, TimelineFrame, TimelineGapMenu, TimelineHistoryButtons, type TimelineHistoryButtonsProps, TimelineKeyframeMenu, TimelineLanes, TimelineOverlays, TimelinePane, type TimelinePaneProps, TimelinePlayhead, TimelineProvider, TimelineRazorGuide, TimelineRuler, TimelineShortcutHint, type TimelineTheme, type TimelineTimeRange$1 as TimelineTimeRange, TimelineToolbar, type TimelineToolbarProps, type TimelineTrackPadding, type TimelineZIndexReorderCommit, type ToolResult, type UseClipboardOptions, type UseDomEditSessionParams, type UseDomGeometryCommitOptions, type UseDomStyleCommitOptions, type UseEditHistoryActionsOptions, type UsePersistentEditHistoryOptions, type UsePreviewPersistenceParams, type UseProjectFileWriterOptions, type UseRenderClipContentOptions, type UseTimelineEditingOptions, VideoThumbnail, type ZOrderAction, applyPatch, buildCompositionSnapTarget, buildGridSnapEdges, buildPickerAgentContextPreview, buildPickerAgentPrompt, buildStudioTools, collectSnapContext, collectStudioLookScene, extractSnapTargets, findElementBlock, flushStudioPendingEdits, formatTime, getPersistedRenderSettings, liveTime, mergeStyleIntoTag, parseStyleString, persistRenderSettings, resolveDomEditSelection, resolveEquidistanceGuides, resolveGuideLineRect, resolveIframe, resolveSnapAdjustment, resolveSourceFile, snapEngagedForTravel, useAudioMetersVisible, useClipboard, useCompositionStack, useDockLayoutStore, useDomEditSelectionContext, useDomEditSession, useDomEditZOrder, useDomGeometryCommit, useDomStyleCommit, useEditHistoryActions, useElementPicker, useLivePreviewIframe, useMarqueeGestures, usePersistentEditHistory, usePlayerHandle, usePlayerStore, usePreviewCompositionRect, usePreviewGuidesStore, usePreviewOverlayContext, usePreviewPersistence, useProjectFileWriter, useRenderClipContent, useRenderQueue, useTimelineContext, useTimelineEditing, useTimelinePlayer };
+export { type AgentModalAnchorPoint, type AgentPromptElementInfo, AskAgentModal, type AskAgentModalProps, AudioMeterStrip, type AudioMeterStripProps, AudioWaveform, type AudioWaveformProps, type BlockedTimelineEditIntent, type CanEditTimelineElement, CompositionBreadcrumb, type CompositionDimensions, type CompositionLevel, CompositionThumbnail, ConnectedDomEditOverlay, type ConnectedDomEditOverlayProps, DEFAULT_SHORTCUT_SECTIONS, Dock, type DockController, type DomEditCapabilities, type DomEditCommitDeclineReason, type DomEditCommitOutcome, type DomEditGroupPathOffsetCommit, DomEditOverlay, type DomEditOverlayProps, DomEditProvider, type DomEditSelection, type DomEditZOrder, type DomGeometryCommits, type EditHistoryHandle, EditorShell, type EditorShellProps, type ExternalFileChangeBlockedState, type ExternalFileChangeCoordinatorHandle, ExternalFileConflictBanner, type FfmpegStatus, FileTree, GridOverlay, ImageThumbnail, type ImageThumbnailProps, type MarqueeGestures, type MarqueeGesturesDeps, MarqueeOverlay, type MarqueeOverlayProps, type Rect$1 as MarqueeRect, type ModelContextTool, NLEPreview, type PanelId, type PatchOperation, type PersistedRenderSettings, type PickedElement, PlayerControls, type PlayerHandle, type PlayerHandleElement, type PlayerHandleListener, type PlayerHandleTimeListener, type DomEditCompositionRect as PreviewCompositionRect, PreviewGuides, PreviewOverlayProvider, type PreviewOverlayProviderProps, type PreviewPromotion, PreviewReadOnlyProvider, type PreviewSnapPreferences, PropertyPanel, type RenderJob, RenderQueue, type RenderQueueProps, type ResolutionPreset, SNAP_THRESHOLD_PX, type ShortcutHint, type ShortcutSection, ShortcutsButton, type ShortcutsButtonProps, type SnapContext, type SnapEdge, type SnapGuide, SnapGuideOverlay, type SnapGuideOverlayProps, type SnapGuidesState, type Rect as SnapRect, type SnapResult, type SnapTarget, SnapToolbar, SourceEditor, type SpacingGuide, type StartRenderOptions, type StudioAgentToolsDeps, StudioApp, StudioFileConflictError, type StudioLookSnapshot, type StudioPendingEditsDrainResult, TRACK_H, type ThumbnailPriority, Timeline, TimelineClipMenu, type TimelineClipMenuItem, type TimelineClipRenderContext, type TimelineEditCallbacks, type TimelineEditOutcome, type TimelineEditPermission, TimelineEditPopover, TimelineEditProvider, type TimelineElement, TimelineEmptyStatePart, TimelineFrame, TimelineGapMenu, TimelineHistoryButtons, type TimelineHistoryButtonsProps, TimelineKeyframeMenu, TimelineLanes, TimelineOverlays, TimelinePane, type TimelinePaneProps, TimelinePlayhead, TimelineProvider, TimelineRazorGuide, TimelineRuler, TimelineShortcutHint, type TimelineTheme, type TimelineTimeRange$1 as TimelineTimeRange, TimelineToolbar, type TimelineToolbarProps, type TimelineTrackPadding, type TimelineZIndexReorderCommit, type ToolResult, type UseClipboardOptions, type UseDomEditSessionParams, type UseDomGeometryCommitOptions, type UseDomStyleCommitOptions, type UseEditHistoryActionsOptions, type UsePersistentEditHistoryOptions, type UsePreviewPersistenceParams, type UseProjectFileWriterOptions, type UseRenderClipContentOptions, type UseTimelineEditingOptions, VideoThumbnail, type ZOrderAction, applyPatch, buildCompositionSnapTarget, buildGridSnapEdges, buildPickerAgentContextPreview, buildPickerAgentPrompt, buildStudioTools, collectSnapContext, collectStudioLookScene, extractSnapTargets, findElementBlock, flushStudioPendingEdits, formatTime, getPersistedRenderSettings, liveTime, mergeStyleIntoTag, openAudioGainDialog, parseStyleString, persistRenderSettings, resolveDomEditSelection, resolveEquidistanceGuides, resolveGuideLineRect, resolveIframe, resolveSnapAdjustment, resolveSourceFile, snapEngagedForTravel, useAudioGainDialogStore, useAudioMetersVisible, useClipboard, useCompositionStack, useDockLayoutStore, useDomEditSelectionContext, useDomEditSession, useDomEditZOrder, useDomGeometryCommit, useDomStyleCommit, useEditHistoryActions, useElementPicker, useLivePreviewIframe, useMarqueeGestures, usePersistentEditHistory, usePlayerHandle, usePlayerStore, usePreviewCompositionRect, usePreviewGuidesStore, usePreviewIframeStore, usePreviewOverlayContext, usePreviewPersistence, useProjectFileWriter, useRenderClipContent, useRenderQueue, useTimelineContext, useTimelineEditing, useTimelinePlayer };

package/dist/index.html

@@ -14,8 +14,8 @@
         document.documentElement.dataset.theme = "paper";
       }
     </script>
-    <script type="module" crossorigin src="/assets/index-C842tcVa.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-ncVJ5IVu.css">
+    <script type="module" crossorigin src="/assets/index-Co6W8IVk.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-C7apTvpr.css">
   </head>
   <body>
     <div data-hf-id="hf-aph5" id="root"></div>