@hyperframes/studio 0.8.114 → 0.8.116

package/dist/index.d.ts

@@ -386,6 +386,16 @@ interface TimelineElement {
     authoredStartIsMasterTime?: boolean;
     /** Legacy marker for an inline sub-composition child; current rows never set it. */
     expandedHostKey?: string;
+    /** A text layer's words and look, which its row draws live instead of a captured picture. */
+    text?: TimelineText;
+}
+interface TimelineText {
+    value: string;
+    fontFamily?: string;
+    fontWeight?: string;
+    color?: string;
+    /** The layer's own opaque background colour, when it paints one. */
+    background?: string;
 }
 /**
  * The fields `updateElement` may write.
@@ -399,7 +409,7 @@ interface TimelineElement {
  * write has to be able to land here or the header goes on rendering whatever it
  * parsed at load.
  */
-type TimelineElementPatch = Partial<Pick<TimelineElement, "start" | "duration" | "track" | "zIndex" | "hasExplicitZIndex" | "playbackStart" | "hidden" | "audioGroup" | "audioGroupLabel" | "audioGroupVolume" | "audioGroupHidden" | "audioGroupFxChain" | "audioGroupAutomation">>;
+type TimelineElementPatch = Partial<Pick<TimelineElement, "start" | "duration" | "track" | "zIndex" | "hasExplicitZIndex" | "playbackStart" | "hidden" | "audioGroup" | "audioGroupLabel" | "audioGroupVolume" | "audioGroupHidden" | "audioGroupFxChain" | "audioGroupAutomation" | "text">>;
 /**
  * The `data-*` state an expanded sub-composition child needs but cannot reach.
  *
@@ -805,7 +815,7 @@ interface TimelineStackingReorderIntent {
     zIndexChanges: TimelineStackingZIndexChange[];
 }
 
-type BlockedTimelineEditIntent = "move" | "resize-start" | "resize-end";
+type BlockedTimelineEditIntent = "move" | "edit-many" | "resize-start" | "resize-end";
 interface TimelineRangeSelection {
     start: number;
     end: number;
@@ -926,9 +936,12 @@ type RuntimeTweenChange = {
     props: SetPatchProps;
 };
 
+type KeyframeUsageAction = "add" | "convert" | "remove_all" | "reset";
+
 interface MutationResult {
     ok: boolean;
     changed?: boolean;
+    mutationChanges?: boolean[];
     parsed?: ParsedGsap;
     before?: string;
     after?: string;
@@ -936,6 +949,9 @@ interface MutationResult {
 }
 interface CommitMutationOptions {
     label: string;
+    keyframeTelemetry?: boolean;
+    keyframeAction?: KeyframeUsageAction;
+    keyframeProperty?: string;
     /** Observe the durable writer result without duplicating the request path. */
     onResult?: (result: MutationResult) => void;
     coalesceKey?: string;
