ts-visio 1.0.0

package/dist/shapes/ContainerBuilder.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContainerBuilder = void 0;
+const ShapeBuilder_1 = require("./ShapeBuilder");
+class ContainerBuilder {
+    static createContainerShape(id, props) {
+        // Reuse basic shape creation (transform, text, etc)
+        const shape = ShapeBuilder_1.ShapeBuilder.createStandardShape(id, props);
+        // Styling Override for "Classic Container":
+        // Usually containers have a Header implementation or specific Geometry.
+        // For Phase 1, we will stick to a basic Rectangle with the Metadata.
+        // If the user wants "classic" look, we might need 2 geometries (Header + Body).
+        // 1. Inject Container Metadata (User Cells)
+        this.makeContainer(shape);
+        // 2. Adjust styling if necessary
+        // Containers often have 'NoFill' for the body so you can see behind,
+        // or they have a Group structure.
+        // For a simple single-shape container, we rely on the Geometry.
+        return shape;
+    }
+    static makeContainer(shape) {
+        // Ensure Section array
+        if (!shape.Section)
+            shape.Section = [];
+        if (!Array.isArray(shape.Section))
+            shape.Section = [shape.Section];
+        // 1. User Section (Metadata)
+        let userSection = shape.Section.find((s) => s['@_N'] === 'User');
+        if (!userSection) {
+            userSection = { '@_N': 'User', Row: [] };
+            shape.Section.push(userSection);
+        }
+        // Ensure Row is array (Critical for XML parser edge cases)
+        if (!userSection.Row)
+            userSection.Row = [];
+        if (!Array.isArray(userSection.Row))
+            userSection.Row = [userSection.Row];
+        // Helper to add/update user row
+        const addUserRow = (name, value) => {
+            const rowIdx = userSection.Row.findIndex((r) => r['@_N'] === name);
+            const newRow = {
+                '@_N': name,
+                Cell: [{ '@_N': 'Value', '@_V': value }]
+            };
+            if (rowIdx >= 0) {
+                userSection.Row[rowIdx] = newRow;
+            }
+            else {
+                userSection.Row.push(newRow);
+            }
+        };
+        // Critical Metadata
+        addUserRow('msvStructureType', '"Container"');
+        addUserRow('msvSDContainerMargin', '10 mm');
+        // 2. Adjust Text Position (Simulate Header)
+        // Find or create TextXform
+        let textXform = shape.Section.find((s) => s['@_N'] === 'TextXform');
+        if (!textXform) {
+            textXform = { '@_N': 'TextXform', Cell: [] };
+            shape.Section.push(textXform);
+        }
+        // Ensure Cell is array
+        if (!textXform.Cell)
+            textXform.Cell = [];
+        if (!Array.isArray(textXform.Cell))
+            textXform.Cell = [textXform.Cell];
+        const upsertCell = (name, val, unit) => {
+            const idx = textXform.Cell.findIndex((c) => c['@_N'] === name);
+            const cell = { '@_N': name, '@_V': val, '@_U': unit };
+            if (idx >= 0)
+                textXform.Cell[idx] = cell;
+            else
+                textXform.Cell.push(cell);
+        };
+        // Move text to top of shape: TxtPinY = Height, TxtLocPinY = TxtHeight
+        // Removed redundant '*1' from formulas
+        upsertCell('TxtPinY', 'Height', 'DY');
+        upsertCell('TxtLocPinY', 'TxtHeight', 'DY');
+    }
+    static makeList(shape, direction = 'vertical') {
+        // 1. Convert basic container to List
+        this.makeContainer(shape);
+        // 2. User Section Override
+        let userSection = shape.Section.find((s) => s['@_N'] === 'User');
+        // Helper to add/update user row
+        const upsertUserRow = (name, value) => {
+            const rowIdx = userSection.Row.findIndex((r) => r['@_N'] === name);
+            const newRow = {
+                '@_N': name,
+                Cell: [{ '@_N': 'Value', '@_V': value }]
+            };
+            if (rowIdx >= 0)
+                userSection.Row[rowIdx] = newRow;
+            else
+                userSection.Row.push(newRow);
+        };
+        upsertUserRow('msvStructureType', '"List"'); // Override "Container"
+        upsertUserRow('msvSDListDirection', direction === 'vertical' ? '1' : '0'); // 1=Vert, 0=Horiz
+        upsertUserRow('msvSDListSpacing', '0.125'); // Default spacing (can be param later)
+        upsertUserRow('msvSDListAlignment', '1'); // 1=Center
+    }
+}
+exports.ContainerBuilder = ContainerBuilder;

