ts-visio 1.0.2 → 1.2.0

package/dist/shapes/ShapeBuilder.js

@@ -18,8 +18,8 @@ class ShapeBuilder {
                 { '@_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() }
+                { '@_N': 'LocPinX', '@_V': (props.width / 2).toString(), '@_F': 'Width*0.5' },
+                { '@_N': 'LocPinY', '@_V': (props.height / 2).toString(), '@_F': 'Height*0.5' }
             ],
             Section: []
             // Text added at end by caller or we can do it here if props.text is final
@@ -36,12 +36,20 @@ class ShapeBuilder {
                 weight: '0.01'
             }));
         }
-        if (props.fontColor || props.bold) {
+        if (props.fontColor || props.bold || props.fontSize !== undefined || props.fontFamily !== undefined) {
             shape.Section.push((0, StyleHelpers_1.createCharacterSection)({
                 bold: props.bold,
-                color: props.fontColor
+                color: props.fontColor,
+                fontSize: props.fontSize,
+                fontFamily: props.fontFamily,
             }));
         }
+        if (props.horzAlign !== undefined) {
+            shape.Section.push((0, StyleHelpers_1.createParagraphSection)(props.horzAlign));
+        }
+        if (props.verticalAlign !== undefined) {
+            shape.Cell.push({ '@_N': 'VerticalAlign', '@_V': (0, StyleHelpers_1.vertAlignValue)(props.verticalAlign) });
+        }
         // Add Geometry
         // Only if NOT a Group AND NOT a Master Instance
         if (props.type !== 'Group' && !props.masterId) {
@@ -51,9 +59,9 @@ class ShapeBuilder {
                 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': '2', Cell: [{ '@_N': 'X', '@_V': props.width.toString(), '@_F': 'Width' }, { '@_N': 'Y', '@_V': '0' }] },
+                    { '@_T': 'LineTo', '@_IX': '3', Cell: [{ '@_N': 'X', '@_V': props.width.toString(), '@_F': 'Width' }, { '@_N': 'Y', '@_V': props.height.toString(), '@_F': 'Height' }] },
+                    { '@_T': 'LineTo', '@_IX': '4', Cell: [{ '@_N': 'X', '@_V': '0' }, { '@_N': 'Y', '@_V': props.height.toString(), '@_F': 'Height' }] },
                     { '@_T': 'LineTo', '@_IX': '5', Cell: [{ '@_N': 'X', '@_V': '0' }, { '@_N': 'Y', '@_V': '0' }] }
                 ]
             });

package/dist/types/VisioTypes.d.ts

