ts-visio 1.0.0

package/dist/core/PageManager.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageManager = void 0;
+const fast_xml_parser_1 = require("fast-xml-parser");
+const VisioConstants_1 = require("./VisioConstants");
+const RelsManager_1 = require("./RelsManager");
+class PageManager {
+    constructor(pkg) {
+        this.pkg = pkg;
+        this.pages = [];
+        this.loaded = false;
+        this.parser = new fast_xml_parser_1.XMLParser({
+            ignoreAttributes: false,
+            attributeNamePrefix: "@_"
+        });
+        this.builder = new fast_xml_parser_1.XMLBuilder({
+            ignoreAttributes: false,
+            attributeNamePrefix: "@_",
+            format: true
+        });
+        this.relsManager = new RelsManager_1.RelsManager(pkg);
+    }
+    load(force = false) {
+        if (!force && this.loaded) {
+            return this.pages;
+        }
+        // 1. Load Pages Index
+        let pagesContent;
+        try {
+            pagesContent = this.pkg.getFileText('visio/pages/pages.xml');
+        }
+        catch {
+            return [];
+        }
+        const parsedPages = this.parser.parse(pagesContent);
+        let pageNodes = parsedPages.Pages ? parsedPages.Pages.Page : [];
+        if (!Array.isArray(pageNodes)) {
+            pageNodes = pageNodes ? [pageNodes] : [];
+        }
+        if (pageNodes.length === 0) {
+            this.pages = [];
+            this.loaded = true;
+            return [];
+        }
+        // 2. Load Relationships to resolve paths
+        let relsContent;
+        try {
+            relsContent = this.pkg.getFileText('visio/pages/_rels/pages.xml.rels');
+        }
+        catch {
+            relsContent = '';
+        }
+        const relsMap = new Map(); // rId -> Target
+        if (relsContent) {
+            const parsedRels = this.parser.parse(relsContent);
+            let relNodes = parsedRels.Relationships ? parsedRels.Relationships.Relationship : [];
+            if (!Array.isArray(relNodes))
+                relNodes = relNodes ? [relNodes] : [];
+            for (const r of relNodes) {
+                relsMap.set(r['@_Id'], r['@_Target']);
+            }
+        }
+        // 3. Map Pages
+        this.pages = pageNodes.map((node) => {
+            // r:id is in the Rel child element, not as a Page attribute
+            const rId = node.Rel?.['@_r:id'] || node['@_r:id']; // Support both for compatibility
+            const target = relsMap.get(rId) || '';
+            // Target is usually "page1.xml" or "pages/page1.xml" depending on relative structure.
+            // pages.xml is in "visio/pages/", so "page1.xml" means "visio/pages/page1.xml"
+            const fullPath = target ? `visio/pages/${target}` : '';
+            // Parse background page attributes
+            const bgAttr = node['@_Background'];
+            const isBackground = bgAttr === 'true' || bgAttr === '1' || bgAttr === true || bgAttr === 1;
+            const backPageAttr = node['@_BackPage'];
+            const backPageId = backPageAttr ? parseInt(backPageAttr.toString()) : undefined;
+            return {
+                id: parseInt(node['@_ID']),
+                name: node['@_Name'],
+                relId: rId,
+                xmlPath: fullPath,
+                isBackground,
+                backPageId
+            };
+        });
+        this.loaded = true;
+        return this.pages;
+    }
+    async createPage(name) {
+        this.load(); // Refresh state
+        // 1. Calculate ID
+        let maxId = 0;
+        for (const p of this.pages) {
+            if (p.id > maxId)
+                maxId = p.id;
+        }
+        const newId = maxId + 1;
+        const fileName = `page${newId}.xml`;
+        const relativePath = `visio/pages/${fileName}`;
+        // 2. Create Page File
+        const pageContent = `<PageContents xmlns="${VisioConstants_1.XML_NAMESPACES.VISIO_MAIN}" xmlns:r="${VisioConstants_1.XML_NAMESPACES.RELATIONSHIPS_OFFICE}" xml:space="preserve">
+    <PageSheet LineStyle="0" FillStyle="0" TextStyle="0">
+        <Cell N="PageWidth" V="8.5"/>
+        <Cell N="PageHeight" V="11"/>
+        <Cell N="PageScale" V="1" Unit="MSG"/>
+        <Cell N="DrawingScale" V="1" Unit="MSG"/>
+        <Cell N="DrawingSizeType" V="0"/>
+        <Cell N="DrawingScaleType" V="0"/>
+        <Cell N="Inhibited" V="0"/>
+        <Cell N="UIVisibility" V="0"/>
+        <Cell N="PageDrawSizeType" V="0"/>
+    </PageSheet>
+    <Shapes/>
+    <Connects/>
+</PageContents>`;
+        this.pkg.updateFile(relativePath, pageContent);
+        // 3. Update Content Types
+        const ctPath = '[Content_Types].xml';
+        const ctContent = this.pkg.getFileText(ctPath);
+        const parsedCt = this.parser.parse(ctContent);
+        // Format: <Override PartName="/visio/pages/page2.xml" ContentType="application/vnd.ms-visio.page+xml"/>
+        // Ensure Types.Override array exists
+        if (!parsedCt.Types.Override)
+            parsedCt.Types.Override = [];
+        if (!Array.isArray(parsedCt.Types.Override))
+            parsedCt.Types.Override = [parsedCt.Types.Override];
+        parsedCt.Types.Override.push({
+            '@_PartName': `/${relativePath}`,
+            '@_ContentType': VisioConstants_1.CONTENT_TYPES.VISIO_PAGE
+        });
+        this.pkg.updateFile(ctPath, this.builder.build(parsedCt));
+        // 4. Update Relationships (pages.xml -> new page file)
+        // Source is "visio/pages/pages.xml", Target is "page{ID}.xml" (relative to source dir)
+        const rId = await this.relsManager.ensureRelationship('visio/pages/pages.xml', fileName, VisioConstants_1.RELATIONSHIP_TYPES.PAGE);
+        // 5. Update Pages Index (visio/pages/pages.xml)
+        const pagesPath = 'visio/pages/pages.xml';
+        const pagesContent = this.pkg.getFileText(pagesPath);
+        const parsedPages = this.parser.parse(pagesContent);
+        if (!parsedPages.Pages.Page)
+            parsedPages.Pages.Page = [];
+        if (!Array.isArray(parsedPages.Pages.Page))
+            parsedPages.Pages.Page = [parsedPages.Pages.Page];
+        parsedPages.Pages.Page.push({
+            '@_ID': newId.toString(),
+            '@_Name': name,
+            'Rel': { '@_r:id': rId }
+        });
+        this.pkg.updateFile(pagesPath, this.builder.build(parsedPages));
+        // Reload to include new page
+        this.load(true);
+        return newId.toString();
+    }
+    /**
+     * Create a background page
+     */
+    async createBackgroundPage(name) {
+        this.load();
+        // 1. Calculate ID
+        let maxId = 0;
+        for (const p of this.pages) {
+            if (p.id > maxId)
+                maxId = p.id;
+        }
+        const newId = maxId + 1;
+        const fileName = `page${newId}.xml`;
+        const relativePath = `visio/pages/${fileName}`;
+        // 2. Create Page File
+        const pageContent = `<PageContents xmlns="${VisioConstants_1.XML_NAMESPACES.VISIO_MAIN}" xmlns:r="${VisioConstants_1.XML_NAMESPACES.RELATIONSHIPS_OFFICE}" xml:space="preserve">
+    <PageSheet LineStyle="0" FillStyle="0" TextStyle="0">
+        <Cell N="PageWidth" V="8.5"/>
+        <Cell N="PageHeight" V="11"/>
+        <Cell N="PageScale" V="1" Unit="MSG"/>
+        <Cell N="DrawingScale" V="1" Unit="MSG"/>
+        <Cell N="DrawingSizeType" V="0"/>
+        <Cell N="DrawingScaleType" V="0"/>
+        <Cell N="Inhibited" V="0"/>
+        <Cell N="UIVisibility" V="0"/>
+        <Cell N="PageDrawSizeType" V="0"/>
+    </PageSheet>
+    <Shapes/>
+</PageContents>`;
+        this.pkg.updateFile(relativePath, pageContent);
+        // 3. Update Content Types
+        const ctPath = '[Content_Types].xml';
+        const ctContent = this.pkg.getFileText(ctPath);
+        const parsedCt = this.parser.parse(ctContent);
+        if (!parsedCt.Types.Override)
+            parsedCt.Types.Override = [];
+        if (!Array.isArray(parsedCt.Types.Override))
+            parsedCt.Types.Override = [parsedCt.Types.Override];
+        parsedCt.Types.Override.push({
+            '@_PartName': `/${relativePath}`,
+            '@_ContentType': VisioConstants_1.CONTENT_TYPES.VISIO_PAGE
+        });
+        this.pkg.updateFile(ctPath, this.builder.build(parsedCt));
+        // 4. Update Relationships
+        const rId = await this.relsManager.ensureRelationship('visio/pages/pages.xml', fileName, VisioConstants_1.RELATIONSHIP_TYPES.PAGE);
+        // 5. Update Pages Index with Background="true"
+        const pagesPath = 'visio/pages/pages.xml';
+        const pagesContent = this.pkg.getFileText(pagesPath);
+        const parsedPages = this.parser.parse(pagesContent);
+        if (!parsedPages.Pages.Page)
+            parsedPages.Pages.Page = [];
+        if (!Array.isArray(parsedPages.Pages.Page))
+            parsedPages.Pages.Page = [parsedPages.Pages.Page];
+        parsedPages.Pages.Page.push({
+            '@_ID': newId.toString(),
+            '@_Name': name,
+            '@_Background': '1', // Use '1' for boolean true attribute
+            'Rel': { '@_r:id': rId }
+        });
+        this.pkg.updateFile(pagesPath, this.builder.build(parsedPages));
+        this.load(true);
+        return newId.toString();
+    }
+    /**
+     * Set a background page for a foreground page
+     */
+    async setBackgroundPage(foregroundPageId, backgroundPageId) {
+        this.load();
+        // Verify pages exist
+        const fgPage = this.pages.find(p => p.id.toString() === foregroundPageId);
+        const bgPage = this.pages.find(p => p.id.toString() === backgroundPageId);
+        if (!fgPage)
+            throw new Error(`Foreground page ${foregroundPageId} not found`);
+        if (!bgPage)
+            throw new Error(`Background page ${backgroundPageId} not found`);
+        if (!bgPage.isBackground)
+            throw new Error(`Page ${backgroundPageId} is not a background page`);
+        // Update pages.xml
+        const pagesPath = 'visio/pages/pages.xml';
+        const pagesContent = this.pkg.getFileText(pagesPath);
+        const parsedPages = this.parser.parse(pagesContent);
+        let pageNodes = parsedPages.Pages.Page;
+        if (!Array.isArray(pageNodes))
+            pageNodes = [pageNodes];
+        const fgNode = pageNodes.find((n) => n['@_ID'] === foregroundPageId);
+        if (fgNode) {
+            fgNode['@_BackPage'] = backgroundPageId.toString();
+        }
+        this.pkg.updateFile(pagesPath, this.builder.build(parsedPages));
+        this.load(true);
+    }
+}
+exports.PageManager = PageManager;

