superdoc 2.29.0-next.13 → 2.29.0-next.17

package/dist/superdoc/src/internal/toolbar/built-in/font-typeahead.d.ts

@@ -1,11 +1,41 @@
-export function findPrefixMatchIndex(query: string, labels: ReadonlyArray<string>): number;
-export function computeTypeahead(query: string, labels: ReadonlyArray<string>, { autocomplete }?: {
-    autocomplete?: boolean;
-}): {
+/**
+ * Pure typeahead/autocomplete helpers for the font comboboxes (family + size).
+ *
+ * Matching is case-insensitive prefix matching on the logical font labels.
+ * Space is a normal query character, so the query is never split on spaces;
+ * only the outer whitespace is ignored when comparing.
+ *
+ * These functions hold no Vue or DOM state so CI can unit-test them in isolation.
+ */
+interface TypeaheadResult {
     matchIndex: number;
     display: string;
     selectionStart: number;
     selectionEnd: number;
-};
-export function normalizeCustomFontFamily(value: any): string;
-export function normalizeCustomFontSize(value: string): string;
+}
+/**
+ * Index of the first label that starts with `query` (case-insensitive).
+ * An empty/whitespace query never matches. Returns the matching index or -1.
+ */
+export declare const findPrefixMatchIndex: (query: string, labels: ReadonlyArray<string>) => number;
+/**
+ * Resolve what the input should display after a keystroke.
+ *
+ * When `autocomplete` is true and a prefix match exists that is longer than the
+ * typed query, the completion is shown with the suffix selected so the next
+ * keystroke replaces it. When false (deletion) or no match exists, the raw
+ * query is shown with the caret at its end. `query` is the user-typed portion.
+ */
+export declare const computeTypeahead: (query: string, labels: ReadonlyArray<string>, { autocomplete }?: {
+    autocomplete?: boolean;
+}) => TypeaheadResult;
+export declare const normalizeCustomFontFamily: (value: unknown) => string;
+/**
+ * Normalize a typed font size to a supported point-size string.
+ * Parses the numeric value (ignoring any unit suffix) keeping its sign, rounds to
+ * the nearest half point (DOCX/Word support half points such as 10.5), and clamps
+ * to the supported range. Returns '' when nothing usable was typed, including
+ * negative or sub-minimum values.
+ */
+export declare const normalizeCustomFontSize: (value: unknown) => string;
+export {};

package/dist/superdoc/src/internal/toolbar/built-in/format-negation.d.ts

@@ -1,5 +1,11 @@
-export function isOffValue(value: unknown): boolean;
-/** @type {Record<string, (attrs?: Record<string, unknown>) => boolean>} */
-export const negationChecks: Record<string, (attrs?: Record<string, unknown>) => boolean>;
-export function isNegatedMark(name: string, attrs?: Record<string, unknown>): boolean;
+type MarkAttrs = Record<string, unknown>;
+/**
+ * Normalize "off" values used by cascade-aware formatting marks.
+ */
+export declare const isOffValue: (value: unknown) => boolean;
+export declare const negationChecks: Record<string, (attrs?: MarkAttrs) => boolean>;
+/**
+ * Determine whether a mark is currently negated (explicitly turning formatting off).
+ */
+export declare const isNegatedMark: (name: string, attrs?: MarkAttrs) => boolean;
 export default isNegatedMark;

package/dist/superdoc/src/internal/toolbar/built-in/general.d.ts

@@ -1 +1,12 @@
-export function findElementBySelector(selector: string | HTMLElement | null | undefined): HTMLElement | null;
+/**
+ * Minimal DOM helpers for the built-in toolbar shell.
+ *
+ * The v1 toolbar's `helpers/general.js` also exported a converter-backed
+ * paragraph-font-family fallback; that path depended on private v1 editor
+ * internals (`@core/super-converter`) and is intentionally dropped on V2, where
+ * font-family active state comes from the shared command controller snapshot.
+ */
+/**
+ * Resolve a toolbar mount target from a selector string or element id.
+ */
+export declare const findElementBySelector: (selector: string | HTMLElement | null | undefined) => HTMLElement | null;

