@tangle-network/agent-app 0.42.4 → 0.42.6

package/dist/design-canvas-react/index.d.ts

@@ -1,11 +1,11 @@
-import { D as DesignCanvasProps, c as createSceneCommandStack, E as ExportTriggerOptions, a as DesignCanvasMode } from '../command-stack-CkjelfK_.js';
-export { A as ApplySceneResult, b as EditorSceneState, S as SCENE_COMMAND_HISTORY_LIMIT, d as SceneCommand, e as SceneCommandStack, f as SceneCommandStackWithReapply, g as SnapEngine, h as SnapResult, i as SnapTarget, j as SnapTargetKind, k as SnapTargets, Z as ZoomPanMath } from '../command-stack-CkjelfK_.js';
+import { D as DesignCanvasProps, c as createSceneCommandStack, E as ExportTriggerOptions, a as DesignCanvasMode } from '../command-stack-CcWi_2bN.js';
+export { A as ApplySceneResult, b as EditorSceneState, S as SCENE_COMMAND_HISTORY_LIMIT, d as SceneCommand, e as SceneCommandStack, f as SceneCommandStackWithReapply, g as SnapEngine, h as SnapResult, i as SnapTarget, j as SnapTargetKind, k as SnapTargets, Z as ZoomPanMath } from '../command-stack-CcWi_2bN.js';
 import { InsertPageGeometry, InsertTemplate, MultiSetAttrsEntry } from './engine.js';
 export { AddElementInput, AddPageInput, BindSlotInput, DEFAULT_INSERT_TEMPLATES, DUPLICATE_OFFSET, DeleteElementInput, DeletePageInput, DuplicatePageInput, ExportViewSnapshot, GroupElementsInput, MAX_INSERT_DIMENSION, MarqueeSelectOptions, NudgeDelta, ReorderElementInput, ReorderPageInput, ResolvedExportParams, SetAttrsInput, SetDocumentTitleInput, SetPageGuidesInput, SetPagePropsInput, UngroupElementInput, ZoomPanConfig, addElementCommand, addPageCommand, bindSlotCommand, buildInsertImageOp, centeredPosition, collectGridTargets, createSnapEngine, createZoomPanMath, deleteElementCommand, deletePageCommand, documentCropToStageCoords, duplicatePageCommand, fittedSize, groupElementsCommand, hitTestPoint, identifyTaintedSrc, isCrossOriginSrc, isExportHiddenNodeName, marqueeSelect, mintElementId, multiSetAttrsCommand, nudgeDelta, reorderElementCommand, reorderPageCommand, resolveExportParams, setAttrsCommand, setDocumentTitleCommand, setPageGuidesCommand, setPagePropsCommand, ungroupElementCommand } from './engine.js';
 import { c as SceneDocument, g as ScenePage, d as SceneElement, P as PageBleed, a as PageGuides } from '../model-BBwyOuWG.js';
 import { f as ExportPreset } from '../export-presets-DAsU5Wal.js';
 export { d as ExportCropRect, h as bleedAwareExportBounds, s as scaleForPreset } from '../export-presets-DAsU5Wal.js';
-export { D as DesignCanvas, a as DesignCanvasChromeLazy, b as DesignCanvasEditor, c as DesignCanvasFullProps, d as DesignCanvasLazy } from '../lazy-BHHqS8-j.js';
+export { D as DesignCanvas, a as DesignCanvasChromeLazy, b as DesignCanvasEditor, c as DesignCanvasFullProps, d as DesignCanvasLazy } from '../lazy-2XBVp1_e.js';
 import * as react from 'react';
 import { ButtonHTMLAttributes } from 'react';
 import { g as SceneOperation, f as SceneAttrsPatch } from '../operations-DLIvvD00.js';
@@ -142,8 +142,15 @@ interface WorkspaceViewProps {
     onReady?(): void;
     /** Konva render palette. Omitted → light defaults (byte-identical history). */
     render?: CanvasRenderPalette;
+    /** Show the branded in-canvas empty state (three doors) while the active page
+     *  has no elements and the user can write. Default true. Set false to keep a
+     *  bare blank stage (e.g. when restoring a saved-but-intentionally-empty page). */
+    showEmptyState?: boolean;
+    /** Focus/open the agent from the empty state's "Ask the agent" door. When
+     *  omitted that door is hidden — there is no agent surface to send them to. */
+    onAskAgent?(): void;
 }
-declare function WorkspaceView({ canWrite, onApplyOperations, onSelectionChange, className, stack, activePage, onFitRef, onExport, onExportRef, fitOnMount, onReady, render, }: WorkspaceViewProps): react.JSX.Element;
+declare function WorkspaceView({ canWrite, onApplyOperations, onSelectionChange, className, stack, activePage, onFitRef, onExport, onExportRef, fitOnMount, onReady, render, showEmptyState, onAskAgent, }: WorkspaceViewProps): react.JSX.Element;
 /**
  * Self-contained Konva workspace that creates its own command stack. Mount
  * this when you want the canvas without the toolbar/rulers/pages-strip chrome.
@@ -153,6 +160,39 @@ declare function WorkspaceView({ canWrite, onApplyOperations, onSelectionChange,
  */
 declare function Workspace(props: DesignCanvasProps): react.JSX.Element | null;
 
