@cj-tech-master/excelts 1.4.4 → 1.4.5-canary.20251212064440.3eb099f

package/dist/types/doc/cell.d.ts

@@ -1,15 +1,57 @@
+import { Note } from "./note.js";
+import type { Row } from "./row.js";
+import type { Column } from "./column.js";
+import type { Worksheet } from "./worksheet.js";
+import type { Workbook } from "./workbook.js";
+import type { Style, NumFmt, Font, Alignment, Protection, Borders, Fill, CellRichTextValue, CellErrorValue, DataValidation, CellValue, CellHyperlinkValue } from "../types.js";
+export type HyperlinkValueData = CellHyperlinkValue;
+export type FormulaResult = string | number | boolean | Date | CellErrorValue;
+export interface FormulaValueData {
+    shareType?: string;
+    ref?: string;
+    formula?: string;
+    sharedFormula?: string;
+    result?: FormulaResult;
+    date1904?: boolean;
+}
 interface FullAddress {
     sheetName: string;
     address: string;
     row: number;
     col: number;
 }
-interface CellModel {
+export interface CellAddress {
+    address: string;
+    row: number;
+    col: number;
+    $col$row?: string;
+}
+export interface NoteText {
+    text: string;
+    font?: Record<string, unknown>;
+}
+export interface NoteConfig {
+    texts?: NoteText[];
+    margins?: {
+        insetmode?: string;
+        inset?: number[];
+    };
+    protection?: {
+        locked?: string;
+        lockText?: string;
+    };
+    editAs?: string;
+}
+export interface NoteModel {
+    type: string;
+    note: NoteConfig;
+}
+export interface CellModel {
     address: string;
     type: number;
-    value?: any;
-    style?: any;
-    comment?: any;
+    value?: number | string | boolean | Date | CellRichTextValue | CellErrorValue | HyperlinkValueData;
+    style?: Partial<Style>;
+    comment?: NoteModel;
     text?: string;
     hyperlink?: string;
     tooltip?: string;
@@ -18,38 +60,39 @@ interface CellModel {
     ref?: string;
     formula?: string;
     sharedFormula?: string;
-    result?: any;
-    richText?: any[];
-    sharedString?: any;
-    error?: any;
-    rawValue?: any;
+    result?: FormulaResult;
+    richText?: CellRichTextValue;
+    sharedString?: number;
+    error?: CellErrorValue;
+    rawValue?: unknown;
 }
+export type CellValueType = CellValue;
 declare class Cell {
     static Types: typeof import("./enums.js").ValueType;
-    _row: any;
-    _column: any;
-    _address: string;
-    _value: any;
-    style: any;
-    _mergeCount: number;
-    _comment?: any;
-    constructor(row: any, column: any, address: string);
-    get worksheet(): any;
-    get workbook(): any;
+    private _row;
+    private _column;
+    private _address;
+    private _value;
+    style: Partial<Style>;
+    private _mergeCount;
+    private _comment?;
+    constructor(row: Row, column: Column, address: string);
+    get worksheet(): Worksheet;
+    get workbook(): Workbook;
     destroy(): void;
-    get numFmt(): any;
-    set numFmt(value: any);
-    get font(): any;
-    set font(value: any);
-    get alignment(): any;
-    set alignment(value: any);
-    get border(): any;
-    set border(value: any);
-    get fill(): any;
-    set fill(value: any);
-    get protection(): any;
-    set protection(value: any);
-    _mergeStyle(rowStyle: any, colStyle: any, style: any): any;
+    get numFmt(): string | NumFmt | undefined;
+    set numFmt(value: string | undefined);
+    get font(): Partial<Font> | undefined;
+    set font(value: Partial<Font> | undefined);
+    get alignment(): Partial<Alignment> | undefined;
+    set alignment(value: Partial<Alignment> | undefined);
+    get border(): Partial<Borders> | undefined;
+    set border(value: Partial<Borders> | undefined);
+    get fill(): Fill | undefined;
+    set fill(value: Fill | undefined);
+    get protection(): Partial<Protection> | undefined;
+    set protection(value: Partial<Protection> | undefined);
+    private _mergeStyle;
     get address(): string;
     get row(): number;
     get col(): number;
@@ -66,16 +109,18 @@ declare class Cell {
     get master(): Cell;
     get isHyperlink(): boolean;
     get hyperlink(): string | undefined;
-    get value(): any;
-    set value(v: any);
-    get note(): string | undefined;
-    set note(note: string);
+    get value(): CellValueType;
+    set value(v: CellValueType);
+    get note(): string | NoteConfig | undefined;
+    set note(note: string | NoteConfig);
+    get comment(): Note | undefined;
+    set comment(comment: Note | NoteConfig | undefined);
     get text(): string;
     get html(): string;
     toString(): string;
     _upgradeToHyperlink(hyperlink: string): void;
     get formula(): string | undefined;
-    get result(): any;
+    get result(): FormulaResult | undefined;
     get formulaType(): number;
     get fullAddress(): FullAddress;
     get name(): string;
@@ -85,9 +130,9 @@ declare class Cell {
     addName(name: string): void;
     removeName(name: string): void;
     removeAllNames(): void;
-    get _dataValidations(): any;
-    get dataValidation(): any;
-    set dataValidation(value: any);
+    private get _dataValidations();
+    get dataValidation(): DataValidation | undefined;
+    set dataValidation(value: DataValidation);
     get model(): CellModel;
     set model(value: CellModel);
 }

package/dist/types/doc/column.d.ts

@@ -1,40 +1,43 @@
-interface ColumnDefn {
-    header?: any;
+import type { Cell, CellValueType } from "./cell.js";
+import type { Worksheet } from "./worksheet.js";
+import type { Style, NumFmt, Font, Alignment, Protection, Borders, Fill } from "../types.js";
+export interface ColumnDefn {
+    header?: string | string[];
     key?: string;
     width?: number;
     outlineLevel?: number;
     hidden?: boolean;
-    style?: any;
+    style?: Partial<Style>;
 }
-interface ColumnModel {
+export interface ColumnModel {
     min: number;
     max: number;
     width?: number;
-    style?: any;
+    style?: Partial<Style>;
     isCustomWidth?: boolean;
     hidden?: boolean;
     outlineLevel?: number;
     collapsed?: boolean;
 }
 declare class Column {
-    _worksheet: any;
-    _number: number;
-    _header: any;
-    _key: string | undefined;
+    private _worksheet;
+    private _number;
+    private _header;
+    private _key;
     width?: number;
-    _hidden: boolean | undefined;
-    _outlineLevel: number | undefined;
-    style: any;
-    constructor(worksheet: any, number: number, defn?: any);
+    private _hidden;
+    private _outlineLevel;
+    style: Partial<Style>;
+    constructor(worksheet: Worksheet, number: number, defn?: ColumnDefn | false);
     get number(): number;
-    get worksheet(): any;
+    get worksheet(): Worksheet;
     get letter(): string;
     get isCustomWidth(): boolean;
     get defn(): ColumnDefn;
     set defn(value: ColumnDefn | undefined);
-    get headers(): any[];
-    get header(): any;
-    set header(value: any);
+    get headers(): string[];
+    get header(): string | string[] | undefined;
+    set header(value: string | string[] | undefined);
     get key(): string | undefined;
     set key(value: string | undefined);
     get hidden(): boolean;
@@ -44,25 +47,27 @@ declare class Column {
     get collapsed(): boolean;
     toString(): string;
     equivalentTo(other: Column): boolean;
+    equivalentToModel(model: ColumnModel): boolean;
     get isDefault(): boolean;
     get headerCount(): number;
-    eachCell(options: any, iteratee?: any): void;
-    get values(): any[];
-    set values(v: any[]);
-    _applyStyle(name: string, value: any): any;
-    get numFmt(): any;
-    set numFmt(value: any);
-    get font(): any;
-    set font(value: any);
-    get alignment(): any;
-    set alignment(value: any);
-    get protection(): any;
-    set protection(value: any);
-    get border(): any;
-    set border(value: any);
-    get fill(): any;
-    set fill(value: any);
+    eachCell(options: {
+        includeEmpty?: boolean;
+    } | ((cell: Cell, rowNumber: number) => void), iteratee?: (cell: Cell, rowNumber: number) => void): void;
+    get values(): CellValueType[];
+    set values(v: CellValueType[]);
+    get numFmt(): string | NumFmt | undefined;
+    set numFmt(value: string | undefined);
+    get font(): Partial<Font> | undefined;
+    set font(value: Partial<Font> | undefined);
+    get alignment(): Partial<Alignment> | undefined;
+    set alignment(value: Partial<Alignment> | undefined);
+    get protection(): Partial<Protection> | undefined;
+    set protection(value: Partial<Protection> | undefined);
+    get border(): Partial<Borders> | undefined;
+    set border(value: Partial<Borders> | undefined);
+    get fill(): Fill | undefined;
+    set fill(value: Fill | undefined);
     static toModel(columns: Column[]): ColumnModel[] | undefined;
-    static fromModel(worksheet: any, cols: ColumnModel[]): Column[] | null;
+    static fromModel(worksheet: Worksheet, cols: ColumnModel[]): Column[] | null;
 }
 export { Column };

package/dist/types/doc/defined-names.d.ts

@@ -1,12 +1,15 @@
+import { type DecodedRange } from "../utils/col-cache.js";
 import { CellMatrix } from "../utils/cell-matrix.js";
 import { Range } from "./range.js";
-interface Cell {
+import type { Address } from "../types.js";
+interface DefinedNameCell {
     sheetName?: string;
     address: string;
     row: number;
     col: number;
     mark?: boolean;
 }
+type CellLocation = Address | DecodedRange;
 interface DefinedNameModel {
     name: string;
     ranges: string[];
@@ -16,14 +19,14 @@ declare class DefinedNames {
     constructor();
     getMatrix(name: string): CellMatrix;
     add(locStr: string, name: string): void;
-    addEx(location: any, name: string): void;
+    addEx(location: CellLocation, name: string): void;
     remove(locStr: string, name: string): void;
-    removeEx(location: any, name: string): void;
-    removeAllNames(location: any): void;
-    forEach(callback: (name: string, cell: Cell) => void): void;
+    removeEx(location: CellLocation, name: string): void;
+    removeAllNames(location: CellLocation): void;
+    forEach(callback: (name: string, cell: DefinedNameCell) => void): void;
     getNames(addressStr: string): string[];
-    getNamesEx(address: any): string[];
-    _explore(matrix: CellMatrix, cell: Cell): Range;
+    getNamesEx(address: Address): string[];
+    _explore(matrix: CellMatrix, cell: DefinedNameCell): Range;
     getRanges(name: string, matrix?: CellMatrix): DefinedNameModel;
     normaliseMatrix(matrix: CellMatrix, sheetName: string): void;
     spliceRows(sheetName: string, start: number, numDelete: number, numInsert: number): void;
@@ -31,4 +34,4 @@ declare class DefinedNames {
     get model(): DefinedNameModel[];
     set model(value: DefinedNameModel[]);
 }
-export { DefinedNames };
+export { DefinedNames, type DefinedNameModel };

package/dist/types/doc/image.d.ts

@@ -1,6 +1,8 @@
-import { Anchor } from "./anchor.js";
+import { Anchor, type AnchorModel } from "./anchor.js";
+import type { Worksheet } from "./worksheet.js";
 interface ImageHyperlinks {
-    [key: string]: any;
+    hyperlink?: string;
+    tooltip?: string;
 }
 interface ImageExt {
     width?: number;
@@ -17,31 +19,46 @@ interface BackgroundModel {
     type: "background";
     imageId: string;
 }
+interface ImageRangeModel {
+    tl: AnchorModel;
+    br?: AnchorModel;
+    ext?: ImageExt;
+    editAs?: string;
+}
 interface ImageModel {
     type: "image";
     imageId: string;
     hyperlinks?: ImageHyperlinks;
-    range: {
-        tl: any;
-        br?: any;
-        ext?: ImageExt;
-        editAs?: string;
-    };
+    range: ImageRangeModel;
 }
 type Model = BackgroundModel | ImageModel;
+type ImageModelInput = ModelInput;
+interface RangeInput {
+    tl?: AnchorModel | {
+        col: number;
+        row: number;
+    } | string;
+    br?: AnchorModel | {
+        col: number;
+        row: number;
+    } | string;
+    ext?: ImageExt;
+    editAs?: string;
+    hyperlinks?: ImageHyperlinks;
+}
 interface ModelInput {
     type: string;
     imageId: string;
-    range?: string | any;
+    range?: string | RangeInput | ImageRangeModel;
     hyperlinks?: ImageHyperlinks;
 }
 declare class Image {
-    worksheet: any;
+    worksheet: Worksheet;
     type?: string;
     imageId?: string;
     range?: ImageRange;
-    constructor(worksheet: any, model?: ModelInput);
+    constructor(worksheet: Worksheet, model?: ModelInput);
     get model(): Model;
     set model({ type, imageId, range, hyperlinks }: ModelInput);
 }
-export { Image };
+export { Image, type Model as ImageModel, type ImageModelInput };

package/dist/types/doc/pivot-table.d.ts

@@ -19,4 +19,4 @@ interface PivotTable {
     cacheId: string;
 }
 declare function makePivotTable(worksheet: any, model: PivotTableModel): PivotTable;
-export { makePivotTable };
+export { makePivotTable, type PivotTable, type PivotTableModel };

package/dist/types/doc/range.d.ts

@@ -1,3 +1,4 @@
+import type { Address } from "../types.js";
 interface RangeModel {
     top: number;
     left: number;
@@ -13,11 +14,21 @@ interface RowWithDimensions {
     number: number;
     dimensions?: RowDimensions;
 }
+export type RangeInput = Range | RangeModel | string | number | RangeInput[];
 declare class Range {
     model: RangeModel;
-    constructor(...args: any[]);
-    setTLBR(t: number | string, l?: number | string, b?: number | string, r?: number | string, s?: string): void;
-    decode(argv: any[]): void;
+    constructor();
+    constructor(range: Range);
+    constructor(model: RangeModel);
+    constructor(rangeString: string);
+    constructor(args: RangeInput[]);
+    constructor(tl: string, br: string);
+    constructor(tl: string, br: string, sheetName: string);
+    constructor(top: number, left: number, bottom: number, right: number);
+    constructor(top: number, left: number, bottom: number, right: number, sheetName: string);
+    setTLBR(tl: string, br: string, sheetName?: string): void;
+    setTLBR(top: number, left: number, bottom: number, right: number, sheetName?: string): void;
+    private decode;
     get top(): number;
     set top(value: number);
     get left(): number;
@@ -44,7 +55,7 @@ declare class Range {
     toString(): string;
     intersects(other: Range): boolean;
     contains(addressStr: string): boolean;
-    containsEx(address: any): boolean;
+    containsEx(address: Address): boolean;
     forEachAddress(cb: (address: string, row: number, col: number) => void): void;
 }
 export { Range };

package/dist/types/doc/row.d.ts

@@ -1,21 +1,17 @@
+import { Cell, type CellModel, type CellAddress } from "./cell.js";
 import type { Worksheet } from "./worksheet.js";
-interface CellAddress {
-    address: string;
-    row: number;
-    col: number;
-    $col$row?: string;
-}
+import type { Style, NumFmt, Font, Alignment, Protection, Borders, Fill, CellValue, RowValues } from "../types.js";
 interface RowDimensions {
     min: number;
     max: number;
 }
-interface RowModel {
-    cells: any[];
+export interface RowModel {
+    cells: CellModel[];
     number: number;
     min: number;
     max: number;
     height?: number;
-    style: any;
+    style: Partial<Style>;
     hidden: boolean;
     outlineLevel: number;
     collapsed: boolean;
@@ -24,46 +20,44 @@ interface EachCellOptions {
     includeEmpty?: boolean;
 }
 declare class Row {
-    _worksheet: Worksheet;
-    _number: number;
-    _cells: any[];
-    style: any;
-    _hidden?: boolean;
-    _outlineLevel?: number;
+    private _worksheet;
+    private _number;
+    private _cells;
+    style: Partial<Style>;
+    private _hidden?;
+    private _outlineLevel?;
     height?: number;
-    constructor(worksheet: any, number: number);
+    constructor(worksheet: Worksheet, number: number);
     get number(): number;
-    get worksheet(): any;
+    get worksheet(): Worksheet;
     commit(): void;
     destroy(): void;
-    findCell(colNumber: number): any;
-    getCellEx(address: CellAddress): any;
-    getCell(col: string | number): any;
-    splice(start: number, count: number, ...inserts: any[]): void;
-    eachCell(iteratee: (cell: any, colNumber: number) => void): void;
-    eachCell(options: EachCellOptions, iteratee: (cell: any, colNumber: number) => void): void;
+    findCell(colNumber: number): Cell | undefined;
+    getCellEx(address: CellAddress): Cell;
+    getCell(col: string | number): Cell;
+    splice(start: number, count: number, ...inserts: CellValue[]): void;
+    eachCell(iteratee: (cell: Cell, colNumber: number) => void): void;
+    eachCell(options: EachCellOptions, iteratee: (cell: Cell, colNumber: number) => void): void;
     addPageBreak(lft?: number, rght?: number): void;
-    get values(): any[];
-    set values(value: any[] | {
-        [key: string]: any;
-    });
+    get values(): CellValue[];
+    set values(value: RowValues);
     get hasValues(): boolean;
     get cellCount(): number;
     get actualCellCount(): number;
     get dimensions(): RowDimensions | null;
-    _applyStyle(name: string, value: any): any;
-    get numFmt(): any;
-    set numFmt(value: any);
-    get font(): any;
-    set font(value: any);
-    get alignment(): any;
-    set alignment(value: any);
-    get protection(): any;
-    set protection(value: any);
-    get border(): any;
-    set border(value: any);
-    get fill(): any;
-    set fill(value: any);
+    private _applyStyle;
+    get numFmt(): string | NumFmt | undefined;
+    set numFmt(value: string | undefined);
+    get font(): Partial<Font> | undefined;
+    set font(value: Partial<Font> | undefined);
+    get alignment(): Partial<Alignment> | undefined;
+    set alignment(value: Partial<Alignment> | undefined);
+    get protection(): Partial<Protection> | undefined;
+    set protection(value: Partial<Protection> | undefined);
+    get border(): Partial<Borders> | undefined;
+    set border(value: Partial<Borders> | undefined);
+    get fill(): Fill | undefined;
+    set fill(value: Fill | undefined);
     get hidden(): boolean;
     set hidden(value: boolean);
     get outlineLevel(): number;

package/dist/types/doc/table.d.ts

@@ -1,75 +1,60 @@
-interface ColumnModel {
-    name: string;
-    filterButton?: boolean;
-    style?: any;
-    totalsRowLabel?: string;
-    totalsRowFunction?: string;
-    totalsRowResult?: any;
-    totalsRowFormula?: string;
-}
-interface TableStyle {
-    theme?: string;
-    name?: string;
-    showFirstColumn?: boolean;
-    showLastColumn?: boolean;
-    showRowStripes?: boolean;
-    showColumnStripes?: boolean;
-}
+import type { Address, CellFormulaValue, CellValue, Style, TableColumnProperties, TableStyleProperties } from "../types.js";
+import type { Worksheet } from "./worksheet.js";
 interface TableModel {
     ref: string;
     name: string;
     displayName?: string;
-    columns: ColumnModel[];
-    rows: any[][];
+    columns: TableColumnProperties[];
+    rows: CellValue[][];
     headerRow?: boolean;
     totalsRow?: boolean;
-    style: TableStyle;
-    tl?: any;
+    style?: TableStyleProperties;
+    tl?: Address;
     autoFilterRef?: string;
     tableRef?: string;
 }
 declare class Column {
     table: Table;
-    column: ColumnModel;
+    column: TableColumnProperties;
     index: number;
-    constructor(table: Table, column: ColumnModel, index: number);
+    constructor(table: Table, column: TableColumnProperties, index: number);
     private _set;
     get name(): string;
     set name(value: string);
     get filterButton(): boolean | undefined;
     set filterButton(value: boolean | undefined);
-    get style(): any;
-    set style(value: any);
+    get style(): Partial<Style> | undefined;
+    set style(value: Partial<Style> | undefined);
     get totalsRowLabel(): string | undefined;
     set totalsRowLabel(value: string | undefined);
-    get totalsRowFunction(): string | undefined;
-    set totalsRowFunction(value: string | undefined);
-    get totalsRowResult(): any;
-    set totalsRowResult(value: any);
+    get totalsRowFunction(): TableColumnProperties["totalsRowFunction"];
+    set totalsRowFunction(value: TableColumnProperties["totalsRowFunction"]);
+    get totalsRowResult(): CellValue;
+    set totalsRowResult(value: CellFormulaValue["result"]);
     get totalsRowFormula(): string | undefined;
     set totalsRowFormula(value: string | undefined);
 }
 declare class Table {
-    worksheet: any;
+    worksheet: Worksheet;
     table: TableModel;
     private _cache?;
-    constructor(worksheet: any, table?: TableModel);
-    getFormula(column: ColumnModel): string | null;
+    constructor(worksheet: Worksheet, table?: TableModel);
+    getFormula(column: TableColumnProperties): string | null;
     get width(): number;
     get height(): number;
     get filterHeight(): number;
     get tableHeight(): number;
     validate(): void;
     store(): void;
-    load(worksheet: any): void;
+    load(worksheet: Worksheet): void;
     get model(): TableModel;
     set model(value: TableModel);
     cacheState(): void;
     commit(): void;
-    addRow(values: any[], rowNumber?: number): void;
+    addRow(values: CellValue[], rowNumber?: number): void;
     removeRows(rowIndex: number, count?: number): void;
     getColumn(colIndex: number): Column;
-    addColumn(column: ColumnModel, values: any[], colIndex?: number): void;
+    addColumn(column: TableColumnProperties, values: CellValue[], colIndex?: number): void;
     removeColumns(colIndex: number, count?: number): void;
     private _assign;
     get ref(): string;
@@ -93,4 +78,4 @@ declare class Table {
     get showColumnStripes(): boolean | undefined;
     set showColumnStripes(value: boolean | undefined);
 }
-export { Table };
+export { Table, type TableModel };