@hyperframes/studio 0.8.46 → 0.8.48

package/dist/assets/{index-BywY2OM3.js → index-D_j-0PD3.js}

@@ -1 +1 @@
-import{g as P}from"./index-DCblmTX3.js";function j(c,d){for(var s=0;s<d.length;s++){const a=d[s];if(typeof a!="string"&&!Array.isArray(a)){for(const i in a)if(i!=="default"&&!(i in c)){const l=Object.getOwnPropertyDescriptor(a,i);l&&Object.defineProperty(c,i,l.get?l:{enumerable:!0,get:()=>a[i]})}}}return Object.freeze(Object.defineProperty(c,Symbol.toStringTag,{value:"Module"}))}var v={},w;function k(){if(w)return v;w=1,Object.defineProperty(v,"__esModule",{value:!0}),v.default=d;var c=window.OfflineAudioContext||window.webkitOfflineAudioContext;function d(e){var r=a(e);return r.start(0),[i,y,O(e.sampleRate),s].reduce(function(t,o){return o(t)},r.buffer.getChannelData(0))}function s(e){return e.sort(function(r,t){return t.count-r.count}).splice(0,5)[0].tempo}function a(e){var r=e.length,t=e.numberOfChannels,o=e.sampleRate,n=new c(t,r,o),u=n.createBufferSource();u.buffer=e;var f=n.createBiquadFilter();return f.type="lowpass",u.connect(f),f.connect(n.destination),u}function i(e){for(var r=[],t=.9,o=.3,n=15;r.length<n&&t>=o;)r=l(e,t),t-=.05;if(r.length<n)throw new Error("Could not find enough samples for a reliable detection.");return r}function l(e,r){for(var t=[],o=0,n=e.length;o<n;o+=1)e[o]>r&&(t.push(o),o+=1e4);return t}function y(e){var r=[];return e.forEach(function(t,o){for(var n=function(x){var g=e[o+x]-t,_=r.some(function(h){if(h.interval===g)return h.count+=1});_||r.push({interval:g,count:1})},u=0;u<10;u+=1)n(u)}),r}function O(e){return function(r){var t=[];return r.forEach(function(o){if(o.interval!==0){for(var n=60/(o.interval/e);n<90;)n*=2;for(;n>180;)n/=2;n=Math.round(n);var u=t.some(function(f){if(f.tempo===n)return f.count+=o.count});u||t.push({tempo:n,count:o.count})}}),t}}return v}var p,b;function q(){return b||(b=1,p=k().default),p}var m=q();const A=P(m),D=j({__proto__:null,default:A},[m]);export{D as i};
+import{g as P}from"./index-C9gJKpqQ.js";function j(c,d){for(var s=0;s<d.length;s++){const a=d[s];if(typeof a!="string"&&!Array.isArray(a)){for(const i in a)if(i!=="default"&&!(i in c)){const l=Object.getOwnPropertyDescriptor(a,i);l&&Object.defineProperty(c,i,l.get?l:{enumerable:!0,get:()=>a[i]})}}}return Object.freeze(Object.defineProperty(c,Symbol.toStringTag,{value:"Module"}))}var v={},w;function k(){if(w)return v;w=1,Object.defineProperty(v,"__esModule",{value:!0}),v.default=d;var c=window.OfflineAudioContext||window.webkitOfflineAudioContext;function d(e){var r=a(e);return r.start(0),[i,y,O(e.sampleRate),s].reduce(function(t,o){return o(t)},r.buffer.getChannelData(0))}function s(e){return e.sort(function(r,t){return t.count-r.count}).splice(0,5)[0].tempo}function a(e){var r=e.length,t=e.numberOfChannels,o=e.sampleRate,n=new c(t,r,o),u=n.createBufferSource();u.buffer=e;var f=n.createBiquadFilter();return f.type="lowpass",u.connect(f),f.connect(n.destination),u}function i(e){for(var r=[],t=.9,o=.3,n=15;r.length<n&&t>=o;)r=l(e,t),t-=.05;if(r.length<n)throw new Error("Could not find enough samples for a reliable detection.");return r}function l(e,r){for(var t=[],o=0,n=e.length;o<n;o+=1)e[o]>r&&(t.push(o),o+=1e4);return t}function y(e){var r=[];return e.forEach(function(t,o){for(var n=function(x){var g=e[o+x]-t,_=r.some(function(h){if(h.interval===g)return h.count+=1});_||r.push({interval:g,count:1})},u=0;u<10;u+=1)n(u)}),r}function O(e){return function(r){var t=[];return r.forEach(function(o){if(o.interval!==0){for(var n=60/(o.interval/e);n<90;)n*=2;for(;n>180;)n/=2;n=Math.round(n);var u=t.some(function(f){if(f.tempo===n)return f.count+=o.count});u||t.push({tempo:n,count:o.count})}}),t}}return v}var p,b;function q(){return b||(b=1,p=k().default),p}var m=q();const A=P(m),D=j({__proto__:null,default:A},[m]);export{D as i};

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
-import { RuntimeTimelineClipIdentity } from '@hyperframes/core';
+import { RuntimeTimelineClipIdentity, HyperframePickerElementInfo } from '@hyperframes/core';
 import { GsapAnimation, PropertyGroupName } from '@hyperframes/core/gsap-parser';
 import * as zustand from 'zustand';
