ooxml-ui 0.27.2 → 0.29.0

package/dist/docx/print-layout-view.d.ts

@@ -0,0 +1,38 @@
+import type { DocumentModel } from 'ooxml-core/docx';
+import { type LayoutResult } from 'ooxml-core/docx/layout';
+import { type PictureUrl } from './print-layout.js';
+/**
+ * Print Layout view: a read-only, paginated render kept in sync with the
+ * editor model on a debounced relayout, rather than a second live editing
+ * surface. Clicking a line asks the caller to move the real ProseMirror
+ * cursor to the nearest editor position (see `print-layout.ts`'s
+ * `resolveClick`), which is the chosen approach for keeping a single
+ * source of truth for editing while still allowing click-to-place-cursor
+ * from the paginated view.
+ */
+export interface PrintLayoutController {
+    /** Mount this in the DOM alongside the continuous editing surface. */
+    element: HTMLElement;
+    setActive(active: boolean): void;
+    scheduleRelayout(model: DocumentModel): void;
+    /** Recomputes which page is most visible; call on the scroll container's `scroll` event. */
+    refreshCurrentPage(): void;
+    pageStatus(): {
+        current: number;
+        total: number;
+    } | null;
+    /** The laid-out page sheets currently in the DOM, in order. */
+    pageElements(): HTMLElement[];
+    /** Increments on every layout pass so dependants (the page navigator) know when to rebuild. */
+    layoutVersion(): number;
+    /** Scrolls the given 1-based page to the top of the scroll container. */
+    scrollToPage(page: number): void;
+    /** Approximations collected by the last layout pass (see `LayoutResult.approximations`). */
+    approximations(): string[];
+    /** Lays out immediately (no debounce) and opens the browser print dialog for the paginated render. */
+    print(model: DocumentModel, note: (message: string) => void): void;
+    destroy(): void;
+}
+export declare function createPrintLayoutController(scrollContainer: HTMLElement, onRequestCursor: (blockId: string, offset: number) => void, pictureUrl?: PictureUrl, onLayout?: () => void): PrintLayoutController;
+/** `@page`-sized print path: prints the current Print Layout render as-is. */
+export declare function printLayoutResult(result: LayoutResult | null, note: (message: string) => void): void;

package/dist/docx/print-layout.d.ts

@@ -0,0 +1,32 @@
+import type { PageBorders } from 'ooxml-core/docx';
+import { type LayoutResult } from 'ooxml-core/docx/layout';
+import { type PrintLineNumbering } from './print-line-numbers';
+export type { PrintLineNumbering } from './print-line-numbers';
+export interface PrintLayoutHandle {
+    /** The scrollable element holding one sheet per page; mount this in the DOM. */
+    element: HTMLElement;
+    pageCount: number;
+    /**
+     * Best-effort click-to-cursor mapping: given the line element under a
+     * click and its horizontal offset, measures the displayed text fragments
+     * and maps to a source boundary. Falls back to proportional mapping for
+     * older layout results. Print Layout remains a read-only render synced
+     * from the editor, not a second editing surface.
+     */
+    resolveClick(target: Element, clientX: number): {
+        blockId: string;
+        offset: number;
+    } | null;
+}
+/** Resolves a package picture part to a displayable URL; undefined draws a placeholder box. */
+export type PictureUrl = (partName: string, contentType: string) => string | undefined;
+export interface PrintLayoutOptions {
+    /** Line numbering by section index; sections without an entry print no numbers. */
+    lineNumbers?: ReadonlyArray<PrintLineNumbering | undefined>;
+    /** Page borders by section index; drawn on each page they apply to. */
+    pageBorders?: ReadonlyArray<PageBorders | undefined>;
+    /** Paragraphs with effective `w:suppressLineNumbers`; omitted from the counter. */
+    suppressedLineNumberParagraphs?: ReadonlySet<string>;
+}
+/** Pure, framework-neutral renderer: turns a `LayoutResult` into a DOM tree of page sheets. */
+export declare function renderPrintLayout(result: LayoutResult, pictureUrl?: PictureUrl, options?: PrintLayoutOptions): PrintLayoutHandle;

package/dist/docx/print-line-numbers.d.ts

@@ -0,0 +1,13 @@
+import type { LayoutResult } from 'ooxml-core/docx/layout';
+/** Line numbering of a section, as the section model gives it. */
+export interface PrintLineNumbering {
+    countBy: number;
+    start: number;
+    restart: 'newPage' | 'newSection' | 'continuous';
+    distanceTwips?: number;
+}
+/** Advances the body-line counter across columns/pages, skipping suppressed paragraphs. */
+export declare function lineNumberLabels(page: LayoutResult['pages'][number], settings: PrintLineNumbering, counter: {
+    next: number;
+    section: number;
+}, suppressed?: ReadonlySet<string>): HTMLElement[];

package/dist/docx/print-page-borders.d.ts

