ts-visio 1.0.2 → 1.2.0

package/dist/ShapeModifier.d.ts

@@ -1,5 +1,7 @@
 import { VisioPackage } from './VisioPackage';
+import { HorzAlign, VertAlign } from './utils/StyleHelpers';
 import { NewShapeProps } from './types/VisioTypes';
+import type { ShapeData, ShapeHyperlink } from './Shape';
 export declare class ShapeModifier {
     private pkg;
     addContainer(pageId: string, props: NewShapeProps): Promise<string>;
@@ -9,9 +11,18 @@ export declare class ShapeModifier {
     private relsManager;
     private pageCache;
     private dirtyPages;
+    private shapeCache;
+    private pagePathRegistry;
     autoSave: boolean;
+    /**
+     * Register the resolved OPC part path for a page ID.
+     * Must be called before any operation on a loaded file to ensure the
+     * correct file is targeted rather than the ID-derived fallback name.
+     */
+    registerPage(pageId: string, xmlPath: string): void;
     constructor(pkg: VisioPackage);
     private getPagePath;
+    private getShapeMap;
     private getAllShapes;
     private getNextId;
     private ensurePageSheet;
@@ -22,9 +33,28 @@ export declare class ShapeModifier {
     flush(): void;
     addConnector(pageId: string, fromShapeId: string, toShapeId: string, beginArrow?: string, endArrow?: string): Promise<string>;
     addShape(pageId: string, props: NewShapeProps, parentId?: string): Promise<string>;
+    deleteShape(pageId: string, shapeId: string): Promise<void>;
+    private removeShapeFromTree;
     updateShapeText(pageId: string, shapeId: string, newText: string): Promise<void>;
     updateShapeStyle(pageId: string, shapeId: string, style: ShapeStyle): Promise<void>;
     updateShapeDimensions(pageId: string, shapeId: string, w: number, h: number): Promise<void>;
+    /**
+     * Set the rotation angle of a shape. Degrees are converted to radians
+     * for storage in the Angle cell (Visio's native unit).
+     */
+    rotateShape(pageId: string, shapeId: string, degrees: number): Promise<void>;
+    /**
+     * Set the flip state for a shape along the X or Y axis.
+     * FlipX mirrors left-to-right; FlipY mirrors top-to-bottom.
+     */
+    setShapeFlip(pageId: string, shapeId: string, axis: 'x' | 'y', enabled: boolean): void;
+    /**
+     * Resize a shape, keeping it centred on its current PinX/PinY.
+     * Updates Width, Height, LocPinX, LocPinY, and the cached @_V on any
+     * Geometry cells whose @_F formula references Width or Height, so that
+     * non-Visio renderers see consistent values.
+     */
+    resizeShape(pageId: string, shapeId: string, width: number, height: number): Promise<void>;
     updateShapePosition(pageId: string, shapeId: string, x: number, y: number): Promise<void>;
     addPropertyDefinition(pageId: string, shapeId: string, name: string, type: number, options?: {
         label?: string;
@@ -58,9 +88,32 @@ export declare class ShapeModifier {
     }>;
     assignLayer(pageId: string, shapeId: string, layerIndex: number): Promise<void>;
     updateLayerProperty(pageId: string, layerIndex: number, propName: string, value: string): Promise<void>;
+    /**
+     * Read back all custom property (shape data) entries for a shape.
+     * Returns a map of property key → ShapeData, with values coerced to
+     * the declared type (Number, Boolean, Date, or String).
+     */
+    getShapeProperties(pageId: string, shapeId: string): Record<string, ShapeData>;
+    /**
+     * Read back all hyperlinks attached to a shape.
+     */
+    getShapeHyperlinks(pageId: string, shapeId: string): ShapeHyperlink[];
+    /**
+     * Read back the layer indices a shape is assigned to.
+     * Returns an empty array if the shape has no layer assignment.
+     */
+    getShapeLayerIndices(pageId: string, shapeId: string): number[];
 }
 export interface ShapeStyle {
     fillColor?: string;
     fontColor?: string;
     bold?: boolean;
+    /** Font size in points (e.g. 14 for 14pt). */
+    fontSize?: number;
+    /** Font family name (e.g. "Arial"). */
+    fontFamily?: string;
+    /** Horizontal text alignment. */
+    horzAlign?: HorzAlign;
+    /** Vertical text alignment. */
+    verticalAlign?: VertAlign;
 }