superdoc 2.29.0-next.9 → 2.30.0-next.4

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/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/public/content-control-ref.d.ts

@@ -0,0 +1,12 @@
+import { ContentControlType } from '../../../document-api/src/index.js';
+export interface ContentControlRef {
+    id: string;
+    tag?: string;
+    alias?: string;
+    controlType: ContentControlType;
+    scope: 'inline' | 'block';
+}
+export interface ContentControlClickPayload {
+    target: ContentControlRef;
+    source: 'pointer';
+}

package/dist/superdoc/src/public/index.d.cts

@@ -1,6 +1,7 @@
 // Generated by scripts/ensure-types.cjs. Do not edit by hand.
 import type { AwarenessState as __Cjs_AwarenessState } from './index.js' with { "resolution-mode": "import" };
 import type { AwarenessUser as __Cjs_AwarenessUser } from './index.js' with { "resolution-mode": "import" };
+import type { BlockChange as __Cjs_BlockChange } from './index.js' with { "resolution-mode": "import" };
 import type { BlockNavigationAddress as __Cjs_BlockNavigationAddress } from './index.js' with { "resolution-mode": "import" };
 import type { BlocksListResult as __Cjs_BlocksListResult } from './index.js' with { "resolution-mode": "import" };
 import type { BookmarkAddress as __Cjs_BookmarkAddress } from './index.js' with { "resolution-mode": "import" };
