@bendyline/squisq-editor-react 2.6.0 → 2.7.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CodeContext, E as EditorHostMode, S as SceneTextChannel } from './shell-BXG_NlvR.js';
-export { B as BlockTagVisibility, a as CodeContextSection, D as DocumentLinkCandidate, b as DocumentLinkProvider, c as EditorActions, d as EditorColorScheme, e as EditorContextValue, f as EditorMode, g as EditorProvider, h as EditorProviderProps, i as EditorShell, j as EditorShellProps, k as EditorState, l as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, m as MentionProvider, P as PreviewPanel, n as PreviewPanelProps, R as RawEditor, o as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, W as WriteCanvasSettings, p as WysiwygEditor, q as WysiwygEditorProps, u as useEditorContext } from './shell-BXG_NlvR.js';
+import { C as CodeContext, E as EditorHostMode, S as SceneTextChannel } from './shell-595XbANu.js';
+export { B as BlockTagVisibility, a as CodeContextSection, D as DocumentLinkCandidate, b as DocumentLinkProvider, c as EditorActions, d as EditorColorScheme, e as EditorContextValue, f as EditorMode, g as EditorProvider, h as EditorProviderProps, i as EditorShell, j as EditorShellProps, k as EditorState, l as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, m as MentionProvider, P as PreviewPanel, n as PreviewPanelProps, R as RawEditor, o as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, W as WriteCanvasSettings, p as WysiwygEditor, q as WysiwygEditorProps, u as useEditorContext } from './shell-595XbANu.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, CSSProperties } from 'react';
@@ -18,9 +18,10 @@ import { Extension } from '@tiptap/core';
 import * as _tiptap_extension_heading from '@tiptap/extension-heading';
 import { DecorationSet } from '@tiptap/pm/view';
 import { Editor } from '@tiptap/react';
-import { PluginKey } from '@tiptap/pm/state';
+import { Transaction, PluginKey } from '@tiptap/pm/state';
 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 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';
@@ -1749,6 +1750,23 @@ interface FenceBlockEntry {
     /** Document position of the codeBlock node at the current state. */
     pos: number;
 }
+/**
+ * Remap a family's previous registry entries onto the new document, returning
+ * `mappedPos -> id` for every fence whose identity carries over.
+ *
+ * Two passes:
+ *  1. survivors whose start position was untouched — the common case;
+ *  2. boundary-churn survivors, where an attrs-only `setNodeMarkup` makes
+ *     `mapResult` report the start as deleted even though the same block is
+ *     still there. Adopt the old id only when a codeBlock sits at the mapped
+ *     position, the slot is unclaimed, AND the old node actually survived
+ *     (see {@link survivedAsChurn}).
+ *
+ * Callers then walk the new doc: a position present in this map keeps its id
+ * (and may use a lenient re-parse gate); a position absent from it is a NEW
+ * fence that must pass full detection.
+ */
+declare function mapFenceEntries(tr: Transaction, previous: readonly FenceBlockEntry[], doc: Node): Map<number, string>;
 
 /**
  * AsciiDiagramExtension — Tiptap/ProseMirror plugin that turns code blocks
@@ -2496,9 +2514,19 @@ interface CodeSnippetPluginState {
 interface CodeSnippetExtensionOptions {
     /** When false, leave all ordinary language-tagged fences as code blocks. */
     enabled?: boolean;
+    /**
+     * Fence languages this extension must NOT claim — typically the keys of
+     * a host `FenceRendererMap` so `HostFenceExtension` can own them instead
+     * of every unknown language becoming a Monaco inset. Tokens are
+     * normalized like fence languages (first token, lowercased). Evaluated
+     * at configure time: changing the *set* of registered languages
+     * requires re-configuring the editor; renderer implementations can
+     * change freely behind the host extension's getter.
+     */
+    reservedLanguages?: readonly string[];
 }
 declare const CODE_SNIPPET_KEY: PluginKey<CodeSnippetPluginState>;
-declare function isCodeSnippetNode(node: Node): boolean;
+declare function isCodeSnippetNode(node: Node, reserved?: ReadonlySet<string>): boolean;
 declare function findCodeSnippetBlockPos(editor: Editor, blockId: string): number | null;
 declare const CodeSnippetExtension: Extension<CodeSnippetExtensionOptions, any>;
 
