ooxml-ui 1.6.2 → 1.8.0

package/dist/visio/viewer-page-setup.d.ts

@@ -1,6 +1,8 @@
 import type { ViewerController, ViewerState } from './controller.js';
 import type { VisioPageSetupCommand } from './page-setup-action.js';
 import { ViewerPageSetupDialog } from './viewer-page-setup-dialog.js';
+import { ViewerRulerGrid } from './viewer-ruler-grid.js';
+import { ViewerSnapGlue } from './viewer-snap-glue.js';
 type Edit = (run: () => Promise<void>, message: string) => void;
 /**
  * Design > Page Setup and Backgrounds, File > Page Setup and View > Page Breaks. Every change is
@@ -14,6 +16,10 @@ export declare class ViewerPageSetup {
     private readonly edit;
     private readonly announce;
     readonly dialog: ViewerPageSetupDialog;
+    /** View > Show > Ruler & Grid, and the page's grid and ruler values. */
+    readonly rulerGrid: ViewerRulerGrid;
+    /** View > Visual Aids > Snap & Glue. */
+    readonly snapGlue: ViewerSnapGlue;
     constructor(root: ShadowRoot, controller: ViewerController, edit: Edit, announce: (message: string) => void);
     get pageBreaks(): boolean;
     run(command: VisioPageSetupCommand): void;

package/dist/visio/viewer-ruler-grid.d.ts

@@ -0,0 +1,25 @@
+import { type VisioGridSteps } from 'ooxml-core/visio/ui';
+import type { ViewerController, ViewerState } from './controller.js';
+import { ViewerDialog } from './viewer-dialog.js';
+import type { RulerLook } from './viewer-ruler.js';
+/**
+ * View > Show > Ruler & Grid, as Visio's dialog: ruler subdivisions and zero point, and the grid's
+ * spacing, minimum spacing and origin, each for the horizontal and the vertical axis. OK saves
+ * the changed cells of the page as one `set-page-layout` edit. The canvas grid, Snap to Grid and
+ * the rulers follow the page's values (`steps`, `look`).
+ */
+export declare class ViewerRulerGrid {
+    #private;
+    private readonly root;
+    private readonly controller;
+    private readonly announce;
+    readonly dialog: ViewerDialog;
+    constructor(root: ShadowRoot, controller: ViewerController, announce: (message: string) => void);
+    /** Grid lines of the shown page at the current zoom, for the canvas and Snap to Grid. */
+    steps(state?: ViewerState): VisioGridSteps;
+    /** Where the rulers' zero is and how many subdivisions they show. */
+    look(state?: ViewerState): RulerLook;
+    show(): void;
+    wire(): () => void;
+    render(state: ViewerState): void;
+}

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

@@ -1,12 +1,20 @@
 /**
  * Visio's rulers: inch scales along the top and left of the drawing window with 0 at the page's
  * left and bottom edges (vertical values grow upward, as in Visio). Drawn by the shared
- * `office-ui-ruler`; this module only lays them out and says where zero is. Viewer-only
- * presentation: nothing is read from or written to the document beyond the rendered page box.
+ * `office-ui-ruler`; this module only lays them out and says where zero is. The page's Ruler &
+ * Grid settings move zero (`RulerLook.originX`/`originY`, page inches from the lower-left corner)
+ * and thin the subdivisions.
  */
+export interface RulerLook {
+    originX: number;
+    originY: number;
+    /** Share of the subdivisions shown, 1 for Fine. */
+    densityX: number;
+    densityY: number;
+}
 export interface Rulers {
     element: HTMLElement;
-    render(visible: boolean, zoom: number): void;
+    render(visible: boolean, zoom: number, look?: RulerLook): void;
     wire(): () => void;
 }
 /** Wraps the viewport in a grid with a corner, a top ruler and a left ruler. */

package/dist/visio/viewer-snap-glue.d.ts

@@ -0,0 +1,23 @@
+import { type VisioSnapGlue } from 'ooxml-core/visio';
+import type { ViewerController, ViewerState } from './controller.js';
+import { ViewerDialog } from './viewer-dialog.js';
+/**
+ * View > Visual Aids > Snap & Glue, as Visio's dialog: whether snapping and gluing are active and
+ * what they snap and glue to. OK saves the drawing's DocumentSettings as one `set-snap-glue`
+ * edit. This editor acts on Snap (grid and guides), Glue and Glue to connection points; the
+ * other choices are saved for Visio and say so in the dialog. View > Dynamic Grid stays a
+ * per-viewer toggle and is not in this dialog.
+ */
+export declare class ViewerSnapGlue {
+    #private;
+    private readonly root;
+    private readonly controller;
+    private readonly announce;
+    readonly dialog: ViewerDialog;
+    constructor(root: ShadowRoot, controller: ViewerController, announce: (message: string) => void);
+    /** The drawing's settings, or Visio's defaults without a drawing. */
+    settings(state?: ViewerState): VisioSnapGlue;
+    show(): void;
+    wire(): () => void;
+    render(state: ViewerState): void;
+}

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

@@ -1,6 +1,9 @@
 import type { ViewerController } from './controller.js';
 /**
  * Shapes window interaction: drag a master onto the page to drop it there, or activate it to add
- * it at the page centre. Ellipses and circles are native ellipses; the rest are core outlines.
+ * it at the page centre. Either way the page gets an instance of a master, as in Visio: a master
+ * of a built-in stencil is first copied into the drawing's own Document Stencil, and a master
+ * that is already there is instanced directly. The window follows the open drawing: its Document
+ * Stencil and the stencils it docks.
  */
 export declare function wireStencil(pane: HTMLElement, viewport: HTMLElement, controller: ViewerController, announce: (message: string) => void): () => void;