@bendyline/squisq-editor-react 2.10.1 → 2.10.3

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CodeContext, E as EditorHostMode, S as SceneTextChannel } from './shell-Dlh-mkn9.js';
-export { B as BlockTagVisibility, a as CodeContextSection, b as CoverImageSaveOutput, D as DashboardImageSaveOutput, c as DocumentLinkCandidate, d as DocumentLinkProvider, e as EditorActions, f as EditorColorScheme, g as EditorContextValue, h as EditorMode, i as EditorProvider, j as EditorProviderProps, k as EditorShell, l as EditorShellProps, m as EditorState, n as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, o as MentionProvider, P as PreviewPanel, p as PreviewPanelProps, R as RawEditor, q as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, W as WriteCanvasSettings, r as WysiwygEditor, s as WysiwygEditorProps, u as useEditorContext } from './shell-Dlh-mkn9.js';
+import { C as CodeContext, E as EditorHostMode, S as SceneTextChannel } from './shell-DSHMZvnK.js';
+export { B as BlockTagVisibility, a as CodeContextSection, b as CoverImageSaveOutput, D as DashboardImageSaveOutput, c as DocumentLinkCandidate, d as DocumentLinkProvider, e as EditorActions, f as EditorColorScheme, g as EditorContextMenuContext, h as EditorContextMenuItem, i as EditorContextMenuItemVisibility, j as EditorContextMenuProvider, k as EditorContextMenuProviderProps, l as EditorContextValue, m as EditorMode, n as EditorProvider, o as EditorProviderProps, p as EditorShell, q as EditorShellProps, r as EditorState, s as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, t as MentionProvider, P as PreviewPanel, u as PreviewPanelProps, R as RawEditor, v as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, W as WriteCanvasSettings, w as WysiwygEditor, x as WysiwygEditorProps, y as useEditorContext, z as useEditorContextMenuItems } from './shell-DSHMZvnK.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, CSSProperties } from 'react';

package/dist/index.js

@@ -28,6 +28,7 @@ import {
   DocumentSettingsDialog,
   DropZoneOverlay,
   EMPTY_TRANSITION,
+  EditorContextMenuProvider,
   EditorProvider,
   EditorShell,
   EmojiPicker,
@@ -202,6 +203,7 @@ import {
   useDocCustomTemplates,
   useDocCustomThemes,
   useEditorContext,
+  useEditorContextMenuItems,
   useEscapeDismissal,
   useFileDrop,
   useMermaidDiagramData,
@@ -210,7 +212,7 @@ import {
   usePreviewSettings,
   useTimelineData,
   useTreeViewData
-} from "./chunk-TQPZ6VVM.js";
+} from "./chunk-X3UQBUVO.js";
 import "./chunk-V4NBQF5C.js";
 import {
   JsonEditor
@@ -228,7 +230,7 @@ import {
 } from "./chunk-V44VP242.js";
 import {
   RecorderButton
-} from "./chunk-WCGDDZB6.js";
+} from "./chunk-VH45VMPL.js";
 import {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderDeviceQuickPicks,
@@ -259,11 +261,11 @@ import {
   unshownSlidesWarning,
   useMediaDevices,
   useMediaRecorder
-} from "./chunk-JNJ7XO5L.js";
+} from "./chunk-7RRYZULY.js";
 import "./chunk-GS7QWYFT.js";
 import {
   TeleprompterView
-} from "./chunk-ZZTB6BEQ.js";
+} from "./chunk-UNOKKSAC.js";
 import {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,
@@ -303,7 +305,7 @@ import {
   useStreamPreview,
   useTeleprompter,
   vadConfigForSensitivity
-} from "./chunk-IRPOMTYK.js";
+} from "./chunk-PMNNJYFD.js";
 
 // src/FolderView.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -747,6 +749,7 @@ export {
   DropZoneOverlay,
   EMPTY_TRANSITION,
   EYE_LINE_FRACTION,
+  EditorContextMenuProvider,
   EditorProvider,
   EditorShell,
   EmojiPicker,
