ooxml-ui 1.5.0 → 1.6.0

package/dist/visio/text-run-style.d.ts

@@ -0,0 +1,9 @@
+import type { VisioTextRun } from 'ooxml-core/visio';
+/** Displayed font size: super- and subscript runs shrink like Visio's defaults. */
+export declare const runDisplaySize: (run: VisioTextRun) => number;
+/** Baseline shift in text units, down-positive (the text group is y-down). */
+export declare const runBaselineShift: (run: VisioTextRun) => number;
+/** Displayed characters for Char.Case; the stored text keeps its own case. */
+export declare function runDisplayText(text: string, run: Pick<VisioTextRun, 'textCase'>): string;
+/** Whether two runs draw identically, so wrapping may merge them. */
+export declare const sameRunExtras: (a: VisioTextRun, b: VisioTextRun) => boolean;

package/dist/visio/viewer-backstage.d.ts

@@ -16,11 +16,18 @@ export interface BackstageHost {
         svg: string;
         pageIndex: number;
     };
+    /** Raster PDF of the foreground pages, or a PNG of the current page (viewer-export). */
+    exportPicture(format: 'pdf' | 'png'): Promise<{
+        blob: Blob;
+        pageIndex: number;
+    }>;
     closeDocument(): void;
     revealNotes(): void;
     showOptions(): void;
     announce(message: string): void;
     noteCount(): number;