@@ -1143,6 +1159,7 @@ interface TimelineEditCallbacks {
     onRazorSplit?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
     onRazorSplitAll?: (splitTime: number) => Promise<void> | void;
     onFreezeFrame?: (element: TimelineElement, time: number) => Promise<void> | void;
+    clipMenuTools?: boolean;
     onNotice?: (message: string, tone?: "error" | "info") => void;
     onDeleteKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
     onDeleteAllKeyframes?: (element: TimelineElement, animationId?: string) => void;
@@ -2015,9 +2032,31 @@ interface PreviewCompositionSize {
     height: number;
 }
 
-interface NLEPreviewProps {
+interface CompositionLevel {
+    /** Unique id — "master" or composition file path */
+    id: string;
+    /** Display label — "Master" or filename without extension */
+    label: string;
+    /** Preview URL for this composition level */
+    previewUrl: string;
+}
+interface CompositionBreadcrumbProps {
+    stack: CompositionLevel[];
+    onNavigate: (index: number) => void;
+}
+declare function CompositionBreadcrumb({ stack, onNavigate }: CompositionBreadcrumbProps): react_jsx_runtime.JSX.Element | null;
+
+interface NLEContextValue {
     projectId: string;
-    iframeRef: RefObject<HTMLIFrameElement | null>;
+    iframeRef: React.MutableRefObject<HTMLIFrameElement | null>;
+    play: () => void;
+    pause: () => void;
+    togglePlay: () => void;
+    seek: (time: number, options?: {
+        keepPlaying?: boolean;
+        follow?: boolean;
+    }) => boolean;
+    refreshPlayer: () => void;
     onIframeLoad: () => void;
     previewSlots: PreviewIframeSlot[];
     onShadowIframeLoad: (gen: number) => void;
@@ -2025,6 +2064,29 @@ interface NLEPreviewProps {
     onShadowError: (gen: number, message: string) => void;
     setShadowIframeNode: (node: HTMLIFrameElement | null) => void;
     resetPreviewSlots: () => void;
+    containerRef: React.MutableRefObject<HTMLDivElement | null>;
+    compositionStack: CompositionLevel[];
+    updateCompositionStack: React.Dispatch<React.SetStateAction<CompositionLevel[]>>;
+    handleNavigateComposition: (index: number) => void;
+    handleDrillDown: (element: TimelineElement) => void;
+    compIdToSrc: Map<string, string>;
+    compositionLoading: boolean;
+    setCompositionLoading: (loading: boolean) => void;
+    timelineDisabled: boolean;
+    timelineSessionEpoch: number;
+    hasLoadedOnceRef: React.MutableRefObject<boolean>;
+    previewCompositionSize: {
+        width: number;
+        height: number;
+    } | null;
+    setPreviewCompositionSize: (size: {
+        width: number;
+        height: number;
+    } | null) => void;
+}
+
+interface NLEPreviewProps extends Pick<NLEContextValue, "projectId" | "onIframeLoad" | "previewSlots" | "onShadowIframeLoad" | "onShadowReadyChange" | "onShadowError" | "setShadowIframeNode" | "resetPreviewSlots"> {
+    iframeRef: RefObject<HTMLIFrameElement | null>;
     onCompositionLoadingChange?: (loading: boolean) => void;
     portrait?: boolean;
     directUrl?: string;
@@ -2044,20 +2106,6 @@ interface ShortcutsButtonProps {
 }
 declare function ShortcutsButton({ sections, disabled, onSeek }: ShortcutsButtonProps): react_jsx_runtime.JSX.Element;
 
-interface CompositionLevel {
-    /** Unique id — "master" or composition file path */
-    id: string;
-    /** Display label — "Master" or filename without extension */
-    label: string;
-    /** Preview URL for this composition level */
-    previewUrl: string;
-}
-interface CompositionBreadcrumbProps {
-    stack: CompositionLevel[];
-    onNavigate: (index: number) => void;
-}
-declare function CompositionBreadcrumb({ stack, onNavigate }: CompositionBreadcrumbProps): react_jsx_runtime.JSX.Element | null;
-
 interface UseCompositionStackOptions {
     projectId: string;
     activeCompositionPath?: string | null;
@@ -2226,6 +2274,21 @@ declare function useRenderClipContent({ projectIdRef, compIdToSrc, activePreview
     label: string;
 }, context?: TimelineClipRenderContext) => ReactNode;
 
+interface UseThumbnailStillOptions {
+    sessionEpoch?: number;
+    priority?: ThumbnailPriority;
+}
+type ThumbnailStill = {
+    status: "loading";
+} | {
+    status: "ready";
+    url: string;
+} | {
+    status: "failed";
+};
+/** A host picture's server still through the thumbnail scheduler, so it yields to a preview reload. */
+declare function useThumbnailStill(url: string | null, projectId: string, { sessionEpoch, priority }?: UseThumbnailStillOptions): ThumbnailStill;
+
 interface DomEditCompositionRect {
     left: number;
     top: number;
@@ -2293,6 +2356,11 @@ interface SourceEditorProps {
 }
 declare const SourceEditor: react.NamedExoticComponent<SourceEditorProps>;
 
+interface GeometryCommitResult {
+    ok: true;
+    changed: boolean;
+}
+
 /**
  * Edit callbacks shared by GsapAnimationSection and each AnimationCard it
  * renders. Extracted so the two prop interfaces don't duplicate the (large)
@@ -2391,14 +2459,14 @@ interface PropertyPanelProps {
         y: number;
     }, route?: {
         plainTranslate: boolean;
-    }) => void | Promise<void>;
+    }) => void | Promise<void | GeometryCommitResult>;
     onSetManualSize: (element: DomEditSelection, next: {
         width: number;
         height: number;
-    }) => void | Promise<void>;
+    }) => void | Promise<void | GeometryCommitResult>;
     onSetManualRotation: (element: DomEditSelection, next: {
         angle: number;
-    }) => void | Promise<void>;
+    }) => void | Promise<void | GeometryCommitResult>;
     onSetText: (value: string, fieldKey?: string) => void;
     onSetTextFieldStyle: (fieldKey: string, property: string, value: string) => void;
     onPreviewTextFieldStyle?: (fieldKey: string, property: string, value: string) => void;
@@ -2711,6 +2779,7 @@ interface RecordEditInput$4 {
 interface ApplyCallbacks {
     readFile: (path: string) => Promise<string>;
     serialize?: <T>(paths: readonly string[], task: () => Promise<T>) => Promise<T>;
+    claimedAfter?: number;
 }
 interface UsePersistentEditHistoryOptions {
     projectId: string | null;
@@ -2749,6 +2818,7 @@ declare function usePersistentEditHistory({ projectId }: UsePersistentEditHistor
         id: string;
         files: RestoreFiles;
     } | null;
+    claims: () => number;
     noteOutsideChange: () => void;
 };
 
@@ -2793,7 +2863,7 @@ declare function useTimelineEditing({ projectId, activeCompPath, timelineElement
     handleTimelineAssetDrop: (assetPath: string, placement: TimelineDropPlacement, durationOverride?: number | undefined) => Promise<void>;
     handleTimelineFileDrop: (files: File[], placement?: TimelineDropPlacement | undefined) => Promise<void>;
     handleTimelineCompositionDrop: (sourcePath: string, placement: Pick<TimelineElement, "track" | "start">) => Promise<void>;
-    handleBlockedTimelineEdit: (element: TimelineElement) => void;
+    handleBlockedTimelineEdit: (element: TimelineElement, intent: BlockedTimelineEditIntent) => void;
     handleTimelineGroupMove: (changes: TimelineGroupMoveChange[], options?: TimelineGroupCommitOptions | undefined) => Promise<void>;
     handleTimelineGroupResize: (changes: TimelineGroupResizeChange[], options?: TimelineGroupCommitOptions | undefined) => Promise<void>;
     restoreLiveLanes: (restore: Parameters<(restore: LiveLaneRestore) => void>[0]) => void;
@@ -2830,7 +2900,9 @@ type StudioSaveDrainResult<Failure = unknown> = {
 
 type StudioPendingEditsDrainResult = StudioSaveDrainResult;
 declare function revertNewestStudioPendingEdit(): (() => void) | null;
-declare function flushStudioPendingEdits(): Promise<StudioPendingEditsDrainResult>;
+declare function flushStudioPendingEdits({ onlyCurrent, }?: {
+    onlyCurrent?: boolean | undefined;
+}): Promise<StudioPendingEditsDrainResult>;
 
 interface HistoryResult {
     ok: boolean;
@@ -2845,6 +2917,7 @@ interface HistoryResult {
 interface HistoryFileCallbacks {
     readFile: (path: string) => Promise<string>;
     serialize?: <T>(paths: readonly string[], task: () => Promise<T>) => Promise<T>;
+    claimedAfter?: number;
 }
 interface EditHistoryHandle {
     undo: (cb: HistoryFileCallbacks) => Promise<HistoryResult>;
@@ -2853,6 +2926,7 @@ interface EditHistoryHandle {
         id: string;
         files: RestoreFiles;
     } | null;
+    claims?: () => number;
     state: {
         undo: ReadonlyArray<{
             createdAt: number;
@@ -2863,7 +2937,7 @@ interface EditHistoryHandle {
     };
 }
 interface UseEditHistoryActionsOptions {
-    editHistory: Pick<EditHistoryHandle, "undo" | "redo" | "predict">;
+    editHistory: Pick<EditHistoryHandle, "undo" | "redo" | "predict" | "claims">;
     readOptionalProjectFile: (path: string) => Promise<string>;
     readProjectFile: (path: string) => Promise<string>;
     writeProjectFile: (path: string, content: string) => Promise<void>;
@@ -3190,6 +3264,10 @@ interface SnapGuideOverlayProps {
 }
 declare const SnapGuideOverlay: react.NamedExoticComponent<SnapGuideOverlayProps>;
 
+interface DomSelectionResult {
+    changed: boolean;
+    count: number;
+}
 interface ApplyDomSelectionOptions {
     revealPanel?: boolean;
     additive?: boolean;
@@ -3250,6 +3328,7 @@ type DomEditCommitDeclineReason = "no-project" | "no-selection" | "geometry-prop
 type DomEditCommitOutcome = {
     ok: true;
     persistence?: DomEditPersistOutcome;
+    changed?: boolean;
 } | {
     ok: false;
     reason: DomEditCommitDeclineReason;
@@ -3273,6 +3352,15 @@ interface RecordEditInput$2 {
     }>;
 }
 
+interface DomGroupMove {
+    selection: DomEditSelection;
+    /** Composition px: the element's box moves by exactly this in the film. */
+    delta: {
+        x: number;
+        y: number;
+    };
+}
+
 interface UseDomEditSessionParams extends DomEditTimelineParams {
     compositionLoading: boolean;
     showToast: (message: string, tone?: "error" | "info") => void;
@@ -3326,7 +3414,7 @@ declare function useDomEditSession({ projectId, activeCompPath, compIdToSrc, cap
     clearDomSelection: () => void;
     refreshDomEditSelectionFromPreview: (selection: DomEditSelection) => Promise<void>;
     handleDomStyleCommit: (property: string, value: string) => Promise<DomEditCommitOutcome>;
-    handleDomStyleCommitForSelection: (selection: DomEditSelection, property: string, value: string) => Promise<DomEditCommitOutcome>;
+    handleDomStyleCommitForSelection: (selection: DomEditSelection, propertyOrStylesAsOnePatch: string | Record<string, string>, value?: string) => Promise<DomEditCommitOutcome>;
     handleDomAttributeCommit: (attr: string, value: string) => Promise<void>;
     handleDomAttributeLiveCommit: (attr: string, value: string | null, onSettled?: (ok: boolean) => void, live?: {
         previewOnly?: boolean;
@@ -3338,8 +3426,11 @@ declare function useDomEditSession({ projectId, activeCompPath, compIdToSrc, cap
     handleDomPathOffsetCommit: (selection: DomEditSelection, next: {
         x: number;
         y: number;
-    }, modifiers?: MoveCommitOptions) => Promise<void>;
-    handleDomGroupPathOffsetCommit: (updates: DomEditGroupPathOffsetCommit[]) => Promise<void>;
+    }, modifiers?: MoveCommitOptions) => Promise<GeometryCommitResult | undefined>;
+    handleDomGroupPathOffsetCommit: (updates: DomEditGroupPathOffsetCommit[], options?: {
+        refusalToast?: boolean;
+    }) => Promise<GeometryCommitResult>;
+    handleDomGroupMoveBy: (moves: DomGroupMove[]) => Promise<void>;
     handleDomZIndexReorderCommit: (entries: Array<{
         element: HTMLElement;
         zIndex: number;
@@ -3355,9 +3446,9 @@ declare function useDomEditSession({ projectId, activeCompPath, compIdToSrc, cap
     }, offset?: {
         x: number;
         y: number;
-    }, restore?: () => void) => Promise<void>;
-    handleDomRotationCommit: (selection: DomEditSelection, next: RotationCommit) => Promise<void>;
-    handleDomManualEditsReset: (selection: DomEditSelection) => Promise<void>;
+    }, restore?: () => void) => Promise<GeometryCommitResult>;
+    handleDomRotationCommit: (selection: DomEditSelection, next: RotationCommit) => Promise<GeometryCommitResult | undefined>;
+    handleDomManualEditsReset: (selection: DomEditSelection) => Promise<DomEditPersistOutcome | undefined>;
     handleDomTextCommit: (value: string, fieldKey?: string) => Promise<DomEditCommitOutcome>;
     handleDomTextCommitForSelection: (selection: DomEditSelection, value: string, fieldKey?: string) => Promise<DomEditCommitOutcome>;
     handleDomRichTextCommit: ({ element, html, previousHtml }: InlineTextEditCommit) => Promise<void>;
@@ -3378,7 +3469,7 @@ declare function useDomEditSession({ projectId, activeCompPath, compIdToSrc, cap
     buildDomSelectionFromTarget: (target: HTMLElement, options?: ResolveDomSelectionOptions) => Promise<DomEditSelection | null>;
     buildDomSelectionForTimelineElement: (element: TimelineElement) => Promise<DomEditSelection | null>;
     updateDomEditHoverSelection: (selection: DomEditSelection | null) => void;
-    applyMarqueeSelection: (selections: DomEditSelection[], additive: boolean) => void;
+    applyMarqueeSelection: (selections: DomEditSelection[], additive: boolean) => DomSelectionResult;
     resolveImportedFontAsset: (fontFamilyValue: string) => ImportedFontAsset | null;
     setAgentModalOpen: react.Dispatch<react.SetStateAction<boolean>>;
     setAgentPromptSelectionContext: react.Dispatch<react.SetStateAction<string | undefined>>;
@@ -3410,7 +3501,7 @@ declare function useDomEditSession({ projectId, activeCompPath, compIdToSrc, cap
         to: number;
     }>, selectionOverride?: DomEditSelection | null) => Promise<boolean>;
     handleGsapConvertToKeyframes: (animId: string, resolvedFromValues?: Record<string, number | string>, duration?: number, commitOverrides?: Partial<CommitMutationOptions>, selectionOverride?: DomEditSelection | null) => Promise<void>;
-    handleGsapRemoveAllKeyframes: (animId: string, selectionOverride?: DomEditSelection | null) => Promise<boolean>;
+    handleGsapRemoveAllKeyframes: (animId: string, selectionOverride?: DomEditSelection | null, telemetry?: boolean) => Promise<boolean>;
     handleResetSelectedElementKeyframes: () => boolean;
     handleUpdateKeyframeEase: (animationId: string, percentage: number, ease: string) => void;
     handleUpdateSegmentEase: (targets: AnimationKeyframeTarget[], ease: string) => void;
@@ -3446,10 +3537,7 @@ declare function useDomEditSession({ projectId, activeCompPath, compIdToSrc, cap
     handleUnroll: () => void;
     invalidateGsapCache: () => void;
     previewIframeRef: react.MutableRefObject<HTMLIFrameElement | null>;
-    commitMutation: (mutation: Record<string, unknown>, options: {
-        label: string;
-        softReload?: boolean;
-    }) => Promise<void>;
+    commitMutation: (mutation: Record<string, unknown>, options: CommitMutationOptions, selection?: DomEditSelection | null) => Promise<void>;
 };
 
 /** The one source for which preview is on screen: the host's iframe, then each reload promoted in its place. */
@@ -3520,7 +3608,7 @@ type DomEditValue = ReturnType<typeof useDomEditSession>;
 interface DomEditSelectionValue extends Pick<DomEditValue, "domEditSelection" | "domEditGroupSelections" | "domEditHoverSelection" | "activeGroupElement" | "domEditSelectionRef" | "selectedGsapAnimations" | "gsapMultipleTimelines" | "gsapUnsupportedTimelinePattern" | "agentModalOpen" | "agentModalAnchorPoint" | "copiedAgentPrompt" | "agentPromptSelectionContext"> {
 }
 declare function useDomEditSelectionContext(): DomEditSelectionValue;
-declare function DomEditProvider({ value: { domEditSelection, domEditGroupSelections, domEditHoverSelection, agentModalOpen, agentModalAnchorPoint, copiedAgentPrompt, agentPromptSelectionContext, domEditSelectionRef, handleTimelineElementSelect, handlePreviewCanvasMouseDown, handlePreviewCanvasPointerMove, handlePreviewCanvasPointerLeave, applyDomSelection, clearDomSelection, refreshDomEditSelectionFromPreview, handleDomStyleCommit, handleDomStyleCommitForSelection, handleDomAttributeCommit, handleDomAttributeLiveCommit, handleDomAttributeQuietCommit, handleDomHtmlAttributeCommit, handleDomAttributesCommit, handleDomAttributeBatchCommit, handleDomPathOffsetCommit, handleDomGroupPathOffsetCommit, handleDomZIndexReorderCommit, handleDomBoxSizeCommit, handleDomRotationCommit, handleDomManualEditsReset, handleDomTextCommit, handleDomTextCommitForSelection, handleDomRichTextCommit, handleDomTextFieldStyleCommit, handleDomAddTextField, handleDomRemoveTextField, getGsapAnimationsForSelection, handleAskAgent, handleAgentModalSubmit, handleBlockedDomMove, handleDomManualDragStart, handleDomEditElementDelete, handleGroupSelection, handleUngroupSelection, setActiveGroupElement, activeGroupElement, buildDomSelectionFromTarget, buildDomSelectionForTimelineElement, updateDomEditHoverSelection, resolveImportedFontAsset, setAgentModalOpen, setAgentPromptSelectionContext, setAgentModalAnchorPoint, selectedGsapAnimations, gsapMultipleTimelines, gsapUnsupportedTimelinePattern, handleGsapUpdateProperty, handleGsapUpdateMeta, handleGsapDeleteAnimation, handleGsapDeleteAllForElement, handleGsapAddAnimation, handleGsapAddProperty, handleGsapRemoveProperty, handleGsapUpdateFromProperty, handleGsapAddFromProperty, handleGsapRemoveFromProperty, handleGsapAddKeyframe, handleGsapAddKeyframeBatch, handleGsapRemoveKeyframe, handleGsapMoveKeyframeToPlayhead, handleGsapMoveKeyframe, handleGsapResizeKeyframedTween, handleGsapConvertToKeyframes, handleGsapRemoveAllKeyframes, handleResetSelectedElementKeyframes, commitAnimatedProperty, commitAnimatedProperties, handleSetArcPath, handleUpdateArcSegment, handleUnroll, invalidateGsapCache, previewIframeRef, commitMutation, applyMarqueeSelection, handleUpdateKeyframeEase, handleUpdateSegmentEase, handleSetAllKeyframeEases, }, children, }: {
+declare function DomEditProvider({ value: { domEditSelection, domEditGroupSelections, domEditHoverSelection, agentModalOpen, agentModalAnchorPoint, copiedAgentPrompt, agentPromptSelectionContext, domEditSelectionRef, handleTimelineElementSelect, handlePreviewCanvasMouseDown, handlePreviewCanvasPointerMove, handlePreviewCanvasPointerLeave, applyDomSelection, clearDomSelection, refreshDomEditSelectionFromPreview, handleDomStyleCommit, handleDomStyleCommitForSelection, handleDomAttributeCommit, handleDomAttributeLiveCommit, handleDomAttributeQuietCommit, handleDomHtmlAttributeCommit, handleDomAttributesCommit, handleDomAttributeBatchCommit, handleDomPathOffsetCommit, handleDomGroupPathOffsetCommit, handleDomGroupMoveBy, handleDomZIndexReorderCommit, handleDomBoxSizeCommit, handleDomRotationCommit, handleDomManualEditsReset, handleDomTextCommit, handleDomTextCommitForSelection, handleDomRichTextCommit, handleDomTextFieldStyleCommit, handleDomAddTextField, handleDomRemoveTextField, getGsapAnimationsForSelection, handleAskAgent, handleAgentModalSubmit, handleBlockedDomMove, handleDomManualDragStart, handleDomEditElementDelete, handleGroupSelection, handleUngroupSelection, setActiveGroupElement, activeGroupElement, buildDomSelectionFromTarget, buildDomSelectionForTimelineElement, updateDomEditHoverSelection, resolveImportedFontAsset, setAgentModalOpen, setAgentPromptSelectionContext, setAgentModalAnchorPoint, selectedGsapAnimations, gsapMultipleTimelines, gsapUnsupportedTimelinePattern, handleGsapUpdateProperty, handleGsapUpdateMeta, handleGsapDeleteAnimation, handleGsapDeleteAllForElement, handleGsapAddAnimation, handleGsapAddProperty, handleGsapRemoveProperty, handleGsapUpdateFromProperty, handleGsapAddFromProperty, handleGsapRemoveFromProperty, handleGsapAddKeyframe, handleGsapAddKeyframeBatch, handleGsapRemoveKeyframe, handleGsapMoveKeyframeToPlayhead, handleGsapMoveKeyframe, handleGsapResizeKeyframedTween, handleGsapConvertToKeyframes, handleGsapRemoveAllKeyframes, handleResetSelectedElementKeyframes, commitAnimatedProperty, commitAnimatedProperties, handleSetArcPath, handleUpdateArcSegment, handleUnroll, invalidateGsapCache, previewIframeRef, commitMutation, applyMarqueeSelection, handleUpdateKeyframeEase, handleUpdateSegmentEase, handleSetAllKeyframeEases, }, children, }: {
     value: DomEditValue;
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
@@ -3620,7 +3708,7 @@ interface DomEditOverlayProps {
     onStyleCommit?: (property: string, value: string) => Promise<unknown> | void;
     recordingState?: GestureRecordingState;
     onToggleRecording?: () => void;
-    onMarqueeSelect?: (selections: DomEditSelection[], additive: boolean) => void;
+    onMarqueeSelect?: (selections: DomEditSelection[], additive: boolean) => DomSelectionResult | void;
     /**
      * Delete the selected canvas element.
      * Wire to handleDomEditElementDelete from useDomEditActionsContext —
@@ -3688,6 +3776,24 @@ declare function useDomStyleCommit({ projectId, iframeRef, writeProjectFile, rec
     waitForPendingSaves: () => Promise<DomEditSaveDrainResult>;
 };
 
+declare function ColorField({ label, value, disabled, onReset, flat, mixed, onPreview, onCommit, }: {
+    label: string;
+    value: string;
+    disabled?: boolean;
+    onReset?: () => void;
+    flat?: boolean;
+    mixed?: boolean;
+    onPreview?: (nextValue: string) => void;
+    onCommit: (nextValue: string) => void;
+}): react_jsx_runtime.JSX.Element;
+
+declare function GradientField({ value, fallbackColor, disabled, onCommit, }: {
+    value: string;
+    fallbackColor: string | undefined;
+    disabled?: boolean;
+    onCommit: (nextValue: string) => void;
+}): react_jsx_runtime.JSX.Element;
+
 /**
  * Studio's `Player` must show the project, with `beginTimelineSession(projectId)` run before it
  * mounts; drain `waitForPendingSaves` before switching projects.
@@ -3722,7 +3828,7 @@ interface MarqueeGesturesDeps<T = DomEditSelection> {
     iframeRef: React.RefObject<HTMLIFrameElement | null>;
     overlayRef: React.RefObject<HTMLDivElement | null>;
     activeCompositionPathRef: React.RefObject<string | null>;
-    onMarqueeSelectRef: React.RefObject<((selections: T[], additive: boolean) => void) | undefined>;
+    onMarqueeSelectRef: React.RefObject<((selections: T[], additive: boolean) => DomSelectionResult | void) | undefined>;
     /** Turns the elements a drag touched into picks; without it, Studio's edit selections. */
     resolveHits?: (elements: HTMLElement[]) => T[] | Promise<T[]>;
     selectionRef?: React.RefObject<DomEditSelection | null>;
@@ -4095,4 +4201,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 FadeEdge, type FadeHandleBox, type FadeHandleClipBox, 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, displayTrackOrder, extractSnapTargets, fadeHandleBoxes, findElementBlock, flushStudioPendingEdits, formatTime, getPersistedRenderSettings, liveTime, mergeStyleIntoTag, openAudioGainDialog, parseStyleString, persistRenderSettings, resolveDomEditSelection, resolveEquidistanceGuides, resolveGuideLineRect, resolveIframe, resolveSnapAdjustment, resolveSourceFile, revertNewestStudioPendingEdit, 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 };
+export { type AgentModalAnchorPoint, type AgentPromptElementInfo, AskAgentModal, type AskAgentModalProps, AudioMeterStrip, type AudioMeterStripProps, AudioWaveform, type AudioWaveformProps, type BlockedTimelineEditIntent, type CanEditTimelineElement, ColorField, 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 FadeEdge, type FadeHandleBox, type FadeHandleClipBox, type FfmpegStatus, FileTree, GradientField, 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, type ThumbnailStill, 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 UseThumbnailStillOptions, type UseTimelineEditingOptions, VideoThumbnail, type ZOrderAction, applyPatch, buildCompositionSnapTarget, buildGridSnapEdges, buildPickerAgentContextPreview, buildPickerAgentPrompt, buildStudioTools, collectSnapContext, collectStudioLookScene, displayTrackOrder, extractSnapTargets, fadeHandleBoxes, findElementBlock, flushStudioPendingEdits, formatTime, getPersistedRenderSettings, liveTime, mergeStyleIntoTag, openAudioGainDialog, parseStyleString, persistRenderSettings, resolveDomEditSelection, resolveEquidistanceGuides, resolveGuideLineRect, resolveIframe, resolveSnapAdjustment, resolveSourceFile, revertNewestStudioPendingEdit, 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, useThumbnailStill, useTimelineContext, useTimelineEditing, useTimelinePlayer };

package/dist/index.html

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