@cj-tech-master/excelts 9.4.2 → 9.5.0

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

@@ -2,7 +2,7 @@
  * Browser entry point - No Node.js dependencies
  * This version is optimized for browser environments with minimal bundle size
  */
-export { Workbook } from "./modules/excel/workbook.js";
+export { Workbook } from "./modules/excel/workbook.browser.js";
 export { Worksheet } from "./modules/excel/worksheet.js";
 export { Row } from "./modules/excel/row.js";
 export { Column } from "./modules/excel/column.js";
@@ -18,27 +18,30 @@ export * from "./modules/excel/enums.js";
 export * from "./modules/excel/types.js";
 export { createTextWatermarkImage } from "./modules/excel/utils/watermark-image.js";
 export type { TextWatermarkImageOptions } from "./modules/excel/utils/watermark-image.js";
-export type { PivotTable, PivotTableModel, PivotTableValue, PivotTableSource, CacheField, SharedItemValue, DataField, PivotTableSubtotal, RecordValue, ParsedCacheDefinition, ParsedCacheRecords } from "./modules/excel/pivot-table.js";
+export type { PivotTable, PivotTableModel, PivotTableValue, PivotTableSource, CacheField, SharedItemValue, DataField, PivotTableChartFormat, PivotTableSubtotal, RecordValue, ParsedCacheDefinition, ParsedCacheRecords } from "./modules/excel/pivot-table.js";
 export type { FormCheckboxModel, FormCheckboxOptions, FormControlRange, FormControlAnchor } from "./modules/excel/form-control.js";
 export { WorkbookWriter } from "./modules/excel/stream/workbook-writer.browser.js";
 export { WorkbookReader } from "./modules/excel/stream/workbook-reader.browser.js";
 export { WorksheetWriter } from "./modules/excel/stream/worksheet-writer.js";
 export { WorksheetReader } from "./modules/excel/stream/worksheet-reader.js";
-export type { CsvOptions, CsvInput } from "./modules/excel/workbook.js";
+export type { CsvOptions, CsvInput } from "./modules/excel/workbook.browser.js";
 export { CsvParserStream, CsvFormatterStream, createCsvParserStream, createCsvFormatterStream } from "./modules/csv/stream/index.js";
 export type { MarkdownOptions } from "./modules/markdown/types.js";
 export type { MarkdownAlignment, MarkdownParseResult, MarkdownParseOptions, MarkdownColumnConfig, MarkdownFormatOptions } from "./modules/markdown/types.js";
 export { DefinedNames, type DefinedNameModel } from "./modules/excel/defined-names.js";
+export { Chartsheet } from "./modules/excel/chartsheet.js";
+export type { AddChartsheetOptions, AddPivotChartsheetOptions, ChartsheetOptions, ChartsheetViewOptions } from "./modules/excel/chartsheet.js";
 export type { CheckboxState } from "./modules/excel/form-control.js";
 export type { ColumnDefn, ColumnHeaderValue } from "./modules/excel/column.js";
 export type { RangeInput } from "./modules/excel/range.js";
-export type { WorkbookModel, WorkbookMedia, WorkbookProtectionModel, ExternalLinkModel, ExternalLinkCachedSheet } from "./modules/excel/workbook.js";
+export type { WorkbookModel, WorkbookMedia, WorkbookProtectionModel, ExternalLinkModel, ExternalLinkCachedSheet } from "./modules/excel/workbook.browser.js";
+export { getCellDisplayText, formatCellValue, isDateDisplayFormat } from "./modules/excel/utils/cell-format.js";
 export { decodeCol, encodeCol, decodeRow, encodeRow, decodeCell, encodeCell, decodeRange, encodeRange } from "./modules/excel/utils/address.js";
 export type { CellAddress, SheetRange, Origin } from "./modules/excel/utils/address.js";
 export type { SheetToJSONOptions, AddJSONOptions, AddAOAOptions } from "./modules/excel/worksheet.js";
 export { dateToExcel, excelToDate } from "./utils/utils.base.js";
 export { base64ToUint8Array, uint8ArrayToBase64 } from "./utils/utils.base.js";
