@cj-tech-master/excelts 9.4.2 → 9.5.0

package/dist/browser/modules/word/index.base.d.ts

@@ -0,0 +1,19 @@
+/**
+ * DOCX Module - Base Exports (Platform Independent)
+ *
+ * Shared exports for both Node.js and browser environments.
+ */
+export type { HalfPoint, Twips, Emu, EighthPoint, HexColor, ShadingType, BorderStyle, PageOrientation, PageSize, PageMargins, ColumnDef, SectionColumns, SectionBreakType, PageNumberFormat, HeaderFooterType, HeaderFooterRef, PageVerticalAlign, DocumentGridType, PageTextDirection, Border, ArtBorderType, PageBorders, SectionProperties, UnderlineStyle, VerticalAlign, HighlightColor, FontSpec, Shading, UnderlineSpec, TextEffect, EmphasisMarkType, ColorSpec, RunProperties, RunContent, TextContent, BreakContent, TabContent, PositionalTabContent, RubyContent, RubyAlign, RubyProperties, SymbolContent, FootnoteRefContent, EndnoteRefContent, FieldContent, InlineImageContent, CarriageReturnContent, NoBreakHyphenContent, SoftHyphenContent, LastRenderedPageBreakContent, AnnotationReferenceContent, PageNumberType, DateFieldContent, Run, RevisionInfo, InsertedRun, DeletedRun, MovedFromRun, MovedToRun, MoveRangeMarker, CustomXmlTrackingMarker, ParagraphPropertyChange, RunPropertyChange, SectionPropertyChange, TableRowRevision, CommentDef, CommentRangeStart, CommentRangeEnd, CommentReference, Alignment, LineSpacingRule, LineSpacing, Indentation, TabStopType, TabStopLeader, TabStop, PositionalTabAlignment, PositionalTabRelativeTo, PositionalTabLeader, ParagraphBorders, NumberingRef, FrameAnchorType, DropCapType, ParagraphFrame, ParagraphProperties, Paragraph, Hyperlink, BookmarkStart, BookmarkEnd, ParagraphChild, TableWidth, TableBorders, TableCellMargins, TableLayout, TableLook, TableFloat, TableProperties, RowHeightRule, TableRowProperties, VerticalCellAlign, TextDirection, VerticalMerge, TableCellProperties, TableCell, TableRow, Table, HorizontalPositionRelative, VerticalPositionRelative, WrapStyle, WrapTextSide, WrapMargins, FloatingImage, DrawingShape, PresetShapeType, Chart, ChartType, ChartSeries, ChartLegendPosition, ChartAxis, ChartContent, AltChunk, WebSettings, PersonInfo, NoteType, TablePropertyChange, TableRowPropertyChange, TableCellPropertyChange, CellMergeRevision, OpaquePart, OpaqueRelationship, OpaqueDrawing, TableOfContents, MathRun, MathFraction, MathSuperScript, MathSubScript, MathSubSuperScript, MathPreSubSuperScript, MathPhantom, MathGroupChar, MathBorderBox, MathRadical, MathDelimiter, MathNary, MathFunction, MathLimit, MathMatrix, MathAccent, MathBar, MathBox, MathEquationArray, MathContent, MathBlock, TextBox, CheckBox, SdtListItem, SdtDateProperties, SdtProperties, SdtDataBinding, SdtCheckboxProperties, SdtRepeatingSectionProperties, StructuredDocumentTag, CustomXmlPart, BodyContent, StyleType, TableStyleConditionType, TableStyleConditionalFormat, StyleDef, DocDefaults, NumberFormat, LevelJustification, LevelSuffix, NumberingLevel, MultiLevelType, AbstractNumbering, LevelOverride, NumberingInstance, NumPicBullet, HeaderFooterContent, HeaderDef, FooterDef, FootnoteDef, EndnoteDef, ImageMediaType, ImageDef, FontFamily, FontPitch, FontDef, EmbeddedFont, ProtectionType, HyphenationSettings, DocumentSettings, CompatSetting, CompatFlag, DocumentBackground, DocumentTheme, ThemeColorScheme, ThemeFontScheme, ThemeFont, ThemeFormatScheme, ThemeColorName, CustomPropertyValue, CustomProperty, CoreProperties, AppProperties, DocxDocument, DocxOptions } from "./types.js";
+export { DocxError, DocxParseError, DocxWriteError, DocxMissingPartError, DocxInvalidStructureError, DocxUnsupportedFeatureError, isDocxError } from "./errors.js";
+export { inchesToTwips, twipsToInches, cmToTwips, twipsToCm, ptToTwips, twipsToPt, mmToTwips, inchesToEmu, emuToInches, cmToEmu, emuToCm, ptToEmu, pxToEmu, emuToPx, ptToHalfPoint, halfPointToPt, ptToEighthPoint, eighthPointToPt, lineMultiplierToSpacing, spacingToLineMultiplier, percentToTablePct, tablePctToPercent } from "./units.js";
+export { DocumentBuilder, text, bold, italic, pageBreak, lineBreak, columnBreak, tab, positionalTab, ruby, carriageReturn, noBreakHyphen, softHyphen, field, pageNumberField, totalPagesField, sectionPagesField, sectionField, dateField, sequenceField, timeField, authorField, titleField, subjectField, keywordsField, fileNameField, fileSizeField, styleRefField, refField, pageRefField, noteRefField, hyperlinkField, quoteField, tocField, tcField, indexEntryField, indexField, ifField, includeTextField, includePictureField, formTextField, formCheckboxField, formDropdownField, paragraph, textParagraph, heading, hyperlink, bookmarkStart, bookmarkEnd, commentRangeStart, commentRangeEnd, commentReference, insertedRun, deletedRun, movedFromRun, movedToRun, moveFromRangeStart, moveFromRangeEnd, moveToRangeStart, moveToRangeEnd, checkBox, mathBlock, mathRun, mathFraction, mathSqrt, mathRoot, mathSum, mathIntegral, mathProduct, mathSuperScript, mathSubScript, mathSubSuperScript, mathPreSubSuperScript, mathPhantom, mathGroupChar, mathBorderBox, mathDelimiter, mathNary, mathFunction, mathLimit, mathMatrix, mathAccent, mathBar, mathBox, mathEquationArray, symbol, floatingImage, drawingShape, chart, structuredDocumentTag, border, gridBorders, cell, row, table, simpleTable, searchText, replaceText, resolveThemeColor, patchDocument, mailMerge, paragraphCount, countWords, getHeadings, findBookmark, findComment, listImages, listTables, listHyperlinks, tableCount, extractText } from "./document.js";
+export type { SearchResult, PatchContent, PatchOperation, PatchOptions, DocumentHeading } from "./document.js";
+export { packageDocx } from "./docx-packager.js";
+export { readDocx } from "./docx-reader.js";
+export { deobfuscateFont, obfuscateFont, generateFontKey } from "./font-obfuscation.js";
+export { isEncryptedDocx, verifyPassword, decryptPackage, parseEncryptionInfoXml, deriveEncryptionKey, AGILE_BLOCK_KEYS } from "./encryption.js";
+export type { AgileEncryptionInfo } from "./encryption.js";
+export { hasDigitalSignatures, parseSignatureXml, extractSignatures, isWellFormedSignature } from "./digital-signatures.js";
+export type { DigitalSignatureInfo } from "./digital-signatures.js";
+export { renderToHtml } from "./html-renderer.js";
+export type { HtmlRenderOptions, HtmlRenderResult } from "./html-renderer.js";