+    /** File > Print > Page Setup. */
+    pageSetup?(): void;
 }
 export declare class ViewerBackstage {
     #private;

package/dist/visio/viewer-change-shape.d.ts

@@ -0,0 +1,16 @@
+import type { VisioChangeShapeTarget } from 'ooxml-core/visio';
+import type { ViewerController, ViewerState } from './controller.js';
+/**
+ * Home > Change Shape: replaces the outline of the one selected local shape through the core's
+ * `change-shape` edit, so undo and redo come from the source-backed history. The gallery is
+ * enabled only for a selection the scene admits; locks and formulas are proven by the core.
+ */
+export declare class ViewerChangeShape {
+    #private;
+    private readonly root;
+    private readonly controller;
+    private readonly edit;
+    constructor(root: ShadowRoot, controller: ViewerController, edit: (run: () => Promise<void>, message: string) => void);
+    run(shape: VisioChangeShapeTarget): void;
+    render(state: ViewerState): void;
+}

package/dist/visio/viewer-chrome.d.ts

@@ -4,7 +4,7 @@ import type { ViewerController, ViewerState } from './controller.js';
  * window, page tabs and status bar are built by their own modules. Visio keeps pages in the
  * bottom tabs and the All pages list, so there is no page pane. Labels are inserted as text.
  */
-export declare const viewerChromeTemplate = "<div class=\"workspace\">\n  <div class=\"viewport\" tabindex=\"0\" role=\"region\" aria-label=\"Diagram canvas\"></div>\n  <aside id=\"inspector-pane\" class=\"inspector-pane\" aria-label=\"Drawing inspector\">\n    <div class=\"pane-heading\"><span>Inspector</span><span class=\"inspector-kind\">Drawing</span><button class=\"pane-close\" type=\"button\" data-chrome=\"inspector\" aria-label=\"Close inspector\">\u00D7</button></div>\n    <div class=\"inspector-body\">\n      <section class=\"inspector-card document-card\" aria-label=\"Current page\"><h2>Current page</h2><p class=\"current-page-name\" data-page-name>No diagram open</p><dl><dt>Size</dt><dd data-page-size>No page</dd><dt>Shapes</dt><dd data-page-shapes>No shapes</dd></dl></section>\n      <p class=\"selection-hint\">Select a shape on the canvas to see its data and links.</p>\n      <details class=\"shape-inspector inspector-card\" hidden><summary>Selected shape</summary><div></div></details>\n      <details class=\"edit-controls\"><summary>Edit diagram (experimental)</summary><p id=\"edit-warning\">Experimental source-backed editing. Unsupported targets are rejected. Native Visio compatibility is not verified. Keep your original file.</p><p data-edit-target></p><label for=\"edit-text\">Selected shape text</label><textarea id=\"edit-text\" rows=\"3\" aria-describedby=\"edit-warning edit-target edit-status\"></textarea><div class=\"edit-actions\"><button type=\"button\" data-edit=\"apply\">Apply text</button><button type=\"button\" data-edit=\"cancel\">Cancel</button><button type=\"button\" data-edit=\"undo\">Undo</button><button type=\"button\" data-edit=\"redo\">Redo</button></div><p id=\"edit-status\" role=\"status\" aria-live=\"polite\"></p><p data-edit-error role=\"alert\" hidden></p><ul data-edit-diagnostics></ul><fieldset data-geometry><legend>Geometry (experimental)</legend><p>Pin X/Y use drawing inches, bottom-left origin, Y up. Resize holds the rotation pin fixed. Core rejects unsupported formulas, protected cells, unsafe group/master dependencies and referenced deletion. Native Visio reopen fidelity is unverified.</p><label>New rectangle ID <input data-geometry-field=\"id\" type=\"text\" maxlength=\"256\"></label><label>Rectangle text (optional) <input data-geometry-field=\"text\" type=\"text\" maxlength=\"1000000\"></label><label>Pin X (inches) <input data-geometry-field=\"x\" type=\"number\" step=\"any\"></label><label>Pin Y (inches) <input data-geometry-field=\"y\" type=\"number\" step=\"any\"></label><label>Width (inches) <input data-geometry-field=\"width\" type=\"number\" min=\"0\" step=\"any\"></label><label>Height (inches) <input data-geometry-field=\"height\" type=\"number\" min=\"0\" step=\"any\"></label><div class=\"edit-actions\"><button type=\"button\" data-geometry-action=\"create-rectangle\">Create rectangle</button><button type=\"button\" data-geometry-action=\"move-shape\">Move selected</button><button type=\"button\" data-geometry-action=\"resize-shape\">Resize selected</button><button type=\"button\" data-geometry-action=\"delete-shape\">Delete selected</button></div><p data-geometry-error role=\"alert\" hidden></p></fieldset></details><details class=\"layer-controls\" hidden><summary>Layers</summary><p>Display changes only. SVG and print snapshots use saved visibility. Guides, NoShow and unknown hidden reasons remain hidden.</p><div data-layer-list></div><p data-layer-status role=\"status\"></p><button type=\"button\" data-layer-reset=\"all\">Reset all layers</button></details>\n      <details class=\"notes inspector-card\"><summary>Compatibility notes</summary><ul></ul></details>\n    </div>\n  </aside>\n</div>";
+export declare const viewerChromeTemplate = "<div class=\"workspace\">\n  <div class=\"viewport\" tabindex=\"0\" role=\"region\" aria-label=\"Diagram canvas\"></div>\n  <aside id=\"inspector-pane\" class=\"inspector-pane\" aria-label=\"Drawing inspector\">\n    <div class=\"pane-heading\"><span>Inspector</span><span class=\"inspector-kind\">Drawing</span><button class=\"pane-close\" type=\"button\" data-chrome=\"inspector\" aria-label=\"Close inspector\">\u00D7</button></div>\n    <div class=\"inspector-body\">\n      <section class=\"inspector-card document-card\" aria-label=\"Current page\"><h2>Current page</h2><p class=\"current-page-name\" data-page-name>No diagram open</p><dl><dt>Size</dt><dd data-page-size>No page</dd><dt>Shapes</dt><dd data-page-shapes>No shapes</dd></dl></section>\n      <p class=\"selection-hint\">Select a shape on the canvas to see its data and links.</p>\n      <details class=\"shape-inspector inspector-card\" hidden><summary>Selected shape</summary><div></div></details>\n      <details class=\"edit-controls\"><summary>Edit diagram (experimental)</summary><p id=\"edit-warning\">Experimental source-backed editing. Unsupported targets are rejected. Native Visio compatibility is not verified. Keep your original file.</p><p data-edit-target></p><label for=\"edit-text\">Selected shape text</label><textarea id=\"edit-text\" rows=\"3\" spellcheck=\"true\" aria-describedby=\"edit-warning edit-target edit-status\"></textarea><div class=\"edit-actions\"><button type=\"button\" data-edit=\"apply\">Apply text</button><button type=\"button\" data-edit=\"cancel\">Cancel</button><button type=\"button\" data-edit=\"undo\">Undo</button><button type=\"button\" data-edit=\"redo\">Redo</button></div><p id=\"edit-status\" role=\"status\" aria-live=\"polite\"></p><p data-edit-error role=\"alert\" hidden></p><ul data-edit-diagnostics></ul><fieldset data-geometry><legend>Geometry (experimental)</legend><p>Pin X/Y use drawing inches, bottom-left origin, Y up. Resize holds the rotation pin fixed. Core rejects unsupported formulas, protected cells, unsafe group/master dependencies and referenced deletion. Native Visio reopen fidelity is unverified.</p><label>New rectangle ID <input data-geometry-field=\"id\" type=\"text\" maxlength=\"256\"></label><label>Rectangle text (optional) <input data-geometry-field=\"text\" type=\"text\" maxlength=\"1000000\"></label><label>Pin X (inches) <input data-geometry-field=\"x\" type=\"number\" step=\"any\"></label><label>Pin Y (inches) <input data-geometry-field=\"y\" type=\"number\" step=\"any\"></label><label>Width (inches) <input data-geometry-field=\"width\" type=\"number\" min=\"0\" step=\"any\"></label><label>Height (inches) <input data-geometry-field=\"height\" type=\"number\" min=\"0\" step=\"any\"></label><div class=\"edit-actions\"><button type=\"button\" data-geometry-action=\"create-rectangle\">Create rectangle</button><button type=\"button\" data-geometry-action=\"move-shape\">Move selected</button><button type=\"button\" data-geometry-action=\"resize-shape\">Resize selected</button><button type=\"button\" data-geometry-action=\"delete-shape\">Delete selected</button></div><p data-geometry-error role=\"alert\" hidden></p></fieldset></details><details class=\"layer-controls\" hidden><summary>Layers</summary><p>Display changes only. SVG and print snapshots use saved visibility. Guides, NoShow and unknown hidden reasons remain hidden.</p><div data-layer-list></div><p data-layer-status role=\"status\"></p><button type=\"button\" data-layer-reset=\"all\">Reset all layers</button></details>\n      <details class=\"notes inspector-card\"><summary>Compatibility notes</summary><ul></ul></details>\n    </div>\n  </aside>\n</div>";
 export type TaskPane = 'shapes' | 'inspector';
 /** Presentation state stays local; page navigation uses the same controller as every binding. */
 export declare class ViewerChrome {

package/dist/visio/viewer-commands.d.ts

@@ -2,6 +2,7 @@ import type { ViewerController, ViewerState } from './controller.js';
 import { type VisioRibbonAction, type CanvasTool } from './ribbon-action.js';
 import type { Rulers } from './viewer-ruler.js';
 import { type ClipboardOperation } from './viewer-clipboard.js';
+import { ViewerLayoutCommands } from './viewer-layout-commands.js';
 export type { CanvasTool } from './ribbon-action.js';
 interface CommandHost {
     root: ShadowRoot;
@@ -14,6 +15,10 @@ interface CommandHost {
     focusSearch(): void;
     focusReplace?(): void;
     togglePanZoom(): void;
+    /** Visio's Presentation Mode (F5). */
+    present?(): void;
+    /** True while Presentation Mode owns the screen. */
+    presenting?(): boolean;
     toggleSizePosition(): void;
     /** Transient command feedback for the status bar; document text is never interpreted as markup. */
     announce(message: string): void;
@@ -27,6 +32,7 @@ interface CommandHost {
 export declare class ViewerCommands {
     #private;
     private readonly host;
+    readonly layoutCommands: ViewerLayoutCommands;
     constructor(host: CommandHost);
     get tool(): CanvasTool;
     /** Browser clipboard transport used by the element's public clipboard methods. */

package/dist/visio/viewer-comment-threads.d.ts

@@ -0,0 +1,17 @@
+import type { VisioComment, VisioDocument, VisioPage, VisioShape } from 'ooxml-core/visio';
+import type { OfficeCommentThread } from '../controls.js';
+/** The conversation of the comments on the page itself; shape conversations are `shape:<id>`. */
+export declare const PAGE_THREAD = "page";
+export declare const commentThreadId: (comment: Pick<VisioComment, 'shapeId'>) => string;
+export declare const threadShapeId: (thread: string) => string | undefined;
+export declare function findCommentShape(shapes: readonly VisioShape[], id: string): VisioShape | undefined;
+/**
+ * The page's comments as shared-pane threads: Visio's comments are flat, so the comments on one
+ * shape (or on the page itself) read as one conversation, oldest first in saved order.
+ */
+export declare function visioCommentThreads(document: VisioDocument, page: VisioPage): OfficeCommentThread[];
+/**
+ * Speech-bubble count markers at the top right of commented shapes (a nested shape uses its
+ * top-level shape) and at the page's top left corner, drawn in screen pixels on the paper SVG.
+ */
+export declare function drawCommentMarkers(svg: SVGSVGElement, document: VisioDocument, page: VisioPage, zoom: number): void;

package/dist/visio/viewer-comments.d.ts

@@ -0,0 +1,25 @@
+import type { OfficeUiCommentsPane } from '../comments/comments-pane.js';
+import type { ViewerController, ViewerState } from './controller.js';
+export { visioCommentThreads } from './viewer-comment-threads.js';
+type Run = (action: () => Promise<void>, success: string) => void;
+/**
+ * Review comments: the shared comments pane in a side pane, comment markers on the canvas, and
+ * the add, reply, edit, delete and resolve edits. The author is the shared Office profile name.
+ */
+export declare class ViewerComments {
+    #private;
+    private readonly root;
+    private readonly viewport;
+    private readonly controller;
+    private readonly announce;
+    private readonly run;
+    readonly host: HTMLElement;
+    readonly pane: OfficeUiCommentsPane;
+    constructor(root: ShadowRoot, viewport: HTMLElement, controller: ViewerController, announce: (message: string) => void, run: Run);
+    get open(): boolean;
+    show(open?: boolean): void;
+    /** Review > New Comment (or the page menu's Add Comment): open the pane at its new-comment box. */
+    newComment(onPage: boolean): void;
+    wire(): () => void;
+    render(state: ViewerState): void;
+}

package/dist/visio/viewer-connection-points.d.ts

@@ -0,0 +1,31 @@
+import type { ViewerController, ViewerState } from './controller.js';
+export interface SelectedConnectionPoint {
+    pageId: string;
+    shapeId: string;
+    index: number;
+}
+/**
+ * View > Visual Aids > Connection Points (Visio's blue x markers) and Home > Tools > Connection
+ * Point (Ctrl+Shift+1): a click on a local 2D shape adds a point there, a click on a point selects
+ * it, and Delete removes the selected point. Edits go through the core and undo like any other.
+ */
+export declare class ViewerConnectionPoints {
+    #private;
+    private readonly viewport;
+    private readonly controller;
+    private readonly options;
+    constructor(viewport: HTMLElement, controller: ViewerController, options: {
+        active(): boolean;
+        /** Other tools that show points while they run (the Connector tool). */
+        showing(): boolean;
+        announce(message: string): void;
+    });
+    get visible(): boolean;
+    get selected(): SelectedConnectionPoint | undefined;
+    toggle(): void;
+    /** Draw the markers in the page's SVG; markers are presentation only and never exported. */
+    render(state: ViewerState): void;
+    wire(): () => void;
+    /** Remove the selected point; returns false when no point is selected. */
+    deleteSelected(): boolean;
+}

package/dist/visio/viewer-connector-routes.d.ts

@@ -0,0 +1,24 @@
+import { type VisioConnectorRoute } from 'ooxml-core/visio';
+import type { ViewerController, ViewerState } from './controller.js';
+import type { VisioRibbonAction } from './ribbon-action.js';
+/**
+ * The connector style: Design > Connectors restyles the selected connectors and sets the style
+ * of new ones; Insert > Connector sets the style and arms the Connector tool. New connectors are
+ * right-angle, as Visio's default dynamic connector.
+ */
+export declare class ViewerConnectorRoutes {
+    #private;
+    private readonly root;
+    private readonly controller;
+    private readonly host;
+    constructor(root: ShadowRoot, controller: ViewerController, host: {
+        setTool(tool: 'connector'): void;
+        edit(run: () => Promise<void>, message: string): void;
+        announce(message: string): void;
+    });
+    get route(): VisioConnectorRoute;
+    run(action: Extract<VisioRibbonAction, {
+        type: 'connector-route';
+    }>): void;
+    render(state: ViewerState): void;
+}

package/dist/visio/viewer-connector-tool.d.ts

@@ -0,0 +1,42 @@
+import type { VisioConnectorRoute, VisioPage } from 'ooxml-core/visio';
+import type { ViewerController, ViewerState } from './controller.js';
+/** What an end released at the pointer would glue to. */
+export interface ConnectorGlueHit {
+    shapeId: string;
+    /** A connection point of the shape (point-to-point glue); otherwise the shape itself. */
+    point?: number;
+    x?: number;
+    y?: number;
+}
+/** A page shape the core can glue to: a visible, local, top-level 2D shape. */
+export declare function connectorGlueTarget(page: VisioPage, element: Element | null): string | undefined;
+/**
+ * The glue target under a client point: the nearest connection point within a few pixels of it,
+ * else the shape under it. Pointer capture retargets events, so the point itself is hit-tested.
+ */
+export declare function connectorGlueAt(viewport: HTMLElement, page: VisioPage, event: Pick<PointerEvent, 'clientX' | 'clientY' | 'target'>, zoom: number): ConnectorGlueHit | undefined;
+/**
+ * Home > Tools > Connector (Ctrl+3). A drag draws a dynamic connector in the current route
+ * (right-angle by default); ends released on shapes glue to them, ends released on a connection
+ * point glue to that point. The shape (and point) under the pointer is highlighted.
+ */
+export declare class ViewerConnectorTool {
+    #private;
+    private readonly viewport;
+    private readonly controller;
+    private readonly options;
+    constructor(viewport: HTMLElement, controller: ViewerController, options: {
+        active(): boolean;
+        announce(message: string): void;
+        /** Route for new connectors (Design > Connectors, Insert > Connector). */
+        route?(): VisioConnectorRoute;
+    });
+    get drawing(): boolean;
+    /** The shape currently highlighted as a glue target, for tests and status text. */
+    get target(): string | undefined;
+    /** The connection point currently targeted, if any. */
+    get targetPoint(): number | undefined;
+    cancel(): void;
+    render(state: ViewerState): void;
+    wire(): () => void;
+}

package/dist/visio/viewer-data-import.d.ts

@@ -0,0 +1,31 @@
+import type { Workbook } from 'ooxml-core/xlsx';
+import { type VisioDataTable } from 'ooxml-core/visio/ui';
+import { InsertDialog } from './viewer-insert-dialog.js';
+/** Largest workbook or CSV read for import (the drawing package limit is 32 MiB too). */
+export declare const DATA_IMPORT_MAX_BYTES: number;
+/** A local File System Access handle, when the browser offers one. */
+export interface DataFileHandle {
+    getFile(): Promise<File>;
+}
+export interface PickedFile {
+    file: File;
+    handle?: DataFileHandle;
+}
+/** How a recordset was read, so Refresh All can read it the same way. */
+export interface DataSourceOptions {
+    sheet: number;
+    range: string;
+    header: boolean;
+}
+/** Read a workbook or CSV through the shared xlsx loader (loaded on first use). */
+export declare function readWorkbook(file: File): Promise<Workbook>;
+export declare function readTable(workbook: Workbook, options: DataSourceOptions): VisioDataTable;
+/** Local file choice: the File System Access picker when present (Refresh can reuse it), else an input. */
+export declare class DataFilePicker {
+    #private;
+    readonly input: HTMLInputElement;
+    constructor(root: ShadowRoot);
+    pick(): Promise<PickedFile | undefined>;
+}
+/** Custom Import: name, sheet, optional range and whether the first row holds headers. */
+export declare function createImportDialog(root: ShadowRoot, press: (button: string) => void): InsertDialog;

package/dist/visio/viewer-data-links.d.ts

@@ -0,0 +1,25 @@
+import type { ViewerController, ViewerState } from './controller.js';
+import { InsertDialog } from './viewer-insert-dialog.js';
+type Run = (action: () => Promise<void>, success: string) => void;
+/**
+ * The External Data window and its links: drag rows onto shapes, link selected rows to selected
+ * shapes, link automatically by a key column, unlink and remove recordsets.
+ */
+export declare class ViewerDataLinks {
+    #private;
+    private readonly root;
+    private readonly controller;
+    private readonly announce;
+    private readonly run;
+    readonly pane: HTMLElement;
+    readonly autoLink: InsertDialog;
+    /** Refresh All, supplied by the Data tab. */
+    onRefresh: () => void;
+    constructor(root: ShadowRoot, controller: ViewerController, announce: (message: string) => void, run: Run);
+    get activeId(): string | undefined;
+    toggle(): void;
+    show(id?: string): void;
+    wire(viewport: HTMLElement): () => void;
+    render(state: ViewerState): void;
+}
+export {};

package/dist/visio/viewer-data-sources.d.ts

@@ -0,0 +1,23 @@
+import type { ViewerController } from './controller.js';
+import type { InsertDialog } from './viewer-insert-dialog.js';
+import { DataFilePicker } from './viewer-data-import.js';
+import type { ViewerDataLinks } from './viewer-data-links.js';
+type Run = (action: () => Promise<void>, success: string) => void;
+/**
+ * Quick Import, Custom Import and Refresh All. A recordset remembers how it was read and, when
+ * the browser offers one, its File System Access handle; without a handle Refresh asks for the
+ * file again, because a page cannot re-read a local path by itself.
+ */
+export declare class ViewerDataSources {
+    #private;
+    private readonly controller;
+    private readonly announce;
+    private readonly run;
+    private readonly links;
+    readonly picker: DataFilePicker;
+    readonly importer: InsertDialog;
+    constructor(root: ShadowRoot, controller: ViewerController, announce: (message: string) => void, run: Run, links: ViewerDataLinks);
+    import(custom: boolean): Promise<void>;
+    refresh(): Promise<void>;
+}
+export {};

package/dist/visio/viewer-data-window.d.ts

@@ -0,0 +1,17 @@
+import type { VisioDataRecordset } from 'ooxml-core/visio';
+/** Drag payload of External Data rows: `{ recordsetId, rowIds }` as JSON. */
+export declare const DATA_ROW_MIME = "application/x-visio-viewer-data-row";
+export type DataWindowAction = 'link' | 'auto-link' | 'unlink' | 'refresh' | 'remove' | 'close';
+/** Visio's External Data window: a docked grid of the drawing's saved recordsets. */
+export declare function createExternalDataWindow(doc: Document): HTMLElement;
+export interface DataWindowView {
+    recordsets: readonly VisioDataRecordset[];
+    active: VisioDataRecordset | undefined;
+    selectedRows: ReadonlySet<string>;
+    /** Rows linked to the selected shapes, highlighted like Visio's linked-row marker. */
+    currentRows: ReadonlySet<string>;
+    editable: boolean;
+    shapesSelected: boolean;
+}
+/** Sync the pane with the drawing; the grid is rebuilt only when the recordset changes. */
+export declare function renderExternalDataWindow(pane: HTMLElement, view: DataWindowView): void;

package/dist/visio/viewer-data.d.ts

@@ -0,0 +1,28 @@
+import type { ViewerController, ViewerState } from './controller.js';
+import type { VisioDataCommand } from './ribbon-action.js';
+import { InsertDialog } from './viewer-insert-dialog.js';
+import { ViewerDataSources } from './viewer-data-sources.js';
+import { ViewerDataLinks } from './viewer-data-links.js';
+import { ViewerShapeData } from './viewer-shape-data.js';
+type Run = (action: () => Promise<void>, success: string) => void;
+/**
+ * Visio's Data tab: Quick and Custom Import of a local workbook or CSV into a saved recordset,
+ * Refresh All, the External Data window with row linking, data graphics, a legend and the
+ * Define Shape Data dialog. Documents stay local; nothing is fetched.
+ */
+export declare class ViewerData {
+    #private;
+    private readonly root;
+    private readonly controller;
+    private readonly announce;
+    private readonly run;
+    readonly sources: ViewerDataSources;
+    readonly graphics: InsertDialog;
+    readonly links: ViewerDataLinks;
+    readonly shapeData: ViewerShapeData;
+    constructor(root: ShadowRoot, controller: ViewerController, announce: (message: string) => void, run: Run);
+    handle(command: VisioDataCommand): void;
+    wire(viewport: HTMLElement): () => void;
+    render(state: ViewerState): void;
+}
+export {};

package/dist/visio/viewer-diagram-parts.d.ts

@@ -0,0 +1,17 @@
+import type { ViewerController, ViewerState } from './controller.js';
+import type { VisioDiagramPartAction } from './ribbon-action.js';
+import { type DiagramPart } from './ribbon-diagram-parts.js';
+/**
+ * Insert > Container and Callout (and the shape menu's Container): one core edit each, so undo
+ * restores the page in one step. Availability follows the selection; core admission decides.
+ */
+export declare class ViewerDiagramParts {
+    private readonly root;
+    private readonly controller;
+    private readonly edit;
+    private readonly revealText;
+    constructor(root: ShadowRoot, controller: ViewerController, edit: (run: () => Promise<void>, message: string) => void, revealText: () => void);
+    reason(state: ViewerState, part: DiagramPart): string | undefined;
+    run(action: VisioDiagramPartAction): void;
+    render(state: ViewerState): void;
+}

package/dist/visio/viewer-dialog.d.ts

@@ -0,0 +1,31 @@
+export type ViewerDialogElement = HTMLElement & {
+    open: boolean;
+    show(): void;
+    close(): void;
+};
+type Button = HTMLElement & {
+    disabled: boolean;
+};
+/**
+ * A Visio command dialog on the shared `office-ui-dialog` shell: a body for the caller's
+ * controls, an alert line and footer buttons. Document text is only ever set as text.
+ */
+export declare class ViewerDialog {
+    readonly dialog: ViewerDialogElement;
+    readonly body: HTMLElement;
+    readonly error: HTMLElement;
+    readonly buttons: Map<string, Button>;
+    constructor(root: ShadowRoot, className: string, heading: string, buttons: readonly string[], press: (button: string) => void);
+    get open(): boolean;
+    show(): void;
+    close(): void;
+    busy(value: boolean): void;
+}
+/** A labelled native checkbox or radio; `label` is plain text. */
+export declare function choice(doc: Document, type: 'checkbox' | 'radio', name: string, value: string, label: string): {
+    row: HTMLLabelElement;
+    input: HTMLInputElement;
+};
+/** A fieldset with a plain-text legend. */
+export declare function fieldset(doc: Document, legend: string, ...children: Node[]): HTMLFieldSetElement;
+export {};

package/dist/visio/viewer-draw-tool.d.ts

@@ -1,5 +1,5 @@
-import type { VisioPage, VisioBasicShape } from 'ooxml-core/visio';
-import { type VisioDrawingPoint } from 'ooxml-core/visio/ui';
+import type { VisioPage, VisioOutlineShape } from 'ooxml-core/visio';
+import { type VisioPathTool, type VisioDrawingPoint } from 'ooxml-core/visio/ui';
 import type { ViewerController, ViewerState } from './controller.js';
 export { pagePoint } from './viewer-page-point.js';
 export { visioNextShapeId as nextShapeId } from 'ooxml-core/visio/ui';
@@ -12,18 +12,26 @@ export declare function insertMaster(controller: ViewerController, page: VisioPa
     kind: 'ellipse';
 } | {
     kind: 'rectangle';
-    shape: VisioBasicShape;
+    shape: VisioOutlineShape;
 }, centre: VisioDrawingPoint, size: {
     width: number;
     height: number;
 }): Promise<string>;
+/**
+ * Quick Style a dropped master gets: variant colour 1 (Accent 1 in every built-in theme's first
+ * variant, and in the theme-less Office colours), theme style 4, so drops follow Design > Variants.
+ */
+export declare const MASTER_QUICK_STYLE: {
+    readonly color: 100;
+    readonly matrix: 4;
+};
 export declare function insertLine(controller: ViewerController, page: VisioPage, begin: VisioDrawingPoint, end: VisioDrawingPoint): Promise<string>;
 /** Core-backed ordinary shape drawing with one captured creation transaction. */
 export declare class ShapeDrawTool {
     #private;
     private readonly controller;
     constructor(viewport: HTMLElement, controller: ViewerController, options: {
-        tool(): 'rectangle' | 'ellipse' | 'line' | undefined;
+        tool(): 'rectangle' | 'ellipse' | 'line' | VisioPathTool | undefined;
         announce(message: string): void;
     });
     get drawing(): boolean;

package/dist/visio/viewer-drawing-gesture.d.ts

@@ -1,5 +1,5 @@
 import type { VisioPage, VisioDocument } from 'ooxml-core/visio';
-import { type VisioDrawingPoint, type VisioDrawingTool } from 'ooxml-core/visio/ui';
+import { type VisioDrawingPoint, type VisioDrawingTool, type VisioPathTool } from 'ooxml-core/visio/ui';
 import type { ViewerController, ViewerState } from './controller.js';
 import type { ViewerCreationToken } from './creation-token.js';
 export interface DrawingGesture {
@@ -8,9 +8,11 @@ export interface DrawingGesture {
     page: VisioPage;
     document: VisioDocument;
     start: VisioDrawingPoint;
-    kind: VisioDrawingTool;
+    kind: VisioDrawingTool | VisioPathTool;
+    /** Pointer samples of a Freeform, Pencil or Arc stroke, start first. */
+    points: VisioDrawingPoint[];
     token: ViewerCreationToken;
-    preview: SVGRectElement | SVGEllipseElement | SVGLineElement;
+    preview: SVGRectElement | SVGEllipseElement | SVGLineElement | SVGPathElement;
     sourceGeneration: number;
     selection: ViewerState['selectedShapes'];
     zoom: number;
@@ -23,7 +25,7 @@ export declare class ViewerDrawingGesture {
     private readonly controller;
     private readonly options;
     constructor(viewport: HTMLElement, controller: ViewerController, options: {
-        tool(): VisioDrawingTool | undefined;
+        tool(): VisioDrawingTool | VisioPathTool | undefined;
         finish(drag: DrawingGesture, end: VisioDrawingPoint): Promise<void>;
         existingShape?(event: PointerEvent): boolean;
         announce(message: string): void;

package/dist/visio/viewer-edit-controls.d.ts

@@ -1,6 +1,6 @@
 import type { ViewerController, ViewerState } from './controller.js';
 /** Static markup only. Document text is assigned exclusively through value/textContent. */
-export declare const editControlsTemplate = "<details class=\"edit-controls\"><summary>Edit diagram (experimental)</summary><p id=\"edit-warning\">Experimental source-backed editing. Unsupported targets are rejected. Native Visio compatibility is not verified. Keep your original file.</p><p data-edit-target></p><label for=\"edit-text\">Selected shape text</label><textarea id=\"edit-text\" rows=\"3\" aria-describedby=\"edit-warning edit-target edit-status\"></textarea><div class=\"edit-actions\"><button type=\"button\" data-edit=\"apply\">Apply text</button><button type=\"button\" data-edit=\"cancel\">Cancel</button><button type=\"button\" data-edit=\"undo\">Undo</button><button type=\"button\" data-edit=\"redo\">Redo</button></div><p id=\"edit-status\" role=\"status\" aria-live=\"polite\"></p><p data-edit-error role=\"alert\" hidden></p><ul data-edit-diagnostics></ul><fieldset data-geometry><legend>Geometry (experimental)</legend><p>Pin X/Y use drawing inches, bottom-left origin, Y up. Resize holds the rotation pin fixed. Core rejects unsupported formulas, protected cells, unsafe group/master dependencies and referenced deletion. Native Visio reopen fidelity is unverified.</p><label>New rectangle ID <input data-geometry-field=\"id\" type=\"text\" maxlength=\"256\"></label><label>Rectangle text (optional) <input data-geometry-field=\"text\" type=\"text\" maxlength=\"1000000\"></label><label>Pin X (inches) <input data-geometry-field=\"x\" type=\"number\" step=\"any\"></label><label>Pin Y (inches) <input data-geometry-field=\"y\" type=\"number\" step=\"any\"></label><label>Width (inches) <input data-geometry-field=\"width\" type=\"number\" min=\"0\" step=\"any\"></label><label>Height (inches) <input data-geometry-field=\"height\" type=\"number\" min=\"0\" step=\"any\"></label><div class=\"edit-actions\"><button type=\"button\" data-geometry-action=\"create-rectangle\">Create rectangle</button><button type=\"button\" data-geometry-action=\"move-shape\">Move selected</button><button type=\"button\" data-geometry-action=\"resize-shape\">Resize selected</button><button type=\"button\" data-geometry-action=\"delete-shape\">Delete selected</button></div><p data-geometry-error role=\"alert\" hidden></p></fieldset></details>";
+export declare const editControlsTemplate = "<details class=\"edit-controls\"><summary>Edit diagram (experimental)</summary><p id=\"edit-warning\">Experimental source-backed editing. Unsupported targets are rejected. Native Visio compatibility is not verified. Keep your original file.</p><p data-edit-target></p><label for=\"edit-text\">Selected shape text</label><textarea id=\"edit-text\" rows=\"3\" spellcheck=\"true\" aria-describedby=\"edit-warning edit-target edit-status\"></textarea><div class=\"edit-actions\"><button type=\"button\" data-edit=\"apply\">Apply text</button><button type=\"button\" data-edit=\"cancel\">Cancel</button><button type=\"button\" data-edit=\"undo\">Undo</button><button type=\"button\" data-edit=\"redo\">Redo</button></div><p id=\"edit-status\" role=\"status\" aria-live=\"polite\"></p><p data-edit-error role=\"alert\" hidden></p><ul data-edit-diagnostics></ul><fieldset data-geometry><legend>Geometry (experimental)</legend><p>Pin X/Y use drawing inches, bottom-left origin, Y up. Resize holds the rotation pin fixed. Core rejects unsupported formulas, protected cells, unsafe group/master dependencies and referenced deletion. Native Visio reopen fidelity is unverified.</p><label>New rectangle ID <input data-geometry-field=\"id\" type=\"text\" maxlength=\"256\"></label><label>Rectangle text (optional) <input data-geometry-field=\"text\" type=\"text\" maxlength=\"1000000\"></label><label>Pin X (inches) <input data-geometry-field=\"x\" type=\"number\" step=\"any\"></label><label>Pin Y (inches) <input data-geometry-field=\"y\" type=\"number\" step=\"any\"></label><label>Width (inches) <input data-geometry-field=\"width\" type=\"number\" min=\"0\" step=\"any\"></label><label>Height (inches) <input data-geometry-field=\"height\" type=\"number\" min=\"0\" step=\"any\"></label><div class=\"edit-actions\"><button type=\"button\" data-geometry-action=\"create-rectangle\">Create rectangle</button><button type=\"button\" data-geometry-action=\"move-shape\">Move selected</button><button type=\"button\" data-geometry-action=\"resize-shape\">Resize selected</button><button type=\"button\" data-geometry-action=\"delete-shape\">Delete selected</button></div><p data-geometry-error role=\"alert\" hidden></p></fieldset></details>";
 export declare class ViewerEditControls {
     #private;
     readonly panel: HTMLDetailsElement;

package/dist/visio/viewer-element.d.ts

@@ -41,6 +41,11 @@ export declare class VisioViewerElement extends BaseElement {
     redo(): Promise<void>;
     cancelEdit(): void;
     exportVsdx(): ReturnType<ViewerController['exportVsdx']>;
+    /** Start Visio's Presentation Mode on the current foreground page (F5). */
+    startPresentation(): void;
+    /** Leave Presentation Mode; the drawing window's page, zoom and selection are unchanged. */
+    exitPresentation(): void;
+    get presenting(): boolean;
     fit(): void;
     setLayerVisibility(pageId: string, layerId: string, visible: boolean | null): void;
     resetLayerVisibility(pageId?: string): void;

package/dist/visio/viewer-explorer.d.ts

@@ -0,0 +1,17 @@
+import type { ViewerController, ViewerState } from './controller.js';
+import { ViewerDialog } from './viewer-dialog.js';
+/**
+ * View > Task Panes > Drawing Explorer: a tree of the drawing's pages and, for the current page,
+ * its layers, shapes (with group members) and masters. Activating a page shows it; a shape,
+ * layer or master selects the matching top-level shapes. Names are plain text.
+ */
+export declare class ViewerExplorer {
+    #private;
+    private readonly root;
+    private readonly controller;
+    private readonly announce;
+    readonly dialog: ViewerDialog;
+    constructor(root: ShadowRoot, controller: ViewerController, announce: (message: string) => void);
+    open(): void;
+    render(state: ViewerState): void;
+}

package/dist/visio/viewer-export.d.ts

@@ -0,0 +1,17 @@
+import type { VisioDocument } from 'ooxml-core/visio';
+/** Raster resolution of PDF and PNG output; large pages are scaled down to the canvas cap. */
+export declare const EXPORT_DPI = 150;
+/** Pixel size of a page at `dpi`, scaled down so neither side exceeds the canvas cap. */
+export declare function rasterSize(widthIn: number, heightIn: number, dpi?: number): {
+    width: number;
+    height: number;
+};
+/** Draw one exported page SVG on a white canvas. Resolves once the image has loaded. */
+export declare function rasterizePage(doc: Document, model: VisioDocument, pageIndex: number, dpi?: number): Promise<HTMLCanvasElement>;
+/** The current page as a PNG picture. */
+export declare function exportPagePng(doc: Document, model: VisioDocument, pageIndex: number): Promise<Blob>;
+/**
+ * Every foreground page (with its background pages) as one raster PDF page of the drawing's
+ * page size. Text is not selectable: the pages are pictures, not vector PDF.
+ */
+export declare function exportDocumentPdf(doc: Document, model: VisioDocument): Promise<Blob>;

package/dist/visio/viewer-format-painter.d.ts

@@ -0,0 +1,20 @@
+import type { ViewerController, ViewerState } from './controller.js';
+export type FormatPainterMode = 'once' | 'sticky' | 'cancel';
+/**
+ * Visio's Format Painter: a click copies the selected shape's formatting and applies it once to
+ * the next selection; a double click keeps it on until Escape or another click on the button.
+ * Each application is one atomic, undoable edit of existing core format commands.
+ */
+export declare class ViewerFormatPainter {
+    #private;
+    private readonly root;
+    private readonly controller;
+    private readonly announce;
+    private readonly edit;
+    constructor(root: ShadowRoot, controller: ViewerController, announce: (message: string) => void, edit: (run: () => Promise<void>, success: string) => void);
+    get armed(): boolean;
+    /** Double clicking the button keeps the painter on (the second click arrives first). */
+    wire(): () => void;
+    run(mode: FormatPainterMode): void;
+    render(state: ViewerState): void;
+}

package/dist/visio/viewer-format-shape.d.ts

@@ -0,0 +1,16 @@
+import type { ViewerController, ViewerState } from './controller.js';
+/**
+ * Home > Shape Styles dialog launcher: Visio's Format Shape with Fill, Line and Effects sections.
+ * Every change becomes one undoable format-shape edit per selected shape.
+ */
+export declare class ViewerFormatShape {
+    #private;
+    private readonly root;
+    private readonly controller;
+    private readonly announce;
+    constructor(root: ShadowRoot, controller: ViewerController, announce: (message: string) => void);
+    wire(): () => void;
+    show(): void;
+    close(): void;
+    render(state: ViewerState): void;
+}

package/dist/visio/viewer-grouping.d.ts

@@ -0,0 +1,13 @@
+import type { ViewerController, ViewerState } from './controller.js';
+type Operation = 'group' | 'ungroup';
+/** Group and Ungroup availability; the controller owns the transaction and new selection. */
+export declare class ViewerGrouping {
+    private readonly root;
+    private readonly controller;
+    private readonly edit;
+    constructor(root: ShadowRoot, controller: ViewerController, edit: (run: () => Promise<void>, message: string) => void);
+    private reason;
+    run(operation: Operation): void;
+    render(state: ViewerState): void;
+}
+export {};