@bendyline/squisq-editor-react 2.7.0 → 2.7.1

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export { CanvasRect, ImageEditor, ImageEditorAction, ImageEditorProps, ImageEdit
 import { CodeBlockCopyHandler, DisplayMode, CaptionStyle, VideoPresentation, PipSize, PipShape, PipPosition } from '@bendyline/squisq-react';
 import { IconFamily } from '@bendyline/squisq/icons';
 import { CoverSlideTemplate, CoverSlidePlayback, ConnectorRouting, AsciiDiagram, Tree, AsciiTimeline, AsciiTimelineSide, AsciiTimelineMarker } from '@bendyline/squisq/doc';
+export { BuildPreviewDocOptions, buildPreviewDoc, documentTitleFromFileName } from '@bendyline/squisq/doc';
 import { MarkdownWrapState } from '@bendyline/squisq/markdown';
 import * as monaco_editor from 'monaco-editor';
 import { M as MonacoLanguageRequest, a as MonacoLanguageLoadOptions } from './monacoLanguageDetection-DEyUW-BS.js';
@@ -23,7 +24,7 @@ import { Node } from '@tiptap/pm/model';
 import { RenderResult } from 'mermaid';
 import { FenceRendererMap } from '@bendyline/squisq/fence';
 export { JsonEditor, JsonEditorProps } from './json-editor/index.js';
-export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, R as RecordedBookmark, a as RecordedMediaKind, b as RecorderAudioDeviceSettings, c as RecorderButton, d as RecorderButtonProps, e as RecorderCameraDeviceSettings, f as RecorderCameraSaveResult, g as RecorderColorScheme, h as RecorderConstraintMode, i as RecorderDeviceSettings, j as RecorderDeviceSettingsPanel, k as RecorderDeviceSettingsPanelProps, l as RecorderEncodingSettings, m as RecorderModal, n as RecorderModalProps, o as RecorderNarrationOptions, p as RecorderPanel, q as RecorderPanelProps, r as RecorderSaveResult, s as RecorderScreenAudioSettings, t as RecorderScreenDeviceSettings, S as ScreenStreamHandle, u as ScreenStreamOptions, T as TimingJson, v as buildRecorderAudioConstraints, w as buildRecorderCameraConstraints, x as buildRecorderScreenAudioConstraints, y as buildRecorderScreenConstraints, z as buildTimingJson, A as encodeTimingJson, B as recordedMediaKind, E as recorderBitsPerSecond, F as requestCameraStream, G as requestMicStream, H as requestScreenStream, I as timingPathFor, J as useStreamPreview } from './recorder-xL-5Vfbu.js';
+export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, M as MediaDeviceInventory, R as RecordedBookmark, a as RecordedMediaKind, b as RecorderAudioDeviceSettings, c as RecorderButton, d as RecorderButtonProps, e as RecorderCameraDeviceSettings, f as RecorderCameraSaveResult, g as RecorderColorScheme, h as RecorderConstraintMode, i as RecorderDeviceOption, j as RecorderDeviceQuickPicks, k as RecorderDeviceQuickPicksProps, l as RecorderDeviceSettings, m as RecorderDeviceSettingsPanel, n as RecorderDeviceSettingsPanelProps, o as RecorderEncodingSettings, p as RecorderModal, q as RecorderModalProps, r as RecorderNarrationOptions, s as RecorderPanel, t as RecorderPanelProps, u as RecorderSaveResult, v as RecorderScreenAudioSettings, w as RecorderScreenDeviceSettings, S as ScreenStreamHandle, x as ScreenStreamOptions, T as TimingJson, y as buildRecorderAudioConstraints, z as buildRecorderCameraConstraints, A as buildRecorderScreenAudioConstraints, B as buildRecorderScreenConstraints, E as buildTimingJson, F as encodeTimingJson, G as hasRecorderDeviceChoice, H as recordedMediaKind, I as recorderBitsPerSecond, J as recorderDeviceGroups, K as recorderDeviceOptions, L as requestCameraStream, N as requestMicStream, O as requestScreenStream, P as timingPathFor, Q as useMediaDevices, U as useStreamPreview } from './recorder-DFP0Dw4v.js';
 export { C as CanvasSink, a as CaptureKind, D as DEFAULT_TELEPROMPTER_PREFS, F as FloatOpenOptions, b as FloatTier, c as FloatingWindowHandle, d as FloatingWindowManager, M as MicAnalysisHandle, e as MicAnalysisStatus, N as NarrationRecorderController, f as NarrationRecorderState, g as NarrationStageHandle, h as NarrationTake, P as PrompterTransport, R as RecorderAudioBitrateMode, i as RecorderCameraLane, j as RecorderExtendedMediaOptions, k as RecorderSource, l as RecorderState, m as ResolvedFormat, T as TeleprompterController, n as TeleprompterPrefs, o as TeleprompterRecordingDeps, U as UseMediaRecorderOptions, p as UseMediaRecorderResult, q as UseNarrationStageOptions, r as buildFilename, s as createFloatingWindowManager, t as detectFloatTiers, u as getCaptureKind, v as resolveFormat, w as supportsDisplayMedia, x as supportsMediaRecorder, y as supportsUserMedia, z as useFloatingWindow, A as useMediaRecorder, B as useMicAnalysis, E as useNarrationRecorder, G as useNarrationStage, H as useTeleprompter, I as vadConfigForSensitivity } from './useNarrationStage-Bk3mdW75.js';
 export { EYE_LINE_FRACTION, NarrationSavePlan, NarrationSaveResult, NarrationStage, NarrationStageProps, PCM_WORKLET_NAME, PCM_WORKLET_SOURCE, TELEPROMPTER_CSS, TeleprompterControls, TeleprompterControlsProps, TeleprompterSurface, TeleprompterSurfaceProps, TeleprompterView, TeleprompterViewProps, TokenLineMap, buildNarrationSavePlan, cameraVideoLine, ensureTeleprompterStyles, executeNarrationSave, insertNarrationPreamble, measureTokenLines, narrationAnnotationLine, prompterVarsFromTheme, registerPcmWorklet, stepScroll, targetOffsetFor } from './teleprompter/index.js';
 import '@bendyline/squisq/versions';