-export { xmlEncode, xmlDecode } from "./modules/xml/encode.js";
+export { xmlEncode, xmlDecode, xmlEncodeAttr, validateXmlName } from "./modules/xml/encode.js";
 export { DateParser, DateFormatter, getSupportedFormats, type DateFormat } from "./utils/datetime.js";
 export { BaseError, type BaseErrorOptions, toError, errorToJSON, getErrorChain, getRootCause } from "./utils/errors.js";
 export { concatUint8Arrays, toUint8Array, stringToUint8Array, uint8ArrayToString } from "./utils/binary.js";

package/dist/browser/index.browser.js

@@ -5,6 +5,12 @@
 // =============================================================================
 // Main Classes (Browser-compatible)
 // =============================================================================
+// All imports point at the explicit `.browser` variants so the emitted
+// .d.ts files reflect the browser-only type surface — without this,
+// the types would leak Node-only methods (readFile / writeFile /
+// file-path streaming input) via `@excel/workbook` resolving to the
+// Node class that extends the browser base. Build-time rewriting
+// handles the JS bundle; only the types need this explicit mapping.
 export { Workbook } from "./modules/excel/workbook.browser.js";
 export { Worksheet } from "./modules/excel/worksheet.js";
 export { Row } from "./modules/excel/row.js";