package/dist/superdoc/src/internal/toolbar/built-in/helpers.d.ts

@@ -1,5 +1,10 @@
-export function sanitizeNumber(value: any, defaultNumber: any): any;
-export function throttle(func: any, wait: any, options: any): {
-    (...callArgs: any[]): any;
-    cancel(): void;
+interface ThrottleOptions {
+    leading?: boolean;
+    trailing?: boolean;
+}
+type Throttled<Args extends unknown[], Result> = ((...args: Args) => Result | undefined) & {
+    cancel: () => void;
 };
+declare const sanitizeNumber: (value: unknown, defaultNumber: number) => number;
+declare const throttle: <Args extends unknown[], Result>(func: (...args: Args) => Result, wait: number, options?: ThrottleOptions) => Throttled<Args, Result>;
+export { sanitizeNumber, throttle };

package/dist/superdoc/src/internal/toolbar/built-in/list-style-buttons.d.ts

@@ -1,9 +1,9 @@
-export const bulletStyleButtons: {
+export declare const bulletStyleButtons: {
     key: string;
     icon: string;
     ariaLabel: string;
 }[];
-export const numberedStyleButtons: {
+export declare const numberedStyleButtons: {
     key: string;
     icon: string;
     ariaLabel: string;

package/dist/superdoc/src/internal/toolbar/built-in/page-number-feedback.d.ts

@@ -1,10 +1,9 @@
+import { HeaderFooterKind } from '../../../../../document-api/src/index.js';
 /**
  * Briefly highlight the painted header or footer regions that are on screen,
  * so the user sees where page numbers landed without the caret leaving the
  * body. Regions are read after the repaint that follows the mutation; nothing
- * happens when none is visible or the host is unavailable.
- *
- * @param {HTMLElement | null | undefined} host Document viewport host element.
- * @param {'header' | 'footer'} kind
+ * happens when none is visible or the host is unavailable. `host` is the
+ * document viewport host element.
  */
-export function flashPageNumberRegions(host: HTMLElement | null | undefined, kind: "header" | "footer"): Promise<void>;
+export declare function flashPageNumberRegions(host: HTMLElement | null | undefined, kind: HeaderFooterKind): Promise<void>;

package/dist/superdoc/src/internal/toolbar/built-in/scroll-helpers.d.ts

@@ -1,4 +1,3 @@
-export function scrollToElement(targetElement: any, options?: {
-    behavior: string;
-    block: string;
-}): void;
+type ScrollOptions = Pick<ScrollIntoViewOptions, 'behavior' | 'block'>;
+export declare function scrollToElement(targetElement: HTMLElement | null | undefined, options?: ScrollOptions): void;
+export {};

package/dist/superdoc/src/internal/toolbar/built-in/toolbarIcons.d.ts

@@ -1,145 +1,78 @@
-import { default as rotateLeftIconSvg } from '../../../../../../shared/common/icons/rotate-left-solid.svg?raw';
-import { default as rotateRightIconSvg } from '../../../../../../shared/common/icons/rotate-right-solid.svg?raw';
-import { default as boldIconSvg } from '../../../../../../shared/common/icons/bold-solid.svg?raw';
-import { default as italicIconSvg } from '../../../../../../shared/common/icons/italic-solid.svg?raw';
-import { default as underlineIconSvg } from '../../../../../../shared/common/icons/underline-solid.svg?raw';
-import { default as fontIconSvg } from '../../../../../../shared/common/icons/font-solid.svg?raw';
-import { default as linkIconSvg } from '../../../../../../shared/common/icons/link-solid.svg?raw';
-import { default as imageIconSvg } from '../../../../../../shared/common/icons/image-solid.svg?raw';
-import { default as tocIconSvg } from '../../../../../../shared/common/icons/toc-solid.svg?raw';
-import { default as watermarkIconSvg } from '../../../../../../shared/common/icons/watermark.svg?raw';
-import { default as pageNumberIconSvg } from '../../../../../../shared/common/icons/page-number.svg?raw';
-import { default as alignLeftIconSvg } from '../../../../../../shared/common/icons/align-left-solid.svg?raw';
-import { default as alignRightIconSvg } from '../../../../../../shared/common/icons/align-right-solid.svg?raw';
-import { default as alignCenterIconSvg } from '../../../../../../shared/common/icons/align-center-solid.svg?raw';
-import { default as alignJustifyIconSvg } from '../../../../../../shared/common/icons/align-justify-solid.svg?raw';
-import { default as listIconSvg } from '../../../../../../shared/common/icons/list-solid.svg?raw';
-import { default as listCircleIconSvg } from '../../../../../../shared/common/icons/list-circle-solid.svg?raw';
-import { default as listSquareIconSvg } from '../../../../../../shared/common/icons/list-square-solid.svg?raw';
-import { default as listOlIconSvg } from '../../../../../../shared/common/icons/list-ol-solid.svg?raw';
-import { default as listDecimalIconSvg } from '../../../../../../shared/common/icons/list-decimal-solid.svg?raw';
-import { default as listDecimalParenIconSvg } from '../../../../../../shared/common/icons/list-decimal-paren-solid.svg?raw';
-import { default as listUpperRomanIconSvg } from '../../../../../../shared/common/icons/list-upper-roman-solid.svg?raw';
-import { default as listLowerRomanIconSvg } from '../../../../../../shared/common/icons/list-lower-roman-solid.svg?raw';
-import { default as listUpperAlphaIconSvg } from '../../../../../../shared/common/icons/list-upper-alpha-solid.svg?raw';
-import { default as listUpperAlphaParenIconSvg } from '../../../../../../shared/common/icons/list-upper-alpha-paren-solid.svg?raw';
-import { default as listLowerAlphaIconSvg } from '../../../../../../shared/common/icons/list-lower-alpha-solid.svg?raw';
-import { default as listLowerAlphaParenIconSvg } from '../../../../../../shared/common/icons/list-lower-alpha-paren-solid.svg?raw';
-import { default as outdentIconSvg } from '../../../../../../shared/common/icons/outdent-solid.svg?raw';
-import { default as indentIconSvg } from '../../../../../../shared/common/icons/indent-solid.svg?raw';
-import { default as paragraphLtrIconSvg } from '../../../../../../shared/common/icons/paragraph-ltr-solid.svg?raw';
-import { default as paragraphRtlIconSvg } from '../../../../../../shared/common/icons/paragraph-rtl-solid.svg?raw';
-import { default as fileHalfDashedIconSvg } from '../../../../../../shared/common/icons/file-half-dashed-solid.svg?raw';
-import { default as paintRollerIconSvg } from '../../../../../../shared/common/icons/paint-roller-solid.svg?raw';
-import { default as textSlashIconSvg } from '../../../../../../shared/common/icons/text-slash-solid.svg?raw';
-import { default as listCheckIconSvg } from '../../../../../../shared/common/icons/list-check-solid.svg?raw';
-import { default as fileIconSvg } from '../../../../../../shared/common/icons/file-solid.svg?raw';
-import { default as eyeIconSvg } from '../../../../../../shared/common/icons/eye-solid.svg?raw';
-import { default as calendarCheckIconSvg } from '../../../../../../shared/common/icons/calendar-check-solid.svg?raw';
-import { default as calendarXmarkIconSvg } from '../../../../../../shared/common/icons/calendar-xmark-solid.svg?raw';
-import { default as userEditIconSvg } from '../../../../../../shared/common/icons/user-edit-solid.svg?raw';
-import { default as commentIconSvg } from '../../../../../../shared/common/icons/comment-solid.svg?raw';
-import { default as circleIconSvg } from '../../../../../../shared/common/icons/circle-solid.svg?raw';
-import { default as checkIconSvg } from '../../../../../../shared/common/icons/check-solid.svg?raw';
-import { default as xmarkIconSvg } from '../../../../../../shared/common/icons/xmark-solid.svg?raw';
-import { default as upRightFromSquareIconSvg } from '../../../../../../shared/common/icons/up-right-from-square-solid.svg?raw';
-import { default as ellipsisVerticalIconSvg } from '../../../../../../shared/common/icons/ellipsis-vertical-solid.svg?raw';
-import { default as caretUpIconSvg } from '../../../../../../shared/common/icons/caret-up-solid.svg?raw';
-import { default as caretDownIconSvg } from '../../../../../../shared/common/icons/caret-down-solid.svg?raw';
-import { default as rulerSvg } from '../../../../../../shared/common/icons/ruler-solid.svg?raw';
-import { default as paintbrushSvg } from '../../../../../../shared/common/icons/paintbrush-solid.svg?raw';
-import { default as highlighterIcon } from '../../../../../../shared/common/icons/highlighter-icon.svg?raw';
-import { default as magicWandIcon } from '../../../../../../shared/common/icons/magic-wand-solid.svg?raw';
-import { default as tableIconSvg } from '../../../../../../shared/common/icons/table-solid.svg?raw';
-import { default as tableColumnsIconSvg } from '../../../../../../shared/common/icons/table-columns-solid.svg?raw';
-import { default as arrowsLeftRightIconSvg } from '../../../../../../shared/common/icons/arrows-left-right-solid.svg?raw';
-import { default as arrowsToDotIconSvg } from '../../../../../../shared/common/icons/arrows-to-dot-solid.svg?raw';
-import { default as plusIconSvg } from '../../../../../../shared/common/icons/plus-solid.svg?raw';
-import { default as trashIconSvg } from '../../../../../../shared/common/icons/trash-can-solid.svg?raw';
-import { default as borderNoneIconSvg } from '../../../../../../shared/common/icons/border-none-solid.svg?raw';
-import { default as wrenchIconSvg } from '../../../../../../shared/common/icons/wrench-solid.svg?raw';
-import { default as upDownIconSvg } from '../../../../../../shared/common/icons/up-down.svg?raw';
-import { default as magnifyingGlassSvg } from '../../../../../../shared/common/icons/magnifying-glass.svg?raw';
-import { default as scissorsIconSvg } from '../../../../../../shared/common/icons/scissors-solid.svg?raw';
-import { default as copyIconSvg } from '../../../../../../shared/common/icons/copy-solid.svg?raw';
-import { default as pasteIconSvg } from '../../../../../../shared/common/icons/paste-solid.svg?raw';
-import { default as strikethroughSvg } from '../../../../../../shared/common/icons/strikethrough.svg?raw';
-import { default as paragraphIconSvg } from '../../../../../../shared/common/icons/paragraph-solid.svg?raw';
-export namespace toolbarIcons {
-    export { rotateLeftIconSvg as undo };
-    export { rotateRightIconSvg as redo };
-    export { boldIconSvg as bold };
-    export { italicIconSvg as italic };
-    export { underlineIconSvg as underline };
-    export { fontIconSvg as color };
-    export { linkIconSvg as link };
-    export { imageIconSvg as image };
-    export { tocIconSvg as tableOfContents };
-    export { watermarkIconSvg as watermark };
-    export { pageNumberIconSvg as pageNumber };
-    export { alignLeftIconSvg as alignLeft };
-    export { alignRightIconSvg as alignRight };
-    export { alignCenterIconSvg as alignCenter };
-    export { alignJustifyIconSvg as alignJustify };
-    export { listIconSvg as bulletList };
-    export { listIconSvg as bulletListDisc };
-    export { listCircleIconSvg as bulletListCircle };
-    export { listSquareIconSvg as bulletListSquare };
-    export { listOlIconSvg as numberedList };
-    export { listDecimalIconSvg as numberedListDecimal };
-    export { listDecimalParenIconSvg as numberedListDecimalParen };
-    export { listUpperRomanIconSvg as numberedListUpperRoman };
-    export { listLowerRomanIconSvg as numberedListLowerRoman };
-    export { listUpperAlphaIconSvg as numberedListUpperAlpha };
-    export { listUpperAlphaParenIconSvg as numberedListUpperAlphaParen };
-    export { listLowerAlphaIconSvg as numberedListLowerAlpha };
-    export { listLowerAlphaParenIconSvg as numberedListLowerAlphaParen };
-    export { outdentIconSvg as indentLeft };
-    export { indentIconSvg as indentRight };
-    export { paragraphLtrIconSvg as directionLtr };
-    export { paragraphRtlIconSvg as directionRtl };
-    export { fileHalfDashedIconSvg as pageBreak };
-    export { paintRollerIconSvg as copyFormat };
-    export { textSlashIconSvg as clearFormatting };
-    export { listCheckIconSvg as trackChanges };
-    export { fileIconSvg as trackChangesFinal };
-    export { eyeIconSvg as trackChangesOriginal };
-    export { calendarCheckIconSvg as trackChangesAccept };
-    export { calendarXmarkIconSvg as trackChangesReject };
-    export { userEditIconSvg as documentMode };
-    export { userEditIconSvg as documentEditingMode };
-    export { commentIconSvg as documentSuggestingMode };
-    export { eyeIconSvg as documentViewingMode };
-    export { circleIconSvg as colorOption };
-    export { checkIconSvg as colorOptionCheck };
-    export { linkIconSvg as linkInput };
-    export { xmarkIconSvg as removeLink };
-    export { upRightFromSquareIconSvg as openLink };
-    export { ellipsisVerticalIconSvg as overflow };
-    export { caretUpIconSvg as dropdownCaretUp };
-    export { caretDownIconSvg as dropdownCaretDown };
-    export { rulerSvg as ruler };
-    export { paintbrushSvg as paintbrush };
-    export { highlighterIcon as highlight };
-    export { magicWandIcon as ai };
-    export { tableIconSvg as table };
-    export { tableColumnsIconSvg as tableActions };
-    export { arrowsLeftRightIconSvg as splitCell };
-    export { arrowsToDotIconSvg as mergeCells };
-    export { plusIconSvg as addRowBefore };
-    export { plusIconSvg as addRowAfter };
-    export { plusIconSvg as addColumnBefore };
-    export { plusIconSvg as addColumnAfter };
-    export { trashIconSvg as deleteRow };
-    export { trashIconSvg as deleteColumn };
-    export { trashIconSvg as deleteTable };
-    export { borderNoneIconSvg as deleteBorders };
-    export { wrenchIconSvg as fixTables };
-    export { upDownIconSvg as lineHeight };
-    export { magnifyingGlassSvg as search };
-    export { scissorsIconSvg as cut };
-    export { copyIconSvg as copy };
-    export { pasteIconSvg as paste };
-    export { strikethroughSvg as strikethrough };
-    export { paragraphIconSvg as formattingMarks };
-}
+export declare const toolbarIcons: {
+    undo: string;
+    redo: string;
+    bold: string;
+    italic: string;
+    underline: string;
+    color: string;
+    link: string;
+    image: string;
+    tableOfContents: string;
+    watermark: string;
+    pageNumber: string;
+    alignLeft: string;
+    alignRight: string;
+    alignCenter: string;
+    alignJustify: string;
+    bulletList: string;
+    bulletListDisc: string;
+    bulletListCircle: string;
+    bulletListSquare: string;
+    numberedList: string;
+    numberedListDecimal: string;
+    numberedListDecimalParen: string;
+    numberedListUpperRoman: string;
+    numberedListLowerRoman: string;
+    numberedListUpperAlpha: string;
+    numberedListUpperAlphaParen: string;
+    numberedListLowerAlpha: string;
+    numberedListLowerAlphaParen: string;
+    indentLeft: string;
+    indentRight: string;
+    directionLtr: string;
+    directionRtl: string;
+    pageBreak: string;
+    copyFormat: string;
+    clearFormatting: string;
+    trackChanges: string;
+    trackChangesFinal: string;
+    trackChangesOriginal: string;
+    trackChangesAccept: string;
+    trackChangesReject: string;
+    documentMode: string;
+    documentEditingMode: string;
+    documentSuggestingMode: string;
+    documentViewingMode: string;
+    colorOption: string;
+    colorOptionCheck: string;
+    linkInput: string;
+    removeLink: string;
+    openLink: string;
+    overflow: string;
+    dropdownCaretUp: string;
+    dropdownCaretDown: string;
+    ruler: string;
+    paintbrush: string;
+    highlight: string;
+    ai: string;
+    table: string;
+    tableActions: string;
+    splitCell: string;
+    mergeCells: string;
+    addRowBefore: string;
+    addRowAfter: string;
+    addColumnBefore: string;
+    addColumnAfter: string;
+    deleteRow: string;
+    deleteColumn: string;
+    deleteTable: string;
+    deleteBorders: string;
+    fixTables: string;
+    lineHeight: string;
+    search: string;
+    cut: string;
+    copy: string;
+    paste: string;
+    strikethrough: string;
+    formattingMarks: string;
+};

package/dist/superdoc/src/internal/toolbar/built-in/url-safety.d.ts

@@ -1,8 +1,16 @@
+/**
+ * Minimal href sanitizer for the built-in link popover.
+ *
+ * The v1 toolbar used the shared `@superdoc/url-validation` package, which is not
+ * a resolvable runtime dependency of the published `superdoc` ES build. This
+ * keeps the same fail-closed posture (only known-safe schemes pass) without
+ * pulling in that package: dangerous schemes (`javascript:`, `data:`,
+ * `vbscript:`) return `null`, mirroring the v1 contract that callers treat a
+ * `null` result as an invalid URL.
+ */
 /**
  * Validate and normalize an href. Returns `{ href }` for safe values, or `null`.
- * @param {string} value
- * @returns {{ href: string }|null}
  */
-export function sanitizeHref(value: string): {
+export declare function sanitizeHref(value: unknown): {
     href: string;
 } | null;

package/dist/superdoc/src/internal/toolbar/built-in-toolbar.d.ts

@@ -32,8 +32,9 @@ type BuiltInToolbarConfig = {
     showPageNumberButton: boolean;
     uiDisplayFallbackFont?: string;
 };
+type ToolbarSuperDoc = Partial<Pick<SuperDoc, 'activeEditor' | 'config' | 'ui' | 'uiConfig' | 'fonts' | 'on' | 'off' | 'emit' | 'focus' | 'toggleRuler' | 'toggleFormattingMarks' | 'setShowFormattingMarks'>>;
 type BuiltInToolbarOptions = {
-    superdoc?: SuperDoc | null;
+    superdoc?: ToolbarSuperDoc | null;
     editor?: Editor | null;
     selector?: string | HTMLElement | null;
     element?: string | HTMLElement | null;
@@ -58,7 +59,7 @@ export declare class BuiltInToolbar extends EventEmitter {
     pendingSelectionCapture: SelectionCapture | null | undefined;
     isDev: boolean;
     role: string;
-    superdoc: SuperDoc | null | undefined;
+    superdoc: ToolbarSuperDoc | null | undefined;
     toolbarContainer: HTMLElement | null;
     toolbar: ComponentPublicInstance | null;
     _detachFontsChanged: (() => void) | null;
@@ -66,7 +67,7 @@ export declare class BuiltInToolbar extends EventEmitter {
     app?: App | null;
     activeEditor: Editor | null;
     ui: BorrowedSuperDocUI | null;
-    snapshot: ToolbarSnapshotSlice | null;
+    snapshot: Partial<Pick<ToolbarSnapshotSlice, 'commands' | 'copyFormatActive'>> | null;
     _unsubscribeController: (() => void) | null;
     _detachFormatPainterModeChange: (() => void) | null;
     _customCommandRegs: Map<string, CustomCommandRegistrationResult<CustomButtonPayload>>;

package/dist/superdoc/src/internal/toolbar/image-upload.d.ts

@@ -1,10 +1,32 @@
+/**
+ * Interactive image acquisition for the built-in toolbar (SD-3567).
+ *
+ * The toolbar image button routes through the shared controller command
+ * `image` → `create.image`, which requires a base64 PNG/JPEG data-URI `src`.
+ * This module owns the browser file picker and the File → data-URI
+ * conversion; the toolbar dispatches the resulting payload through the
+ * normal controller command path.
+ */
+/** Accept filter for the picker: PNG and JPEG only (V1 parity; OOXML-native formats). */
+export declare const IMAGE_PICKER_ACCEPT = ".png,.jpg,.jpeg,image/png,image/jpeg";
+type NamedBlob = Blob & {
+    name?: string;
+};
+interface ImageFilePickerOptions {
+    ownerDocument?: Document;
+    onPick?: (file: File) => void | Promise<void>;
+    onError?: (error: unknown) => void;
+}
+interface ImageFilePicker {
+    input: HTMLInputElement;
+    open: () => void;
+    destroy: () => void;
+}
 /**
  * Whether a picked/dropped file is an insertable image (PNG/JPEG). Falls back
  * to the file extension when the browser reports no MIME type.
- * @param {File | null | undefined} file
- * @returns {boolean}
  */
-export function isSupportedImageFile(file: File | null | undefined): boolean;
+export declare function isSupportedImageFile(file: File | null | undefined): boolean;
 /**
  * Read a File/Blob into a base64 data URI.
  *
@@ -12,52 +34,20 @@ export function isSupportedImageFile(file: File | null | undefined): boolean;
  * accepts those by extension, but `readAsDataURL` would then produce an
  * `application/octet-stream` data URI that `create.image` rejects. Rewrite
  * the media type from the filename so extension-accepted files still insert.
- * @param {Blob & { name?: string }} file
- * @returns {Promise<string>}
  */
-export function fileToDataUri(file: Blob & {
-    name?: string;
-}): Promise<string>;
+export declare function fileToDataUri(file: NamedBlob): Promise<string>;
 /**
  * Resolve the `create.image` src for a picked file. Uses the consumer's
  * `handleImageUpload` callback when configured (V1 contract:
  * `(file: File) => Promise<string>`). A returned non-data URL is fetched and
  * embedded, because `create.image` requires an embedded base64 data URI.
- * @param {File} file
- * @param {((file: File) => Promise<string>) | null | undefined} handleImageUpload
- * @returns {Promise<string>}
  */
-export function resolveImageSrc(file: File, handleImageUpload: ((file: File) => Promise<string>) | null | undefined): Promise<string>;
+export declare function resolveImageSrc(file: File, handleImageUpload: ((file: File) => Promise<string>) | null | undefined): Promise<string>;
 /**
  * Hidden `<input type=file>` picker bound to one toolbar instance. The input
  * stays attached (hidden) so automation and tests can drive it; `destroy()`
  * removes it. Picking a file calls `onPick(file)`; an unsupported type or a
  * failed pick routes through `onError(error)`.
- *
- * @param {{
- *   ownerDocument?: Document,
- *   onPick?: (file: File) => unknown,
- *   onError?: (error: Error) => void,
- * }} options
- * @returns {{ input: HTMLInputElement, open: () => void, destroy: () => void }}
- */
-export function createImageFilePicker({ ownerDocument, onPick, onError }?: {
-    ownerDocument?: Document;
-    onPick?: (file: File) => unknown;
-    onError?: (error: Error) => void;
-}): {
-    input: HTMLInputElement;
-    open: () => void;
-    destroy: () => void;
-};
-/**
- * Interactive image acquisition for the built-in toolbar (SD-3567).
- *
- * The toolbar image button routes through the shared controller command
- * `image` → `create.image`, which requires a base64 PNG/JPEG data-URI `src`.
- * This module owns the browser file picker and the File → data-URI
- * conversion; the toolbar dispatches the resulting payload through the
- * normal controller command path.
  */
-/** Accept filter for the picker: PNG and JPEG only (V1 parity; OOXML-native formats). */
-export const IMAGE_PICKER_ACCEPT: ".png,.jpg,.jpeg,image/png,image/jpeg";
+export declare function createImageFilePicker({ ownerDocument, onPick, onError, }?: ImageFilePickerOptions): ImageFilePicker;
+export {};

package/dist/superdoc/src/stores/comments-store.d.ts

@@ -91,8 +91,8 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         key: null;
         entry: null;
     };
-    getCommentDocumentId: (comment: any) => string | null;
-    belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+    getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+    belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
     viewingVisibility: {
         documentMode: string;
         commentsVisible: boolean;
@@ -412,8 +412,8 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         key: null;
         entry: null;
     };
-    getCommentDocumentId: (comment: any) => string | null;
-    belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+    getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+    belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
     viewingVisibility: {
         documentMode: string;
         commentsVisible: boolean;
@@ -733,8 +733,8 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         key: null;
         entry: null;
     };
-    getCommentDocumentId: (comment: any) => string | null;
-    belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+    getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+    belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
     viewingVisibility: {
         documentMode: string;
         commentsVisible: boolean;
@@ -961,4 +961,4 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         appliedCount: number;
     } | undefined;
     remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-}, "resolveCommentPositionEntry" | "getCommentAliasIds" | "getCommentPositionKey" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "belongsToDocument" | "init" | "setViewingVisibility" | "setActiveComment" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
+}, "resolveCommentPositionEntry" | "getCommentAliasIds" | "getCommentPositionKey" | "belongsToDocument" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "init" | "setViewingVisibility" | "setActiveComment" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;

package/dist/superdoc/src/stores/helpers/comment-document-scope.d.ts

@@ -0,0 +1,22 @@
+export type DocumentScopedComment = {
+    fileId?: unknown;
+    documentId?: unknown;
+    selection?: {
+        documentId?: unknown;
+    } | null;
+} | null | undefined;
+type OpenDocument = {
+    id?: unknown;
+} | null | undefined;
+export type OpenDocumentsSource = OpenDocument[] | {
+    value?: OpenDocument[] | null;
+} | null | undefined;
+export type BelongsToDocumentOptions = {
+    allowSingleDocumentMismatch?: boolean;
+};
+export declare const getCommentDocumentId: (comment: DocumentScopedComment) => string | null;
+export declare const createCommentDocumentScope: (readOpenDocuments: () => OpenDocumentsSource) => {
+    belongsToDocument: (comment: DocumentScopedComment, activeDocumentId: string | null | undefined, options?: BelongsToDocumentOptions) => boolean;
+    belongsToTrackedChangeSyncDocument: (comment: DocumentScopedComment, activeDocumentId: string | null | undefined) => boolean;
+};
+export {};

package/dist/superdoc/src/stores/helpers/pending-selection-snapshot.d.ts

@@ -0,0 +1,17 @@
+export type PendingSelectionHost = {
+    activeEditor?: {
+        options?: {
+            documentId?: unknown;
+        } | null;
+        doc?: {
+            selection?: {
+                current?: () => unknown;
+            } | null;
+        } | null;
+    } | null;
+} | null | undefined;
+export type PendingActiveSelection = {
+    source?: unknown;
+    documentId?: unknown;
+} | null | undefined;
+export declare const getPendingSelectionSnapshot: (superdoc: PendingSelectionHost, activeSelection: PendingActiveSelection) => unknown;

package/dist/superdoc/src/stores/helpers/tracked-change-compaction.d.ts

@@ -0,0 +1,16 @@
+export type CompactableTrackedChangeRow = {
+    commentId?: unknown;
+    importedId?: unknown;
+    trackedChangeCanonicalId?: unknown;
+    trackedChangeAnchorKey?: unknown;
+    trackedChangePositionAliases?: unknown;
+    resolvedTime?: unknown;
+    resolvedById?: unknown;
+    resolvedByEmail?: unknown;
+    resolvedByName?: unknown;
+    trackedChangeDecision?: unknown;
+};
+export declare const getBodyTrackedChangeIdentityIds: (comment: CompactableTrackedChangeRow) => string[];
+export declare const groupBodyTrackedChangeCommentsByIdentity: <Row extends CompactableTrackedChangeRow>(comments: readonly Row[]) => Map<number, Row[]>;
+export declare const mergeDuplicateBodyTrackedChangeComments: <Row extends CompactableTrackedChangeRow>(groups: ReadonlyMap<number, readonly Row[]>) => Map<Row, Row>;
+export declare const createDroppedCommentIdMap: <Row extends CompactableTrackedChangeRow>(duplicates: ReadonlyMap<Row, Row>) => Map<string, string>;