@@ -984,6 +987,7 @@ export {
   useDocCustomTemplates,
   useDocCustomThemes,
   useEditorContext,
+  useEditorContextMenuItems,
   useFileDrop,
   useFloatingWindow,
   useImageEditor,

package/dist/recorder/index.js

@@ -1,6 +1,6 @@
 import {
   RecorderButton
-} from "../chunk-WCGDDZB6.js";
+} from "../chunk-VH45VMPL.js";
 import {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderDeviceQuickPicks,
@@ -20,7 +20,7 @@ import {
   requestScreenStream,
   useMediaDevices,
   useMediaRecorder
-} from "../chunk-JNJ7XO5L.js";
+} from "../chunk-7RRYZULY.js";
 import "../chunk-GS7QWYFT.js";
 import {
   buildFilename,
@@ -34,7 +34,7 @@ import {
   supportsUserMedia,
   timingPathFor,
   useStreamPreview
-} from "../chunk-IRPOMTYK.js";
+} from "../chunk-PMNNJYFD.js";
 export {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderButton,

package/dist/shell/index.d.ts

@@ -1,4 +1,4 @@
-export { B as BlockTagVisibility, c as DocumentLinkCandidate, d as DocumentLinkProvider, e as EditorActions, f as EditorColorScheme, g as EditorContextValue, E as EditorHostMode, h as EditorMode, i as EditorProvider, j as EditorProviderProps, k as EditorShell, l as EditorShellProps, m as EditorState, n as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, o as MentionProvider, P as PreviewPanel, p as PreviewPanelProps, R as RawEditor, q as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, r as WysiwygEditor, s as WysiwygEditorProps, u as useEditorContext } from '../shell-Dlh-mkn9.js';
+export { B as BlockTagVisibility, c as DocumentLinkCandidate, d as DocumentLinkProvider, e as EditorActions, f as EditorColorScheme, g as EditorContextMenuContext, h as EditorContextMenuItem, i as EditorContextMenuItemVisibility, j as EditorContextMenuProvider, k as EditorContextMenuProviderProps, l as EditorContextValue, E as EditorHostMode, m as EditorMode, n as EditorProvider, o as EditorProviderProps, p as EditorShell, q as EditorShellProps, r as EditorState, s as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, t as MentionProvider, P as PreviewPanel, u as PreviewPanelProps, R as RawEditor, v as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, w as WysiwygEditor, x as WysiwygEditorProps, y as useEditorContext, z as useEditorContextMenuItems } from '../shell-DSHMZvnK.js';
 import 'react/jsx-runtime';
 import 'react';
 import '@bendyline/squisq/schemas';

package/dist/shell/index.js

@@ -1,23 +1,27 @@
 import {
+  EditorContextMenuProvider,
   EditorProvider,
   EditorShell,
   PreviewPanel,
   RawEditor,
   WysiwygEditor,
-  useEditorContext
-} from "../chunk-TQPZ6VVM.js";
+  useEditorContext,
+  useEditorContextMenuItems
+} from "../chunk-X3UQBUVO.js";
 import "../chunk-V4NBQF5C.js";
 import "../chunk-TCLNRATG.js";
 import "../chunk-V44VP242.js";
-import "../chunk-JNJ7XO5L.js";
+import "../chunk-7RRYZULY.js";
 import "../chunk-GS7QWYFT.js";
-import "../chunk-ZZTB6BEQ.js";
-import "../chunk-IRPOMTYK.js";
+import "../chunk-UNOKKSAC.js";
+import "../chunk-PMNNJYFD.js";
 export {
+  EditorContextMenuProvider,
   EditorProvider,
   EditorShell,
   PreviewPanel,
   RawEditor,
   WysiwygEditor,
-  useEditorContext
+  useEditorContext,
+  useEditorContextMenuItems
 };

