@stll/folio-react 0.12.1 → 0.12.3

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { _ as FolioUIProvider, a as DocxEditorApplyDocumentOperationsOptions, c as DocxEditorRef, d as ToolbarProps, f as EditorMode, g as FolioUIComponents, h as FolioButtonProps, i as renderAsync, l as HighlightPassageOptions, m as ColorPreset, n as EditorHandle, o as DocxEditorCollaboration, p as FontOption, r as RenderAsyncOptions, s as DocxEditorProps, t as DocxEditorHandle, u as HighlightPassageResult, v as OutlineItem, y as FontDefinition } from "./renderAsync-D2OJupOm.js";
-import { A as HyperlinkDialog, C as ImagePropertiesData, D as ImagePositionDialog, E as ImagePositionData, F as FindReplaceDialog, I as FindReplaceDialogProps, M as HyperlinkDialogProps, N as FootnotePropertiesDialog, O as ImagePositionDialogProps, P as FootnotePropertiesDialogProps, S as InsertImageDialogProps, T as ImagePropertiesDialogProps, _ as InsertTableStyleOption, a as TablePropertiesDialogProps, b as InsertImageDialog, c as SplitCellDialogProps, d as PasteSpecialMode, f as PageSetupDialog, g as InsertTableDialogProps, h as InsertTableDialogData, i as TablePropertiesDialog, j as HyperlinkDialogData, k as HyperlinkBookmarkOption, l as PasteSpecialDialog, m as InsertTableDialog, n as WatermarkDialogProps, o as SplitCellDialog, p as PageSetupDialogProps, r as TableProperties, s as SplitCellDialogData, t as WatermarkDialog, u as PasteSpecialDialogProps, v as InsertSymbolDialog, w as ImagePropertiesDialog, x as InsertImageDialogData, y as InsertSymbolDialogProps } from "./dialogs-auOIiNGI.js";
+import { _ as FolioUIProvider, a as DocxEditorApplyDocumentOperationsOptions, c as DocxEditorRef, d as ToolbarProps, f as EditorMode, g as FolioUIComponents, h as FolioButtonProps, i as renderAsync, l as HighlightPassageOptions, m as ColorPreset, n as EditorHandle, o as DocxEditorCollaboration, p as FontOption, r as RenderAsyncOptions, s as DocxEditorProps, t as DocxEditorHandle, u as HighlightPassageResult, v as OutlineItem, y as FontDefinition } from "./renderAsync-CH8S7yqU.js";
+import { A as HyperlinkDialog, C as ImagePropertiesData, D as ImagePositionDialog, E as ImagePositionData, F as FindReplaceDialog, I as FindReplaceDialogProps, M as HyperlinkDialogProps, N as FootnotePropertiesDialog, O as ImagePositionDialogProps, P as FootnotePropertiesDialogProps, S as InsertImageDialogProps, T as ImagePropertiesDialogProps, _ as InsertTableStyleOption, a as TablePropertiesDialogProps, b as InsertImageDialog, c as SplitCellDialogProps, d as PasteSpecialMode, f as PageSetupDialog, g as InsertTableDialogProps, h as InsertTableDialogData, i as TablePropertiesDialog, j as HyperlinkDialogData, k as HyperlinkBookmarkOption, l as PasteSpecialDialog, m as InsertTableDialog, n as WatermarkDialogProps, o as SplitCellDialog, p as PageSetupDialogProps, r as TableProperties, s as SplitCellDialogData, t as WatermarkDialog, u as PasteSpecialDialogProps, v as InsertSymbolDialog, w as ImagePropertiesDialog, x as InsertImageDialogData, y as InsertSymbolDialogProps } from "./dialogs-lCOx21mG.js";
 import React, { CSSProperties, ReactNode, RefObject } from "react";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "@stll/folio-core/utils/createDocument";
 import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAISignatureParty, WordDiffSegment, applyFolioAIEditOperations, createFolioAIEditSnapshot, diffWordSegments, hashFolioAIBlockText, normalizeFolioAIBlockText } from "@stll/folio-core/ai-edits";