@@ -1611,46 +1612,6 @@ declare function markdownToTiptap(markdown: string): string;
  */
 declare function tiptapToMarkdown(html: string): string;
 
-/**
- * buildPreviewDoc — Converts a markdown-derived Doc into a player-ready Doc
- * with TemplateBlock slides and interleaved images.
- *
- * Shared between PreviewPanel (live preview) and export flows (HTML/video).
- *
- * Pipeline:
- * 1. Flatten hierarchical blocks into a linear slide sequence
- * 2. Convert each block into a TemplateBlock-compatible object
- * 3. Interleave images as standalone imageWithCaption slides
- * 4. Synthesize a dummy audio segment for timer-based playback
- */
-
-/**
- * Build a player-ready Doc from a markdown-derived Doc.
- *
- * Flattens hierarchical blocks, converts each to a TemplateBlock-compatible
- * slide, interleaves images, recalculates timing, and adds a synthetic
- * audio segment.
- */
-interface BuildPreviewDocOptions {
-    /**
-     * Human-facing title to use as the header of the leading heading-less
-     * "preamble" block when the document has no frontmatter `title:`. Hosts
-     * typically pass the file name (extension stripped) via
-     * {@link documentTitleFromFileName}. When neither this nor a frontmatter
-     * title is present, the preamble simply renders with no header rather than
-     * the placeholder block id.
-     */
-    documentTitle?: string;
-}
-/**
- * Derive a display title from a file name: strip any directory prefix and the
- * trailing extension (`docs/Longview Plan.md` → `Longview Plan`). Returns an
- * empty string for an absent/blank name so callers can pass the result through
- * without extra guards.
- */
-declare function documentTitleFromFileName(fileName?: string): string;
-declare function buildPreviewDoc(doc: Doc, options?: BuildPreviewDocOptions): Doc;
-
 /**
  * TemplateAnnotation — Tiptap Heading Extension
  *
@@ -2729,6 +2690,9 @@ declare function shouldPasteAsTreeFence(text: string): boolean;
  * text in one undoable transaction; the info-string meta is NOT provided
  * (it does not survive the ProseMirror round-trip — payload lives in the
  * body, see the fence contract docs).
+ *
+ * The React surface lives in `HostFenceWidget.tsx`, mirroring how every
+ * other fence family splits its `.ts` extension from its `.tsx` widget.
  */
 
 type HostFenceBlockEntry = FenceBlockEntry;
