ooxml-ui 1.13.0 → 1.14.0

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

@@ -0,0 +1,101 @@
+/** Insert > Shapes, the Shape Format tab and the shape dialogs. Keys are the English UI text. */
+export declare const enShapes: {
+    readonly 'tab.shape-format': 'Shape Format';
+    readonly Shapes: 'Shapes';
+    readonly Lines: 'Lines';
+    readonly Rectangles: 'Rectangles';
+    readonly 'Basic Shapes': 'Basic Shapes';
+    readonly 'Block Arrows': 'Block Arrows';
+    readonly Flowchart: 'Flowchart';
+    readonly Callouts: 'Callouts';
+    readonly 'Stars and Banners': 'Stars and Banners';
+    readonly Line: 'Line';
+    readonly 'Straight Connector': 'Straight Connector';
+    readonly 'Elbow Connector': 'Elbow Connector';
+    readonly 'Curved Connector': 'Curved Connector';
+    readonly Rectangle: 'Rectangle';
+    readonly 'Rounded Rectangle': 'Rounded Rectangle';
+    readonly 'Snip Single Corner': 'Snip Single Corner';
+    readonly 'Round Same-Side Corners': 'Round Same-Side Corners';
+    readonly Oval: 'Oval';
+    readonly Triangle: 'Triangle';
+    readonly 'Right Triangle': 'Right Triangle';
+    readonly Parallelogram: 'Parallelogram';
+    readonly Trapezoid: 'Trapezoid';
+    readonly Diamond: 'Diamond';
+    readonly Pentagon: 'Pentagon';
+    readonly Hexagon: 'Hexagon';
+    readonly Octagon: 'Octagon';
+    readonly Cross: 'Cross';
+    readonly Heart: 'Heart';
+    readonly 'Smiley Face': 'Smiley Face';
+    readonly Sun: 'Sun';
+    readonly Moon: 'Moon';
+    readonly 'Lightning Bolt': 'Lightning Bolt';
+    readonly Cylinder: 'Cylinder';
+    readonly Cube: 'Cube';
+    readonly 'Right Arrow': 'Right Arrow';
+    readonly 'Left Arrow': 'Left Arrow';
+    readonly 'Up Arrow': 'Up Arrow';
+    readonly 'Down Arrow': 'Down Arrow';
+    readonly 'Left-Right Arrow': 'Left-Right Arrow';
+    readonly 'Up-Down Arrow': 'Up-Down Arrow';
+    readonly 'Bent Arrow': 'Bent Arrow';
+    readonly 'U-Turn Arrow': 'U-Turn Arrow';
+    readonly Chevron: 'Chevron';
+    readonly 'Pentagon Arrow': 'Pentagon Arrow';
+    readonly 'Flowchart: Process': 'Flowchart: Process';
+    readonly 'Flowchart: Alternate Process': 'Flowchart: Alternate Process';
+    readonly 'Flowchart: Decision': 'Flowchart: Decision';
+    readonly 'Flowchart: Data': 'Flowchart: Data';
+    readonly 'Flowchart: Predefined Process': 'Flowchart: Predefined Process';
+    readonly 'Flowchart: Document': 'Flowchart: Document';
+    readonly 'Flowchart: Terminator': 'Flowchart: Terminator';
+    readonly 'Flowchart: Connector': 'Flowchart: Connector';
+    readonly 'Flowchart: Preparation': 'Flowchart: Preparation';
+    readonly 'Speech Bubble: Rectangle': 'Speech Bubble: Rectangle';
+    readonly 'Speech Bubble: Rectangle with Corners Rounded': 'Speech Bubble: Rectangle with Corners Rounded';
+    readonly 'Speech Bubble: Oval': 'Speech Bubble: Oval';
+    readonly 'Thought Bubble: Cloud': 'Thought Bubble: Cloud';
+    readonly 'Callout: Line': 'Callout: Line';
+    readonly 'Star: 4 Points': 'Star: 4 Points';
+    readonly 'Star: 5 Points': 'Star: 5 Points';
+    readonly 'Star: 6 Points': 'Star: 6 Points';
+    readonly 'Star: 8 Points': 'Star: 8 Points';
+    readonly 'Shape Styles': 'Shape Styles';
+    readonly 'Shape fill': 'Shape fill';
+    readonly 'Shape outline': 'Shape outline';
+    readonly 'Shape outline weight': 'Shape outline weight';
+    readonly 'No Fill': 'No Fill';
+    readonly 'No Outline': 'No Outline';
+    readonly 'Add Text': 'Add Text';
+    readonly Arrange: 'Arrange';
+    readonly 'Wrap text': 'Wrap text';
+    readonly 'In Line with Text': 'In Line with Text';
+    readonly Square: 'Square';
+    readonly Tight: 'Tight';
+    readonly Through: 'Through';
+    readonly 'Top and Bottom': 'Top and Bottom';
+    readonly 'Behind Text': 'Behind Text';
+    readonly 'In Front of Text': 'In Front of Text';
+    readonly 'Shape height (inches)': 'Shape height (inches)';
+    readonly 'Shape width (inches)': 'Shape width (inches)';
+    readonly '0.25 pt': '0.25 pt';
+    readonly '0.5 pt': '0.5 pt';
+    readonly '0.75 pt': '0.75 pt';
+    readonly '1 pt': '1 pt';
+    readonly '1.5 pt': '1.5 pt';
+    readonly '2.25 pt': '2.25 pt';
+    readonly '3 pt': '3 pt';
+    readonly '4.5 pt': '4.5 pt';
+    readonly '6 pt': '6 pt';
+    readonly 'Select a shape first.': 'Select a shape first.';
+    readonly 'This shape has formatted text that the editor cannot change.': 'This shape has formatted text that the editor cannot change.';
+};
+type Keys = keyof typeof enShapes;
+export type ShapeStrings = Record<Keys, string>;
+export declare const frShapes: ShapeStrings;
+export declare const deShapes: ShapeStrings;
+export declare const esShapes: ShapeStrings;
+export declare const zhShapes: ShapeStrings;
+export {};

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

@@ -43,6 +43,124 @@ export declare const strings: {
         readonly 'Suppress for Current Paragraph': 'Suppress for Current Paragraph';
         readonly 'Line Numbering Options\u2026': 'Line Numbering Options…';
         readonly 'Enter whole numbers from 1 to 32767 and a distance from 0 to 22 inches.': 'Enter whole numbers from 1 to 32767 and a distance from 0 to 22 inches.';
+        readonly 'Content control': 'Content control';
+        readonly 'Rich text': 'Rich text';
+        readonly 'Plain text': 'Plain text';
+        readonly 'Check box': 'Check box';
+        readonly 'Drop-down list': 'Drop-down list';
+        readonly 'Combo box': 'Combo box';
+        readonly 'Date picker': 'Date picker';
+        readonly 'Properties\u2026': 'Properties…';
+        readonly 'Content control properties': 'Content control properties';
+        readonly Tag: 'Tag';
+        readonly 'Content control cannot be deleted': 'Content control cannot be deleted';
+        readonly 'Contents cannot be edited': 'Contents cannot be edited';
+        readonly 'Drop-down list entries (one per line)': 'Drop-down list entries (one per line)';
+        readonly 'Date display format': 'Date display format';
+        readonly 'Select a content control to edit its properties.': 'Select a content control to edit its properties.';
+        readonly 'Previous month': 'Previous month';
+        readonly 'Next month': 'Next month';
+        readonly Today: 'Today';
+        readonly 'Insert or Edit Equation\u2026': 'Insert or Edit Equation…';
+        readonly 'Area of Circle': 'Area of Circle';
+        readonly 'Quadratic Formula': 'Quadratic Formula';
+        readonly 'Pythagorean Theorem': 'Pythagorean Theorem';
+        readonly 'Binomial Theorem': 'Binomial Theorem';
+        readonly 'LaTeX equation': 'LaTeX equation';
+        readonly 'Display equation on its own line': 'Display equation on its own line';
+        readonly 'Type a LaTeX equation to see a preview.': 'Type a LaTeX equation to see a preview.';
+        readonly 'This LaTeX could not be converted to an equation.': 'This LaTeX could not be converted to an equation.';
+        readonly 'tab.shape-format': 'Shape Format';
+        readonly Shapes: 'Shapes';
+        readonly Lines: 'Lines';
+        readonly Rectangles: 'Rectangles';
+        readonly 'Basic Shapes': 'Basic Shapes';
+        readonly 'Block Arrows': 'Block Arrows';
+        readonly Flowchart: 'Flowchart';
+        readonly Callouts: 'Callouts';
+        readonly 'Stars and Banners': 'Stars and Banners';
+        readonly Line: 'Line';
+        readonly 'Straight Connector': 'Straight Connector';
+        readonly 'Elbow Connector': 'Elbow Connector';
+        readonly 'Curved Connector': 'Curved Connector';
+        readonly Rectangle: 'Rectangle';
+        readonly 'Rounded Rectangle': 'Rounded Rectangle';
+        readonly 'Snip Single Corner': 'Snip Single Corner';
+        readonly 'Round Same-Side Corners': 'Round Same-Side Corners';
+        readonly Oval: 'Oval';
+        readonly Triangle: 'Triangle';
+        readonly 'Right Triangle': 'Right Triangle';
+        readonly Parallelogram: 'Parallelogram';
+        readonly Trapezoid: 'Trapezoid';
+        readonly Diamond: 'Diamond';
+        readonly Pentagon: 'Pentagon';
+        readonly Hexagon: 'Hexagon';
+        readonly Octagon: 'Octagon';
+        readonly Cross: 'Cross';
+        readonly Heart: 'Heart';
+        readonly 'Smiley Face': 'Smiley Face';
+        readonly Sun: 'Sun';
+        readonly Moon: 'Moon';
+        readonly 'Lightning Bolt': 'Lightning Bolt';
+        readonly Cylinder: 'Cylinder';
+        readonly Cube: 'Cube';
+        readonly 'Right Arrow': 'Right Arrow';
+        readonly 'Left Arrow': 'Left Arrow';
+        readonly 'Up Arrow': 'Up Arrow';
+        readonly 'Down Arrow': 'Down Arrow';
+        readonly 'Left-Right Arrow': 'Left-Right Arrow';
+        readonly 'Up-Down Arrow': 'Up-Down Arrow';
+        readonly 'Bent Arrow': 'Bent Arrow';
+        readonly 'U-Turn Arrow': 'U-Turn Arrow';
+        readonly Chevron: 'Chevron';
+        readonly 'Pentagon Arrow': 'Pentagon Arrow';
+        readonly 'Flowchart: Process': 'Flowchart: Process';
+        readonly 'Flowchart: Alternate Process': 'Flowchart: Alternate Process';
+        readonly 'Flowchart: Decision': 'Flowchart: Decision';
+        readonly 'Flowchart: Data': 'Flowchart: Data';
+        readonly 'Flowchart: Predefined Process': 'Flowchart: Predefined Process';
+        readonly 'Flowchart: Document': 'Flowchart: Document';
+        readonly 'Flowchart: Terminator': 'Flowchart: Terminator';
+        readonly 'Flowchart: Connector': 'Flowchart: Connector';
+        readonly 'Flowchart: Preparation': 'Flowchart: Preparation';
+        readonly 'Speech Bubble: Rectangle': 'Speech Bubble: Rectangle';
+        readonly 'Speech Bubble: Rectangle with Corners Rounded': 'Speech Bubble: Rectangle with Corners Rounded';
+        readonly 'Speech Bubble: Oval': 'Speech Bubble: Oval';
+        readonly 'Thought Bubble: Cloud': 'Thought Bubble: Cloud';
+        readonly 'Callout: Line': 'Callout: Line';
+        readonly 'Star: 4 Points': 'Star: 4 Points';
+        readonly 'Star: 5 Points': 'Star: 5 Points';
+        readonly 'Star: 6 Points': 'Star: 6 Points';
+        readonly 'Star: 8 Points': 'Star: 8 Points';
+        readonly 'Shape Styles': 'Shape Styles';
+        readonly 'Shape fill': 'Shape fill';
+        readonly 'Shape outline': 'Shape outline';
+        readonly 'Shape outline weight': 'Shape outline weight';
+        readonly 'No Fill': 'No Fill';
+        readonly 'No Outline': 'No Outline';
+        readonly 'Add Text': 'Add Text';
+        readonly Arrange: 'Arrange';
+        readonly 'Wrap text': 'Wrap text';
+        readonly 'In Line with Text': 'In Line with Text';
+        readonly Square: 'Square';
+        readonly Tight: 'Tight';
+        readonly Through: 'Through';
+        readonly 'Top and Bottom': 'Top and Bottom';
+        readonly 'Behind Text': 'Behind Text';
+        readonly 'In Front of Text': 'In Front of Text';
+        readonly 'Shape height (inches)': 'Shape height (inches)';
+        readonly 'Shape width (inches)': 'Shape width (inches)';
+        readonly '0.25 pt': '0.25 pt';
+        readonly '0.5 pt': '0.5 pt';
+        readonly '0.75 pt': '0.75 pt';
+        readonly '1 pt': '1 pt';
+        readonly '1.5 pt': '1.5 pt';
+        readonly '2.25 pt': '2.25 pt';
+        readonly '3 pt': '3 pt';
+        readonly '4.5 pt': '4.5 pt';
+        readonly '6 pt': '6 pt';
+        readonly 'Select a shape first.': 'Select a shape first.';
+        readonly 'This shape has formatted text that the editor cannot change.': 'This shape has formatted text that the editor cannot change.';
         readonly File: 'File';
         readonly Alignment: 'Alignment';
         readonly 'Quick access': 'Quick access';

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

@@ -1,4 +1,4 @@
-import type { Block, Note } from 'ooxml-core/docx';
+import type { Block, Note, TextRun } from 'ooxml-core/docx';
 import { type InlineEditorOptions } from './header-footer-editor.js';
 import type { NoteKind } from './note-commands.js';
 export interface NoteEditingOptions {
@@ -7,5 +7,11 @@ export interface NoteEditingOptions {
     change(kind: NoteKind, id: string, blocks: Block[]): void;
     editable(): boolean;
 }
+/** Splits off the note's automatic number mark so it can't be edited away. */
+export declare function withoutMark(blocks: Block[]): {
+    editable: Block[];
+    mark?: TextRun;
+};
+export declare function withMark(blocks: Block[], mark: TextRun | undefined): Block[];
 /** Double-click a footnote or endnote to edit its text in place. */
 export declare function attachNoteEditing(root: HTMLElement, options: NoteEditingOptions): void;

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

@@ -1,4 +1,4 @@
-import type { ReviewDisplayMode } from 'ooxml-core/docx';
+import type { Block, ReviewDisplayMode } from 'ooxml-core/docx';
 import { type Plugin } from 'prosemirror-state';
 import type { EditorView } from 'prosemirror-view';
 import type { EditorHost } from './editor-host.js';
@@ -36,6 +36,32 @@ export declare class PartsController {
     /** Page-number insertion follows the first/even/default story currently being edited. */
     activeHeaderFooterSlot(): HeaderFooterSlotName | undefined;
     headerFooterContext(): HeaderFooterContext | undefined;
+    /**
+     * Edits a header or footer in place on a Print Layout page: `container` is that page's element.
+     * The ribbon then targets it (Header & Footer tab) until it closes, which calls `closed`.
+     */
+    editOnPage(story: {
+        container: HTMLElement;
+        kind: 'headers' | 'footers';
+        slot: HeaderFooterSlotName;
+        sectionIndex: number;
+        blocks: Block[];
+        closed(): void;
+    }): boolean;
+    /**
+     * Edits a footnote or endnote in place on a Print Layout page: `container` is the element the
+     * note is drawn in. The ribbon targets the note until it closes (Escape, or focus leaving), which
+     * calls `closed`. `opened` receives the editor so the caller can place the caret.
+     */
+    editNoteOnPage(story: {
+        container: HTMLElement;
+        kind: NoteKind;
+        id: string;
+        opened?(view: EditorView): void;
+        closed(): void;
+    }): boolean;
+    /** Closes the open header, footer or note editor, leaving the body focused. */
+    closeOpenStory(): void;
     closeHeaderFooter(canvas?: HTMLElement, paper?: HTMLElement): void;
     navigate(target: 'header' | 'footer' | 'previous' | 'next', canvas?: HTMLElement, paper?: HTMLElement): void;
     toggleLink(): void;

package/dist/docx/print-caret-affinity.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Which side of a boundary the caret sits on when one text offset belongs to two rendered lines
+ * (the end of a wrapped line and the start of the next, across a column or a page). Upstream is the
+ * end of the earlier line; downstream is the start of the later one.
+ */
+export type CaretAffinity = 'upstream' | 'downstream';
+/** Lines of a block whose source range holds the offset, in reading order. */
+export declare function candidateLines(block: readonly HTMLElement[], offset: number): HTMLElement[];
+/** Pick the line a caret at `offset` is drawn on. */
+export declare function lineForCaret(block: readonly HTMLElement[], offset: number, affinity: CaretAffinity): HTMLElement | undefined;
+/**
+ * Affinity a caret placed at `offset` on `line` has: upstream when the offset is the line's end and
+ * a later line of the same block starts there, downstream otherwise.
+ */
+export declare function affinityOnLine(line: HTMLElement, offset: number, block: readonly HTMLElement[]): CaretAffinity;

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

@@ -24,6 +24,7 @@ export declare class PrintEditingIndex {
     between(from: number, to: number): Iterable<PrintParagraphPosition>;
     at(pos: number): PrintParagraphPosition | undefined;
     block(id: string): readonly HTMLElement[];
+    has(line: HTMLElement): boolean;
     adjacent(line: HTMLElement, direction: number): HTMLElement;
     pageStep(line: HTMLElement, direction: number): HTMLElement;
     nearest(x: number, y: number): HTMLElement | undefined;

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

@@ -1,9 +1,10 @@
+import { type CaretAffinity } from './print-caret-affinity.js';
 import type { EditorView } from 'prosemirror-view';
 export interface PrintEditingBridge {
     setActive(active: boolean): void;
     refresh(): void;
     destroy(): void;
-    select(blockId: string, offset: number, extend?: boolean): boolean;
+    select(blockId: string, offset: number, extend?: boolean, affinity?: CaretAffinity): boolean;
     /** Place the caret on the line nearest a viewport point (the gutter beside the pages). */
     selectNearest(clientX: number, clientY: number): boolean;
 }

package/dist/docx/print-float-geometry.d.ts

@@ -0,0 +1,28 @@
+import type { PicturePlacement } from 'ooxml-core/docx';
+/** A floating object's rectangle on its page, in CSS pixels. */
+export interface FloatBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export type FloatHandle = 'nw' | 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w';
+export declare const FLOAT_HANDLES: readonly FloatHandle[];
+export declare const MIN_FLOAT_SIZE = 16;
+/** One arrow press moves a selected float by this much (Ctrl+arrow moves 1px). */
+export declare const NUDGE_PX = 6;
+/**
+ * Resizes `start` by dragging `handle` by (`dx`, `dy`). Corner handles keep the aspect ratio when
+ * `lockAspect` is set (pictures), averaging the two axes the way Word's proportional resize
+ * feels; edge handles change one dimension. The opposite edge or corner stays fixed.
+ */
+export declare function resizeBox(start: FloatBox, handle: FloatHandle, dx: number, dy: number, lockAspect: boolean): FloatBox;
+export declare function moveBox(start: FloatBox, dx: number, dy: number): FloatBox;
+/**
+ * The placement that puts a float at `box`: offsets from the frame origin, with any alignment
+ * dropped (the offset now says where it is). Wrapping, anchoring and frames are kept.
+ */
+export declare function placementAt(placement: PicturePlacement | undefined, box: FloatBox, origin: {
+    x: number;
+    y: number;
+}): PicturePlacement;

package/dist/docx/print-float-locate.d.ts

@@ -0,0 +1,25 @@
+import type { PicturePlacement, ShapeSpec } from 'ooxml-core/docx';
+import type { Node as ProseMirrorNode } from 'prosemirror-model';
+import { type EditorState } from 'prosemirror-state';
+import type { FloatBox, FloatHandle } from './print-float-geometry.js';
+export interface Located {
+    pos: number;
+    node: ProseMirrorNode;
+    blockId: string;
+    index: number;
+}
+/** A float the page can select: an anchored picture with media bytes, or an anchored shape. */
+export declare const isFloat: (node: ProseMirrorNode) => boolean;
+/** Whether a float is a drawing shape or text box rather than a picture. */
+export declare const isShapeFloat: (node: ProseMirrorNode) => boolean;
+/** The shape spec of a float, when it is a shape. */
+export declare function shapeSpecOf(node: ProseMirrorNode): ShapeSpec | undefined;
+/** The float `index` of a paragraph, in run order. */
+export declare function locateFloat(doc: ProseMirrorNode, blockId: string, index: number): Located | undefined;
+/** The floating object a node selection holds, with its paragraph id and index. */
+export declare function selectedFloat(state: EditorState): Located | undefined;
+export declare const number: (value: string | undefined) => number;
+export declare function boxOf(element: HTMLElement): FloatBox;
+export declare function place(element: HTMLElement, box: FloatBox): void;
+export declare const CURSORS: Record<FloatHandle, string>;
+export declare function parsePlacement(value: unknown): PicturePlacement | undefined;

package/dist/docx/print-float-selection.d.ts

@@ -0,0 +1,24 @@
+import type { EditorView } from 'prosemirror-view';
+export { locateFloat, selectedFloat } from './print-float-locate.js';
+export interface PrintFloatHost {
+    /** The `.dve-print-pages` element. */
+    pages: HTMLElement;
+    /** The editing surface whose keys a selected float takes over. */
+    paper: HTMLElement;
+    view(): EditorView | undefined;
+    printActive(): boolean;
+}
+export interface PrintFloats {
+    /** Redraws the selection frame; call after transactions and layouts. */
+    refresh(): void;
+    destroy(): void;
+}
+/**
+ * Floating pictures, shapes and text boxes on Print Layout pages are selectable like in Word: a press selects the object
+ * (the same node selection the Draft surface uses) and draws a frame with eight handles; dragging
+ * moves it, corner handles resize it (keeping the aspect ratio for pictures; a second press on a shape
+ * that holds text, or a double-click on any shape, edits its text in place), arrow keys nudge it and Delete
+ * removes it. Each gesture is one transaction, so it is one undo step. Pictures behind the text
+ * are only taken where no text is, so a press on text still places the caret.
+ */
+export declare function attachPrintFloatSelection(host: PrintFloatHost): PrintFloats;

package/dist/docx/print-float-text.d.ts

@@ -0,0 +1,8 @@
+import type { EditorView } from 'prosemirror-view';
+/**
+ * Edits the text of a floating shape or text box in place on its page: a textarea laid over the
+ * shape, one paragraph per line. Enter adds a line, Escape cancels, Ctrl+Enter or leaving the
+ * field applies it as one transaction (one undo step). Returns a function that applies and closes the editor
+ * ; undefined when the shape's text cannot be edited.
+ */
+export declare function editShapeText(view: EditorView, element: HTMLElement, lines: string[], onClose: () => void): (() => void) | undefined;

package/dist/docx/print-keyboard-navigation.d.ts

@@ -1,18 +1,19 @@
 import type { EditorView } from 'prosemirror-view';
 import type { PrintEditingIndex } from './print-editing-index.js';
+import { type CaretAffinity } from './print-caret-affinity.js';
 interface Options {
     active(): boolean;
     getView(): EditorView | undefined;
     index: PrintEditingIndex;
     position(id: string, offset: number): number | undefined;
-    select(id: string, offset: number, extend?: boolean): boolean;
+    select(id: string, offset: number, extend?: boolean, affinity?: CaretAffinity): boolean;
     resolveHit(target: Element, x: number): {
         blockId: string;
         offset: number;
     } | null;
     scrollContainer: HTMLElement;
-    preferredPage(): string | undefined;
-    setPreferredPage(page: string | undefined): void;
+    /** Affinity of the current caret. */
+    affinity(): CaretAffinity;
 }
 export declare function printKeyboardNavigation(options: Options): (event: KeyboardEvent) => void;
 export {};

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

@@ -32,6 +32,12 @@ export interface PrintLayoutController {
     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;
+    /**
+     * Holds layout while an in-page header, footer or note editor is open (a relayout would replace
+     * the page it lives in); releasing lays out the latest model. `page` (a zero-based index) stays
+     * mounted while held, so scrolling a long document does not tear the open editor down.
+     */
+    holdLayout(held: boolean, page?: number): void;
     destroy(): void;
 }
 export declare function createPrintLayoutController(scrollContainer: HTMLElement, onRequestCursor: (blockId: string, offset: number) => void, pictureUrl?: PictureUrl, onLayout?: () => void, getReviewMode?: () => ReviewDisplayMode, isEditing?: () => boolean): PrintLayoutController;

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

@@ -8,7 +8,7 @@ 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;
+    showPages(center: number, pinned?: number | readonly (number | undefined)[]): void;
     renderAll(): void;
     pageSnapshot(index: number): HTMLElement | undefined;
     /**

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

@@ -0,0 +1,47 @@
+import type { DocumentModel } from 'ooxml-core/docx';
+import type { EditorView } from 'prosemirror-view';
+import type { NoteKind } from './note-commands.js';
+import type { PartsController } from './parts-controller.js';
+export interface PrintNoteHost {
+    /** The `.dve-print-pages` element. */
+    pages: HTMLElement;
+    parts: Pick<PartsController, 'editNoteOnPage' | 'closeOpenStory'>;
+    model(): DocumentModel;
+    /** The body editor, which keeps the caret outside the note. */
+    view(): EditorView | undefined;
+    printActive(): boolean;
+    /** `page` is the zero-based index of the page the open editor lives on. */
+    holdLayout(held: boolean, page?: number): void;
+    /** Mounts the page that holds a paragraph (virtualised documents). */
+    showBlock(id: string, offset: number): void;
+}
+interface NoteRef {
+    kind: NoteKind;
+    id: string;
+    /** Id of the note's first paragraph (where the automatic number mark sits). */
+    firstId: string;
+}
+/** Paragraph id to owning note, for every footnote and endnote paragraph in the model. */
+export declare function noteParagraphs(model: DocumentModel): Map<string, NoteRef>;
+/** The note a body reference mark under `target` points at, when it is one. */
+export declare function referenceUnder(view: EditorView, target: Element): {
+    kind: NoteKind;
+    id: string;
+} | undefined;
+/** Position just after the body reference to a note, with the id of its paragraph. */
+export declare function referencePosition(view: EditorView, ref: {
+    kind: NoteKind;
+    id: string;
+}): {
+    pos: number;
+    blockId: string;
+    offset: number;
+} | undefined;
+/**
+ * Notes on Print Layout pages. A press on a note's text opens the note's own editor over it with
+ * the caret there; Escape, or a press anywhere else, returns to the body. Double-clicking a
+ * reference mark in the body jumps to its note, and double-clicking the number in the note jumps
+ * back to the reference, as in Word.
+ */
+export declare function attachPrintNoteEditing(host: PrintNoteHost): () => void;
+export {};

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

@@ -10,7 +10,8 @@ export declare class PrintPageWindow {
     mount(index: number): void;
     private unmount;
     private changed;
-    show(center: number, pinned?: number): void;
+    /** Mounts the pages around `center`; `pinned` pages stay mounted wherever the window is. */
+    show(center: number, pinned?: number | readonly (number | undefined)[]): void;
     all(): void;
     snapshot(index: number): HTMLElement | undefined;
 }

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

@@ -1,5 +1,12 @@
 /** Resolves a package picture part to a displayable URL; undefined draws a placeholder box. */
 export type PictureUrl = (partName: string, contentType: string) => string | undefined;
+/**
+ * Strips the active content from a chart SVG before it is imported into the
+ * page: `<script>` and `<foreignObject>` elements, every `on*` event-handler
+ * attribute, and `href` / `xlink:href` values other than fragments or
+ * `data:image` URLs. Mirrors the rules of `src/core/docx/ui/chart-spec.ts`.
+ */
+export declare function sanitizeChartSvg(svg: Element): void;
 export declare function pictureElement(object: {
     partName: string;
     contentType: string;

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

@@ -0,0 +1,16 @@
+import type { DocumentModel } from 'ooxml-core/docx';
+import type { PartsController } from './parts-controller.js';
+export interface PrintStoryHost {
+    /** The `.dve-print-pages` element. */
+    pages: HTMLElement;
+    parts: Pick<PartsController, 'editOnPage' | 'closeOpenStory'>;
+    model(): DocumentModel;
+    printActive(): boolean;
+    /** `page` is the zero-based index of the page the open editor lives on. */
+    holdLayout(held: boolean, page?: number): void;
+}
+/**
+ * Double-clicking a page's header or footer area edits it in place, as in Word: the body dims, the
+ * Header & Footer ribbon tab appears, and Escape or a double-click on the body closes it.
+ */
+export declare function attachPrintStoryEditing(host: PrintStoryHost): () => void;

package/dist/docx/print-vertical-step.d.ts

@@ -0,0 +1,7 @@
+import type { PrintEditingIndex } from './print-editing-index.js';
+/**
+ * The line one step up or down from `line`. Outside tables that is the next rendered line; inside a
+ * table it stays in the cell, then moves to the cell of the next row under the same x, and leaves
+ * the table past its last or first row. Entering a table lands in the cell under `x`.
+ */
+export declare function stepVertical(index: PrintEditingIndex, line: HTMLElement, direction: number, x: number): HTMLElement;

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

@@ -167,6 +167,21 @@ export type RibbonAction = {
     key: 'toggle' | 'add' | 'delete' | 'previous' | 'next';
 } | {
     type: 'insertPicture';
+} | {
+    type: 'shapePicker';
+} | {
+    type: 'drawShape';
+    preset: string;
+} | {
+    type: 'shape';
+    key: 'fill' | 'outline' | 'weight' | 'width' | 'height' | 'wrap';
+    value: string | number;
+} | {
+    type: 'insertEquation';
+    id: 'area' | 'quadratic' | 'pythagorean' | 'binomial';
+} | {
+    type: 'insertContentControl';
+    value: 'richText' | 'text' | 'checkbox' | 'dropDownList' | 'comboBox' | 'date';
 } | {
     type: 'formatPicture';
 } | {

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

@@ -118,6 +118,9 @@ declare const paths: {
     readonly watermark: 'M5 18L19 6 M7 8h4 M13 16h4';
     readonly pageBorders: 'M4 4h16v16H4z M7 7h10v10H7z';
     readonly textBox: 'M4 5h16v14H4z M8 10h8 M8 14h5';
+    readonly shapes: 'M4 14h8v6H4z M17 7.5a4 4 0 1 0 0 .01 M10 11l4-8 4 8z';
+    readonly equation: 'M18 5H7l6 7-6 7h11';
+    readonly contentControl: 'M4 7h16v12H4z M4 7V4h7v3 M8 12h8 M8 15h5';
     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';

package/dist/docx/schema.d.ts

@@ -3,4 +3,4 @@ export { wordHighlightColors } from 'ooxml-core/docx/ui';
 /** Single line spacing as a multiple of the font size, close to Calibri's and Arial's metrics. */
 export declare const NATURAL_LINE_HEIGHT = 1.2;
 export declare function paragraphStyle(attrs: Record<string, unknown>): string;
-export declare const schema: Schema<"doc" | "equation" | "fieldMarker" | "hardBreak" | "image" | "nestedTablePreview" | "noteReference" | "pageBreak" | "paragraph" | "table" | "tableCell" | "tableRow" | "text", "bold" | "characterStyle" | "comment" | "deletion" | "field" | "font" | "highlight" | "inlineCommentAnchors" | "insertion" | "italic" | "language" | "link" | "runProperties" | "runRtl" | "strike" | "underline" | "verticalAlign">;
+export declare const schema: Schema<"doc" | "equation" | "fieldMarker" | "hardBreak" | "image" | "nestedTablePreview" | "noteReference" | "pageBreak" | "paragraph" | "table" | "tableCell" | "tableRow" | "text", "bold" | "characterStyle" | "comment" | "contentControl" | "deletion" | "field" | "font" | "highlight" | "inlineCommentAnchors" | "insertion" | "italic" | "language" | "link" | "runProperties" | "runRtl" | "strike" | "underline" | "verticalAlign">;