ooxml-ui 1.11.0 → 1.12.0

package/dist/chunk-GSXOZCAN.js

@@ -0,0 +1,75 @@
+// src/pointer-gesture.ts
+function ownsCaptureLoss(owner, event) {
+  return event.target === owner;
+}
+function trackPointerPan(owner, start, onMove, onEnd) {
+  const left = owner.scrollLeft, top = owner.scrollTop;
+  return trackPointerGesture(owner, start.pointerId, {
+    move: (event) => {
+      if (Math.hypot(start.clientX - event.clientX, start.clientY - event.clientY) < 4) return;
+      owner.scrollLeft = left + start.clientX - event.clientX;
+      owner.scrollTop = top + start.clientY - event.clientY;
+      onMove();
+    },
+    commit: onEnd,
+    cancel: onEnd
+  });
+}
+function trackPointerGesture(owner, pointerId, callbacks) {
+  const win = owner.ownerDocument.defaultView;
+  const Abort = win?.AbortController ?? AbortController;
+  const events = new Abort();
+  const options = { signal: events.signal };
+  let active = true;
+  const finish = (event) => {
+    if (!active) return;
+    active = false;
+    events.abort();
+    if (owner.hasPointerCapture?.(pointerId)) owner.releasePointerCapture(pointerId);
+    if (event) callbacks.commit(event);
+    else callbacks.cancel();
+  };
+  owner.addEventListener(
+    "pointermove",
+    (event) => {
+      if (event.pointerId === pointerId) callbacks.move(event);
+    },
+    options
+  );
+  owner.addEventListener(
+    "pointerup",
+    (event) => {
+      if (event.pointerId === pointerId) finish(event);
+    },
+    options
+  );
+  owner.addEventListener(
+    "pointercancel",
+    (event) => {
+      if (event.pointerId === pointerId) finish();
+    },
+    options
+  );
+  owner.addEventListener(
+    "lostpointercapture",
+    (event) => {
+      if (event.pointerId === pointerId && ownsCaptureLoss(owner, event)) finish();
+    },
+    options
+  );
+  owner.ownerDocument.addEventListener(
+    "keydown",
+    (event) => {
+      if (event.key === "Escape") {
+        event.preventDefault();
+        finish();
+      }
+    },
+    options
+  );
+  win?.addEventListener("blur", () => finish(), options);
+  owner.setPointerCapture?.(pointerId);
+  return () => finish();
+}
+
+export { ownsCaptureLoss, trackPointerGesture, trackPointerPan };

package/dist/{chunk-QVPO35YI.js → chunk-N3BQ3IIJ.js}

@@ -1,5 +1,5 @@
 import { defineSmartArt } from './chunk-PXIYHFZ5.js';
-import { TEAMS_TAGS, registerTeams } from './chunk-JZP5L2AZ.js';
+import { TEAMS_TAGS, registerTeams } from './chunk-B7NCMLSK.js';
 import { installOfficeUiTheme } from './chunk-S6ZXU442.js';
 import { registerControls } from './chunk-FUQYUUIQ.js';
 import { definePresence } from './chunk-L7JV5FVE.js';

package/dist/docx/context-menu-actions.d.ts

@@ -7,4 +7,4 @@ export declare function copyOrCut(view: EditorView, op: 'cut' | 'copy'): Promise
 /** Whether the browser will let us read the clipboard; `true` when it cannot say. */
 export declare function clipboardReadAllowed(): Promise<boolean>;
 /** Uses ProseMirror's HTML parser for formatted content, with a plain-text API fallback. */
-export declare function pasteClipboard(view: EditorView): Promise<boolean>;
+export declare function pasteClipboard(view: EditorView, plainText?: boolean): Promise<boolean>;

package/dist/docx/decoration-cache.d.ts

@@ -0,0 +1,16 @@
+import type { Node } from 'prosemirror-model';
+import type { DecorationSet } from 'prosemirror-view';
+/** Selection transactions retain the document and all formatting inputs. */
+export declare class DecorationCache {
+    private doc;
+    private inputs;
+    private value;
+    get(doc: Node, inputs: readonly unknown[]): DecorationSet | undefined;
+    set(doc: Node, inputs: readonly unknown[], value: DecorationSet): DecorationSet;
+    clear(): void;
+}
+/** ProseMirror retains attribute objects across text-only edits. */
+export declare class AttributeCache<T> {
+    private entries;
+    resolve(attributes: object, inputs: readonly unknown[], create: () => T): T;
+}