+/**
+ * In-canvas empty state — the first move on a blank design. Shown by
+ * WorkspaceView as a centered overlay while the active page has no user
+ * content, so a fresh canvas reads as "ready to start" rather than "broken or
+ * empty". Three doors cover the two ways people begin and the agent path:
+ *   - Start with a template — drop a starter element via the same command stack.
+ *   - Add an element — insert a text block by hand.
+ *   - Ask the agent — surfaced only when the host wires `onAskAgent` (an agent
+ *     panel exists); otherwise the door is omitted rather than rendered dead.
+ *
+ * Token-styled only (CSS-var tokens + Tailwind semantic names) and stamped with
+ * the Tangle mark so the blank state is on-brand. Pointer-events stay scoped to
+ * the card: clicking the surrounding canvas still starts a marquee.
+ */
+interface CanvasEmptyStateProps {
+    /** Drop a starter template element through the command stack. */
+    onStartTemplate(): void;
+    /** Insert a single editable element by hand. */
+    onAddElement(): void;
+    /** Focus the agent panel / open the agent. Omitted → the door is hidden. */
+    onAskAgent?(): void;
+    /** Heading copy. Overridable; defaults to the cold-open prompt. */
+    title?: string;
+    /** Supporting line under the heading. Overridable. */
+    subtitle?: string;
+    className?: string;
+}
+/**
+ * The three-door empty state. Each door is a real action wired to the editor's
+ * command stack (or the agent), never a placeholder.
+ */
+declare function CanvasEmptyState({ onStartTemplate, onAddElement, onAskAgent, title, subtitle, className, }: CanvasEmptyStateProps): react.JSX.Element;
+
 interface SelectionLayerProps {
     /** Konva stage reference to look up selected nodes by name. */
     stageRef: React.RefObject<Konva.Stage | null>;
@@ -189,8 +229,12 @@ interface PagesStripProps {
     /** Show page-management affordances (add / duplicate / delete). Default true.
      *  The review surface passes false: pages are navigated, not authored. */
     canManagePages?: boolean;
+    /** Heading shown above the strip so it reads as page management. Overridable;
+     *  defaults to "Pages". Set to '' to hide the visible label (the container
+     *  keeps its accessible name regardless). */
+    label?: string;
 }
-declare function PagesStrip({ pages, activePageId, canWrite, renderThumbnail, onSelectPage, onAddPage, onDuplicatePage, onDeletePage, onReorderPage, canManagePages, }: PagesStripProps): react.JSX.Element;
+declare function PagesStrip({ pages, activePageId, canWrite, renderThumbnail, onSelectPage, onAddPage, onDuplicatePage, onDeletePage, onReorderPage, canManagePages, label, }: PagesStripProps): react.JSX.Element;
 
 interface LayersPanelProps {
     page: ScenePage;
@@ -244,8 +288,14 @@ interface ToolbarProps {
     onUngroup(groupId: string): void;
     onDelete(elementIds: string[]): void;
     onBindSlot(elementId: string, slot: string | null): void;
+    /** Field label for the page-size control. Defaults to the clearer "Page size";
+     *  overridable for consumers that want the older "Preset" wording. */
+    pageSizeLabel?: string;
+    /** Title for the "turn on print bleed" action. Defaults to "Show print bleed"
+     *  (the outcome) rather than the print-shop term "bleed". */
+    enableBleedLabel?: string;
 }
-declare function Toolbar({ page, selectedElements, canWrite, mode, canUndo, canRedo, gridEnabled, snapEnabled, showRulers, showBleed, onUndo, onRedo, onToggleGrid, onToggleSnap, onToggleRulers, onToggleBleed, onSetAttrs, onSetPageProps, onSetPageGuides, onReorder, onGroup, onUngroup, onDelete, onBindSlot, }: ToolbarProps): react.JSX.Element;
+declare function Toolbar({ page, selectedElements, canWrite, mode, canUndo, canRedo, gridEnabled, snapEnabled, showRulers, showBleed, onUndo, onRedo, onToggleGrid, onToggleSnap, onToggleRulers, onToggleBleed, onSetAttrs, onSetPageProps, onSetPageGuides, onReorder, onGroup, onUngroup, onDelete, onBindSlot, pageSizeLabel, enableBleedLabel, }: ToolbarProps): react.JSX.Element;
 
 /**
  * Canvas zoom controls: fit-to-page, 100%, zoom-out/in buttons, and a percent
@@ -256,8 +306,11 @@ interface ZoomControlsProps {
     zoom: number;
     onZoom(zoom: number): void;
     onFit(): void;
+    /** Label/aria for the fit action. Defaults to "Fit to screen" — shorter and
+     *  matching every other tool's wording for the same action. */
+    fitLabel?: string;
 }
-declare function ZoomControls({ zoom, onZoom, onFit }: ZoomControlsProps): react.JSX.Element;
+declare function ZoomControls({ zoom, onZoom, onFit, fitLabel }: ZoomControlsProps): react.JSX.Element;
 
 /** 28px square (h-7) — used by the main toolbar. */
 declare const BTN = "flex h-7 w-7 items-center justify-center rounded border border-[var(--border-default)] text-[var(--text-secondary)] transition hover:text-[var(--text-primary)] focus:outline-none focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[hsl(var(--ring))] focus-visible:ring-offset-1 focus-visible:ring-offset-[var(--bg-input)] disabled:cursor-default disabled:opacity-40";
@@ -514,4 +567,4 @@ declare function buildRulerTicks(input: {
  *  decimals are rounded to 1 place. Values ≥ 1000 are compacted to "1k" etc. */
 declare function formatRulerLabel(value: number): string;
 
-export { BTN, BTN_ACTIVE, BTN_SM, BTN_SM_ACTIVE, type BakedNodeAttrs, CanvasInsertPanel, type CanvasInsertPanelProps, DesignCanvasMode, DesignCanvasProps, ElementNode, type ElementNodeProps, ExportControl, type ExportControlProps, type ExportPageDataUrlOptions, ExportPreset, ExportTriggerOptions, GridLayer, type GridLayerProps, IconButton, type IconButtonProps, type InsertGeneration, InsertPageGeometry, InsertTemplate, LAYERS_PANEL_ROW_LIMIT, type LayerRow, LayersPanel, type LayersPanelProps, MultiSetAttrsEntry, PagesStrip, type PagesStripProps, type RulerTick, Rulers, type RulersProps, SelectionLayer, type SelectionLayerProps, type TickStep, Toolbar, type ToolbarProps, type TransformerNode, Workspace, WorkspaceView, type WorkspaceViewProps, ZoomControls, type ZoomControlsProps, bakeLineTransform, bakeRectTransform, bakeTextTransform, buildRulerTicks, createSceneCommandStack, downloadDataUrl, exportDocumentJson, exportPageDataUrl, flattenLayerTree, formatRulerLabel, selectTickStep };
+export { BTN, BTN_ACTIVE, BTN_SM, BTN_SM_ACTIVE, type BakedNodeAttrs, CanvasEmptyState, type CanvasEmptyStateProps, CanvasInsertPanel, type CanvasInsertPanelProps, DesignCanvasMode, DesignCanvasProps, ElementNode, type ElementNodeProps, ExportControl, type ExportControlProps, type ExportPageDataUrlOptions, ExportPreset, ExportTriggerOptions, GridLayer, type GridLayerProps, IconButton, type IconButtonProps, type InsertGeneration, InsertPageGeometry, InsertTemplate, LAYERS_PANEL_ROW_LIMIT, type LayerRow, LayersPanel, type LayersPanelProps, MultiSetAttrsEntry, PagesStrip, type PagesStripProps, type RulerTick, Rulers, type RulersProps, SelectionLayer, type SelectionLayerProps, type TickStep, Toolbar, type ToolbarProps, type TransformerNode, Workspace, WorkspaceView, type WorkspaceViewProps, ZoomControls, type ZoomControlsProps, bakeLineTransform, bakeRectTransform, bakeTextTransform, buildRulerTicks, createSceneCommandStack, downloadDataUrl, exportDocumentJson, exportPageDataUrl, flattenLayerTree, formatRulerLabel, selectTickStep };

package/dist/design-canvas-react/index.js

@@ -1,4 +1,5 @@
 import {
+  CanvasEmptyState,
   DesignCanvasEditor,
   ElementNode,
   GridLayer,
@@ -11,7 +12,7 @@ import {
   downloadDataUrl,
   exportDocumentJson,
   exportPageDataUrl
-} from "../chunk-YYYXGLLQ.js";
+} from "../chunk-6JYDS34Y.js";
 import {
   BTN,
   BTN_ACTIVE,
@@ -40,29 +41,28 @@ import {
   buildRulerTicks,
   formatRulerLabel,
   selectTickStep
-} from "../chunk-YEWTVDDT.js";
+} from "../chunk-OVUQNKLM.js";
+import "../chunk-ZN5J47UX.js";
 import {
   DEFAULT_INSERT_TEMPLATES,
+  DUPLICATE_OFFSET,
   MAX_INSERT_DIMENSION,
   buildInsertImageOp,
   centeredPosition,
-  fittedSize,
-  mintElementId
-} from "../chunk-SQV7NUEM.js";
-import {
-  DUPLICATE_OFFSET,
   collectGridTargets,
   createSnapEngine,
   createZoomPanMath,
   documentCropToStageCoords,
+  fittedSize,
   hitTestPoint,
   identifyTaintedSrc,
   isCrossOriginSrc,
   isExportHiddenNodeName,
   marqueeSelect,
+  mintElementId,
   nudgeDelta,
   resolveExportParams
-} from "../chunk-V5XZKHCL.js";
+} from "../chunk-AFQXKJAE.js";
 import {
   SCENE_COMMAND_HISTORY_LIMIT,
   addElementCommand,
@@ -85,7 +85,7 @@ import {
 import {
   DesignCanvasChromeLazy,
   DesignCanvasLazy
-} from "../chunk-FJUOBNIY.js";
+} from "../chunk-A5Z53E3A.js";
 import "../chunk-LVD37K5V.js";
 import {
   assertSceneMediaSrc,
@@ -529,6 +529,7 @@ export {
   BTN_ACTIVE,
   BTN_SM,
   BTN_SM_ACTIVE,
+  CanvasEmptyState,
   CanvasInsertPanel,
   DEFAULT_INSERT_TEMPLATES,
   DUPLICATE_OFFSET,

package/dist/design-canvas-react/lazy.d.ts

@@ -1,6 +1,6 @@
 import 'react';
-export { a as DesignCanvasChromeLazy, c as DesignCanvasFullProps, d as DesignCanvasLazy } from '../lazy-BHHqS8-j.js';
-export { D as DesignCanvasProps } from '../command-stack-CkjelfK_.js';
+export { a as DesignCanvasChromeLazy, c as DesignCanvasFullProps, d as DesignCanvasLazy } from '../lazy-2XBVp1_e.js';
+export { D as DesignCanvasProps } from '../command-stack-CcWi_2bN.js';
 import '../model-BBwyOuWG.js';
 import '../operations-DLIvvD00.js';
 import '../theme/index.js';

package/dist/design-canvas-react/lazy.js

@@ -1,7 +1,7 @@
 import {
   DesignCanvasChromeLazy,
   DesignCanvasLazy
-} from "../chunk-FJUOBNIY.js";
+} from "../chunk-A5Z53E3A.js";
 export {
   DesignCanvasChromeLazy,
   DesignCanvasLazy

package/dist/{lazy-BHHqS8-j.d.ts → lazy-2XBVp1_e.d.ts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { c as SceneDocument } from './model-BBwyOuWG.js';
-import { D as DesignCanvasProps, c as createSceneCommandStack, E as ExportTriggerOptions } from './command-stack-CkjelfK_.js';
+import { D as DesignCanvasProps, c as createSceneCommandStack, E as ExportTriggerOptions } from './command-stack-CcWi_2bN.js';
 
 /** Callers inject a workspace renderer so this chrome stays Konva-free. The
  *  workspace occupies the scrollable area between the rulers and the bottom bar. */
@@ -45,6 +45,10 @@ interface DesignCanvasFullProps extends DesignCanvasProps {
         /** Forwarded from DesignCanvasProps. The Konva render palette; the
          *  Konva-free chrome passes it straight through to the workspace. */
         render?: DesignCanvasProps['render'];
+        /** Forwarded from DesignCanvasProps. Toggles the branded in-canvas empty
+         *  state and its agent door. */
+        showEmptyState?: DesignCanvasProps['showEmptyState'];
+        onAskAgent?: DesignCanvasProps['onAskAgent'];
         onZoomChange(zoom: number): void;
         onPanChange(panX: number, panY: number): void;
         onSelectElements(ids: string[], additive: boolean): void;
@@ -55,7 +59,7 @@ interface DesignCanvasFullProps extends DesignCanvasProps {
      */
     renderThumbnail(page: SceneDocument['pages'][number]): Promise<string | null>;
 }
-declare function DesignCanvas({ document: initialDocument, rev: initialRev, canWrite, mode, onApplyOperations, onSelectionChange, renderAgentPanel, renderSidePanel, onExport, exportDefaults, className, fitOnMount, onReady, render, renderWorkspace, renderThumbnail, }: DesignCanvasFullProps): react.JSX.Element;
+declare function DesignCanvas({ document: initialDocument, rev: initialRev, canWrite, mode, onApplyOperations, onSelectionChange, renderAgentPanel, renderSidePanel, onExport, exportDefaults, className, fitOnMount, onReady, render, showEmptyState, onAskAgent, pageSizeLabel, enableBleedLabel, fitLabel, renderWorkspace, renderThumbnail, }: DesignCanvasFullProps): react.JSX.Element;
 
 /**
  * Mount this component to get the full editor: toolbar, rulers, layers panel,

package/dist/sequences-react/index.d.ts

@@ -114,6 +114,34 @@ interface TranscriptionProvider {
         onProgress?: (fraction: number) => void;
     }): Promise<TranscriptionSegment[]>;
 }
+/** Overridable copy for the editor's product-facing labels. Every field is
+ *  optional; the editor ships clear defaults (see `DEFAULT_TIMELINE_LABELS`).
+ *  Accessible names (the `*AriaLabel` fields) stay descriptive for screen
+ *  readers; the short visible labels carry the on-screen verb. Products rename
+ *  per their own vocabulary without forking the component. */
+interface TimelineEditorLabels {
+    /** Visible verb on the split-at-playhead tool. */
+    splitClip?: string;
+    splitClipAriaLabel?: string;
+    /** Visible verb on the add-caption-at-playhead tool. */
+    addCaption?: string;
+    addCaptionAriaLabel?: string;
+    /** Visible verb on the export action (rendered only when `onCreateExport`). */
+    createExport?: string;
+    /** Empty-state heading + the three doors. */
+    emptyTitle?: string;
+    emptyBody?: string;
+    emptyTemplateDoor?: string;
+    emptyClipDoor?: string;
+    emptyAgentDoor?: string;
+    /** Phone gate shown instead of the gesture-heavy editor below `sm`. */
+    smallScreenTitle?: string;
+    smallScreenBody?: string;
+    /** Ghost-lane names shown at rest so time reads as a timeline before any
+     *  track exists. */
+    ghostVideoLane?: string;
+    ghostCaptionLane?: string;
+}
 interface TimelineEditorProps {
     timeline: SequenceTimeline;
     canWrite: boolean;
@@ -136,8 +164,24 @@ interface TimelineEditorProps {
     renderAssetShelf?(): React.ReactNode;
     /** Frame provider override; omitted → the baseline HTMLVideoElement provider. */
     frameProvider?: VideoFrameProvider;
+    /** Overridable product-facing copy; defaults are clear on their own. */
+    labels?: TimelineEditorLabels;
+    /** Empty-state doors. Supplying a handler renders that door; omitting it
+     *  hides it. With none supplied the empty state shows guidance only. */
+    onStartFromTemplate?(): void;
+    onAddClip?(): void;
+    onAskAgent?(): void;
+    /** Render the export action (a toolbar "Export…" button). Omitted → no export
+     *  affordance. The handler owns the dialog/flow; this surface only invokes it. */
+    onCreateExport?(): void;
+    /** Off by default. When true AND the consuming product supplies a branded
+     *  export pipeline, the export door/button is marked as Tangle-branded. This
+     *  surface has no render pipeline of its own to brand, so the flag is a
+     *  forward-compatible hint to `onCreateExport`, never a baked watermark. */
+    brandedExport?: boolean;
     className?: string;
 }
+declare const DEFAULT_TIMELINE_LABELS: Required<TimelineEditorLabels>;
 
 /**
  * Undo/redo command stack over immutable `EditorTimelineState`.
@@ -635,6 +679,52 @@ interface TimelinePlayheadProps {
 }
 declare function TimelinePlayhead({ frame, zoom }: TimelinePlayheadProps): react.JSX.Element;
 
+/**
+ * Lazy boundary around the Tangle knot from `../../brand`.
+ *
+ * `/brand` re-exports the mark from `@tangle-network/sandbox-ui`, an OPT-IN peer
+ * (see brand/index.tsx). Static-importing it would pull the peer into every
+ * module that renders the timeline — breaking substrate-free environments (and
+ * products that haven't installed the peer) at module-eval time. Code-splitting
+ * it (the repo's `lazy.tsx` convention) keeps the peer out of the editor's
+ * static graph: the knot streams in only when an empty/phone state actually
+ * renders, and its absence degrades to empty space rather than a crash.
+ */
+interface BrandMarkProps {
+    size: number;
+    className?: string;
+}
+declare function BrandMark({ size, className }: BrandMarkProps): react.JSX.Element;
+
+interface TimelineEmptyStateProps {
+    labels?: TimelineEditorLabels;
+    brandedExport?: boolean;
+    onStartFromTemplate?(): void;
+    onAddClip?(): void;
+    onAskAgent?(): void;
+}
+declare function TimelineEmptyState(props: TimelineEmptyStateProps): react.JSX.Element;
+
+/**
+ * Labeled placeholder lanes drawn behind the empty state so the surface reads
+ * as a timeline before any track exists: a "Video" lane and a "Captions" lane
+ * with the same sticky header column the real `TimelineTrackRow` uses, sized to
+ * the timeline width so the ruler's timecodes line up over real lanes. Purely
+ * decorative — no clips, no gestures.
+ */
+interface TimelineGhostLanesProps {
+    /** Timeline pixel width (durationFrames * zoom), so ghost lanes match the ruler. */
+    laneWidth: number;
+    videoLabel: string;
+    captionLabel: string;
+}
+declare function TimelineGhostLanes({ laneWidth, videoLabel, captionLabel }: TimelineGhostLanesProps): react.JSX.Element;
+
+interface TimelineSmallScreenGateProps {
+    labels?: TimelineEditorLabels;
+}
+declare function TimelineSmallScreenGate({ labels }: TimelineSmallScreenGateProps): react.JSX.Element;
+
 interface SnapIndicatorLineProps {
     point: SnapPoint | null;
     zoom: number;
@@ -645,8 +735,10 @@ interface ZoomControlProps {
     zoomMath: ZoomMath;
     zoom: number;
     onZoomChange(zoom: number): void;
+    /** Fit-to-sequence pixels-per-frame; clicking the readout snaps back to it. */
+    fitZoom?: number;
 }
-declare function ZoomControl({ zoomMath, zoom, onZoomChange }: ZoomControlProps): react.JSX.Element;
+declare function ZoomControl({ zoomMath, zoom, onZoomChange, fitZoom }: ZoomControlProps): react.JSX.Element;
 
 /**
  * Fuses several `TimelineCommand`s into one undo step so a single gesture
@@ -763,4 +855,4 @@ declare function chooseMoveSnap(input: {
 
 declare const SequenceTimelineEditorLazy: react__default.LazyExoticComponent<typeof TimelineEditor>;
 
-export { type AddCaptionInput, type ApplySnapOptions, type AudioBufferLike, COMMAND_HISTORY_LIMIT, type ClipIdResolver, type ClipMoveCommit, type ClipTrimCommit, type CommandStack, DEFAULT_MAX_MEDIA_ELEMENTS, DEFAULT_WHISPER_MODEL, type DeleteClipInput, type EditorTimelineState, type FrameRect, type LetterboxRect, type MediaElementPool, type MoveClipInput, type MoveDragInput, type PlaceClipInput, type PlaybackClock, type PlaybackClockConfig, type PooledElementLease, PreviewCanvas, type PreviewCanvasProps, SEEK_TIMEOUT_MS, SEEK_TOLERANCE_SECONDS, SEQUENCE_MEDIA_DRAG_TYPE, SequenceTimelineEditorLazy, type SetClipTextInput, SnapIndicatorLine, type SnapIndicatorLineProps, type SnapPoint, type SnapResult, type SplitClipInput, TimelineClipChip, type TimelineClipChipProps, type TimelineCommand, TimelineEditor, type TimelineEditorProps, TimelinePlayhead, type TimelinePlayheadProps, TimelineRuler, type TimelineRulerProps, type TimelineSnapPoint, TimelineTrackRow, type TimelineTrackRowProps, type ToggleClipDisabledInput, type TranscriptionProvider, type TranscriptionSegment, type TrimClipInput, type TrimEndDragInput, type TrimStartDragInput, type TrimStartDragResult, type VideoFrameProvider, type ViewportTransform, type WaveformData, type WhisperOutput, ZoomControl, type ZoomControlProps, type ZoomMath, type ZoomMathConfig, addCaptionCommand, applySnap, captionFontPx, chooseMoveSnap, classifyMediaUrl, clipChipGeometry, collectSnapPoints, compositeCommand, computeWaveform, containFitRect, createCommandStack, createImageFrameProvider, createMediaElementPool, createPlaybackClock, createVideoElementFrameProvider, createWhisperTranscriptionProvider, createZoomMath, deleteClipCommand, drawWaveform, frameToPixel, framesFromPixelDelta, letterboxRect, loadWaveform, mapWhisperOutput, mixdownToMono, moveClipCommand, moveDragStartFrame, needsSeek, pixelToFrame, placeClipCommand, selectTickStepSeconds, setClipTextCommand, snapPixel, splitClipCommand, toggleClipDisabledCommand, trimClipCommand, trimEndDrag, trimStartDrag };
+export { type AddCaptionInput, type ApplySnapOptions, type AudioBufferLike, BrandMark, type BrandMarkProps, COMMAND_HISTORY_LIMIT, type ClipIdResolver, type ClipMoveCommit, type ClipTrimCommit, type CommandStack, DEFAULT_MAX_MEDIA_ELEMENTS, DEFAULT_TIMELINE_LABELS, DEFAULT_WHISPER_MODEL, type DeleteClipInput, type EditorTimelineState, type FrameRect, type LetterboxRect, type MediaElementPool, type MoveClipInput, type MoveDragInput, type PlaceClipInput, type PlaybackClock, type PlaybackClockConfig, type PooledElementLease, PreviewCanvas, type PreviewCanvasProps, SEEK_TIMEOUT_MS, SEEK_TOLERANCE_SECONDS, SEQUENCE_MEDIA_DRAG_TYPE, SequenceTimelineEditorLazy, type SetClipTextInput, SnapIndicatorLine, type SnapIndicatorLineProps, type SnapPoint, type SnapResult, type SplitClipInput, TimelineClipChip, type TimelineClipChipProps, type TimelineCommand, TimelineEditor, type TimelineEditorLabels, type TimelineEditorProps, TimelineEmptyState, type TimelineEmptyStateProps, TimelineGhostLanes, type TimelineGhostLanesProps, TimelinePlayhead, type TimelinePlayheadProps, TimelineRuler, type TimelineRulerProps, TimelineSmallScreenGate, type TimelineSmallScreenGateProps, type TimelineSnapPoint, TimelineTrackRow, type TimelineTrackRowProps, type ToggleClipDisabledInput, type TranscriptionProvider, type TranscriptionSegment, type TrimClipInput, type TrimEndDragInput, type TrimStartDragInput, type TrimStartDragResult, type VideoFrameProvider, type ViewportTransform, type WaveformData, type WhisperOutput, ZoomControl, type ZoomControlProps, type ZoomMath, type ZoomMathConfig, addCaptionCommand, applySnap, captionFontPx, chooseMoveSnap, classifyMediaUrl, clipChipGeometry, collectSnapPoints, compositeCommand, computeWaveform, containFitRect, createCommandStack, createImageFrameProvider, createMediaElementPool, createPlaybackClock, createVideoElementFrameProvider, createWhisperTranscriptionProvider, createZoomMath, deleteClipCommand, drawWaveform, frameToPixel, framesFromPixelDelta, letterboxRect, loadWaveform, mapWhisperOutput, mixdownToMono, moveClipCommand, moveDragStartFrame, needsSeek, pixelToFrame, placeClipCommand, selectTickStepSeconds, setClipTextCommand, snapPixel, splitClipCommand, toggleClipDisabledCommand, trimClipCommand, trimEndDrag, trimStartDrag };

package/dist/sequences-react/index.js

@@ -1,6 +1,8 @@
 import {
+  BrandMark,
   COMMAND_HISTORY_LIMIT,
   DEFAULT_MAX_MEDIA_ELEMENTS,
+  DEFAULT_TIMELINE_LABELS,
   PreviewCanvas,
   SEEK_TIMEOUT_MS,
   SEEK_TOLERANCE_SECONDS,
@@ -8,8 +10,11 @@ import {
   SnapIndicatorLine,
   TimelineClipChip,
   TimelineEditor,
+  TimelineEmptyState,
+  TimelineGhostLanes,
   TimelinePlayhead,
   TimelineRuler,
+  TimelineSmallScreenGate,
   TimelineTrackRow,
   ZoomControl,
   addCaptionCommand,
@@ -47,7 +52,7 @@ import {
   trimClipCommand,
   trimEndDrag,
   trimStartDrag
-} from "../chunk-S6WS2B32.js";
+} from "../chunk-EX3LD5G6.js";
 import "../chunk-ZYBWGSAZ.js";
 
 // src/sequences-react/media/transcription.ts
@@ -182,10 +187,12 @@ function createWhisperTranscriptionProvider(opts) {
 
 // src/sequences-react/lazy.tsx
 import React from "react";
-var SequenceTimelineEditorLazy = React.lazy(() => import("../TimelineEditor-Z7C6BFP5.js"));
+var SequenceTimelineEditorLazy = React.lazy(() => import("../TimelineEditor-SNOAGBV6.js"));
 export {
+  BrandMark,
   COMMAND_HISTORY_LIMIT,
   DEFAULT_MAX_MEDIA_ELEMENTS,
+  DEFAULT_TIMELINE_LABELS,
   DEFAULT_WHISPER_MODEL,
   PreviewCanvas,
   SEEK_TIMEOUT_MS,
@@ -195,8 +202,11 @@ export {
   SnapIndicatorLine,
   TimelineClipChip,
   TimelineEditor,
+  TimelineEmptyState,
+  TimelineGhostLanes,
   TimelinePlayhead,
   TimelineRuler,
+  TimelineSmallScreenGate,
   TimelineTrackRow,
   ZoomControl,
   addCaptionCommand,

package/dist/sequences-react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/sequences-react/media/transcription.ts","../../src/sequences-react/lazy.tsx"],"sourcesContent":["/**\n * Whisper transcription behind the `TranscriptionProvider` seam, powered by\n * the OPTIONAL peer `@huggingface/transformers`. The peer is loaded with a\n * dynamic variable-specifier import inside `transcribe()` so bundlers leave\n * it external and apps that never transcribe never pay for it. `available`\n * is the sync UI affordance signal; `transcribe()` re-verifies with the real\n * import and is the source of truth.\n */\n\nimport type { TranscriptionProvider, TranscriptionSegment } from '../contracts'\nimport type { AudioBufferLike } from './waveform'\n\nexport const DEFAULT_WHISPER_MODEL = 'onnx-community/whisper-large-v3-turbo'\n\n/** Whisper models are trained on 16 kHz mono — decoding through a 16 kHz\n *  OfflineAudioContext resamples any source rate in one step. */\nconst WHISPER_SAMPLE_RATE = 16_000\n\nconst TRANSCRIPTION_PEER = '@huggingface/transformers'\nconst PEER_MISSING_MESSAGE = 'transcription requires optional peer @huggingface/transformers'\n\ninterface WhisperChunk {\n  text: string\n  timestamp: [number, number | null]\n}\n\nexport interface WhisperOutput {\n  text: string\n  chunks?: WhisperChunk[]\n}\n\ntype WhisperPipeline = (\n  audio: Float32Array,\n  options: Record<string, unknown>,\n) => Promise<WhisperOutput | WhisperOutput[]>\n\ninterface TransformersProgressEvent {\n  status: string\n  progress?: number\n}\n\ninterface TransformersModule {\n  pipeline(\n    task: 'automatic-speech-recognition',\n    model: string,\n    options?: Record<string, unknown>,\n  ): Promise<WhisperPipeline>\n}\n\n/** Mean-mixdown to mono. Single-channel buffers return the live channel data\n *  without copying — callers must treat the result as read-only. */\nexport function mixdownToMono(buffer: AudioBufferLike): Float32Array {\n  if (buffer.numberOfChannels < 1) throw new Error('audio buffer has no channels — cannot mix down')\n  if (buffer.numberOfChannels === 1) return buffer.getChannelData(0)\n  const mono = new Float32Array(buffer.length)\n  for (let channel = 0; channel < buffer.numberOfChannels; channel++) {\n    const data = buffer.getChannelData(channel)\n    if (data.length !== buffer.length) {\n      throw new Error(`channel ${channel} has ${data.length} samples, expected ${buffer.length}`)\n    }\n    for (let i = 0; i < data.length; i++) {\n      // in range by the length assertion above; casts silence noUncheckedIndexedAccess\n      mono[i] = (mono[i] as number) + (data[i] as number)\n    }\n  }\n  const scale = 1 / buffer.numberOfChannels\n  for (let i = 0; i < mono.length; i++) {\n    mono[i] = (mono[i] as number) * scale\n  }\n  return mono\n}\n\n/** Map whisper chunk output to contract segments. A `null` end timestamp is\n *  whisper's \"ran past the end of the audio\" sentinel on the final chunk and\n *  resolves to the audio duration. */\nexport function mapWhisperOutput(\n  output: WhisperOutput | WhisperOutput[],\n  durationSeconds: number,\n  mediaUrl: string,\n): TranscriptionSegment[] {\n  const first = Array.isArray(output) ? output[0] : output\n  if (first === undefined) throw new Error(`whisper produced no output for ${mediaUrl}`)\n  const chunks = first.chunks\n  if (chunks === undefined || chunks.length === 0) {\n    const text = first.text.trim()\n    return text.length === 0 ? [] : [{ text, startSeconds: 0, endSeconds: durationSeconds }]\n  }\n  const segments: TranscriptionSegment[] = []\n  for (const chunk of chunks) {\n    const text = chunk.text.trim()\n    if (text.length === 0) continue\n    const [start, end] = chunk.timestamp\n    if (!Number.isFinite(start)) {\n      throw new Error(`whisper returned a non-numeric start timestamp for \"${text}\" in ${mediaUrl}`)\n    }\n    segments.push({ text, startSeconds: start, endSeconds: end === null ? durationSeconds : end })\n  }\n  return segments\n}\n\nasync function loadTransformers(): Promise<TransformersModule> {\n  try {\n    // Variable specifier + ignore pragmas keep bundlers from statically\n    // resolving an optional peer that may not be installed.\n    return (await import(/* @vite-ignore */ /* webpackIgnore: true */ TRANSCRIPTION_PEER)) as TransformersModule\n  } catch (error) {\n    throw new Error(PEER_MISSING_MESSAGE, { cause: error })\n  }\n}\n\nasync function fetchMonoAudio(mediaUrl: string): Promise<{ samples: Float32Array; durationSeconds: number }> {\n  const response = await fetch(mediaUrl)\n  if (!response.ok) {\n    throw new Error(`failed to fetch media for transcription: ${response.status} ${response.statusText} from ${mediaUrl}`)\n  }\n  const bytes = await response.arrayBuffer()\n  if (typeof OfflineAudioContext === 'undefined') {\n    throw new Error('transcription requires Web Audio (OfflineAudioContext) — call transcribe() from a browser')\n  }\n  // decodeAudioData resamples to the context rate per the Web Audio spec, so\n  // a 16 kHz context yields whisper-ready samples from any source rate.\n  const context = new OfflineAudioContext(1, 1, WHISPER_SAMPLE_RATE)\n  const decoded = await context.decodeAudioData(bytes)\n  return { samples: mixdownToMono(decoded), durationSeconds: decoded.duration }\n}\n\nexport function createWhisperTranscriptionProvider(opts?: { model?: string }): TranscriptionProvider {\n  const model = opts?.model ?? DEFAULT_WHISPER_MODEL\n  let availability: boolean | null = null\n  let pipelinePromise: Promise<WhisperPipeline> | null = null\n\n  const probeAvailability = (): boolean => {\n    if (availability !== null) return availability\n    const resolve = (import.meta as ImportMeta & { resolve?: (specifier: string) => string }).resolve\n    if (typeof resolve !== 'function') {\n      // No sync resolver in this runtime — report unavailable rather than\n      // guess; transcribe() still attempts the real import either way.\n      availability = false\n      return availability\n    }\n    try {\n      resolve.call(import.meta, TRANSCRIPTION_PEER)\n      availability = true\n    } catch {\n      availability = false\n    }\n    return availability\n  }\n\n  const getPipeline = (\n    transformers: TransformersModule,\n    onProgress?: (fraction: number) => void,\n  ): Promise<WhisperPipeline> => {\n    if (pipelinePromise === null) {\n      const device = typeof navigator !== 'undefined' && 'gpu' in navigator ? 'webgpu' : 'wasm'\n      pipelinePromise = transformers.pipeline('automatic-speech-recognition', model, {\n        dtype: 'q4',\n        device,\n        // Model download progress only — it dwarfs inference time on first\n        // use, and only the first transcribe ever sees a download.\n        progress_callback: (event: TransformersProgressEvent) => {\n          if (event.status === 'progress' && typeof event.progress === 'number' && onProgress !== undefined) {\n            onProgress(Math.min(1, Math.max(0, event.progress / 100)))\n          }\n        },\n      })\n      // A failed load must not poison the cache — the next transcribe retries.\n      pipelinePromise.catch(() => {\n        pipelinePromise = null\n      })\n    }\n    return pipelinePromise\n  }\n\n  return {\n    get available() {\n      return probeAvailability()\n    },\n    async transcribe(mediaUrl, transcribeOpts) {\n      const transformers = await loadTransformers()\n      // A successful import is ground truth and overrides a false probe.\n      availability = true\n      const audio = await fetchMonoAudio(mediaUrl)\n      const transcriber = await getPipeline(transformers, transcribeOpts?.onProgress)\n      const options: Record<string, unknown> = {\n        return_timestamps: true,\n        chunk_length_s: 30,\n        stride_length_s: 5,\n      }\n      if (transcribeOpts?.language !== undefined) options.language = transcribeOpts.language\n      const output = await transcriber(audio.samples, options)\n      const segments = mapWhisperOutput(output, audio.durationSeconds, mediaUrl)\n      transcribeOpts?.onProgress?.(1)\n      return segments\n    },\n  }\n}\n","/**\n * Code-split entry for the timeline editor. The editor pulls in canvas\n * painting, waveform decode, and gesture machinery products only need on the\n * sequence route — `React.lazy` keeps it out of their main bundle. Mount\n * inside a `<Suspense>` boundary.\n */\n\nimport React from 'react'\n\nexport const SequenceTimelineEditorLazy = React.lazy(() => import('./components/TimelineEditor'))\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/sequences-react/media/transcription.ts","../../src/sequences-react/lazy.tsx"],"sourcesContent":["/**\n * Whisper transcription behind the `TranscriptionProvider` seam, powered by\n * the OPTIONAL peer `@huggingface/transformers`. The peer is loaded with a\n * dynamic variable-specifier import inside `transcribe()` so bundlers leave\n * it external and apps that never transcribe never pay for it. `available`\n * is the sync UI affordance signal; `transcribe()` re-verifies with the real\n * import and is the source of truth.\n */\n\nimport type { TranscriptionProvider, TranscriptionSegment } from '../contracts'\nimport type { AudioBufferLike } from './waveform'\n\nexport const DEFAULT_WHISPER_MODEL = 'onnx-community/whisper-large-v3-turbo'\n\n/** Whisper models are trained on 16 kHz mono — decoding through a 16 kHz\n *  OfflineAudioContext resamples any source rate in one step. */\nconst WHISPER_SAMPLE_RATE = 16_000\n\nconst TRANSCRIPTION_PEER = '@huggingface/transformers'\nconst PEER_MISSING_MESSAGE = 'transcription requires optional peer @huggingface/transformers'\n\ninterface WhisperChunk {\n  text: string\n  timestamp: [number, number | null]\n}\n\nexport interface WhisperOutput {\n  text: string\n  chunks?: WhisperChunk[]\n}\n\ntype WhisperPipeline = (\n  audio: Float32Array,\n  options: Record<string, unknown>,\n) => Promise<WhisperOutput | WhisperOutput[]>\n\ninterface TransformersProgressEvent {\n  status: string\n  progress?: number\n}\n\ninterface TransformersModule {\n  pipeline(\n    task: 'automatic-speech-recognition',\n    model: string,\n    options?: Record<string, unknown>,\n  ): Promise<WhisperPipeline>\n}\n\n/** Mean-mixdown to mono. Single-channel buffers return the live channel data\n *  without copying — callers must treat the result as read-only. */\nexport function mixdownToMono(buffer: AudioBufferLike): Float32Array {\n  if (buffer.numberOfChannels < 1) throw new Error('audio buffer has no channels — cannot mix down')\n  if (buffer.numberOfChannels === 1) return buffer.getChannelData(0)\n  const mono = new Float32Array(buffer.length)\n  for (let channel = 0; channel < buffer.numberOfChannels; channel++) {\n    const data = buffer.getChannelData(channel)\n    if (data.length !== buffer.length) {\n      throw new Error(`channel ${channel} has ${data.length} samples, expected ${buffer.length}`)\n    }\n    for (let i = 0; i < data.length; i++) {\n      // in range by the length assertion above; casts silence noUncheckedIndexedAccess\n      mono[i] = (mono[i] as number) + (data[i] as number)\n    }\n  }\n  const scale = 1 / buffer.numberOfChannels\n  for (let i = 0; i < mono.length; i++) {\n    mono[i] = (mono[i] as number) * scale\n  }\n  return mono\n}\n\n/** Map whisper chunk output to contract segments. A `null` end timestamp is\n *  whisper's \"ran past the end of the audio\" sentinel on the final chunk and\n *  resolves to the audio duration. */\nexport function mapWhisperOutput(\n  output: WhisperOutput | WhisperOutput[],\n  durationSeconds: number,\n  mediaUrl: string,\n): TranscriptionSegment[] {\n  const first = Array.isArray(output) ? output[0] : output\n  if (first === undefined) throw new Error(`whisper produced no output for ${mediaUrl}`)\n  const chunks = first.chunks\n  if (chunks === undefined || chunks.length === 0) {\n    const text = first.text.trim()\n    return text.length === 0 ? [] : [{ text, startSeconds: 0, endSeconds: durationSeconds }]\n  }\n  const segments: TranscriptionSegment[] = []\n  for (const chunk of chunks) {\n    const text = chunk.text.trim()\n    if (text.length === 0) continue\n    const [start, end] = chunk.timestamp\n    if (!Number.isFinite(start)) {\n      throw new Error(`whisper returned a non-numeric start timestamp for \"${text}\" in ${mediaUrl}`)\n    }\n    segments.push({ text, startSeconds: start, endSeconds: end === null ? durationSeconds : end })\n  }\n  return segments\n}\n\nasync function loadTransformers(): Promise<TransformersModule> {\n  try {\n    // Variable specifier + ignore pragmas keep bundlers from statically\n    // resolving an optional peer that may not be installed.\n    return (await import(/* @vite-ignore */ /* webpackIgnore: true */ TRANSCRIPTION_PEER)) as TransformersModule\n  } catch (error) {\n    throw new Error(PEER_MISSING_MESSAGE, { cause: error })\n  }\n}\n\nasync function fetchMonoAudio(mediaUrl: string): Promise<{ samples: Float32Array; durationSeconds: number }> {\n  const response = await fetch(mediaUrl)\n  if (!response.ok) {\n    throw new Error(`failed to fetch media for transcription: ${response.status} ${response.statusText} from ${mediaUrl}`)\n  }\n  const bytes = await response.arrayBuffer()\n  if (typeof OfflineAudioContext === 'undefined') {\n    throw new Error('transcription requires Web Audio (OfflineAudioContext) — call transcribe() from a browser')\n  }\n  // decodeAudioData resamples to the context rate per the Web Audio spec, so\n  // a 16 kHz context yields whisper-ready samples from any source rate.\n  const context = new OfflineAudioContext(1, 1, WHISPER_SAMPLE_RATE)\n  const decoded = await context.decodeAudioData(bytes)\n  return { samples: mixdownToMono(decoded), durationSeconds: decoded.duration }\n}\n\nexport function createWhisperTranscriptionProvider(opts?: { model?: string }): TranscriptionProvider {\n  const model = opts?.model ?? DEFAULT_WHISPER_MODEL\n  let availability: boolean | null = null\n  let pipelinePromise: Promise<WhisperPipeline> | null = null\n\n  const probeAvailability = (): boolean => {\n    if (availability !== null) return availability\n    const resolve = (import.meta as ImportMeta & { resolve?: (specifier: string) => string }).resolve\n    if (typeof resolve !== 'function') {\n      // No sync resolver in this runtime — report unavailable rather than\n      // guess; transcribe() still attempts the real import either way.\n      availability = false\n      return availability\n    }\n    try {\n      resolve.call(import.meta, TRANSCRIPTION_PEER)\n      availability = true\n    } catch {\n      availability = false\n    }\n    return availability\n  }\n\n  const getPipeline = (\n    transformers: TransformersModule,\n    onProgress?: (fraction: number) => void,\n  ): Promise<WhisperPipeline> => {\n    if (pipelinePromise === null) {\n      const device = typeof navigator !== 'undefined' && 'gpu' in navigator ? 'webgpu' : 'wasm'\n      pipelinePromise = transformers.pipeline('automatic-speech-recognition', model, {\n        dtype: 'q4',\n        device,\n        // Model download progress only — it dwarfs inference time on first\n        // use, and only the first transcribe ever sees a download.\n        progress_callback: (event: TransformersProgressEvent) => {\n          if (event.status === 'progress' && typeof event.progress === 'number' && onProgress !== undefined) {\n            onProgress(Math.min(1, Math.max(0, event.progress / 100)))\n          }\n        },\n      })\n      // A failed load must not poison the cache — the next transcribe retries.\n      pipelinePromise.catch(() => {\n        pipelinePromise = null\n      })\n    }\n    return pipelinePromise\n  }\n\n  return {\n    get available() {\n      return probeAvailability()\n    },\n    async transcribe(mediaUrl, transcribeOpts) {\n      const transformers = await loadTransformers()\n      // A successful import is ground truth and overrides a false probe.\n      availability = true\n      const audio = await fetchMonoAudio(mediaUrl)\n      const transcriber = await getPipeline(transformers, transcribeOpts?.onProgress)\n      const options: Record<string, unknown> = {\n        return_timestamps: true,\n        chunk_length_s: 30,\n        stride_length_s: 5,\n      }\n      if (transcribeOpts?.language !== undefined) options.language = transcribeOpts.language\n      const output = await transcriber(audio.samples, options)\n      const segments = mapWhisperOutput(output, audio.durationSeconds, mediaUrl)\n      transcribeOpts?.onProgress?.(1)\n      return segments\n    },\n  }\n}\n","/**\n * Code-split entry for the timeline editor. The editor pulls in canvas\n * painting, waveform decode, and gesture machinery products only need on the\n * sequence route — `React.lazy` keeps it out of their main bundle. Mount\n * inside a `<Suspense>` boundary.\n */\n\nimport React from 'react'\n\nexport const SequenceTimelineEditorLazy = React.lazy(() => import('./components/TimelineEditor'))\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYO,IAAM,wBAAwB;AAIrC,IAAM,sBAAsB;AAE5B,IAAM,qBAAqB;AAC3B,IAAM,uBAAuB;AAgCtB,SAAS,cAAc,QAAuC;AACnE,MAAI,OAAO,mBAAmB,EAAG,OAAM,IAAI,MAAM,qDAAgD;AACjG,MAAI,OAAO,qBAAqB,EAAG,QAAO,OAAO,eAAe,CAAC;AACjE,QAAM,OAAO,IAAI,aAAa,OAAO,MAAM;AAC3C,WAAS,UAAU,GAAG,UAAU,OAAO,kBAAkB,WAAW;AAClE,UAAM,OAAO,OAAO,eAAe,OAAO;AAC1C,QAAI,KAAK,WAAW,OAAO,QAAQ;AACjC,YAAM,IAAI,MAAM,WAAW,OAAO,QAAQ,KAAK,MAAM,sBAAsB,OAAO,MAAM,EAAE;AAAA,IAC5F;AACA,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AAEpC,WAAK,CAAC,IAAK,KAAK,CAAC,IAAgB,KAAK,CAAC;AAAA,IACzC;AAAA,EACF;AACA,QAAM,QAAQ,IAAI,OAAO;AACzB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,SAAK,CAAC,IAAK,KAAK,CAAC,IAAe;AAAA,EAClC;AACA,SAAO;AACT;AAKO,SAAS,iBACd,QACA,iBACA,UACwB;AACxB,QAAM,QAAQ,MAAM,QAAQ,MAAM,IAAI,OAAO,CAAC,IAAI;AAClD,MAAI,UAAU,OAAW,OAAM,IAAI,MAAM,kCAAkC,QAAQ,EAAE;AACrF,QAAM,SAAS,MAAM;AACrB,MAAI,WAAW,UAAa,OAAO,WAAW,GAAG;AAC/C,UAAM,OAAO,MAAM,KAAK,KAAK;AAC7B,WAAO,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,cAAc,GAAG,YAAY,gBAAgB,CAAC;AAAA,EACzF;AACA,QAAM,WAAmC,CAAC;AAC1C,aAAW,SAAS,QAAQ;AAC1B,UAAM,OAAO,MAAM,KAAK,KAAK;AAC7B,QAAI,KAAK,WAAW,EAAG;AACvB,UAAM,CAAC,OAAO,GAAG,IAAI,MAAM;AAC3B,QAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,YAAM,IAAI,MAAM,uDAAuD,IAAI,QAAQ,QAAQ,EAAE;AAAA,IAC/F;AACA,aAAS,KAAK,EAAE,MAAM,cAAc,OAAO,YAAY,QAAQ,OAAO,kBAAkB,IAAI,CAAC;AAAA,EAC/F;AACA,SAAO;AACT;AAEA,eAAe,mBAAgD;AAC7D,MAAI;AAGF,WAAQ,MAAM;AAAA;AAAA;AAAA,MAAoD;AAAA;AAAA,EACpE,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,sBAAsB,EAAE,OAAO,MAAM,CAAC;AAAA,EACxD;AACF;AAEA,eAAe,eAAe,UAA+E;AAC3G,QAAM,WAAW,MAAM,MAAM,QAAQ;AACrC,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,4CAA4C,SAAS,MAAM,IAAI,SAAS,UAAU,SAAS,QAAQ,EAAE;AAAA,EACvH;AACA,QAAM,QAAQ,MAAM,SAAS,YAAY;AACzC,MAAI,OAAO,wBAAwB,aAAa;AAC9C,UAAM,IAAI,MAAM,gGAA2F;AAAA,EAC7G;AAGA,QAAM,UAAU,IAAI,oBAAoB,GAAG,GAAG,mBAAmB;AACjE,QAAM,UAAU,MAAM,QAAQ,gBAAgB,KAAK;AACnD,SAAO,EAAE,SAAS,cAAc,OAAO,GAAG,iBAAiB,QAAQ,SAAS;AAC9E;AAEO,SAAS,mCAAmC,MAAkD;AACnG,QAAM,QAAQ,MAAM,SAAS;AAC7B,MAAI,eAA+B;AACnC,MAAI,kBAAmD;AAEvD,QAAM,oBAAoB,MAAe;AACvC,QAAI,iBAAiB,KAAM,QAAO;AAClC,UAAM,UAAW,YAAyE;AAC1F,QAAI,OAAO,YAAY,YAAY;AAGjC,qBAAe;AACf,aAAO;AAAA,IACT;AACA,QAAI;AACF,cAAQ,KAAK,aAAa,kBAAkB;AAC5C,qBAAe;AAAA,IACjB,QAAQ;AACN,qBAAe;AAAA,IACjB;AACA,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,CAClB,cACA,eAC6B;AAC7B,QAAI,oBAAoB,MAAM;AAC5B,YAAM,SAAS,OAAO,cAAc,eAAe,SAAS,YAAY,WAAW;AACnF,wBAAkB,aAAa,SAAS,gCAAgC,OAAO;AAAA,QAC7E,OAAO;AAAA,QACP;AAAA;AAAA;AAAA,QAGA,mBAAmB,CAAC,UAAqC;AACvD,cAAI,MAAM,WAAW,cAAc,OAAO,MAAM,aAAa,YAAY,eAAe,QAAW;AACjG,uBAAW,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,WAAW,GAAG,CAAC,CAAC;AAAA,UAC3D;AAAA,QACF;AAAA,MACF,CAAC;AAED,sBAAgB,MAAM,MAAM;AAC1B,0BAAkB;AAAA,MACpB,CAAC;AAAA,IACH;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,IAAI,YAAY;AACd,aAAO,kBAAkB;AAAA,IAC3B;AAAA,IACA,MAAM,WAAW,UAAU,gBAAgB;AACzC,YAAM,eAAe,MAAM,iBAAiB;AAE5C,qBAAe;AACf,YAAM,QAAQ,MAAM,eAAe,QAAQ;AAC3C,YAAM,cAAc,MAAM,YAAY,cAAc,gBAAgB,UAAU;AAC9E,YAAM,UAAmC;AAAA,QACvC,mBAAmB;AAAA,QACnB,gBAAgB;AAAA,QAChB,iBAAiB;AAAA,MACnB;AACA,UAAI,gBAAgB,aAAa,OAAW,SAAQ,WAAW,eAAe;AAC9E,YAAM,SAAS,MAAM,YAAY,MAAM,SAAS,OAAO;AACvD,YAAM,WAAW,iBAAiB,QAAQ,MAAM,iBAAiB,QAAQ;AACzE,sBAAgB,aAAa,CAAC;AAC9B,aAAO;AAAA,IACT;AAAA,EACF;AACF;;;AC7LA,OAAO,WAAW;AAEX,IAAM,6BAA6B,MAAM,KAAK,MAAM,OAAO,+BAA6B,CAAC;","names":[]}

package/dist/studio/index.d.ts

@@ -1,7 +1,7 @@
 interface StudioIntegrationConnection {
     status: string;
     providerId: string;
-    connectorId: string;
+    connectorId?: string;
 }
 type GenerationType = 'image' | 'video' | 'speech' | 'avatar' | 'transcription';
 type GenerationStatus = 'pending' | 'running' | 'succeeded' | 'failed';

package/dist/studio/index.js

@@ -26,7 +26,7 @@ import {
   relativeTime,
   selectedModelsWithDefaults,
   userSafeGenerationMessage
-} from "../chunk-DTS5TZRN.js";
+} from "../chunk-MFI4ZM7W.js";
 export {
   CADENCES,
   DESTINATIONS,

package/dist/studio-react/index.js

@@ -24,7 +24,7 @@ import {
   relativeTime,
   selectedModelsWithDefaults,
   userSafeGenerationMessage
-} from "../chunk-DTS5TZRN.js";
+} from "../chunk-MFI4ZM7W.js";
 
 // src/studio-react/studio-workspace.tsx
 import { useRef as useRef3, useState as useState3 } from "react";

package/dist/web-react/index.d.ts

@@ -375,13 +375,32 @@ interface ModelPickerProps {
  * sorts providers by tier).
  */
 declare function ModelPicker({ value, onChange, models, loading, renderProviderBadge, recommendedLabel }: ModelPickerProps): react.JSX.Element;
+/** One reasoning-budget level: the engine `id` is unchanged (the value the
+ *  product sends to the loop); only the user-facing `label` is renamed to the
+ *  plainer "how hard should it think" vocabulary from docs/product-surfaces.md.
+ *  `low`→Quick, `medium`→Standard, `high`→Extended. The mapping is overridable
+ *  via `EffortPickerProps.levels`, so a product can relabel without losing the
+ *  ids the runtime expects. */
+interface EffortLevel {
+    id: string;
+    label: string;
+}
+declare const DEFAULT_EFFORT_LEVELS: readonly EffortLevel[];
 interface EffortPickerProps {
     value: string;
     onChange: (id: string) => void;
+    /** Selectable levels (engine id + user-facing label). Defaults to the plain
+     *  "Thinking" vocabulary; override to relabel without changing the ids the
+     *  runtime receives. */
+    levels?: readonly EffortLevel[];
+    /** Prefix shown before the active level on the pill — the "what is this"
+     *  context the bare value lacked. Default "Thinking". Pass '' to hide it. */
+    label?: string;
 }
-/** Reasoning-effort selector pill, styled to match {@link ModelPicker}. Show
- *  it only when the selected model `supportsReasoning`. */
-declare function EffortPicker({ value, onChange }: EffortPickerProps): react.JSX.Element;
+/** Thinking-budget selector pill, styled to match {@link ModelPicker}. Show
+ *  it only when the selected model `supportsReasoning`. "Thinking" is the
+ *  plain-English name for what was internally called "effort". */
+declare function EffortPicker({ value, onChange, levels, label }: EffortPickerProps): react.JSX.Element;
 
 interface AgentSessionControlsProps {
     /** Catalog models — canonical provider-prefixed ids. */
@@ -464,12 +483,28 @@ interface ChatToolCallInfo {
 declare function pendingApprovalOf(call: ChatToolCallInfo): {
     proposalId: string;
 } | null;
+/** One ordered piece of an assistant turn: a run of answer text, or a tool
+ *  call, in the sequence the agent emitted them. A message carrying `segments`
+ *  is rendered in order — interleaving text and tool chips — so the agent's
+ *  pre- and post-tool reasoning reads chronologically instead of as one text
+ *  blob with the tool chips collected after it. */
+type ChatMessageSegment = {
+    kind: 'text';
+    content: string;
+} | {
+    kind: 'tool';
+    call: ChatToolCallInfo;
+};
 interface ChatUiMessage extends ChatMessageMetrics {
     id: string;
     role: 'user' | 'assistant' | 'system';
     content: string;
     reasoning?: string;
     toolCalls?: ChatToolCallInfo[];
+    /** Ordered text/tool sequence for true chronological interleaving. When
+     *  present and non-empty it is rendered in place of `content` + `toolCalls`;
+     *  both remain the fallback for producers that don't segment a turn. */
+    segments?: ChatMessageSegment[];
 }
 interface ChatMessagesProps {
     messages: ChatUiMessage[];
@@ -498,9 +533,41 @@ interface ChatMessagesProps {
      *  retry button (e.g. when the product retries automatically). */
     onRetry?: () => void;
     /** Zero-state renderer, shown when there are no messages and the turn is
-     *  neither loading nor errored. Omit to render nothing (current behavior). */
+     *  neither loading nor errored. When omitted, a branded first-run state is
+     *  shown ({@link ChatEmptyState}); pass `() => null` to render nothing. */
     renderEmpty?: () => ReactNode;
+    /** First-run state config used when `renderEmpty` is not supplied. Lets a
+     *  product set the headline and the "doors" (e.g. start from a template, ask
+     *  the agent) without replacing the whole zero-state. */
+    emptyState?: ChatEmptyStateProps;
+    /** Optional branded header slot rendered above the thread. Off by default to
+     *  preserve the current layout; pass `{ title }` (or your own node via
+     *  `header`) to show the Tangle mark + product title in the chat shell. */
+    header?: ReactNode;
 }
+/** One starting "door" in the chat first-run state — a concrete, labeled action
+ *  (start from a template, do it by hand, ask the agent), not a placeholder. */
+interface ChatEmptyDoor {
+    label: string;
+    description?: string;
+    onSelect: () => void;
+}
+interface ChatEmptyStateProps {
+    /** Product name shown next to the Tangle mark. Default "Agent". */
+    productName?: string;
+    /** Headline. Default frames delegation, not messaging. */
+    headline?: string;
+    /** Subline under the headline. */
+    subline?: string;
+    /** Up to three concrete starting doors. Omit for a mark-and-prompt-only state. */
+    doors?: ChatEmptyDoor[];
+}
+/**
+ * Branded chat first-run state: the Tangle mark, a delegation-framed prompt, and
+ * up to three concrete doors. Replaces the blank thread that read as "empty or
+ * broken". Concrete + actionable — never a "coming soon" placeholder.
+ */
+declare function ChatEmptyState({ productName, headline, subline, doors, }: ChatEmptyStateProps): react.JSX.Element;
 interface ProposalApprovalHandlers {
     onApprove: (proposalId: string, toolCallId: string) => void | Promise<void>;
     onReject: (proposalId: string, toolCallId: string) => void | Promise<void>;
@@ -514,6 +581,6 @@ type ToolDetailRenderers = Record<string, (call: ChatToolCallInfo, message: Chat
  * model id, tokens/sec, and cost, plus a collapsible thinking section and
  * tool-call chips.
  */
-declare function ChatMessages({ messages, models, renderMarkdown, renderExtras, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, }: ChatMessagesProps): react.JSX.Element;
+declare function ChatMessages({ messages, models, renderMarkdown, renderExtras, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, emptyState, header, }: ChatMessagesProps): react.JSX.Element;
 
-export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type ChatMessageMetrics, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ConsumeChatStreamResult, EffortPicker, type EffortPickerProps, FlowWaterfall, type FlowWaterfallProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, RunDrillIn, type RunDrillInProps, type SandboxTerminalConnection, type SandboxTerminalConnectionResponse, SeatPaywall, type SeatPaywallProps, type SmoothRevealOptions, type StreamChatOptions, type TerminalStatusDisplay, type TerminalStatusTone, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseSandboxTerminalConnectionOptions, type UseSandboxTerminalConnectionResult, type WaterfallRow, WorkspaceTerminalPanel, type WorkspaceTerminalPanelProps, activityTone, consumeChatStream, dispatchChatStreamLine, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, mergeActivityPages, nextRevealCount, pendingApprovalOf, streamChatTurn, tabTerminalConnectionId, usePending, usePopover, useSandboxTerminalConnection, useSmoothText, waterfallLayout };
+export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, type EffortLevel, EffortPicker, type EffortPickerProps, FlowWaterfall, type FlowWaterfallProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, RunDrillIn, type RunDrillInProps, type SandboxTerminalConnection, type SandboxTerminalConnectionResponse, SeatPaywall, type SeatPaywallProps, type SmoothRevealOptions, type StreamChatOptions, type TerminalStatusDisplay, type TerminalStatusTone, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseSandboxTerminalConnectionOptions, type UseSandboxTerminalConnectionResult, type WaterfallRow, WorkspaceTerminalPanel, type WorkspaceTerminalPanelProps, activityTone, consumeChatStream, dispatchChatStreamLine, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, mergeActivityPages, nextRevealCount, pendingApprovalOf, streamChatTurn, tabTerminalConnectionId, usePending, usePopover, useSandboxTerminalConnection, useSmoothText, waterfallLayout };