ts-visio 1.10.0 → 1.13.0

package/README.md

@@ -28,6 +28,8 @@ Built using specific schema-level abstractions to handle the complex internal st
 - **Named Connection Points**: Define specific ports on shapes (`Top`, `Right`, etc.) and connect to them precisely using `fromPort`/`toPort` on any connector API.
 - **StyleSheets**: Create document-level named styles with fill, line, and text properties via `doc.createStyle()` and apply them to shapes at creation time (`styleId`) or post-creation (`shape.applyStyle()`).
 - **Color Palette**: Register named colors in the document's color table via `doc.addColor()` and look them up by index or hex value with `doc.getColors()` / `doc.getColorIndex()`.
+- **Read Layers Back**: Enumerate existing layers from loaded files via `page.getLayers()`; delete a layer with `layer.delete()`, rename with `layer.rename()`, and read `layer.visible` / `layer.locked` state.
+- **Group Traversal**: Access nested child shapes via `shape.getChildren()`, check `shape.isGroup`, and read `shape.type`.
 
 Feature gaps are being tracked in [FEATURES.md](./FEATURES.md).
 
@@ -316,12 +318,12 @@ await shape.toUrl('https://google.com')
 ```
 
 #### 17. Layers
-Organize complex diagrams with layers. Control visibility and locking programmatically.
+Organize complex diagrams with layers. Control visibility and locking programmatically, and read layers back from loaded files.
 
 ```typescript
 // 1. Define Layers
-const wireframe = await page.addLayer('Wireframe');
-const annotations = await page.addLayer('Annotations');
+const wireframe   = await page.addLayer('Wireframe');
+const annotations = await page.addLayer('Annotations', { visible: false });
 
 // 2. Assign Shapes to Layers
 await shape.addToLayer(wireframe);
@@ -333,6 +335,21 @@ await annotations.show();  // Show again
 
 // 4. Lock Layer
 await wireframe.setLocked(true);
+
+// 5. Read all layers back (works on loaded files too)
+const layers = page.getLayers();
+// [ { name: 'Wireframe', index: 0, visible: true, locked: true },
+//   { name: 'Annotations', index: 1, visible: true, locked: false } ]
+
+for (const layer of layers) {
+    console.log(layer.name, layer.visible, layer.locked);
+}
+
+// 6. Rename a layer
+await wireframe.rename('Structural');
+
+// 7. Delete a layer (cleans up shape assignments automatically)
+await annotations.delete();
 ```
 
 #### 18. Cross-Functional Flowcharts (Swimlanes)
@@ -728,6 +745,52 @@ Built-in colors: IX 0 = `#000000` (black), IX 1 = `#FFFFFF` (white). User colors
 
 ---
 
+#### 32. Group Traversal (`shape.getChildren()`)
+Access nested child shapes of a group without touching XML. Only **direct** children are returned — call `getChildren()` recursively to walk a deeper tree.
+
+```typescript
+// 1. Create a group with children
+const group = await page.addShape({
+    text: 'Container', x: 5, y: 5, width: 6, height: 6, type: 'Group'
+});
+const childA = await page.addShape({ text: 'A', x: 1, y: 1, width: 2, height: 1 }, group.id);
+const childB = await page.addShape({ text: 'B', x: 1, y: 3, width: 2, height: 1 }, group.id);
+
+// 2. Check if a shape is a group
+console.log(group.isGroup);   // true
+console.log(childA.isGroup);  // false
+console.log(group.type);      // 'Group'
+
+// 3. Get direct children
+const children = group.getChildren();
+// → [Shape('A'), Shape('B')]
+
+for (const child of children) {
+    console.log(child.text, child.id);
+}
+
+// 4. Recursively walk a nested tree
+function walk(shape, depth = 0) {
+    console.log(' '.repeat(depth * 2) + shape.text);
+    for (const child of shape.getChildren()) {
+        walk(child, depth + 1);
+    }
+}
+walk(group);
+
+// 5. Works on shapes loaded from an existing .vsdx file
+const doc2   = await VisioDocument.load('existing.vsdx');
+const shapes = doc2.pages[0].getShapes();
+const groups = shapes.filter(s => s.isGroup);
+for (const g of groups) {
+    console.log(`Group "${g.text}" has ${g.getChildren().length} children`);
+}
+```
+
+`getChildren()` returns `[]` for non-group shapes. Children are full `Shape` instances — all existing methods (`setStyle()`, `getProperties()`, `delete()`, etc.) work on them.
+
+---
+
 ## Examples
 
 Check out the [examples](./examples) directory for complete scripts.

package/dist/Layer.d.ts

@@ -5,10 +5,25 @@ export declare class Layer {
     index: number;
     private pageId?;
     private pkg?;
+    private _visible;
+    private _locked;
     private modifier;
-    constructor(name: string, index: number, pageId?: string | undefined, pkg?: VisioPackage | undefined, modifier?: ShapeModifier);
+    constructor(name: string, index: number, pageId?: string | undefined, pkg?: VisioPackage | undefined, modifier?: ShapeModifier, _visible?: boolean, _locked?: boolean);
+    /** Whether the layer is currently visible. */
+    get visible(): boolean;
+    /** Whether the layer is currently locked. */
+    get locked(): boolean;
     setVisible(visible: boolean): Promise<this>;
     setLocked(locked: boolean): Promise<this>;
     hide(): Promise<this>;
     show(): Promise<this>;
+    /**
+     * Rename this layer.
+     */
+    rename(newName: string): Promise<this>;
+    /**
+     * Delete this layer from the page.
+     * Removes the layer definition and strips it from all shape LayerMember cells.
+     */
+    delete(): Promise<void>;
 }

package/dist/Layer.js