package/dist/shapes/ForeignShapeBuilder.d.ts

@@ -0,0 +1,4 @@
+import { NewShapeProps } from '../types/VisioTypes';
+export declare class ForeignShapeBuilder {
+    static createImageShapeObject(id: string, rId: string, props: NewShapeProps): any;
+}

package/dist/shapes/ForeignShapeBuilder.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForeignShapeBuilder = void 0;
+class ForeignShapeBuilder {
+    static createImageShapeObject(id, rId, props) {
+        return {
+            '@_ID': id,
+            '@_NameU': `Sheet.${id}`,
+            '@_Name': `Sheet.${id}`,
+            '@_Type': 'Foreign',
+            ForeignData: { '@_r:id': rId },
+            Cell: [
+                { '@_N': 'PinX', '@_V': props.x.toString() },
+                { '@_N': 'PinY', '@_V': props.y.toString() },
+                { '@_N': 'Width', '@_V': props.width.toString() },
+                { '@_N': 'Height', '@_V': props.height.toString() },
+                { '@_N': 'LocPinX', '@_V': (props.width / 2).toString() },
+                { '@_N': 'LocPinY', '@_V': (props.height / 2).toString() }
+            ],
+            Section: [
+                // Foreign shapes typically have no border (LinePattern=0)
+                {
+                    '@_N': 'Line',
+                    Cell: [
+                        { '@_N': 'LinePattern', '@_V': '0' }, // 0 = Null/No Line
+                        { '@_N': 'LineColor', '@_V': '#000000' },
+                        { '@_N': 'LineWeight', '@_V': '0' }
+                    ]
+                },
+                // Geometry is required for selection bounds
+                {
+                    '@_N': 'Geometry',
+                    '@_IX': '0',
+                    Cell: [{ '@_N': 'NoFill', '@_V': '1' }], // Images usually don't have a fill behind them
+                    Row: [
+                        { '@_T': 'MoveTo', '@_IX': '1', Cell: [{ '@_N': 'X', '@_V': '0' }, { '@_N': 'Y', '@_V': '0' }] },
+                        { '@_T': 'LineTo', '@_IX': '2', Cell: [{ '@_N': 'X', '@_V': props.width.toString() }, { '@_N': 'Y', '@_V': '0' }] },
+                        { '@_T': 'LineTo', '@_IX': '3', Cell: [{ '@_N': 'X', '@_V': props.width.toString() }, { '@_N': 'Y', '@_V': props.height.toString() }] },
+                        { '@_T': 'LineTo', '@_IX': '4', Cell: [{ '@_N': 'X', '@_V': '0' }, { '@_N': 'Y', '@_V': props.height.toString() }] },
+                        { '@_T': 'LineTo', '@_IX': '5', Cell: [{ '@_N': 'X', '@_V': '0' }, { '@_N': 'Y', '@_V': '0' }] }
+                    ]
+                }
+            ]
+        };
+    }
+}
+exports.ForeignShapeBuilder = ForeignShapeBuilder;

package/dist/shapes/ShapeBuilder.d.ts

@@ -0,0 +1,4 @@
+import { NewShapeProps } from '../types/VisioTypes';
+export declare class ShapeBuilder {
+    static createStandardShape(id: string, props: NewShapeProps): any;
+}