+import { StoreApi } from 'zustand';
 import { MusicBeatAnalysis } from '@hyperframes/core/beats';
 import { GsapAnimation as GsapAnimation$1, ArcPathSegment } from '@hyperframes/parsers/gsap-parser';
 
@@ -250,6 +251,20 @@ interface ThumbnailSlice {
     bumpThumbnailContentRevision: () => void;
 }
 
+/** Gates `timelineReady` on the composition's declared readiness inputs
+ * (media, for now) instead of just a known duration. The generation counter
+ * is module-scope, not store state: it guards an in-flight settlement, not
+ * something a component reads, so bumping it shouldn't trigger a render. */
+
+interface PlaybackReadinessSlice {
+    timelineReady: boolean;
+    setTimelineReady: (ready: boolean) => void;
+    /** Sets timelineReady once doc's readiness inputs settle, or immediately
+     *  if doc is null. A wait a later call supersedes never wins the race. */
+    requestTimelineReady: (doc: Document | null) => void;
+}
+declare function createPlaybackReadinessSlice(set: StoreApi<PlaybackReadinessSlice>["setState"]): PlaybackReadinessSlice;
+
 type TimeListener = (time: number) => void;
 declare const liveTime: {
     notify: (time: number) => void;
@@ -382,11 +397,11 @@ type TimelineTool = "select" | "razor";
 interface SelectElementOptions {
     preserveSet?: boolean;
 }
-interface PlayerState extends KeyframeSlice, AutomationSelectionSlice, ThumbnailSlice, EditingModeSlice {
+type PlayerStoreSlices = KeyframeSlice & AutomationSelectionSlice & ThumbnailSlice & EditingModeSlice & ReturnType<typeof createPlaybackReadinessSlice>;
+interface PlayerState extends PlayerStoreSlices {
     isPlaying: boolean;
     currentTime: number;
     duration: number;
-    timelineReady: boolean;
     /** Increments exactly once when the Studio switches to a different project. */
     timelineSessionEpoch: number;
     /** Project owning the current timeline session; null outside a project-scoped reset. */
@@ -428,14 +443,14 @@ interface PlayerState extends KeyframeSlice, AutomationSelectionSlice, Thumbnail
     /** Timeline magnet toggle — when false, clip drags/trims/drops never snap. */
     timelineSnapEnabled: boolean;
     setTimelineSnapEnabled: (enabled: boolean) => void;
+    /** Keeps the main track gapless on delete; distinct from the magnet above. */
+    rippleEditEnabled: boolean;
+    setRippleEditEnabled: (enabled: boolean) => void;
     /** Transport + ruler readout: timecode ("time") or frame number ("frame"). */
     timeDisplayMode: TimelineTimeDisplayMode;
     setTimeDisplayMode: (mode: TimelineTimeDisplayMode) => void;
-    /**
-     * Pin the timeline zoom to its current visual scale before a duration-changing
-     * edit, so a subsequent duration change (which recomputes fit-pps) stops
-     * rescaling every clip. No-op once already pinned (mode is "manual").
-     */
+    /** Pin the timeline zoom to its current scale before a duration change, so
+     *  it stops rescaling every clip. No-op once already pinned. */
     pinTimelineZoom: (currentPixelsPerSecond: number, fitPixelsPerSecond: number) => void;
     /** The timeline's live pixels-per-second + fit basis, published by <Timeline>. */
     timelinePps: number;
@@ -452,7 +467,6 @@ interface PlayerState extends KeyframeSlice, AutomationSelectionSlice, Thumbnail
     setAudioMuted: (muted: boolean) => void;
     setAudioVolume: (volume: number) => void;
     setLoopEnabled: (enabled: boolean) => void;
-    setTimelineReady: (ready: boolean) => void;
     setBeatDragging: (dragging: boolean) => void;
     setElements: (elements: TimelineElement[]) => void;
     setSelectedElementId: (id: string | null, options?: SelectElementOptions) => void;
@@ -468,25 +482,15 @@ interface PlayerState extends KeyframeSlice, AutomationSelectionSlice, Thumbnail
     beginTimelineSession: (projectId: string) => void;
     /** Clears project data without creating a new hard-project session. */
     reset: () => void;
-    /**
-     * Request a seek from outside the player loop (e.g. Layers panel).
-     * useTimelinePlayer subscribes and calls adapter.seek() + liveTime.notify().
-     */
+    /** Request a seek from outside the player loop (e.g. Layers panel);
+     *  useTimelinePlayer subscribes and calls adapter.seek() + liveTime.notify(). */
     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.
-     */
+    /** Request the transport start or stop from outside the player loop: the FX
+     *  rack starts playback to audition a preset (silent while paused) and
+     *  restores the playhead on leave, without costing the author their place.
+     *  A nonce, not a bare boolean, so two hovers in a row both register. */
     playbackRequest: {
         playing: boolean;
         returnTo: number | null;
@@ -661,6 +665,45 @@ interface DomEditSelection extends PatchTarget {
     gsapAnimations?: GsapAnimation$1[];
 }
 
+/**
+ * Agent prompt builder for HyperFrames element edit requests.
+ */
+
+/**
+ * The subset of an element selection shared by the Studio DOM editor (`DomEditSelection`) and the
+ * runtime picker (`HyperframePickerElementInfo`); a field absent from a caller's type is simply omitted.
+ */
+interface AgentPromptElementInfo {
+    id: string | null;
+    selector?: string | null;
+    /** Disambiguates duplicate selectors in `DomEditSelection`. The picker
+     *  payload has no such concept (one picked node, not a candidate list), so
+     *  a picker-built prompt always prints index 0 — expected, not a gap. */
+    selectorIndex?: number;
+    tagName: string;
+    label?: string;
+    boundingBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    textContent: string | null;
+    src?: string | null;
+    textFields?: DomEditTextField[];
+    inlineStyles?: Record<string, string>;
+    computedStyles?: Record<string, string>;
+}
+/**
+ * Same convention as `buildElementAgentPrompt`, for a host app embedding only the player: built from
+ * the runtime picker's own payload, not `DomEditSelection`. Null selection yields a bare prompt, no guardrails.
+ */
+declare function buildPickerAgentPrompt({ selection, userInstruction, }: {
+    selection: HyperframePickerElementInfo | null;
+    userInstruction?: string;
+}): string;
+declare function buildPickerAgentContextPreview(selection: HyperframePickerElementInfo | null): string;
+
 type BlockedTimelineEditIntent = "move" | "resize-start" | "resize-end";
 
 type TimelineMoveOperation = "timing" | "lane-reorder" | "track-insert";
@@ -1202,6 +1245,20 @@ declare const FileTree: react.NamedExoticComponent<FileTreeProps>;
 
 declare function StudioApp(): react_jsx_runtime.JSX.Element;
 
+interface AgentModalAnchorPoint {
+    x: number;
+    y: number;
+}
+
+interface AskAgentModalProps {
+    selectionLabel: string;
+    contextPreview?: string;
+    anchorPoint?: AgentModalAnchorPoint | null;
+    onSubmit: (instruction: string) => void;
+    onClose: () => void;
+}
+declare function AskAgentModal({ selectionLabel, contextPreview, anchorPoint, onSubmit, onClose, }: AskAgentModalProps): react_jsx_runtime.JSX.Element;
+
 interface PickedElement {
     id: string | null;
     tagName: string;
@@ -1277,4 +1334,4 @@ declare function findElementBlock(html: string, elementId: string): {
     isSelfClosing: boolean;
 } | null;
 
-export { CompositionBreadcrumb, type CompositionLevel, CompositionThumbnail, EditorShell, FileTree, NLEPreview, type PatchOperation, type PickedElement, Player, PlayerControls, PropertyPanel, SourceEditor, StudioApp, Timeline, type TimelineElement, VideoThumbnail, applyPatch, findElementBlock, formatTime, liveTime, mergeStyleIntoTag, parseStyleString, resolveIframe, resolveSourceFile, useElementPicker, usePlayerStore, useTimelinePlayer };
+export { type AgentModalAnchorPoint, type AgentPromptElementInfo, AskAgentModal, type AskAgentModalProps, CompositionBreadcrumb, type CompositionLevel, CompositionThumbnail, EditorShell, FileTree, NLEPreview, type PatchOperation, type PickedElement, Player, PlayerControls, PropertyPanel, SourceEditor, StudioApp, Timeline, type TimelineElement, VideoThumbnail, applyPatch, buildPickerAgentContextPreview, buildPickerAgentPrompt, findElementBlock, formatTime, liveTime, mergeStyleIntoTag, parseStyleString, resolveIframe, resolveSourceFile, useElementPicker, usePlayerStore, useTimelinePlayer };

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-DCblmTX3.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DnRfAiK2.css">
+    <script type="module" crossorigin src="/assets/index-C9gJKpqQ.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-B9LfWNyM.css">
   </head>
   <body>
     <div data-hf-id="hf-aph5" id="root"></div>