@@ -0,0 +1,18 @@
+import type { PageBorders } from 'ooxml-core/docx';
+/** The page geometry the border box is measured from (pixels at 96 DPI). */
+export interface BorderPage {
+    widthPx: number;
+    heightPx: number;
+    marginTopPx: number;
+    marginRightPx: number;
+    marginBottomPx: number;
+    marginLeftPx: number;
+    pageInSection: number;
+}
+/**
+ * A positioned box drawing a section's page borders on one printed sheet, or null when the borders
+ * do not show on this page (`w:display`) or no side has a line. Each side sits `w:space` points from
+ * the page edge (default) or from the text margins (`offsetFrom="text"`). Art borders are drawn as
+ * plain lines, as the document model reports. It never takes pointer events.
+ */
+export declare function pageBorderBox(page: BorderPage, borders: PageBorders): HTMLElement | null;

package/dist/docx/print-table.d.ts

@@ -0,0 +1,8 @@
+import type { LayoutParagraphBox, LayoutTableBox } from 'ooxml-core/docx/layout';
+/**
+ * Draws one table fragment: cells at their grid positions with shading and the document's
+ * borders (no gridlines, as Word prints), content inset by cell margins and aligned vertically.
+ * Each cell draws its top and left edges; the last cell of a row adds its right edge and the
+ * fragment's last row its bottom, so shared edges are drawn once.
+ */
+export declare function renderTable(box: LayoutTableBox, columnWidthPx: number, renderParagraph: (paragraph: LayoutParagraphBox) => HTMLElement): HTMLElement;

package/dist/docx/read-aloud.d.ts

@@ -0,0 +1,11 @@
+import type { EditorView } from 'prosemirror-view';
+/** Whether the browser can speak text; Read Aloud is unavailable (not faked) without it. */
+export declare function readAloudAvailable(): boolean;
+/** What Word's Read Aloud reads: the selection, or everything from the caret to the end. */
+export declare function textToRead(view: EditorView): string;
+export declare function isReadingAloud(): boolean;
+/**
+ * Starts reading `text` with the browser's voice, or stops when it is already reading. Returns
+ * whether speech is now playing. `onChange` fires when it ends by itself.
+ */
+export declare function toggleReadAloud(text: string, onChange: (speaking: boolean) => void): boolean;

package/dist/docx/review-commands.d.ts

@@ -0,0 +1,24 @@
+import type { EditorView } from 'prosemirror-view';
+export interface RevisionRange {
+    id: string;
+    kind: 'insert' | 'delete';
+    from: number;
+    to: number;
+    author: string;
+    /** The move this range is one side of; both sides are accepted or rejected together. */
+    move?: string;
+}
+/** Merges adjacent text/hardBreak nodes sharing the same revision mark id into one range. */
+export declare function collectRevisionRanges(doc: import('prosemirror-model').Node): RevisionRange[];
+export declare function hasAnyChange(view: EditorView | undefined): boolean;
+export declare function hasChangeAtCursor(view: EditorView | undefined): boolean;
+/** Accepting an insertion keeps the text; accepting a deletion removes it. Moves resolve both sides. */
+export declare function acceptRevisionRange(view: EditorView, range: RevisionRange): void;
+/** Rejecting an insertion removes the text; rejecting a deletion restores it. Moves resolve both sides. */
+export declare function rejectRevisionRange(view: EditorView, range: RevisionRange): void;
+export declare function acceptChangeAtCursor(view: EditorView): boolean;
+export declare function rejectChangeAtCursor(view: EditorView): boolean;
+export declare const acceptAllChanges: (view: EditorView) => boolean;
+export declare const rejectAllChanges: (view: EditorView) => boolean;
+export declare const goToNextChange: (view: EditorView) => boolean;
+export declare const goToPreviousChange: (view: EditorView) => boolean;

package/dist/docx/review-controller.d.ts

@@ -0,0 +1,30 @@
+import type { EditorView } from 'prosemirror-view';
+import type { DocumentModel } from 'ooxml-core/docx';
+import { type CommentsPanelHandle } from './comments-panel';
+import type { RibbonAction } from './ribbon';
+/** Narrow view of the host element `ReviewController` needs; keeps component.ts's own diff small. */
+export interface ReviewHost {
+    getModel(): DocumentModel;
+    setModel(model: DocumentModel): void;
+    getView(): EditorView | undefined;
+    getReviewAuthor(): string;
+    getCollaborationIds(): ((kind: string) => string) | undefined;
+    notifyChange(): void;
+    refresh(): void;
+}
+/** Owns comment add/reply/resolve/delete and tracked-change accept/reject/navigate/toggle commands. */
+export declare class ReviewController {
+    private host;
+    readonly commentsPanel: CommentsPanelHandle;
+    constructor(host: ReviewHost);
+    get commentsOpen(): boolean;
+    setLocale(locale: string): void;
+    /** Removes a comment, its replies and its anchored range in one go. */
+    private deleteById;
+    private updateComments;
+    private addComment;
+    handleReview(key: Extract<RibbonAction, {
+        type: 'review';
+    }>['key']): void;
+    handleComments(key: 'toggle' | 'add' | 'delete' | 'previous' | 'next'): void;
+}