package/dist/shapes/ShapeBuilder.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShapeBuilder = void 0;
+const StyleHelpers_1 = require("../utils/StyleHelpers");
+class ShapeBuilder {
+    static createStandardShape(id, props) {
+        // Validate dimensions
+        if (props.width <= 0 || props.height <= 0) {
+            throw new Error('Shape dimensions must be positive numbers');
+        }
+        const shape = {
+            '@_ID': id,
+            '@_NameU': `Sheet.${id}`,
+            '@_Name': `Sheet.${id}`,
+            '@_Type': props.type || 'Shape',
+            Cell: [
+                { '@_N': 'PinX', '@_V': props.x.toString() },
+                { '@_N': 'PinY', '@_V': props.y.toString() },
+                { '@_N': 'Width', '@_V': props.width.toString() },
+                { '@_N': 'Height', '@_V': props.height.toString() },
+                { '@_N': 'LocPinX', '@_V': (props.width / 2).toString() },
+                { '@_N': 'LocPinY', '@_V': (props.height / 2).toString() }
+            ],
+            Section: []
+            // Text added at end by caller or we can do it here if props.text is final
+        };
+        if (props.masterId) {
+            shape['@_Master'] = props.masterId;
+        }
+        // Add Styles
+        if (props.fillColor) {
+            shape.Section.push((0, StyleHelpers_1.createFillSection)(props.fillColor));
+            // Standard Line for fillable shapes
+            shape.Section.push((0, StyleHelpers_1.createLineSection)({
+                color: props.lineColor || '#000000',
+                weight: '0.01'
+            }));
+        }
+        if (props.fontColor || props.bold) {
+            shape.Section.push((0, StyleHelpers_1.createCharacterSection)({
+                bold: props.bold,
+                color: props.fontColor
+            }));
+        }
+        // Add Geometry
+        // Only if NOT a Group AND NOT a Master Instance
+        if (props.type !== 'Group' && !props.masterId) {
+            shape.Section.push({
+                '@_N': 'Geometry',
+                '@_IX': '0',
+                Cell: [{ '@_N': 'NoFill', '@_V': props.fillColor ? '0' : '1' }],
+                Row: [
+                    { '@_T': 'MoveTo', '@_IX': '1', Cell: [{ '@_N': 'X', '@_V': '0' }, { '@_N': 'Y', '@_V': '0' }] },
+                    { '@_T': 'LineTo', '@_IX': '2', Cell: [{ '@_N': 'X', '@_V': props.width.toString() }, { '@_N': 'Y', '@_V': '0' }] },
+                    { '@_T': 'LineTo', '@_IX': '3', Cell: [{ '@_N': 'X', '@_V': props.width.toString() }, { '@_N': 'Y', '@_V': props.height.toString() }] },
+                    { '@_T': 'LineTo', '@_IX': '4', Cell: [{ '@_N': 'X', '@_V': '0' }, { '@_N': 'Y', '@_V': props.height.toString() }] },
+                    { '@_T': 'LineTo', '@_IX': '5', Cell: [{ '@_N': 'X', '@_V': '0' }, { '@_N': 'Y', '@_V': '0' }] }
+                ]
+            });
+        }
+        // Handle Text if provided
+        if (props.text !== undefined && props.text !== null) {
+            shape.Text = { '#text': props.text };
+        }
+        return shape;
+    }
+}
+exports.ShapeBuilder = ShapeBuilder;

package/dist/templates/MinimalVsdx.d.ts

@@ -0,0 +1,10 @@
+export declare const CONTENT_TYPES_XML: string;
+export declare const RELS_XML: string;
+export declare const DOCUMENT_XML: string;
+export declare const DOCUMENT_RELS_XML: string;
+export declare const PAGES_XML: string;
+export declare const PAGES_RELS_XML: string;
+export declare const PAGE1_XML: string;
+export declare const WINDOWS_XML: string;
+export declare const CORE_XML: string;
+export declare const APP_XML: string;

