ooxml-ui 1.3.0 → 1.4.0

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

@@ -1,43 +1,23 @@
 import type { VisioPage } from 'ooxml-core/visio';
-import type { CanvasTool } from './ribbon-action.js';
-import type { ViewerController } from './controller.js';
+import { 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';
-/** 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'>, options?: {
-    snap?: boolean;
-    bounded?: boolean;
-}): {
-    x: number;
-    y: number;
-} | undefined;
-/**
- * Create one rectangle through core and select it. `centre` is in top-left page inches (SVG
- * space); core pins are centre points in bottom-left, y-up drawing inches.
- */
-export declare function insertRectangle(controller: ViewerController, page: VisioPage, centre: {
-    x: number;
-    y: number;
-}, size: {
+export declare function insertRectangle(controller: ViewerController, page: VisioPage, centre: VisioDrawingPoint, size: {
     width: number;
     height: number;
 }): Promise<string>;
-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 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 viewport;
     private readonly controller;
-    private readonly options;
     constructor(viewport: HTMLElement, controller: ViewerController, options: {
-        tool(): Exclude<CanvasTool, 'pointer'> | undefined;
+        tool(): 'rectangle' | 'ellipse' | 'line' | undefined;
         announce(message: string): void;
     });
     get drawing(): boolean;
+    cancel(): void;
+    render(state: ViewerState): void;
     wire(): () => void;
 }

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

@@ -0,0 +1,36 @@
+import type { VisioPage, VisioDocument } from 'ooxml-core/visio';
+import { type VisioDrawingPoint, type VisioDrawingTool } from 'ooxml-core/visio/ui';
+import type { ViewerController, ViewerState } from './controller.js';
+import type { ViewerCreationToken } from './creation-token.js';
+export interface DrawingGesture {
+    pointer: number;
+    svg: SVGSVGElement;
+    page: VisioPage;
+    document: VisioDocument;
+    start: VisioDrawingPoint;
+    kind: VisioDrawingTool;
+    token: ViewerCreationToken;
+    preview: SVGRectElement | SVGEllipseElement | SVGLineElement;
+    sourceGeneration: number;
+    selection: ViewerState['selectedShapes'];
+    zoom: number;
+    layers: ViewerState['layerVisibilityOverrides'];
+}
+/** One captured drawing intent. Core plans geometry; the DOM owns capture and a temporary frame. */
+export declare class ViewerDrawingGesture {
+    #private;
+    private readonly viewport;
+    private readonly controller;
+    private readonly options;
+    constructor(viewport: HTMLElement, controller: ViewerController, options: {
+        tool(): VisioDrawingTool | undefined;
+        finish(drag: DrawingGesture, end: VisioDrawingPoint): Promise<void>;
+        existingShape?(event: PointerEvent): boolean;
+        announce(message: string): void;
+    });
+    get drawing(): boolean;
+    current(drag: DrawingGesture): boolean;
+    render(_state: ViewerState): void;
+    wire(): () => void;
+    cancel(): void;
+}

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

@@ -0,0 +1,11 @@
+import type { ViewerController, ViewerState } from './controller.js';
+/** Source duplication availability; the controller owns the transaction and new selection. */
+export declare class ViewerDuplication {
+    private readonly root;
+    private readonly controller;
+    private readonly edit;
+    constructor(root: ShadowRoot, controller: ViewerController, edit: (run: () => Promise<void>, message: string) => void);
+    private reason;
+    run(): void;
+    render(state: ViewerState): void;
+}

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

@@ -1,7 +1,8 @@
 import type { VisioDocument, VisioEdit } from 'ooxml-core/visio';
-import type { VsdxSource } from 'ooxml-core/visio/ui';
+import type { VsdxSource, VisioShapeSelection } from 'ooxml-core/visio/ui';
 import { ViewerController } from './controller.js';
 import { type BackstagePage } from './backstage.js';
+import type { CreateVsdxOptions } from 'ooxml-core/visio';
 import { type SvgExportOptions, type SvgExportResult } from './export-svg.js';
 import { type CurrentPagePrintSnapshotOptions, type PrintSnapshot } from './print-snapshot.js';
 declare const BaseElement: typeof HTMLElement;
@@ -19,6 +20,8 @@ export declare class VisioViewerElement extends BaseElement {
     set showToolbar(value: boolean);
     get renderWarnings(): readonly string[];
     load(source: VsdxSource): Promise<void>;
+    /** Create a source-backed drawing and name only the accepted request. */
+    createBlankDrawing(options?: CreateVsdxOptions): Promise<void>;
     /** Leave Visio's File backstage and return to the drawing. */
     closeBackstage(): void;
     /** Open Visio's File backstage at a page (Info by default). */
@@ -26,6 +29,13 @@ export declare class VisioViewerElement extends BaseElement {
     /** Name of the last opened local file, or empty for bytes, models and closed drawings. */
     get fileName(): string;
     applyEdits(edits: readonly VisioEdit[]): Promise<void>;
+    selectShapes(shapes: readonly VisioShapeSelection[]): void;
+    selectAll(): void;
+    clearSelection(): void;
+    duplicateSelection(): Promise<void>;
+    copySelection(): Promise<void>;
+    cutSelection(): Promise<void>;
+    pasteSelection(): Promise<void>;
     replacePlainText(pageId: string, shapeId: string, text: string): Promise<void>;
     undo(): Promise<void>;
     redo(): Promise<void>;

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

@@ -0,0 +1,12 @@
+import type { ViewerController, ViewerState } from './controller.js';
+import type { VisioFormattingAction } from './ribbon-action.js';
+/** Selection-aware ribbon presentation; all writes go through the controller's edit worker. */
+export declare class ViewerFormatting {
+    #private;
+    private readonly root;
+    private readonly controller;
+    private readonly edit;
+    constructor(root: ShadowRoot, controller: ViewerController, edit: (run: () => Promise<void>, success: string) => void);
+    run(action: VisioFormattingAction): void;
+    render(state: ViewerState): void;
+}

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

@@ -0,0 +1,2 @@
+/** Restore only captured nodes; a replacement render owns its newly created overlays. */
+export declare function hideGestureOverlays(viewport: HTMLElement, selector: string): () => void;

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

@@ -16,4 +16,7 @@ export declare function wireHandleEvents(viewport: HTMLElement, callbacks: {
     move(event: PointerEvent): void;
     finish(event: PointerEvent): Promise<void>;
     cancel(): void;
+    /** General shape drags leave ordinary below-threshold clicks unchanged. */
+    shouldSuppressClick?(): boolean;
+    consumeClick?(): boolean;
 }): () => void;

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

@@ -1,3 +1,4 @@
+export { hasVisibleShapeContent } from 'ooxml-core/visio/ui';
 import { type VisioDocument, type VisioShape } from 'ooxml-core/visio';
 /** UI limits. Visibility semantics and shape traversal remain in ooxml-core. */
 export declare const VIEWER_LAYER_LIMITS: Readonly<{
@@ -18,5 +19,3 @@ export declare function visibleSelection(model: VisioDocument | null, pageIndex:
     readonly id: string;
     readonly pageId?: string;
 } | null, visible: WeakMap<VisioShape, boolean>): boolean;
-/** Rendering eligibility shared by selection and SVG containers; no format interpretation. */
-export declare function hasVisibleShapeContent(shape: VisioShape, visible: WeakMap<VisioShape, boolean> | undefined, cache?: WeakMap<VisioShape, boolean>): boolean;

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

@@ -0,0 +1,7 @@
+import type { VisioPage } from 'ooxml-core/visio';
+import { type VisioPagePoint } from 'ooxml-core/visio/ui';
+/** Share existing inert SVG resources; moving a preview never mutates the scene or source. */
+export declare function createMovementPreview(svg: SVGSVGElement, page: VisioPage, ids: readonly string[]): {
+    update(delta: VisioPagePoint): void;
+    dispose(): void;
+};

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

@@ -0,0 +1,5 @@
+/** File New and its shortcut share the element's source lifecycle. */
+export declare function wireNewDrawing(root: ShadowRoot, create: () => Promise<void>, busy: () => boolean, announce: (message: string) => void): {
+    run(): void;
+    dispose(): void;
+};

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

@@ -0,0 +1,6 @@
+import type { VisioPage } from 'ooxml-core/visio';
+/** Client coordinates projected into physical SVG page inches. */
+export declare function pagePoint(svg: SVGSVGElement, page: VisioPage, event: Pick<MouseEvent, 'clientX' | 'clientY'>, options?: {
+    snap?: boolean;
+    bounded?: boolean;
+}): import("ooxml-core/visio/ui").VisioDrawingPoint | undefined;

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

@@ -0,0 +1,28 @@
+export type PaintField = 'fillPattern' | 'fillBackgroundColor' | 'fillTransparency' | 'linePattern' | 'lineTransparency';
+export type PaintInput = HTMLInputElement | (HTMLElement & {
+    value: string;
+    disabled: boolean;
+    options: {
+        value: string;
+        label: string;
+        disabled?: boolean;
+    }[];
+});
+export type PaintDialog = HTMLElement & {
+    open: boolean;
+    show(): void;
+    close(): void;
+    updateComplete: Promise<boolean>;
+};
+export type PaintButton = HTMLElement & {
+    disabled: boolean;
+};
+export declare const paintFields: readonly PaintField[];
+/** Typed presentation only; the core defines native pattern and transparency semantics. */
+export declare function createPaintDialog(doc: Document): {
+    dialog: PaintDialog;
+    fields: Map<PaintField, PaintInput>;
+    error: HTMLParagraphElement;
+    apply: PaintButton;
+    cancel: PaintButton;
+};

package/dist/visio/viewer-paint-menu.d.ts

@@ -0,0 +1,4 @@
+import type { VisioShape } from 'ooxml-core/visio';
+import type { RibbonCommand } from './ribbon-parts.js';
+/** Paint menu checks use source property state; mixed selections have no checked choice. */
+export declare function renderPaintMenus(root: ShadowRoot, shapes: readonly VisioShape[], reason: string, set: (element: RibbonCommand | null, reason: string) => void): void;

package/dist/visio/viewer-paint-properties.d.ts

@@ -0,0 +1,13 @@
+import type { ViewerController, ViewerState } from './controller.js';
+/** Stable selection draft; one changed-fields-only worker transaction commits the dialog. */
+export declare class ViewerPaintProperties {
+    #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-pointer-gestures.d.ts

@@ -0,0 +1,14 @@
+import type { ViewerController, ViewerState } from './controller.js';
+/** Direct pointer movement and full-enclosure marquee; release is the only source edit. */
+export declare class ViewerPointerGestures {
+    #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-replace-status.d.ts

@@ -0,0 +1,6 @@
+import type { VisioTextOccurrence } from 'ooxml-core/visio/ui';
+import type { ViewerState } from './controller.js';
+import type { FindBar } from './viewer-search.js';
+export declare const sameTextOccurrence: (a: VisioTextOccurrence, b: VisioTextOccurrence) => boolean;
+/** Occurrence status is presentation only; the controller and core own all matching. */
+export declare function renderReplaceStatus(bar: FindBar, state: ViewerState, matches: readonly VisioTextOccurrence[], current: VisioTextOccurrence | undefined, pending: boolean, summary: string): void;

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

@@ -0,0 +1,14 @@
+import type { ViewerController, ViewerState } from './controller.js';
+import { type FindBar } from './viewer-search.js';
+/** Literal occurrence draft. Controller tokens retain scope through owned result navigation. */
+export declare class ViewerReplace {
+    #private;
+    private readonly bar;
+    private readonly controller;
+    private readonly announce;
+    constructor(bar: FindBar, controller: ViewerController, announce: (message: string) => void);
+    wire(): () => void;
+    showReplace(): void;
+    showFind(): void;
+    render(state: ViewerState): void;
+}

package/dist/visio/viewer-resize-frame.d.ts

@@ -0,0 +1,9 @@
+import type { VisioPage, VisioShape } from 'ooxml-core/visio';
+import { type VisioResizeFrame } from 'ooxml-core/visio/ui';
+/** A bounds preview, leaving the saved shape content visible until source acceptance. */
+export declare function createResizeFrame(svg: SVGSVGElement, page: VisioPage, shape: VisioShape, scale: number): {
+    element: SVGGElement;
+    rectangle: SVGRectElement;
+    update: (frame: VisioResizeFrame) => void;
+    dispose: () => void;
+};

package/dist/visio/viewer-resize-handles.d.ts

@@ -0,0 +1,14 @@
+import type { ViewerController, ViewerState } from './controller.js';
+/** Eight source-backed single-selection handles; saved content is never speculatively resized. */
+export declare class ViewerResizeHandles {
+    #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-search.d.ts

@@ -4,6 +4,21 @@ export type FindBar = HTMLElement & {
     value: string;
     status: string;
     statusTitle: string;
+    replaceMode: boolean;
+    replacement: string;
+    replacementMaxlength: number;
+    scope: string;
+    scopeOptions: {
+        value: string;
+        label: string;
+        disabled?: boolean;
+    }[];
+    matchCase: boolean;
+    matchCaseDisabled: boolean;
+    replaceDisabled: boolean;
+    replaceAllDisabled: boolean;
+    error: string;
+    updateComplete: Promise<boolean>;
     show(): void;
     close(): void;
 };

package/dist/visio/viewer-size-position.d.ts

@@ -0,0 +1,13 @@
+import type { ViewerController, ViewerState } from './controller.js';
+/** Static presentation only; source quantities and edit conversion belong to core. */
+export declare function createSizePosition(doc: Document): HTMLElement;
+/** One committed numeric field creates one strict selection transaction. */
+export declare class ViewerSizePosition {
+    #private;
+    private readonly controller;
+    private readonly checked;
+    constructor(root: ShadowRoot, controller: ViewerController, checked: (open: boolean) => void);
+    toggle(open?: boolean): void;
+    wire(): () => void;
+    render(state: ViewerState): void;
+}

package/dist/visio/viewer-text-draft.d.ts

@@ -0,0 +1,9 @@
+import type { VisioDrawingBounds } from 'ooxml-core/visio/ui';
+/** Plain browser input, separate from the saved SVG text and its layout. */
+export declare function createTextDraft(viewport: HTMLElement, svg: SVGSVGElement, bounds: VisioDrawingBounds, apply: () => void, cancel: () => void): {
+    element: HTMLElement;
+    input: HTMLTextAreaElement;
+    error: HTMLParagraphElement;
+    setBusy(busy: boolean): void;
+    dispose(): void;
+};

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

@@ -0,0 +1,17 @@
+import type { ViewerController, ViewerState } from './controller.js';
+/** Fixed-size plain-text boxes. Native automatic sizing and rich content editing are separate. */
+export declare class ViewerTextTool {
+    #private;
+    private readonly viewport;
+    private readonly controller;
+    private readonly options;
+    constructor(viewport: HTMLElement, controller: ViewerController, options: {
+        active(): boolean;
+        announce(message: string): void;
+        revealEdit(): void;
+    });
+    get drafting(): boolean;
+    wire(): () => void;
+    render(state: ViewerState): void;
+    cancel(): void;
+}

package/dist/visio/worker-clipboard.d.ts

@@ -0,0 +1,16 @@
+export interface ClipboardCaptureRequest {
+    bytes: ArrayBuffer;
+    pageId: string;
+    shapeIds: readonly string[];
+}
+export interface ClipboardWorkerLike {
+    onmessage: ((event: MessageEvent) => void) | null;
+    onerror: ((event: ErrorEvent) => void) | null;
+    postMessage(message: ClipboardCaptureRequest, transfer: Transferable[]): void;
+    terminate(): void;
+}
+export type CancellableClipboardCapture = ((bytes: Uint8Array, pageId: string, shapeIds: readonly string[]) => Promise<string>) & {
+    cancel?: () => void;
+};
+/** Isolated source capture with an owned input, bounded response and cancellable lifetime. */
+export declare function createWorkerClipboardCapture(factory?: () => ClipboardWorkerLike, timeoutMs?: number): CancellableClipboardCapture;