@@ -2680,6 +2708,94 @@ declare function applyTreeCommand(editor: Editor, blockId: string, cmd: TreeComm
  */
 declare function shouldPasteAsTreeFence(text: string): boolean;
 
+/**
+ * HostFenceExtension — mounts HOST-registered fence renderers
+ * (`@bendyline/squisq/fence`) inside the WYSIWYG editor.
+ *
+ * Structurally a sibling of TreeViewExtension/CodeSnippetExtension:
+ * position registry with stable synthetic ids, `mapFenceEntries` for
+ * boundary-churn survival, hide-the-fence node decoration + a widget
+ * decoration hosting a React root with `containFenceWidgetEvents`.
+ *
+ * Ownership is simply "the host registry claims this fence language".
+ * The registry is read through a GETTER (the `mentionProvider` pattern)
+ * so renderer implementations can change without remounting the editor;
+ * the *set* of claimed languages is also consulted per-transaction, but
+ * remember to pass the same languages to
+ * `CodeSnippetExtension.reservedLanguages` or Monaco claims them first.
+ *
+ * The fence body is the single source of truth. Renderers receive
+ * `mode: 'edit'` plus a `replaceValue` callback that rewrites the fence
+ * 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).
+ */
+
+type HostFenceBlockEntry = FenceBlockEntry;
+interface HostFencePluginState {
+    entries: HostFenceBlockEntry[];
+    decorations: DecorationSet;
+    seq: number;
+}
+declare const HOST_FENCE_KEY: PluginKey<HostFencePluginState>;
+interface HostFenceExtensionOptions {
+    /** When false, the extension is inert. */
+    enabled?: boolean;
+    /**
+     * Getter for the host registry — read on every ownership check so
+     * renderer implementations stay live without an editor remount.
+     */
+    renderers?: () => FenceRendererMap | null | undefined;
+    /** Getter for the active theme, forwarded into the render context. */
+    theme?: () => Theme | undefined;
+}
+declare function findHostFenceBlockPos(editor: Editor, blockId: string): number | null;
+/**
+ * Replace a claimed fence's body in one undoable transaction. This is
+ * what backs `FenceRenderContext.replaceValue` in edit mode; exported so
+ * hosts building their own extensions get the same write boundary
+ * (read-only enforcement included) as the built-in fence families.
+ */
+declare function replaceHostFenceText(editor: Editor, blockId: string, next: string): boolean;
+declare const HostFenceExtension: Extension<HostFenceExtensionOptions, any>;
+
+/**
+ * Shared DOM containment for the interactive widgets that the fence-widget
+ * families (ascii diagram, tree, timeline, mermaid) mount over a hidden code
+ * fence via a ProseMirror widget decoration.
+ *
+ * Why this exists: a widget host is `contentEditable="false"` inside a
+ * contentEditable ProseMirror surface, but the real form controls it contains
+ * (`<input>`, `<textarea>`, `<select>`) still bubble their COMPLETE edit
+ * stream up to the editor's DOM. ProseMirror's own handlers sit on
+ * `view.dom`, so a `beforeinput`/`paste`/`compositionend` that originated in
+ * a widget's rename field is ALSO interpreted as text insertion at the
+ * document selection — the user types in the widget and the characters land
+ * in the document. Stopping propagation at the host boundary is what keeps
+ * the two edit surfaces separate.
+ *
+ * `keydown`/`keyup`/`pointerdown`/`mousedown` are contained for the same
+ * reason: they drive ProseMirror's keymap and selection handling.
+ *
+ * This must stay ONE list used by every host — it drifted into three
+ * divergent copies once already (only the timeline stopped the composition /
+ * paste stream, so IME and paste edits leaked out of the diagram and tree
+ * widgets).
+ */
+/**
+ * Every event a mounted fence widget must keep to itself. Ordered
+ * pointer → key → text-input → composition → clipboard.
+ */
+declare const FENCE_WIDGET_CONTAINED_EVENTS: readonly ["pointerdown", "mousedown", "keydown", "keyup", "beforeinput", "input", "change", "compositionstart", "compositionupdate", "compositionend", "paste", "cut"];
+/**
+ * Stop every contained event at `container` so interaction inside a mounted
+ * fence widget never reaches the ProseMirror editor that hosts it.
+ *
+ * Call once, on the host element created by a widget decoration, before
+ * mounting React into it.
+ */
+declare function containFenceWidgetEvents(container: HTMLElement): void;
+
 /**
  * TimelineViewExtension — mounts a WYSIWYG timeline editor over qualifying
  * authored timeline code fences while keeping the fence text as source of
@@ -2843,4 +2959,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, type FileCategory, type FileKind, type FolderEntry, FolderView, type FolderViewProps, type HeadingTransitionAttrs, HeadingWithTemplate, 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, detectLanguageFromFileName, documentTitleFromFileName, draftPatchFromImportedTheme, findAsciiDiagramBlockPos, findCodeSnippetBlockPos, findMermaidDiagramBlockPos, findRepairableBlockPos, findTimelineBlockPos, findTransitionEntry, findTreeBlockPos, formatSeconds, getBlockSlices, getTimelineForNode, indentItemOp, ingestForWrite, inspectMermaidSource, isAsciiSourceVisible, isCodeSnippetFenceLanguage, isCodeSnippetNode, isMermaidDiagramNode, isMermaidFlowchartShapeId, isMermaidSourceVisible, isRepairableFence, isTimelineSourceSafeForSemanticEdit, lineToOffset, 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, 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, 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 };

package/dist/index.js

@@ -26,8 +26,11 @@ import {
   EditorProvider,
   EditorShell,
   EmojiPicker,
+  FENCE_WIDGET_CONTAINED_EVENTS,
   FontPicker,
+  HOST_FENCE_KEY,
   HeadingWithTemplate,
+  HostFenceExtension,
   IMAGE_TREATMENT_PRESETS,
   ImportThemeSection,
   InlinePreviewGutter,
@@ -92,11 +95,13 @@ import {
   codeSnippetLanguageLabel,
   codeSnippetMarkdown,
   compileDraft,
+  containFenceWidgetEvents,
   detectLanguageFromFileName,
   documentTitleFromFileName,
   draftPatchFromImportedTheme,
   findAsciiDiagramBlockPos,
   findCodeSnippetBlockPos,
+  findHostFenceBlockPos,
   findMermaidDiagramBlockPos,
   findRepairableBlockPos,
   findTimelineBlockPos,
@@ -117,6 +122,7 @@ import {
   isRepairableFence,
   isTimelineSourceSafeForSemanticEdit,
   lineToOffset,
+  mapFenceEntries,
   mermaidDiagramMarkdown,
   mermaidDiagramProperties,
   mermaidEditCapabilities,
@@ -152,6 +158,7 @@ import {
   renderMermaidDiagram,
   replaceAsciiFenceText,
   replaceCodeSnippetText,
+  replaceHostFenceText,
   resizeNodeOp,
   resolveFileKind,
   sanitizeAsciiLabel,
@@ -194,7 +201,7 @@ import {
   usePreviewSettings,
   useTimelineData,
   useTreeViewData
-} from "./chunk-5FG3NAPH.js";
+} from "./chunk-NJ2VKEQF.js";
 import "./chunk-V4NBQF5C.js";
 import {
   JsonEditor
@@ -718,8 +725,11 @@ export {
   EditorProvider,
   EditorShell,
   EmojiPicker,
+  FENCE_WIDGET_CONTAINED_EVENTS,
   FolderView,
+  HOST_FENCE_KEY,
   HeadingWithTemplate,
+  HostFenceExtension,
   ImageEditor,
   ImageViewer,
   ImportThemeSection,
@@ -803,6 +813,7 @@ export {
   codeSnippetLanguageLabel,
   codeSnippetMarkdown,
   configureMonacoWorkers,
+  containFenceWidgetEvents,
   createFloatingWindowManager,
   detectFloatTiers,
   detectLanguageFromFileName,
@@ -813,6 +824,7 @@ export {
   executeNarrationSave,
   findAsciiDiagramBlockPos,
   findCodeSnippetBlockPos,
+  findHostFenceBlockPos,
   findMermaidDiagramBlockPos,
   findRepairableBlockPos,
   findTimelineBlockPos,
@@ -837,6 +849,7 @@ export {
   isRepairableFence,
   isTimelineSourceSafeForSemanticEdit,
   lineToOffset,
+  mapFenceEntries,
   markdownToTiptap,
   measureTokenLines,
   mermaidDiagramMarkdown,
@@ -878,6 +891,7 @@ export {
   renderMermaidDiagram,
   replaceAsciiFenceText,
   replaceCodeSnippetText,
+  replaceHostFenceText,
   replaceAsciiFenceText as replaceTreeFenceText,
   requestCameraStream,
   requestMicStream,

package/dist/shell/index.d.ts

@@ -1,7 +1,8 @@
-export { B as BlockTagVisibility, D as DocumentLinkCandidate, b as DocumentLinkProvider, c as EditorActions, d as EditorColorScheme, e as EditorContextValue, E as EditorHostMode, f as EditorMode, g as EditorProvider, h as EditorProviderProps, i as EditorShell, j as EditorShellProps, k as EditorState, l as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, m as MentionProvider, P as PreviewPanel, n as PreviewPanelProps, R as RawEditor, o as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, p as WysiwygEditor, q as WysiwygEditorProps, u as useEditorContext } from '../shell-BXG_NlvR.js';
+export { B as BlockTagVisibility, D as DocumentLinkCandidate, b as DocumentLinkProvider, c as EditorActions, d as EditorColorScheme, e as EditorContextValue, E as EditorHostMode, f as EditorMode, g as EditorProvider, h as EditorProviderProps, i as EditorShell, j as EditorShellProps, k as EditorState, l as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, m as MentionProvider, P as PreviewPanel, n as PreviewPanelProps, R as RawEditor, o as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, p as WysiwygEditor, q as WysiwygEditorProps, u as useEditorContext } from '../shell-595XbANu.js';
 import 'react/jsx-runtime';
 import 'react';
 import '@bendyline/squisq/schemas';
+import '@bendyline/squisq/fence';
 import '@bendyline/squisq/markdown';
 import '@bendyline/squisq/storage';
 import '@bendyline/squisq/versions';

package/dist/shell/index.js

@@ -5,7 +5,7 @@ import {
   RawEditor,
   WysiwygEditor,
   useEditorContext
-} from "../chunk-5FG3NAPH.js";
+} from "../chunk-NJ2VKEQF.js";
 import "../chunk-V4NBQF5C.js";
 import "../chunk-K2WJYVS4.js";
 import "../chunk-V44VP242.js";

package/dist/{shell-BXG_NlvR.d.ts → shell-595XbANu.d.ts}

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { Doc, MediaProvider, ViewportPreset, Theme } from '@bendyline/squisq/schemas';
+import { FenceRendererMap } from '@bendyline/squisq/fence';
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
 import { ContentContainer } from '@bendyline/squisq/storage';
 import { DocumentVersionManager, SaveVersionOptions, SaveVersionResult, PrunePolicy } from '@bendyline/squisq/versions';
@@ -367,6 +368,13 @@ interface EditorContextValue extends EditorState, EditorActions {
      * host DOES resolve is unsupported. Executable schemes stay refused.
      */
     linkSchemes: readonly string[] | undefined;
+    /**
+     * Host fence-renderer registry (`@bendyline/squisq/fence`). Claimed
+     * fence languages render as interactive host widgets in the WYSIWYG
+     * editor (via `HostFenceExtension`) instead of Monaco code insets, and
+     * flow into the preview panel's read path. Null disables.
+     */
+    fenceRenderers: FenceRendererMap | null;
     /**
      * File name the host opened this document as (e.g. `Longview Plan.md`), if
      * any. Used as a display-title fallback — for example, the header of a
@@ -438,6 +446,11 @@ interface EditorProviderProps {
      * Omit to fall back to URL-only link insertion.
      */
     documentLinkProvider?: DocumentLinkProvider | null;
+    /**
+     * Host fence-renderer registry (`@bendyline/squisq/fence`). Omit to
+     * leave every explicit-language fence to the built-in families.
+     */
+    fenceRenderers?: FenceRendererMap | null;
     /**
      * Extra link schemes this host resolves itself. Threaded into the link
      * dialog's `sanitizeUrl` check so a host-custom protocol is accepted;
@@ -556,7 +569,7 @@ interface ViewPreferences {
     /** Document vs. block-at-a-time layout. */
     layoutMode?: LayoutMode;
 }