package/dist/templates/MinimalVsdx.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APP_XML = exports.CORE_XML = exports.WINDOWS_XML = exports.PAGE1_XML = exports.PAGES_RELS_XML = exports.PAGES_XML = exports.DOCUMENT_RELS_XML = exports.DOCUMENT_XML = exports.RELS_XML = exports.CONTENT_TYPES_XML = void 0;
+const VisioConstants_1 = require("../core/VisioConstants");
+exports.CONTENT_TYPES_XML = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Types xmlns="${VisioConstants_1.XML_NAMESPACES.CONTENT_TYPES}">
+    <Default Extension="rels" ContentType="${VisioConstants_1.CONTENT_TYPES.XML_RELATIONSHIPS}"/>
+    <Default Extension="xml" ContentType="${VisioConstants_1.CONTENT_TYPES.XML}"/>
+    <Override PartName="/visio/document.xml" ContentType="${VisioConstants_1.CONTENT_TYPES.VISIO_DRAWING}"/>
+    <Override PartName="/visio/pages/pages.xml" ContentType="${VisioConstants_1.CONTENT_TYPES.VISIO_PAGES}"/>
+    <Override PartName="/visio/pages/page1.xml" ContentType="${VisioConstants_1.CONTENT_TYPES.VISIO_PAGE}"/>
+    <Override PartName="/visio/windows.xml" ContentType="${VisioConstants_1.CONTENT_TYPES.VISIO_WINDOWS}"/>
+    <Override PartName="/docProps/core.xml" ContentType="${VisioConstants_1.CONTENT_TYPES.CORE_PROPERTIES}"/>
+    <Override PartName="/docProps/app.xml" ContentType="${VisioConstants_1.CONTENT_TYPES.EXTENDED_PROPERTIES}"/>
+</Types>`;
+exports.RELS_XML = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="${VisioConstants_1.XML_NAMESPACES.RELATIONSHIPS}">
+    <Relationship Id="rId1" Type="${VisioConstants_1.RELATIONSHIP_TYPES.DOCUMENT}" Target="visio/document.xml"/>
+    <Relationship Id="rId2" Type="${VisioConstants_1.RELATIONSHIP_TYPES.CORE_PROPERTIES}" Target="docProps/core.xml"/>
+    <Relationship Id="rId3" Type="${VisioConstants_1.RELATIONSHIP_TYPES.EXTENDED_PROPERTIES}" Target="docProps/app.xml"/>
+</Relationships>`;
+exports.DOCUMENT_XML = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<VisioDocument xmlns="${VisioConstants_1.XML_NAMESPACES.VISIO_MAIN}" xmlns:r="${VisioConstants_1.XML_NAMESPACES.RELATIONSHIPS_OFFICE}" xml:space="preserve" Language="en-US">
+    <DocumentSettings TopPage="0" DefaultTextStyle="0" DefaultLineStyle="0" DefaultFillStyle="0" DefaultGuideStyle="0"/>
+    <Colors>
+        <ColorEntry IX="0" RGB="#000000"/>
+        <ColorEntry IX="1" RGB="#FFFFFF"/>
+    </Colors>
+    <FaceNames/>
+    <StyleSheets/>
+</VisioDocument>`;
+exports.DOCUMENT_RELS_XML = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="${VisioConstants_1.XML_NAMESPACES.RELATIONSHIPS}">
+    <Relationship Id="rId1" Type="${VisioConstants_1.RELATIONSHIP_TYPES.PAGES}" Target="pages/pages.xml"/>
+    <Relationship Id="rId2" Type="${VisioConstants_1.RELATIONSHIP_TYPES.WINDOWS}" Target="windows.xml"/>
+</Relationships>`;
+exports.PAGES_XML = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Pages xmlns="${VisioConstants_1.XML_NAMESPACES.VISIO_MAIN}" xmlns:r="${VisioConstants_1.XML_NAMESPACES.RELATIONSHIPS_OFFICE}" xml:space="preserve">
+    <Page ID="1" Name="Page-1" NameU="Page-1" ViewScale="1" ViewCenterX="4.133858267716535" ViewCenterY="5.846456692913386">
+        <Rel r:id="rId1"/>
+    </Page>
+</Pages>`;
+exports.PAGES_RELS_XML = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="${VisioConstants_1.XML_NAMESPACES.RELATIONSHIPS}">
+    <Relationship Id="rId1" Type="${VisioConstants_1.RELATIONSHIP_TYPES.PAGE}" Target="page1.xml"/>
+</Relationships>`;
+exports.PAGE1_XML = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<PageContents xmlns="${VisioConstants_1.XML_NAMESPACES.VISIO_MAIN}" xmlns:r="${VisioConstants_1.XML_NAMESPACES.RELATIONSHIPS_OFFICE}" xml:space="preserve">
+    <Shapes/>
+</PageContents>`;
+exports.WINDOWS_XML = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Windows xmlns="${VisioConstants_1.XML_NAMESPACES.VISIO_MAIN}" xmlns:r="${VisioConstants_1.XML_NAMESPACES.RELATIONSHIPS_OFFICE}" xml:space="preserve">
+    <Window ID="0" WindowType="Drawing" WindowState="1073741824" WindowLeft="0" WindowTop="0" WindowWidth="1024" WindowHeight="768" Container="0" ContainerType="Page" Sheet="0"/>
+</Windows>`;
+exports.CORE_XML = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<cp:coreProperties xmlns:cp="${VisioConstants_1.XML_NAMESPACES.CORE_PROPERTIES}" xmlns:dc="${VisioConstants_1.XML_NAMESPACES.DC_ELEMENTS}" xmlns:dcterms="${VisioConstants_1.XML_NAMESPACES.DC_TERMS}" xmlns:dcmitype="${VisioConstants_1.XML_NAMESPACES.DC_DCMITYPE}" xmlns:xsi="${VisioConstants_1.XML_NAMESPACES.XSI}">
+    <dc:title>Drawing1</dc:title>
+    <dc:creator>ts-visio</dc:creator>
+    <cp:lastModifiedBy>ts-visio</cp:lastModifiedBy>
+    <cp:revision>1</cp:revision>
+</cp:coreProperties>`;
+exports.APP_XML = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Properties xmlns="${VisioConstants_1.XML_NAMESPACES.EXTENDED_PROPERTIES}" xmlns:vt="${VisioConstants_1.XML_NAMESPACES.DOC_PROPS_VTYPES}">
+    <Template>Basic</Template>
+    <Application>ts-visio</Application>
+</Properties>`;