package/dist/docx/review-display.d.ts

@@ -0,0 +1,11 @@
+import { Plugin } from 'prosemirror-state';
+/**
+ * All Markup shows insertions/deletions as authored (default CSS from schema.ts's marks).
+ * No Markup (final) hides deleted text and shows insertions unmarked, matching the resulting document.
+ * Original hides inserted text and shows deletions unmarked, matching the document before the changes.
+ * Simple Markup is approximated as No Markup with a change indicator; per-line change bars are not
+ * implemented, so it is visually identical to No Markup today (see docs/parity-roadmap.md).
+ */
+export type ReviewDisplayMode = 'all' | 'simple' | 'final' | 'original';
+/** Hides insertion or deletion runs via decorations rather than mutating the document. */
+export declare function reviewDisplayPlugin(getMode: () => ReviewDisplayMode): Plugin;

package/dist/docx/review-ribbon.d.ts

@@ -0,0 +1,2 @@
+/** Review tab's Track Changes / navigate-and-resolve / comments controls (see AGENTS.md hub-file rule). */
+export declare function createReviewControls(): HTMLElement[];

package/dist/docx/ribbon-action.d.ts

@@ -0,0 +1,183 @@
+import type { TableCommand } from './table-commands';
+import type { MultilingualAction } from './multilingual-ribbon';
+import type { ReviewDisplayMode } from './review-display';
+/** Every command the ribbon can raise, dispatched as a `ribbon-action` event. */
+export type RibbonAction = {
+    type: 'format';
+    key: 'bold' | 'italic' | 'underline' | 'strike' | 'superscript' | 'subscript';
+} | {
+    type: 'history';
+    key: 'undo' | 'redo';
+} | {
+    type: 'align';
+    value: 'left' | 'center' | 'right' | 'justify';
+} | {
+    type: 'font';
+    key: 'family' | 'size' | 'color' | 'highlight';
+    value: string;
+} | {
+    type: 'clear';
+} | {
+    type: 'table';
+    rows?: number;
+    columns?: number;
+} | {
+    type: 'tablePicker';
+} | {
+    type: 'clipboard';
+    key: 'cut' | 'copy' | 'paste';
+} | {
+    type: 'fontStep';
+    direction: 'grow' | 'shrink';
+} | {
+    type: 'insertBreak';
+    kind: 'page' | 'column';
+} | {
+    type: 'tableEdit';
+    key: TableCommand;
+} | {
+    type: 'page';
+    key: 'margin' | 'orientation' | 'columns' | 'numberFormat' | 'numberStart' | 'titlePage' | 'verticalAlign' | 'lineNumbers' | 'size';
+    value: string;
+} | {
+    type: 'sectionBreak';
+    kind: 'nextPage' | 'continuous' | 'evenPage' | 'oddPage';
+} | {
+    type: 'evenOddHeaders';
+} | {
+    type: 'pageColor';
+    value: string;
+} | {
+    type: 'hyphenation';
+    value: string;
+} | {
+    type: 'suppressLineNumbers';
+} | {
+    type: 'paragraph';
+    key: 'indent' | 'spacingBefore' | 'spacingAfter' | 'lineSpacing';
+    value: string;
+} | {
+    type: 'zoom';
+    value: number;
+} | {
+    type: 'list';
+    key: 'bullet' | 'number' | 'multilevel' | 'outline' | 'headings' | 'article' | 'roman' | 'increaseLevel' | 'decreaseLevel' | 'remove';
+} | {
+    type: 'view';
+    value: 'draft' | 'print';
+} | {
+    type: 'print';
+} | MultilingualAction | {
+    type: 'search';
+    focus?: 'find' | 'replace';
+} | {
+    type: 'changeCase';
+    value: 'sentence' | 'lower' | 'upper' | 'title' | 'toggle';
+} | {
+    type: 'formatPainter';
+} | {
+    type: 'ruler';
+} | {
+    type: 'coverPage';
+} | {
+    type: 'sort';
+    order: 'ascending' | 'descending';
+} | {
+    type: 'goTo';
+} | {
+    type: 'selectObjects';
+} | {
+    type: 'addText';
+    level: 0 | 1 | 2 | 3;
+} | {
+    type: 'blankPage';
+} | {
+    type: 'readAloud';
+} | {
+    type: 'gridlines';
+} | {
+    type: 'navigation';
+} | {
+    type: 'shading';
+    value: string;
+} | {
+    type: 'borders';
+    preset: 'none' | 'bottom' | 'top' | 'left' | 'right' | 'all' | 'outside' | 'insideH' | 'insideV' | 'horizontal';
+} | {
+    type: 'pageNumber';
+    position: 'top' | 'bottom';
+    align: 'left' | 'center' | 'right';
+    style?: 'plain' | 'pageOfTotal';
+} | {
+    type: 'headerFooter';
+    kind: 'header' | 'footer';
+    slot?: 'default' | 'first' | 'even';
+} | {
+    type: 'headerFooterLink';
+} | {
+    type: 'headerFooterClose';
+} | {
+    type: 'headerFooterNavigate';
+    target: 'header' | 'footer' | 'previous' | 'next';
+} | {
+    type: 'headerFooterPosition';
+    kind: 'header' | 'footer';
+    inches: number;
+} | {
+    type: 'formatDialog';
+    kind: import('./format-dialogs').FormatDialogKind;
+} | {
+    type: 'indent';
+    side: 'left' | 'right';
+    inches: number;
+} | {
+    type: 'zoomFit';
+    mode: 'actual' | 'width' | 'page' | 'pages';
+} | {
+    type: 'wordCount';
+} | {
+    type: 'spelling';
+} | {
+    type: 'insertSymbol';
+    value: string;
+} | {
+    type: 'dropCap';
+    value: 'none' | 'drop' | 'margin';
+} | {
+    type: 'insertDateTime';
+    value: 'long' | 'short' | 'time' | 'datetime';
+} | {
+    type: 'showMarks';
+} | {
+    type: 'selectAll';
+} | {
+    type: 'review';
+    key: 'trackChanges' | 'acceptOne' | 'rejectOne' | 'acceptAll' | 'rejectAll' | 'previous' | 'next';
+} | {
+    type: 'reviewDisplay';
+    value: ReviewDisplayMode;
+} | {
+    type: 'comments';
+    key: 'toggle' | 'add' | 'delete' | 'previous' | 'next';
+} | {
+    type: 'insertPicture';
+} | {
+    type: 'formatPicture';
+} | {
+    type: 'link';
+} | {
+    type: 'characterStyle';
+    value: string;
+} | {
+    type: 'showHidden';
+} | {
+    type: 'thumbnails';
+} | {
+    type: 'insertNote';
+    kind: 'footnote' | 'endnote';
+} | {
+    type: 'toc';
+    key: 'insert' | 'update' | 'remove' | 'fields' | 'figures' | 'updateFigures';
+    levels?: number;
+    label?: string;
+};

