@cj-tech-master/excelts 9.5.0 → 9.5.1

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

@@ -0,0 +1,189 @@
+/**
+ * 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")
+ * ]));
+ * ```
+ */
+import { text, bold, italic, pageBreak, lineBreak, columnBreak, tab, positionalTab, ruby, carriageReturn, noBreakHyphen, softHyphen, symbol, 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, floatingImage, drawingShape, chart, structuredDocumentTag, border, gridBorders, cell, row, table, simpleTable, searchText, replaceText, mailMerge, paragraphCount, countWords, getHeadings, findBookmark, findComment, listImages, listTables, listHyperlinks, tableCount, extractText } from "./document.js";
+// =============================================================================
+// Run namespace — text run constructors
+// =============================================================================
+/** Namespace for creating text runs (inline content). */
+export const Run = {
+    text,
+    bold,
+    italic,
+    pageBreak,
+    lineBreak,
+    columnBreak,
+    tab,
+    positionalTab,
+    ruby,
+    carriageReturn,
+    noBreakHyphen,
+    softHyphen,
+    symbol
+};
+// =============================================================================
+// Field namespace — field code constructors
+// =============================================================================
+/** Namespace for creating field codes. */
+export const Field = {
+    create: field,
+    pageNumber: pageNumberField,
+    totalPages: totalPagesField,
+    sectionPages: sectionPagesField,
+    section: sectionField,
+    date: dateField,
+    sequence: sequenceField,
+    time: timeField,
+    author: authorField,
+    title: titleField,
+    subject: subjectField,
+    keywords: keywordsField,
+    fileName: fileNameField,
+    fileSize: fileSizeField,
+    styleRef: styleRefField,
+    ref: refField,
+    pageRef: pageRefField,
+    noteRef: noteRefField,
+    hyperlink: hyperlinkField,
+    quote: quoteField,
+    toc: tocField,
+    tc: tcField,
+    indexEntry: indexEntryField,
+    index: indexField,
+    condition: ifField,
+    includeText: includeTextField,
+    includePicture: includePictureField,
+    formText: formTextField,
+    formCheckbox: formCheckboxField,
+    formDropdown: formDropdownField
+};
+// =============================================================================
+// Paragraph namespace — paragraph constructors
+// =============================================================================
+/** Namespace for creating paragraphs. */
+export const Paragraph = {
+    create: paragraph,
+    text: textParagraph,
+    heading,
+    hyperlink,
+    bookmarkStart,
+    bookmarkEnd
+};
+// =============================================================================
+// Comment namespace — comment markers
+// =============================================================================
+/** Namespace for comment-related markers. */
+export const Comment = {
+    rangeStart: commentRangeStart,
+    rangeEnd: commentRangeEnd,
+    reference: commentReference
+};
+// =============================================================================
+// TrackChanges namespace — revision markers
+// =============================================================================
+/** Namespace for track-changes (revision) markers. */
+export const TrackChanges = {
+    insertedRun,
+    deletedRun,
+    movedFromRun,
+    movedToRun,
+    moveFromRangeStart,
+    moveFromRangeEnd,
+    moveToRangeStart,
+    moveToRangeEnd
+};
+// =============================================================================
+// Math namespace — Office Math constructors
+// =============================================================================
+/** Namespace for OMML (Office Math) content. */
+export const Math = {
+    block: mathBlock,
+    run: mathRun,
+    fraction: mathFraction,
+    sqrt: mathSqrt,
+    root: mathRoot,
+    sum: mathSum,
+    integral: mathIntegral,
+    product: mathProduct,
+    superScript: mathSuperScript,
+    subScript: mathSubScript,
+    subSuperScript: mathSubSuperScript,
+    preSubSuperScript: mathPreSubSuperScript,
+    phantom: mathPhantom,
+    groupChar: mathGroupChar,
+    borderBox: mathBorderBox,
+    delimiter: mathDelimiter,
+    nary: mathNary,
+    func: mathFunction,
+    limit: mathLimit,
+    matrix: mathMatrix,
+    accent: mathAccent,
+    bar: mathBar,
+    box: mathBox,
+    equationArray: mathEquationArray
+};
+// =============================================================================
+// Table namespace — table constructors
+// =============================================================================
+/** Namespace for creating tables. */
+export const Table = {
+    create: table,
+    simple: simpleTable,
+    row,
+    cell,
+    border,
+    gridBorders
+};
+// =============================================================================
+// Drawing namespace — images, shapes, charts
+// =============================================================================
+/** Namespace for drawings (images, shapes, charts). */
+export const Drawing = {
+    floatingImage,
+    shape: drawingShape,
+    chart
+};
+// =============================================================================
+// Sdt namespace — structured document tags
+// =============================================================================
+/** Namespace for structured document tags (content controls). */
+export const Sdt = {
+    create: structuredDocumentTag,
+    checkBox
+};
+// =============================================================================
+// Query namespace — document query/search functions
+// =============================================================================
+/** Namespace for querying/searching document content. */
+export const Query = {
+    search: searchText,
+    replace: replaceText,
+    mailMerge,
+    paragraphCount,
+    countWords,
+    getHeadings,
+    findBookmark,
+    findComment,
+    listImages,
+    listTables,
+    listHyperlinks,
+    tableCount,
+    extractText
+};

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