package/dist/types/VisioTypes.d.ts

@@ -0,0 +1,85 @@
+export interface VisioCell {
+    N: string;
+    V: string;
+    U?: string;
+    F?: string;
+}
+export interface VisioRow {
+    T?: string;
+    N?: string;
+    IX?: number;
+    Cells: {
+        [name: string]: VisioCell;
+    };
+}
+export interface VisioSection {
+    N: string;
+    Rows: VisioRow[];
+    Cells?: {
+        [name: string]: VisioCell;
+    };
+}
+export interface VisioShape {
+    ID: string;
+    Name: string;
+    NameU?: string;
+    Type: string;
+    Master?: string;
+    Text?: string;
+    Cells: {
+        [name: string]: VisioCell;
+    };
+    Sections: {
+        [name: string]: VisioSection;
+    };
+}
+export interface VisioConnect {
+    FromSheet: string;
+    FromCell: string;
+    FromPart?: number;
+    ToSheet: string;
+    ToCell: string;
+    ToPart?: number;
+}
+export interface VisioPage {
+    ID: string;
+    Name: string;
+    NameU?: string;
+    Shapes: VisioShape[];
+    Connects: VisioConnect[];
+    isBackground?: boolean;
+    backPageId?: string;
+    PageSheet?: {
+        Cells: {
+            [name: string]: VisioCell;
+        };
+        Sections: {
+            [name: string]: VisioSection;
+        };
+    };
+}
+export declare enum VisioPropType {
+    String = 0,
+    FixedList = 1,
+    Number = 2,
+    Boolean = 3,
+    VariableList = 4,
+    Date = 5,
+    Duration = 6,
+    Currency = 7
+}
+export interface NewShapeProps {
+    text: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    id?: string;
+    fillColor?: string;
+    fontColor?: string;
+    bold?: boolean;
+    type?: string;
+    masterId?: string;
+    imgRelId?: string;
+    lineColor?: string;
+}