package/dist/docx/ribbon-behavior.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Ribbon KeyTips. The shared ribbon owns collapse and peek (`collapsible`); here, when the ribbon
+ * is focused with Alt or F10 (the host fires `dve-keytips`), tab badges appear and the matching
+ * letter opens that tab (`F` opens File); the tab's commands then show their own tips (see
+ * ribbon-keytips.ts).
+ */
+export declare function attachRibbonBehavior(root: HTMLElement): void;

package/dist/docx/ribbon-color-grid.d.ts

@@ -0,0 +1,11 @@
+/** The five variants under a theme colour, as Word's grid shows them (lighter, then darker). */
+export declare function themeShades(hex: string): string[];
+export interface ColorGridOptions {
+    /** Label of the first row's "clear" command, or omitted when the property cannot be cleared. */
+    noneLabel?: string;
+}
+/**
+ * Word's colour picker: a no-colour row, a Theme Colors grid (ten columns, each a colour over five
+ * variants), Standard Colors and More Colors (the browser's colour dialog).
+ */
+export declare function openColorGridPopover(anchor: HTMLElement, choose: (value: string) => void, options?: ColorGridOptions): void;

package/dist/docx/ribbon-combo.d.ts

@@ -0,0 +1,23 @@
+import type { RibbonAction } from './ribbon-action';
+export declare const FONT_FAMILIES: string[];
+/** Word's font size ladder, offered in the list; any size from 1 to 1638 pt can be typed. */
+export declare const FONT_SIZES: number[];
+/** The size a typed value means, or null when it is not a valid point size. */
+export declare function parseFontSize(text: string): number | null;
+/** Family names are kept to what Word stores in `w:rFonts`: a single plain name. */
+export declare function parseFontFamily(text: string): string | null;
+export interface ComboInput extends HTMLInputElement {
+    /** Entries offered by the drop-down, in order; the current value is added when it is missing. */
+    comboItems: string[];
+}
+/**
+ * Word's editable combo box: type a value and press Enter (or leave the box) to apply it, or pick
+ * from the list. The input carries the control's name and `value`; the caret button opens the list.
+ * `preview` draws each list entry in its own face (font names).
+ */
+export declare function comboBox(label: string, items: readonly string[], parse: (text: string) => string | null, action: (value: string) => RibbonAction, options?: {
+    preview?: boolean;
+    className?: string;
+}): HTMLDivElement;
+/** Shows `value` in a combo (or blank when the selection mixes values) and lists it if it is new. */
+export declare function setComboValue(input: ComboInput, value: string | null): void;

package/dist/docx/ribbon-commands.d.ts

