@cj-tech-master/excelts 9.5.0 → 9.5.1

package/dist/cjs/modules/word/namespaces.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * DOCX Module — Sub-namespace objects
+ *
+ * Groups flat builder helpers into logical namespaces for better
+ * IDE discoverability. These are re-exports aggregated into objects;
+ * since they reference the same underlying functions, tree-shaking
+ * still applies at the individual function level for consumers who
+ * import the flat named exports instead.
+ *
+ * @example
+ * ```ts
+ * import { Run, Paragraph, Table, Math, Field } from "excelts/word";
+ *
+ * const doc = Document.create();
+ * Document.addParagraphElement(doc, Paragraph.create([
+ *   Run.bold("Hello"),
+ *   Run.text(" world")
+ * ]));
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Query = exports.Sdt = exports.Drawing = exports.Table = exports.Math = exports.TrackChanges = exports.Comment = exports.Paragraph = exports.Field = exports.Run = void 0;
+const document_1 = require("./document");
+// =============================================================================
+// Run namespace — text run constructors
+// =============================================================================
+/** Namespace for creating text runs (inline content). */
+exports.Run = {
+    text: document_1.text,
+    bold: document_1.bold,
+    italic: document_1.italic,
+    pageBreak: document_1.pageBreak,
+    lineBreak: document_1.lineBreak,
+    columnBreak: document_1.columnBreak,
+    tab: document_1.tab,
+    positionalTab: document_1.positionalTab,
+    ruby: document_1.ruby,
+    carriageReturn: document_1.carriageReturn,
+    noBreakHyphen: document_1.noBreakHyphen,
+    softHyphen: document_1.softHyphen,
+    symbol: document_1.symbol
+};
+// =============================================================================
+// Field namespace — field code constructors
+// =============================================================================
+/** Namespace for creating field codes. */
+exports.Field = {
+    create: document_1.field,
+    pageNumber: document_1.pageNumberField,
+    totalPages: document_1.totalPagesField,
+    sectionPages: document_1.sectionPagesField,
+    section: document_1.sectionField,
+    date: document_1.dateField,
+    sequence: document_1.sequenceField,
+    time: document_1.timeField,
+    author: document_1.authorField,
+    title: document_1.titleField,
+    subject: document_1.subjectField,
+    keywords: document_1.keywordsField,
+    fileName: document_1.fileNameField,
+    fileSize: document_1.fileSizeField,
+    styleRef: document_1.styleRefField,
+    ref: document_1.refField,
+    pageRef: document_1.pageRefField,
+    noteRef: document_1.noteRefField,
+    hyperlink: document_1.hyperlinkField,
+    quote: document_1.quoteField,
+    toc: document_1.tocField,
+    tc: document_1.tcField,
+    indexEntry: document_1.indexEntryField,
+    index: document_1.indexField,
+    condition: document_1.ifField,
+    includeText: document_1.includeTextField,
+    includePicture: document_1.includePictureField,
+    formText: document_1.formTextField,
+    formCheckbox: document_1.formCheckboxField,
+    formDropdown: document_1.formDropdownField
+};
+// =============================================================================
+// Paragraph namespace — paragraph constructors
+// =============================================================================
+/** Namespace for creating paragraphs. */
+exports.Paragraph = {
+    create: document_1.paragraph,
+    text: document_1.textParagraph,
+    heading: document_1.heading,
+    hyperlink: document_1.hyperlink,
+    bookmarkStart: document_1.bookmarkStart,
+    bookmarkEnd: document_1.bookmarkEnd
+};
+// =============================================================================
+// Comment namespace — comment markers
+// =============================================================================
+/** Namespace for comment-related markers. */
+exports.Comment = {
+    rangeStart: document_1.commentRangeStart,
+    rangeEnd: document_1.commentRangeEnd,
+    reference: document_1.commentReference
+};
+// =============================================================================
+// TrackChanges namespace — revision markers
+// =============================================================================
+/** Namespace for track-changes (revision) markers. */
+exports.TrackChanges = {
+    insertedRun: document_1.insertedRun,
+    deletedRun: document_1.deletedRun,
+    movedFromRun: document_1.movedFromRun,
+    movedToRun: document_1.movedToRun,
+    moveFromRangeStart: document_1.moveFromRangeStart,
+    moveFromRangeEnd: document_1.moveFromRangeEnd,
+    moveToRangeStart: document_1.moveToRangeStart,
+    moveToRangeEnd: document_1.moveToRangeEnd
+};
+// =============================================================================
+// Math namespace — Office Math constructors
+// =============================================================================
+/** Namespace for OMML (Office Math) content. */
+exports.Math = {
+    block: document_1.mathBlock,
+    run: document_1.mathRun,
+    fraction: document_1.mathFraction,
+    sqrt: document_1.mathSqrt,
+    root: document_1.mathRoot,
+    sum: document_1.mathSum,
+    integral: document_1.mathIntegral,
+    product: document_1.mathProduct,
+    superScript: document_1.mathSuperScript,
+    subScript: document_1.mathSubScript,
+    subSuperScript: document_1.mathSubSuperScript,
+    preSubSuperScript: document_1.mathPreSubSuperScript,
+    phantom: document_1.mathPhantom,
+    groupChar: document_1.mathGroupChar,
+    borderBox: document_1.mathBorderBox,
+    delimiter: document_1.mathDelimiter,
+    nary: document_1.mathNary,
+    func: document_1.mathFunction,
+    limit: document_1.mathLimit,
+    matrix: document_1.mathMatrix,
+    accent: document_1.mathAccent,
+    bar: document_1.mathBar,
+    box: document_1.mathBox,
+    equationArray: document_1.mathEquationArray
+};
+// =============================================================================
+// Table namespace — table constructors
+// =============================================================================
+/** Namespace for creating tables. */
+exports.Table = {
+    create: document_1.table,
+    simple: document_1.simpleTable,
+    row: document_1.row,
+    cell: document_1.cell,
+    border: document_1.border,
+    gridBorders: document_1.gridBorders
+};
+// =============================================================================
+// Drawing namespace — images, shapes, charts
+// =============================================================================
+/** Namespace for drawings (images, shapes, charts). */
+exports.Drawing = {
+    floatingImage: document_1.floatingImage,
+    shape: document_1.drawingShape,
+    chart: document_1.chart
+};
+// =============================================================================
+// Sdt namespace — structured document tags
+// =============================================================================
+/** Namespace for structured document tags (content controls). */
+exports.Sdt = {
+    create: document_1.structuredDocumentTag,
+    checkBox: document_1.checkBox
+};
+// =============================================================================
+// Query namespace — document query/search functions
+// =============================================================================
+/** Namespace for querying/searching document content. */
+exports.Query = {
+    search: document_1.searchText,
+    replace: document_1.replaceText,
+    mailMerge: document_1.mailMerge,
+    paragraphCount: document_1.paragraphCount,
+    countWords: document_1.countWords,
+    getHeadings: document_1.getHeadings,
+    findBookmark: document_1.findBookmark,
+    findComment: document_1.findComment,
+    listImages: document_1.listImages,
+    listTables: document_1.listTables,
+    listHyperlinks: document_1.listHyperlinks,
+    tableCount: document_1.tableCount,
+    extractText: document_1.extractText
+};

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

@@ -4,57 +4,52 @@
  *
  * Manages OPC relationships for the DOCX package.
  * Generates .rels files for package-level and part-level relationships.
+ * Uses a plain data record + free functions for tree-shakeability.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RelationshipManager = void 0;
+exports.createRelationships = createRelationships;
+exports.addRelationship = addRelationship;
+exports.addRelationshipWithId = addRelationshipWithId;
+exports.getRelationshipCount = getRelationshipCount;
+exports.renderRelationships = renderRelationships;
 const constants_1 = require("./constants");
-/**
- * Manages relationships and generates .rels XML.
- */
-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;
+/** Create a new empty RelationshipsState. */
+function createRelationships() {
+    return { rels: [], nextId: 1 };
+}
+/** Add a relationship and return its assigned rId. */
+function addRelationship(state, type, target, targetMode) {
+    const id = `rId${state.nextId++}`;
+    state.rels.push({ id, type, target, targetMode });
+    return id;
+}
+/** Add a relationship with a specific ID. */
+function addRelationshipWithId(state, id, type, target, targetMode) {
+    state.rels.push({ id, type, target, targetMode });
+    // Keep nextId above any manually-assigned IDs
+    const num = parseInt(id.replace("rId", ""), 10);
+    if (!isNaN(num) && num >= state.nextId) {
+        state.nextId = num + 1;
     }
-    /** Render the relationships XML to a sink. */
-    render(xml) {
-        xml.openXml(constants_1.STD_DOC_ATTRIBUTES);
-        xml.openNode("Relationships", { xmlns: constants_1.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);
+}
+/** Get the number of relationships. */
+function getRelationshipCount(state) {
+    return state.rels.length;
+}
+/** Render the relationships XML to a sink. */
+function renderRelationships(state, xml) {
+    xml.openXml(constants_1.STD_DOC_ATTRIBUTES);
+    xml.openNode("Relationships", { xmlns: constants_1.NS_PKG_RELS });
+    for (const rel of state.rels) {
+        const attrs = {
+            Id: rel.id,
+            Type: rel.type,
+            Target: rel.target
+        };
+        if (rel.targetMode) {
+            attrs.TargetMode = rel.targetMode;
         }
-        xml.closeNode();
+        xml.leafNode("Relationship", attrs);
     }
+    xml.closeNode();
 }
-exports.RelationshipManager = RelationshipManager;

package/dist/esm/modules/pdf/excel-bridge.js

@@ -187,6 +187,31 @@ async function convertSheet(ws, workbook) {
             right: dimensions.model.right
         }
         : { top: 0, left: 0, bottom: 0, right: 0 };
+    // Expand bounds to include cells that only have styles (borders, fills, fonts)
+    // but no values — these are not tracked by dimensions.
+    if (hasData) {
+        for (let r = bounds.top; r <= bounds.bottom; r++) {
+            const row = ws.findRow(r);
+            if (!row) {
+                continue;
+            }
+            row.eachCell({ includeEmpty: true }, cell => {
+                if (cell.col > bounds.right) {
+                    const hasStyle = cell.style &&
+                        ((cell.style.border &&
+                            (cell.style.border.top ||
+                                cell.style.border.right ||
+                                cell.style.border.bottom ||
+                                cell.style.border.left)) ||
+                            cell.style.fill ||
+                            cell.style.font);
+                    if (hasStyle || (cell.type !== ValueType.Null && cell.type !== ValueType.Merge)) {
+                        bounds.right = cell.col;
+                    }
+                }
+            });
+        }
+    }
     // Convert columns
     const columns = new Map();
     if (hasData) {
@@ -480,7 +505,8 @@ function convertColor(color) {
     return {
         argb: color.argb,
         theme: color.theme,
-        tint: color.tint
+        tint: color.tint,
+        indexed: color.indexed
     };
 }
 function convertFill(fill) {

package/dist/esm/modules/pdf/render/layout-engine.js

@@ -551,7 +551,7 @@ function countWrapLines(cell, fontSize, scaleFactor, sheet, fontManager, options
         if (value && typeof value === "object" && "richText" in value) {
             const runs = value.richText;
             if (runs.length > 0) {
-                const wrappedCount = countRichTextWrapLines(text, runs, scaleFactor, effectiveWidth, fontManager, options);
+                const wrappedCount = countRichTextWrapLines(text, runs, scaleFactor, effectiveWidth, fontManager, options, cell.style?.font);
                 return Math.max(lineCount, wrappedCount);
             }
         }
@@ -571,7 +571,10 @@ function countWrapLines(cell, fontSize, scaleFactor, sheet, fontManager, options
  * This mirrors the logic in wrapRichTextLines (page-renderer) so that
  * the row height calculation matches the actual rendering.
  */
-function countRichTextWrapLines(text, runs, scaleFactor, effectiveWidth, fontManager, options) {
+function countRichTextWrapLines(text, runs, scaleFactor, effectiveWidth, fontManager, options, cellFont) {
+    // Use cell-level font as fallback for runs without their own font
+    const defaultFamily = cellFont?.name ?? options.defaultFontFamily;
+    const defaultSize = cellFont?.size ?? options.defaultFontSize;
     // Build character-to-run mapping
     const runForChar = [];
     for (let ri = 0; ri < runs.length; ri++) {
@@ -579,9 +582,20 @@ function countRichTextWrapLines(text, runs, scaleFactor, effectiveWidth, fontMan
             runForChar.push(ri);
         }
     }
-    // Resolve font resources for each run
+    // Resolve font resources for each run (with cell font inheritance)
     const runResources = runs.map(run => {
-        const fontProps = extractFontProperties(run.font, options.defaultFontFamily, options.defaultFontSize);
+        const effectiveRunFont = run.font
+            ? {
+                name: run.font.name ?? cellFont?.name,
+                size: run.font.size ?? cellFont?.size,
+                bold: run.font.bold ?? cellFont?.bold,
+                italic: run.font.italic ?? cellFont?.italic,
+                strike: run.font.strike ?? cellFont?.strike,
+                underline: run.font.underline ?? cellFont?.underline,
+                color: run.font.color ?? cellFont?.color
+            }
+            : cellFont;
+        const fontProps = extractFontProperties(effectiveRunFont, defaultFamily, defaultSize);
         const pdfFontName = resolvePdfFontName(fontProps.fontFamily, fontProps.bold, fontProps.italic);
         return fontManager.hasEmbeddedFont()
             ? fontManager.getEmbeddedResourceName()
@@ -589,7 +603,15 @@ function countRichTextWrapLines(text, runs, scaleFactor, effectiveWidth, fontMan
     });
     // Resolve scaled font sizes for each run
     const runFontSizes = runs.map(run => {
-        const fontProps = extractFontProperties(run.font, options.defaultFontFamily, options.defaultFontSize);
+        const effectiveRunFont = run.font
+            ? {
+                name: run.font.name ?? cellFont?.name,
+                size: run.font.size ?? cellFont?.size,
+                bold: run.font.bold ?? cellFont?.bold,
+                italic: run.font.italic ?? cellFont?.italic
+            }
+            : cellFont;
+        const fontProps = extractFontProperties(effectiveRunFont, defaultFamily, defaultSize);
         return fontProps.fontSize * scaleFactor;
     });
     // Measure a range of fullText using per-character run font sizes
@@ -861,8 +883,10 @@ function buildLayoutCell(cell, x, y, width, height, colSpan, rowSpan, options, f
         // Track non-WinAnsi code points for Type3 fallback font generation
         fontManager.trackText(text);
     }
-    // Rich text runs
-    const richText = buildRichTextRuns(cell, options, fontManager, scaleFactor);
+    // Rich text runs — pass cell-level font as the fallback for runs without
+    // their own font definition (e.g. the first run often has no font object
+    // and should inherit the cell's style font including bold/italic).
+    const richText = buildRichTextRuns(cell, options, fontManager, scaleFactor, style.font);
     const borders = excelBordersToPdf(style.border);
     return {
         text,
@@ -1305,6 +1329,30 @@ function computeTextOverflows(cellGrid, rowPage, colGroup, visibleRows, visibleC
             }
             if (overflowAvailable > 0) {
                 cell.textOverflowWidth = Math.min(overflowNeeded, overflowAvailable);
+                // Hide internal vertical borders in the overflow region.
+                // In Excel, when text overflows into adjacent empty cells, the shared
+                // vertical borders between them are not drawn (the text appears to
+                // span across seamlessly). We suppress:
+                // - The overflowing cell's right border
+                // - Each covered neighbor's left border (and right border if fully covered)
+                let accumulated = 0;
+                const actualOverflow = cell.textOverflowWidth;
+                // Remove the source cell's right border if text overflows
+                cell.borders.right = null;
+                for (let j = gci + 1; j < colGroup.length; j++) {
+                    const neighborCell = cellGrid.get(`${ri}:${j}`);
+                    if (!neighborCell) {
+                        break;
+                    }
+                    // Remove the neighbor's left border (shared edge with previous cell)
+                    neighborCell.borders.left = null;
+                    accumulated += groupColWidths[j];
+                    if (accumulated >= actualOverflow) {
+                        break;
+                    }
+                    // If fully covered, also remove the neighbor's right border
+                    neighborCell.borders.right = null;
+                }
             }
         }
     }
@@ -1316,7 +1364,7 @@ function computeTextOverflows(cellGrid, rowPage, colGroup, visibleRows, visibleC
  * Build rich text runs from a RichText cell.
  * Returns null for non-RichText cells.
  */
-function buildRichTextRuns(cell, options, fontManager, scaleFactor) {
+function buildRichTextRuns(cell, options, fontManager, scaleFactor, cellFont) {
     if (!cell || cell.type !== PdfCellType.RichText) {
         return null;
     }
@@ -1328,8 +1376,25 @@ function buildRichTextRuns(cell, options, fontManager, scaleFactor) {
     if (runs.length === 0) {
         return null;
     }
+    // Use cell-level font as fallback for runs without their own font,
+    // falling back to global defaults only if cell font is not available.
+    const defaultFamily = cellFont?.name ?? options.defaultFontFamily;
+    const defaultSize = cellFont?.size ?? options.defaultFontSize;
     return runs.map(run => {
-        const fontProps = extractFontProperties(run.font, options.defaultFontFamily, options.defaultFontSize);
+        // When a run has no font at all, use cell font entirely.
+        // When a run has a partial font, merge with cell font for missing properties.
+        const effectiveFont = run.font
+            ? {
+                name: run.font.name ?? cellFont?.name,
+                size: run.font.size ?? cellFont?.size,
+                bold: run.font.bold ?? cellFont?.bold,
+                italic: run.font.italic ?? cellFont?.italic,
+                strike: run.font.strike ?? cellFont?.strike,
+                underline: run.font.underline ?? cellFont?.underline,
+                color: run.font.color ?? cellFont?.color
+            }
+            : cellFont;
+        const fontProps = extractFontProperties(effectiveFont, defaultFamily, defaultSize);
         // Register font for this run
         if (fontManager.hasEmbeddedFont()) {
             fontManager.trackText(run.text);

package/dist/esm/modules/pdf/render/style-converter.js

@@ -50,7 +50,7 @@ export function argbToPdfColor(argb) {
 }
 /**
  * Convert a color data object to PDF color.
- * Handles both ARGB and theme-based colors.
+ * Handles ARGB, theme-based, and indexed colors.
  */
 export function excelColorToPdf(color) {
     if (!color) {
@@ -72,6 +72,10 @@ export function excelColorToPdf(color) {
         }
         return base;
     }
+    // Indexed colors (legacy Excel color palette)
+    if (color.indexed !== undefined) {
+        return indexedColorToPdf(color.indexed);
+    }
     return null;
 }
 /**
@@ -97,6 +101,99 @@ function themeColorToPdf(themeIndex) {
     }
     return null;
 }
+/**
+ * Standard Excel indexed color palette (56 colors + system colors).
+ * Index 0–7: legacy base colors
+ * Index 8–63: standard palette (indices 8–63)
+ * Index 64: system foreground (black)
+ * Index 65: system background (white)
+ *
+ * @see ECMA-376 §18.8.27 — indexedColors
+ */
+const INDEXED_COLORS = [
+    // 0–7: legacy base colors (same as 8–15 but less commonly used directly)
+    "000000", // 0: Black
+    "FFFFFF", // 1: White
+    "FF0000", // 2: Red
+    "00FF00", // 3: Green
+    "0000FF", // 4: Blue
+    "FFFF00", // 5: Yellow
+    "FF00FF", // 6: Magenta
+    "00FFFF", // 7: Cyan
+    // 8–63: standard palette
+    "000000", // 8: Black
+    "FFFFFF", // 9: White
+    "FF0000", // 10: Red
+    "00FF00", // 11: Green
+    "0000FF", // 12: Blue
+    "FFFF00", // 13: Yellow
+    "FF00FF", // 14: Magenta
+    "00FFFF", // 15: Cyan
+    "800000", // 16: Dark Red
+    "008000", // 17: Dark Green
+    "000080", // 18: Dark Blue (Navy)
+    "808000", // 19: Dark Yellow (Olive)
+    "800080", // 20: Purple
+    "008080", // 21: Teal
+    "C0C0C0", // 22: Silver
+    "808080", // 23: Gray
+    "9999FF", // 24: Periwinkle
+    "993366", // 25: Plum
+    "FFFFCC", // 26: Ivory
+    "CCFFFF", // 27: Light Cyan
+    "660066", // 28: Dark Purple
+    "FF8080", // 29: Coral
+    "0066CC", // 30: Ocean Blue
+    "CCCCFF", // 31: Ice Blue
+    "000080", // 32: Dark Blue
+    "FF00FF", // 33: Pink
+    "FFFF00", // 34: Yellow
+    "00FFFF", // 35: Cyan
+    "800080", // 36: Purple
+    "800000", // 37: Dark Red
+    "008080", // 38: Teal
+    "0000FF", // 39: Blue
+    "00CCFF", // 40: Sky Blue
+    "CCFFFF", // 41: Light Turquoise
+    "CCFFCC", // 42: Light Green
+    "FFFF99", // 43: Light Yellow
+    "99CCFF", // 44: Pale Blue
+    "FF99CC", // 45: Rose
+    "CC99FF", // 46: Lavender
+    "FFCC99", // 47: Tan
+    "3366FF", // 48: Light Blue
+    "33CCCC", // 49: Aqua
+    "99CC00", // 50: Lime
+    "FFCC00", // 51: Gold
+    "FF9900", // 52: Light Orange
+    "FF6600", // 53: Orange
+    "666699", // 54: Blue Gray
+    "969696", // 55: Gray 40%
+    "003366", // 56: Dark Teal
+    "339966", // 57: Sea Green
+    "003300", // 58: Very Dark Green
+    "333300", // 59: Dark Olive
+    "993300", // 60: Brown
+    "993366", // 61: Plum
+    "333399", // 62: Indigo
+    "333333" // 63: Gray 80%
+];
+/**
+ * Convert an indexed color to PDF color.
+ * Index 64 = system foreground (black), 65 = system background (white).
+ */
+function indexedColorToPdf(index) {
+    if (index === 64) {
+        return { r: 0, g: 0, b: 0 }; // System foreground (black)
+    }
+    if (index === 65) {
+        return { r: 1, g: 1, b: 1 }; // System background (white)
+    }
+    if (index >= 0 && index < INDEXED_COLORS.length) {
+        return argbToPdfColor(INDEXED_COLORS[index]) ?? null;
+    }
+    return null;
+}
 /**
  * Apply a tint value to a color.
  * Tint range: -1.0 (fully dark) to +1.0 (fully light).