package/dist/browser/modules/word/index.base.js

@@ -0,0 +1,51 @@
+/**
+ * DOCX Module - Base Exports (Platform Independent)
+ *
+ * Shared exports for both Node.js and browser environments.
+ */
+// Errors
+export { DocxError, DocxParseError, DocxWriteError, DocxMissingPartError, DocxInvalidStructureError, DocxUnsupportedFeatureError, isDocxError } from "./errors.js";
+// Units
+export { inchesToTwips, twipsToInches, cmToTwips, twipsToCm, ptToTwips, twipsToPt, mmToTwips, inchesToEmu, emuToInches, cmToEmu, emuToCm, ptToEmu, pxToEmu, emuToPx, ptToHalfPoint, halfPointToPt, ptToEighthPoint, eighthPointToPt, lineMultiplierToSpacing, spacingToLineMultiplier, percentToTablePct, tablePctToPercent } from "./units.js";
+// Builder helpers
+export { DocumentBuilder, 
+// Run helpers
+text, bold, italic, pageBreak, lineBreak, columnBreak, tab, positionalTab, ruby, carriageReturn, noBreakHyphen, softHyphen, field, pageNumberField, totalPagesField, sectionPagesField, sectionField, dateField, sequenceField, timeField, authorField, titleField, subjectField, keywordsField, fileNameField, fileSizeField, styleRefField, refField, pageRefField, noteRefField, hyperlinkField, quoteField, tocField, tcField, indexEntryField, indexField, ifField, includeTextField, includePictureField, formTextField, formCheckboxField, formDropdownField, 
+// Paragraph helpers
+paragraph, textParagraph, heading, hyperlink, bookmarkStart, bookmarkEnd, 
+// Comment helpers
+commentRangeStart, commentRangeEnd, commentReference, 
+// Track changes helpers
+insertedRun, deletedRun, movedFromRun, movedToRun, moveFromRangeStart, moveFromRangeEnd, moveToRangeStart, moveToRangeEnd, 
+// CheckBox helper
+checkBox, 
+// Math helpers
+mathBlock, mathRun, mathFraction, mathSqrt, mathRoot, mathSum, mathIntegral, mathProduct, 
+// Additional math helpers
+mathSuperScript, mathSubScript, mathSubSuperScript, mathPreSubSuperScript, mathPhantom, mathGroupChar, mathBorderBox, mathDelimiter, mathNary, mathFunction, mathLimit, mathMatrix, mathAccent, mathBar, mathBox, mathEquationArray, 
+// Symbol helper
+symbol, 
+// Floating image helper
+floatingImage, 
+// Drawing shape helper
+drawingShape, 
+// Chart helper
+chart, 
+// SDT helper
+structuredDocumentTag, 
+// Table helpers
+border, gridBorders, cell, row, table, simpleTable, searchText, replaceText, resolveThemeColor, patchDocument, mailMerge, 
+// Query API
+paragraphCount, countWords, getHeadings, findBookmark, findComment, listImages, listTables, listHyperlinks, tableCount, extractText } from "./document.js";
+// Packager
+export { packageDocx } from "./docx-packager.js";
+// Reader
+export { readDocx } from "./docx-reader.js";
+// Font obfuscation utilities
+export { deobfuscateFont, obfuscateFont, generateFontKey } from "./font-obfuscation.js";
+// Encryption utilities
+export { isEncryptedDocx, verifyPassword, decryptPackage, parseEncryptionInfoXml, deriveEncryptionKey, AGILE_BLOCK_KEYS } from "./encryption.js";
+// Digital signature utilities
+export { hasDigitalSignatures, parseSignatureXml, extractSignatures, isWellFormedSignature } from "./digital-signatures.js";
+// HTML Renderer
+export { renderToHtml } from "./html-renderer.js";