package/dist/core/RelsManager.d.ts

@@ -0,0 +1,11 @@
+import { VisioPackage } from '../VisioPackage';
+export declare class RelsManager {
+    private pkg;
+    private parser;
+    private builder;
+    constructor(pkg: VisioPackage);
+    private getRelsPath;
+    ensureRelationship(sourcePath: string, target: string, type: string): Promise<string>;
+    addPageImageRel(pageId: string, mediaPath: string): Promise<string>;
+    addImageRelationship(sourcePath: string, target: string): Promise<string>;
+}

package/dist/core/RelsManager.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelsManager = void 0;
+const fast_xml_parser_1 = require("fast-xml-parser");
+const VisioConstants_1 = require("./VisioConstants");
+class RelsManager {
+    constructor(pkg) {
+        this.pkg = pkg;
+        this.parser = new fast_xml_parser_1.XMLParser({
+            ignoreAttributes: false,
+            attributeNamePrefix: "@_"
+        });
+        this.builder = new fast_xml_parser_1.XMLBuilder({
+            ignoreAttributes: false,
+            attributeNamePrefix: "@_",
+            format: true
+        });
+    }
+    getRelsPath(partPath) {
+        // file.xml -> _rels/file.xml.rels
+        // dir/file.xml -> dir/_rels/file.xml.rels
+        const parts = partPath.split('/');
+        const fileName = parts.pop();
+        const dir = parts.join('/');
+        return `${dir}/_rels/${fileName}.rels`;
+    }
+    async ensureRelationship(sourcePath, target, type) {
+        const relsPath = this.getRelsPath(sourcePath);
+        let content = '';
+        try {
+            content = this.pkg.getFileText(relsPath);
+        }
+        catch {
+            // If .rels doesn't exist, start fresh
+            content = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="${VisioConstants_1.XML_NAMESPACES.RELATIONSHIPS}">
+</Relationships>`;
+        }
+        const parsed = this.parser.parse(content);
+        if (!parsed.Relationships) {
+            parsed.Relationships = { Relationship: [] };
+        }
+        let rels = parsed.Relationships.Relationship;
+        if (!Array.isArray(rels)) {
+            rels = rels ? [rels] : [];
+            parsed.Relationships.Relationship = rels;
+        }
+        // Check for existing
+        const existing = rels.find((r) => r['@_Target'] === target && r['@_Type'] === type);
+        if (existing) {
+            return existing['@_Id'];
+        }
+        // Generate new ID (rId1, rId2...)
+        let maxId = 0;
+        for (const r of rels) {
+            const idStr = r['@_Id']; // "rId5"
+            const idNum = parseInt(idStr.replace('rId', ''));
+            if (!isNaN(idNum) && idNum > maxId)
+                maxId = idNum;
+        }
+        const newId = `rId${maxId + 1}`;
+        // Add new relationship
+        rels.push({
+            '@_Id': newId,
+            '@_Type': type,
+            '@_Target': target
+        });
+        // Save back
+        const newXml = this.builder.build(parsed);
+        this.pkg.updateFile(relsPath, newXml);
+        return newId;
+    }
+    async addPageImageRel(pageId, mediaPath) {
+        const pagePath = `visio/pages/page${pageId}.xml`;
+        return this.addImageRelationship(pagePath, mediaPath);
+    }
+    async addImageRelationship(sourcePath, target) {
+        return this.ensureRelationship(sourcePath, target, VisioConstants_1.RELATIONSHIP_TYPES.IMAGE);
+    }
+}
+exports.RelsManager = RelsManager;

package/dist/core/VisioConstants.d.ts

@@ -0,0 +1,38 @@
+export declare const XML_NAMESPACES: {
+    readonly VISIO_MAIN: "http://schemas.microsoft.com/office/visio/2012/main";
+    readonly RELATIONSHIPS: "http://schemas.openxmlformats.org/package/2006/relationships";
+    readonly RELATIONSHIPS_OFFICE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+    readonly CONTENT_TYPES: "http://schemas.openxmlformats.org/package/2006/content-types";
+    readonly CORE_PROPERTIES: "http://schemas.openxmlformats.org/package/2006/metadata/core-properties";
+    readonly EXTENDED_PROPERTIES: "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties";
+    readonly DOC_PROPS_VTYPES: "http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes";
+    readonly DC_ELEMENTS: "http://purl.org/dc/elements/1.1/";
+    readonly DC_TERMS: "http://purl.org/dc/terms/";
+    readonly DC_DCMITYPE: "http://purl.org/dc/dcmitype/";
+    readonly XSI: "http://www.w3.org/2001/XMLSchema-instance";
+};
+export declare const RELATIONSHIP_TYPES: {
+    readonly IMAGE: "http://schemas.microsoft.com/office/2006/relationships/image";
+    readonly MASTERS: "http://schemas.microsoft.com/visio/2010/relationships/masters";
+    readonly PAGES: "http://schemas.microsoft.com/visio/2010/relationships/pages";
+    readonly PAGE: "http://schemas.microsoft.com/visio/2010/relationships/page";
+    readonly WINDOWS: "http://schemas.microsoft.com/visio/2010/relationships/windows";
+    readonly DOCUMENT: "http://schemas.microsoft.com/visio/2010/relationships/document";
+    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";
+};
+export declare const CONTENT_TYPES: {
+    readonly PNG: "image/png";
+    readonly JPEG: "image/jpeg";
+    readonly GIF: "image/gif";
+    readonly BMP: "image/bmp";
+    readonly TIFF: "image/tiff";
+    readonly XML_RELATIONSHIPS: "application/vnd.openxmlformats-package.relationships+xml";
+    readonly XML: "application/xml";
+    readonly VISIO_DRAWING: "application/vnd.ms-visio.drawing.main+xml";
+    readonly VISIO_PAGES: "application/vnd.ms-visio.pages+xml";
+    readonly VISIO_PAGE: "application/vnd.ms-visio.page+xml";
+    readonly VISIO_WINDOWS: "application/vnd.ms-visio.windows+xml";
+    readonly CORE_PROPERTIES: "application/vnd.openxmlformats-package.core-properties+xml";
+    readonly EXTENDED_PROPERTIES: "application/vnd.openxmlformats-officedocument.extended-properties+xml";
+};

package/dist/core/VisioConstants.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTENT_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',
+    RELATIONSHIPS_OFFICE: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',
+    CONTENT_TYPES: 'http://schemas.openxmlformats.org/package/2006/content-types',
+    CORE_PROPERTIES: 'http://schemas.openxmlformats.org/package/2006/metadata/core-properties',
+    EXTENDED_PROPERTIES: 'http://schemas.openxmlformats.org/officeDocument/2006/extended-properties',
+    DOC_PROPS_VTYPES: 'http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes',
+    DC_ELEMENTS: 'http://purl.org/dc/elements/1.1/',
+    DC_TERMS: 'http://purl.org/dc/terms/',
+    DC_DCMITYPE: 'http://purl.org/dc/dcmitype/',
+    XSI: 'http://www.w3.org/2001/XMLSchema-instance'
+};
+exports.RELATIONSHIP_TYPES = {
+    IMAGE: 'http://schemas.microsoft.com/office/2006/relationships/image',
+    MASTERS: 'http://schemas.microsoft.com/visio/2010/relationships/masters',
+    PAGES: 'http://schemas.microsoft.com/visio/2010/relationships/pages',
+    PAGE: 'http://schemas.microsoft.com/visio/2010/relationships/page',
+    WINDOWS: 'http://schemas.microsoft.com/visio/2010/relationships/windows',
+    DOCUMENT: 'http://schemas.microsoft.com/visio/2010/relationships/document',
+    CORE_PROPERTIES: 'http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties',
+    EXTENDED_PROPERTIES: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties'
+};
+exports.CONTENT_TYPES = {
+    PNG: 'image/png',
+    JPEG: 'image/jpeg',
+    GIF: 'image/gif',
+    BMP: 'image/bmp',
+    TIFF: 'image/tiff',
+    XML_RELATIONSHIPS: 'application/vnd.openxmlformats-package.relationships+xml',
+    XML: 'application/xml',
+    VISIO_DRAWING: 'application/vnd.ms-visio.drawing.main+xml',
+    VISIO_PAGES: 'application/vnd.ms-visio.pages+xml',
+    VISIO_PAGE: 'application/vnd.ms-visio.page+xml',
+    VISIO_WINDOWS: 'application/vnd.ms-visio.windows+xml',
+    CORE_PROPERTIES: 'application/vnd.openxmlformats-package.core-properties+xml',
+    EXTENDED_PROPERTIES: 'application/vnd.openxmlformats-officedocument.extended-properties+xml'
+};

package/dist/core/VisioValidator.d.ts

@@ -0,0 +1,27 @@
+import { VisioPackage } from '../VisioPackage';
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare class VisioValidator {
+    private parser;
+    constructor();
+    /**
+     * Validate a VisioPackage for structural correctness
+     */
+    validate(pkg: VisioPackage): Promise<ValidationResult>;
+    private checkRequiredFiles;
+    private validateContentTypes;
+    private validateDocumentRels;
+    private validatePages;
+    private validatePageContent;
+    private validateShapeIds;
+    private validateConnects;
+    private validateSectionNames;
+    private validateCellNames;
+    private validateImageShapes;
+    private validateMasterReferences;
+    private validateRelationshipIntegrity;
+    private getAllShapes;
+}