ts-visio 1.1.0 → 1.3.0

package/README.md

@@ -8,18 +8,24 @@
 A Node.js library to strict-type interact with Visio (`.vsdx`) files.
 Built using specific schema-level abstractions to handle the complex internal structure of Visio documents (ShapeSheets, Pages, Masters).
 
-> **Status**: Work In Progress (TDD).
-
 ## Features
 
-- **Read VSDX**: Open and parse `.vsdx` files (zippped XML).
+- **Read VSDX**: Open and parse `.vsdx` files (zipped XML).
 - **Strict Typing**: Interact with `VisioPage`, `VisioShape`, and `VisioConnect` objects.
 - **ShapeSheet Access**: Read `Cells`, `Rows`, and `Sections` directly.
 - **Connections**: Analyze connectivity between shapes.
 - **Modular Architecture**: Use specialized components for loading, page management, shape reading, and modification.
 - **Modify Content**: Update text content of shapes.
-- **Create Shapes**: Add new rectangular shapes with text to pages.
-- **Connect Shapes**: Create dynamic connectors between shapes.
+- **Create Shapes**: Rectangles, ellipses, diamonds, rounded rectangles, triangles, parallelograms.
+- **Connect Shapes**: Dynamic connectors with arrow styles, line styling, and routing (straight / orthogonal / curved).
+- **Text Styling**: Font size, font family, bold, color, horizontal/vertical alignment.
+- **Shape Transformations**: Rotate, flip (X/Y), and resize shapes via a fluent API.
+- **Deletion**: Remove shapes and pages cleanly (including orphaned connectors and relationships).
+- **Lookup API**: Find shapes by ID, predicate, or look up pages by name.
+- **Read-Back API**: Read custom properties, hyperlinks, and layer assignments from existing shapes.
+- **Page Size & Orientation**: Set canvas dimensions with named sizes (`Letter`, `A4`, …) or raw inches; rotate between portrait and landscape.
+
+Feature gaps are being tracked in [FEATURES.md](./FEATURES.md).
 
 ## Installation
 
@@ -63,9 +69,13 @@ const shape = await page.addShape({
     y: 1,
     width: 3,
     height: 1,
-    fillColor: "#ff0000", // Option hexadecimal fill color
+    fillColor: "#ff0000",   // Hex fill color
     fontColor: "#ffffff",
-    bold: true
+    bold: true,
+    fontSize: 14,           // Points
+    fontFamily: "Segoe UI",
+    horzAlign: "center",    // "left" | "center" | "right" | "justify"
+    verticalAlign: "middle" // "top" | "middle" | "bottom"
 });
 
 // Modify text