package/dist/browser/modules/word/index.browser.d.ts

@@ -0,0 +1,4 @@
+/**
+ * DOCX Module - Browser Entry Point
+ */
+export * from "./index.base.js";

package/dist/browser/modules/word/index.browser.js

@@ -0,0 +1,4 @@
+/**
+ * DOCX Module - Browser Entry Point
+ */
+export * from "./index.base.js";

package/dist/browser/modules/word/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * DOCX Module - Node.js Entry Point
+ */
+export * from "./index.base.js";

package/dist/browser/modules/word/index.js

@@ -0,0 +1,4 @@
+/**
+ * DOCX Module - Node.js Entry Point
+ */
+export * from "./index.base.js";

package/dist/browser/modules/word/internal-utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * DOCX Module - Internal utilities (shared helpers)
+ */
+/**
+ * Encode a byte array to base64. Uses native Node `Buffer` if available;
+ * otherwise falls back to chunked `btoa()` for browser environments.
+ *
+ * The chunked approach avoids the O(n²) string concatenation cost that naïve
+ * `String.fromCharCode(...data)` implementations exhibit on large buffers.
+ */
+export declare function bytesToBase64(data: Uint8Array): string;
+/**
+ * Decode a base64 string to a byte array. Uses native Node `Buffer` if available.
+ */
+export declare function base64ToBytes(s: string): Uint8Array;
+/**
+ * Build an XML attributes object from an array of [name, value] entries,
+ * omitting entries whose value is `undefined` or `false`. Numeric and boolean
+ * values are stringified: `number → String(n)`, `boolean → "1"`.
+ *
+ * Reduces repetitive `if (x !== undefined) attrs["w:x"] = String(x)` patterns.
+ */
+export declare function buildAttrs(entries: ReadonlyArray<[string, string | number | boolean | undefined | null]>): Record<string, string>;

package/dist/browser/modules/word/internal-utils.js

