@cj-tech-master/excelts 3.1.0-canary.20260102041828.82ed571 → 3.1.0

package/dist/esm/index.browser.js

@@ -5,41 +5,32 @@
 // =============================================================================
 // Main Classes (Browser-compatible)
 // =============================================================================
-export { Workbook } from "@excel/workbook";
-export { Worksheet } from "@excel/worksheet";
-export { Row } from "@excel/row";
-export { Column } from "@excel/column";
-export { Cell } from "@excel/cell";
-export { Range } from "@excel/range";
-export { Image } from "@excel/image";
-export * from "@excel/anchor";
-export { Table } from "@excel/table";
-export { DataValidations } from "@excel/data-validations";
+export { Workbook } from "./doc/workbook.browser.js";
+export { Worksheet } from "./doc/worksheet.js";
+export { Row } from "./doc/row.js";
+export { Column } from "./doc/column.js";
+export { Cell } from "./doc/cell.js";
+export { Range } from "./doc/range.js";
+export { Image } from "./doc/image.js";
+export * from "./doc/anchor.js";
+export { Table } from "./doc/table.js";
+export { DataValidations } from "./doc/data-validations.js";
 // =============================================================================
 // Enums
 // =============================================================================
-export * from "@excel/enums";
+export * from "./doc/enums.js";
 // =============================================================================
 // Types
 // =============================================================================
 // Export all type definitions from types.ts
-export * from "@excel/types";
+export * from "./types.js";
 // =============================================================================
 // Utilities
 // =============================================================================
-export * from "@excel/utils/sheet-utils";
-export { CsvParserStream, CsvFormatterStream } from "@csv/csv.browser";
+export * from "./utils/sheet-utils.js";
 // =============================================================================
-// Streaming Writer (Browser-compatible)
-// Uses cross-platform base implementation without Node.js fs
-// =============================================================================
-import { WorkbookWriter } from "@excel/stream/workbook-writer.browser";
-import { WorkbookReader } from "@excel/stream/workbook-reader.browser";
-import { WorksheetWriter } from "@excel/stream/worksheet-writer";
-import { WorksheetReader } from "@excel/stream/worksheet-reader";
-export { WorkbookWriter, WorkbookReader, WorksheetWriter, WorksheetReader };
-// =============================================================================
-// NOTE: Node.js-only features not available in browser:
-// - Reading from a file path is not supported (use Uint8Array/ArrayBuffer/Blob instead)
-// - Writing to a file path is not supported (use writeBuffer() / stream output, then save as Blob/download)
+// NOTE: The following are NOT exported in browser build (Node.js only):
+// - WorkbookWriter, WorkbookReader (streaming classes for file I/O)
+// - WorksheetWriter, WorksheetReader (streaming classes)
+// - ModelContainer
 // =============================================================================

package/dist/esm/index.js

@@ -1,35 +1,36 @@
 // =============================================================================
 // Main Classes
 // =============================================================================
-export { Workbook } from "@excel/workbook";
-export { Worksheet } from "@excel/worksheet";
-export { Row } from "@excel/row";
-export { Column } from "@excel/column";
-export { Cell } from "@excel/cell";
-export { Range } from "@excel/range";
-export { Image } from "@excel/image";
-export * from "@excel/anchor";
-export { Table } from "@excel/table";
-export { DataValidations } from "@excel/data-validations";
+export { Workbook } from "./doc/workbook.js";
+export { Worksheet } from "./doc/worksheet.js";
+export { Row } from "./doc/row.js";
+export { Column } from "./doc/column.js";
+export { Cell } from "./doc/cell.js";
+export { Range } from "./doc/range.js";
+export { Image } from "./doc/image.js";
+export * from "./doc/anchor.js";
+export { Table } from "./doc/table.js";
+export { DataValidations } from "./doc/data-validations.js";
 // =============================================================================
 // Node.js Only: Streaming Classes
 // These can also be accessed via Workbook.createStreamWriter/createStreamReader
 // =============================================================================
-export { WorkbookWriter } from "@excel/stream/workbook-writer";
-export { WorkbookReader } from "@excel/stream/workbook-reader";
-export { WorksheetWriter } from "@excel/stream/worksheet-writer";
-export { WorksheetReader } from "@excel/stream/worksheet-reader";
+export { WorkbookWriter } from "./stream/xlsx/workbook-writer.js";
+export { WorkbookReader } from "./stream/xlsx/workbook-reader.js";
+export { WorksheetWriter } from "./stream/xlsx/worksheet-writer.js";
+export { WorksheetReader } from "./stream/xlsx/worksheet-reader.js";
+export { ModelContainer } from "./doc/modelcontainer.js";
 // =============================================================================
 // Enums
 // =============================================================================
-export * from "@excel/enums";
+export * from "./doc/enums.js";
 // =============================================================================
 // Types
 // =============================================================================
 // Export all type definitions from types.ts