@@ -28,7 +28,6 @@ import { DirectiveKind, DirectiveRange, getTemplateDirectives, scanDirectives }
 import { TemplatePreviewSpan, TemplatePreviewValue, TemplatePreviewValues, setTemplatePreviewValues } from "@stll/folio-core/prosemirror/plugins/templatePreviewValues";
 import { AcceptAutocompleteResult, AutocompleteSuggestionPluginOptions, AutocompleteSuggestionState, AutocompleteSuggestionStatus, AutocompleteTriggerCheck, AutocompleteTriggerOptions, AutocompleteTriggerSkipReason, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acceptAutocompleteWord, appendAutocompleteToken, autocompleteSuggestionKey, autocompleteSuggestionPlugin, clearAutocompleteSuggestion, finishAutocompleteSuggestion, getAutocompleteSuggestion, shouldTriggerAutocomplete, startAutocompleteSuggestion } from "@stll/folio-core/prosemirror/plugins/autocompleteSuggestion";
 import { ImageMeta, ImageRef, MarkdownOptions, MarkdownResult, fromMarkdown, toMarkdown, toMarkdownResult } from "@stll/folio-core/markdown";
-
 //#region src/components/DocxEditor.d.ts
 /**
  * DocxEditor - Complete DOCX editor component
@@ -37,10 +36,14 @@ declare const DocxEditor: import("react").ForwardRefExoticComponent<DocxEditorPr
 //#endregion
 //#region src/components/FormattingBar.d.ts
 type FormattingBarProps = {
-  children?: ReactNode; /** Host controls that should stay in the primary row before text formatting */
-  priorityExtra?: ReactNode; /** Extra controls rendered inline in the center column (after formatting buttons) */
-  inlineExtra?: ReactNode; /** Display label for the style picker when the backing document is hydrating. */
-  stylePickerLabel?: string | undefined; /** Computed preview style for the hydrating style picker label. */
+  children?: ReactNode;
+  /** Host controls that should stay in the primary row before text formatting */
+  priorityExtra?: ReactNode;
+  /** Extra controls rendered inline in the center column (after formatting buttons) */
+  inlineExtra?: ReactNode;
+  /** Display label for the style picker when the backing document is hydrating. */
+  stylePickerLabel?: string | undefined;
+  /** Computed preview style for the hydrating style picker label. */
   stylePickerLabelStyle?: CSSProperties | undefined;
   inline?: boolean;
 } & ToolbarProps;
@@ -61,32 +64,35 @@ type ZoomLevel = {
   label: string;
 };
 type ZoomControlProps = {
-  /** Current zoom (1 = 100%). */value?: number; /** Called with the chosen zoom level. */
-  onChange?: (zoom: number) => void; /** Override the preset levels offered in the dropdown. */
+  /** Current zoom (1 = 100%). */
+  value?: number;
+  /** Called with the chosen zoom level. */
+  onChange?: (zoom: number) => void;
+  /** Override the preset levels offered in the dropdown. */
   levels?: ZoomLevel[];
   disabled?: boolean;
-  className?: string; /** Render the trigger at the smaller toolbar-chrome size. */
+  className?: string;
+  /** Render the trigger at the smaller toolbar-chrome size. */
   compact?: boolean;
 };