@@ -3,18 +3,29 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Layer = void 0;
 const ShapeModifier_1 = require("./ShapeModifier");
 class Layer {
-    constructor(name, index, pageId, pkg, modifier) {
+    constructor(name, index, pageId, pkg, modifier, _visible = true, _locked = false) {
         this.name = name;
         this.index = index;
         this.pageId = pageId;
         this.pkg = pkg;
+        this._visible = _visible;
+        this._locked = _locked;
         this.modifier = modifier ?? (pkg ? new ShapeModifier_1.ShapeModifier(pkg) : null);
     }
+    /** Whether the layer is currently visible. */
+    get visible() {
+        return this._visible;
+    }
+    /** Whether the layer is currently locked. */
+    get locked() {
+        return this._locked;
+    }
     async setVisible(visible) {
         if (!this.pageId || !this.modifier) {
             throw new Error('Layer was not created with page context. Cannot update properties.');
         }
         await this.modifier.updateLayerProperty(this.pageId, this.index, 'Visible', visible ? '1' : '0');
+        this._visible = visible;
         return this;
     }
     async setLocked(locked) {
@@ -22,6 +33,7 @@ class Layer {
             throw new Error('Layer was not created with page context. Cannot update properties.');
         }
         await this.modifier.updateLayerProperty(this.pageId, this.index, 'Lock', locked ? '1' : '0');
+        this._locked = locked;
         return this;
     }
     async hide() {
@@ -30,5 +42,26 @@ class Layer {
     async show() {
         return this.setVisible(true);
     }
+    /**
+     * Rename this layer.
+     */
+    async rename(newName) {
+        if (!this.pageId || !this.modifier) {
+            throw new Error('Layer was not created with page context. Cannot update properties.');
+        }
+        await this.modifier.updateLayerProperty(this.pageId, this.index, 'Name', newName);
+        this.name = newName;
+        return this;
+    }
+    /**
+     * Delete this layer from the page.
+     * Removes the layer definition and strips it from all shape LayerMember cells.
+     */
+    async delete() {
+        if (!this.pageId || !this.modifier) {
+            throw new Error('Layer was not created with page context. Cannot delete.');
+        }
+        this.modifier.deleteLayer(this.pageId, this.index);
+    }
 }
 exports.Layer = Layer;

package/dist/Page.d.ts

@@ -77,4 +77,15 @@ export declare class Page {
         lock?: boolean;
         print?: boolean;
     }): Promise<Layer>;
+    /**
+     * Return all layers defined on this page, ordered by index.
+     * Works for both newly created documents and loaded `.vsdx` files.
+     *
+     * @example
+     * const layers = page.getLayers();
+     * // [{ name: 'Background', index: 0, visible: true, locked: false }, ...]
+     */
+    getLayers(): Layer[];
+    /** @internal Used by VisioDocument.renamePage() to keep in-memory state in sync. */
+    _updateName(newName: string): void;
 }

package/dist/Page.js

@@ -113,6 +113,7 @@ class Page {
         // In a real scenario, we might want to re-read the shape from disk to get full defaults
         const internalStub = (0, StubHelpers_1.createVisioShapeStub)({
             ID: newId,
+            Type: props.type,
             Text: props.text,
             Cells: {
                 'Width': props.width,
@@ -267,5 +268,21 @@ class Page {
         const info = await this.modifier.addLayer(this.id, name, options);
         return new Layer_1.Layer(info.name, info.index, this.id, this.pkg, this.modifier);
     }
+    /**
+     * Return all layers defined on this page, ordered by index.
+     * Works for both newly created documents and loaded `.vsdx` files.
+     *
+     * @example
+     * const layers = page.getLayers();
+     * // [{ name: 'Background', index: 0, visible: true, locked: false }, ...]
+     */
+    getLayers() {
+        const infos = this.modifier.getPageLayers(this.id);
+        return infos.map(l => new Layer_1.Layer(l.name, l.index, this.id, this.pkg, this.modifier, l.visible, l.locked));
+    }
+    /** @internal Used by VisioDocument.renamePage() to keep in-memory state in sync. */
+    _updateName(newName) {
+        this.internalPage.Name = newName;
+    }
 }
 exports.Page = Page;

package/dist/Shape.d.ts

@@ -23,6 +23,16 @@ export declare class Shape {
     constructor(internalShape: VisioShape, pageId: string, pkg: VisioPackage, modifier?: ShapeModifier);
     get id(): string;
     get name(): string;
+    /**
+     * The shape's Type attribute — `'Group'` for group shapes, `'Shape'` (or `undefined`
+     * normalised to `'Shape'`) for regular shapes.
+     */
+    get type(): string;
+    /**
+     * `true` if this shape is a Group (i.e. it can contain nested child shapes).
+     * Use `shape.getChildren()` to retrieve those children.
+     */
+    get isGroup(): boolean;
     get text(): string;
     setText(newText: string): Promise<void>;
     get width(): number;
@@ -73,6 +83,20 @@ export declare class Shape {
      * Returns an empty array if the shape has no layer assignment.
      */
     getLayerIndices(): number[];
+    /**
+     * Return the direct child shapes of this group.
+     * Returns an empty array for non-group shapes or groups with no children.
+     *
+     * Only direct children are returned — grandchildren are accessible by calling
+     * `getChildren()` on the child shape.
+     *
+     * @example
+     * const group = await page.addShape({ text: 'G', x: 5, y: 5, width: 4, height: 4, type: 'Group' });
+     * await page.addShape({ text: 'Child A', x: 1, y: 1, width: 1, height: 1 }, group.id);
+     * await page.addShape({ text: 'Child B', x: 2, y: 1, width: 1, height: 1 }, group.id);
+     * group.getChildren(); // → [Shape('Child A'), Shape('Child B')]
+     */
+    getChildren(): Shape[];
     /** Current rotation angle in degrees (0 if no Angle cell is set). */
     get angle(): number;
     /**

package/dist/Shape.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Shape = void 0;
 const ShapeModifier_1 = require("./ShapeModifier");
 const VisioTypes_1 = require("./types/VisioTypes");
+const VisioConstants_1 = require("./core/VisioConstants");
 /** Round a coordinate to 10 decimal places to prevent float-to-string-to-float precision drift. */
 function fmtCoord(n) {
     return parseFloat(n.toFixed(10)).toString();
@@ -20,6 +21,20 @@ class Shape {
     get name() {
         return this.internalShape.Name;
     }
+    /**
+     * The shape's Type attribute — `'Group'` for group shapes, `'Shape'` (or `undefined`
+     * normalised to `'Shape'`) for regular shapes.
+     */
+    get type() {
+        return this.internalShape.Type ?? 'Shape';
+    }
+    /**
+     * `true` if this shape is a Group (i.e. it can contain nested child shapes).
+     * Use `shape.getChildren()` to retrieve those children.
+     */
+    get isGroup() {
+        return this.internalShape.Type === VisioConstants_1.SHAPE_TYPES.Group;
+    }
     get text() {
         return this.internalShape.Text || '';
     }
@@ -139,6 +154,23 @@ class Shape {
     getLayerIndices() {
         return this.modifier.getShapeLayerIndices(this.pageId, this.id);
     }
+    /**
+     * Return the direct child shapes of this group.
+     * Returns an empty array for non-group shapes or groups with no children.
+     *
+     * Only direct children are returned — grandchildren are accessible by calling
+     * `getChildren()` on the child shape.
+     *
+     * @example
+     * const group = await page.addShape({ text: 'G', x: 5, y: 5, width: 4, height: 4, type: 'Group' });
+     * await page.addShape({ text: 'Child A', x: 1, y: 1, width: 1, height: 1 }, group.id);
+     * await page.addShape({ text: 'Child B', x: 2, y: 1, width: 1, height: 1 }, group.id);
+     * group.getChildren(); // → [Shape('Child A'), Shape('Child B')]
+     */
+    getChildren() {
+        const children = this.modifier.getShapeChildren(this.pageId, this.id);
+        return children.map(c => new Shape(c, this.pageId, this.pkg, this.modifier));
+    }
     /** Current rotation angle in degrees (0 if no Angle cell is set). */
     get angle() {
         const cell = this.internalShape.Cells['Angle'];
@@ -185,7 +217,7 @@ class Shape {
         return this;
     }
     async addMember(memberShape) {
-        await this.modifier.addRelationship(this.pageId, this.id, memberShape.id, 'Container');
+        await this.modifier.addRelationship(this.pageId, this.id, memberShape.id, VisioConstants_1.STRUCT_RELATIONSHIP_TYPES.Container);
         return this;
     }
     async addListItem(item) {

package/dist/ShapeModifier.d.ts

@@ -2,6 +2,7 @@ import { VisioPackage } from './VisioPackage';
 import { HorzAlign, VertAlign } from './utils/StyleHelpers';
 import { NewShapeProps, ConnectorStyle, ConnectionTarget, ConnectionPointDef } from './types/VisioTypes';
 import type { ShapeData, ShapeHyperlink } from './Shape';
+import type { VisioShape } from './types/VisioTypes';
 export declare class ShapeModifier {
     private pkg;
     addContainer(pageId: string, props: NewShapeProps): Promise<string>;
@@ -100,6 +101,19 @@ export declare class ShapeModifier {
     }>;
     assignLayer(pageId: string, shapeId: string, layerIndex: number): Promise<void>;
     updateLayerProperty(pageId: string, layerIndex: number, propName: string, value: string): Promise<void>;
+    /**
+     * Return all layers defined in the page's PageSheet as plain objects.
+     */
+    getPageLayers(pageId: string): Array<{
+        name: string;
+        index: number;
+        visible: boolean;
+        locked: boolean;
+    }>;
+    /**
+     * Delete a layer by index and remove it from all shape LayerMember cells.
+     */
+    deleteLayer(pageId: string, layerIndex: number): void;
     /**
      * Read back all custom property (shape data) entries for a shape.
      * Returns a map of property key → ShapeData, with values coerced to
@@ -128,6 +142,11 @@ export declare class ShapeModifier {
      * Returns an empty array if the shape has no layer assignment.
      */
     getShapeLayerIndices(pageId: string, shapeId: string): number[];
+    /**
+     * Return the direct child shapes of a group or container shape.
+     * Returns an empty array for non-group shapes or shapes with no children.
+     */
+    getShapeChildren(pageId: string, shapeId: string): VisioShape[];
 }
 export interface ShapeStyle {
     fillColor?: string;

package/dist/ShapeModifier.js

@@ -6,6 +6,7 @@ const StyleHelpers_1 = require("./utils/StyleHelpers");
 const VisioConstants_1 = require("./core/VisioConstants");
 const VisioTypes_1 = require("./types/VisioTypes");
 const ConnectionPointBuilder_1 = require("./shapes/ConnectionPointBuilder");
+const ShapeReader_1 = require("./ShapeReader");
 const ForeignShapeBuilder_1 = require("./shapes/ForeignShapeBuilder");
 const ShapeBuilder_1 = require("./shapes/ShapeBuilder");
 const ConnectorBuilder_1 = require("./shapes/ConnectorBuilder");
@@ -230,9 +231,9 @@ class ShapeModifier {
         if (!Array.isArray(shape.Section))
             shape.Section = [shape.Section];
         // Find or create Connection section
-        let connSection = shape.Section.find((s) => s['@_N'] === 'Connection');
+        let connSection = shape.Section.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.Connection);
         if (!connSection) {
-            connSection = { '@_N': 'Connection', Row: [] };
+            connSection = { '@_N': VisioConstants_1.SECTION_NAMES.Connection, Row: [] };
             shape.Section.push(connSection);
         }
         if (!connSection.Row)
@@ -282,7 +283,7 @@ class ShapeModifier {
             newId = this.getNextId(parsed);
         }
         let newShape;
-        if (props.type === 'Foreign' && props.imgRelId) {
+        if (props.type === VisioConstants_1.SHAPE_TYPES.Foreign && props.imgRelId) {
             newShape = ForeignShapeBuilder_1.ForeignShapeBuilder.createImageShapeObject(newId, props.imgRelId, props);
             // Text for foreign shapes? Usually none, but we can support it.
             if (props.text !== undefined && props.text !== null) {
@@ -311,8 +312,8 @@ class ShapeModifier {
                 parent.Shapes.Shape = parent.Shapes.Shape ? [parent.Shapes.Shape] : [];
             }
             // Mark parent as Group if not already
-            if (parent['@_Type'] !== 'Group') {
-                parent['@_Type'] = 'Group';
+            if (parent['@_Type'] !== VisioConstants_1.SHAPE_TYPES.Group) {
+                parent['@_Type'] = VisioConstants_1.SHAPE_TYPES.Group;
             }
             parent.Shapes.Shape.push(newShape);
         }
@@ -397,7 +398,7 @@ class ShapeModifier {
         // Update/Add Fill
         if (style.fillColor) {
             // Remove existing Fill section if any (simplified: assuming IX=0)
-            shape.Section = shape.Section.filter((s) => s['@_N'] !== 'Fill');
+            shape.Section = shape.Section.filter((s) => s['@_N'] !== VisioConstants_1.SECTION_NAMES.Fill);
             shape.Section.push((0, StyleHelpers_1.createFillSection)(style.fillColor));
         }
         // Update/Add Line
@@ -405,7 +406,7 @@ class ShapeModifier {
             || style.lineWeight !== undefined
             || style.linePattern !== undefined;
         if (hasLineProps) {
-            shape.Section = shape.Section.filter((s) => s['@_N'] !== 'Line');
+            shape.Section = shape.Section.filter((s) => s['@_N'] !== VisioConstants_1.SECTION_NAMES.Line);
             shape.Section.push((0, StyleHelpers_1.createLineSection)({
                 color: style.lineColor,
                 weight: style.lineWeight !== undefined ? (style.lineWeight / 72).toString() : undefined,
@@ -421,7 +422,7 @@ class ShapeModifier {
             || style.fontSize !== undefined
             || style.fontFamily !== undefined;
         if (hasCharProps) {
-            shape.Section = shape.Section.filter((s) => s['@_N'] !== 'Character');
+            shape.Section = shape.Section.filter((s) => s['@_N'] !== VisioConstants_1.SECTION_NAMES.Character);
             shape.Section.push((0, StyleHelpers_1.createCharacterSection)({
                 bold: style.bold,
                 italic: style.italic,
@@ -438,7 +439,7 @@ class ShapeModifier {
             || style.spaceAfter !== undefined
             || style.lineSpacing !== undefined;
         if (hasParagraphProps) {
-            shape.Section = shape.Section.filter((s) => s['@_N'] !== 'Paragraph');
+            shape.Section = shape.Section.filter((s) => s['@_N'] !== VisioConstants_1.SECTION_NAMES.Paragraph);
             shape.Section.push((0, StyleHelpers_1.createParagraphSection)({
                 horzAlign: style.horzAlign,
                 spaceBefore: style.spaceBefore,
@@ -452,7 +453,7 @@ class ShapeModifier {
             || style.textMarginLeft !== undefined
             || style.textMarginRight !== undefined;
         if (hasTextBlockProps) {
-            shape.Section = shape.Section.filter((s) => s['@_N'] !== 'TextBlock');
+            shape.Section = shape.Section.filter((s) => s['@_N'] !== VisioConstants_1.SECTION_NAMES.TextBlock);
             shape.Section.push((0, StyleHelpers_1.createTextBlockSection)({
                 topMargin: style.textMarginTop,
                 bottomMargin: style.textMarginBottom,
@@ -570,7 +571,7 @@ class ShapeModifier {
         if (shape.Section) {
             const sections = Array.isArray(shape.Section) ? shape.Section : [shape.Section];
             for (const section of sections) {
-                if (section['@_N'] !== 'Geometry' || !section.Row)
+                if (section['@_N'] !== VisioConstants_1.SECTION_NAMES.Geometry || !section.Row)
                     continue;
                 const rows = Array.isArray(section.Row) ? section.Row : [section.Row];
                 for (const row of rows) {
@@ -627,9 +628,9 @@ class ShapeModifier {
         if (!Array.isArray(shape.Section))
             shape.Section = [shape.Section];
         // Find or Create Property Section
-        let propSection = shape.Section.find((s) => s['@_N'] === 'Property');
+        let propSection = shape.Section.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.Property);
         if (!propSection) {
-            propSection = { '@_N': 'Property', Row: [] };
+            propSection = { '@_N': VisioConstants_1.SECTION_NAMES.Property, Row: [] };
             shape.Section.push(propSection);
         }
         // Ensure Row array exists
@@ -681,7 +682,7 @@ class ShapeModifier {
         }
         // Ensure Section array exists
         const sections = shape.Section ? (Array.isArray(shape.Section) ? shape.Section : [shape.Section]) : [];
-        const propSection = sections.find((s) => s['@_N'] === 'Property');
+        const propSection = sections.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.Property);
         if (!propSection) {
             throw new Error(`Property definition 'Prop.${name}' does not exist on shape ${shapeId}. Call addPropertyDefinition first.`);
         }
@@ -770,7 +771,7 @@ class ShapeModifier {
             return [];
         const relsArray = Array.isArray(rels) ? rels : [rels];
         return relsArray
-            .filter((r) => r['@_Type'] === 'Container' && r['@_ShapeID'] === containerId)
+            .filter((r) => r['@_Type'] === VisioConstants_1.STRUCT_RELATIONSHIP_TYPES.Container && r['@_ShapeID'] === containerId)
             .map((r) => r['@_RelatedShapeID']);
     }
     async reorderShape(pageId, shapeId, position) {
@@ -805,7 +806,7 @@ class ShapeModifier {
         const getUserVal = (name, def) => {
             if (!listShape.Section)
                 return def;
-            const userSec = listShape.Section.find((s) => s['@_N'] === 'User');
+            const userSec = listShape.Section.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.User);
             if (!userSec || !userSec.Row)
                 return def;
             const rows = Array.isArray(userSec.Row) ? userSec.Row : [userSec.Row];
@@ -850,7 +851,7 @@ class ShapeModifier {
         // 3. Update Item Position
         await this.updateShapePosition(pageId, itemId, newX, newY);
         // 4. Add Relationship
-        await this.addRelationship(pageId, listId, itemId, 'Container');
+        await this.addRelationship(pageId, listId, itemId, VisioConstants_1.STRUCT_RELATIONSHIP_TYPES.Container);
         // 5. Resize List Container
         await this.resizeContainerToFit(pageId, listId, 0.25);
     }
@@ -946,9 +947,9 @@ class ShapeModifier {
         if (!Array.isArray(pageSheet.Section))
             pageSheet.Section = [pageSheet.Section];
         // Find or Create Layer Section
-        let layerSection = pageSheet.Section.find((s) => s['@_N'] === 'Layer');
+        let layerSection = pageSheet.Section.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.Layer);
         if (!layerSection) {
-            layerSection = { '@_N': 'Layer', Row: [] };
+            layerSection = { '@_N': VisioConstants_1.SECTION_NAMES.Layer, Row: [] };
             pageSheet.Section.push(layerSection);
         }
         // Ensure Row array
@@ -990,9 +991,9 @@ class ShapeModifier {
         if (!Array.isArray(shape.Section))
             shape.Section = [shape.Section];
         // Find or Create LayerMem Section
-        let memSection = shape.Section.find((s) => s['@_N'] === 'LayerMem');
+        let memSection = shape.Section.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.LayerMem);
         if (!memSection) {
-            memSection = { '@_N': 'LayerMem', Row: [] };
+            memSection = { '@_N': VisioConstants_1.SECTION_NAMES.LayerMem, Row: [] };
             shape.Section.push(memSection);
         }
         // Ensure Row array
@@ -1036,7 +1037,7 @@ class ShapeModifier {
         if (!pageSheet.Section)
             return;
         const sections = Array.isArray(pageSheet.Section) ? pageSheet.Section : [pageSheet.Section];
-        const layerSection = sections.find((s) => s['@_N'] === 'Layer');
+        const layerSection = sections.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.Layer);
         if (!layerSection || !layerSection.Row)
             return;
         const rows = Array.isArray(layerSection.Row) ? layerSection.Row : [layerSection.Row];
@@ -1059,6 +1060,69 @@ class ShapeModifier {
         }
         this.saveParsed(pageId, parsed);
     }
+    /**
+     * Return all layers defined in the page's PageSheet as plain objects.
+     */
+    getPageLayers(pageId) {
+        const parsed = this.getParsed(pageId);
+        const pageSheet = parsed.PageContents?.PageSheet;
+        if (!pageSheet?.Section)
+            return [];
+        const sections = Array.isArray(pageSheet.Section) ? pageSheet.Section : [pageSheet.Section];
+        const layerSection = sections.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.Layer);
+        if (!layerSection?.Row)
+            return [];
+        const rows = Array.isArray(layerSection.Row) ? layerSection.Row : [layerSection.Row];
+        return rows.map((row) => {
+            const cells = Array.isArray(row.Cell) ? row.Cell : (row.Cell ? [row.Cell] : []);
+            const getVal = (name) => cells.find((c) => c['@_N'] === name)?.['@_V'];
+            return {
+                name: getVal('Name') ?? '',
+                index: parseInt(row['@_IX'], 10),
+                visible: getVal('Visible') !== '0',
+                locked: getVal('Lock') === '1',
+            };
+        });
+    }
+    /**
+     * Delete a layer by index and remove it from all shape LayerMember cells.
+     */
+    deleteLayer(pageId, layerIndex) {
+        const parsed = this.getParsed(pageId);
+        // Remove the row from the Layer section in PageSheet
+        const pageSheet = parsed.PageContents?.PageSheet;
+        if (pageSheet?.Section) {
+            const sections = Array.isArray(pageSheet.Section) ? pageSheet.Section : [pageSheet.Section];
+            const layerSection = sections.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.Layer);
+            if (layerSection?.Row) {
+                const rows = Array.isArray(layerSection.Row) ? layerSection.Row : [layerSection.Row];
+                layerSection.Row = rows.filter((r) => r['@_IX'] !== layerIndex.toString());
+            }
+        }
+        // Remove this layer index from every shape's LayerMember cell
+        const idxStr = layerIndex.toString();
+        for (const [, shape] of this.getShapeMap(parsed)) {
+            if (!shape.Section)
+                continue;
+            const sections = Array.isArray(shape.Section) ? shape.Section : [shape.Section];
+            const memSec = sections.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.LayerMem);
+            if (!memSec?.Row)
+                continue;
+            const rows = Array.isArray(memSec.Row) ? memSec.Row : [memSec.Row];
+            const row = rows[0];
+            if (!row?.Cell)
+                continue;
+            const cells = Array.isArray(row.Cell) ? row.Cell : [row.Cell];
+            const memberCell = cells.find((c) => c['@_N'] === 'LayerMember');
+            if (!memberCell?.['@_V'])
+                continue;
+            const remaining = memberCell['@_V']
+                .split(';')
+                .filter((s) => s.length > 0 && s !== idxStr);
+            memberCell['@_V'] = remaining.join(';');
+        }
+        this.saveParsed(pageId, parsed);
+    }
     /**
      * Read back all custom property (shape data) entries for a shape.
      * Returns a map of property key → ShapeData, with values coerced to
@@ -1073,7 +1137,7 @@ class ShapeModifier {
         if (!shape.Section)
             return result;
         const sections = Array.isArray(shape.Section) ? shape.Section : [shape.Section];
-        const propSection = sections.find((s) => s['@_N'] === 'Property');
+        const propSection = sections.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.Property);
         if (!propSection?.Row)
             return result;
         const rows = Array.isArray(propSection.Row) ? propSection.Row : [propSection.Row];
@@ -1188,7 +1252,7 @@ class ShapeModifier {
         if (!shape.Section)
             return [];
         const sections = Array.isArray(shape.Section) ? shape.Section : [shape.Section];
-        const memSection = sections.find((s) => s['@_N'] === 'LayerMem');
+        const memSection = sections.find((s) => s['@_N'] === VisioConstants_1.SECTION_NAMES.LayerMem);
         if (!memSection?.Row)
             return [];
         const rows = Array.isArray(memSection.Row) ? memSection.Row : [memSection.Row];
@@ -1205,5 +1269,14 @@ class ShapeModifier {
             .map((s) => parseInt(s))
             .filter((n) => !isNaN(n));
     }
+    /**
+     * Return the direct child shapes of a group or container shape.
+     * Returns an empty array for non-group shapes or shapes with no children.
+     */
+    getShapeChildren(pageId, shapeId) {
+        const pagePath = this.getPagePath(pageId);
+        const reader = new ShapeReader_1.ShapeReader(this.pkg);
+        return reader.readChildShapes(pagePath, shapeId);
+    }
 }
 exports.ShapeModifier = ShapeModifier;

package/dist/ShapeReader.d.ts

@@ -25,6 +25,12 @@ export declare class ShapeReader {
     /** Decode a Visio ToPart integer string to a ConnectionTarget. */
     private decodeToPart;
     private gatherShapes;
+    /**
+     * Return the direct child shapes of a group or container shape.
+     * Returns an empty array if the shape has no children or does not exist.
+     */
+    readChildShapes(path: string, parentId: string): VisioShape[];
     private findShapeById;
+    private findRawShape;
     private parseShape;
 }

package/dist/ShapeReader.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ShapeReader = void 0;
 const fast_xml_parser_1 = require("fast-xml-parser");
 const VisioParsers_1 = require("./utils/VisioParsers");
+const VisioConstants_1 = require("./core/VisioConstants");
 class ShapeReader {
     constructor(pkg) {
         this.pkg = pkg;
@@ -138,7 +139,7 @@ class ShapeReader {
             let lineWeight;
             let linePattern;
             for (const sec of sections) {
-                if (sec['@_N'] === 'Line') {
+                if (sec['@_N'] === VisioConstants_1.SECTION_NAMES.Line) {
                     const lineCells = (0, VisioParsers_1.parseCells)(sec);
                     if (lineCells['LineColor']?.V)
                         lineColor = lineCells['LineColor'].V;
@@ -190,12 +191,37 @@ class ShapeReader {
             }
         }
     }
+    /**
+     * Return the direct child shapes of a group or container shape.
+     * Returns an empty array if the shape has no children or does not exist.
+     */
+    readChildShapes(path, parentId) {
+        let content;
+        try {
+            content = this.pkg.getFileText(path);
+        }
+        catch {
+            return [];
+        }
+        const parsed = this.parser.parse(content);
+        const shapesData = parsed.PageContents?.Shapes?.Shape;
+        if (!shapesData)
+            return [];
+        const rawParent = this.findRawShape((0, VisioParsers_1.asArray)(shapesData), parentId);
+        if (!rawParent?.Shapes?.Shape)
+            return [];
+        return (0, VisioParsers_1.asArray)(rawParent.Shapes.Shape).map((s) => this.parseShape(s));
+    }
     findShapeById(rawShapes, shapeId) {
+        const raw = this.findRawShape(rawShapes, shapeId);
+        return raw ? this.parseShape(raw) : undefined;
+    }
+    findRawShape(rawShapes, shapeId) {
         for (const s of rawShapes) {
             if (s['@_ID'] === shapeId)
-                return this.parseShape(s);
+                return s;
             if (s.Shapes?.Shape) {
-                const found = this.findShapeById((0, VisioParsers_1.asArray)(s.Shapes.Shape), shapeId);
+                const found = this.findRawShape((0, VisioParsers_1.asArray)(s.Shapes.Shape), shapeId);
                 if (found)
                     return found;
             }

package/dist/VisioDocument.d.ts

@@ -31,6 +31,30 @@ export declare class VisioDocument {
      * and any BackPage references from other pages.
      */
     deletePage(page: Page): Promise<void>;
+    /**
+     * Rename a page. Updates `page.name` in-memory as well as the pages.xml record.
+     *
+     * @example
+     * doc.renamePage(page, 'Architecture Overview');
+     */
+    renamePage(page: Page, newName: string): void;
+    /**
+     * Move a page to a new 0-based position in the tab order.
+     * Clamps `toIndex` to the valid range automatically.
+     *
+     * @example
+     * doc.movePage(page, 0);  // move to first position
+     */
+    movePage(page: Page, toIndex: number): void;
+    /**
+     * Duplicate a page and return the new Page object.
+     * The duplicate is inserted directly after the source page in the tab order.
+     * If `newName` is omitted, `"<original name> (Copy)"` is used.
+     *
+     * @example
+     * const copy = await doc.duplicatePage(page, 'Page 2');
+     */
+    duplicatePage(page: Page, newName?: string): Promise<Page>;
     /**
      * Read document metadata from `docProps/core.xml` and `docProps/app.xml`.
      * Fields not present in the file are returned as `undefined`.

package/dist/VisioDocument.js

@@ -137,6 +137,48 @@ class VisioDocument {
         await this.pageManager.deletePage(page.id);
         this._pageCache = null;
     }
+    /**
+     * Rename a page. Updates `page.name` in-memory as well as the pages.xml record.
+     *
+     * @example
+     * doc.renamePage(page, 'Architecture Overview');
+     */
+    renamePage(page, newName) {
+        this.pageManager.renamePage(page.id, newName);
+        page._updateName(newName);
+    }
+    /**
+     * Move a page to a new 0-based position in the tab order.
+     * Clamps `toIndex` to the valid range automatically.
+     *
+     * @example
+     * doc.movePage(page, 0);  // move to first position
+     */
+    movePage(page, toIndex) {
+        this.pageManager.reorderPage(page.id, toIndex);
+        this._pageCache = null;
+    }
+    /**
+     * Duplicate a page and return the new Page object.
+     * The duplicate is inserted directly after the source page in the tab order.
+     * If `newName` is omitted, `"<original name> (Copy)"` is used.
+     *
+     * @example
+     * const copy = await doc.duplicatePage(page, 'Page 2');
+     */
+    async duplicatePage(page, newName) {
+        const resolvedName = newName ?? `${page.name} (Copy)`;
+        const newId = await this.pageManager.duplicatePage(page.id, resolvedName);
+        this._pageCache = null;
+        const pageStub = {
+            ID: newId,
+            Name: resolvedName,
+            xmlPath: `visio/pages/page${newId}.xml`,
+            Shapes: [],
+            Connects: []
+        };
+        return new Page_1.Page(pageStub, this.pkg, this.mediaManager);
+    }
     /**
      * Read document metadata from `docProps/core.xml` and `docProps/app.xml`.
      * Fields not present in the file are returned as `undefined`.

package/dist/core/PageManager.d.ts

@@ -28,6 +28,21 @@ export declare class PageManager {
      * and any BackPage references from other pages that pointed to it.
      */
     deletePage(pageId: string): Promise<void>;
+    /**
+     * Rename a page — updates Name and NameU in pages.xml.
+     */
+    renamePage(pageId: string, newName: string): void;
+    /**
+     * Move a page to a new 0-based position in the pages.xml order (which
+     * controls the tab order in the Visio UI).
+     */
+    reorderPage(pageId: string, toIndex: number): void;
+    /**
+     * Duplicate a page: copies the page XML (and its rels file if present),
+     * registers the new page in pages.xml and pages.xml.rels, and returns
+     * the new page ID.
+     */
+    duplicatePage(pageId: string, newName: string): Promise<string>;
     /**
      * Set a background page for a foreground page
      */

package/dist/core/PageManager.js

@@ -271,6 +271,107 @@ class PageManager {
         // 6. Reload the page list to reflect the deletion
         this.load(true);
     }
+    /**
+     * Rename a page — updates Name and NameU in pages.xml.
+     */
+    renamePage(pageId, newName) {
+        this.load();
+        const pagesPath = 'visio/pages/pages.xml';
+        const parsed = this.parser.parse(this.pkg.getFileText(pagesPath));
+        let pageNodes = parsed.Pages.Page;
+        if (!Array.isArray(pageNodes))
+            pageNodes = pageNodes ? [pageNodes] : [];
+        const node = pageNodes.find((n) => n['@_ID'] === pageId);
+        if (!node)
+            throw new Error(`Page ${pageId} not found`);
+        node['@_Name'] = newName;
+        node['@_NameU'] = newName;
+        this.pkg.updateFile(pagesPath, (0, XmlHelper_1.buildXml)(this.builder, parsed));
+        this.load(true);
+    }
+    /**
+     * Move a page to a new 0-based position in the pages.xml order (which
+     * controls the tab order in the Visio UI).
+     */
+    reorderPage(pageId, toIndex) {
+        this.load();
+        const pagesPath = 'visio/pages/pages.xml';
+        const parsed = this.parser.parse(this.pkg.getFileText(pagesPath));
+        let pageNodes = parsed.Pages.Page;
+        if (!Array.isArray(pageNodes))
+            pageNodes = pageNodes ? [pageNodes] : [];
+        const fromIndex = pageNodes.findIndex((n) => n['@_ID'] === pageId);
+        if (fromIndex === -1)
+            throw new Error(`Page ${pageId} not found`);
+        const clamped = Math.max(0, Math.min(toIndex, pageNodes.length - 1));
+        const [moved] = pageNodes.splice(fromIndex, 1);
+        pageNodes.splice(clamped, 0, moved);
+        parsed.Pages.Page = pageNodes;
+        this.pkg.updateFile(pagesPath, (0, XmlHelper_1.buildXml)(this.builder, parsed));
+        this.load(true);
+    }
+    /**
+     * Duplicate a page: copies the page XML (and its rels file if present),
+     * registers the new page in pages.xml and pages.xml.rels, and returns
+     * the new page ID.
+     */
+    async duplicatePage(pageId, newName) {
+        this.load();
+        const source = this.pages.find(p => p.id.toString() === pageId);
+        if (!source)
+            throw new Error(`Page ${pageId} not found`);
+        // 1. Calculate new ID and paths
+        const maxId = Math.max(...this.pages.map(p => p.id));
+        const newId = maxId + 1;
+        const newFileName = `page${newId}.xml`;
+        const newPath = `visio/pages/${newFileName}`;
+        // 2. Copy page XML verbatim
+        const sourceXml = this.pkg.getFileText(source.xmlPath);
+        this.pkg.updateFile(newPath, sourceXml);
+        // 3. Copy the page's .rels file if one exists (image refs etc.)
+        const sourceFileName = source.xmlPath.split('/').pop();
+        const sourceRelsPath = `visio/pages/_rels/${sourceFileName}.rels`;
+        const newRelsPath = `visio/pages/_rels/${newFileName}.rels`;
+        try {
+            this.pkg.updateFile(newRelsPath, this.pkg.getFileText(sourceRelsPath));
+        }
+        catch { /* no rels file — fine */ }
+        // 4. Add Content Types override
+        const ctPath = '[Content_Types].xml';
+        const parsedCt = this.parser.parse(this.pkg.getFileText(ctPath));
+        if (!parsedCt.Types.Override)
+            parsedCt.Types.Override = [];
+        if (!Array.isArray(parsedCt.Types.Override))
+            parsedCt.Types.Override = [parsedCt.Types.Override];
+        parsedCt.Types.Override.push({
+            '@_PartName': `/${newPath}`,
+            '@_ContentType': VisioConstants_1.CONTENT_TYPES.VISIO_PAGE
+        });
+        this.pkg.updateFile(ctPath, (0, XmlHelper_1.buildXml)(this.builder, parsedCt));
+        // 5. Add relationship in pages.xml.rels
+        const rId = await this.relsManager.ensureRelationship('visio/pages/pages.xml', newFileName, VisioConstants_1.RELATIONSHIP_TYPES.PAGE);
+        // 6. Append entry to pages.xml (directly after the source page)
+        const pagesPath = 'visio/pages/pages.xml';
+        const parsedPages = this.parser.parse(this.pkg.getFileText(pagesPath));
+        if (!parsedPages.Pages.Page)
+            parsedPages.Pages.Page = [];
+        if (!Array.isArray(parsedPages.Pages.Page))
+            parsedPages.Pages.Page = [parsedPages.Pages.Page];
+        const newEntry = {
+            '@_ID': newId.toString(),
+            '@_Name': newName,
+            '@_NameU': newName,
+            'Rel': { '@_r:id': rId }
+        };
+        if (source.isBackground)
+            newEntry['@_Background'] = '1';
+        // Insert right after the source page so the duplicate is adjacent in the tab bar
+        const srcIdx = parsedPages.Pages.Page.findIndex((n) => n['@_ID'] === pageId);
+        parsedPages.Pages.Page.splice(srcIdx + 1, 0, newEntry);
+        this.pkg.updateFile(pagesPath, (0, XmlHelper_1.buildXml)(this.builder, parsedPages));
+        this.load(true);
+        return newId.toString();
+    }
     /**
      * Set a background page for a foreground page
      */

package/dist/core/VisioConstants.d.ts

@@ -21,6 +21,36 @@ export declare const RELATIONSHIP_TYPES: {
     readonly CORE_PROPERTIES: "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties";
     readonly EXTENDED_PROPERTIES: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties";
 };
+/** Visio shape `Type` attribute values. */
+export declare const SHAPE_TYPES: {
+    readonly Shape: "Shape";
+    readonly Group: "Group";
+    readonly Foreign: "Foreign";
+};
+/**
+ * Visio ShapeSheet section names (the `N` attribute on `<Section>` elements).
+ * Used when finding or filtering sections by name in page/master XML.
+ */
+export declare const SECTION_NAMES: {
+    readonly Line: "Line";
+    readonly Fill: "Fill";
+    readonly Character: "Character";
+    readonly Paragraph: "Paragraph";
+    readonly TextBlock: "TextBlock";
+    readonly Geometry: "Geometry";
+    readonly Connection: "Connection";
+    readonly Property: "Property";
+    readonly User: "User";
+    readonly LayerMem: "LayerMem";
+    readonly Layer: "Layer";
+};
+/**
+ * Structural relationship types stored in `<Relationship>` elements
+ * inside Visio page XML (distinct from OPC `.rels` relationship types).
+ */
+export declare const STRUCT_RELATIONSHIP_TYPES: {
+    readonly Container: "Container";
+};
 export declare const CONTENT_TYPES: {
     readonly PNG: "image/png";
     readonly JPEG: "image/jpeg";

package/dist/core/VisioConstants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTENT_TYPES = exports.RELATIONSHIP_TYPES = exports.XML_NAMESPACES = void 0;
+exports.CONTENT_TYPES = exports.STRUCT_RELATIONSHIP_TYPES = exports.SECTION_NAMES = exports.SHAPE_TYPES = exports.RELATIONSHIP_TYPES = exports.XML_NAMESPACES = void 0;
 exports.XML_NAMESPACES = {
     VISIO_MAIN: 'http://schemas.microsoft.com/office/visio/2012/main',
     RELATIONSHIPS: 'http://schemas.openxmlformats.org/package/2006/relationships',
@@ -24,6 +24,36 @@ exports.RELATIONSHIP_TYPES = {
     CORE_PROPERTIES: 'http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties',
     EXTENDED_PROPERTIES: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties'
 };
+/** Visio shape `Type` attribute values. */
+exports.SHAPE_TYPES = {
+    Shape: 'Shape',
+    Group: 'Group',
+    Foreign: 'Foreign',
+};
+/**
+ * Visio ShapeSheet section names (the `N` attribute on `<Section>` elements).
+ * Used when finding or filtering sections by name in page/master XML.
+ */
+exports.SECTION_NAMES = {
+    Line: 'Line',
+    Fill: 'Fill',
+    Character: 'Character',
+    Paragraph: 'Paragraph',
+    TextBlock: 'TextBlock',
+    Geometry: 'Geometry',
+    Connection: 'Connection',
+    Property: 'Property',
+    User: 'User',
+    LayerMem: 'LayerMem',
+    Layer: 'Layer',
+};
+/**
+ * Structural relationship types stored in `<Relationship>` elements
+ * inside Visio page XML (distinct from OPC `.rels` relationship types).
+ */
+exports.STRUCT_RELATIONSHIP_TYPES = {
+    Container: 'Container',
+};
 exports.CONTENT_TYPES = {
     PNG: 'image/png',
     JPEG: 'image/jpeg',

package/dist/core/VisioValidator.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VisioValidator = void 0;
 const fast_xml_parser_1 = require("fast-xml-parser");
+const VisioConstants_1 = require("./VisioConstants");
 // Known Visio section names per Microsoft schema
 const VALID_SECTION_NAMES = new Set([
     'Geometry', 'Character', 'Paragraph', 'Tabs', 'Scratch', 'Connection',
@@ -241,7 +242,7 @@ class VisioValidator {
     validateImageShapes(pkg, pageId, parsed, pagePath, errors, warnings) {
         const shapes = this.getAllShapes(parsed);
         for (const shape of shapes) {
-            if (shape['@_Type'] !== 'Foreign')
+            if (shape['@_Type'] !== VisioConstants_1.SHAPE_TYPES.Foreign)
                 continue;
             if (!shape.ForeignData) {
                 warnings.push(`${pagePath}: Foreign shape ${shape['@_ID']} missing ForeignData`);

package/dist/shapes/ShapeBuilder.js

@@ -4,6 +4,7 @@ exports.ShapeBuilder = void 0;
 const StyleHelpers_1 = require("../utils/StyleHelpers");
 const GeometryBuilder_1 = require("./GeometryBuilder");
 const ConnectionPointBuilder_1 = require("./ConnectionPointBuilder");
+const VisioConstants_1 = require("../core/VisioConstants");
 class ShapeBuilder {
     static createStandardShape(id, props) {
         // Validate dimensions
@@ -14,7 +15,7 @@ class ShapeBuilder {
             '@_ID': id,
             '@_NameU': `Sheet.${id}`,
             '@_Name': `Sheet.${id}`,
-            '@_Type': props.type || 'Shape',
+            '@_Type': props.type || VisioConstants_1.SHAPE_TYPES.Shape,
             Cell: [
                 { '@_N': 'PinX', '@_V': props.x.toString() },
                 { '@_N': 'PinY', '@_V': props.y.toString() },
@@ -103,7 +104,7 @@ class ShapeBuilder {
         }
         // Add Geometry
         // Only if NOT a Group AND NOT a Master Instance
-        if (props.type !== 'Group' && !props.masterId) {
+        if (props.type !== VisioConstants_1.SHAPE_TYPES.Group && !props.masterId) {
             shape.Section.push(GeometryBuilder_1.GeometryBuilder.build(props));
         }
         // Handle Text if provided

package/dist/utils/StubHelpers.d.ts

@@ -2,6 +2,7 @@ import { VisioShape } from '../types/VisioTypes';
 export declare function createVisioShapeStub(props: {
     ID: string;
     Name?: string;
+    Type?: string;
     Text?: string;
     Cells?: Record<string, string | number>;
 }): VisioShape;

package/dist/utils/StubHelpers.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createVisioShapeStub = createVisioShapeStub;
+const VisioConstants_1 = require("../core/VisioConstants");
 function createVisioShapeStub(props) {
     return {
         ID: props.ID,
         Name: props.Name || `Sheet.${props.ID}`,
-        Type: 'Shape',
+        Type: props.Type ?? VisioConstants_1.SHAPE_TYPES.Shape,
         Text: props.Text,
         Cells: Object.entries(props.Cells || {}).reduce((acc, [k, v]) => {
             acc[k] = { N: k, V: v.toString() };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-visio",
-  "version": "1.10.0",
+  "version": "1.13.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {