ts-visio 1.3.0 → 1.5.0

package/README.md

@@ -18,12 +18,13 @@ Built using specific schema-level abstractions to handle the complex internal st
 - **Modify Content**: Update text content of shapes.
 - **Create Shapes**: Rectangles, ellipses, diamonds, rounded rectangles, triangles, parallelograms.
 - **Connect Shapes**: Dynamic connectors with arrow styles, line styling, and routing (straight / orthogonal / curved).
-- **Text Styling**: Font size, font family, bold, color, horizontal/vertical alignment.
+- **Text Styling**: Font size, font family, bold, italic, underline, strikethrough, color, alignment, paragraph spacing, and text margins.
 - **Shape Transformations**: Rotate, flip (X/Y), and resize shapes via a fluent API.
 - **Deletion**: Remove shapes and pages cleanly (including orphaned connectors and relationships).
 - **Lookup API**: Find shapes by ID, predicate, or look up pages by name.
 - **Read-Back API**: Read custom properties, hyperlinks, and layer assignments from existing shapes.
 - **Page Size & Orientation**: Set canvas dimensions with named sizes (`Letter`, `A4`, …) or raw inches; rotate between portrait and landscape.
+- **Document Metadata**: Read and write document properties (title, author, description, keywords, company, dates) via `doc.getMetadata()` / `doc.setMetadata()`.
 
 Feature gaps are being tracked in [FEATURES.md](./FEATURES.md).
 
@@ -490,6 +491,73 @@ Available named sizes in `PageSizes`: `Letter`, `Legal`, `Tabloid`, `A3`, `A4`,
 
 ---
 
+#### 26. Document Metadata
+Set and read document-level properties that appear in Visio's Document Properties dialog.
+
+```typescript
+// Write metadata (only supplied fields are changed)
+doc.setMetadata({
+    title:          'Network Topology',
+    author:         'Alice',
+    description:    'Data-centre interconnect diagram',
+    keywords:       'network datacenter cloud',
+    lastModifiedBy: 'CI pipeline',
+    company:        'ACME Corp',
+    manager:        'Bob',
+    created:        new Date('2025-01-01T00:00:00Z'),
+    modified:       new Date(),
+});
+
+// Read back all metadata fields
+const meta = doc.getMetadata();
+console.log(meta.title);    // 'Network Topology'
+console.log(meta.author);   // 'Alice'
+console.log(meta.company);  // 'ACME Corp'
+console.log(meta.created);  // Date object
+```
+
+Fields map to OPC parts: `title`, `author`, `description`, `keywords`, `lastModifiedBy`,
+`created`, `modified` → `docProps/core.xml`; `company`, `manager` → `docProps/app.xml`.
+
+---
+
+#### 27. Rich Text Formatting
+Italic, underline, strikethrough, paragraph spacing, and text block margins are available both at shape-creation time and via `shape.setStyle()`.
+
+```typescript
+// At creation time
+const shape = await page.addShape({
+    text: 'Important',
+    x: 2, y: 3, width: 3, height: 1,
+    bold: true,
+    italic: true,
+    underline: true,
+    strikethrough: false,
+    // Paragraph spacing (in points)
+    spaceBefore: 6,
+    spaceAfter: 6,
+    lineSpacing: 1.5,  // 1.5× line height
+    // Text block margins (in inches)
+    textMarginTop:    0.1,
+    textMarginBottom: 0.1,
+    textMarginLeft:   0.1,
+    textMarginRight:  0.1,
+});
+
+// Post-creation via setStyle()
+await shape.setStyle({
+    italic: true,
+    lineSpacing: 2.0,         // double spacing
+    textMarginTop: 0.15,
+    textMarginLeft: 0.05,
+});
+```
+
+`lineSpacing` is a multiplier: `1.0` = single, `1.5` = 1.5×, `2.0` = double.
+`spaceBefore` / `spaceAfter` are in **points**. Text margins are in **inches**.
+
+---
+
 ## Examples
 
 Check out the [examples](./examples) directory for complete scripts.

package/dist/ShapeModifier.d.ts