-declare function ZoomControl({
-  value,
-  onChange,
-  levels,
-  disabled,
-  className,
-  compact
-}: ZoomControlProps): import("react").JSX.Element;
+declare function ZoomControl({ value, onChange, levels, disabled, className, compact }: ZoomControlProps): import("react").JSX.Element;
 //#endregion
 //#region src/hooks/useWheelZoom.d.ts
 /**
  * Options for useWheelZoom hook
  */
 type UseWheelZoomOptions = {
-  /** Initial zoom level (default: 1.0) */initialZoom?: number; /** Minimum zoom level (default: 0.25) */
-  minZoom?: number; /** Maximum zoom level (default: 4.0) */
-  maxZoom?: number; /** Zoom step for each scroll event (default: 0.1) */
-  zoomStep?: number; /** Whether zoom is enabled (default: true) */
-  enabled?: boolean; /** Container element ref to attach wheel listener */
+  /** Initial zoom level (default: 1.0) */
+  initialZoom?: number;
+  /** Minimum zoom level (default: 0.25) */
+  minZoom?: number;
+  /** Maximum zoom level (default: 4.0) */
+  maxZoom?: number;
+  /** Zoom step for each scroll event (default: 0.1) */
+  zoomStep?: number;
+  /** Whether zoom is enabled (default: true) */
+  enabled?: boolean;
+  /** Container element ref to attach wheel listener */
   containerRef?: RefObject<HTMLElement | null>;
   /**
    * Live current zoom getter. When provided the hook runs controlled: it reads
@@ -94,26 +100,41 @@ type UseWheelZoomOptions = {
    * and only emits the next value through `onZoomChange`. Lets the hook compose
    * with an external zoom owner without a second, divergent source of truth.
    */
-  getCurrentZoom?: () => number; /** Callback when zoom changes */
-  onZoomChange?: (zoom: number) => void; /** Whether to enable keyboard shortcuts (Ctrl++, Ctrl+-, Ctrl+0) */
-  enableKeyboardShortcuts?: boolean; /** Whether to prevent default browser zoom behavior */
+  getCurrentZoom?: () => number;
+  /** Callback when zoom changes */
+  onZoomChange?: (zoom: number) => void;
+  /** Whether to enable keyboard shortcuts (Ctrl++, Ctrl+-, Ctrl+0) */
+  enableKeyboardShortcuts?: boolean;
+  /** Whether to prevent default browser zoom behavior */
   preventDefault?: boolean;
 };
 /**
  * Return value of useWheelZoom hook
  */
 type UseWheelZoomReturn = {
-  /** Current zoom level */zoom: number; /** Set zoom level directly */
-  setZoom: (zoom: number) => void; /** Zoom in by step */
-  zoomIn: () => void; /** Zoom out by step */
-  zoomOut: () => void; /** Reset zoom to initial level */
-  resetZoom: () => void; /** Reset zoom to 100% */
-  zoomTo100: () => void; /** Zoom to fit width */
-  zoomToFit: (containerWidth: number, contentWidth: number) => void; /** Whether currently at minimum zoom */
-  isMinZoom: boolean; /** Whether currently at maximum zoom */
-  isMaxZoom: boolean; /** Zoom percentage (e.g., 100 for zoom level 1.0) */
-  zoomPercent: number; /** Wheel event handler (for manual attachment) */
-  handleWheel: (event: WheelEvent) => void; /** Keyboard event handler (for manual attachment) */
+  /** Current zoom level */
+  zoom: number;
+  /** Set zoom level directly */
+  setZoom: (zoom: number) => void;
+  /** Zoom in by step */
+  zoomIn: () => void;
+  /** Zoom out by step */
+  zoomOut: () => void;
+  /** Reset zoom to initial level */
+  resetZoom: () => void;
+  /** Reset zoom to 100% */
+  zoomTo100: () => void;
+  /** Zoom to fit width */
+  zoomToFit: (containerWidth: number, contentWidth: number) => void;
+  /** Whether currently at minimum zoom */
+  isMinZoom: boolean;
+  /** Whether currently at maximum zoom */
+  isMaxZoom: boolean;
+  /** Zoom percentage (e.g., 100 for zoom level 1.0) */
+  zoomPercent: number;
+  /** Wheel event handler (for manual attachment) */
+  handleWheel: (event: WheelEvent) => void;
+  /** Keyboard event handler (for manual attachment) */
   handleKeyDown: (event: KeyboardEvent) => void;
 };
 /**
@@ -140,8 +161,11 @@ declare function clampZoom(zoom: number, minZoom?: number, maxZoom?: number): nu
 //#endregion
 //#region src/paged-editor/AutocompleteCaretOverlay.d.ts
 type AutocompleteCaretRect = {
-  /** Container-relative pixel x. */x: number; /** Container-relative pixel y (top of the cursor line). */
-  y: number; /** Line height in pixels at the anchor. */
+  /** Container-relative pixel x. */
+  x: number;
+  /** Container-relative pixel y (top of the cursor line). */
+  y: number;
+  /** Line height in pixels at the anchor. */
   lineHeight: number;
   /**
    * Available width from the caret to the page's right content margin,
@@ -157,14 +181,12 @@ type AutocompleteCaretOverlayProps = {
    * Position of the autocomplete anchor, projected into the
    * overlay's container space. `null` while idle.
    */