package/dist/docx/editor-core.d.ts

@@ -70,6 +70,7 @@ export declare class EditorCore {
     readonly viewOptions: ViewOptions;
     readonly dirtyState: DirtyState;
     readonly pageTracker: PageTracker;
+    private wordText;
     constructor(element: HTMLElement);
     contentWidth(): number;
     canEditBody(): boolean;
@@ -81,4 +82,6 @@ export declare class EditorCore {
     pendingCollaboration(): import("ooxml-core/docx/ui").StepBatch | null;
     applyTransaction(transaction: Transaction, remote?: boolean): void;
     refreshControls(): void;
+    /** Scrolling only changes page state, never formatting controls or document statistics. */
+    refreshPageStatus(): void;
 }

package/dist/docx/locales/en-ribbon.d.ts

@@ -210,6 +210,10 @@ export declare const enRibbon: {
     readonly 'Capitalize Each Word': 'Capitalize Each Word';
     readonly 'tOGGLE cASE': 'tOGGLE cASE';
     readonly Paste: 'Paste';
+    readonly 'Paste options': 'Paste options';
+    readonly 'Keep text only': 'Keep text only';
+    readonly 'Bullets options': 'Bullets options';
+    readonly 'Numbering options': 'Numbering options';
     readonly Cut: 'Cut';
     readonly Copy: 'Copy';
     readonly 'Grow font': 'Grow font';
@@ -395,4 +399,34 @@ export declare const enRibbon: {
     readonly 'dyn.exact': 'Exact {n} pt';
     readonly 'dyn.atLeast': 'At least {n} pt';
     readonly 'Enter a BCP 47 language tag, such as en-US or ar-SA.': 'Enter a BCP 47 language tag, such as en-US or ar-SA.';
+    readonly 'tab.design': 'Design';
+    readonly 'tab.mailings': 'Mailings';
+    readonly 'tab.help': 'Help';
+    readonly 'Document Formatting': 'Document Formatting';
+    readonly Themes: 'Themes';
+    readonly Colors: 'Colors';
+    readonly Fonts: 'Fonts';
+    readonly 'Paragraph spacing': 'Paragraph spacing';
+    readonly 'Set as Default': 'Set as Default';
+    readonly Create: 'Create';
+    readonly Envelopes: 'Envelopes';
+    readonly Labels: 'Labels';
+    readonly 'Start Mail Merge': 'Start Mail Merge';
+    readonly 'Select Recipients': 'Select Recipients';
+    readonly 'Edit Recipient List': 'Edit Recipient List';
+    readonly 'Write & Insert Fields': 'Write & Insert Fields';
+    readonly 'Highlight Merge Fields': 'Highlight Merge Fields';
+    readonly 'Address Block': 'Address Block';
+    readonly 'Greeting Line': 'Greeting Line';
+    readonly 'Insert Merge Field': 'Insert Merge Field';
+    readonly Rules: 'Rules';
+    readonly 'Match Fields': 'Match Fields';
+    readonly 'Update Labels': 'Update Labels';
+    readonly 'Preview Results': 'Preview Results';
+    readonly 'Find Recipient': 'Find Recipient';
+    readonly 'Check for Errors': 'Check for Errors';
+    readonly Finish: 'Finish';
+    readonly 'Finish & Merge': 'Finish & Merge';
+    readonly Help: 'Help';
+    readonly 'Not available in this editor': 'Not available in this editor';
 };

package/dist/docx/locales/en.d.ts

@@ -512,6 +512,10 @@ export declare const en: {
     readonly 'Capitalize Each Word': 'Capitalize Each Word';
     readonly 'tOGGLE cASE': 'tOGGLE cASE';
     readonly Paste: 'Paste';
+    readonly 'Paste options': 'Paste options';
+    readonly 'Keep text only': 'Keep text only';
+    readonly 'Bullets options': 'Bullets options';
+    readonly 'Numbering options': 'Numbering options';
     readonly Cut: 'Cut';
     readonly Copy: 'Copy';
     readonly 'Grow font': 'Grow font';
@@ -695,6 +699,36 @@ export declare const en: {
     readonly 'dyn.exact': 'Exact {n} pt';
     readonly 'dyn.atLeast': 'At least {n} pt';
     readonly 'Enter a BCP 47 language tag, such as en-US or ar-SA.': 'Enter a BCP 47 language tag, such as en-US or ar-SA.';
+    readonly 'tab.design': 'Design';
+    readonly 'tab.mailings': 'Mailings';
+    readonly 'tab.help': 'Help';
+    readonly 'Document Formatting': 'Document Formatting';
+    readonly Themes: 'Themes';
+    readonly Colors: 'Colors';
+    readonly Fonts: 'Fonts';
+    readonly 'Paragraph spacing': 'Paragraph spacing';
+    readonly 'Set as Default': 'Set as Default';
+    readonly Create: 'Create';
+    readonly Envelopes: 'Envelopes';
+    readonly Labels: 'Labels';
+    readonly 'Start Mail Merge': 'Start Mail Merge';
+    readonly 'Select Recipients': 'Select Recipients';
+    readonly 'Edit Recipient List': 'Edit Recipient List';
+    readonly 'Write & Insert Fields': 'Write & Insert Fields';
+    readonly 'Highlight Merge Fields': 'Highlight Merge Fields';
+    readonly 'Address Block': 'Address Block';
+    readonly 'Greeting Line': 'Greeting Line';
+    readonly 'Insert Merge Field': 'Insert Merge Field';
+    readonly Rules: 'Rules';
+    readonly 'Match Fields': 'Match Fields';
+    readonly 'Update Labels': 'Update Labels';
+    readonly 'Preview Results': 'Preview Results';
+    readonly 'Find Recipient': 'Find Recipient';
+    readonly 'Check for Errors': 'Check for Errors';
+    readonly Finish: 'Finish';
+    readonly 'Finish & Merge': 'Finish & Merge';
+    readonly Help: 'Help';
+    readonly 'Not available in this editor': 'Not available in this editor';
     readonly "(No style)": string;
     readonly "Add tab stop at (inches)": string;
     readonly "Aligned at (inches)": string;

package/dist/docx/localization-strings.d.ts

@@ -509,6 +509,10 @@ export declare const strings: {
         readonly 'Capitalize Each Word': 'Capitalize Each Word';
         readonly 'tOGGLE cASE': 'tOGGLE cASE';
         readonly Paste: 'Paste';
+        readonly 'Paste options': 'Paste options';
+        readonly 'Keep text only': 'Keep text only';
+        readonly 'Bullets options': 'Bullets options';
+        readonly 'Numbering options': 'Numbering options';
         readonly Cut: 'Cut';
         readonly Copy: 'Copy';
         readonly 'Grow font': 'Grow font';
@@ -692,6 +696,36 @@ export declare const strings: {
         readonly 'dyn.exact': 'Exact {n} pt';
         readonly 'dyn.atLeast': 'At least {n} pt';
         readonly 'Enter a BCP 47 language tag, such as en-US or ar-SA.': 'Enter a BCP 47 language tag, such as en-US or ar-SA.';
+        readonly 'tab.design': 'Design';
+        readonly 'tab.mailings': 'Mailings';
+        readonly 'tab.help': 'Help';
+        readonly 'Document Formatting': 'Document Formatting';
+        readonly Themes: 'Themes';
+        readonly Colors: 'Colors';
+        readonly Fonts: 'Fonts';
+        readonly 'Paragraph spacing': 'Paragraph spacing';
+        readonly 'Set as Default': 'Set as Default';
+        readonly Create: 'Create';
+        readonly Envelopes: 'Envelopes';
+        readonly Labels: 'Labels';
+        readonly 'Start Mail Merge': 'Start Mail Merge';
+        readonly 'Select Recipients': 'Select Recipients';
+        readonly 'Edit Recipient List': 'Edit Recipient List';
+        readonly 'Write & Insert Fields': 'Write & Insert Fields';
+        readonly 'Highlight Merge Fields': 'Highlight Merge Fields';
+        readonly 'Address Block': 'Address Block';
+        readonly 'Greeting Line': 'Greeting Line';
+        readonly 'Insert Merge Field': 'Insert Merge Field';
+        readonly Rules: 'Rules';
+        readonly 'Match Fields': 'Match Fields';
+        readonly 'Update Labels': 'Update Labels';
+        readonly 'Preview Results': 'Preview Results';
+        readonly 'Find Recipient': 'Find Recipient';
+        readonly 'Check for Errors': 'Check for Errors';
+        readonly Finish: 'Finish';
+        readonly 'Finish & Merge': 'Finish & Merge';
+        readonly Help: 'Help';
+        readonly 'Not available in this editor': 'Not available in this editor';
         readonly "(No style)": string;
         readonly "Add tab stop at (inches)": string;
         readonly "Aligned at (inches)": string;

package/dist/docx/model-adapter.d.ts

@@ -2,5 +2,5 @@ import { EditorState, Transaction } from 'prosemirror-state';
 import type { DocumentModel } from 'ooxml-core/docx';
 import type { Node as ProseMirrorNode } from 'prosemirror-model';
 export declare function modelToDoc(model: DocumentModel): ProseMirrorNode;
-export declare function docToModel(doc: ReturnType<typeof modelToDoc>, prior: DocumentModel): DocumentModel;
+export declare function docToModel(doc: ReturnType<typeof modelToDoc>, prior: DocumentModel, previousDoc?: ProseMirrorNode): DocumentModel;
 export declare function assignMissingParagraphIds(state: EditorState): Transaction | null;

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

@@ -61,7 +61,7 @@ export declare class PageController {
     setZoom(percent: number, sideBySide?: boolean): void;
     /** Switches between continuous and paginated presentations of the existing editor. */
     setViewMode(mode: 'draft' | 'print'): void;
-    /** Re-lays out Print Layout after a model change (debounced by the layout view). */
+    /** Re-lays out Print Layout after a model change (coalesced by the layout view). */
     relayout(): void;
     print(): void;
 }

package/dist/docx/page-navigator.d.ts

@@ -3,6 +3,7 @@ import { type EditorLocale } from './localization.js';
 export interface PageNavigatorHost {
     /** Laid-out page sheets in order; empty until a layout exists. */
     pages(): HTMLElement[];
+    pageSnapshot?(index: number): HTMLElement | undefined;
     /** Changes whenever the layout was rebuilt. */
     version(): number;
     goTo(page: number): void;

package/dist/docx/paragraph-decoration-cache.d.ts

@@ -0,0 +1,28 @@
+import type { Node } from 'prosemirror-model';
+import { Decoration } from 'prosemirror-view';
+type Attributes = Parameters<typeof Decoration.inline>[2];
+interface Descriptor {
+    from: number;
+    to: number;
+    attrs: Attributes;
+    spec: object | undefined;
+    kind: 'inline' | 'node';
+}
+interface Entry {
+    inputs: readonly unknown[];
+    descriptors: Descriptor[];
+    hasScale: boolean;
+}
+/** Store paragraph-local descriptors without mapping a separate tree through the whole document. */
+export declare class ParagraphDecorationBuilder {
+    readonly descriptors: Descriptor[];
+    inline(from: number, to: number, attrs: Attributes, spec?: object): Decoration;
+    node(from: number, to: number, attrs: Attributes, spec?: object): Decoration;
+}
+export declare class ParagraphDecorationCache {
+    private entries;
+    get(node: Node, inputs: readonly unknown[]): Entry | undefined;
+    set(node: Node, inputs: readonly unknown[], builder: ParagraphDecorationBuilder, hasScale: boolean): Entry;
+    place(value: Entry, start: number): Decoration[];
+}
+export {};

package/dist/docx/print-block-pages.d.ts

@@ -0,0 +1,3 @@
+import type { LayoutResult } from 'ooxml-core/docx/layout';
+/** Source ranges locate the caret's page without requiring offscreen DOM. */
+export declare function printBlockPages(result: LayoutResult): (id: string, offset: number) => number | undefined;

package/dist/docx/print-editing-index.d.ts

@@ -9,6 +9,7 @@ export declare class PrintEditingIndex {
     private readonly pages;
     private doc;
     private root;
+    private renderVersion;
     private paragraphs;
     private positions;
     private byBlock;

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

@@ -9,4 +9,4 @@ export interface PrintEditingBridge {
 export declare function createPrintEditingBridge(pages: HTMLElement, paper: HTMLElement, getView: () => EditorView | undefined, resolveHit: (target: Element, clientX: number) => {
     blockId: string;
     offset: number;
-} | null, scrollContainer?: HTMLElement): PrintEditingBridge;
+} | null, scrollContainer?: HTMLElement, ensureBlock?: (id: string, offset: number) => void): PrintEditingBridge;

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

@@ -20,6 +20,8 @@ export interface PrintLayoutController {
     } | null;
     /** The laid-out page sheets currently in the DOM, in order. */
     pageElements(): HTMLElement[];
+    pageSnapshot(index: number): HTMLElement | undefined;
+    ensureBlock(id: string, offset: number): void;
     /** 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. */

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

@@ -8,6 +8,9 @@ export interface PrintLayoutHandle {
     /** The scrollable element holding one sheet per page; mount this in the DOM. */
     element: HTMLElement;
     pageCount: number;
+    showPages(center: number, pinned?: number): void;
+    renderAll(): void;
+    pageSnapshot(index: number): HTMLElement | undefined;
     /**
      * Best-effort click-to-cursor mapping: given the line element under a
      * click and its horizontal offset, measures the displayed text fragments
@@ -21,6 +24,8 @@ export interface PrintLayoutHandle {
     } | null;
 }
 export interface PrintLayoutOptions {
+    virtual?: boolean;
+    onPageRender?: (sheet: HTMLElement, index: number) => void;
     /** 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. */

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

@@ -0,0 +1,16 @@
+/** Fixed-size page shells keep scroll geometry stable while only nearby content is mounted. */
+export declare class PrintPageWindow {
+    private readonly root;
+    private readonly virtual;
+    private pages;
+    private mounted;
+    private revision;
+    constructor(root: HTMLElement, virtual: boolean);
+    add(sheet: HTMLElement, draw: () => () => void): void;
+    mount(index: number): void;
+    private unmount;
+    private changed;
+    show(center: number, pinned?: number): void;
+    all(): void;
+    snapshot(index: number): HTMLElement | undefined;
+}

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

@@ -3,6 +3,8 @@ import type { MultilingualAction } from './multilingual-ribbon.js';
 import type { ReviewDisplayMode } from './review-display.js';
 /** Every command the ribbon can raise, dispatched as a `ribbon-action` event. */
 export type RibbonAction = {
+    type: 'help';
+} | {
     type: 'format';
     key: 'bold' | 'italic' | 'underline' | 'strike' | 'superscript' | 'subscript';
 } | {
@@ -26,6 +28,10 @@ export type RibbonAction = {
 } | {
     type: 'clipboard';
     key: 'cut' | 'copy' | 'paste';
+    plainText?: boolean;
+} | {
+    type: 'underline';
+    value: import('./font-format.js').UnderlineKind;
 } | {
     type: 'fontStep';
     direction: 'grow' | 'shrink';

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

@@ -0,0 +1,3 @@
+export declare function pasteSplit(): HTMLElement;
+export declare function underlineSplit(): HTMLElement;
+export declare function listSplit(key: 'bullet' | 'number'): HTMLElement;

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

@@ -1,5 +1,8 @@
 /** Line icons for ribbon buttons on a 24x24 grid, drawn with `currentColor` so themes apply. */
 declare const paths: {
+    readonly envelope: 'M3 5h18v14H3z M3 5l9 7 9-7';
+    readonly field: 'M4 3h16v18H4z M10 8l-3 4 3 4 M14 8l3 4-3 4';
+    readonly help: 'M9 8a3 3 0 1 1 4 2.8c-1 .5-1 1.2-1 2.2 M12 17h.01 M12 2a10 10 0 1 0 0 20 10 10 0 0 0 0-20';
     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';

package/dist/docx/ribbon-native-tabs.d.ts

@@ -0,0 +1,2 @@
+/** Office's tabs and groups, with unsupported operations explicitly disabled. */
+export declare function buildNativeTabs(panels: Map<string, HTMLElement>): void;

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

@@ -1,7 +1,7 @@
 import type { RibbonAction } from './ribbon-action.js';
 import { type RibbonIcon } from './ribbon-icons.js';
 /** Building blocks for ribbon tabs: buttons, selects, labelled groups and rows. */
-export declare const button: (label: string, text: string, action: RibbonAction, className?: string) => HTMLButtonElement;
+export declare const button: (label: string, text: string, action: RibbonAction | null, className?: string) => HTMLButtonElement;
 export declare const select: (label: string, values: Array<[string, string]>, action: (value: string) => RibbonAction) => HTMLSelectElement;
 /**
  * Word's dropdown command: an icon over a caption with a caret. The real `<select>` stays in the
@@ -34,7 +34,7 @@ export declare const launcher: (label: string, action: RibbonAction) => HTMLButt
 export declare const group: (label: string, ...children: HTMLElement[]) => HTMLDivElement;
 export declare const row: (...children: HTMLElement[]) => HTMLDivElement;
 /** An icon button. `large` stacks a caption under a 28px icon, as Word's big commands do. */
-export declare const tool: (label: string, icon: RibbonIcon, action: RibbonAction, options?: {
+export declare const tool: (label: string, icon: RibbonIcon, action: RibbonAction | null, options?: {
     large?: boolean;
     inline?: boolean;
     caption?: string;