superdoc 2.28.0 → 2.29.0-next.13

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

@@ -1,23 +1,13 @@
-export function makeColorOption(color: any, label?: null): {
-    label: null;
-    icon: any;
-    value: any;
-    style: {
-        color: any;
-        boxShadow: string;
-        borderRadius: string;
-    };
+import { BuiltInToolbar, ToolbarItem } from '../built-in-toolbar.js';
+type ColorOption = {
+    label: string;
+    icon: string;
+    value: string;
+    style: Record<string, string>;
 };
-export function renderColorOptions(superToolbar: any, button: any, customIcons?: any[], hasNoneIcon?: boolean): import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+type ColorDropdownToolbar = Pick<BuiltInToolbar, 'emitCommand' | 'superdoc' | 'activeEditor'>;
+type ColorDropdownButton = Pick<ToolbarItem, 'name' | 'type' | 'command' | 'isCustomToolbarItem' | 'iconColor' | 'expand'>;
+export declare const renderColorOptions: (superToolbar: ColorDropdownToolbar, button: ColorDropdownButton, customIcons?: ColorOption[][], hasNoneIcon?: boolean) => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
     [key: string]: any;
 }>;
-export const icons: {
-    label: null;
-    icon: any;
-    value: any;
-    style: {
-        color: any;
-        boxShadow: string;
-        borderRadius: string;
-    };
-}[][];
+export {};

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

