ooxml-ui 0.31.0 → 1.0.0

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

@@ -1,12 +1,19 @@
+export type CanvasTool = 'pointer' | 'rectangle' | 'ellipse' | 'line';
 /** Every command the Visio ribbon, status bar or a shortcut can raise, as a `ribbon-action` event. */
 export type VisioRibbonAction = {
     type: 'history';
     key: 'undo' | 'redo';
 } | {
     type: 'tool';
-    tool: 'pointer' | 'rectangle';
+    tool: CanvasTool;
 } | {
     type: 'delete';
+} | {
+    type: 'rotate';
+    direction: 'left' | 'right';
+} | {
+    type: 'flip';
+    axis: 'horizontal' | 'vertical';
 } | {
     type: 'pane';
     pane: 'shapes' | 'inspector';

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

@@ -20,6 +20,7 @@ export interface CommandSpec {
     pressed?: boolean;
     controls?: string;
     checked?: boolean;
+    items?: readonly CommandSpec[];
 }
 export interface MenuSpec extends CommandSpec {
     items: readonly CommandSpec[];
@@ -29,7 +30,7 @@ export interface MenuSpec extends CommandSpec {
 /** A shared `office-ui-button` in Visio's large, small or icon-only size. */
 export declare function command(doc: Document, spec: CommandSpec): RibbonCommand;
 /** A shared `office-ui-menu-button` (dropdown or split) with typed actions per item. */
-export declare function menu(doc: Document, spec: MenuSpec): RibbonCommand;
+export declare function menu(doc: Document, spec: MenuSpec, submenu?: boolean): RibbonCommand;
 /** Office's three-row column of small commands, or a row with `horizontal`. */
 export declare function stack(doc: Document, children: readonly HTMLElement[], horizontal?: boolean): HTMLElement;
 /** A labelled ribbon group; `launcher` shows Visio's dialog launcher, disabled with a reason. */

package/dist/visio/ribbon-router.d.ts

@@ -1,11 +1,13 @@
 import type { ViewerController } from './controller.js';
-import type { VisioRibbonAction } from './ribbon-action.js';
+import type { VisioRibbonAction, CanvasTool } from './ribbon-action.js';
 /** The controllers a ribbon action can reach. The element supplies each one. */
 export interface RibbonTargets {
     controller: ViewerController;
     history(key: 'undo' | 'redo'): void;
     deleteSelection(): void;
-    setTool(tool: 'pointer' | 'rectangle'): void;
+    rotateSelection(direction: 'left' | 'right'): void;
+    flipSelection(axis: 'horizontal' | 'vertical'): void;
+    setTool(tool: CanvasTool): void;
     toggleGrid(): void;
     toggleRuler(): void;
     togglePanZoom(): void;

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

@@ -1,7 +1,7 @@
 import type { ViewerController, ViewerState } from './controller.js';
-import { type VisioRibbonAction } from './ribbon-action.js';
+import { type VisioRibbonAction, type CanvasTool } from './ribbon-action.js';
 import type { Rulers } from './viewer-ruler.js';
-export type CanvasTool = 'pointer' | 'rectangle';
+export type { CanvasTool } from './ribbon-action.js';
 interface CommandHost {
     root: ShadowRoot;
     viewport: HTMLElement;
@@ -14,6 +14,7 @@ interface CommandHost {
     togglePanZoom(): void;
     /** Transient command feedback for the status bar; document text is never interpreted as markup. */
     announce(message: string): void;
+    toolChanged?(): void;
 }
 /**
  * Visio command state (tool, grid, pending edits) and keyboard shortcuts. Ribbon controls emit
@@ -31,4 +32,3 @@ export declare class ViewerCommands {
     setTool(tool: CanvasTool): void;
     render(state: ViewerState): void;
 }
-export {};

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

@@ -1,9 +1,12 @@
 import type { VisioPage } from 'ooxml-core/visio';
+import type { CanvasTool } from './ribbon-action.js';
 import type { ViewerController } from './controller.js';
-/** Next free numeric shape ID on the page tree. Core still rejects any collision. */
-export declare function nextShapeId(page: VisioPage): string;
+export { visioNextShapeId as nextShapeId } from 'ooxml-core/visio/ui';
 /** Page inches with a top-left origin (SVG user space) from a client point. */
-export declare function pagePoint(svg: SVGSVGElement, page: VisioPage, event: Pick<MouseEvent, 'clientX' | 'clientY'>): {
+export declare function pagePoint(svg: SVGSVGElement, page: VisioPage, event: Pick<MouseEvent, 'clientX' | 'clientY'>, options?: {
+    snap?: boolean;
+    bounded?: boolean;
+}): {
     x: number;
     y: number;
 } | undefined;
@@ -18,14 +21,21 @@ export declare function insertRectangle(controller: ViewerController, page: Visi
     width: number;
     height: number;
 }): Promise<string>;
-/** Drag-to-draw rectangle tool. The preview is viewer-only; the shape is created by core. */
-export declare class RectangleDrawTool {
+export declare function insertLine(controller: ViewerController, page: VisioPage, begin: {
+    x: number;
+    y: number;
+}, end: {
+    x: number;
+    y: number;
+}): Promise<string>;
+/** Shared rectangle/line gesture lifecycle. Preview is DOM-only; core owns creation. */
+export declare class ShapeDrawTool {
     #private;
     private readonly viewport;
     private readonly controller;
     private readonly options;
     constructor(viewport: HTMLElement, controller: ViewerController, options: {
-        active(): boolean;
+        tool(): Exclude<CanvasTool, 'pointer'> | undefined;
         announce(message: string): void;
     });
     get drawing(): boolean;

package/dist/visio/viewer-handle-events.d.ts

@@ -0,0 +1,19 @@
+import type { VisioDocument, VisioPage } from 'ooxml-core/visio';
+import type { ViewerState } from './controller.js';
+export interface HandleGestureSnapshot {
+    pointer: number;
+    svg: SVGSVGElement;
+    page: VisioPage;
+    document: VisioDocument;
+    shapeId: string;
+}
+/** Cancel previews when source, page, selection, tool or editing availability changes. */
+export declare function handleGestureIsCurrent(drag: HandleGestureSnapshot, state: ViewerState, active: boolean): boolean;
+/** Shared capture, cancellation, Escape and post-release click ownership for geometry handles. */
+export declare function wireHandleEvents(viewport: HTMLElement, callbacks: {
+    pointer(): number | undefined;
+    start(event: PointerEvent): void;
+    move(event: PointerEvent): void;
+    finish(event: PointerEvent): Promise<void>;
+    cancel(): void;
+}): () => void;

package/dist/visio/viewer-line-endpoints.d.ts

@@ -0,0 +1,14 @@
+import type { ViewerController, ViewerState } from './controller.js';
+/** A preview-only endpoint gesture; release commits one source-backed core transaction. */
+export declare class ViewerLineEndpoints {
+    #private;
+    private readonly viewport;
+    private readonly controller;
+    private readonly options;
+    constructor(viewport: HTMLElement, controller: ViewerController, options: {
+        active(): boolean;
+        announce(message: string): void;
+    });
+    render(state: ViewerState): void;
+    wire(): () => void;
+}

package/dist/visio/viewer-rotation-handle.d.ts

@@ -0,0 +1,14 @@
+import type { ViewerController, ViewerState } from './controller.js';
+/** A source-backed rotation gesture; previews never mutate the model or history. */
+export declare class ViewerRotationHandle {
+    #private;
+    private readonly viewport;
+    private readonly controller;
+    private readonly options;
+    constructor(viewport: HTMLElement, controller: ViewerController, options: {
+        active(): boolean;
+        announce(message: string): void;
+    });
+    render(state: ViewerState): void;
+    wire(): () => void;
+}

package/dist/visio/viewer-rotation-preview.d.ts

@@ -0,0 +1,7 @@
+import type { VisioDocument, VisioPage, VisioShape } from 'ooxml-core/visio';
+/** Render the temporary pose through the same geometry, paint, text and resource pipeline. */
+export declare function createRotationPreview(model: VisioDocument, page: VisioPage, shape: VisioShape, source: SVGGElement): {
+    element: SVGGElement;
+    update(angle: number): void;
+    dispose(): void;
+};