-declare function EditorProvider({ initialMarkdown, initialView, articleId, colorScheme: initialColorScheme, workspaceContainer, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, mediaProvider, imageDisplayMode, mentionProvider, documentLinkProvider, linkSchemes, allowRecording, allowNarrate, preserveSourceWrapping, fileName, language, findMode: controlledFindMode, onFindModeChange, inlinePreview, showStatusBar, outline, blockTags, blockTagVisibility: initialBlockTagVisibility, themeInheritance, layoutMode, viewPreferences, onViewPreferencesChange, children, }: EditorProviderProps): react_jsx_runtime.JSX.Element;
+declare function EditorProvider({ initialMarkdown, initialView, articleId, colorScheme: initialColorScheme, workspaceContainer, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, mediaProvider, imageDisplayMode, mentionProvider, documentLinkProvider, fenceRenderers, linkSchemes, allowRecording, allowNarrate, preserveSourceWrapping, fileName, language, findMode: controlledFindMode, onFindModeChange, inlinePreview, showStatusBar, outline, blockTags, blockTagVisibility: initialBlockTagVisibility, themeInheritance, layoutMode, viewPreferences, onViewPreferencesChange, children, }: EditorProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Host-supplied context sections rendered INSIDE the Monaco (raw/code)
@@ -927,6 +940,15 @@ interface EditorShellProps {
      * remote API, …) implement this; the editor stays agnostic.
      */
     documentLinkProvider?: DocumentLinkProvider | null;
+    /**
+     * Host fence-renderer registry (`@bendyline/squisq/fence`). Claimed
+     * fence languages mount as interactive host widgets in the WYSIWYG
+     * view (via `HostFenceExtension`) instead of Monaco code insets. The
+     * *set* of claimed languages is read at editor configure time;
+     * renderer implementations stay live behind a getter. Omit to leave
+     * every fence to the built-in families.
+     */
+    fenceRenderers?: FenceRendererMap | null;
     /**
      * Extra link schemes this host resolves itself (e.g. an app-internal
      * navigation protocol). The link dialog validates typed URLs against
@@ -1086,7 +1108,7 @@ interface EditorShellProps {
  * Complete markdown editor shell with toolbar, view switcher, and three
  * editing modes: Raw (Monaco), WYSIWYG (Tiptap), and Preview.
  */
-declare function EditorShell({ initialMarkdown, initialView, hostMode, defaultViewportPreset, articleId, basePath, onChange, onLinkClick, showCodeCopyButton, onCopyCode, colorScheme, className, height, minHeight, maxHeight, mediaProvider, workspaceContainer, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, showFilesToggle, showFormattingControls, showInsertControls, allowBinaryDownloads, toolbarSlotLeft, toolbarSlotAfterActions, toolbarSlotRight, statusBarSlotRight, showPlayTab, allowPresentationWindow, allowPresentationFullscreen, allowPrint, submitOnEnter, codeContext, fullWidth, uxFont, thinMargins, writeCanvasSettings, showStatusBar, imageDisplayMode, fileName, language, findMode, onFindModeChange, mentionProvider, documentLinkProvider, linkSchemes, allowRecording, allowNarrate, preserveSourceWrapping, placeholder, readOnly, imageSrc, imageAlt, imageMode, imageEditorContainer, onImageExport, inlinePreview, inlinePreviewWidth, outline, outlineWidth, blockTags, blockTagVisibility, themeInheritance, viewPreferences, onViewPreferencesChange, themeOverride, }: EditorShellProps): react_jsx_runtime.JSX.Element;
+declare function EditorShell({ initialMarkdown, initialView, hostMode, defaultViewportPreset, articleId, basePath, onChange, onLinkClick, showCodeCopyButton, onCopyCode, colorScheme, className, height, minHeight, maxHeight, mediaProvider, workspaceContainer, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, showFilesToggle, showFormattingControls, showInsertControls, allowBinaryDownloads, toolbarSlotLeft, toolbarSlotAfterActions, toolbarSlotRight, statusBarSlotRight, showPlayTab, allowPresentationWindow, allowPresentationFullscreen, allowPrint, submitOnEnter, codeContext, fullWidth, uxFont, thinMargins, writeCanvasSettings, showStatusBar, imageDisplayMode, fileName, language, findMode, onFindModeChange, mentionProvider, documentLinkProvider, fenceRenderers, linkSchemes, allowRecording, allowNarrate, preserveSourceWrapping, placeholder, readOnly, imageSrc, imageAlt, imageMode, imageEditorContainer, onImageExport, inlinePreview, inlinePreviewWidth, outline, outlineWidth, blockTags, blockTagVisibility, themeInheritance, viewPreferences, onViewPreferencesChange, themeOverride, }: EditorShellProps): react_jsx_runtime.JSX.Element;
 
 /**
  * RawEditor

package/dist/styles/index.css

@@ -16493,6 +16493,14 @@
   color: var(--squisq-text-muted, #6b7280);
 }
 
+/* src/styles/host-fence.css */
+.squisq-wysiwyg-editor pre.squisq-host-fence-hidden {
+  display: none;
+}
+.squisq-host-fence-widget-host {
+  margin: 0.6rem 0;
+}
+
 /* src/styles/ascii-timeline.css */
 .squisq-wysiwyg-editor pre.squisq-ascii-timeline-fence-hidden {
   display: none;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-editor-react",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "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.6.0",
-    "@bendyline/squisq-formats": "2.4.0",
-    "@bendyline/squisq-react": "2.6.0",
-    "@bendyline/squisq-video-react": "2.3.1",
+    "@bendyline/squisq": "2.7.0",
+    "@bendyline/squisq-formats": "2.4.1",
+    "@bendyline/squisq-react": "2.7.0",
+    "@bendyline/squisq-video-react": "2.3.2",
     "@fortawesome/fontawesome-free": "7.2.0",
     "@tiptap/core": "2.27.2",
     "@tiptap/extension-heading": "2.27.2",