@@ -45,17 +51,29 @@ export { CsvParserStream, CsvFormatterStream, createCsvParserStream, createCsvFo
 // Additional Classes & Types
 // =============================================================================
 export { DefinedNames } from "./modules/excel/defined-names.js";
+export { Chartsheet } from "./modules/excel/chartsheet.js";
 // =============================================================================
 // Utilities
 // =============================================================================
+// Cell display-text helpers (apply numFmt to produce an Excel-style string).
+// Cross-platform — no Node dependencies. Ships in both entry points so
+// browser users can access the same `Cell.displayText` behavior via
+// the standalone helper.
+export { getCellDisplayText, formatCellValue, isDateDisplayFormat } from "./modules/excel/utils/cell-format.js";
 // Cell address encoding/decoding (0-indexed)
 export { decodeCol, encodeCol, decodeRow, encodeRow, decodeCell, encodeCell, decodeRange, encodeRange } from "./modules/excel/utils/address.js";
+// Chart programmatic surface lives at the `./chart` subpath so it stays
+// out of bundles that only need to read / write XLSX files. Import
+// `@cj-tech-master/excelts/chart` to use chart APIs. Call
+// `installChartSupport()` once at startup to enable
+// `worksheet.addChart()`, chart-cache population during write, and
+// chart reconstruction during XLSX load.
 // Date conversion (Excel serial dates <-> JS Date)
 export { dateToExcel, excelToDate } from "./utils/utils.base.js";
 // Base64 utilities (cross-platform)
 export { base64ToUint8Array, uint8ArrayToBase64 } from "./utils/utils.base.js";
 // XML utilities
-export { xmlEncode, xmlDecode } from "./modules/xml/encode.js";
+export { xmlEncode, xmlDecode, xmlEncodeAttr, validateXmlName } from "./modules/xml/encode.js";
 // Date parsing/formatting (high-performance, zero-dep)
 export { DateParser, DateFormatter, getSupportedFormats } from "./utils/datetime.js";
 // Error infrastructure

package/dist/browser/index.d.ts

@@ -18,7 +18,7 @@ export * from "./modules/excel/enums.js";
 export * from "./modules/excel/types.js";
 export { createTextWatermarkImage } from "./modules/excel/utils/watermark-image.js";
 export type { TextWatermarkImageOptions } from "./modules/excel/utils/watermark-image.js";
-export type { PivotTable, PivotTableModel, PivotTableValue, PivotTableSource, CacheField, SharedItemValue, DataField, PivotTableSubtotal, RecordValue, ParsedCacheDefinition, ParsedCacheRecords } from "./modules/excel/pivot-table.js";
+export type { PivotTable, PivotTableModel, PivotTableValue, PivotTableSource, CacheField, SharedItemValue, DataField, PivotTableChartFormat, PivotTableSubtotal, RecordValue, ParsedCacheDefinition, ParsedCacheRecords } from "./modules/excel/pivot-table.js";
 export type { FormCheckboxModel, FormCheckboxOptions, FormControlRange, FormControlAnchor } from "./modules/excel/form-control.js";
 export type { WorkbookReaderOptions, ParseEvent, SharedStringEvent, WorksheetReadyEvent, HyperlinksEvent } from "./modules/excel/stream/workbook-reader.js";
 export type { WorksheetReaderOptions, WorksheetEvent, RowEvent, HyperlinkEvent, WorksheetHyperlink } from "./modules/excel/stream/worksheet-reader.js";
@@ -28,6 +28,8 @@ export { CsvParserStream, CsvFormatterStream, createCsvParserStream, createCsvFo
 export type { MarkdownOptions } from "./modules/markdown/types.js";
 export type { MarkdownAlignment, MarkdownParseResult, MarkdownParseOptions, MarkdownColumnConfig, MarkdownFormatOptions } from "./modules/markdown/types.js";
 export { DefinedNames, type DefinedNameModel } from "./modules/excel/defined-names.js";
+export { Chartsheet } from "./modules/excel/chartsheet.js";
+export type { AddChartsheetOptions, AddPivotChartsheetOptions, ChartsheetOptions, ChartsheetViewOptions } from "./modules/excel/chartsheet.js";
 export type { CheckboxState } from "./modules/excel/form-control.js";
 export type { ColumnDefn, ColumnHeaderValue } from "./modules/excel/column.js";
 export type { RangeInput } from "./modules/excel/range.js";
@@ -39,7 +41,7 @@ export type { SheetToJSONOptions, AddJSONOptions, AddAOAOptions } from "./module
 export { getCellDisplayText, formatCellValue, isDateDisplayFormat } from "./modules/excel/utils/cell-format.js";
 export { dateToExcel, excelToDate } from "./utils/utils.base.js";
 export { base64ToUint8Array, uint8ArrayToBase64 } from "./utils/utils.base.js";
-export { xmlEncode, xmlDecode } from "./modules/xml/encode.js";
+export { xmlEncode, xmlDecode, xmlEncodeAttr, validateXmlName } from "./modules/xml/encode.js";
 export { DateParser, DateFormatter, getSupportedFormats, type DateFormat } from "./utils/datetime.js";
 export { BaseError, type BaseErrorOptions, toError, errorToJSON, getErrorChain, getRootCause } from "./utils/errors.js";
 export { concatUint8Arrays, toUint8Array, stringToUint8Array, uint8ArrayToString } from "./utils/binary.js";

package/dist/browser/index.js

@@ -41,11 +41,19 @@ export { CsvParserStream, CsvFormatterStream, createCsvParserStream, createCsvFo
 // Additional Classes & Types
 // =============================================================================
 export { DefinedNames } from "./modules/excel/defined-names.js";
+export { Chartsheet } from "./modules/excel/chartsheet.js";
 // =============================================================================
 // Utilities
 // =============================================================================
 // Cell address encoding/decoding (0-indexed)
 export { decodeCol, encodeCol, decodeRow, encodeRow, decodeCell, encodeCell, decodeRange, encodeRange } from "./modules/excel/utils/address.js";
+// Chart programmatic surface (builders, renderers, presets, parsers,
+// install function) lives at the `./chart` subpath so it stays out of
+// bundles that only need to read / write XLSX files. Import
+// `@cj-tech-master/excelts/chart` to use chart APIs — and call
+// `installChartSupport()` once at startup to enable
+// `worksheet.addChart()`, chart-cache population during write, and
+// chart reconstruction during XLSX load.
 // Cell display-text helpers (apply numFmt to produce an Excel-style string)
 export { getCellDisplayText, formatCellValue, isDateDisplayFormat } from "./modules/excel/utils/cell-format.js";
 // Date conversion (Excel serial dates <-> JS Date)
@@ -53,7 +61,7 @@ export { dateToExcel, excelToDate } from "./utils/utils.base.js";
 // Base64 utilities (cross-platform)
 export { base64ToUint8Array, uint8ArrayToBase64 } from "./utils/utils.base.js";
 // XML utilities
-export { xmlEncode, xmlDecode } from "./modules/xml/encode.js";
+export { xmlEncode, xmlDecode, xmlEncodeAttr, validateXmlName } from "./modules/xml/encode.js";
 // Date parsing/formatting (high-performance, zero-dep)
 export { DateParser, DateFormatter, getSupportedFormats } from "./utils/datetime.js";
 // Error infrastructure

package/dist/browser/modules/excel/chart/cache-populator.d.ts

@@ -0,0 +1,49 @@
+import type { ChartExModel } from "./chart-ex-types.js";
+/**
+ * Chart cache populator.
+ *
+ * Walks a ChartModel, finds every `numRef`/`strRef` formula, resolves it against
+ * the actual worksheet cell values in the workbook, and populates the cache
+ * points so that headless consumers (PDF export, image preview, other readers
+ * that don't recalculate formulas) see non-empty charts.
+ *
+ * Excel itself recomputes caches on open, so this is a best-effort enrichment:
+ *   - empty/missing cells produce null values at the correct index
+ *   - formula-bearing cells use their cached result when available
+ *   - non-existent sheets or malformed formulas are skipped silently
+ */
+import type { ChartModel, NumberReference, StringReference, MultiLevelStringReference } from "./types.js";
+import type { Workbook } from "../workbook.js";
+import type { Worksheet } from "../worksheet.js";
+/**
+ * Populate all number/string caches in a ChartModel from the given workbook.
+ * Mutates the model in place. Safe to call multiple times (idempotent).
+ *
+ * @param model - The chart model to enrich
+ * @param workbook - The workbook used to resolve sheet/cell references
+ * @param contextWorksheet - Optional worksheet providing the default scope for
+ *   defined-name resolution. When a defined name has a sheet-scoped entry
+ *   matching this worksheet's workbook index (`localSheetId`), that entry
+ *   wins over the workbook-scoped entry. Supplying this argument is required
+ *   to correctly resolve sheet-scoped names; omitting it falls back to
+ *   workbook-scoped names only.
+ */
+export declare function fillChartCaches(model: ChartModel, workbook: Workbook, contextWorksheet?: Worksheet): void;
+export declare function fillChartExCaches(model: ChartExModel, workbook: Workbook, contextWorksheet?: Worksheet): void;
+/**
+ * Populate a NumberReference cache from the workbook.
+ * Only fills if `cache.points` is currently empty.
+ *
+ * @param contextWorksheet - Optional worksheet whose sheet-scoped defined
+ *   names take precedence over workbook-scoped ones.
+ */
+export declare function fillNumRef(ref: NumberReference, workbook: Workbook, date1904?: boolean, contextWorksheet?: Worksheet): void;
+/**
+ * Populate a StringReference cache from the workbook.
+ * Only fills if `cache.points` is currently empty.
+ *
+ * @param contextWorksheet - Optional worksheet whose sheet-scoped defined
+ *   names take precedence over workbook-scoped ones.
+ */
+export declare function fillStrRef(ref: StringReference, workbook: Workbook, contextWorksheet?: Worksheet): void;
+export declare function fillMultiLvlStrRef(ref: MultiLevelStringReference, workbook: Workbook, contextWorksheet?: Worksheet): void;