package/dist/types/VisioTypes.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VisioPropType = void 0;
+var VisioPropType;
+(function (VisioPropType) {
+    VisioPropType[VisioPropType["String"] = 0] = "String";
+    VisioPropType[VisioPropType["FixedList"] = 1] = "FixedList";
+    VisioPropType[VisioPropType["Number"] = 2] = "Number";
+    VisioPropType[VisioPropType["Boolean"] = 3] = "Boolean";
+    VisioPropType[VisioPropType["VariableList"] = 4] = "VariableList";
+    VisioPropType[VisioPropType["Date"] = 5] = "Date";
+    VisioPropType[VisioPropType["Duration"] = 6] = "Duration";
+    VisioPropType[VisioPropType["Currency"] = 7] = "Currency";
+})(VisioPropType || (exports.VisioPropType = VisioPropType = {}));

package/dist/utils/StubHelpers.d.ts

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

package/dist/utils/StubHelpers.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVisioShapeStub = createVisioShapeStub;
+function createVisioShapeStub(props) {
+    return {
+        ID: props.ID,
+        Name: props.Name || `Sheet.${props.ID}`,
+        Type: 'Shape',
+        Text: props.Text,
+        Cells: Object.entries(props.Cells || {}).reduce((acc, [k, v]) => {
+            acc[k] = { N: k, V: v.toString() };
+            return acc;
+        }, {}),
+        Sections: {}
+    };
+}

package/dist/utils/StyleHelpers.d.ts

@@ -0,0 +1,30 @@
+export interface VisioSection {
+    '@_N': string;
+    '@_IX'?: string;
+    Row?: any[];
+    Cell?: any[];
+}
+export declare function createFillSection(hexColor: string): VisioSection;
+export declare const ArrowHeads: {
+    None: string;
+    Standard: string;
+    Open: string;
+    Stealth: string;
+    Diamond: string;
+    Oneway: string;
+    CrowsFoot: string;
+    One: string;
+};
+export declare function createCharacterSection(props: {
+    bold?: boolean;
+    color?: string;
+}): VisioSection;
+export declare function createLineSection(props: {
+    color?: string;
+    pattern?: string;
+    weight?: string;
+    beginArrow?: string;
+    beginArrowSize?: string;
+    endArrow?: string;
+    endArrowSize?: string;
+}): VisioSection;