-export * from "@excel/types";
-export { CsvParserStream, CsvFormatterStream } from "@csv/csv";
+export * from "./types.js";
+export { CsvParserStream, CsvFormatterStream } from "./csv/csv.js";
 // =============================================================================
 // Utilities
 // =============================================================================
-export * from "@excel/utils/sheet-utils";
+export * from "./utils/sheet-utils.js";

package/dist/esm/local.js

@@ -0,0 +1 @@
+console.log(123);

package/dist/esm/stream/xlsx/hyperlink-reader.js

@@ -0,0 +1,79 @@
+import { EventEmitter } from "events";
+import { parseSax } from "../../utils/parse-sax.js";
+import { Enums } from "../../doc/enums.js";
+import { RelType } from "../../xlsx/rel-type.js";
+class HyperlinkReader extends EventEmitter {
+    constructor({ workbook, id, iterator, options }) {
+        super();
+        this.workbook = workbook;
+        this.id = id;
+        this.iterator = iterator;
+        this.options = options;
+    }
+    get count() {
+        return (this.hyperlinks && Object.keys(this.hyperlinks).length) || 0;
+    }
+    each(fn) {
+        if (this.hyperlinks) {
+            Object.keys(this.hyperlinks).forEach(rId => {
+                fn(this.hyperlinks[rId], rId);
+            });
+        }
+    }
+    async read() {
+        const { iterator, options } = this;
+        let emitHyperlinks = false;
+        let hyperlinks = null;
+        switch (options.hyperlinks) {
+            case "emit":
+                emitHyperlinks = true;
+                break;
+            case "cache":
+                this.hyperlinks = hyperlinks = {};
+                break;
+            default:
+                break;
+        }
+        if (!emitHyperlinks && !hyperlinks) {
+            this.emit("finished");
+            return;
+        }
+        try {
+            for await (const events of parseSax(iterator)) {
+                for (const { eventType, value } of events) {
+                    if (eventType === "opentag") {
+                        const node = value;
+                        if (node.name === "Relationship") {
+                            const rId = node.attributes.Id;
+                            switch (node.attributes.Type) {
+                                case RelType.Hyperlink:
+                                    {
+                                        const relationship = {
+                                            type: Enums.RelationshipType.Hyperlink,
+                                            rId,
+                                            target: node.attributes.Target,
+                                            targetMode: node.attributes.TargetMode
+                                        };
+                                        if (emitHyperlinks) {
+                                            this.emit("hyperlink", relationship);
+                                        }
+                                        else {
+                                            hyperlinks[relationship.rId] = relationship;
+                                        }
+                                    }
+                                    break;
+                                default:
+                                    break;
+                            }
+                        }
+                    }
+                }
+            }
+            this.emit("finished");
+        }
+        catch (error) {
+            this.emit("error", error);
+        }
+    }
+}
+export { HyperlinkReader };

package/dist/esm/stream/xlsx/sheet-comments-writer.js