-  caret: AutocompleteCaretRect | null; /** The full streamed ghost text so far. */
-  text: string; /** Whether tokens are still arriving from the model. */
+  caret: AutocompleteCaretRect | null;
+  /** The full streamed ghost text so far. */
+  text: string;
+  /** Whether tokens are still arriving from the model. */
   isStreaming: boolean;
 };
-declare const AutocompleteCaretOverlay: ({
-  caret,
-  text,
-  isStreaming
-}: AutocompleteCaretOverlayProps) => React.JSX.Element | null;
+declare const AutocompleteCaretOverlay: ({ caret, text, isStreaming }: AutocompleteCaretOverlayProps) => React.JSX.Element | null;
 //#endregion
 export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyResult, AutocompleteCaretOverlay, type AutocompleteCaretOverlayProps, type AutocompleteCaretRect, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type ColorPreset, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, DocxEditor, type DocxEditorApplyDocumentOperationsOptions, type DocxEditorCollaboration, type DocxEditorHandle, type DocxEditorProps, type DocxEditorRef, type EditorHandle, type EditorMode, type ExtractDocumentStyleSetOptions, FindReplaceDialog, type FindReplaceDialogProps, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioButtonProps, type FolioSuggestion, type FolioUIComponents, FolioUIProvider, type FontDefinition, type FontOption, FootnotePropertiesDialog, type FootnotePropertiesDialogProps, FormattingBar, type FormattingBarProps, type HighlightPassageOptions, type HighlightPassageResult, type HyperlinkBookmarkOption, HyperlinkDialog, type HyperlinkDialogData, type HyperlinkDialogProps, type ImageMeta, type ImagePositionData, ImagePositionDialog, type ImagePositionDialogProps, type ImagePropertiesData, ImagePropertiesDialog, type ImagePropertiesDialogProps, type ImageRef, InsertImageDialog, type InsertImageDialogData, type InsertImageDialogProps, InsertSymbolDialog, type InsertSymbolDialogProps, InsertTableDialog, type InsertTableDialogData, type InsertTableDialogProps, type InsertTableStyleOption, type MarkdownOptions, type MarkdownResult, type OutlineItem, PageSetupDialog, type PageSetupDialogProps, PasteSpecialDialog, type PasteSpecialDialogProps, type PasteSpecialMode, type PictureWatermark, type PositionalText, type RenderAsyncOptions, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type ScrollToParaIdOptions, SplitCellDialog, type SplitCellDialogData, type SplitCellDialogProps, type SuggestionAppliedAs, type SuggestionKind, type TableProperties, TablePropertiesDialog, type TablePropertiesDialogProps, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, type TextWatermark, type UseWheelZoomOptions, type UseWheelZoomReturn, type Watermark, WatermarkDialog, type WatermarkDialogProps, type WordDiffSegment, ZOOM_PRESETS, ZoomControl, type ZoomControlProps, type ZoomLevel, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applySuggestions, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clampZoom, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, finishAutocompleteSuggestion, formatZoom, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getDocumentWatermark, getFolioCaretViewportRect, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, insertImageFromFile, insertPageBreakInView, insertTableInView, insertTableOfContentsInView, inspectDocumentStyles, inspectDocumentStylesFromDocx, isFolioBlockId, isSequentialFolioBlockId, isSuggestionStale, normalizeFolioAIBlockText, parseZoom, renderAsync, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setDocumentWatermark, setFocusedSuggestionMeta, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult, useWheelZoom };