@cj-tech-master/excelts 4.0.0 → 4.0.1-canary.20260104072032.0453bbe

package/dist/browser/utils/utils.base.js

@@ -0,0 +1,275 @@
+/**
+ * Base utility functions shared between Node.js and Browser
+ * All functions use standard Web APIs that work in both environments
+ * (Node.js 16+ supports atob/btoa/TextEncoder/TextDecoder globally)
+ */
+import { isNode } from "./env.js";
+// =============================================================================
+// Base64 utilities (with native Buffer optimization for Node.js)
+// =============================================================================
+/**
+ * Convert base64 string to Uint8Array
+ * Uses native Buffer in Node.js for better performance
+ */
+export function base64ToUint8Array(base64) {
+    // Node.js: use native Buffer (fast, C++ implementation)
+    if (isNode()) {
+        return Buffer.from(base64, "base64");
+    }
+    // Browser: use atob
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+// =============================================================================
+// Basic utilities
+// =============================================================================
+export function delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export function nop() { }
+export const inherits = function (cls, superCtor, statics, prototype) {
+    cls.super_ = superCtor;
+    if (!prototype) {
+        prototype = statics;
+        statics = null;
+    }
+    if (statics) {
+        Object.keys(statics).forEach(i => {
+            Object.defineProperty(cls, i, Object.getOwnPropertyDescriptor(statics, i));
+        });
+    }
+    const properties = {
+        constructor: {
+            value: cls,
+            enumerable: false,
+            writable: false,
+            configurable: true
+        }
+    };
+    if (prototype) {
+        Object.keys(prototype).forEach(i => {
+            properties[i] = Object.getOwnPropertyDescriptor(prototype, i);
+        });
+    }
+    cls.prototype = Object.create(superCtor.prototype, properties);
+};
+// =============================================================================
+// Date utilities
+// =============================================================================
+export function dateToExcel(d, date1904) {
+    return 25569 + d.getTime() / (24 * 3600 * 1000) - (date1904 ? 1462 : 0);
+}
+export function excelToDate(v, date1904) {
+    const millisecondSinceEpoch = Math.round((v - 25569 + (date1904 ? 1462 : 0)) * 24 * 3600 * 1000);
+    return new Date(millisecondSinceEpoch);
+}
+export function toIsoDateString(dt) {
+    return dt.toISOString().substr(0, 10);
+}
+export function parsePath(filepath) {
+    const last = filepath.lastIndexOf("/");
+    return {
+        path: filepath.substring(0, last),
+        name: filepath.substring(last + 1)
+    };
+}
+export function getRelsPath(filepath) {
+    const path = parsePath(filepath);
+    return `${path.path}/_rels/${path.name}.rels`;
+}
+// =============================================================================
+// XML utilities
+// =============================================================================
+const xmlDecodingMap = {
+    lt: "<",
+    gt: ">",
+    amp: "&",
+    quot: '"',
+    apos: "'"
+};
+export function xmlDecode(text) {
+    if (text.indexOf("&") === -1) {
+        return text;
+    }
+    return text.replace(/&(#\d+|#x[0-9A-Fa-f]+|\w+);/g, (match, entity) => {
+        if (entity[0] === "#") {
+            // Numeric character reference
+            const code = entity[1] === "x" ? parseInt(entity.slice(2), 16) : parseInt(entity.slice(1));
+            if (Number.isNaN(code)) {
+                return match;
+            }
+            return String.fromCodePoint(code);
+        }
+        return xmlDecodingMap[entity] || match;
+    });
+}
+// oxlint-disable-next-line no-control-regex -- Control characters are intentionally matched for XML encoding
+const xmlEncodeRegex = /[<>&'"\x7F\x00-\x08\x0B-\x0C\x0E-\x1F]/;
+/**
+ * Encode special characters for XML output
+ * Handles XML entities (< > & " ') and removes invalid control characters
+ */
+export function xmlEncode(text) {
+    const regexResult = xmlEncodeRegex.exec(text);
+    if (!regexResult) {
+        return text;
+    }
+    const parts = [];
+    let lastIndex = 0;
+    for (let i = regexResult.index; i < text.length; i++) {
+        const charCode = text.charCodeAt(i);
+        let escape = null;
+        switch (charCode) {
+            case 34: // "
+                escape = "&quot;";
+                break;
+            case 38: // &
+                escape = "&amp;";
+                break;
+            case 39: // '
+                escape = "&apos;";
+                break;
+            case 60: // <
+                escape = "&lt;";
+                break;
+            case 62: // >
+                escape = "&gt;";
+                break;
+            case 127:
+                escape = "";
+                break;
+            default: {
+                if (charCode <= 31 && (charCode <= 8 || (charCode >= 11 && charCode !== 13))) {
+                    // Remove invalid control characters
+                    escape = "";
+                    break;
+                }
+                continue;
+            }
+        }
+        if (lastIndex !== i) {
+            parts.push(text.substring(lastIndex, i));
+        }
+        lastIndex = i + 1;
+        if (escape) {
+            parts.push(escape);
+        }
+    }
+    if (lastIndex < text.length) {
+        parts.push(text.substring(lastIndex));
+    }
+    return parts.join("");
+}
+// =============================================================================
+// Parsing utilities
+// =============================================================================
+export function validInt(value) {
+    const i = typeof value === "number" ? value : parseInt(value, 10);
+    return Number.isNaN(i) ? 0 : i;
+}
+export function isDateFmt(fmt) {
+    if (!fmt) {
+        return false;
+    }
+    // must not be a string fmt
+    if (fmt.indexOf("@") > -1) {
+        return false;
+    }
+    // must remove all chars inside quotes and []
+    let cleanFmt = fmt.replace(/\[[^\]]*\]/g, "");
+    cleanFmt = cleanFmt.replace(/"[^"]*"/g, "");
+    // then check for date formatting chars
+    return cleanFmt.match(/[ymdhMsb]+/) !== null;
+}
+export function parseBoolean(value) {
+    return value === true || value === "true" || value === 1 || value === "1";
+}
+// =============================================================================
+// Collection utilities
+// =============================================================================
+export function* range(start, stop, step = 1) {
+    const compareOrder = step > 0 ? (a, b) => a < b : (a, b) => a > b;
+    for (let value = start; compareOrder(value, stop); value += step) {
+        yield value;
+    }
+}
+export function toSortedArray(values) {
+    const result = Array.from(values);
+    // If all numbers, use numeric sort
+    if (result.every(item => Number.isFinite(item))) {
+        return result.sort((a, b) => a - b);
+    }
+    return result.sort();
+}
+export function objectFromProps(props, value = null) {
+    return props.reduce((result, property) => {
+        result[property] = value;
+        return result;
+    }, {});
+}
+// =============================================================================
+// Buffer utilities (cross-platform)
+// =============================================================================
+const textDecoder = new TextDecoder("utf-8");
+let latin1Decoder;
+try {
+    // Faster base64 encoding path in browsers: decode bytes into a binary string once.
+    // Some environments may not support this encoding.
+    latin1Decoder = new TextDecoder("latin1");
+}
+catch {
+    latin1Decoder = undefined;
+}
+/**
+ * Convert a Buffer, ArrayBuffer, or Uint8Array to a UTF-8 string
+ * Works in both Node.js and browser environments
+ */
+export function bufferToString(chunk) {
+    if (typeof chunk === "string") {
+        return chunk;
+    }
+    return textDecoder.decode(chunk);
+}
+/**
+ * Convert Uint8Array to base64 string
+ * Uses native Buffer in Node.js, optimized chunked conversion in browser
+ */
+export function uint8ArrayToBase64(bytes) {
+    if (isNode()) {
+        return Buffer.from(bytes).toString("base64");
+    }
+    // Browser: fastest path when latin1 TextDecoder exists.
+    // Some environments can still throw on `btoa(...)` (e.g. if decoding yields non-Latin1 chars),
+    // so fall back to a guaranteed-binary string conversion.
+    if (latin1Decoder) {
+        try {
+            return btoa(latin1Decoder.decode(bytes));
+        }
+        catch {
+            // fall through
+        }
+    }
+    // Browser: chunked String.fromCharCode.apply to avoid stack overflow and reduce string concatenation
+    const CHUNK_SIZE = 0x8000; // 32KB chunks
+    const chunks = [];
+    for (let i = 0; i < bytes.length; i += CHUNK_SIZE) {
+        chunks.push(String.fromCharCode.apply(null, bytes.subarray(i, i + CHUNK_SIZE)));
+    }
+    return btoa(chunks.join(""));
+}
+/**
+ * Convert string to UTF-16LE Uint8Array (used for Excel password hashing)
+ */
+export function stringToUtf16Le(str) {
+    const bytes = new Uint8Array(str.length * 2);
+    for (let i = 0; i < str.length; i++) {
+        const code = str.charCodeAt(i);
+        bytes[i * 2] = code & 0xff;
+        bytes[i * 2 + 1] = (code >> 8) & 0xff;
+    }
+    return bytes;
+}

package/dist/browser/utils/utils.browser.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Browser utility functions
+ * Re-exports shared utilities and adds browser-specific implementations
+ */
+export { delay, nop, inherits, dateToExcel, excelToDate, toIsoDateString, parsePath, getRelsPath, xmlDecode, xmlEncode, validInt, isDateFmt, parseBoolean, range, toSortedArray, objectFromProps, bufferToString, base64ToUint8Array, uint8ArrayToBase64, stringToUtf16Le } from "@utils/utils.base";
+export declare function fileExists(_path: string): Promise<boolean>;

package/dist/browser/utils/utils.browser.js

@@ -0,0 +1,12 @@
+/**
+ * Browser utility functions
+ * Re-exports shared utilities and adds browser-specific implementations
+ */
+// Re-export all shared utilities
+export { delay, nop, inherits, dateToExcel, excelToDate, toIsoDateString, parsePath, getRelsPath, xmlDecode, xmlEncode, validInt, isDateFmt, parseBoolean, range, toSortedArray, objectFromProps, bufferToString, base64ToUint8Array, uint8ArrayToBase64, stringToUtf16Le } from "./utils.base.js";
+// =============================================================================
+// File system utilities (Browser stub - always returns false)
+// =============================================================================
+export function fileExists(_path) {
+    return Promise.resolve(false);
+}

package/dist/browser/utils/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Node.js utility functions
+ * Re-exports shared utilities and adds Node.js-specific implementations
+ */
+export { delay, nop, inherits, dateToExcel, excelToDate, toIsoDateString, parsePath, getRelsPath, xmlDecode, xmlEncode, validInt, isDateFmt, parseBoolean, range, toSortedArray, objectFromProps, bufferToString, base64ToUint8Array, uint8ArrayToBase64, stringToUtf16Le } from "@utils/utils.base";
+export declare function fileExists(path: string): Promise<boolean>;

package/dist/browser/utils/utils.js

@@ -0,0 +1,19 @@
+/**
+ * Node.js utility functions
+ * Re-exports shared utilities and adds Node.js-specific implementations
+ */
+import fs from "fs";
+// Re-export all shared utilities
+export { delay, nop, inherits, dateToExcel, excelToDate, toIsoDateString, parsePath, getRelsPath, xmlDecode, xmlEncode, validInt, isDateFmt, parseBoolean, range, toSortedArray, objectFromProps, bufferToString, base64ToUint8Array, uint8ArrayToBase64, stringToUtf16Le } from "./utils.base.js";
+// =============================================================================
+// File system utilities (Node.js only)
+// =============================================================================
+export async function fileExists(path) {
+    try {
+        await fs.promises.access(path, fs.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/browser/utils/uuid.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate a UUID v4.
+ *
+ * This exists to avoid a hard dependency on `crypto.randomUUID()` so that
+ * older supported browsers can still generate UUIDs.
+ *
+ * - Prefers `crypto.randomUUID()` when available.
+ * - Falls back to `crypto.getRandomValues()`.
+ * - Last-resort fallback uses `Math.random()` (NOT cryptographically secure).
+ */
+export declare function uuidV4(): string;

package/dist/browser/utils/uuid.js

@@ -0,0 +1,55 @@
+function toHex(byte) {
+    return byte.toString(16).padStart(2, "0");
+}
+function bytesToUuidV4(bytes) {
+    // RFC 4122, version 4 UUID
+    // Set version (4) and variant (10xx)
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const b = bytes;
+    return (toHex(b[0]) +
+        toHex(b[1]) +
+        toHex(b[2]) +
+        toHex(b[3]) +
+        "-" +
+        toHex(b[4]) +
+        toHex(b[5]) +
+        "-" +
+        toHex(b[6]) +
+        toHex(b[7]) +
+        "-" +
+        toHex(b[8]) +
+        toHex(b[9]) +
+        "-" +
+        toHex(b[10]) +
+        toHex(b[11]) +
+        toHex(b[12]) +
+        toHex(b[13]) +
+        toHex(b[14]) +
+        toHex(b[15]));
+}
+/**
+ * Generate a UUID v4.
+ *
+ * This exists to avoid a hard dependency on `crypto.randomUUID()` so that
+ * older supported browsers can still generate UUIDs.
+ *
+ * - Prefers `crypto.randomUUID()` when available.
+ * - Falls back to `crypto.getRandomValues()`.
+ * - Last-resort fallback uses `Math.random()` (NOT cryptographically secure).
+ */
+export function uuidV4() {
+    const cryptoObj = globalThis.crypto;
+    if (cryptoObj?.randomUUID) {
+        return cryptoObj.randomUUID();
+    }
+    const bytes = new Uint8Array(16);
+    if (cryptoObj?.getRandomValues) {
+        cryptoObj.getRandomValues(bytes);
+        return bytesToUuidV4(bytes);
+    }
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = Math.floor(Math.random() * 256);
+    }
+    return bytesToUuidV4(bytes);
+}

package/dist/cjs/modules/excel/table.js

@@ -176,7 +176,14 @@ class Table {
             const r = worksheet.getRow(row + count++);
             data.forEach((value, j) => {
                 const cell = r.getCell(col + j);
-                cell.value = value;
+                const formula = value?.formula;
+                cell.value =
+                    typeof formula === "string"
+                        ? {
+                            ...value,
+                            formula: formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`)
+                        }
+                        : value;
                 assignStyle(cell, table.columns[j].style);
             });
         });

package/dist/esm/modules/excel/table.js

@@ -173,7 +173,14 @@ class Table {
             const r = worksheet.getRow(row + count++);
             data.forEach((value, j) => {
                 const cell = r.getCell(col + j);
-                cell.value = value;
+                const formula = value?.formula;
+                cell.value =
+                    typeof formula === "string"
+                        ? {
+                            ...value,
+                            formula: formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`)
+                        }
+                        : value;
                 assignStyle(cell, table.columns[j].style);
             });
         });

package/dist/{browser → iife}/excelts.iife.js

@@ -1,5 +1,5 @@
 /*!
- * @cj-tech-master/excelts v4.0.0
+ * @cj-tech-master/excelts v4.0.1-canary.20260104072032.0453bbe
  * TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.
  * (c) 2026 cjnoname
  * Released under the MIT License
@@ -2395,7 +2395,11 @@ var ExcelTS = (function(exports) {
 				const r = worksheet.getRow(row + count++);
 				data.forEach((value, j) => {
 					const cell = r.getCell(col + j);
-					cell.value = value;
+					const formula = value?.formula;
+					cell.value = typeof formula === "string" ? {
+						...value,
+						formula: formula.replace(/(^|[^A-Za-z0-9_])\[@\[?([^\[\]]+?)\]?\]/g, `$1${table.name}[[#This Row],[$2]]`)
+					} : value;
 					assignStyle(cell, table.columns[j].style);
 				});
 			});