@@ -0,0 +1,100 @@
+import { XmlStream } from "../../utils/xml-stream.js";
+import { RelType } from "../../xlsx/rel-type.js";
+import { colCache } from "../../utils/col-cache.js";
+import { CommentXform } from "../../xlsx/xform/comment/comment-xform.js";
+import { VmlShapeXform } from "../../xlsx/xform/comment/vml-shape-xform.js";
+class SheetCommentsWriter {
+    constructor(worksheet, sheetRelsWriter, options) {
+        // in a workbook, each sheet will have a number
+        this.id = options.id;
+        this.count = 0;
+        this._worksheet = worksheet;
+        this._workbook = options.workbook;
+        this._sheetRelsWriter = sheetRelsWriter;
+    }
+    get commentsStream() {
+        if (!this._commentsStream) {
+            this._commentsStream = this._workbook._openStream(`xl/comments${this.id}.xml`);
+        }
+        return this._commentsStream;
+    }
+    get vmlStream() {
+        if (!this._vmlStream) {
+            this._vmlStream = this._workbook._openStream(`xl/drawings/vmlDrawing${this.id}.vml`);
+        }
+        return this._vmlStream;
+    }
+    _addRelationships() {
+        const commentRel = {
+            Type: RelType.Comments,
+            Target: `../comments${this.id}.xml`
+        };
+        this._sheetRelsWriter.addRelationship(commentRel);
+        const vmlDrawingRel = {
+            Type: RelType.VmlDrawing,
+            Target: `../drawings/vmlDrawing${this.id}.vml`
+        };
+        this.vmlRelId = this._sheetRelsWriter.addRelationship(vmlDrawingRel);
+    }
+    _addCommentRefs() {
+        this._workbook.commentRefs.push({
+            commentName: `comments${this.id}`,
+            vmlDrawing: `vmlDrawing${this.id}`
+        });
+    }
+    _writeOpen() {
+        this.commentsStream.write('<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
+            '<comments xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">' +
+            "<authors><author>Author</author></authors>" +
+            "<commentList>");
+        this.vmlStream.write('<?xml version="1.0" encoding="UTF-8"?>' +
+            '<xml xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:v="urn:schemas-microsoft-com:vml" xmlns:x="urn:schemas-microsoft-com:office:excel">' +
+            '<o:shapelayout v:ext="edit">' +
+            '<o:idmap v:ext="edit" data="1" />' +
+            "</o:shapelayout>" +
+            '<v:shapetype id="_x0000_t202" coordsize="21600,21600" o:spt="202" path="m,l,21600r21600,l21600,xe">' +
+            '<v:stroke joinstyle="miter" />' +
+            '<v:path gradientshapeok="t" o:connecttype="rect" />' +
+            "</v:shapetype>");
+    }
+    _writeComment(comment, index) {
+        const commentXform = new CommentXform();
+        const commentsXmlStream = new XmlStream();
+        commentXform.render(commentsXmlStream, comment);
+        this.commentsStream.write(commentsXmlStream.xml);
+        const vmlShapeXform = new VmlShapeXform();
+        const vmlXmlStream = new XmlStream();
+        vmlShapeXform.render(vmlXmlStream, comment, index);
+        this.vmlStream.write(vmlXmlStream.xml);
+    }
+    _writeClose() {
+        this.commentsStream.write("</commentList></comments>");
+        this.vmlStream.write("</xml>");
+    }
+    addComments(comments) {
+        if (comments && comments.length) {
+            if (!this.startedData) {
+                this._worksheet.comments = [];
+                this._writeOpen();
+                this._addRelationships();
+                this._addCommentRefs();
+                this.startedData = true;
+            }
+            comments.forEach(item => {
+                item.refAddress = colCache.decodeAddress(item.ref);
+            });
+            comments.forEach(comment => {
+                this._writeComment(comment, this.count);
+                this.count += 1;
+            });
+        }
+    }
+    commit() {
+        if (this.count) {
+            this._writeClose();
+            this.commentsStream.end();
+            this.vmlStream.end();
+        }
+    }
+}
+export { SheetCommentsWriter };

package/dist/esm/stream/xlsx/sheet-rels-writer.js

@@ -0,0 +1,90 @@
+import { xmlEncode } from "../../utils/utils.js";
+import { RelType } from "../../xlsx/rel-type.js";
+class HyperlinksProxy {
+    constructor(sheetRelsWriter) {
+        this.writer = sheetRelsWriter;
+    }
+    push(hyperlink) {
+        this.writer.addHyperlink(hyperlink);
+    }
+}
+class SheetRelsWriter {
+    constructor(options) {
+        // in a workbook, each sheet will have a number
+        this.id = options.id;
+        // count of all relationships
+        this.count = 0;
+        // keep record of all hyperlinks
+        this._hyperlinks = [];
+        this._workbook = options.workbook;
+    }
+    get stream() {
+        if (!this._stream) {
+            this._stream = this._workbook._openStream(`xl/worksheets/_rels/sheet${this.id}.xml.rels`);
+        }
+        return this._stream;
+    }
+    get length() {
+        return this._hyperlinks.length;
+    }
+    each(fn) {
+        return this._hyperlinks.forEach(fn);
+    }
+    get hyperlinksProxy() {
+        return this._hyperlinksProxy || (this._hyperlinksProxy = new HyperlinksProxy(this));
+    }
+    addHyperlink(hyperlink) {
+        // Write to stream
+        const relationship = {
+            Target: hyperlink.target,
+            Type: RelType.Hyperlink,
+            TargetMode: "External"
+        };
+        const rId = this._writeRelationship(relationship);
+        // store sheet stuff for later
+        this._hyperlinks.push({
+            rId,
+            address: hyperlink.address
+        });
+    }
+    addMedia(media) {
+        return this._writeRelationship(media);
+    }
+    addRelationship(rel) {
+        return this._writeRelationship(rel);
+    }
+    commit() {
+        if (this.count) {
+            // write xml utro
+            this._writeClose();
+            // and close stream
+            this.stream.end();
+        }
+    }
+    // ================================================================================
+    _writeOpen() {
+        this.stream.write(`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+       <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">`);
+    }
+    _writeRelationship(relationship) {
+        if (!this.count) {
+            this._writeOpen();
+        }
+        const rId = `rId${++this.count}`;
+        if (relationship.TargetMode) {
+            this.stream.write(`<Relationship Id="${rId}"` +
+                ` Type="${relationship.Type}"` +
+                ` Target="${xmlEncode(relationship.Target)}"` +
+                ` TargetMode="${relationship.TargetMode}"` +
+                "/>");
+        }
+        else {
+            this.stream.write(`<Relationship Id="${rId}" Type="${relationship.Type}" Target="${relationship.Target}"/>`);
+        }
+        return rId;
+    }
+    _writeClose() {
+        this.stream.write("</Relationships>");
+    }
+}
+export { SheetRelsWriter };