@@ -0,0 +1,13 @@
+import type { DocumentModel } from 'ooxml-core/docx';
+import type { EditorView } from 'prosemirror-view';
+export declare function applyFont(view: EditorView, key: 'family' | 'size' | 'color', value: string): void;
+export declare function clearFormatting(view: EditorView): void;
+export declare const MAX_TABLE_ROWS = 100;
+export declare const MAX_TABLE_COLUMNS = 20;
+/** Inserts a table of `size` (2 x 2 when unspecified, at most 100 rows and 20 columns). */
+export declare function insertTable(view: EditorView, idGenerator?: (kind: string) => string, size?: {
+    rows?: number;
+    columns?: number;
+}): void;
+export declare function updateParagraphs(view: EditorView, key: 'indent' | 'spacingBefore' | 'spacingAfter' | 'lineSpacing', value: string): void;
+export declare function applyPageStyles(paper: HTMLElement, model: DocumentModel, zoom: number): void;

package/dist/docx/ribbon-controls.d.ts

@@ -0,0 +1,4 @@
+import type { EditorState } from 'prosemirror-state';
+/** Synchronize the inline-format toggle buttons with the current selection. */
+export declare function syncFormatControls(toolbar: HTMLElement, state: EditorState): void;
+export declare function syncParagraphControls(toolbar: HTMLElement, state: EditorState): void;

package/dist/docx/ribbon-gallery-menu.d.ts

@@ -0,0 +1,26 @@
+import type { RibbonAction } from './ribbon-action';
+import type { RibbonIcon } from './ribbon-icons';
+/** What a gallery entry looks like: a page thumbnail and a line of detail under the name. */
+export interface GalleryLook {
+    thumb: SVGSVGElement;
+    detail?: string;
+}
+export type GalleryKind = 'margins' | 'size' | 'orientation' | 'columns' | 'verticalAlign' | 'borders' | 'pageNumber' | 'lineSpacing';
+/** A command listed under a gallery's entries, such as Line Spacing Options. */
+export interface GalleryCommand {
+    label: string;
+    action: RibbonAction;
+}
+/** The thumbnail and detail for `value` of the gallery `kind`; unknown values get a plain page. */
+export declare function galleryLook(kind: GalleryKind, value: string, say?: (text: string) => string): GalleryLook;
+/**
+ * A dropdown command like `menuSelect`, but choosing opens a gallery of page thumbnails (Word's
+ * Margins, Size, Orientation and Columns) instead of the browser's plain list. The real `<select>`
+ * stays in the DOM so the editor keeps reading and writing `select.value`, and the keyboard still
+ * changes it directly.
+ */
+export declare function menuGallery(label: string, icon: RibbonIcon, kind: GalleryKind, values: Array<[string, string]>, action: (value: string) => RibbonAction, options?: {
+    compact?: boolean;
+    momentary?: boolean;
+    commands?: GalleryCommand[];
+}): HTMLElement;

package/dist/docx/ribbon-home.d.ts

@@ -0,0 +1,4 @@
+/** The Home tab in Word's group order: Clipboard, Font, Paragraph, Styles (added on load), Editing. */
+export declare function buildHomePanel(panels: Map<string, HTMLElement>): void;
+/** Layout > Paragraph: paragraph spacing before and after, as in Word's Layout tab. */
+export declare function buildParagraphSpacing(): HTMLElement[];

package/dist/docx/ribbon-icons.d.ts