@@ -0,0 +1,54 @@
+/**
+ * DOCX Module - Internal utilities (shared helpers)
+ */
+/**
+ * Encode a byte array to base64. Uses native Node `Buffer` if available;
+ * otherwise falls back to chunked `btoa()` for browser environments.
+ *
+ * The chunked approach avoids the O(n²) string concatenation cost that naïve
+ * `String.fromCharCode(...data)` implementations exhibit on large buffers.
+ */
+export function bytesToBase64(data) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(data).toString("base64");
+    }
+    const CHUNK = 0x8000;
+    const parts = [];
+    for (let i = 0; i < data.length; i += CHUNK) {
+        const slice = data.subarray(i, i + CHUNK);
+        // `apply` on Uint8Array works in all modern JS engines
+        parts.push(String.fromCharCode.apply(null, slice));
+    }
+    return btoa(parts.join(""));
+}
+/**
+ * Decode a base64 string to a byte array. Uses native Node `Buffer` if available.
+ */
+export function base64ToBytes(s) {
+    if (typeof Buffer !== "undefined") {
+        return new Uint8Array(Buffer.from(s, "base64"));
+    }
+    const binary = atob(s);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * Build an XML attributes object from an array of [name, value] entries,
+ * omitting entries whose value is `undefined` or `false`. Numeric and boolean
+ * values are stringified: `number → String(n)`, `boolean → "1"`.
+ *
+ * Reduces repetitive `if (x !== undefined) attrs["w:x"] = String(x)` patterns.
+ */
+export function buildAttrs(entries) {
+    const out = {};
+    for (const [k, v] of entries) {
+        if (v === undefined || v === null || v === false) {
+            continue;
+        }
+        out[k] = typeof v === "boolean" ? "1" : String(v);
+    }
+    return out;
+}

package/dist/browser/modules/word/relationships.d.ts

@@ -0,0 +1,31 @@
+/**
+ * DOCX Module - Relationship Manager
+ *
+ * Manages OPC relationships for the DOCX package.
+ * Generates .rels files for package-level and part-level relationships.
+ */
+import type { XmlSink } from "../xml/types.js";
+/** A single OPC relationship. */
+export interface Relationship {
+    readonly id: string;
+    readonly type: string;
+    readonly target: string;
+    readonly targetMode?: "External";
+}
+/**
+ * Manages relationships and generates .rels XML.
+ */
+export declare class RelationshipManager {
+    private readonly _rels;
+    private _nextId;
+    /** Add a relationship and return its assigned rId. */
+    add(type: string, target: string, targetMode?: "External"): string;
+    /** Add a relationship with a specific ID. */
+    addWithId(id: string, type: string, target: string, targetMode?: "External"): void;
+    /** Get all relationships. */
+    get relationships(): readonly Relationship[];
+    /** Get the number of relationships. */
+    get count(): number;
+    /** Render the relationships XML to a sink. */
+    render(xml: XmlSink): void;
+}

package/dist/browser/modules/word/relationships.js

@@ -0,0 +1,56 @@
+/**
+ * DOCX Module - Relationship Manager
+ *
+ * Manages OPC relationships for the DOCX package.
+ * Generates .rels files for package-level and part-level relationships.
+ */
+import { NS_PKG_RELS, STD_DOC_ATTRIBUTES } from "./constants.js";
+/**
+ * Manages relationships and generates .rels XML.
+ */
+export class RelationshipManager {
+    constructor() {
+        this._rels = [];
+        this._nextId = 1;
+    }
+    /** Add a relationship and return its assigned rId. */
+    add(type, target, targetMode) {
+        const id = `rId${this._nextId++}`;
+        this._rels.push({ id, type, target, targetMode });
+        return id;
+    }
+    /** Add a relationship with a specific ID. */
+    addWithId(id, type, target, targetMode) {
+        this._rels.push({ id, type, target, targetMode });
+        // Keep nextId above any manually-assigned IDs
+        const num = parseInt(id.replace("rId", ""), 10);
+        if (!isNaN(num) && num >= this._nextId) {
+            this._nextId = num + 1;
+        }
+    }
+    /** Get all relationships. */
+    get relationships() {
+        return this._rels;
+    }
+    /** Get the number of relationships. */
+    get count() {
+        return this._rels.length;
+    }
+    /** Render the relationships XML to a sink. */
+    render(xml) {
+        xml.openXml(STD_DOC_ATTRIBUTES);
+        xml.openNode("Relationships", { xmlns: NS_PKG_RELS });
+        for (const rel of this._rels) {
+            const attrs = {
+                Id: rel.id,
+                Type: rel.type,
+                Target: rel.target
+            };
+            if (rel.targetMode) {
+                attrs.TargetMode = rel.targetMode;
+            }
+            xml.leafNode("Relationship", attrs);
+        }
+        xml.closeNode();
+    }
+}