package/dist/utils/StyleHelpers.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrowHeads = void 0;
+exports.createFillSection = createFillSection;
+exports.createCharacterSection = createCharacterSection;
+exports.createLineSection = createLineSection;
+const hexToRgb = (hex) => {
+    // Expand shorthand form (e.g. "03F") to full form (e.g. "0033FF")
+    const shorthandRegex = /^#?([a-f\d])([a-f\d])([a-f\d])$/i;
+    hex = hex.replace(shorthandRegex, (m, r, g, b) => r + r + g + g + b + b);
+    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    return result ? `RGB(${parseInt(result[1], 16)},${parseInt(result[2], 16)},${parseInt(result[3], 16)})` : 'RGB(0,0,0)';
+};
+function createFillSection(hexColor) {
+    // Visio uses FillForegnd for the main background color.
+    // Ideally we should sanitize hexColor to be #RRGGBB.
+    const rgbFormula = hexToRgb(hexColor);
+    return {
+        '@_N': 'Fill',
+        Cell: [
+            { '@_N': 'FillForegnd', '@_V': hexColor, '@_F': rgbFormula },
+            { '@_N': 'FillBkgnd', '@_V': '#FFFFFF' }, // Default background pattern color usually white
+            { '@_N': 'FillPattern', '@_V': '1' } // 1 = Solid fill
+        ]
+    };
+}
+exports.ArrowHeads = {
+    None: '0',
+    Standard: '1',
+    Open: '2',
+    Stealth: '3',
+    Diamond: '4',
+    Oneway: '5',
+    CrowsFoot: '29', // Visio "Many"
+    One: '24', // Visio "One" (Dash) - Approximate, or '26'
+    // There are many variants, but 29 is the standard "Fork"
+};
+function createCharacterSection(props) {
+    // Visio Character Section
+    // N="Character"
+    // Row T="Character"
+    //   Cell N="Color" V="#FF0000"
+    //   Cell N="Style" V="1" (1=Bold, 2=Italic, 4=Underline) - Bitwise
+    // Visio booleans are often 0 or 1.
+    // Style=1 (Bold)
+    // Default Style is 0 (Normal)
+    let styleVal = 0;
+    if (props.bold) {
+        styleVal += 1; // Add Bold bit
+    }
+    // Default Color is usually 0 (Black) or specific hex
+    const colorVal = props.color || '#000000';
+    return {
+        '@_N': 'Character',
+        Row: [
+            {
+                '@_T': 'Character',
+                '@_IX': '0',
+                Cell: [
+                    { '@_N': 'Color', '@_V': colorVal, '@_F': hexToRgb(colorVal) },
+                    { '@_N': 'Style', '@_V': styleVal.toString() },
+                    // Size, Font, etc could go here
+                    { '@_N': 'Font', '@_V': '1' } // Default font (Calibri usually)
+                ]
+            }
+        ]
+    };
+}
+function createLineSection(props) {
+    const cells = [
+        { '@_N': 'LineColor', '@_V': props.color || '#000000' },
+        { '@_N': 'LinePattern', '@_V': props.pattern || '1' }, // 1 = Solid
+        { '@_N': 'LineWeight', '@_V': props.weight || '0.01' } // ~0.72pt
+    ];
+    // Add RGB Formula for custom colors
+    if (props.color) {
+        cells[0]['@_F'] = hexToRgb(props.color);
+    }
+    if (props.beginArrow) {
+        cells.push({ '@_N': 'BeginArrow', '@_V': props.beginArrow });
+    }
+    if (props.beginArrowSize) {
+        cells.push({ '@_N': 'BeginArrowSize', '@_V': props.beginArrowSize });
+    }
+    if (props.endArrow) {
+        cells.push({ '@_N': 'EndArrow', '@_V': props.endArrow });
+    }
+    if (props.endArrowSize) {
+        cells.push({ '@_N': 'EndArrowSize', '@_V': props.endArrowSize });
+    }
+    return {
+        '@_N': 'Line',
+        Cell: cells
+    };
+}

package/dist/utils/VisioParsers.d.ts

@@ -0,0 +1,6 @@
+import { VisioCell, VisioSection } from '../types/VisioTypes';
+export declare const asArray: <T>(obj: any) => T[];
+export declare const parseCells: (container: any) => {
+    [name: string]: VisioCell;
+};
+export declare const parseSection: (sectionData: any) => VisioSection;

package/dist/utils/VisioParsers.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSection = exports.parseCells = exports.asArray = void 0;
+const asArray = (obj) => {
+    if (!obj)
+        return [];
+    return Array.isArray(obj) ? obj : [obj];
+};
+exports.asArray = asArray;
+const parseCells = (container) => {
+    const cells = {};
+    const cellData = (0, exports.asArray)(container.Cell);
+    for (const c of cellData) {
+        const cell = c;
+        if (cell['@_N']) {
+            cells[cell['@_N']] = {
+                N: cell['@_N'],
+                V: cell['@_V'],
+                U: cell['@_U'],
+                F: cell['@_F']
+            };
+        }
+    }
+    return cells;
+};
+exports.parseCells = parseCells;
+const parseSection = (sectionData) => {
+    const rows = [];
+    const rowData = (0, exports.asArray)(sectionData.Row);
+    for (const r of rowData) {
+        const row = r;
+        rows.push({
+            T: row['@_T'],
+            N: row['@_N'],
+            IX: row['@_IX'],
+            Cells: (0, exports.parseCells)(row)
+        });
+    }
+    return {
+        N: sectionData['@_N'],
+        Rows: rows,
+        Cells: (0, exports.parseCells)(sectionData) // Attempt to parse direct cells
+    };
+};
+exports.parseSection = parseSection;

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "ts-visio",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "test": "vitest",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [],
+  "author": "Walt Zimmerman (me@waltzimmerman.com)",
+  "license": "MIT",
+  "description": "A npm package for creating Visio files (vsdx) using TypeScript.",
+  "dependencies": {
+    "fast-xml-parser": "^5.3.3",
+    "jszip": "^3.10.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17"
+  }
+}