hyperframes 0.8.100 → 0.8.102

package/dist/studio/index.d.ts

@@ -5,10 +5,10 @@ import { RefObject, MutableRefObject, ReactNode, DragEventHandler, ComponentProp
 import { RuntimeTimelineClipIdentity, HyperframePickerElementInfo } from '@hyperframes/core';
 import { GsapAnimation, ParsedGsap, PropertyGroupName } from '@hyperframes/core/gsap-parser';
 import { Composition } from '@hyperframes/sdk';
-export { Player } from './player.js';
-import { MusicBeatAnalysis } from '@hyperframes/core/beats';
 import * as zustand from 'zustand';
 import { StoreApi } from 'zustand';
+export { Player } from './player.js';
+import { MusicBeatAnalysis } from '@hyperframes/core/beats';
 import { GsapAnimation as GsapAnimation$1, ArcPathSegment } from '@hyperframes/parsers/gsap-parser';
 import * as _hyperframes_parsers from '@hyperframes/parsers';
 import { CanvasResolution } from '@hyperframes/parsers';
@@ -2010,6 +2010,68 @@ interface UseCompositionStackResult {
 }
 declare function useCompositionStack({ projectId, activeCompositionPath, onCompositionChange, }: UseCompositionStackOptions): UseCompositionStackResult;
 
+declare const PANEL_IDS: readonly ["preview", "timeline", "compositions", "assets", "code", "catalog", "design", "layers", "renders", "variables", "slideshow"];
+type PanelId = (typeof PANEL_IDS)[number];
+type PanelZone = "left" | "center" | "right";
+
+declare function Root({ projectId, panels, storageKey, dockWidth, children, }: {
+    projectId: string | null;
+    panels?: readonly PanelId[];
+    storageKey?: string;
+    dockWidth?: () => number;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function Panel({ id, title, children }: {
+    id: PanelId;
+    title?: string;
+    children: ReactNode;
+}): react.ReactPortal | null;
+declare function WindowMenu(): react_jsx_runtime.JSX.Element;
+declare const Dock: {
+    Root: typeof Root;
+    Panel: typeof Panel;
+    WindowMenu: typeof WindowMenu;
+};
+
+/** The narrow surface Dock.Root exposes; dockview types never leave the dock folder. */
+interface DockController {
+    /** Adds the panel at its default place if it is closed; never moves focus. */
+    open: (id: PanelId) => void;
+    /** Focuses the panel, reopening it at its default place if it was closed. */
+    activate: (id: PanelId) => void;
+    setTitle: (id: PanelId, title: string) => void;
+    close: (id: PanelId) => void;
+    /** Hides or shows the panel's whole tab group without closing it. */
+    setGroupVisible: (id: PanelId, visible: boolean) => void;
+    reset: () => void;
+}
+interface DockSnapshot {
+    openPanels: ReadonlySet<PanelId>;
+    /** Open panels whose tab is showing and whose group is not hidden. */
+    visiblePanels: ReadonlySet<PanelId>;
+    activePanel: PanelId | null;
+    /** The tab each group shows, so a restored layout still records what every side column last showed. */
+    groupActivePanels?: readonly PanelId[];
+}
+type LastActive = Partial<Record<PanelZone, PanelId>>;
+interface DockLayoutState extends DockSnapshot {
+    controller: DockController | null;
+    panels: readonly PanelId[];
+    lastActive: LastActive;
+    /** An activation requested before the dock mounted; Dock.Root applies it on ready. */
+    pendingActivation: PanelId | null;
+    attach: (controller: DockController, panels?: readonly PanelId[]) => void;
+    detach: () => void;
+    sync: (snapshot: DockSnapshot) => void;
+    takePendingActivation: () => PanelId | null;
+    activatePanel: (id: PanelId) => void;
+    closePanel: (id: PanelId) => void;
+    togglePanel: (id: PanelId) => void;
+    setZoneVisible: (zone: PanelZone, visible: boolean) => void;
+    resetLayout: () => void;
+}
+declare const useDockLayoutStore: zustand.UseBoundStore<zustand.StoreApi<DockLayoutState>>;
+
 interface AudioWaveformProps {
     audioUrl: string;
     waveformUrl?: string;
@@ -2524,6 +2586,13 @@ declare function findElementBlock(html: string, elementId: string): {
     isSelfClosing: boolean;
 } | null;
 
+/** One file's restore from the edit-history store: before (live) / after (target) bytes. */
+interface UndoRestoreFile {
+    previous: string;
+    restored: string;
+}
+type RestoreFiles = Record<string, UndoRestoreFile>;
+
 interface RecordEditInput$4 {
     label: string;
     coalesceKey?: string;
@@ -2540,10 +2609,6 @@ interface ApplyCallbacks {
 interface UsePersistentEditHistoryOptions {
     projectId: string | null;
 }
-interface ApplyRestoredFile {
-    previous: string;
-    restored: string;
-}
 interface ApplyResult {
     ok: boolean;
     /** content-mismatch: `paths` changed after the step's entry. failed: `message` says why. */
@@ -2551,7 +2616,8 @@ interface ApplyResult {
     message?: string;
     label?: string;
     paths?: string[];
-    files?: Record<string, ApplyRestoredFile>;
+    undoes?: string;
+    files?: RestoreFiles;
 }
 /** Studio's undo over the server's project history: an edit claims what it wrote; Cmd+Z steps the person's. */
 declare function usePersistentEditHistory({ projectId }: UsePersistentEditHistoryOptions): {
@@ -2573,6 +2639,11 @@ declare function usePersistentEditHistory({ projectId }: UsePersistentEditHistor
     recordEdit: ({ label, coalesceKey, coalesceMs, files }: RecordEditInput$4) => Promise<void>;
     undo: (callbacks: ApplyCallbacks) => Promise<ApplyResult>;
     redo: (callbacks: ApplyCallbacks) => Promise<ApplyResult>;
+    predict: (direction: "undo" | "redo") => {
+        id: string;
+        files: RestoreFiles;
+    } | null;
+    noteOutsideChange: () => void;
 };
 
 /** The files an undo or redo rewrote. */
@@ -2653,11 +2724,9 @@ interface HistoryResult {
     message?: string;
     label?: string;
     paths?: string[];
+    undoes?: string;
     /** Per-file restored/previous content, used to soft-apply the preview. */
-    files?: Record<string, {
-        previous: string;
-        restored: string;
-    }>;
+    files?: RestoreFiles;
 }
 interface HistoryFileCallbacks {
     readFile: (path: string) => Promise<string>;
@@ -2666,6 +2735,10 @@ interface HistoryFileCallbacks {
 interface EditHistoryHandle {
     undo: (cb: HistoryFileCallbacks) => Promise<HistoryResult>;
     redo: (cb: HistoryFileCallbacks) => Promise<HistoryResult>;
+    predict?: (direction: "undo" | "redo") => {
+        id: string;
+        files: RestoreFiles;
+    } | null;
     state: {
         undo: ReadonlyArray<{
             createdAt: number;
@@ -2676,12 +2749,13 @@ interface EditHistoryHandle {
     };
 }
 interface UseEditHistoryActionsOptions {
-    editHistory: Pick<EditHistoryHandle, "undo" | "redo">;
+    editHistory: Pick<EditHistoryHandle, "undo" | "redo" | "predict">;
     readOptionalProjectFile: (path: string) => Promise<string>;
     readProjectFile: (path: string) => Promise<string>;
     writeProjectFile: (path: string, content: string) => Promise<void>;
     showToast: (message: string, tone?: "error" | "info") => void;
     syncHistoryPreviewAfterApply: (restore: Pick<HistoryResult, "paths" | "files">) => Promise<void>;
+    showHistoryRestoreNow?: (files: RestoreFiles) => (() => void) | null;
     waitForPendingDomEditSaves: () => Promise<void>;
     onAfterUndoRedo?: (restore: Pick<HistoryResult, "paths" | "files">) => void;
     /** Active composition path — decides whether undo/redo must resync the SDK session. */
@@ -2690,7 +2764,7 @@ interface UseEditHistoryActionsOptions {
     forceReloadSdkSession?: () => void;
 }
 /** Takes one step of the project's history: the single owner of undo/redo over project files. */
-declare function useEditHistoryActions({ editHistory, readOptionalProjectFile, readProjectFile, writeProjectFile, showToast, syncHistoryPreviewAfterApply, waitForPendingDomEditSaves, onAfterUndoRedo, activeCompPath, forceReloadSdkSession, }: UseEditHistoryActionsOptions): {
+declare function useEditHistoryActions({ editHistory, readOptionalProjectFile, readProjectFile, writeProjectFile, showToast, syncHistoryPreviewAfterApply, showHistoryRestoreNow, waitForPendingDomEditSaves, onAfterUndoRedo, activeCompPath, forceReloadSdkSession, }: UseEditHistoryActionsOptions): {
     undo: () => Promise<void>;
     redo: () => Promise<void>;
 };
@@ -3103,21 +3177,16 @@ declare function useDomEditSession({ projectId, activeCompPath, compIdToSrc, cap
 interface DomEditSaveQueue {
     enqueue: <T>(save: () => Promise<T>) => Promise<T>;
     waitForIdle: () => Promise<DomEditSaveDrainResult>;
+    isIdle: () => boolean;
     reset: () => void;
     destroy: () => void;
 }
 type DomEditSaveDrainResult = StudioSaveDrainResult;
 
-/** One file's restore from the edit-history store: before (live) / after (target) bytes. */
-interface UndoRestoreFile {
-    previous: string;
-    restored: string;
-}
-
 /** The restore payload the undo/redo preview-sync consumes (from the history store). */
 interface HistoryPreviewRestore {
     paths?: string[];
-    files?: Record<string, UndoRestoreFile>;
+    files?: RestoreFiles;
 }
 interface RecordEditInput$1 {
     label: string;
@@ -3157,6 +3226,7 @@ declare function usePreviewPersistence({ showToast, readOptionalProjectFile: _re
     applyCurrentStudioManualEditsToPreview: (iframe?: HTMLIFrameElement | null) => void;
     applyStudioManualEditsToPreview: (iframe?: HTMLIFrameElement | null) => Promise<void>;
     syncHistoryPreviewAfterApply: (restore: HistoryPreviewRestore) => Promise<void>;
+    showHistoryRestoreNow: (files: RestoreFiles) => (() => void) | null;
 };
 
 type DomEditValue = ReturnType<typeof useDomEditSession>;
@@ -3434,6 +3504,16 @@ interface ConnectedDomEditOverlayProps extends HostInputProps {
 }
 declare function ConnectedDomEditOverlay({ activeCompositionPath, showHoverSelection, shouldShowSelectedDomBounds, isGestureRecording, canvasInput, allowBodyDrag, onTextEditingChange, onSelectionBoxClick, }: ConnectedDomEditOverlayProps): react_jsx_runtime.JSX.Element;
 
+interface DomEditZOrder {
+    /** False in a read-only preview, for an element no longer in the live preview, or at that end of its stacking set. */
+    enabled: (sel: DomEditSelection, action: ZOrderAction) => boolean;
+    /** Resolve and commit one step; false when nothing is sent to be saved. */
+    apply: (sel: DomEditSelection, action: ZOrderAction) => boolean;
+    /** Commit patches already resolved (the canvas menu resolves its own); false when none could be sent to be saved. */
+    commit: (sel: DomEditSelection, patches: ReadonlyArray<ZOrderPatch>, action: ZOrderAction, crossed: HTMLElement | null) => boolean;
+}
+declare function useDomEditZOrder(): DomEditZOrder;
+
 interface RecordEditInput {
     label: string;
     coalesceKey?: string;
@@ -3536,4 +3616,4 @@ interface MarqueeOverlayProps {
  */
 declare function MarqueeOverlay({ candidateRects, marqueeRect }: MarqueeOverlayProps): react_jsx_runtime.JSX.Element;
 
-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, type DomEditCapabilities, type DomEditCommitDeclineReason, type DomEditCommitOutcome, type DomEditGroupPathOffsetCommit, DomEditOverlay, type DomEditOverlayProps, DomEditProvider, type DomEditSelection, 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, NLEPreview, type PatchOperation, type PersistedRenderSettings, type PickedElement, PlayerControls, type PlayerHandle, type PlayerHandleElement, type PlayerHandleListener, type PlayerHandleTimeListener, type DomEditCompositionRect as PreviewCompositionRect, PreviewGuides, PreviewOverlayProvider, type PreviewOverlayProviderProps, 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, StudioApp, StudioFileConflictError, 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 UseClipboardOptions, type UseDomEditSessionParams, type UseDomGeometryCommitOptions, type UseDomStyleCommitOptions, type UseEditHistoryActionsOptions, type UsePersistentEditHistoryOptions, type UsePreviewPersistenceParams, type UseProjectFileWriterOptions, type UseRenderClipContentOptions, type UseTimelineEditingOptions, VideoThumbnail, applyPatch, buildCompositionSnapTarget, buildGridSnapEdges, buildPickerAgentContextPreview, buildPickerAgentPrompt, collectSnapContext, extractSnapTargets, findElementBlock, flushStudioPendingEdits, formatTime, getPersistedRenderSettings, liveTime, mergeStyleIntoTag, parseStyleString, persistRenderSettings, resolveDomEditSelection, resolveEquidistanceGuides, resolveGuideLineRect, resolveIframe, resolveSnapAdjustment, resolveSourceFile, snapEngagedForTravel, useClipboard, useCompositionStack, useDomEditSelectionContext, useDomEditSession, useDomGeometryCommit, useDomStyleCommit, useEditHistoryActions, useElementPicker, 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, 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, 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, StudioApp, StudioFileConflictError, 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 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, collectSnapContext, extractSnapTargets, findElementBlock, flushStudioPendingEdits, formatTime, getPersistedRenderSettings, liveTime, mergeStyleIntoTag, parseStyleString, persistRenderSettings, resolveDomEditSelection, resolveEquidistanceGuides, resolveGuideLineRect, resolveIframe, resolveSnapAdjustment, resolveSourceFile, snapEngagedForTravel, useClipboard, useCompositionStack, useDockLayoutStore, useDomEditSelectionContext, useDomEditSession, useDomEditZOrder, useDomGeometryCommit, useDomStyleCommit, useEditHistoryActions, useElementPicker, useMarqueeGestures, usePersistentEditHistory, usePlayerHandle, usePlayerStore, usePreviewCompositionRect, usePreviewGuidesStore, usePreviewOverlayContext, usePreviewPersistence, useProjectFileWriter, useRenderClipContent, useRenderQueue, useTimelineContext, useTimelineEditing, useTimelinePlayer };

package/dist/studio/index.html

@@ -5,7 +5,7 @@
     <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-D6TjRAvz.js"></script>
+    <script type="module" crossorigin src="/assets/index-C2utDZt-.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-xB5O0hPw.css">
   </head>
   <body>