@hyperframes/studio 0.7.107 → 0.7.108

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
+import { GsapAnimation, PropertyGroupName } from '@hyperframes/core/gsap-parser';
 import * as zustand from 'zustand';
 import { MusicBeatAnalysis } from '@hyperframes/core/beats';
-import { GsapAnimation, PropertyGroupName } from '@hyperframes/core/gsap-parser';
 import { GsapAnimation as GsapAnimation$1, ArcPathSegment } from '@hyperframes/parsers/gsap-parser';
 
 interface PlayerProps {
@@ -129,6 +129,40 @@ interface KeyframeSlice {
     setKeyframeCache: (elementId: string, data: KeyframeCacheEntry | undefined) => void;
 }
 
+/**
+ * The active selection box on one automation lane.
+ *
+ * A store slice, not lane-local state, for the same reason keyframe selection
+ * is one: Delete/copy/paste handlers and the shape menu live outside the lane
+ * component and need to read it. Ephemeral by construction — nothing
+ * serializes store state, and the selection must never survive into a render.
+ */
+
+interface AutomationSelection {
+    /** TimelineElement key (key ?? id) of the clip that owns the lane. */
+    elementKey: string;
+    /** Lane target: "volume" or "fx.<nodeId>.<param>". */
+    target: string;
+    /** Clip-local seconds; always t0 <= t1 (ordered on write). */
+    t0: number;
+    t1: number;
+    /**
+     * The box's value bounds, in the parameter's own units; always v0 <= v1.
+     *
+     * What makes the selection a box rather than a time span: a point is caught
+     * only if it falls inside both axes. Span operations — copy, paste, shape
+     * insert, simplify — still read t0/t1 alone, because they act on the envelope
+     * over a stretch of time rather than on a set of breakpoints.
+     */
+    v0: number;
+    v1: number;
+}
+interface AutomationSelectionSlice {
+    automationSelection: AutomationSelection | null;
+    setAutomationSelection: (sel: AutomationSelection) => void;
+    clearAutomationSelection: () => void;
+}
+
 interface TimelineFocusRequest {
     id: string;
     projectId: string | null;
@@ -149,6 +183,15 @@ declare const liveTime: {
     subscribe: (listener: TimeListener) => () => boolean;
 };
 
+/**
+ * One row in the timeline: a clip as Studio needs it, translated from the
+ * runtime's manifest at createTimelineElementFromManifestClip.
+ *
+ * Split out of playerStore, which had reached the 600-line studio ceiling and
+ * could not carry another field. Re-exported from there, so every existing
+ * importer is unaffected.
+ */
+
 interface TimelineElement {
     id: string;
     label?: string;
@@ -194,6 +237,9 @@ interface TimelineElement {
     playbackRate?: number;
     sourceDuration?: number;
     volume?: number;
+    /** Verbatim `data-fx-chain` / `data-automation`; see automationLaneData. */
+    fxChain?: string;
+    automation?: string;
     /** Path from data-composition-src — identifies sub-composition elements */
     compositionSrc?: string;
     /** Whether this row came from authored clip timing or Studio's full-duration layer fallback. */
@@ -213,12 +259,13 @@ interface TimelineElement {
     expandedParentStart?: number;
     expandedHostKey?: string;
 }
+
 type ZoomMode = "fit" | "manual";
 type TimelineTool = "select" | "razor";
 interface SelectElementOptions {
     preserveSet?: boolean;
 }
-interface PlayerState extends KeyframeSlice, ThumbnailSlice {
+interface PlayerState extends KeyframeSlice, AutomationSelectionSlice, ThumbnailSlice {
     isPlaying: boolean;
     currentTime: number;
     duration: number;
@@ -323,6 +370,37 @@ interface PlayerState extends KeyframeSlice, ThumbnailSlice {
     requestedSeekTime: number | null;
     requestSeek: (time: number) => void;
     clearSeekRequest: () => void;
+    /**
+     * Request the transport start or stop from outside the player loop.
+     *
+     * The FX rack auditions a preset by writing it to the running graph, which is
+     * silent while the transport is paused — so hovering one has to start
+     * playback, and leaving has to put the playhead back where it was. Hovering is
+     * not an edit and must not cost the author their place.
+     *
+     * A nonce rather than a bare boolean: two hovers in a row both want play, and
+     * without it the second request is indistinguishable from the first having
+     * already been served.
+     */
+    playbackRequest: {
+        playing: boolean;
+        returnTo: number | null;
+        nonce: number;
+    } | null;
+    requestPlayback: (playing: boolean, returnTo?: number | null) => void;
+    clearPlaybackRequest: () => void;
+    /**
+     * Request the timeline to scroll a clip into view (e.g. clicking an
+     * already-added asset card in the sidebar). Consumed and cleared by
+     * useTimelineRevealClip. The nonce makes repeat requests for the same
+     * clip observable so a second click re-reveals after the user scrolls away.
+     */
+    clipRevealRequest: {
+        elementId: string;
+        nonce: number;
+    } | null;
+    requestClipReveal: (elementId: string) => void;
+    clearClipRevealRequest: () => void;
     timelineFocus: TimelineFocusRequest | null;
     timelineFocusNonce: number;
     requestTimelineFocus: (id: string) => void;
@@ -853,6 +931,11 @@ interface PropertyPanelProps {
      *  `onSetAttribute` calls where omitted. */
     onSetAttributes?: (selection: DomEditSelection, attrs: Record<string, string>) => Promise<void>;
     onSetAttributeLive: (attr: string, value: string | null, onSettled?: (ok: boolean) => void) => void | Promise<void>;
+    /** Persists without reloading the preview, but re-reads the selection after —
+     *  for attributes the runtime applies to the live graph itself, where a reload
+     *  would only interrupt playback, and where the panel still has to see the
+     *  value it just wrote to compute the next edit from. */
+    onSetAttributeQuiet?: (attr: string, value: string | null) => void | Promise<void>;
     onApplyColorGradingScope?: (scope: "source-file" | "project", value: string | null) => Promise<{
         changedFiles: number;
         changedElements: number;

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-dF-CmLZu.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-zQ4JFwwB.css">
+    <script type="module" crossorigin src="/assets/index-GqONLcOl.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DNkh9mbV.css">
   </head>
   <body>
     <div data-hf-id="hf-aph5" id="root"></div>