@@ -1,51 +1,18 @@
-/**
- * The single seam that composes the font dropdown options: it turns the active document's
- * {@link import('../../../../../shared/font-system/src/index.js').DocumentFontOption}s into toolbar font options and unions them
- * with the bundled defaults. The toolbar only asks for the result; it does not know how a font previews.
- *
- * - A consumer-provided `configFonts` list is returned UNCHANGED (custom toolbars own their list).
- * - With no document options, returns `undefined` so the caller keeps its fallback to {@link TOOLBAR_FONTS}.
- * - Otherwise: bundled defaults and document fonts are deduped by normalized logical family, then sorted
- *   alphabetically by the visible font name. `label`/`key` stay the pure logical family (active-state
- *   matching + the stored value), and the preview renders in `previewFamily`.
- *
- * @param {ReadonlyArray<import('../../../../../shared/font-system/src/index.js').DocumentFontOption>} documentOptions
- * @param {Array} [configFonts] - the consumer's `fonts` config, if any
- * @returns {Array|undefined}
- */
-export function composeToolbarFontOptions(documentOptions: ReadonlyArray<import('../../../../../shared/font-system/src/index.js').DocumentFontOption>, configFonts?: any[]): any[] | undefined;
-/**
- * Map the host-computed, activation-aware font-family options onto the toolbar option shape. PURE: it
- * receives the already-resolved list from `superdoc.fonts.getFontFamilyOptions()` (the host owns the
- * `@superdoc/font-system` computation this module must not import). Returns `undefined` for an empty
- * list so the caller keeps its {@link TOOLBAR_FONTS} fallback. `label` is the Word-facing logical
- * family (stored on the selection + used for active-state matching), `key` is a stable option key, and
- * the row preview renders in `previewFamily` (falling back to the label).
- *
- * @param {ReadonlyArray<import('../../../../../shared/font-system/src/index.js').FontFamilyOption>} options
- * @returns {Array|undefined}
- */
-export function mapFontFamilyOptionsToToolbar(options: ReadonlyArray<import('../../../../../shared/font-system/src/index.js').FontFamilyOption>): any[] | undefined;
-export const TOOLBAR_FONTS: {
+import { DocumentFontOption, FontFamilyOption } from '../../../../../shared/font-system/src/index.js';
+import { ToolbarFontOption } from '../../../core/types/index.js';
+export declare const TOOLBAR_FONTS: ToolbarFontOption[];
+export declare function composeToolbarFontOptions(documentOptions: readonly DocumentFontOption[] | null | undefined, configFonts?: readonly ToolbarFontOption[]): readonly ToolbarFontOption[] | undefined;
+export declare function mapFontFamilyOptionsToToolbar(options: readonly FontFamilyOption[] | null | undefined): ToolbarFontOption[] | undefined;
+export declare const TOOLBAR_FONT_SIZES: {
     label: string;
     key: string;
     props: {
-        style: {
-            fontFamily: string;
-        };
         'data-item': string;
     };
 }[];
-export const TOOLBAR_FONT_SIZES: {
-    label: string;
-    key: string;
-    props: {
-        'data-item': string;
-    };
-}[];
-export namespace RESPONSIVE_BREAKPOINTS {
-    let sm: number;
-    let md: number;
-    let lg: number;
-    let xl: number;
-}
+export declare const RESPONSIVE_BREAKPOINTS: {
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+};

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

@@ -1,18 +1,35 @@
-/**
- * Set or clear the link item's `href` without disturbing the rest of its
- * attributes. The static configuration (`ariaLabel`, and anything added later)
- * lives in the same object as the transient href, so rebuilding that object
- * from the keys a caller knows about silently drops the others.
- *
- * Exported because the built-in toolbar's `updateToolbarState()` writes the
- * href on its own path, without going through this item's handlers. Both
- * callers share this one rule so the two cannot drift apart.
- */
-export function withLinkHref(attributes: any, href: any): any;
-export function makeDefaultItems({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts, hideButtons, availableWidth, role, isDev, configuredItemNames, configuredItemOrder, excludedItemNames, additionalItems, }?: {
-    isDev?: boolean | undefined;
-    additionalItems?: never[] | undefined;
-}): {
-    defaultItems: any[];
-    overflowItems: any[];
+import { ToolbarItemAttributes } from './use-toolbar-item.js';
+import { BuiltInToolbar, ToolbarItem } from '../built-in-toolbar.js';
+type DefaultItemsToolbar = Pick<BuiltInToolbar, 'config' | 'ui' | 'superdoc' | 'activeEditor' | 'pendingSelectionCapture' | 'emitCommand' | 'isCommandEnabled' | 'getLinkedStyleOptions' | 'getActiveLinkedStyleId' | 'updateLinkedStyleToMatchSelection'>;
+interface DefaultItemsInput {
+    superToolbar: DefaultItemsToolbar;
+    toolbarIcons: Readonly<Record<string, unknown>>;
+    toolbarTexts: Readonly<Record<string, unknown>>;
+    toolbarFonts?: readonly FontOption[] | null;
+    hideButtons: boolean;
+    availableWidth: number;
+    role: string;
+    isDev?: boolean;
+    configuredItemNames?: ReadonlySet<string> | null;
+    configuredItemOrder?: readonly string[] | null;
+    excludedItemNames?: ReadonlySet<string> | null;
+    additionalItems?: readonly ToolbarItem[];
+}
+type FontOption = {
+    label: string;
+    key: string;
+    value?: string;
+    props?: {
+        style?: {
+            fontFamily?: string;
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
 };
+export declare function withLinkHref(attributes: ToolbarItemAttributes, href: unknown): ToolbarItemAttributes;
+export declare const makeDefaultItems: ({ superToolbar, toolbarIcons: configuredIcons, toolbarTexts: configuredTexts, toolbarFonts, hideButtons, availableWidth, role, isDev, configuredItemNames, configuredItemOrder, excludedItemNames, additionalItems, }: DefaultItemsInput) => {
+    defaultItems: ToolbarItem[];
+    overflowItems: ToolbarItem[];
+};
+export {};

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

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

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

@@ -1,2 +1,10 @@
-export function preventEditorFocusTransfer(event: any): void;
-export function refocusEditorSurface(superToolbar: any, preferredEditor?: null): void;
+type FocusTarget = {
+    focus?: unknown;
+};
+type RefocusToolbar = {
+    superdoc?: FocusTarget | null;
+    activeEditor?: FocusTarget | null;
+};
+export declare const preventEditorFocusTransfer: (event: Pick<Event, "target" | "preventDefault">) => void;
+export declare const refocusEditorSurface: (superToolbar: RefocusToolbar | null | undefined, preferredEditor?: FocusTarget | null) => void;
+export {};

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

@@ -1,3 +1,70 @@
+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 };

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

@@ -1,61 +1,61 @@
-export namespace toolbarTexts {
-    let bold: string;
-    let fontFamily: string;
-    let ai: string;
-    let fontSize: string;
-    let italic: string;
-    let underline: string;
-    let highlight: string;
-    let strikethrough: string;
-    let color: string;
-    let search: string;
-    let link: string;
-    let image: string;
-    let tableOfContents: string;
-    let watermark: string;
-    let pageNumber: string;
-    let table: string;
-    let tableActions: string;
-    let addRowBefore: string;
-    let addRowAfter: string;
-    let addColumnBefore: string;
-    let addColumnAfter: string;
-    let deleteRow: string;
-    let deleteColumn: string;
-    let deleteTable: string;
-    let removeBorders: string;
-    let mergeCells: string;
-    let splitCell: string;
-    let fixTables: string;
-    let textAlign: string;
-    let bulletList: string;
-    let numberedList: string;
-    let indentLeft: string;
-    let indentRight: string;
-    let directionLtr: string;
-    let directionRtl: string;
-    let zoom: string;
-    let measurementUnit: string;
-    let undo: string;
-    let redo: string;
-    let trackChanges: string;
-    let trackChangesAccept: string;
-    let trackChangesReject: string;
-    let trackChangesOriginal: string;
-    let trackChangesFinal: string;
-    let clearFormatting: string;
-    let copyFormat: string;
-    let lineHeight: string;
-    let formatText: string;
-    let ruler: string;
-    let formattingMarks: string;
-    let pageBreak: string;
-    let documentEditingMode: string;
-    let documentSuggestingMode: string;
-    let documentViewingMode: string;
-    let documentEditingModeDescription: string;
-    let documentSuggestingModeDescription: string;
-    let documentViewingModeDescription: string;
-    let linkedStyles: string;
-    let updateLinkedStyle: string;
-}
+export declare const toolbarTexts: {
+    bold: string;
+    fontFamily: string;
+    ai: string;
+    fontSize: string;
+    italic: string;
+    underline: string;
+    highlight: string;
+    strikethrough: string;
+    color: string;
+    search: string;
+    link: string;
+    image: string;
+    tableOfContents: string;
+    watermark: string;
+    pageNumber: string;
+    table: string;
+    tableActions: string;
+    addRowBefore: string;
+    addRowAfter: string;
+    addColumnBefore: string;
+    addColumnAfter: string;
+    deleteRow: string;
+    deleteColumn: string;
+    deleteTable: string;
+    removeBorders: string;
+    mergeCells: string;
+    splitCell: string;
+    fixTables: string;
+    textAlign: string;
+    bulletList: string;
+    numberedList: string;
+    indentLeft: string;
+    indentRight: string;
+    directionLtr: string;
+    directionRtl: string;
+    zoom: string;
+    measurementUnit: string;
+    undo: string;
+    redo: string;
+    trackChanges: string;
+    trackChangesAccept: string;
+    trackChangesReject: string;
+    trackChangesOriginal: string;
+    trackChangesFinal: string;
+    clearFormatting: string;
+    copyFormat: string;
+    lineHeight: string;
+    formatText: string;
+    ruler: string;
+    formattingMarks: string;
+    pageBreak: string;
+    documentEditingMode: string;
+    documentSuggestingMode: string;
+    documentViewingMode: string;
+    documentEditingModeDescription: string;
+    documentSuggestingModeDescription: string;
+    documentViewingModeDescription: string;
+    linkedStyles: string;
+    updateLinkedStyle: string;
+};

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

@@ -1,50 +1,111 @@
-export function useToolbarItem(options: any): {
-    initiallyDisabled: boolean;
-    unref: () => {};
-    activate: (attrs?: {}, ...args: any[]) => void;
-    deactivate: () => void;
-    setDisabled: (state: any) => void;
-    resetDisabled: () => void;
-    onActivate: any;
-    onDeactivate: any;
-    id: import('vue').Ref<string, string>;
-    name: import('vue').Ref<any, any>;
-    type: any;
-    command: any;
-    noArgumentCommand: any;
-    icon: import('vue').Ref<any, any>;
-    tooltip: import('vue').Ref<any, any>;
-    group: import('vue').Ref<any, any>;
-    attributes: import('vue').Ref<any, any>;
-    disabled: import('vue').Ref<any, any>;
-    active: import('vue').Ref<boolean, boolean>;
-    expand: import('vue').Ref<boolean, boolean>;
-    nestedOptions: import('vue').Ref<never[], never[]>;
-    style: import('vue').Ref<any, any>;
-    isNarrow: import('vue').Ref<any, any>;
-    isWide: import('vue').Ref<any, any>;
-    minWidth: import('vue').Ref<any, any>;
-    layoutWidth: import('vue').Ref<any, any>;
-    argument: import('vue').Ref<any, any>;
-    parentItem: import('vue').Ref<null, null>;
-    iconColor: import('vue').Ref<any, any>;
-    hasCaret: import('vue').Ref<any, any>;
-    splitButton: import('vue').Ref<boolean, boolean>;
-    splitButtonCommand: any;
-    dropdownStyles: import('vue').Ref<any, any>;
-    tooltipVisible: import('vue').Ref<any, any>;
-    tooltipTimeout: import('vue').Ref<any, any>;
-    defaultLabel: import('vue').Ref<any, any>;
-    label: import('vue').Ref<any, any>;
-    hideLabel: import('vue').Ref<any, any>;
-    inlineTextInputVisible: import('vue').Ref<any, any>;
-    hasInlineTextInput: import('vue').Ref<any, any>;
-    restoreEditorFocus: boolean;
-    markName: import('vue').Ref<any, any>;
-    labelAttr: import('vue').Ref<any, any>;
-    childItem: import('vue').Ref<null, null>;
-    allowWithoutEditor: import('vue').Ref<any, any>;
-    dropdownValueKey: import('vue').Ref<any, any>;
-    selectedValue: import('vue').Ref<any, any>;
-    inputRef: import('vue').Ref<any, any>;
+import { CSSProperties, Ref } from 'vue';
+declare const TOOLBAR_ITEM_TYPES: readonly ["button", "options", "separator", "dropdown", "overflow"];
+export type ToolbarItemType = (typeof TOOLBAR_ITEM_TYPES)[number];
+export interface ToolbarItemOption {
+    key?: string | number;
+    label?: string;
+    type?: string;
+    disabled?: boolean;
+    class?: unknown;
+    props?: Record<string, unknown>;
+    icon?: string | object | ((option: ToolbarItemOption) => unknown);
+    render?: () => unknown;
+    [member: string]: unknown;
+}
+export type ToolbarItemAttributes = {
+    ariaLabel?: string;
+    className?: unknown;
+    [attribute: string]: unknown;
 };
+export type ToolbarItemStyle = string | CSSProperties;
+export type ToolbarActivationAttributes = Record<string, unknown>;
+export interface UseToolbarItemOptions {
+    type: ToolbarItemType;
+    name: string;
+    command?: unknown;
+    noArgumentCommand?: string;
+    icon?: string;
+    group?: string;
+    allowWithoutEditor?: boolean;
+    attributes?: ToolbarItemAttributes;
+    disabled?: boolean;
+    style?: ToolbarItemStyle;
+    isNarrow?: boolean;
+    isWide?: boolean;
+    layoutWidth?: number;
+    suppressActiveHighlight?: boolean;
+    argument?: unknown;
+    iconColor?: string;
+    hasCaret?: boolean;
+    splitButton?: boolean;
+    splitButtonCommand?: unknown;
+    restoreEditorFocus?: boolean;
+    dropdownStyles?: unknown;
+    tooltip?: string;
+    tooltipVisible?: boolean;
+    tooltipTimeout?: number;
+    defaultLabel?: string;
+    label?: string;
+    hideLabel?: boolean;
+    inlineTextInputVisible?: boolean;
+    hasInlineTextInput?: boolean;
+    markName?: string;
+    labelAttr?: string;
+    selectedValue?: string | number | null;
+    dropdownValueKey?: string;
+    inputRef?: unknown;
+    options?: readonly ToolbarItemOption[];
+    onActivate?: (attributes: ToolbarActivationAttributes, isMultiple?: boolean) => unknown;
+    onDeactivate?: () => unknown;
+}
+export interface ToolbarItem {
+    type: ToolbarItemType;
+    id: Ref<string>;
+    name: Ref<string>;
+    command?: unknown;
+    noArgumentCommand?: string;
+    splitButtonCommand?: unknown;
+    group: Ref<string>;
+    attributes: Ref<ToolbarItemAttributes>;
+    disabled: Ref<boolean | undefined>;
+    active: Ref<boolean>;
+    expand: Ref<boolean>;
+    nestedOptions: Ref<ToolbarItemOption[]>;
+    label: Ref<string | undefined>;
+    defaultLabel: Ref<string | undefined>;
+    icon: Ref<string | undefined>;
+    selectedValue: Ref<string | number | null | undefined>;
+    hideLabel: Ref<boolean | undefined>;
+    iconColor: Ref<string | undefined>;
+    hasCaret: Ref<boolean | undefined>;
+    splitButton: Ref<boolean>;
+    inlineTextInputVisible: Ref<boolean | undefined>;
+    hasInlineTextInput: Ref<boolean | undefined>;
+    style: Ref<ToolbarItemStyle | undefined>;
+    isNarrow: Ref<boolean | undefined>;
+    isWide: Ref<boolean | undefined>;
+    layoutWidth: Ref<number | undefined>;
+    tooltip: Ref<string | undefined>;
+    tooltipVisible: Ref<boolean | undefined>;
+    tooltipTimeout: Ref<number | undefined>;
+    argument: Ref<unknown>;
+    restoreEditorFocus: boolean;
+    dropdownStyles: Ref<unknown>;
+    dropdownValueKey: Ref<string | undefined>;
+    allowWithoutEditor: Ref<boolean | undefined>;
+    markName: Ref<string | undefined>;
+    labelAttr: Ref<string | undefined>;
+    inputRef: Ref<unknown>;
+    childItem: unknown;
+    parentItem: unknown;
+    initiallyDisabled: boolean;
+    isCustomToolbarItem?: boolean;
+    activate(attributes?: ToolbarActivationAttributes, isMultiple?: boolean): void;
+    deactivate(): void;
+    setDisabled(state: boolean): void;
+    resetDisabled(): void;
+    onActivate(attributes: ToolbarActivationAttributes, isMultiple?: boolean): unknown;
+    onDeactivate(): unknown;
+}
+export declare const useToolbarItem: (options: UseToolbarItemOptions) => ToolbarItem;
+export {};

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

@@ -1,31 +1,11 @@
 import { EventEmitter } from 'eventemitter3';
-import { App, ComponentPublicInstance, Ref } from 'vue';
+import { App, ComponentPublicInstance } from 'vue';
 import { Editor, SuperDoc, ToolbarCustomButton, ToolbarFontOption } from '../../core/types/index.js';
-import { BorrowedSuperDocUI, CustomCommandRegistrationResult, StyleCatalogItem, ToolbarSnapshotSlice } from '../../public/ui/types.js';
+import { BorrowedSuperDocUI, CustomCommandRegistrationResult, SelectionCapture, StyleCatalogItem, ToolbarSnapshotSlice } from '../../public/ui/types.js';
+import { ToolbarItem, ToolbarItemOption } from './built-in/use-toolbar-item.js';
 import { HighContrastMode } from '../../composables/use-high-contrast-mode.js';
-interface ToolbarItem {
-    type: string;
-    name: Ref<string>;
-    command?: unknown;
-    group: Ref<string>;
-    attributes: Ref<Record<string, unknown>>;
-    disabled: Ref<boolean>;
-    active: Ref<boolean>;
-    expand: Ref<boolean>;
-    nestedOptions: Ref<unknown[]>;
-    label: Ref<unknown>;
-    defaultLabel: Ref<unknown>;
-    icon: Ref<unknown>;
-    selectedValue: Ref<unknown>;
-    allowWithoutEditor: Ref<boolean | undefined>;
-    initiallyDisabled: boolean;
-    isCustomToolbarItem?: boolean;
-    activate(attributes?: Record<string, unknown>, ...args: unknown[]): void;
-    deactivate(): void;
-    setDisabled(state: boolean): void;
-    resetDisabled(): void;
-    onActivate(attributes?: Record<string, unknown>, ...args: unknown[]): unknown;
-}
+export type { ToolbarItem, ToolbarItemOption };
+export type ToolbarCommandItem = Pick<ToolbarItem, 'name'> & Partial<Pick<ToolbarItem, 'type' | 'command' | 'isCustomToolbarItem'>>;
 type CustomButtonPayload = {
     argument?: unknown;
     option?: unknown;
@@ -75,6 +55,7 @@ export declare class BuiltInToolbar extends EventEmitter {
     config: BuiltInToolbarConfig;
     toolbarItems: ToolbarItem[];
     overflowItems: ToolbarItem[];
+    pendingSelectionCapture: SelectionCapture | null | undefined;
     isDev: boolean;
     role: string;
     superdoc: SuperDoc | null | undefined;
@@ -128,7 +109,7 @@ export declare class BuiltInToolbar extends EventEmitter {
      * Main toolbar command entry point used by the rendered components.
      */
     emitCommand({ item, argument, option }: {
-        item: ToolbarItem;
+        item: ToolbarCommandItem;
         argument?: unknown;
         option?: unknown;
     }): void;
@@ -138,4 +119,3 @@ export declare class BuiltInToolbar extends EventEmitter {
  * Create the rendered built-in toolbar for a `SuperDoc` instance.
  */
 export declare function createBuiltInToolbar(config: BuiltInToolbarOptions): BuiltInToolbar;
-export {};

package/dist/superdoc/src/internal/toolbar/compatibility-catalog.d.ts

@@ -1,9 +1,9 @@
 /** Layout regions a built-in toolbar item can be placed in. */
-export type ToolbarGroup = 'left' | 'center' | 'right';
+type ToolbarGroup = 'left' | 'center' | 'right';
 /** How a documented built-in toolbar item is (or is not) backed on V2. */
-export type ToolbarItemDisposition = 'controller-routed' | 'host-routed' | 'shell-owned' | 'unsupported' | 'unresolved';
+type ToolbarItemDisposition = 'controller-routed' | 'host-routed' | 'shell-owned' | 'unsupported' | 'unresolved';
 /** One documented built-in toolbar item and how it maps onto V2. */
-export interface BuiltInToolbarItemEntry {
+interface BuiltInToolbarItemEntry {
     /** Legacy built-in item name (the id v1 toolbars and the docs use). */
     readonly name: string;
     /**
@@ -73,3 +73,4 @@ export declare function resolveBuiltInItemCommandId(name: string): string | null
  * kept exported so a future renderer/build guard can reuse it.
  */
 export declare function assertCatalogAlignedWithController(): void;
+export {};

package/dist/superdoc/src/internal/toolbar/toolbar-item-aliases.d.ts

@@ -1,5 +1,5 @@
 /** Canonical toolbar item ids mapped to the names retained by the built-in runtime. */
-export const TOOLBAR_ITEM_ALIASES: Readonly<{
+export declare const TOOLBAR_ITEM_ALIASES: Readonly<{
     'font-family': "fontFamily";
     'font-size': "fontSize";
     strikethrough: "strike";