@@ -0,0 +1,126 @@
+/** Line icons for ribbon buttons on a 24x24 grid, drawn with `currentColor` so themes apply. */
+declare const paths: {
+    readonly close: 'M6 6l12 12 M18 6L6 18';
+    readonly paste: 'M8 4h8v3H8z M6 5.5H5v15h14v-15h-1 M9 12h6 M9 15.5h6';
+    readonly cut: 'M6 3l9 12 M18 3l-9 12 M7 15.5a2.5 2.5 0 1 0 0 5 2.5 2.5 0 0 0 0-5z M17 15.5a2.5 2.5 0 1 0 0 5 2.5 2.5 0 0 0 0-5z';
+    readonly copy: 'M9 8h11v13H9z M6 16H4V3h11v2';
+    readonly bold: 'M7 4h6a3.5 3.5 0 0 1 0 7H7z M7 11h7a3.5 3.5 0 0 1 0 7H7z';
+    readonly italic: 'M10 4h8 M6 20h8 M15 4l-6 16';
+    readonly underline: 'M7 4v7a5 5 0 0 0 10 0V4 M5 21h14';
+    readonly strike: 'M4 12h16 M16.5 7.5C16 5.5 14 4.5 12 4.5c-2.5 0-4.2 1.3-4.2 3.2 0 1.6 1.2 2.4 4.2 3 M8 16.5c.5 2 2.3 3 4.2 3 2.6 0 4.3-1.3 4.3-3.3 0-1.2-.6-2-2-2.5';
+    readonly subscript: 'M4 5l8 10 M12 5L4 15 M16 17.5a2 2 0 1 1 3.5 1.3L16 22h4';
+    readonly superscript: 'M4 9l8 10 M12 9L4 19 M16 3.5a2 2 0 1 1 3.5 1.3L16 8h4';
+    readonly fontGrow: 'M3 19 8.5 5 14 19 M5 14h7 M17 9V3 M14 6h6';
+    readonly fontShrink: 'M3 19 8.5 5 14 19 M5 14h7 M14 6h6';
+    readonly clear: 'M4 20l4-1 11-11-3-3L5 16z M13 7l3 3 M14 20h7';
+    readonly fontColor: 'M6 17 12 4l6 13 M8.3 12h7.4';
+    readonly highlight: 'M14 4l6 6-8 8H8l-4-4v-3z M4 21h9';
+    readonly bullets: 'M9 6h11 M9 12h11 M9 18h11 M4.5 6h.01 M4.5 12h.01 M4.5 18h.01';
+    readonly numbering: 'M11 6h9 M11 12h9 M11 18h9 M4 4.5l1.5-1V9 M4 14.5c.5-1.5 3-1.5 3 .3 0 1-1.5 1.6-3 3.2h3';
+    readonly outdent: 'M8 6h12 M12 11h8 M12 16h8 M8 21h12 M7 9l-4 3 4 3z';
+    readonly indent: 'M8 6h12 M12 11h8 M12 16h8 M8 21h12 M3 9l4 3-4 3z';
+    readonly lineNumbers: 'M3 6h2 M3 12h2 M3 18h2 M8 6h13 M8 12h13 M8 18h13';
+    readonly multilevel: 'M4 6h3 M10 6h10 M7 12h3 M13 12h7 M10 18h3 M16 18h4';
+    readonly removeList: 'M9 6h11 M9 12h6 M9 18h11 M4 4l5 5 M9 4 4 9';
+    readonly alignLeft: 'M4 6h16 M4 10h10 M4 14h16 M4 18h10';
+    readonly alignCenter: 'M4 6h16 M7 10h10 M4 14h16 M7 18h10';
+    readonly alignRight: 'M4 6h16 M10 10h10 M4 14h16 M10 18h10';
+    readonly justify: 'M4 6h16 M4 10h16 M4 14h16 M4 18h16';
+    readonly lineSpacing: 'M10 6h10 M10 12h10 M10 18h10 M5 4v16 M3 6l2-2 2 2 M3 18l2 2 2-2';
+    readonly spaceBefore: 'M4 20h16 M8 4v10 M5.5 11.5 8 14l2.5-2.5';
+    readonly spaceAfter: 'M4 4h16 M8 20V10 M5.5 12.5 8 10l2.5 2.5';
+    readonly find: 'M10 4a6 6 0 1 0 0 12 6 6 0 0 0 0-12z M14.5 14.5 20 20';
+    readonly table: 'M4 5h16v14H4z M4 10h16 M4 15h16 M10 5v14 M15 5v14';
+    readonly picture: 'M4 5h16v14H4z M4 16l5-5 4 4 3-3 4 4 M15.5 9.5h.01';
+    readonly formatPicture: 'M4 6h12v12H4z M4 15l3-3 3 3 M16 4l4 4-7 7h-4v-4z';
+    readonly link: 'M10 14a4 4 0 0 0 5.7 0l3-3a4 4 0 0 0-5.7-5.7l-1 1 M14 10a4 4 0 0 0-5.7 0l-3 3a4 4 0 0 0 5.7 5.7l1-1';
+    readonly pageBreak: 'M7 3h10v6H7z M7 15h10v6H7z M3 12h3 M9 12h2 M13 12h2 M18 12h3';
+    readonly columnBreak: 'M4 4h6v16H4z M14 4h6v16h-6z M12 4v3 M12 10v4 M12 17v3';
+    readonly toc: 'M4 6h16 M8 11h12 M8 16h12 M4 11h.01 M4 16h.01 M4 21h16';
+    readonly updateTable: 'M20 12a8 8 0 1 1-2.5-5.8 M20 4v5h-5';
+    readonly footnote: 'M5 4h9v12H5z M8 8h3 M8 11h3 M4 20h16 M17 6v.01';
+    readonly endnote: 'M5 3h9v11H5z M8 7h3 M8 10h3 M4 17h16 M4 21h16';
+    readonly sectionNext: 'M5 3h9l3 3v8H5z M5 18h14 M5 21h14 M12 9v4 M10 11l2 2 2-2';
+    readonly sectionContinuous: 'M5 4h14v6H5z M5 14h14v6H5z M3 12h2 M8 12h2 M14 12h2 M19 12h2';
+    readonly sectionEven: 'M6 3h9l3 3v15H6z M9 13a1.5 1.5 0 0 1 3 0c0 1.2-3 2.5-3 3.5h3';
+    readonly sectionOdd: 'M6 3h9l3 3v15H6z M9 12l1.5-1v6';
+    readonly firstPage: 'M6 3h9l3 3v15H6z M9 8h6 M9 12h6 M9 16h3';
+    readonly oddEven: 'M3 5h8v14H3z M13 5h8v14h-8z M6 9h2 M16 9h2';
+    readonly track: 'M4 20l4-1 11-11-3-3L5 16z M14 20h7';
+    readonly previous: 'M6 14l6-6 6 6';
+    readonly next: 'M6 10l6 6 6-6';
+    readonly accept: 'M5 12.5l4.5 4.5L19 7';
+    readonly reject: 'M6 6l12 12 M18 6L6 18';
+    readonly acceptAll: 'M2 12.5l4 4L14 8 M10 15.5l1.5 1.5L21 7';
+    readonly rejectAll: 'M4 6l7 7 M11 6l-7 7 M14 12l7 7 M21 12l-7 7';
+    readonly comment: 'M4 5h16v11H10l-4 4v-4H4z M8 9h8 M8 12h5';
+    readonly comments: 'M3 4h13v9H9l-3 3v-3H3z M9 17h6l3 3v-3h3V8h-3';
+    readonly hidden: 'M3 12s3.5-6 9-6 9 6 9 6-3.5 6-9 6-9-6-9-6z M12 9.5a2.5 2.5 0 1 0 0 5 2.5 2.5 0 0 0 0-5z M4 20L20 4';
+    readonly thumbnails: 'M4 4h6v7H4z M14 4h6v7h-6z M4 14h6v7H4z M14 14h6v7h-6z';
+    readonly print: 'M7 9V3h10v6 M5 9h14v8h-3 M7 14h10v7H7z';
+    readonly rowAbove: 'M4 10h16v10H4z M4 15h16 M12 3v4 M10 5h4';
+    readonly rowBelow: 'M4 4h16v10H4z M4 9h16 M12 17v4 M10 19h4';
+    readonly deleteRow: 'M4 6h16v9H4z M4 10.5h16 M8 19l8 0';
+    readonly columnLeft: 'M10 4h10v16H10z M15 4v16 M3 12h4 M5 10v4';
+    readonly columnRight: 'M4 4h10v16H4z M9 4v16 M17 12h4 M19 10v4';
+    readonly deleteColumn: 'M6 4h9v16H6z M10.5 4v16 M19 8v8';
+    readonly deleteTable: 'M4 5h16v14H4z M4 10h16 M10 5v14 M14 13l5 5 M19 13l-5 5';
+    readonly margins: 'M5 3h14v18H5z M8 6h8v12H8z';
+    readonly orientation: 'M6 3h9l3 3v15H6z M12 9v6 M9 12h6';
+    readonly columns: 'M4 4h7v16H4z M13 4h7v16h-7z M6 8h3 M6 12h3 M15 8h3 M15 12h3';
+    readonly verticalAlign: 'M5 4h14 M5 20h14 M8 8h8 M8 12h8 M8 16h8';
+    readonly pageNumber: 'M6 3h9l3 3v15H6z M9 17h6 M12 11v4 M10.5 12.5l1.5-1.5';
+    readonly numbering2: 'M6 3h9l3 3v15H6z M9 9h6 M9 13h6 M9 17h3';
+    readonly view: 'M3 12s3.5-6 9-6 9 6 9 6-3.5 6-9 6-9-6-9-6z M12 9.5a2.5 2.5 0 1 0 0 5 2.5 2.5 0 0 0 0-5z';
+    readonly zoom: 'M10 4a6 6 0 1 0 0 12 6 6 0 0 0 0-12z M14.5 14.5 20 20 M7.5 10h5 M10 7.5v5';
+    readonly markup: 'M4 5h16v11H10l-4 4v-4H4z M8 9h8 M8 12h4';
+    readonly changeCase: 'M2 18 7 5l5 13 M4 14h6 M14 18l3.5-8 3.5 8 M15.5 15.5h4';
+    readonly formatPainter: 'M5 4h11v5H5z M16 6.5h3v5h-8v3 M9.5 14.5h3V21h-3z';
+    readonly paragraphMarks: 'M12 4H9a4 4 0 0 0 0 8h3 M12 4v16 M16 4v16';
+    readonly select: 'M6 3l12 9-5.5 1.2L15 19l-2.5 1-2.5-5.8L6 18z';
+    readonly replace: 'M4 7h12l-3-3 M20 17H8l3 3 M10 12a3 3 0 1 0 0 .01';
+    readonly moreStyles: 'M4 5h16 M4 10h16 M4 15h10 M17 16l3 3 3-3';
+    readonly charStyle: 'M4 19 9 5l5 14 M6 14h6 M17 9h4 M19 9v10';
+    readonly wordCount: 'M4 5h16v14H4z M8 15V9l2 4 2-4v6 M16 9v6';
+    readonly spelling: 'M4 15l4-10 4 10 M5.5 12h5 M14 17l2.5 2.5L21 13';
+    readonly symbol: 'M5 19h4v-2a6 6 0 1 1 6 0v2h4';
+    readonly dropCap: 'M4 4h8v8H4z M6.5 10l1.5-4 1.5 4 M14 5h6 M14 8h6 M14 11h6 M4 15h16 M4 18h16 M4 21h11';
+    readonly dateTime: 'M4 5h16v15H4z M4 10h16 M8 3v4 M16 3v4 M12 13v3l2 1';
+    readonly zoom100: 'M10 4a6 6 0 1 0 0 12 6 6 0 0 0 0-12z M14.5 14.5 20 20 M8.5 8.5l1.5-1v5';
+    readonly pageWidth: 'M3 6v12 M21 6v12 M7 12h10 M9 10l-2 2 2 2 M15 10l2 2-2 2';
+    readonly twoPages: 'M3 5h8v14H3z M13 5h8v14h-8z M5.5 9h3 M15.5 9h3 M5.5 12h3 M15.5 12h3';
+    readonly onePage: 'M7 3h10v18H7z M10 8h4 M10 12h4';
+    readonly launcher: 'M14 4h6v6 M20 4l-7 7 M10 6H5v13h13v-5';
+    readonly pageSize: 'M6 3h9l3 3v15H6z M9 11h6 M9 15h6 M4 9v8 M2.5 10.5 4 9l1.5 1.5';
+    readonly header: 'M5 3h14v18H5z M5 8h14 M8 5.5h6';
+    readonly footer: 'M5 3h14v18H5z M5 16h14 M8 18.5h6';
+    readonly pageNumberIcon: 'M5 3h14v18H5z M9 17h6 M12 11v4 M10.5 12.5l1.5-1';
+    readonly shading: 'M5 11l6-6 8 8-6 6z M11 5l-3-2 M19 16c1 1.5 1.5 2.5 1.5 3.3a1.5 1.5 0 0 1-3 0c0-.8.5-1.8 1.5-3.3z';
+    readonly borders: 'M4 4h16v16H4z M4 12h16 M12 4v16';
+    readonly addText: 'M4 5h16 M4 10h10 M4 15h16 M17 12v6 M14 15h6';
+    readonly blankPage: 'M6 3h9l3 3v15H6z';
+    readonly readAloud: 'M4 9v6h4l5 4V5L8 9z M16 9a4 4 0 0 1 0 6 M18.5 6.5a8 8 0 0 1 0 11';
+    readonly gridlines: 'M4 4h16v16H4z M4 9h16 M4 14h16 M9 4v16 M14 4v16';
+    readonly chevronLeft: 'M14 6l-6 6 6 6';
+    readonly chevronRight: 'M10 6l6 6-6 6';
+    readonly stylesMoreArrow: 'M6 9l6 6 6-6 M6 5h12';
+    readonly stylesPane: 'M4 4h16v16H4z M14 4v16 M7 8h4 M7 12h4';
+    readonly sort: 'M6 4v16 M3.5 17.5 6 20l2.5-2.5 M13 6h7 M13 12h5 M13 18h3';
+    readonly bookmark: 'M7 3h10v18l-5-4-5 4z';
+    readonly coverPage: 'M6 3h12v18H6z M9 8h6 M9 11h6 M9 17h6';
+    readonly ruler: 'M3 8h18v8H3z M7 8v3 M11 8v4 M15 8v3 M19 8v4';
+    readonly caption: 'M4 5h16v11H4z M4 19h10 M8 9l2 3 2-3';
+    readonly crossReference: 'M9 15l6-6 M8 8H5a3 3 0 0 0 0 6h3 M16 16h3a3 3 0 0 0 0-6h-3';
+    readonly deleteComment: 'M4 5h16v11H10l-4 4v-4H4z M9 8.5l5 5 M14 8.5l-5 5';
+    readonly watermark: 'M5 18L19 6 M7 8h4 M13 16h4';
+    readonly pageBorders: 'M4 4h16v16H4z M7 7h10v10H7z';
+    readonly textBox: 'M4 5h16v14H4z M8 10h8 M8 14h5';
+    readonly pageColor: 'M6 3h9l3 3v15H6z M9 11h6v6H9z';
+    readonly hyphenation: 'M4 6h16 M4 11h9 M16 11h4 M4 16h16 M13 11h3';
+    readonly caret: 'M7 10l5 5 5-5';
+};
+export type RibbonIcon = keyof typeof paths;
+export declare function isRibbonIcon(name: string): name is RibbonIcon;
+/** An `<svg>` for `name`; `size` is its rendered edge in CSS pixels. */
+export declare function ribbonIcon(name: RibbonIcon, size?: number): SVGSVGElement;
+export {};

package/dist/docx/ribbon-keytips.d.ts

@@ -0,0 +1,11 @@
+import { type KeyTipTarget } from '../controls';
+/**
+ * KeyTips for the visible controls of `panel`: Word's own where this ribbon has the same command,
+ * otherwise two letters from the label (see `assignKeyTips`).
+ */
+export declare function collectKeyTips(panel: HTMLElement): KeyTipTarget[];
+/**
+ * Shows badges over the controls of `panel` and runs the one whose letters are typed. Escape (or a
+ * key with no match) ends it; `onDone` runs after any end. Returns a function that stops it.
+ */
+export declare function showCommandTips(root: HTMLElement, panel: HTMLElement, onDone: () => void): () => void;

package/dist/docx/ribbon-overflow.d.ts

@@ -0,0 +1,3 @@
+export declare const fitPanel: (panel: HTMLElement) => void;
+export declare const attachRibbonOverflow: (root: HTMLElement) => () => void;
+export declare const refitRibbon: (root: HTMLElement) => void;