@@ -345,6 +355,141 @@ await lane1.addMember(startShape);
 await lane2.addMember(serverShape);
 ```
 
+#### 19. Shape Transformations
+Rotate, flip, and resize shapes using a fluent API.
+
+```typescript
+const shape = await page.addShape({ text: "Widget", x: 3, y: 3, width: 2, height: 1 });
+
+// Rotate 45 degrees (clockwise)
+await shape.rotate(45);
+console.log(shape.angle); // 45
+
+// Mirror horizontally or vertically
+await shape.flipX();
+await shape.flipY(false); // un-flip
+
+// Resize (keeps the pin point centred)
+await shape.resize(4, 2);
+console.log(shape.width, shape.height); // 4, 2
+
+// Chainable
+await shape.rotate(90).then(s => s.resize(3, 1));
+```
+
+#### 20. Deleting Shapes and Pages
+Remove shapes or entire pages. Orphaned connectors and relationships are cleaned up automatically.
+
+```typescript
+// Delete a shape
+await shape.delete();
+
+// Delete a page (removes page file, rels, and all back-page references)
+await doc.deletePage(page2);
+```
+
+#### 21. Lookup API
+Find shapes and pages without iterating manually.
+
+```typescript
+// Find a shape by its numeric ID (searches nested groups too)
+const target = await page.getShapeById("42");
+
+// Find all shapes matching a predicate
+const servers = await page.findShapes(s => s.text.startsWith("Server"));
+
+// Look up a page by name (exact, case-sensitive)
+const detailPage = doc.getPage("Architecture Diagram");
+```
+
+#### 22. Reading Shape Data Back
+Retrieve custom properties, hyperlinks, and layer assignments that were previously written.
+
+```typescript
+// Custom properties (shape data)
+const props = shape.getProperties();
+console.log(props["IP"].value);    // "192.168.1.10"
+console.log(props["Port"].type);   // VisioPropType.Number
+
+// Hyperlinks
+const links = shape.getHyperlinks();
+// [ { address: "https://example.com", description: "Docs", newWindow: false } ]
+
+// Layer indices
+const indices = shape.getLayerIndices(); // e.g. [0, 2]
+```
+
+#### 23. Non-Rectangular Geometry
+Use the `geometry` prop on `addShape()` to create common flowchart primitives without touching XML.
+
+```typescript
+// Ellipse / circle
+await page.addShape({ text: "Start", x: 1, y: 5, width: 2, height: 2, geometry: 'ellipse' });
+
+// Decision diamond
+await page.addShape({ text: "Yes?", x: 4, y: 5, width: 2, height: 2, geometry: 'diamond' });
+
+// Rounded rectangle (optional corner radius in inches)
+await page.addShape({ text: "Process", x: 7, y: 5, width: 3, height: 2,
+    geometry: 'rounded-rectangle', cornerRadius: 0.2 });
+
+// Right-pointing triangle
+await page.addShape({ text: "Extract", x: 1, y: 2, width: 2, height: 2, geometry: 'triangle' });
+
+// Parallelogram (Data / IO shape)
+await page.addShape({ text: "Input", x: 4, y: 2, width: 3, height: 1.5, geometry: 'parallelogram' });
+```
+
+Supported values: `'rectangle'` (default), `'ellipse'`, `'diamond'`, `'rounded-rectangle'`, `'triangle'`, `'parallelogram'`.
+
+#### 24. Connector Styling
+Control line appearance and routing algorithm on any connector.
+
+```typescript
+import { ArrowHeads } from 'ts-visio/utils/StyleHelpers';
+
+// Styled connector with crow's foot arrow and custom line
+await shape1.connectTo(shape2, ArrowHeads.One, ArrowHeads.CrowsFoot, {
+    lineColor: '#cc0000',   // Hex stroke color
+    lineWeight: 1.5,        // Stroke width in points
+    linePattern: 2,         // 1=solid, 2=dash, 3=dot, 4=dash-dot
+    routing: 'curved',      // 'straight' | 'orthogonal' (default) | 'curved'
+});
+
+// Via page.connectShapes()
+await page.connectShapes(a, b, undefined, undefined, { routing: 'straight' });
+```
+
+#### 25. Page Size & Orientation
+Control the canvas dimensions using named paper sizes or raw inch values.
+
+```typescript
+import { PageSizes } from 'ts-visio';
+
+// Use a named paper size (portrait by default)
+page.setNamedSize('A4');                     // 8.268" × 11.693"
+page.setNamedSize('Letter', 'landscape');   // 11" × 8.5"
+
+// Set arbitrary dimensions in inches
+page.setSize(13.33, 7.5);    // 13.33" × 7.5" widescreen
+
+// Rotate the existing canvas without changing the paper size
+page.setOrientation('landscape');  // swaps width and height if needed
+page.setOrientation('portrait');
+
+// Read current dimensions
+console.log(page.pageWidth);    // e.g. 11
+console.log(page.pageHeight);   // e.g. 8.5
+console.log(page.orientation);  // 'landscape' | 'portrait'
+
+// All size methods are chainable
+page.setNamedSize('A3').setOrientation('landscape');
+```
+
+Available named sizes in `PageSizes`: `Letter`, `Legal`, `Tabloid`, `A3`, `A4`, `A5`.
+
+---
+
 ## Examples
 
 Check out the [examples](./examples) directory for complete scripts.

package/dist/Page.d.ts

@@ -1,4 +1,4 @@
-import { VisioPage } from './types/VisioTypes';
+import { VisioPage, ConnectorStyle, PageOrientation, PageSizeName } from './types/VisioTypes';
 import { VisioPackage } from './VisioPackage';
 import { ShapeModifier } from './ShapeModifier';
 import { NewShapeProps } from './types/VisioTypes';
@@ -17,9 +17,40 @@ export declare class Page {
     constructor(internalPage: VisioPage, pkg: VisioPackage, media?: MediaManager, rels?: RelsManager, modifier?: ShapeModifier);
     get id(): string;
     get name(): string;
+    /** Width of the page canvas in inches. */
+    get pageWidth(): number;
+    /** Height of the page canvas in inches. */
+    get pageHeight(): number;
+    /** Current page orientation derived from the canvas dimensions. */
+    get orientation(): PageOrientation;
+    /**
+     * Set the page canvas size in inches.
+     * @example page.setSize(11, 8.5)  // landscape letter
+     */
+    setSize(width: number, height: number): this;
+    /**
+     * Convenience: change the page to a named standard size (portrait by default).
+     * @example page.setNamedSize('A4')
+     */
+    setNamedSize(sizeName: PageSizeName, orientation?: PageOrientation): this;
+    /**
+     * Rotate the canvas between portrait and landscape without changing the paper size.
+     * Swaps width and height when the current orientation does not match the requested one.
+     */
+    setOrientation(orientation: PageOrientation): this;
     getShapes(): Shape[];
+    /**
+     * Find a shape by its ID anywhere on the page, including shapes nested inside groups.
+     * Returns undefined if no shape with that ID exists.
+     */
+    getShapeById(id: string): Shape | undefined;
+    /**
+     * Return all shapes on the page (including nested group children) that satisfy
+     * the predicate. Equivalent to getAllShapes().filter(predicate).
+     */
+    findShapes(predicate: (shape: Shape) => boolean): Shape[];
     addShape(props: NewShapeProps, parentId?: string): Promise<Shape>;
-    connectShapes(fromShape: Shape, toShape: Shape, beginArrow?: string, endArrow?: string): Promise<void>;
+    connectShapes(fromShape: Shape, toShape: Shape, beginArrow?: string, endArrow?: string, style?: ConnectorStyle): Promise<void>;
     addImage(data: Buffer, name: string, x: number, y: number, width: number, height: number): Promise<Shape>;
     addContainer(props: NewShapeProps): Promise<Shape>;
     addList(props: NewShapeProps, direction?: 'vertical' | 'horizontal'): Promise<Shape>;

package/dist/Page.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Page = void 0;
+const VisioTypes_1 = require("./types/VisioTypes");
 const ShapeReader_1 = require("./ShapeReader");
 const ShapeModifier_1 = require("./ShapeModifier");
 const Shape_1 = require("./Shape");
@@ -26,6 +27,51 @@ class Page {
     get name() {
         return this.internalPage.Name;
     }
+    /** Width of the page canvas in inches. */
+    get pageWidth() {
+        return this.modifier.getPageDimensions(this.id).width;
+    }
+    /** Height of the page canvas in inches. */
+    get pageHeight() {
+        return this.modifier.getPageDimensions(this.id).height;
+    }
+    /** Current page orientation derived from the canvas dimensions. */
+    get orientation() {
+        return this.pageWidth > this.pageHeight ? 'landscape' : 'portrait';
+    }
+    /**
+     * Set the page canvas size in inches.
+     * @example page.setSize(11, 8.5)  // landscape letter
+     */
+    setSize(width, height) {
+        this.modifier.setPageSize(this.id, width, height);
+        return this;
+    }
+    /**
+     * Convenience: change the page to a named standard size (portrait by default).
+     * @example page.setNamedSize('A4')
+     */
+    setNamedSize(sizeName, orientation = 'portrait') {
+        const { width, height } = VisioTypes_1.PageSizes[sizeName];
+        return orientation === 'landscape'
+            ? this.setSize(height, width)
+            : this.setSize(width, height);
+    }
+    /**
+     * Rotate the canvas between portrait and landscape without changing the paper size.
+     * Swaps width and height when the current orientation does not match the requested one.
+     */
+    setOrientation(orientation) {
+        const w = this.pageWidth;
+        const h = this.pageHeight;
+        if (orientation === 'landscape' && h > w) {
+            this.modifier.setPageSize(this.id, h, w);
+        }
+        else if (orientation === 'portrait' && w > h) {
+            this.modifier.setPageSize(this.id, h, w);
+        }
+        return this;
+    }
     getShapes() {
         const reader = new ShapeReader_1.ShapeReader(this.pkg);
         try {
@@ -33,11 +79,32 @@ class Page {
             return internalShapes.map(s => new Shape_1.Shape(s, this.id, this.pkg, this.modifier));
         }
         catch (e) {
-            // If page file doesn't exist or is empty, return empty array
             console.warn(`Could not read shapes for page ${this.id}:`, e);
             return [];
         }
     }
+    /**
+     * Find a shape by its ID anywhere on the page, including shapes nested inside groups.
+     * Returns undefined if no shape with that ID exists.
+     */
+    getShapeById(id) {
+        const reader = new ShapeReader_1.ShapeReader(this.pkg);
+        const internal = reader.readShapeById(this.pagePath, id);
+        if (!internal)
+            return undefined;
+        return new Shape_1.Shape(internal, this.id, this.pkg, this.modifier);
+    }
+    /**
+     * Return all shapes on the page (including nested group children) that satisfy
+     * the predicate. Equivalent to getAllShapes().filter(predicate).
+     */
+    findShapes(predicate) {
+        const reader = new ShapeReader_1.ShapeReader(this.pkg);
+        const all = reader.readAllShapes(this.pagePath);
+        return all
+            .map(s => new Shape_1.Shape(s, this.id, this.pkg, this.modifier))
+            .filter(predicate);
+    }
     async addShape(props, parentId) {
         const newId = await this.modifier.addShape(this.id, props, parentId);
         // Return a fresh Shape object representing the new shape
@@ -57,8 +124,8 @@ class Page {
         });
         return new Shape_1.Shape(internalStub, this.id, this.pkg, this.modifier);
     }
-    async connectShapes(fromShape, toShape, beginArrow, endArrow) {
-        await this.modifier.addConnector(this.id, fromShape.id, toShape.id, beginArrow, endArrow);
+    async connectShapes(fromShape, toShape, beginArrow, endArrow, style) {
+        await this.modifier.addConnector(this.id, fromShape.id, toShape.id, beginArrow, endArrow, style);
     }
     async addImage(data, name, x, y, width, height) {
         // 1. Upload Media

package/dist/Shape.d.ts

@@ -1,4 +1,4 @@
-import { VisioShape } from './types/VisioTypes';
+import { VisioShape, ConnectorStyle } from './types/VisioTypes';
 import { VisioPackage } from './VisioPackage';
 import { ShapeModifier, ShapeStyle } from './ShapeModifier';
 import { VisioPropType } from './types/VisioTypes';
@@ -9,6 +9,12 @@ export interface ShapeData {
     hidden?: boolean;
     type?: VisioPropType;
 }
+export interface ShapeHyperlink {
+    address?: string;
+    subAddress?: string;
+    description?: string;
+    newWindow: boolean;
+}
 export declare class Shape {
     private internalShape;
     private pageId;
@@ -23,7 +29,8 @@ export declare class Shape {
     get height(): number;
     get x(): number;
     get y(): number;
-    connectTo(targetShape: Shape, beginArrow?: string, endArrow?: string): Promise<this>;
+    delete(): Promise<void>;
+    connectTo(targetShape: Shape, beginArrow?: string, endArrow?: string, style?: ConnectorStyle): Promise<this>;
     setStyle(style: ShapeStyle): Promise<this>;
     placeRightOf(targetShape: Shape, options?: {
         gap: number;
@@ -37,6 +44,41 @@ export declare class Shape {
     }): this;
     setPropertyValue(name: string, value: string | number | boolean | Date): this;
     addData(key: string, data: ShapeData): this;
+    /**
+     * Read back all custom property (shape data) entries written to this shape.
+     * Returns a map of property key → ShapeData. Values are coerced to the
+     * declared Visio type (Number, Boolean, Date, or String).
+     */
+    getProperties(): Record<string, ShapeData>;
+    /**
+     * Read back all hyperlinks attached to this shape.
+     */
+    getHyperlinks(): ShapeHyperlink[];
+    /**
+     * Read back the layer indices this shape is assigned to.
+     * Returns an empty array if the shape has no layer assignment.
+     */
+    getLayerIndices(): number[];
+    /** Current rotation angle in degrees (0 if no Angle cell is set). */
+    get angle(): number;
+    /**
+     * Rotate the shape to an absolute angle (degrees, clockwise).
+     * Replaces any existing rotation.
+     */
+    rotate(degrees: number): Promise<this>;
+    /**
+     * Resize the shape to the given width and height (in inches).
+     * Updates LocPinX/LocPinY to keep the centre-pin at width/2, height/2.
+     */
+    resize(width: number, height: number): Promise<this>;
+    /**
+     * Flip the shape horizontally. Pass `false` to un-flip.
+     */
+    flipX(enabled?: boolean): Promise<this>;
+    /**
+     * Flip the shape vertically. Pass `false` to un-flip.
+     */
+    flipY(enabled?: boolean): Promise<this>;
     addMember(memberShape: Shape): Promise<this>;
     addListItem(item: Shape): Promise<this>;
     resizeToFit(padding?: number): Promise<this>;
@@ -67,4 +109,5 @@ export declare class Shape {
      */
     addToLayer(layer: Layer | number): Promise<this>;
     private setLocalCoord;
+    private setLocalRawCell;
 }

package/dist/Shape.js

@@ -39,8 +39,11 @@ class Shape {
     get y() {
         return this.internalShape.Cells['PinY'] ? Number(this.internalShape.Cells['PinY'].V) : 0;
     }
-    async connectTo(targetShape, beginArrow, endArrow) {
-        await this.modifier.addConnector(this.pageId, this.id, targetShape.id, beginArrow, endArrow);
+    async delete() {
+        await this.modifier.deleteShape(this.pageId, this.id);
+    }
+    async connectTo(targetShape, beginArrow, endArrow, style) {
+        await this.modifier.addConnector(this.pageId, this.id, targetShape.id, beginArrow, endArrow, style);
         return this;
     }
     async setStyle(style) {
@@ -96,6 +99,72 @@ class Shape {
         this.setPropertyValue(key, data.value);
         return this;
     }
+    /**
+     * Read back all custom property (shape data) entries written to this shape.
+     * Returns a map of property key → ShapeData. Values are coerced to the
+     * declared Visio type (Number, Boolean, Date, or String).
+     */
+    getProperties() {
+        return this.modifier.getShapeProperties(this.pageId, this.id);
+    }
+    /**
+     * Read back all hyperlinks attached to this shape.
+     */
+    getHyperlinks() {
+        return this.modifier.getShapeHyperlinks(this.pageId, this.id);
+    }
+    /**
+     * Read back the layer indices this shape is assigned to.
+     * Returns an empty array if the shape has no layer assignment.
+     */
+    getLayerIndices() {
+        return this.modifier.getShapeLayerIndices(this.pageId, this.id);
+    }
+    /** Current rotation angle in degrees (0 if no Angle cell is set). */
+    get angle() {
+        const cell = this.internalShape.Cells['Angle'];
+        return cell ? (parseFloat(cell.V) * 180) / Math.PI : 0;
+    }
+    /**
+     * Rotate the shape to an absolute angle (degrees, clockwise).
+     * Replaces any existing rotation.
+     */
+    async rotate(degrees) {
+        await this.modifier.rotateShape(this.pageId, this.id, degrees);
+        const radians = (degrees * Math.PI) / 180;
+        this.setLocalCoord('Angle', radians);
+        return this;
+    }
+    /**
+     * Resize the shape to the given width and height (in inches).
+     * Updates LocPinX/LocPinY to keep the centre-pin at width/2, height/2.
+     */
+    async resize(width, height) {
+        if (width <= 0 || height <= 0)
+            throw new Error('Shape dimensions must be positive');
+        await this.modifier.resizeShape(this.pageId, this.id, width, height);
+        this.setLocalCoord('Width', width);
+        this.setLocalCoord('Height', height);
+        this.setLocalCoord('LocPinX', width / 2);
+        this.setLocalCoord('LocPinY', height / 2);
+        return this;
+    }
+    /**
+     * Flip the shape horizontally. Pass `false` to un-flip.
+     */
+    async flipX(enabled = true) {
+        this.modifier.setShapeFlip(this.pageId, this.id, 'x', enabled);
+        this.setLocalRawCell('FlipX', enabled ? '1' : '0');
+        return this;
+    }
+    /**
+     * Flip the shape vertically. Pass `false` to un-flip.
+     */
+    async flipY(enabled = true) {
+        this.modifier.setShapeFlip(this.pageId, this.id, 'y', enabled);
+        this.setLocalRawCell('FlipY', enabled ? '1' : '0');
+        return this;
+    }
     async addMember(memberShape) {
         await this.modifier.addRelationship(this.pageId, this.id, memberShape.id, 'Container');
         return this;
@@ -165,5 +234,11 @@ class Shape {
         else
             this.internalShape.Cells[name] = { V: v, N: name };
     }
+    setLocalRawCell(name, value) {
+        if (this.internalShape.Cells[name])
+            this.internalShape.Cells[name].V = value;
+        else
+            this.internalShape.Cells[name] = { V: value, N: name };
+    }
 }
 exports.Shape = Shape;

package/dist/ShapeModifier.d.ts

@@ -1,5 +1,7 @@
 import { VisioPackage } from './VisioPackage';
-import { NewShapeProps } from './types/VisioTypes';
+import { HorzAlign, VertAlign } from './utils/StyleHelpers';
+import { NewShapeProps, ConnectorStyle } from './types/VisioTypes';
+import type { ShapeData, ShapeHyperlink } from './Shape';
 export declare class ShapeModifier {
     private pkg;
     addContainer(pageId: string, props: NewShapeProps): Promise<string>;
@@ -29,11 +31,30 @@ export declare class ShapeModifier {
     private saveParsed;
     private performSave;
     flush(): void;
-    addConnector(pageId: string, fromShapeId: string, toShapeId: string, beginArrow?: string, endArrow?: string): Promise<string>;
+    addConnector(pageId: string, fromShapeId: string, toShapeId: string, beginArrow?: string, endArrow?: string, style?: ConnectorStyle): 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;
@@ -67,9 +88,45 @@ 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>;
+    /**
+     * Set the page canvas size. Writes PageWidth / PageHeight into the PageSheet
+     * and sets DrawingSizeType=0 (Custom) so Visio does not override the values.
+     */
+    setPageSize(pageId: string, width: number, height: number): void;
+    /**
+     * Read the current page canvas dimensions.
+     * Returns 8.5 × 11 (US Letter) if no PageSheet cells are present.
+     */
+    getPageDimensions(pageId: string): {
+        width: number;
+        height: number;
+    };
+    /**
+     * 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;
 }