@hyperframes/studio 0.8.6 → 0.8.8

package/dist/index.d.ts

@@ -31,6 +31,10 @@ interface PlayerControlsProps {
     disabled?: boolean;
     isFullscreen?: boolean;
     onToggleFullscreen?: () => void;
+    /** Needed to read the soloed clips' labels out of the preview document. */
+    previewIframeRef?: {
+        current: HTMLIFrameElement | null;
+    };
 }
 declare const PlayerControls: react.NamedExoticComponent<PlayerControlsProps>;
 
@@ -113,6 +117,12 @@ interface KeyframeSlice {
     setClipExpanded: (id: string, expanded: boolean) => void;
     /** Union-expand clips (keyframed clips are expanded by default on load). */
     expandClips: (ids: readonly string[]) => void;
+    /** Groups whose member rows the caret has shown (structural, not lanes). */
+    expandedGroupIds: Set<string>;
+    toggleGroupExpanded: (id: string) => void;
+    /** Rows (clip id or group id) whose automation-lane rows the `∿` button opened. */
+    expandedLaneOwnerIds: Set<string>;
+    toggleLaneOwnerExpanded: (id: string) => void;
     /**
      * Project/session/element-scoped request. Its nonce is monotonic across store
      * resets so a stale consumer can never collide with a later request.
@@ -177,6 +187,56 @@ interface ThumbnailSlice {
     setThumbnailMode: (mode: ThumbnailMode) => void;
 }
 
+/**
+ * "Hear only this" — session-only monitoring override, never persisted.
+ *
+ * Holds clip ids and group ids (never track numbers, per the design doc: solo
+ * is a per-element/per-group concept, not a row-position one). Exclusive by
+ * default (a plain toggle replaces the set); ⌘/Ctrl-click adds/removes one
+ * member without disturbing the rest. Never written to any attribute or
+ * document — the export-safety guarantee this slice exists to hold.
+ */
+
+interface AudioSoloSlice {
+    soloed: ReadonlySet<string>;
+    toggleSolo: (id: string, options?: {
+        add?: boolean;
+    }) => void;
+    clearSolo: () => void;
+}
+
+/**
+ * The two editing-mode toggles the timeline toolbar owns.
+ *
+ * A store slice rather than toolbar-local state because both are read far from
+ * where they are set: the motion-path arm is consumed by the canvas click
+ * handler and published by MotionPathOverlay, and the auto-keyframe flag
+ * decides what a drag/resize/rotate does inside the edit commit path.
+ *
+ * `motionPathArmed` is also cleared by playerStore on selection change — arming
+ * survives neither a new element nor a project switch, so those resets stay
+ * with the state they clear alongside.
+ */
+
+interface EditingModeSlice {
+    /** Motion-path "set destination" mode. Armed from the preview toolbar
+     *  (replaces the old double-click-on-canvas UX); while armed, one canvas
+     *  click places the new path's destination. */
+    motionPathArmed: boolean;
+    setMotionPathArmed: (armed: boolean) => void;
+    /** Published by MotionPathOverlay so the toolbar shows the button only when
+     *  the selected element can actually take a path. */
+    motionPathCreateAvailable: boolean;
+    setMotionPathCreateAvailable: (available: boolean) => void;
+    /** Global toggle for the "Add keyframe" diamond in the timeline toolbar
+     *  (#1808). When false, a manual drag/resize/rotate edit on an element that
+     *  already has a live tween shifts every keyframe by the edit's delta
+     *  (preserving the animation's shape) instead of inserting/updating a
+     *  keyframe at the playhead. */
+    autoKeyframeEnabled: boolean;
+    setAutoKeyframeEnabled: (enabled: boolean) => void;
+}
+
 type TimeListener = (time: number) => void;
 declare const liveTime: {
     notify: (time: number) => void;
@@ -250,6 +310,16 @@ interface TimelineElement {
     hidden?: boolean;
     /** Value of data-timeline-role attribute — used to identify music vs. voiceover. */
     timelineRole?: string;
+    /** Verbatim `data-audio-group` — the id of the `<hf-audio-group>` this clip belongs to, when any. */
+    audioGroup?: string;
+    /** The owning group's `data-label` (falls back to its id) — resolved once per parse. */
+    audioGroupLabel?: string;
+    /** The owning group's `data-volume` (defaults to 1) — resolved once per parse. */
+    audioGroupVolume?: number;
+    /** The owning group's `data-hidden` (defaults to false) — resolved once per parse. */
+    audioGroupHidden?: boolean;
+    /** The owning group's serialized `data-fx-chain`, when set — resolved once per parse. */
+    audioGroupFxChain?: string;
     /**
      * Set by useExpandedTimelineElements on an inline-expanded sub-composition
      * child: the absolute master-timeline start of the sub-comp host the child
@@ -265,7 +335,7 @@ type TimelineTool = "select" | "razor";
 interface SelectElementOptions {
     preserveSet?: boolean;
 }
-interface PlayerState extends KeyframeSlice, AutomationSelectionSlice, ThumbnailSlice {
+interface PlayerState extends KeyframeSlice, AutomationSelectionSlice, ThumbnailSlice, AudioSoloSlice, EditingModeSlice {
     isPlaying: boolean;
     currentTime: number;
     duration: number;
@@ -303,20 +373,6 @@ interface PlayerState extends KeyframeSlice, AutomationSelectionSlice, Thumbnail
      *  (drag, resize, rotate) target this instead of recomputing from playhead. */
     activeKeyframePct: number | null;
     setActiveKeyframePct: (pct: number | null) => void;
-    /** Motion-path "set destination" mode. Armed from the preview toolbar (replaces
-     *  the old double-click-on-canvas UX); while armed, one canvas click places the
-     *  new path's destination. `available` is published by MotionPathOverlay so the
-     *  toolbar shows the button only when the selected element can take a path. */
-    motionPathArmed: boolean;
-    setMotionPathArmed: (armed: boolean) => void;
-    motionPathCreateAvailable: boolean;
-    setMotionPathCreateAvailable: (available: boolean) => void;
-    /** Global toggle for the "Add keyframe" diamond in the timeline toolbar (#1808).
-     *  When false, a manual drag/resize/rotate edit on an element that already has
-     *  a live tween shifts every keyframe by the edit's delta (preserving the
-     *  animation's shape) instead of inserting/updating a keyframe at the playhead. */
-    autoKeyframeEnabled: boolean;
-    setAutoKeyframeEnabled: (enabled: boolean) => void;
     /** Multi-select: additional selected elements beyond selectedElementId. */
     selectedElementIds: Set<string>;
     clearSelectedElementIds: () => void;
@@ -355,7 +411,7 @@ interface PlayerState extends KeyframeSlice, AutomationSelectionSlice, Thumbnail
     setSelectedElementId: (id: string | null, options?: SelectElementOptions) => void;
     /** Move the selection anchor within an active multi-selection without collapsing it. */
     setSelectionAnchor: (id: string | null) => void;
-    updateElement: (elementId: string, updates: Partial<Pick<TimelineElement, "start" | "duration" | "track" | "zIndex" | "hasExplicitZIndex" | "playbackStart" | "hidden">>) => void;
+    updateElement: (elementId: string, updates: Partial<Pick<TimelineElement, "start" | "duration" | "track" | "zIndex" | "hasExplicitZIndex" | "playbackStart" | "hidden" | "audioGroup">>) => void;
     setZoomMode: (mode: ZoomMode) => void;
     setManualZoomPercent: (percent: number) => void;
     bumpZEditVersion: () => void;
@@ -599,7 +655,28 @@ interface TimelineEditCallbacks {
     }>, options?: {
         coalesceKey?: string;
     }) => Promise<void> | void;
-    onToggleTrackHidden?: (track: number, hidden: boolean) => Promise<void> | void;
+    /**
+     * `displayNumber` is the row the CLICKED control announced. It travels with
+     * the click because the header and the undo-history label derive the row from
+     * two different orderings: the header's comes from the group-aware row list
+     * (synthetic anchor rows, members pulled contiguous), the history's from a
+     * plain ascending sort of element-bearing keys. Once a group exists those
+     * disagree, so the same click said "Mute track 2" and recorded "Mute track 1".
+     * Passing the rendered number keeps one answer instead of two derivations.
+     */
+    onToggleTrackHidden?: (track: number, hidden: boolean, displayNumber?: number | null) => Promise<void> | void;
+    /** B7's bus strip: live-write the group's own attribute while dragging. */
+    onSetAudioGroupAttributeLive?: (groupId: string, attr: string, value: string | null) => void;
+    /** ...and persist one undo entry on release. */
+    onSetAudioGroupAttributeQuiet?: (groupId: string, attr: string, value: string | null, label: string) => Promise<void>;
+    /** C1's ungrouped-track FX pointer: "Group these clips" — write
+     *  `data-audio-group` on every one of them, atomically. Same shape B6's
+     *  carve auto-grouping uses. */
+    onGroupClips?: (clipIds: readonly string[], groupId: string) => Promise<void>;
+    /** C1's single-clip FX write: addressed by the clip itself rather than the
+     *  current selection, mirroring `onSetAudioGroupAttributeLive/Quiet`. */
+    onSetElementAttributeLive?: (element: TimelineElement, attr: string, value: string | null) => void;
+    onSetElementAttributeQuiet?: (element: TimelineElement, attr: string, value: string | null, label: string) => Promise<void>;
     onBlockedEditAttempt?: (element: TimelineElement, intent: BlockedTimelineEditIntent) => void;
     onSplitElement?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
     onRazorSplit?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
@@ -759,10 +836,21 @@ interface TimelineEditCallbackDeps {
     handleTimelineElementResize: (element: TimelineElement, updates: Pick<TimelineElement, "start" | "duration" | "playbackStart">) => Promise<void> | void;
     handleTimelineGroupResize: NonNullable<TimelineEditCallbacks["onResizeElements"]>;
     handleToggleTrackHidden: (track: number, hidden: boolean) => Promise<void> | void;
+    setAudioGroupAttribute: {
+        setLive: (groupId: string, attr: string, value: string | null) => void;
+        setQuiet: (groupId: string, attr: string, value: string | null, label: string) => Promise<void>;
+    };
     handleBlockedTimelineEdit: (element: TimelineElement, intent: BlockedTimelineEditIntent) => void;
     handleTimelineElementSplit: (element: TimelineElement, splitTime: number) => Promise<void> | void;
     handleRazorSplit: (element: TimelineElement, splitTime: number) => Promise<void> | void;
     handleRazorSplitAll: (splitTime: number) => Promise<void> | void;
+    /** C1's ungrouped-track FX pointer — same auto-grouping write B6's carve uses. */
+    handleGroupClips?: (clipIds: readonly string[], groupId: string) => Promise<void>;
+    /** C1's single-clip FX write, addressed by the clip itself. */
+    setElementFxAttribute?: {
+        setLive: (element: TimelineElement, attr: string, value: string | null) => void;
+        setQuiet: (element: TimelineElement, attr: string, value: string | null, label: string) => Promise<void>;
+    };
 }
 
 interface BlockPreviewInfo {
@@ -806,7 +894,7 @@ interface EditorShellProps extends TimelineEditCallbackDeps {
     onToggleRecording?: () => void;
     gestureOverlay?: ReactNode;
 }
-declare function EditorShell({ left, right, hidden, timelineToolbar, renderClipContent, handleTimelineElementDelete, handleTimelineAssetDrop, handleTimelineBlockDrop, handleTimelineCompositionDrop, handlePreviewBlockDrop, handleTimelineFileDrop, handleTimelineElementMove, handleTimelineElementsMove, handleTimelineElementResize, handleTimelineGroupResize, handleToggleTrackHidden, handleBlockedTimelineEdit, handleTimelineElementSplit, handleRazorSplit, handleRazorSplitAll, setCompIdToSrc, setCompositionLoading, shouldShowMotionPath, shouldShowSelectedDomBounds, isGestureRecording, recordingState, onToggleRecording, blockPreview, gestureOverlay, }: EditorShellProps): react_jsx_runtime.JSX.Element;
+declare function EditorShell({ left, right, hidden, timelineToolbar, renderClipContent, handleTimelineElementDelete, handleTimelineAssetDrop, handleTimelineBlockDrop, handleTimelineCompositionDrop, handlePreviewBlockDrop, handleTimelineFileDrop, handleTimelineElementMove, handleTimelineElementsMove, handleTimelineElementResize, handleTimelineGroupResize, handleToggleTrackHidden, setAudioGroupAttribute, handleGroupClips, setElementFxAttribute, handleBlockedTimelineEdit, handleTimelineElementSplit, handleRazorSplit, handleRazorSplitAll, setCompIdToSrc, setCompositionLoading, shouldShowMotionPath, shouldShowSelectedDomBounds, isGestureRecording, recordingState, onToggleRecording, blockPreview, gestureOverlay, }: EditorShellProps): react_jsx_runtime.JSX.Element;
 
 interface NLEPreviewProps {
     projectId: string;
@@ -966,6 +1054,8 @@ interface PropertyPanelProps {
     onRemoveTextField: (fieldKey: string) => void;
     onAskAgent: () => void;
     onToggleElementHidden?: (elementKey: string, hidden: boolean) => void | Promise<void>;
+    /** B6: group two or more picked voice clips, atomically, one undo entry. */
+    onAutoGroupCarveSources?: (clipIds: readonly string[], groupId: string) => Promise<void>;
     onImportAssets?: (files: FileList, dir?: string) => Promise<string[]>;
     onAddMediaOverlay?: AddMediaOverlayHandler;
     fontAssets?: ImportedFontAsset[];

package/dist/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
     <title>HyperFrames Studio</title>
-    <script type="module" crossorigin src="/assets/index-Cy6fGN1u.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DcF4s1PG.css">
+    <script type="module" crossorigin src="/assets/index-ng4tq6YE.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-Ba9zbpT9.css">
   </head>
   <body>
     <div data-hf-id="hf-aph5" id="root"></div>