@@ -45,6 +45,10 @@ export interface VisioPage {
     ID: string;
     Name: string;
     NameU?: string;
+    /** Resolved OPC part path (e.g. "visio/pages/page2.xml"). When present,
+     *  this takes precedence over the ID-derived fallback path so that loaded
+     *  files with non-sequential page filenames are handled correctly. */
+    xmlPath?: string;
     Shapes: VisioShape[];
     Connects: VisioConnect[];
     isBackground?: boolean;
@@ -78,6 +82,14 @@ export interface NewShapeProps {
     fillColor?: string;
     fontColor?: string;
     bold?: boolean;
+    /** Font size in points (e.g. 14 for 14pt). */
+    fontSize?: number;
+    /** Font family name (e.g. "Arial", "Times New Roman"). */
+    fontFamily?: string;
+    /** Horizontal text alignment within the shape. */
+    horzAlign?: 'left' | 'center' | 'right' | 'justify';
+    /** Vertical text alignment within the shape. */
+    verticalAlign?: 'top' | 'middle' | 'bottom';
     type?: string;
     masterId?: string;
     imgRelId?: string;

package/dist/utils/StyleHelpers.d.ts

@@ -15,16 +15,33 @@ export declare const ArrowHeads: {
     CrowsFoot: string;
     One: string;
 };
+declare const HORZ_ALIGN_VALUES: {
+    readonly left: "0";
+    readonly center: "1";
+    readonly right: "2";
+    readonly justify: "3";
+};
+declare const VERT_ALIGN_VALUES: {
+    readonly top: "0";
+    readonly middle: "1";
+    readonly bottom: "2";
+};
+export type HorzAlign = keyof typeof HORZ_ALIGN_VALUES;
+export type VertAlign = keyof typeof VERT_ALIGN_VALUES;
+export declare function horzAlignValue(align: HorzAlign): string;
+export declare function vertAlignValue(align: VertAlign): string;
 export declare function createCharacterSection(props: {
     bold?: boolean;
     color?: string;
+    /** Font size in points (e.g. 12 for 12pt). Stored internally as inches (pt / 72). */
+    fontSize?: number;
+    /** Font family name (e.g. "Arial"). Uses FONT() formula for portability. */
+    fontFamily?: string;
 }): VisioSection;
+export declare function createParagraphSection(horzAlign: HorzAlign): VisioSection;
 export declare function createLineSection(props: {
     color?: string;
     pattern?: string;
     weight?: string;
-    beginArrow?: string;
-    beginArrowSize?: string;
-    endArrow?: string;
-    endArrowSize?: string;
 }): VisioSection;
+export {};

package/dist/utils/StyleHelpers.js

@@ -2,7 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ArrowHeads = void 0;
 exports.createFillSection = createFillSection;
+exports.horzAlignValue = horzAlignValue;
+exports.vertAlignValue = vertAlignValue;
 exports.createCharacterSection = createCharacterSection;
+exports.createParagraphSection = createParagraphSection;
 exports.createLineSection = createLineSection;
 const hexToRgb = (hex) => {
     // Expand shorthand form (e.g. "03F") to full form (e.g. "0033FF")
@@ -35,32 +38,66 @@ exports.ArrowHeads = {
     One: '24', // Visio "One" (Dash) - Approximate, or '26'
     // There are many variants, but 29 is the standard "Fork"
 };
+const HORZ_ALIGN_VALUES = {
+    left: '0',
+    center: '1',
+    right: '2',
+    justify: '3',
+};
+const VERT_ALIGN_VALUES = {
+    top: '0',
+    middle: '1',
+    bottom: '2',
+};
+function horzAlignValue(align) {
+    return HORZ_ALIGN_VALUES[align];
+}
+function vertAlignValue(align) {
+    return VERT_ALIGN_VALUES[align];
+}
 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
+        styleVal += 1; // Bold bit
     }
-    // Default Color is usually 0 (Black) or specific hex
     const colorVal = props.color || '#000000';
+    const cells = [
+        { '@_N': 'Color', '@_V': colorVal, '@_F': hexToRgb(colorVal) },
+        { '@_N': 'Style', '@_V': styleVal.toString() },
+    ];
+    if (props.fontSize !== undefined) {
+        // Visio stores size in inches internally; @_U="PT" is a display hint for the ShapeSheet UI
+        const sizeInInches = props.fontSize / 72;
+        cells.push({ '@_N': 'Size', '@_V': sizeInInches.toString(), '@_U': 'PT' });
+    }
+    if (props.fontFamily !== undefined) {
+        // FONT("name") formula lets Visio resolve the font by name at load time.
+        // @_V="0" is a safe placeholder (document default font) used before Visio evaluates the formula.
+        cells.push({ '@_N': 'Font', '@_V': '0', '@_F': `FONT("${props.fontFamily}")` });
+    }
+    else {
+        cells.push({ '@_N': 'Font', '@_V': '1' }); // Default (Calibri)
+    }
     return {
         '@_N': 'Character',
         Row: [
             {
                 '@_T': 'Character',
                 '@_IX': '0',
+                Cell: cells,
+            }
+        ]
+    };
+}
+function createParagraphSection(horzAlign) {
+    return {
+        '@_N': 'Paragraph',
+        Row: [
+            {
+                '@_T': 'Paragraph',
+                '@_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)
+                    { '@_N': 'HorzAlign', '@_V': HORZ_ALIGN_VALUES[horzAlign] },
                 ]
             }
         ]
@@ -70,24 +107,12 @@ 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
+        { '@_N': 'LineWeight', '@_V': props.weight || '0.01', '@_U': 'IN' } // ~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/XmlHelper.d.ts

@@ -0,0 +1,39 @@
+import { XMLParser, XMLBuilder } from 'fast-xml-parser';
+/**
+ * Standard XMLParser options used across all Visio XML parts.
+ *
+ * - ignoreDeclaration: false  → preserves <?xml?> in the parsed object
+ * - ignoreAttributes: false   → preserves xmlns, xmlns:r, xml:space, etc.
+ * - parseAttributeValue: false → keeps attribute values as strings (avoids
+ *   numeric coercion on IDs, versions, etc.)
+ */
+export declare const PARSER_OPTIONS: {
+    readonly ignoreAttributes: false;
+    readonly attributeNamePrefix: "@_";
+    readonly ignoreDeclaration: false;
+    readonly parseAttributeValue: false;
+};
+/**
+ * Standard XMLBuilder options used across all Visio XML parts.
+ *
+ * - suppressBooleanAttributes: false → always emit attribute="value", never
+ *   bare attribute (important for Visio attributes like xml:space="preserve")
+ */
+export declare const BUILDER_OPTIONS: {
+    readonly ignoreAttributes: false;
+    readonly attributeNamePrefix: "@_";
+    readonly format: true;
+    readonly suppressBooleanAttributes: false;
+};
+export declare function createXmlParser(): XMLParser;
+export declare function createXmlBuilder(): XMLBuilder;
+/**
+ * Serialize a parsed XML object to a string, guaranteeing the XML declaration
+ * is always present at the top of the output.
+ *
+ * fast-xml-parser's XMLBuilder re-emits the `?xml` key when it is present in
+ * the parsed object (requires ignoreDeclaration: false on the parser side).
+ * This function acts as a safety net for cases where the declaration was
+ * absent in the source XML or was stripped for any reason.
+ */
+export declare function buildXml(builder: XMLBuilder, parsed: unknown): string;

package/dist/utils/XmlHelper.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILDER_OPTIONS = exports.PARSER_OPTIONS = void 0;
+exports.createXmlParser = createXmlParser;
+exports.createXmlBuilder = createXmlBuilder;
+exports.buildXml = buildXml;
+const fast_xml_parser_1 = require("fast-xml-parser");
+const XML_DECLARATION = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>';
+/**
+ * Standard XMLParser options used across all Visio XML parts.
+ *
+ * - ignoreDeclaration: false  → preserves <?xml?> in the parsed object
+ * - ignoreAttributes: false   → preserves xmlns, xmlns:r, xml:space, etc.
+ * - parseAttributeValue: false → keeps attribute values as strings (avoids
+ *   numeric coercion on IDs, versions, etc.)
+ */
+exports.PARSER_OPTIONS = {
+    ignoreAttributes: false,
+    attributeNamePrefix: '@_',
+    ignoreDeclaration: false,
+    parseAttributeValue: false,
+};
+/**
+ * Standard XMLBuilder options used across all Visio XML parts.
+ *
+ * - suppressBooleanAttributes: false → always emit attribute="value", never
+ *   bare attribute (important for Visio attributes like xml:space="preserve")
+ */
+exports.BUILDER_OPTIONS = {
+    ignoreAttributes: false,
+    attributeNamePrefix: '@_',
+    format: true,
+    suppressBooleanAttributes: false,
+};
+function createXmlParser() {
+    return new fast_xml_parser_1.XMLParser(exports.PARSER_OPTIONS);
+}
+function createXmlBuilder() {
+    return new fast_xml_parser_1.XMLBuilder(exports.BUILDER_OPTIONS);
+}
+/**
+ * Serialize a parsed XML object to a string, guaranteeing the XML declaration
+ * is always present at the top of the output.
+ *
+ * fast-xml-parser's XMLBuilder re-emits the `?xml` key when it is present in
+ * the parsed object (requires ignoreDeclaration: false on the parser side).
+ * This function acts as a safety net for cases where the declaration was
+ * absent in the source XML or was stripped for any reason.
+ */
+function buildXml(builder, parsed) {
+    const xml = builder.build(parsed);
+    if (xml.trimStart().startsWith('<?xml')) {
+        return xml;
+    }
+    return XML_DECLARATION + '\n' + xml;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-visio",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -28,4 +28,4 @@
     "typescript": "^5.9.3",
     "vitest": "^4.0.17"
   }
-}
+}