package/dist/{shell-Dlh-mkn9.d.ts → shell-DSHMZvnK.d.ts}

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
+import { ReactNode, RefObject } from 'react';
 import { Doc, MediaProvider, ViewportPreset, Theme } from '@bendyline/squisq/schemas';
 import { FenceRendererMap } from '@bendyline/squisq/fence';
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
@@ -378,6 +378,10 @@ interface EditorContextValue extends EditorState, EditorActions {
      * override it.
      */
     proofingDefaultEnabled: boolean;
+    /** Whether spelling findings are surfaced (host preference). */
+    proofingSpellingEnabled: boolean;
+    /** Whether grammar/style findings are surfaced (host preference). */
+    proofingGrammarEnabled: boolean;
     /**
      * Host-owned, per-document storage for dismissed findings. Ignores
      * are never written into the document; without a store they last only
@@ -484,6 +488,10 @@ interface EditorProviderProps {
     proofing?: ProofingCapability | null;
     /** Host default enable state for proofing (default true). */
     proofingDefaultEnabled?: boolean;
+    /** Whether spelling findings are surfaced (default true). */
+    proofingSpellingEnabled?: boolean;
+    /** Whether grammar/style findings are surfaced (default true). */
+    proofingGrammarEnabled?: boolean;
     /** Host-owned per-document storage for dismissed proofing findings. */
     proofingIgnoreStore?: ProofingIgnoreStore | null;
     /**
@@ -618,7 +626,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, proofing, proofingDefaultEnabled, proofingIgnoreStore, documentLinkProvider, fenceRenderers, linkSchemes, allowRecording, allowNarrate, preserveSourceWrapping, fileName, saveCoverImageOutput, saveDashboardImageOutput, 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, proofing, proofingDefaultEnabled, proofingSpellingEnabled, proofingGrammarEnabled, proofingIgnoreStore, documentLinkProvider, fenceRenderers, linkSchemes, allowRecording, allowNarrate, preserveSourceWrapping, fileName, saveCoverImageOutput, saveDashboardImageOutput, 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)
@@ -839,6 +847,12 @@ interface EditorShellProps {
     onSaveVersion?: (result: SaveVersionResult) => void;
     /** Show the Files toggle in the toolbar. Defaults to true when mediaProvider is passed. */
     showFilesToggle?: boolean;
+    /**
+     * Open the Files panel when its accessory bin becomes non-empty. The user
+     * can still close it normally; it opens again only when the visible count
+     * changes. Defaults to false.
+     */
+    showFilesWhenNotEmpty?: boolean;
     /**
      * Show the toolbar's built-in text, block, and contextual formatting
      * controls. The toolbar, Insert menu, and host-provided slots remain
@@ -1006,6 +1020,18 @@ interface EditorShellProps {
      * and the user's session toggle in the View menu override this.
      */
     proofingDefaultEnabled?: boolean;
+    /**
+     * Whether spelling findings (red squiggles) are shown (default `true`).
+     * A host-level preference, deliberately independent of the enable
+     * layers above: turning both this and `proofingGrammarEnabled` off is
+     * equivalent to turning proofing off, and loads no engine.
+     */
+    proofingSpellingEnabled?: boolean;
+    /**
+     * Whether grammar and style findings (green/blue squiggles) are shown
+     * (default `true`). See {@link EditorShellProps.proofingSpellingEnabled}.
+     */
+    proofingGrammarEnabled?: boolean;
     /**
      * Host-owned storage for findings the user dismissed with "Ignore",
      * scoped per document (`load`/`save` receive a
@@ -1193,7 +1219,55 @@ 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, saveCoverImageOutput, saveDashboardImageOutput, language, findMode, onFindModeChange, mentionProvider, proofing, proofingDefaultEnabled, proofingIgnoreStore, 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;
+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, showFilesWhenNotEmpty, showFormattingControls, showInsertControls, allowBinaryDownloads, toolbarSlotLeft, toolbarSlotAfterActions, toolbarSlotRight, statusBarSlotRight, showPlayTab, allowPresentationWindow, allowPresentationFullscreen, allowPrint, submitOnEnter, codeContext, fullWidth, uxFont, thinMargins, writeCanvasSettings, showStatusBar, imageDisplayMode, fileName, saveCoverImageOutput, saveDashboardImageOutput, language, findMode, onFindModeChange, mentionProvider, proofing, proofingDefaultEnabled, proofingSpellingEnabled, proofingGrammarEnabled, proofingIgnoreStore, 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;
+
+/**
+ * Shared editor context menu.
+ *
+ * EditorShell installs this once for every text surface. Squisq contributes
+ * the ordinary clipboard actions; hosts register domain-specific actions with
+ * `useEditorContextMenuItems` without installing competing DOM listeners.
+ */
+
+interface EditorContextMenuContext {
+    /** Editor rendition that was right-clicked. */
+    view: EditorView;
+    /** Exact selected plain text at the time the menu opened. */
+    selectedText: string;
+    hasSelection: boolean;
+    /** False in Preview and when the host made the editor read-only. */
+    editable: boolean;
+    clientX: number;
+    clientY: number;
+    target: Element;
+}
+type EditorContextMenuItemVisibility = 'always' | 'selection' | 'location' | ((context: EditorContextMenuContext) => boolean);
+interface EditorContextMenuItem {
+    /** Stable within one host registration. */
+    id: string;
+    label: string;
+    /** Optional trailing shortcut hint, e.g. `Ctrl+C`. */
+    shortcut?: string;
+    /** Consecutive groups are separated visually. Defaults to `host`. */
+    group?: string;
+    icon?: ReactNode;
+    /** Defaults to `always`. */
+    when?: EditorContextMenuItemVisibility;
+    disabled?: boolean | ((context: EditorContextMenuContext) => boolean);
+    onSelect: (context: EditorContextMenuContext) => void | Promise<void>;
+}
+/** Register host actions with the nearest EditorShell context menu. */
+declare function useEditorContextMenuItems(items: readonly EditorContextMenuItem[]): void;
+interface EditorContextMenuProviderProps {
+    rootRef: RefObject<HTMLElement | null>;
+    readOnly?: boolean;
+    children: ReactNode;
+}
+/**
+ * Context-menu owner used by EditorShell. Exported for hosts that compose the
+ * lower-level RawEditor/WysiwygEditor primitives into their own shell.
+ */
+declare function EditorContextMenuProvider({ rootRef, readOnly, children, }: EditorContextMenuProviderProps): JSX.Element;
 
 /**
  * RawEditor
@@ -1283,4 +1357,4 @@ interface PreviewPanelProps {
  */
 declare function PreviewPanel({ basePath, className, workspaceContainer, onLinkClick, showCodeCopyButton, onCopyCode, }: PreviewPanelProps): react_jsx_runtime.JSX.Element;
 
-export { type BlockTagVisibility as B, type CodeContext as C, type DashboardImageSaveOutput as D, type EditorHostMode as E, type ImageDisplayMode as I, type LayoutMode as L, type MentionCandidate as M, PreviewPanel as P, RawEditor as R, type SceneTextChannel as S, type ThemeInheritance as T, type ViewPreferences as V, type WriteCanvasSettings as W, type CodeContextSection as a, type CoverImageSaveOutput as b, type DocumentLinkCandidate as c, type DocumentLinkProvider as d, type EditorActions as e, type EditorColorScheme as f, type EditorContextValue as g, type EditorMode as h, EditorProvider as i, type EditorProviderProps as j, EditorShell as k, type EditorShellProps as l, type EditorState as m, type EditorView as n, type MentionProvider as o, type PreviewPanelProps as p, type RawEditorProps as q, WysiwygEditor as r, type WysiwygEditorProps as s, useEditorContext as u };
+export { type BlockTagVisibility as B, type CodeContext as C, type DashboardImageSaveOutput as D, type EditorHostMode as E, type ImageDisplayMode as I, type LayoutMode as L, type MentionCandidate as M, PreviewPanel as P, RawEditor as R, type SceneTextChannel as S, type ThemeInheritance as T, type ViewPreferences as V, type WriteCanvasSettings as W, type CodeContextSection as a, type CoverImageSaveOutput as b, type DocumentLinkCandidate as c, type DocumentLinkProvider as d, type EditorActions as e, type EditorColorScheme as f, type EditorContextMenuContext as g, type EditorContextMenuItem as h, type EditorContextMenuItemVisibility as i, EditorContextMenuProvider as j, type EditorContextMenuProviderProps as k, type EditorContextValue as l, type EditorMode as m, EditorProvider as n, type EditorProviderProps as o, EditorShell as p, type EditorShellProps as q, type EditorState as r, type EditorView as s, type MentionProvider as t, type PreviewPanelProps as u, type RawEditorProps as v, WysiwygEditor as w, type WysiwygEditorProps as x, useEditorContext as y, useEditorContextMenuItems as z };