@@ -8,6 +9,11 @@ import type { BookmarkInfo as __Cjs_BookmarkInfo } from './index.js' with { "res
 import type { BorrowedSuperDocUI as __Cjs_BorrowedSuperDocUI } from './index.js' with { "resolution-mode": "import" };
 import type { BuiltInCommandId as __Cjs_BuiltInCommandId } from './index.js' with { "resolution-mode": "import" };
 import type { CanPerformPermissionParams as __Cjs_CanPerformPermissionParams } from './index.js' with { "resolution-mode": "import" };
+import type { ChangeActor as __Cjs_ChangeActor } from './index.js' with { "resolution-mode": "import" };
+import type { ChangeCause as __Cjs_ChangeCause } from './index.js' with { "resolution-mode": "import" };
+import type { ChangeProvenance as __Cjs_ChangeProvenance } from './index.js' with { "resolution-mode": "import" };
+import type { ChangeRecord as __Cjs_ChangeRecord } from './index.js' with { "resolution-mode": "import" };
+import type { ChangesConfig as __Cjs_ChangesConfig } from './index.js' with { "resolution-mode": "import" };
 import type { CollaborationConfig as __Cjs_CollaborationConfig } from './index.js' with { "resolution-mode": "import" };
 import type { CommentAddress as __Cjs_CommentAddress } from './index.js' with { "resolution-mode": "import" };
 import type { CommentInteractionConfig as __Cjs_CommentInteractionConfig } from './index.js' with { "resolution-mode": "import" };
@@ -298,6 +304,8 @@ import type { UIConfig as __Cjs_UIConfig } from './index.js' with { "resolution-
 import type { UpgradeToCollaborationOptions as __Cjs_UpgradeToCollaborationOptions } from './index.js' with { "resolution-mode": "import" };
 import type { UpgradeToCollaborationResult as __Cjs_UpgradeToCollaborationResult } from './index.js' with { "resolution-mode": "import" };
 import type { User as __Cjs_User } from './index.js' with { "resolution-mode": "import" };
+import type { UserClaim as __Cjs_UserClaim } from './index.js' with { "resolution-mode": "import" };
+import type { UserClaimContext as __Cjs_UserClaimContext } from './index.js' with { "resolution-mode": "import" };
 import type { V2CollaborationConfig as __Cjs_V2CollaborationConfig } from './index.js' with { "resolution-mode": "import" };
 import type { ViewingOptions as __Cjs_ViewingOptions } from './index.js' with { "resolution-mode": "import" };
 import type { ViewingTrackedChangesMode as __Cjs_ViewingTrackedChangesMode } from './index.js' with { "resolution-mode": "import" };
@@ -306,6 +314,7 @@ import type { ViewOptions as __Cjs_ViewOptions } from './index.js' with { "resol
 export type { __Cjs_AwarenessState as AwarenessState };
 export type { __Cjs_AwarenessUser as AwarenessUser };
 export declare const BlankDOCX: typeof import('./index.js', { with: { "resolution-mode": "import" } }).BlankDOCX;
+export type { __Cjs_BlockChange as BlockChange };
 export type { __Cjs_BlockNavigationAddress as BlockNavigationAddress };
 export type { __Cjs_BlocksListResult as BlocksListResult };
 export type { __Cjs_BookmarkAddress as BookmarkAddress };
@@ -314,6 +323,11 @@ export type { __Cjs_BorrowedSuperDocUI as BorrowedSuperDocUI };
 export declare const buildTheme: typeof import('./index.js', { with: { "resolution-mode": "import" } }).buildTheme;
 export type { __Cjs_BuiltInCommandId as BuiltInCommandId };
 export type { __Cjs_CanPerformPermissionParams as CanPerformPermissionParams };
+export type { __Cjs_ChangeActor as ChangeActor };
+export type { __Cjs_ChangeCause as ChangeCause };
+export type { __Cjs_ChangeProvenance as ChangeProvenance };
+export type { __Cjs_ChangeRecord as ChangeRecord };
+export type { __Cjs_ChangesConfig as ChangesConfig };
 export type { __Cjs_CollaborationConfig as CollaborationConfig };
 export type { __Cjs_CommentAddress as CommentAddress };
 export type { __Cjs_CommentInteractionConfig as CommentInteractionConfig };
@@ -615,6 +629,8 @@ export type { __Cjs_UIConfig as UIConfig };
 export type { __Cjs_UpgradeToCollaborationOptions as UpgradeToCollaborationOptions };
 export type { __Cjs_UpgradeToCollaborationResult as UpgradeToCollaborationResult };
 export type { __Cjs_User as User };
+export type { __Cjs_UserClaim as UserClaim };
+export type { __Cjs_UserClaimContext as UserClaimContext };
 export type { __Cjs_V2CollaborationConfig as V2CollaborationConfig };
 export type { __Cjs_ViewingOptions as ViewingOptions };
 export type { __Cjs_ViewingTrackedChangesMode as ViewingTrackedChangesMode };

package/dist/superdoc/src/public/index.d.ts

@@ -200,6 +200,9 @@ export type { UpgradeToCollaborationResult } from '../core/types/index.js';
 export type { SuperDocCollaborationUpgradeError } from '../core/types/index.js';
 export type { V2CollaborationConfig } from '../core/types/index.js';
 export type { User } from '../core/types/index.js';
+export type { UserClaim, UserClaimContext } from '../core/types/index.js';
+export type { ChangesConfig } from '../core/types/index.js';
+export type { BlockChange, ChangeActor, ChangeCause, ChangeProvenance, ChangeRecord } from '../../../document-api/src/index.js';
 export type { ViewOptions } from '../core/types/index.js';
 export type { ViewingOptions } from '../core/types/index.js';
 export type { ViewingTrackedChangesMode } from '../core/types/index.js';

package/dist/superdoc/src/public/ui/async-read-cache.d.ts

@@ -0,0 +1,32 @@
+export type AsyncReadEntry = {
+    token: string | null;
+    value: unknown;
+    hasSettled: boolean;
+    inflightToken: string | null;
+    failedToken?: string | null;
+    failureCount?: number;
+    retryAtMs?: number;
+    settled?: Promise<void>;
+};
+export type AsyncReadSettlement = {
+    key: string;
+    settledAtMs: number;
+    commandId: string | null;
+    commandKind: string | null;
+};
+export interface AsyncReadCacheOptions {
+    isDisposed: () => boolean;
+    recomputeAfterSettle: () => void;
+    recomputeWhenRetryDue: () => void;
+}
+export declare function failureRetryDelayMs(failureCount: number): number;
+export declare function createAsyncReadCache(options: AsyncReadCacheOptions): {
+    entries: Map<string, AsyncReadEntry>;
+    issue: (key: string, token: string, run: () => unknown, normalize: (raw: unknown) => unknown) => AsyncReadEntry | null;
+    seed: (key: string, token: string | null, value: unknown, inflightToken?: string | null) => void;
+    clearKeys: (predicate: (key: string) => boolean) => void;
+    scheduleRefresh: () => void;
+    scheduleFailureRetry: (retryAtMs: number) => void;
+    cancelFailureRetry: () => void;
+    drainSettlements: () => AsyncReadSettlement[];
+};