@@ -2959,4 +2923,4 @@ declare function applyTimelineCommand(editor: Editor, blockId: string, command:
 /** Paste gate for bare, high-confidence Unicode timeline art. */
 declare function shouldPasteAsTimelineFence(text: string): boolean;
 
-export { ALL_PICKER_ENTRIES, type AddTimelineEventOptions, type AddTimelineEventResult, type ApplyAsciiDiagramCommandOptions, type AsciiDiagramBlockEntry, AsciiDiagramExtension, type AsciiDiagramExtensionOptions, type AsciiDiagramPluginState, type AsciiDiagramView, AsciiDiagramWidget, BlockCardView, type BlockCardViewProps, type BlockNavigator, BlockPropertiesPopover, type BlockPropertiesPopoverProps, type BlockRange, type BlockSlice, type BuildPreviewDocOptions, CODE_SNIPPET_KEY, CODE_SNIPPET_LANGUAGES, CodeContext, CodeContextZones, type CodeSnippetBlockEntry, type CodeSnippetData, CodeSnippetExtension, type CodeSnippetExtensionOptions, type CodeSnippetLanguage, type CodeSnippetPluginState, CodeSnippetWidget, type CodeSnippetWidgetProps, type CustomTemplateContextValue, CustomTemplateProvider, type CustomTemplateProviderProps, type CustomThemeContextValue, CustomThemeProvider, type CustomThemeProviderProps, DEFAULT_MERMAID_DIAGRAM_TYPE, DiagramCanvas, type DiagramCommand, type DiagramData, type DiagramEdge, type DiagramNode, type DirectionModel, type DocCustomTemplates, type DocCustomThemes, DocumentSettingsDialog, type DocumentSettingsDialogProps, type DragContentType, type DropTarget, DropZoneOverlay, type DropZoneOverlayProps, EMPTY_TRANSITION, EditorHostMode, EmojiPicker, type EmojiPickerProps, FENCE_WIDGET_CONTAINED_EVENTS, type FenceBlockEntry, type FileCategory, type FileKind, type FolderEntry, FolderView, type FolderViewProps, HOST_FENCE_KEY, type HeadingTransitionAttrs, HeadingWithTemplate, type HostFenceBlockEntry, HostFenceExtension, type HostFenceExtensionOptions, type HostFencePluginState, ImportThemeSection, type ImportThemeSectionProps, type ImportedThemeResult, InlinePreviewGutter, type InlinePreviewGutterProps, MERMAID_DIAGRAM_KEY, MERMAID_DIAGRAM_TYPES, MERMAID_FLOWCHART_SHAPES, MediaBin, type MediaBinProps, type MediaClipPatch, type MermaidDiagramBlockEntry, MermaidDiagramCanvas, type MermaidDiagramCanvasProps, type MermaidDiagramCategory, type MermaidDiagramData, MermaidDiagramExtension, type MermaidDiagramExtensionOptions, type MermaidDiagramPluginState, type MermaidDiagramPreview, type MermaidDiagramProperty, type MermaidDiagramType, MermaidDiagramTypeThumbnail, MermaidDiagramWidget, type MermaidDiagramWidgetProps, type MermaidEditCapabilities, type MermaidEditableDiagramKind, type MermaidEditableEdge, type MermaidEditableModel, type MermaidEditableNode, type MermaidEditableText, type MermaidEditableTextTarget, type MermaidFlowchartDirection, type MermaidFlowchartModel, type MermaidFlowchartShape, type MermaidFlowchartShapeId, type MermaidNodeCanvasAction, type MermaidRenderResult, type MermaidSelection, MermaidShapePalette, type MermaidShapePaletteProps, type MermaidSourceEditableModel, MonacoLanguageLoadOptions, MonacoLanguageRequest, OutlinePanel, type OutlinePanelProps, PICKER_CATEGORIES, type PickerCategory, type PickerEntry, PlainHtmlPreview, type PlainHtmlPreviewProps, PreviewFormatSwitch, PreviewModeMenu, PreviewModeSwitch, type PreviewSettings, PreviewSettingsProvider, PreviewToolbarControls, type PreviewToolbarControlsProps, REPAIRABLE_KEY, type RepairableBlockEntry, RepairableDiagramExtension, type RepairableDiagramExtensionOptions, type RepairablePluginState, StatusBar, type StatusBarProps, TIMELINE_VIEW_KEY, TRANSITION_ENTRIES, TRANSITION_GROUPS, TemplatePicker, ThemeCustomizerPanel, type ThemeCustomizerPanelProps, ThemePicker, type ThemePickerProps, type ThemeSaveExtras, type TimelineBlockEntry, type TimelineCommand, type TimelineCommandResult, TimelineCompositionPanel, type TimelineCompositionPanelProps, TimelineEditorWidget, type TimelineEditorWidgetProps, type TimelineEventPatch, TimelineToolbar, type TimelineToolbarProps, TimelineTrack, type TimelineTrackProps, TimelineVideoPanel, type TimelineVideoPanelProps, type TimelineViewData, TimelineViewExtension, type TimelineViewExtensionOptions, type TimelineViewPluginState, Toolbar, type ToolbarProps, TooltipLayer, TransformMenu, type TransitionCatalogEntry, type TransitionFields, type TransitionGroup, TransitionPicker, type TransitionPickerProps, type TreeBlockEntry, type TreeCommand, TreeOutlineWidget, type TreeViewData, TreeViewExtension, type TreeViewExtensionOptions, type TreeViewPluginState, type UseBlockNavigatorOptions, type UseFileDropOptions, type UseFileDropResult, type UseMonacoLoaderResult, VersionHistoryPanel, ViewMenuPanel, ViewSwitcher, type ViewSwitcherProps, type WrapPolicyIngest, addEdgeOp, addItemOp, addNodeOp, addTimelineEventOp, applyAsciiDiagramCommand, applyRepairCommand, applyTimelineCommand, applyTreeCommand, asciiDiagramToCanvas, buildPreviewDoc, classifyFile, codeSnippetFenceLanguageToken, codeSnippetLanguageLabel, codeSnippetMarkdown, containFenceWidgetEvents, detectLanguageFromFileName, documentTitleFromFileName, draftPatchFromImportedTheme, findAsciiDiagramBlockPos, findCodeSnippetBlockPos, findHostFenceBlockPos, findMermaidDiagramBlockPos, findRepairableBlockPos, findTimelineBlockPos, findTransitionEntry, findTreeBlockPos, formatSeconds, getBlockSlices, getTimelineForNode, indentItemOp, ingestForWrite, inspectMermaidSource, isAsciiSourceVisible, isCodeSnippetFenceLanguage, isCodeSnippetNode, isMermaidDiagramNode, isMermaidFlowchartShapeId, isMermaidSourceVisible, isRepairableFence, isTimelineSourceSafeForSemanticEdit, lineToOffset, mapFenceEntries, markdownToTiptap, mermaidDiagramMarkdown, mermaidDiagramProperties, mermaidEditCapabilities, mermaidEditableTexts, mermaidErrorMessage, monacoLanguageForFence, moveItemDownOp, moveItemUpOp, moveNodeOp, nextTimelineEventId, normalizeMermaidFlowchartShape, offsetToLine, outdentItemOp, parseTimelineForNode, partitionFiles, persistFromWrite, preloadMonaco, preloadMonacoSuggestions, processMediaFiles, processTextFile, processTextFiles, readBlockAttrsParams, readBlockAttrsTransition, readBlockAttrsValue, readHeadingLineTransition, removeEdgeOp, removeItemOp, removeNodeOp, removeTimelineEventOp, renameItemOp, renameNodeOp, renderMermaidDiagram, replaceAsciiFenceText, replaceCodeSnippetText, replaceHostFenceText, replaceAsciiFenceText as replaceTreeFenceText, resizeNodeOp, resolveFileKind, sanitizeAsciiLabel, sanitizeTimelineText, sanitizeTreeLabel, searchPickerEntries, setBlockAttrsValue, setBlockDurationInSource, setBlockStartTimeInSource, setBlockTransitionInSource, setHeadingAttrsTransition, setHeadingLineTransition, setMediaClipInSource, shouldPasteAsAsciiFence, shouldPasteAsTimelineFence, shouldPasteAsTreeFence, sliceIndexAtOffset, spliceBlock, summarizeBlockProps, templateLabel, tiptapToMarkdown, toggleAsciiSource, toggleDirOp, toggleMermaidSource, transitionLabel, translateDiagramOp, updateTimelineEventOp, useAsciiDiagramData, useBlockNavigator, useCodeSnippetData, useCustomTemplates, useCustomThemes, useDocCustomTemplates, useDocCustomThemes, useFileDrop, useMermaidDiagramData, useMonacoLoader, usePreviewSettings, useTimelineData, useTreeViewData };
+export { ALL_PICKER_ENTRIES, type AddTimelineEventOptions, type AddTimelineEventResult, type ApplyAsciiDiagramCommandOptions, type AsciiDiagramBlockEntry, AsciiDiagramExtension, type AsciiDiagramExtensionOptions, type AsciiDiagramPluginState, type AsciiDiagramView, AsciiDiagramWidget, BlockCardView, type BlockCardViewProps, type BlockNavigator, BlockPropertiesPopover, type BlockPropertiesPopoverProps, type BlockRange, type BlockSlice, CODE_SNIPPET_KEY, CODE_SNIPPET_LANGUAGES, CodeContext, CodeContextZones, type CodeSnippetBlockEntry, type CodeSnippetData, CodeSnippetExtension, type CodeSnippetExtensionOptions, type CodeSnippetLanguage, type CodeSnippetPluginState, CodeSnippetWidget, type CodeSnippetWidgetProps, type CustomTemplateContextValue, CustomTemplateProvider, type CustomTemplateProviderProps, type CustomThemeContextValue, CustomThemeProvider, type CustomThemeProviderProps, DEFAULT_MERMAID_DIAGRAM_TYPE, DiagramCanvas, type DiagramCommand, type DiagramData, type DiagramEdge, type DiagramNode, type DirectionModel, type DocCustomTemplates, type DocCustomThemes, DocumentSettingsDialog, type DocumentSettingsDialogProps, type DragContentType, type DropTarget, DropZoneOverlay, type DropZoneOverlayProps, EMPTY_TRANSITION, EditorHostMode, EmojiPicker, type EmojiPickerProps, FENCE_WIDGET_CONTAINED_EVENTS, type FenceBlockEntry, type FileCategory, type FileKind, type FolderEntry, FolderView, type FolderViewProps, HOST_FENCE_KEY, type HeadingTransitionAttrs, HeadingWithTemplate, type HostFenceBlockEntry, HostFenceExtension, type HostFenceExtensionOptions, type HostFencePluginState, ImportThemeSection, type ImportThemeSectionProps, type ImportedThemeResult, InlinePreviewGutter, type InlinePreviewGutterProps, MERMAID_DIAGRAM_KEY, MERMAID_DIAGRAM_TYPES, MERMAID_FLOWCHART_SHAPES, MediaBin, type MediaBinProps, type MediaClipPatch, type MermaidDiagramBlockEntry, MermaidDiagramCanvas, type MermaidDiagramCanvasProps, type MermaidDiagramCategory, type MermaidDiagramData, MermaidDiagramExtension, type MermaidDiagramExtensionOptions, type MermaidDiagramPluginState, type MermaidDiagramPreview, type MermaidDiagramProperty, type MermaidDiagramType, MermaidDiagramTypeThumbnail, MermaidDiagramWidget, type MermaidDiagramWidgetProps, type MermaidEditCapabilities, type MermaidEditableDiagramKind, type MermaidEditableEdge, type MermaidEditableModel, type MermaidEditableNode, type MermaidEditableText, type MermaidEditableTextTarget, type MermaidFlowchartDirection, type MermaidFlowchartModel, type MermaidFlowchartShape, type MermaidFlowchartShapeId, type MermaidNodeCanvasAction, type MermaidRenderResult, type MermaidSelection, MermaidShapePalette, type MermaidShapePaletteProps, type MermaidSourceEditableModel, MonacoLanguageLoadOptions, MonacoLanguageRequest, OutlinePanel, type OutlinePanelProps, PICKER_CATEGORIES, type PickerCategory, type PickerEntry, PlainHtmlPreview, type PlainHtmlPreviewProps, PreviewFormatSwitch, PreviewModeMenu, PreviewModeSwitch, type PreviewSettings, PreviewSettingsProvider, PreviewToolbarControls, type PreviewToolbarControlsProps, REPAIRABLE_KEY, type RepairableBlockEntry, RepairableDiagramExtension, type RepairableDiagramExtensionOptions, type RepairablePluginState, StatusBar, type StatusBarProps, TIMELINE_VIEW_KEY, TRANSITION_ENTRIES, TRANSITION_GROUPS, TemplatePicker, ThemeCustomizerPanel, type ThemeCustomizerPanelProps, ThemePicker, type ThemePickerProps, type ThemeSaveExtras, type TimelineBlockEntry, type TimelineCommand, type TimelineCommandResult, TimelineCompositionPanel, type TimelineCompositionPanelProps, TimelineEditorWidget, type TimelineEditorWidgetProps, type TimelineEventPatch, TimelineToolbar, type TimelineToolbarProps, TimelineTrack, type TimelineTrackProps, TimelineVideoPanel, type TimelineVideoPanelProps, type TimelineViewData, TimelineViewExtension, type TimelineViewExtensionOptions, type TimelineViewPluginState, Toolbar, type ToolbarProps, TooltipLayer, TransformMenu, type TransitionCatalogEntry, type TransitionFields, type TransitionGroup, TransitionPicker, type TransitionPickerProps, type TreeBlockEntry, type TreeCommand, TreeOutlineWidget, type TreeViewData, TreeViewExtension, type TreeViewExtensionOptions, type TreeViewPluginState, type UseBlockNavigatorOptions, type UseFileDropOptions, type UseFileDropResult, type UseMonacoLoaderResult, VersionHistoryPanel, ViewMenuPanel, ViewSwitcher, type ViewSwitcherProps, type WrapPolicyIngest, addEdgeOp, addItemOp, addNodeOp, addTimelineEventOp, applyAsciiDiagramCommand, applyRepairCommand, applyTimelineCommand, applyTreeCommand, asciiDiagramToCanvas, classifyFile, codeSnippetFenceLanguageToken, codeSnippetLanguageLabel, codeSnippetMarkdown, containFenceWidgetEvents, detectLanguageFromFileName, draftPatchFromImportedTheme, findAsciiDiagramBlockPos, findCodeSnippetBlockPos, findHostFenceBlockPos, findMermaidDiagramBlockPos, findRepairableBlockPos, findTimelineBlockPos, findTransitionEntry, findTreeBlockPos, formatSeconds, getBlockSlices, getTimelineForNode, indentItemOp, ingestForWrite, inspectMermaidSource, isAsciiSourceVisible, isCodeSnippetFenceLanguage, isCodeSnippetNode, isMermaidDiagramNode, isMermaidFlowchartShapeId, isMermaidSourceVisible, isRepairableFence, isTimelineSourceSafeForSemanticEdit, lineToOffset, mapFenceEntries, markdownToTiptap, mermaidDiagramMarkdown, mermaidDiagramProperties, mermaidEditCapabilities, mermaidEditableTexts, mermaidErrorMessage, monacoLanguageForFence, moveItemDownOp, moveItemUpOp, moveNodeOp, nextTimelineEventId, normalizeMermaidFlowchartShape, offsetToLine, outdentItemOp, parseTimelineForNode, partitionFiles, persistFromWrite, preloadMonaco, preloadMonacoSuggestions, processMediaFiles, processTextFile, processTextFiles, readBlockAttrsParams, readBlockAttrsTransition, readBlockAttrsValue, readHeadingLineTransition, removeEdgeOp, removeItemOp, removeNodeOp, removeTimelineEventOp, renameItemOp, renameNodeOp, renderMermaidDiagram, replaceAsciiFenceText, replaceCodeSnippetText, replaceHostFenceText, replaceAsciiFenceText as replaceTreeFenceText, resizeNodeOp, resolveFileKind, sanitizeAsciiLabel, sanitizeTimelineText, sanitizeTreeLabel, searchPickerEntries, setBlockAttrsValue, setBlockDurationInSource, setBlockStartTimeInSource, setBlockTransitionInSource, setHeadingAttrsTransition, setHeadingLineTransition, setMediaClipInSource, shouldPasteAsAsciiFence, shouldPasteAsTimelineFence, shouldPasteAsTreeFence, sliceIndexAtOffset, spliceBlock, summarizeBlockProps, templateLabel, tiptapToMarkdown, toggleAsciiSource, toggleDirOp, toggleMermaidSource, transitionLabel, translateDiagramOp, updateTimelineEventOp, useAsciiDiagramData, useBlockNavigator, useCodeSnippetData, useCustomTemplates, useCustomThemes, useDocCustomTemplates, useDocCustomThemes, useFileDrop, useMermaidDiagramData, useMonacoLoader, usePreviewSettings, useTimelineData, useTreeViewData };

package/dist/index.js

@@ -201,7 +201,7 @@ import {
   usePreviewSettings,
   useTimelineData,
   useTreeViewData
-} from "./chunk-NJ2VKEQF.js";
+} from "./chunk-BYXVO34Z.js";
 import "./chunk-V4NBQF5C.js";
 import {
   JsonEditor
@@ -219,9 +219,10 @@ import {
 } from "./chunk-V44VP242.js";
 import {
   RecorderButton
-} from "./chunk-WH3DL6TG.js";
+} from "./chunk-AZ5ME4XG.js";
 import {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
+  RecorderDeviceQuickPicks,
   RecorderDeviceSettingsPanel,
   RecorderModal,
   RecorderPanel,
@@ -230,11 +231,15 @@ import {
   buildRecorderScreenAudioConstraints,
   buildRecorderScreenConstraints,
   getCaptureKind,
+  hasRecorderDeviceChoice,
   recordedMediaKind,
   recorderBitsPerSecond,
+  recorderDeviceGroups,
+  recorderDeviceOptions,
   requestScreenStream,
+  useMediaDevices,
   useMediaRecorder
-} from "./chunk-JUAQQTJE.js";
+} from "./chunk-V3J5S7X6.js";
 import "./chunk-GS7QWYFT.js";
 import {
   TeleprompterView
@@ -759,6 +764,7 @@ export {
   REPAIRABLE_KEY,
   RawEditor,
   RecorderButton,
+  RecorderDeviceQuickPicks,
   RecorderDeviceSettingsPanel,
   RecorderModal,
   RecorderPanel,
@@ -834,6 +840,7 @@ export {
   getBlockSlices,
   getCaptureKind,
   getTimelineForNode,
+  hasRecorderDeviceChoice,
   imageEditorReducer,
   indentItemOp,
   ingestForWrite,
@@ -881,6 +888,8 @@ export {
   readHeadingLineTransition,
   recordedMediaKind,
   recorderBitsPerSecond,
+  recorderDeviceGroups,
+  recorderDeviceOptions,
   registerPcmWorklet,
   removeEdgeOp,
   removeItemOp,
@@ -941,6 +950,7 @@ export {
   useFileDrop,
   useFloatingWindow,
   useImageEditor,
+  useMediaDevices,
   useMediaRecorder,
   useMermaidDiagramData,
   useMicAnalysis,

package/dist/recorder/index.d.ts

@@ -1,4 +1,4 @@
-export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, R as RecordedBookmark, a as RecordedMediaKind, b as RecorderAudioDeviceSettings, c as RecorderButton, d as RecorderButtonProps, e as RecorderCameraDeviceSettings, f as RecorderCameraSaveResult, g as RecorderColorScheme, h as RecorderConstraintMode, i as RecorderDeviceSettings, j as RecorderDeviceSettingsPanel, k as RecorderDeviceSettingsPanelProps, l as RecorderEncodingSettings, m as RecorderModal, n as RecorderModalProps, p as RecorderPanel, q as RecorderPanelProps, r as RecorderSaveResult, s as RecorderScreenAudioSettings, t as RecorderScreenDeviceSettings, S as ScreenStreamHandle, u as ScreenStreamOptions, T as TimingJson, v as buildRecorderAudioConstraints, w as buildRecorderCameraConstraints, x as buildRecorderScreenAudioConstraints, y as buildRecorderScreenConstraints, z as buildTimingJson, A as encodeTimingJson, B as recordedMediaKind, E as recorderBitsPerSecond, F as requestCameraStream, G as requestMicStream, H as requestScreenStream, I as timingPathFor, J as useStreamPreview } from '../recorder-xL-5Vfbu.js';
+export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, M as MediaDeviceInventory, R as RecordedBookmark, a as RecordedMediaKind, b as RecorderAudioDeviceSettings, c as RecorderButton, d as RecorderButtonProps, e as RecorderCameraDeviceSettings, f as RecorderCameraSaveResult, g as RecorderColorScheme, h as RecorderConstraintMode, i as RecorderDeviceOption, j as RecorderDeviceQuickPicks, k as RecorderDeviceQuickPicksProps, l as RecorderDeviceSettings, m as RecorderDeviceSettingsPanel, n as RecorderDeviceSettingsPanelProps, o as RecorderEncodingSettings, p as RecorderModal, q as RecorderModalProps, s as RecorderPanel, t as RecorderPanelProps, u as RecorderSaveResult, v as RecorderScreenAudioSettings, w as RecorderScreenDeviceSettings, S as ScreenStreamHandle, x as ScreenStreamOptions, T as TimingJson, y as buildRecorderAudioConstraints, z as buildRecorderCameraConstraints, A as buildRecorderScreenAudioConstraints, B as buildRecorderScreenConstraints, E as buildTimingJson, F as encodeTimingJson, G as hasRecorderDeviceChoice, H as recordedMediaKind, I as recorderBitsPerSecond, J as recorderDeviceGroups, K as recorderDeviceOptions, L as requestCameraStream, N as requestMicStream, O as requestScreenStream, P as timingPathFor, Q as useMediaDevices, U as useStreamPreview } from '../recorder-DFP0Dw4v.js';
 export { a as CaptureKind, R as RecorderAudioBitrateMode, i as RecorderCameraLane, j as RecorderExtendedMediaOptions, k as RecorderSource, l as RecorderState, m as ResolvedFormat, U as UseMediaRecorderOptions, p as UseMediaRecorderResult, r as buildFilename, u as getCaptureKind, v as resolveFormat, w as supportsDisplayMedia, x as supportsMediaRecorder, y as supportsUserMedia, A as useMediaRecorder } from '../useNarrationStage-Bk3mdW75.js';
 import 'react/jsx-runtime';
 import '@bendyline/squisq/schemas';

package/dist/recorder/index.js

@@ -1,8 +1,9 @@
 import {
   RecorderButton
-} from "../chunk-WH3DL6TG.js";
+} from "../chunk-AZ5ME4XG.js";
 import {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
+  RecorderDeviceQuickPicks,
   RecorderDeviceSettingsPanel,
   RecorderModal,
   RecorderPanel,
@@ -11,11 +12,15 @@ import {
   buildRecorderScreenAudioConstraints,
   buildRecorderScreenConstraints,
   getCaptureKind,
+  hasRecorderDeviceChoice,
   recordedMediaKind,
   recorderBitsPerSecond,
+  recorderDeviceGroups,
+  recorderDeviceOptions,
   requestScreenStream,
+  useMediaDevices,
   useMediaRecorder
-} from "../chunk-JUAQQTJE.js";
+} from "../chunk-V3J5S7X6.js";
 import "../chunk-GS7QWYFT.js";
 import {
   buildFilename,
@@ -33,6 +38,7 @@ import {
 export {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderButton,
+  RecorderDeviceQuickPicks,
   RecorderDeviceSettingsPanel,
   RecorderModal,
   RecorderPanel,
@@ -44,8 +50,11 @@ export {
   buildTimingJson,
   encodeTimingJson,
   getCaptureKind,
+  hasRecorderDeviceChoice,
   recordedMediaKind,
   recorderBitsPerSecond,
+  recorderDeviceGroups,
+  recorderDeviceOptions,
   requestCameraStream,
   requestMicStream,
   requestScreenStream,
@@ -54,6 +63,7 @@ export {
   supportsMediaRecorder,
   supportsUserMedia,
   timingPathFor,
+  useMediaDevices,
   useMediaRecorder,
   useStreamPreview
 };

package/dist/{recorder-xL-5Vfbu.d.ts → recorder-DFP0Dw4v.d.ts}

@@ -240,6 +240,105 @@ interface RecorderDeviceSettingsPanelProps {
 }
 declare function RecorderDeviceSettingsPanel({ value, onChange, disabled, microphoneEnabled, cameraEnabled, screenEnabled, systemAudioEnabled, separateAudioRecorder, primaryStream, cameraStream, }: RecorderDeviceSettingsPanelProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Microphone / camera pickers promoted out of "Advanced device settings".
+ *
+ * Choosing WHICH microphone or camera to record is an everyday decision on a
+ * machine that has more than one, and burying it under a disclosure whose
+ * other twenty fields are constraint plumbing puts it in the wrong place. Each
+ * picker therefore appears inline when — and only when — two conditions hold:
+ * its source is enabled, and the browser reports more than one real device of
+ * that kind (see `recorderDeviceOptions` for what "real" excludes). A machine
+ * with a single webcam gets no camera picker, because there is nothing to pick.
+ *
+ * These are the SAME selects as the ones in the advanced panel, bound to the
+ * same `RecorderDeviceSettings` and rendering the same option list — a
+ * shortcut to one setting, never a second source of truth.
+ */
+interface RecorderDeviceQuickPicksProps {
+    /** Enumerated devices, typically from `useMediaDevices()`. */
+    devices: readonly MediaDeviceInfo[];
+    microphoneEnabled: boolean;
+    cameraEnabled: boolean;
+    audioDeviceId: string;
+    cameraDeviceId: string;
+    onAudioDeviceChange: (deviceId: string) => void;
+    onCameraDeviceChange: (deviceId: string) => void;
+    disabled?: boolean;
+}
+declare function RecorderDeviceQuickPicks({ devices, microphoneEnabled, cameraEnabled, audioDeviceId, cameraDeviceId, onAudioDeviceChange, onCameraDeviceChange, disabled, }: RecorderDeviceQuickPicksProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Turning an `enumerateDevices()` result into the option list a recorder
+ * device picker should show — and answering "does the user actually have a
+ * choice here?", which is what decides whether a picker is worth surfacing
+ * outside Advanced settings.
+ *
+ * Two kinds of entry are dropped:
+ *
+ * - **Alias ids.** Chromium reports `deviceId: 'default'` and
+ *   `'communications'` for audio inputs: synthetic entries that POINT AT a
+ *   real device further down the list. Counting them makes a single-microphone
+ *   machine look like it has three. A picker's own "System default" choice
+ *   (the empty deviceId — no constraint at all) already covers that intent.
+ * - **Blank ids.** Before the first permission grant, browsers return one
+ *   label-less, id-less entry per device. There is nothing to select, so those
+ *   are placeholders, not choices.
+ *
+ * The currently-selected id is always kept, even when a rule above would drop
+ * it, so a setting persisted from an earlier session can never silently vanish
+ * from the control that owns it.
+ */
+/** One selectable capture device. */
+interface RecorderDeviceOption {
+    deviceId: string;
+    /** `device.label`, or a positional fallback when labels are withheld. */
+    label: string;
+    groupId: string;
+}
+/**
+ * The real, selectable devices of one kind. Excludes the synthetic
+ * "System default" entry a picker renders itself.
+ */
+declare function recorderDeviceOptions(devices: readonly MediaDeviceInfo[], kind: MediaDeviceKind, noun: string, selectedDeviceId?: string): RecorderDeviceOption[];
+/**
+ * True when more than one real device exists — i.e. picking between them is a
+ * decision the user could meaningfully make, rather than a control that can
+ * only ever restate the system default.
+ */
+declare function hasRecorderDeviceChoice(options: readonly RecorderDeviceOption[]): boolean;
+/** Distinct hardware groups represented by an option list, in first-seen order. */
+declare function recorderDeviceGroups(options: readonly RecorderDeviceOption[]): Array<{
+    id: string;
+    label: string;
+}>;
+
+/**
+ * Live `enumerateDevices()` inventory plus the browser's supported-constraint
+ * map, shared by every recorder surface that offers a device picker.
+ *
+ * Enumeration is best effort: browsers withhold labels — and sometimes ids —
+ * until the first permission grant, and that grant frequently does NOT fire
+ * `devicechange`. Callers holding a preview stream should therefore call
+ * `refresh()` when it lands:
+ *
+ * ```ts
+ * const { devices, refresh } = useMediaDevices();
+ * useEffect(() => {
+ *   if (micStream || cameraStream) refresh();
+ * }, [micStream, cameraStream, refresh]);
+ * ```
+ */
+/** What the browser will tell us about capture devices right now. */
+interface MediaDeviceInventory {
+    devices: MediaDeviceInfo[];
+    /** `getSupportedConstraints()`, or null when the browser withholds it. */
+    supported: Record<string, boolean> | null;
+    /** Re-enumerate — call after a permission grant reveals labels. */
+    refresh: () => void;
+}
+declare function useMediaDevices(): MediaDeviceInventory;
+
 /**
  * useStreamPreview — binds a `MediaStream` to a `<video>` element's
  * `srcObject`. Decouples the preview surface from `useMediaRecorder`,
@@ -412,4 +511,4 @@ declare function encodeTimingJson(timing: TimingJson): Uint8Array;
  */
 declare function timingPathFor(audioRelativePath: string): string;
 
-export { encodeTimingJson as A, recordedMediaKind as B, type CameraStreamOptions as C, DEFAULT_RECORDER_DEVICE_SETTINGS as D, recorderBitsPerSecond as E, requestCameraStream as F, requestMicStream as G, requestScreenStream as H, timingPathFor as I, useStreamPreview as J, type RecordedBookmark as R, type ScreenStreamHandle as S, type TimingJson as T, type RecordedMediaKind as a, type RecorderAudioDeviceSettings as b, RecorderButton as c, type RecorderButtonProps as d, type RecorderCameraDeviceSettings as e, type RecorderCameraSaveResult as f, type RecorderColorScheme as g, type RecorderConstraintMode as h, type RecorderDeviceSettings as i, RecorderDeviceSettingsPanel as j, type RecorderDeviceSettingsPanelProps as k, type RecorderEncodingSettings as l, RecorderModal as m, type RecorderModalProps as n, type RecorderNarrationOptions as o, RecorderPanel as p, type RecorderPanelProps as q, type RecorderSaveResult as r, type RecorderScreenAudioSettings as s, type RecorderScreenDeviceSettings as t, type ScreenStreamOptions as u, buildRecorderAudioConstraints as v, buildRecorderCameraConstraints as w, buildRecorderScreenAudioConstraints as x, buildRecorderScreenConstraints as y, buildTimingJson as z };
+export { buildRecorderScreenAudioConstraints as A, buildRecorderScreenConstraints as B, type CameraStreamOptions as C, DEFAULT_RECORDER_DEVICE_SETTINGS as D, buildTimingJson as E, encodeTimingJson as F, hasRecorderDeviceChoice as G, recordedMediaKind as H, recorderBitsPerSecond as I, recorderDeviceGroups as J, recorderDeviceOptions as K, requestCameraStream as L, type MediaDeviceInventory as M, requestMicStream as N, requestScreenStream as O, timingPathFor as P, useMediaDevices as Q, type RecordedBookmark as R, type ScreenStreamHandle as S, type TimingJson as T, useStreamPreview as U, type RecordedMediaKind as a, type RecorderAudioDeviceSettings as b, RecorderButton as c, type RecorderButtonProps as d, type RecorderCameraDeviceSettings as e, type RecorderCameraSaveResult as f, type RecorderColorScheme as g, type RecorderConstraintMode as h, type RecorderDeviceOption as i, RecorderDeviceQuickPicks as j, type RecorderDeviceQuickPicksProps as k, type RecorderDeviceSettings as l, RecorderDeviceSettingsPanel as m, type RecorderDeviceSettingsPanelProps as n, type RecorderEncodingSettings as o, RecorderModal as p, type RecorderModalProps as q, type RecorderNarrationOptions as r, RecorderPanel as s, type RecorderPanelProps as t, type RecorderSaveResult as u, type RecorderScreenAudioSettings as v, type RecorderScreenDeviceSettings as w, type ScreenStreamOptions as x, buildRecorderAudioConstraints as y, buildRecorderCameraConstraints as z };

package/dist/shell/index.js

@@ -5,11 +5,11 @@ import {
   RawEditor,
   WysiwygEditor,
   useEditorContext
-} from "../chunk-NJ2VKEQF.js";
+} from "../chunk-BYXVO34Z.js";
 import "../chunk-V4NBQF5C.js";
 import "../chunk-K2WJYVS4.js";
 import "../chunk-V44VP242.js";
-import "../chunk-JUAQQTJE.js";
+import "../chunk-V3J5S7X6.js";
 import "../chunk-GS7QWYFT.js";
 import "../chunk-IQFPX2CE.js";
 import "../chunk-OWOKKZAU.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-editor-react",
-  "version": "2.7.0",
+  "version": "2.7.1",
   "description": "React editor shell with raw/WYSIWYG/preview modes for Squisq documents",
   "license": "MIT",
   "author": "Bendyline",
@@ -84,10 +84,10 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.7.0",
-    "@bendyline/squisq-formats": "2.4.1",
-    "@bendyline/squisq-react": "2.7.0",
-    "@bendyline/squisq-video-react": "2.3.2",
+    "@bendyline/squisq": "2.7.1",
+    "@bendyline/squisq-formats": "2.4.2",
+    "@bendyline/squisq-react": "2.7.1",
+    "@bendyline/squisq-video-react": "2.3.3",
     "@fortawesome/fontawesome-free": "7.2.0",
     "@tiptap/core": "2.27.2",
     "@tiptap/extension-heading": "2.27.2",