@@ -121,6 +121,12 @@ export interface ShapeStyle {
     fillColor?: string;
     fontColor?: string;
     bold?: boolean;
+    /** Italic text. */
+    italic?: boolean;
+    /** Underline text. */
+    underline?: boolean;
+    /** Strikethrough text. */
+    strikethrough?: boolean;
     /** Font size in points (e.g. 14 for 14pt). */
     fontSize?: number;
     /** Font family name (e.g. "Arial"). */
@@ -129,4 +135,18 @@ export interface ShapeStyle {
     horzAlign?: HorzAlign;
     /** Vertical text alignment. */
     verticalAlign?: VertAlign;
+    /** Space before each paragraph in **points**. */
+    spaceBefore?: number;
+    /** Space after each paragraph in **points**. */
+    spaceAfter?: number;
+    /** Line-height multiplier (1.0 = single, 1.5 = 1.5×, 2.0 = double). */
+    lineSpacing?: number;
+    /** Top text margin in inches. */
+    textMarginTop?: number;
+    /** Bottom text margin in inches. */
+    textMarginBottom?: number;
+    /** Left text margin in inches. */
+    textMarginLeft?: number;
+    /** Right text margin in inches. */
+    textMarginRight?: number;
 }

package/dist/ShapeModifier.js

@@ -349,19 +349,52 @@ class ShapeModifier {
             shape.Section.push((0, StyleHelpers_1.createFillSection)(style.fillColor));
         }
         // Update/Add Character (Font/Text Style)
-        if (style.fontColor || style.bold !== undefined || style.fontSize !== undefined || style.fontFamily !== undefined) {
+        const hasCharProps = style.fontColor !== undefined
+            || style.bold !== undefined
+            || style.italic !== undefined
+            || style.underline !== undefined
+            || style.strikethrough !== undefined
+            || style.fontSize !== undefined
+            || style.fontFamily !== undefined;
+        if (hasCharProps) {
             shape.Section = shape.Section.filter((s) => s['@_N'] !== 'Character');
             shape.Section.push((0, StyleHelpers_1.createCharacterSection)({
                 bold: style.bold,
+                italic: style.italic,
+                underline: style.underline,
+                strikethrough: style.strikethrough,
                 color: style.fontColor,
                 fontSize: style.fontSize,
                 fontFamily: style.fontFamily,
             }));
         }
-        // Update/Add Paragraph (Horizontal Alignment)
-        if (style.horzAlign !== undefined) {
+        // Update/Add Paragraph
+        const hasParagraphProps = style.horzAlign !== undefined
+            || style.spaceBefore !== undefined
+            || style.spaceAfter !== undefined
+            || style.lineSpacing !== undefined;
+        if (hasParagraphProps) {
             shape.Section = shape.Section.filter((s) => s['@_N'] !== 'Paragraph');
-            shape.Section.push((0, StyleHelpers_1.createParagraphSection)(style.horzAlign));
+            shape.Section.push((0, StyleHelpers_1.createParagraphSection)({
+                horzAlign: style.horzAlign,
+                spaceBefore: style.spaceBefore,
+                spaceAfter: style.spaceAfter,
+                lineSpacing: style.lineSpacing,
+            }));
+        }
+        // Update/Add TextBlock (text margins)
+        const hasTextBlockProps = style.textMarginTop !== undefined
+            || style.textMarginBottom !== undefined
+            || style.textMarginLeft !== undefined
+            || style.textMarginRight !== undefined;
+        if (hasTextBlockProps) {
+            shape.Section = shape.Section.filter((s) => s['@_N'] !== 'TextBlock');
+            shape.Section.push((0, StyleHelpers_1.createTextBlockSection)({
+                topMargin: style.textMarginTop,
+                bottomMargin: style.textMarginBottom,
+                leftMargin: style.textMarginLeft,
+                rightMargin: style.textMarginRight,
+            }));
         }
         // Update/Add VerticalAlign (top-level shape Cell)
         if (style.verticalAlign !== undefined) {

package/dist/VisioDocument.d.ts

@@ -1,9 +1,11 @@
 import { Page } from './Page';
+import { DocumentMetadata } from './types/VisioTypes';
 export declare class VisioDocument {
     private pkg;
     private pageManager;
     private _pageCache;
     private mediaManager;
+    private metadataManager;
     private constructor();
     static create(): Promise<VisioDocument>;
     static load(pathOrBuffer: string | Buffer | ArrayBuffer | Uint8Array): Promise<VisioDocument>;
@@ -27,5 +29,18 @@ export declare class VisioDocument {
      * and any BackPage references from other pages.
      */
     deletePage(page: Page): Promise<void>;
+    /**
+     * Read document metadata from `docProps/core.xml` and `docProps/app.xml`.
+     * Fields not present in the file are returned as `undefined`.
+     */
+    getMetadata(): DocumentMetadata;
+    /**
+     * Write document metadata. Only the supplied fields are changed;
+     * all other fields keep their existing values.
+     *
+     * @example
+     * doc.setMetadata({ title: 'My Diagram', author: 'Alice', company: 'ACME' });
+     */
+    setMetadata(props: Partial<DocumentMetadata>): void;
     save(filename?: string): Promise<Buffer>;
 }

package/dist/VisioDocument.js

@@ -38,12 +38,14 @@ const VisioPackage_1 = require("./VisioPackage");
 const PageManager_1 = require("./core/PageManager");
 const Page_1 = require("./Page");
 const MediaManager_1 = require("./core/MediaManager");
+const MetadataManager_1 = require("./core/MetadataManager");
 class VisioDocument {
     constructor(pkg) {
         this.pkg = pkg;
         this._pageCache = null;
         this.pageManager = new PageManager_1.PageManager(pkg);
         this.mediaManager = new MediaManager_1.MediaManager(pkg);
+        this.metadataManager = new MetadataManager_1.MetadataManager(pkg);
     }
     static async create() {
         const pkg = await VisioPackage_1.VisioPackage.create();
@@ -131,6 +133,23 @@ class VisioDocument {
         await this.pageManager.deletePage(page.id);
         this._pageCache = null;
     }
+    /**
+     * Read document metadata from `docProps/core.xml` and `docProps/app.xml`.
+     * Fields not present in the file are returned as `undefined`.
+     */
+    getMetadata() {
+        return this.metadataManager.getMetadata();
+    }
+    /**
+     * Write document metadata. Only the supplied fields are changed;
+     * all other fields keep their existing values.
+     *
+     * @example
+     * doc.setMetadata({ title: 'My Diagram', author: 'Alice', company: 'ACME' });
+     */
+    setMetadata(props) {
+        this.metadataManager.setMetadata(props);
+    }
     async save(filename) {
         return this.pkg.save(filename);
     }

package/dist/core/MetadataManager.d.ts

@@ -0,0 +1,22 @@
+import { VisioPackage } from '../VisioPackage';
+import { DocumentMetadata } from '../types/VisioTypes';
+export declare class MetadataManager {
+    private pkg;
+    private parser;
+    private builder;
+    constructor(pkg: VisioPackage);
+    /** Read document metadata from `docProps/core.xml` and `docProps/app.xml`. */
+    getMetadata(): DocumentMetadata;
+    /** Merge the supplied fields into the existing metadata and persist to the package. */
+    setMetadata(props: Partial<DocumentMetadata>): void;
+    /** Extract a string from a parsed XML node (handles plain strings and #text objects). */
+    private str;
+    /** Parse an ISO datetime string into a Date (returns undefined on failure). */
+    private date;
+    private parsedCore;
+    private parsedApp;
+    private writeCore;
+    private writeApp;
+    private blankCoreParsed;
+    private blankAppParsed;
+}

package/dist/core/MetadataManager.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataManager = void 0;
+const VisioConstants_1 = require("./VisioConstants");
+const XmlHelper_1 = require("../utils/XmlHelper");
+class MetadataManager {
+    constructor(pkg) {
+        this.pkg = pkg;
+        this.parser = (0, XmlHelper_1.createXmlParser)();
+        this.builder = (0, XmlHelper_1.createXmlBuilder)();
+    }
+    // ---- public API --------------------------------------------------------
+    /** Read document metadata from `docProps/core.xml` and `docProps/app.xml`. */
+    getMetadata() {
+        const core = this.parsedCore();
+        const app = this.parsedApp();
+        return {
+            title: this.str(core['dc:title']),
+            author: this.str(core['dc:creator']),
+            description: this.str(core['dc:description']),
+            keywords: this.str(core['cp:keywords']),
+            lastModifiedBy: this.str(core['cp:lastModifiedBy']),
+            created: this.date(core['dcterms:created']),
+            modified: this.date(core['dcterms:modified']),
+            company: this.str(app['Company']),
+            manager: this.str(app['Manager']),
+        };
+    }
+    /** Merge the supplied fields into the existing metadata and persist to the package. */
+    setMetadata(props) {
+        const coreKeys = [
+            'title', 'author', 'description', 'keywords', 'lastModifiedBy', 'created', 'modified',
+        ];
+        const appKeys = ['company', 'manager'];
+        if (coreKeys.some(k => k in props))
+            this.writeCore(props);
+        if (appKeys.some(k => k in props))
+            this.writeApp(props);
+    }
+    // ---- private helpers ---------------------------------------------------
+    /** Extract a string from a parsed XML node (handles plain strings and #text objects). */
+    str(val) {
+        if (val === undefined || val === null)
+            return undefined;
+        if (typeof val === 'string')
+            return val || undefined;
+        if (typeof val === 'object' && '#text' in val) {
+            const t = val['#text'];
+            const s = typeof t === 'string' ? t : String(t);
+            return s || undefined;
+        }
+        return undefined;
+    }
+    /** Parse an ISO datetime string into a Date (returns undefined on failure). */
+    date(val) {
+        const text = this.str(val);
+        if (!text)
+            return undefined;
+        const d = new Date(text);
+        return isNaN(d.getTime()) ? undefined : d;
+    }
+    parsedCore() {
+        try {
+            const xml = this.pkg.getFileText('docProps/core.xml');
+            const parsed = this.parser.parse(xml);
+            return parsed['cp:coreProperties'] ?? {};
+        }
+        catch {
+            return {};
+        }
+    }
+    parsedApp() {
+        try {
+            const xml = this.pkg.getFileText('docProps/app.xml');
+            const parsed = this.parser.parse(xml);
+            return parsed['Properties'] ?? {};
+        }
+        catch {
+            return {};
+        }
+    }
+    writeCore(props) {
+        let parsed;
+        try {
+            const xml = this.pkg.getFileText('docProps/core.xml');
+            parsed = this.parser.parse(xml);
+        }
+        catch {
+            parsed = this.blankCoreParsed();
+        }
+        const root = parsed['cp:coreProperties'];
+        if ('title' in props)
+            root['dc:title'] = props.title ?? '';
+        if ('author' in props)
+            root['dc:creator'] = props.author ?? '';
+        if ('description' in props)
+            root['dc:description'] = props.description ?? '';
+        if ('keywords' in props)
+            root['cp:keywords'] = props.keywords ?? '';
+        if ('lastModifiedBy' in props)
+            root['cp:lastModifiedBy'] = props.lastModifiedBy ?? '';
+        if ('created' in props && props.created !== undefined) {
+            root['dcterms:created'] = {
+                '@_xsi:type': 'dcterms:W3CDTF',
+                '#text': props.created.toISOString(),
+            };
+        }
+        if ('modified' in props && props.modified !== undefined) {
+            root['dcterms:modified'] = {
+                '@_xsi:type': 'dcterms:W3CDTF',
+                '#text': props.modified.toISOString(),
+            };
+        }
+        this.pkg.updateFile('docProps/core.xml', (0, XmlHelper_1.buildXml)(this.builder, parsed));
+    }
+    writeApp(props) {
+        let parsed;
+        try {
+            const xml = this.pkg.getFileText('docProps/app.xml');
+            parsed = this.parser.parse(xml);
+        }
+        catch {
+            parsed = this.blankAppParsed();
+        }
+        const root = parsed['Properties'];
+        if ('company' in props)
+            root['Company'] = props.company ?? '';
+        if ('manager' in props)
+            root['Manager'] = props.manager ?? '';
+        this.pkg.updateFile('docProps/app.xml', (0, XmlHelper_1.buildXml)(this.builder, parsed));
+    }
+    blankCoreParsed() {
+        return {
+            '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,
+            },
+        };
+    }
+    blankAppParsed() {
+        return {
+            'Properties': {
+                '@_xmlns': VisioConstants_1.XML_NAMESPACES.EXTENDED_PROPERTIES,
+                '@_xmlns:vt': VisioConstants_1.XML_NAMESPACES.DOC_PROPS_VTYPES,
+                'Application': 'ts-visio',
+                'Template': 'Basic',
+            },
+        };
+    }
+}
+exports.MetadataManager = MetadataManager;

package/dist/shapes/ShapeBuilder.js

@@ -37,16 +37,47 @@ class ShapeBuilder {
                 weight: '0.01'
             }));
         }
-        if (props.fontColor || props.bold || props.fontSize !== undefined || props.fontFamily !== undefined) {
+        const hasCharProps = props.fontColor !== undefined
+            || props.bold !== undefined
+            || props.italic !== undefined
+            || props.underline !== undefined
+            || props.strikethrough !== undefined
+            || props.fontSize !== undefined
+            || props.fontFamily !== undefined;
+        if (hasCharProps) {
             shape.Section.push((0, StyleHelpers_1.createCharacterSection)({
                 bold: props.bold,
+                italic: props.italic,
+                underline: props.underline,
+                strikethrough: props.strikethrough,
                 color: props.fontColor,
                 fontSize: props.fontSize,
                 fontFamily: props.fontFamily,
             }));
         }
-        if (props.horzAlign !== undefined) {
-            shape.Section.push((0, StyleHelpers_1.createParagraphSection)(props.horzAlign));
+        const hasParagraphProps = props.horzAlign !== undefined
+            || props.spaceBefore !== undefined
+            || props.spaceAfter !== undefined
+            || props.lineSpacing !== undefined;
+        if (hasParagraphProps) {
+            shape.Section.push((0, StyleHelpers_1.createParagraphSection)({
+                horzAlign: props.horzAlign,
+                spaceBefore: props.spaceBefore,
+                spaceAfter: props.spaceAfter,
+                lineSpacing: props.lineSpacing,
+            }));
+        }
+        const hasTextBlockProps = props.textMarginTop !== undefined
+            || props.textMarginBottom !== undefined
+            || props.textMarginLeft !== undefined
+            || props.textMarginRight !== undefined;
+        if (hasTextBlockProps) {
+            shape.Section.push((0, StyleHelpers_1.createTextBlockSection)({
+                topMargin: props.textMarginTop,
+                bottomMargin: props.textMarginBottom,
+                leftMargin: props.textMarginLeft,
+                rightMargin: props.textMarginRight,
+            }));
         }
         if (props.verticalAlign !== undefined) {
             shape.Cell.push({ '@_N': 'VerticalAlign', '@_V': (0, StyleHelpers_1.vertAlignValue)(props.verticalAlign) });

package/dist/types/VisioTypes.d.ts

@@ -72,6 +72,27 @@ export declare enum VisioPropType {
     Duration = 6,
     Currency = 7
 }
+/** Document-level metadata that maps to `docProps/core.xml` and `docProps/app.xml`. */
+export interface DocumentMetadata {
+    /** Document title (`dc:title`). */
+    title?: string;
+    /** Author / creator (`dc:creator`). */
+    author?: string;
+    /** Short description (`dc:description`). */
+    description?: string;
+    /** Space-separated keywords (`cp:keywords`). */
+    keywords?: string;
+    /** Last-modified-by user (`cp:lastModifiedBy`). */
+    lastModifiedBy?: string;
+    /** Company name from `app.xml` `<Company>`. */
+    company?: string;
+    /** Manager name from `app.xml` `<Manager>`. */
+    manager?: string;
+    /** Document creation timestamp (`dcterms:created`). */
+    created?: Date;
+    /** Last-modified timestamp (`dcterms:modified`). */
+    modified?: Date;
+}
 export type PageOrientation = 'portrait' | 'landscape';
 /** Common paper sizes in inches (width × height in portrait orientation). */
 export declare const PageSizes: {
@@ -151,4 +172,24 @@ export interface NewShapeProps {
     masterId?: string;
     imgRelId?: string;
     lineColor?: string;
+    /** Italic text. */
+    italic?: boolean;
+    /** Underline text. */
+    underline?: boolean;
+    /** Strikethrough text. */
+    strikethrough?: boolean;
+    /** Space before each paragraph in **points**. */
+    spaceBefore?: number;
+    /** Space after each paragraph in **points**. */
+    spaceAfter?: number;
+    /** Line-height multiplier (1.0 = single, 1.5 = 1.5×, 2.0 = double). */
+    lineSpacing?: number;
+    /** Top text margin in inches. */
+    textMarginTop?: number;
+    /** Bottom text margin in inches. */
+    textMarginBottom?: number;
+    /** Left text margin in inches. */
+    textMarginLeft?: number;
+    /** Right text margin in inches. */
+    textMarginRight?: number;
 }

package/dist/utils/StyleHelpers.d.ts

@@ -32,13 +32,50 @@ export declare function horzAlignValue(align: HorzAlign): string;
 export declare function vertAlignValue(align: VertAlign): string;
 export declare function createCharacterSection(props: {
     bold?: boolean;
+    /** Italic text (Style bit 2). */
+    italic?: boolean;
+    /** Underline text (Style bit 4). */
+    underline?: boolean;
+    /** Strikethrough text (Style bit 8). */
+    strikethrough?: 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 interface ParagraphProps {
+    /** Horizontal text alignment within the paragraph. */
+    horzAlign?: HorzAlign;
+    /**
+     * Space before each paragraph in **points**.
+     * Converted to inches internally (pt / 72).
+     */
+    spaceBefore?: number;
+    /**
+     * Space after each paragraph in **points**.
+     * Converted to inches internally (pt / 72).
+     */
+    spaceAfter?: number;
+    /**
+     * Line-height multiplier (1.0 = single, 1.5 = 1.5×, 2.0 = double).
+     * Stored as a negative value in Visio's `SpLine` cell (negative means
+     * proportional; positive means absolute in inches).
+     */
+    lineSpacing?: number;
+}
+export declare function createParagraphSection(props: ParagraphProps): VisioSection;
+export interface TextBlockProps {
+    /** Top text margin in inches. */
+    topMargin?: number;
+    /** Bottom text margin in inches. */
+    bottomMargin?: number;
+    /** Left text margin in inches. */
+    leftMargin?: number;
+    /** Right text margin in inches. */
+    rightMargin?: number;
+}
+export declare function createTextBlockSection(props: TextBlockProps): VisioSection;
 export declare function createLineSection(props: {
     color?: string;
     pattern?: string;

package/dist/utils/StyleHelpers.js

@@ -6,6 +6,7 @@ exports.horzAlignValue = horzAlignValue;
 exports.vertAlignValue = vertAlignValue;
 exports.createCharacterSection = createCharacterSection;
 exports.createParagraphSection = createParagraphSection;
+exports.createTextBlockSection = createTextBlockSection;
 exports.createLineSection = createLineSection;
 const hexToRgb = (hex) => {
     // Expand shorthand form (e.g. "03F") to full form (e.g. "0033FF")
@@ -57,9 +58,14 @@ function vertAlignValue(align) {
 }
 function createCharacterSection(props) {
     let styleVal = 0;
-    if (props.bold) {
-        styleVal += 1; // Bold bit
-    }
+    if (props.bold)
+        styleVal |= 1;
+    if (props.italic)
+        styleVal |= 2;
+    if (props.underline)
+        styleVal |= 4;
+    if (props.strikethrough)
+        styleVal |= 8;
     const colorVal = props.color || '#000000';
     const cells = [
         { '@_N': 'Color', '@_V': colorVal, '@_F': hexToRgb(colorVal) },
@@ -89,20 +95,47 @@ function createCharacterSection(props) {
         ]
     };
 }
-function createParagraphSection(horzAlign) {
+function createParagraphSection(props) {
+    const cells = [];
+    if (props.horzAlign !== undefined) {
+        cells.push({ '@_N': 'HorzAlign', '@_V': HORZ_ALIGN_VALUES[props.horzAlign] });
+    }
+    if (props.spaceBefore !== undefined) {
+        cells.push({ '@_N': 'SpBefore', '@_V': (props.spaceBefore / 72).toString(), '@_U': 'PT' });
+    }
+    if (props.spaceAfter !== undefined) {
+        cells.push({ '@_N': 'SpAfter', '@_V': (props.spaceAfter / 72).toString(), '@_U': 'PT' });
+    }
+    if (props.lineSpacing !== undefined) {
+        // Negative value = proportional multiplier; positive = absolute (inches)
+        cells.push({ '@_N': 'SpLine', '@_V': (-props.lineSpacing).toString() });
+    }
     return {
         '@_N': 'Paragraph',
         Row: [
             {
                 '@_T': 'Paragraph',
                 '@_IX': '0',
-                Cell: [
-                    { '@_N': 'HorzAlign', '@_V': HORZ_ALIGN_VALUES[horzAlign] },
-                ]
+                Cell: cells,
             }
         ]
     };
 }
+function createTextBlockSection(props) {
+    const cells = [];
+    if (props.topMargin !== undefined)
+        cells.push({ '@_N': 'TopMargin', '@_V': props.topMargin.toString(), '@_U': 'IN' });
+    if (props.bottomMargin !== undefined)
+        cells.push({ '@_N': 'BottomMargin', '@_V': props.bottomMargin.toString(), '@_U': 'IN' });
+    if (props.leftMargin !== undefined)
+        cells.push({ '@_N': 'LeftMargin', '@_V': props.leftMargin.toString(), '@_U': 'IN' });
+    if (props.rightMargin !== undefined)
+        cells.push({ '@_N': 'RightMargin', '@_V': props.rightMargin.toString(), '@_U': 'IN' });
+    return {
+        '@_N': 'TextBlock',
+        Cell: cells,
+    };
+}
 function createLineSection(props) {
     const cells = [
         { '@_N': 'LineColor', '@_V': props.color || '#000000' },

package/package.json

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