@@ -3,54 +3,46 @@
  *
  * 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.
  */
 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;
+/** Create a new empty RelationshipsState. */
+export function createRelationships() {
+    return { rels: [], nextId: 1 };
+}
+/** Add a relationship and return its assigned rId. */
+export 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. */
+export 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(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);
+}
+/** Get the number of relationships. */
+export function getRelationshipCount(state) {
+    return state.rels.length;
+}
+/** Render the relationships XML to a sink. */
+export function renderRelationships(state, xml) {
+    xml.openXml(STD_DOC_ATTRIBUTES);
+    xml.openNode("Relationships", { xmlns: 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();
 }

package/dist/iife/excelts.iife.js

@@ -1,5 +1,5 @@
 /*!
-* @cj-tech-master/excelts v9.5.0
+* @cj-tech-master/excelts v9.5.1
 * Zero-dependency TypeScript toolkit — Excel (XLSX), PDF, CSV, Markdown, XML, ZIP/TAR, and streaming.
 * (c) 2026 cjnoname
 * Released under the MIT License
@@ -88381,7 +88381,7 @@ self.onmessage = async function(event) {
 	}
 	/**
 	* Convert a color data object to PDF color.
-	* Handles both ARGB and theme-based colors.
+	* Handles ARGB, theme-based, and indexed colors.
 	*/
 	function excelColorToPdf(color) {
 		if (!color) return null;
@@ -88393,6 +88393,7 @@ self.onmessage = async function(event) {
 			if (tint !== void 0 && tint !== 0) return applyTint(base, tint);
 			return base;
 		}
+		if (color.indexed !== void 0) return indexedColorToPdf(color.indexed);
 		return null;
 	}
 	/**
@@ -88456,6 +88457,99 @@ self.onmessage = async function(event) {
 		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 = [
+		"000000",
+		"FFFFFF",
+		"FF0000",
+		"00FF00",
+		"0000FF",
+		"FFFF00",
+		"FF00FF",
+		"00FFFF",
+		"000000",
+		"FFFFFF",
+		"FF0000",
+		"00FF00",
+		"0000FF",
+		"FFFF00",
+		"FF00FF",
+		"00FFFF",
+		"800000",
+		"008000",
+		"000080",
+		"808000",
+		"800080",
+		"008080",
+		"C0C0C0",
+		"808080",
+		"9999FF",
+		"993366",
+		"FFFFCC",
+		"CCFFFF",
+		"660066",
+		"FF8080",
+		"0066CC",
+		"CCCCFF",
+		"000080",
+		"FF00FF",
+		"FFFF00",
+		"00FFFF",
+		"800080",
+		"800000",
+		"008080",
+		"0000FF",
+		"00CCFF",
+		"CCFFFF",
+		"CCFFCC",
+		"FFFF99",
+		"99CCFF",
+		"FF99CC",
+		"CC99FF",
+		"FFCC99",
+		"3366FF",
+		"33CCCC",
+		"99CC00",
+		"FFCC00",
+		"FF9900",
+		"FF6600",
+		"666699",
+		"969696",
+		"003366",
+		"339966",
+		"003300",
+		"333300",
+		"993300",
+		"993366",
+		"333399",
+		"333333"
+	];
+	/**
+	* 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
+		};
+		if (index === 65) return {
+			r: 1,
+			g: 1,
+			b: 1
+		};
+		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).
 	* Negative tint darkens, positive tint lightens.
@@ -89061,7 +89155,7 @@ self.onmessage = async function(event) {
 			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);
 				}
 			}
@@ -89079,16 +89173,31 @@ self.onmessage = async function(event) {
 	* 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) {
+		const defaultFamily = cellFont?.name ?? options.defaultFontFamily;
+		const defaultSize = cellFont?.size ?? options.defaultFontSize;
 		const runForChar = [];
 		for (let ri = 0; ri < runs.length; ri++) for (let ci = 0; ci < runs[ri].text.length; ci++) runForChar.push(ri);
 		const runResources = runs.map((run) => {
-			const fontProps = extractFontProperties(run.font, options.defaultFontFamily, options.defaultFontSize);
+			const fontProps = extractFontProperties(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, defaultFamily, defaultSize);
 			const pdfFontName = resolvePdfFontName(fontProps.fontFamily, fontProps.bold, fontProps.italic);
 			return fontManager.hasEmbeddedFont() ? fontManager.getEmbeddedResourceName() : fontManager.ensureFont(pdfFontName);
 		});
 		const runFontSizes = runs.map((run) => {
-			return extractFontProperties(run.font, options.defaultFontFamily, options.defaultFontSize).fontSize * scaleFactor;
+			return extractFontProperties(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, defaultFamily, defaultSize).fontSize * scaleFactor;
 		});
 		const measureRange = (start, end) => {
 			let width = 0;
@@ -89287,7 +89396,7 @@ self.onmessage = async function(event) {
 			fontManager.ensureFont(pdfFontName);
 			fontManager.trackText(text);
 		}
-		const richText = buildRichTextRuns(cell, options, fontManager, scaleFactor);
+		const richText = buildRichTextRuns(cell, options, fontManager, scaleFactor, style.font);
 		const borders = excelBordersToPdf(style.border);
 		return {
 			text,
@@ -89622,21 +89731,44 @@ self.onmessage = async function(event) {
 				overflowAvailable += groupColWidths[j];
 				if (overflowAvailable >= overflowNeeded) break;
 			}
-			if (overflowAvailable > 0) cell.textOverflowWidth = Math.min(overflowNeeded, overflowAvailable);
+			if (overflowAvailable > 0) {
+				cell.textOverflowWidth = Math.min(overflowNeeded, overflowAvailable);
+				let accumulated = 0;
+				const actualOverflow = cell.textOverflowWidth;
+				cell.borders.right = null;
+				for (let j = gci + 1; j < colGroup.length; j++) {
+					const neighborCell = cellGrid.get(`${ri}:${j}`);
+					if (!neighborCell) break;
+					neighborCell.borders.left = null;
+					accumulated += groupColWidths[j];
+					if (accumulated >= actualOverflow) break;
+					neighborCell.borders.right = null;
+				}
+			}
 		}
 	}
 	/**
 	* 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;
 		const value = cell.value;
 		if (!value || typeof value !== "object" || !("richText" in value)) return null;
 		const runs = value.richText;
 		if (runs.length === 0) return null;
+		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);
+			const fontProps = extractFontProperties(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, defaultFamily, defaultSize);
 			if (fontManager.hasEmbeddedFont()) fontManager.trackText(run.text);
 			else {
 				const pdfFontName = resolvePdfFontName(fontProps.fontFamily, fontProps.bold, fontProps.italic);
@@ -90369,6 +90501,15 @@ self.onmessage = async function(event) {
 			bottom: 0,
 			right: 0
 		};
+		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) {
+					if (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) || cell.type !== 0 && cell.type !== 1) bounds.right = cell.col;
+				}
+			});
+		}
 		const columns = /* @__PURE__ */ new Map();
 		if (hasData) for (let c = bounds.left; c <= bounds.right; c++) {
 			const col = ws.getColumn(c);
@@ -90562,7 +90703,8 @@ self.onmessage = async function(event) {
 		return {
 			argb: color.argb,
 			theme: color.theme,
-			tint: color.tint
+			tint: color.tint,
+			indexed: color.indexed
 		};
 	}
 	function convertFill(fill) {