ts-visio 1.10.0 → 1.11.0

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,

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>;
@@ -128,6 +129,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);
     }
@@ -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
@@ -1073,7 +1074,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 +1189,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 +1206,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/core/VisioConstants.d.ts

@@ -21,6 +21,35 @@ 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";
+};
+/**
+ * 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,35 @@ 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',
+};
+/**
+ * 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.11.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {