@nocobase/plugin-action-import 1.0.0-alpha.9 → 1.0.1-alpha.2

package/dist/node_modules/xlsx/types/index.d.ts

@@ -1,16 +1,23 @@
 /* index.d.ts (C) 2015-present SheetJS and contributors */
 // TypeScript Version: 2.2
-import * as CFB from "cfb";
-import * as SSF from "ssf";
+// import * as CFB from "cfb";
+// import * as SSF from "ssf";
 
 /** Version string */
 export const version: string;
 
 /** SSF Formatter Library */
-export { SSF };
+// export { SSF };
+export const SSF: any;
 
 /** CFB Library */
-export { CFB };
+// export { CFB };
+export const CFB: any;
+
+/** Set internal `fs` instance */
+export function set_fs(fs: any): void;
+/** Set internal codepage tables */
+export function set_cptable(cptable: any): void;
 
 /** NODE ONLY! Attempts to read filename and parse */
 export function readFile(filename: string, opts?: ParsingOptions): WorkBook;
@@ -18,11 +25,15 @@ export function readFile(filename: string, opts?: ParsingOptions): WorkBook;
 export function read(data: any, opts?: ParsingOptions): WorkBook;
 /** Attempts to write or download workbook data to file */
 export function writeFile(data: WorkBook, filename: string, opts?: WritingOptions): any;
+/** Attempts to write or download workbook data to XLSX file */
+export function writeFileXLSX(data: WorkBook, filename: string, opts?: WritingOptions): any;
 /** Attempts to write or download workbook data to file asynchronously */
 type CBFunc = () => void;
 export function writeFileAsync(filename: string, data: WorkBook, opts: WritingOptions | CBFunc, cb?: CBFunc): any;
 /** Attempts to write the workbook data */
-export function write(data: WorkBook, opts?: WritingOptions): any;
+export function write(data: WorkBook, opts: WritingOptions): any;
+/** Attempts to write the workbook data as XLSX */
+export function writeXLSX(data: WorkBook, opts: WritingOptions): any;
 
 /** Utility Functions */
 export const utils: XLSX$Utils;
@@ -128,12 +139,37 @@ export interface DateNFOption {
     dateNF?: NumberFormat;
 }
 
+export interface UTCOption {
+    /**
+     * For plaintext formats, interpret ambiguous datetimes in UTC
+     * If explicitly set to `false`, dates will be parsed in local time.
+     *
+     * The `true` option is consistent with spreadsheet application export.
+     *
+     * @default true
+     */
+    UTC?: boolean;
+}
+
+export interface DenseOption {
+    /** If true, generate dense-mode worksheets */
+    dense?: boolean;
+}
+
 /** Options for read and readFile */
-export interface ParsingOptions extends CommonOptions {
+export interface ParsingOptions extends UTCOption, CommonOptions, DenseOption {
     /** Input data encoding */
     type?: 'base64' | 'binary' | 'buffer' | 'file' | 'array' | 'string';
 
-    /** Default codepage */
+    /**
+     * Default codepage for legacy files
+     *
+     * This requires encoding support to be loaded.  It is automatically loaded
+     * in `xlsx.full.min.js` and in CommonJS / Extendscript, but an extra step
+     * is required in React / Angular / Webpack ESM deployments.
+     *
+     * Check the relevant guide https://docs.sheetjs.com/docs/getting-started/
+     */
     codepage?: number;
 
     /**
@@ -202,9 +238,22 @@ export interface ParsingOptions extends CommonOptions {
     /** If true, plaintext parsing will not parse values */
     raw?: boolean;
 
-    dense?: boolean;
+    /** If true, ignore "dimensions" records and guess range using every cell */
+    nodim?: boolean;
+
+    /** If true, preserve _xlfn. prefixes in formula function names */
+    xlfn?: boolean;
+
+    /**
+     * For single-sheet formats (including CSV), override the worksheet name
+     * @default "Sheet1"
+     */
+    sheet?: string;
+
+    PRN?: boolean;
 }
 
+
 /** Options for write and writeFile */
 export interface WritingOptions extends CommonOptions {
     /** Output data encoding */
@@ -222,18 +271,15 @@ export interface WritingOptions extends CommonOptions {
      */
     bookType?: BookType;
 
-    /**
-     * Name of Worksheet (for single-sheet formats)
-     * @default ''
-     */
-    sheet?: string;
-
     /**
      * Use ZIP compression for ZIP-based formats
      * @default false
      */
     compression?: boolean;
 
+    /** Overwride theme XML when exporting to XLSX/XLSM/XLSB */
+    themeXLSX?: string;
+
     /**
      * Suppress "number stored as text" errors in generated files
      * @default true
@@ -242,6 +288,35 @@ export interface WritingOptions extends CommonOptions {
 
     /** Override workbook properties on save */
     Props?: Properties;
+
+    /**
+     * Desired codepage for legacy file formats
+     *
+     * This requires encoding support to be loaded.  It is automatically loaded
+     * in `xlsx.full.min.js` and in CommonJS / Extendscript, but an extra step
+     * is required in React / Angular / Webpack / ESM deployments.
+     *
+     * Check the relevant guide https://docs.sheetjs.com/docs/getting-started/
+     */
+    codepage?: number;
+
+    /** Base64 encoding of NUMBERS base for exports */
+    numbers?: string;
+
+    /**
+     * For single-sheet formats, export the specified worksheet.
+     *
+     * The property must be a string (sheet name) or number (`SheetNames` index).
+     *
+     * If this option is omitted, the first worksheet will be exported.
+     */
+    sheet?: string | number;
+
+    /** Field Separator ("delimiter") for CSV / Text output */
+    FS?: string;
+
+    /** Record Separator ("row separator") for CSV / Text output */
+    RS?: string;
 }
 
 /** Workbook Object */
@@ -259,11 +334,14 @@ export interface WorkBook {
     Props?: FullProperties;
 
     /** Custom workbook Properties */
-    Custprops?: any;
+    Custprops?: object;
 
     Workbook?: WBProps;
 
     vbaraw?: any;
+
+    /** Original file type (when parsed with `read` or `readFile`) */
+    bookType?: BookType;
 }
 
 export interface SheetProps {
@@ -325,6 +403,21 @@ export interface WorkbookProperties {
     CodeName?: string;
 }
 
+/** DBF Field Header */
+export interface DBFField {
+    /** Original Field Name */
+    name?: string;
+
+    /** Field Type */
+    type?: string;
+
+    /** Field Length */
+    len?: number;
+
+    /** Field Decimal Count */
+    dec?: number;
+}
+
 /** Column Properties Object */
 export interface ColInfo {
     /* --- visibility --- */
@@ -348,6 +441,9 @@ export interface ColInfo {
 
     /** Excel's "Max Digit Width" unit, always integral */
     MDW?: number;
+
+    /** DBF Field Header */
+    DBF?: DBFField;
 }
 
 /** Row Properties Object */
@@ -475,20 +571,52 @@ export type SheetKeys = string | MarginInfo | SheetType;
 /** General object representing a Sheet (worksheet or chartsheet) */
 export interface Sheet {
     /**
-     * Indexing with a cell address string maps to a cell object
+     * Sparse-mode store cells with keys corresponding to A1-style address
+     * Dense-mode  store cells in the '!data' key
      * Special keys start with '!'
      */
-    [cell: string]: CellObject | SheetKeys | any;
+    [cell: string]: CellObject | CellObject[][] | SheetKeys | any;
+
+    /**
+     * Dense-mode worksheets store data in an array of arrays
+     *
+     * Cells are accessed with sheet['!data'][R][C] (where R and C are 0-indexed)
+     */
+    '!data'?: CellObject[][];
 
     /** Sheet type */
     '!type'?: SheetType;
 
-    /** Sheet Range */
+    /** Sheet Range (A1-style) */
     '!ref'?: string;
 
     /** Page Margins */
     '!margins'?: MarginInfo;
 }
+/** General object representing a dense Sheet (worksheet or chartsheet) */
+export interface DenseSheet extends Sheet {
+    /**
+     * Special keys start with '!'
+     * Dense-mode worksheets store data in the '!data' key
+     */
+    [cell: string]: CellObject[][] | SheetKeys | any;
+
+    /**
+     * Dense-mode worksheets store data in an array of arrays
+     *
+     * Cells are accessed with sheet['!data'][R][C] (where R and C are 0-indexed)
+     */
+    '!data': CellObject[][];
+}
+/** General object representing a sparse Sheet (worksheet or chartsheet) */
+export interface SparseSheet extends Sheet {
+    /**
+     * Sparse-mode store cells with keys corresponding to A1-style address
+     * Cells are accessed with sheet[addr]
+     */
+    '!data': never;
+}
+
 
 /** AutoFilter properties */
 export interface AutoFilterInfo {
@@ -521,6 +649,15 @@ export interface WorkSheet extends Sheet {
     /** AutoFilter info */
     '!autofilter'?: AutoFilterInfo;
 }
+/** Dense Worksheet Object */
+export interface DenseWorkSheet extends DenseSheet {
+    /**
+     * Dense-mode worksheets store data in an array of arrays
+     *
+     * Cells are accessed with sheet['!data'][R][C] (where R and C are 0-indexed)
+     */
+    '!data': CellObject[][];
+}
 
 /**
  * Worksheet Object with CellObject type
@@ -539,7 +676,7 @@ export type ExcelDataType = 'b' | 'n' | 'e' | 's' | 'd' | 'z';
  * Type of generated workbook
  * @default 'xlsx'
  */
-export type BookType = 'xlsx' | 'xlsm' | 'xlsb' | 'xls' | 'xla' | 'biff8' | 'biff5' | 'biff2' | 'xlml' | 'ods' | 'fods' | 'csv' | 'txt' | 'sylk' | 'html' | 'dif' | 'rtf' | 'prn' | 'eth';
+export type BookType = 'xlsx' | 'xlsm' | 'xlsb' | 'xls' | 'xla' | 'biff8' | 'biff5' | 'biff2' | 'xlml' | 'ods' | 'fods' | 'csv' | 'txt' | 'sylk' | 'slk' | 'html' | 'dif' | 'rtf' | 'prn' | 'eth' | 'dbf' | 'numbers';
 
 /** Comment element */
 export interface Comment {
@@ -548,6 +685,9 @@ export interface Comment {
 
     /** Plaintext of the comment */
     t: string;
+
+    /** If true, mark the comment as a part of a thread */
+    T?: boolean;
 }
 
 /** Cell comments */
@@ -585,6 +725,9 @@ export interface CellObject {
     /** Range of enclosing array if formula is array formula (if applicable) */
     F?: string;
 
+    /** If true, cell is a dynamic array formula (for supported file formats) */
+    D?: boolean;
+
     /** Rich text encoding (if applicable) */
     r?: any;
 
@@ -678,11 +821,32 @@ export interface Sheet2JSONOpts extends DateNFOption {
     /** if true, return raw data; if false, return formatted text */
     raw?: boolean;
 
+    /** if true, skip hidden rows and columns */
+    skipHidden?: boolean;
+
     /** if true, return raw numbers; if false, return formatted numbers */
     rawNumbers?: boolean;
+
+    /**
+     * If true, return dates whose UTC interpretation is correct
+     * By default, return dates whose local interpretation is correct
+     *
+     * @default false
+     */
+    UTC?: boolean;
+}
+
+export interface UTCDateOption {
+    /**
+     * If true, dates are interpreted using the UTC methods
+     * By default, dates are interpreted in the local timezone
+     *
+     * @default false
+     */
+    UTC?: boolean;
 }
 
-export interface AOA2SheetOpts extends CommonOptions, DateNFOption {
+export interface AOA2SheetOpts extends CommonOptions, UTCDateOption, DateNFOption, DenseOption {
     /**
      * Create cell objects for stub cells
      * @default false
@@ -692,7 +856,7 @@ export interface AOA2SheetOpts extends CommonOptions, DateNFOption {
 
 export interface SheetAOAOpts extends AOA2SheetOpts, OriginOption {}
 
-export interface JSON2SheetOpts extends CommonOptions, DateNFOption {
+export interface JSON2SheetOpts extends CommonOptions, UTCDateOption, DateNFOption, OriginOption, DenseOption {
     /** Use specified column order */
     header?: string[];
 
@@ -700,8 +864,6 @@ export interface JSON2SheetOpts extends CommonOptions, DateNFOption {
     skipHeader?: boolean;
 }
 
-export interface SheetJSONOpts extends JSON2SheetOpts, OriginOption {}
-
 export interface Table2SheetOpts extends CommonOptions, DateNFOption, OriginOption {
     /** If true, plaintext parsing will not parse values */
     raw?: boolean;
@@ -714,6 +876,28 @@ export interface Table2SheetOpts extends CommonOptions, DateNFOption, OriginOpti
 
     /** If true, hidden rows and cells will not be parsed */
     display?: boolean;
+
+    /**
+     * Override the worksheet name
+     * @default "Sheet1"
+     */
+    sheet?: string;
+
+    /**
+     * If true, interpret date strings as if they are UTC.
+     * By default, date strings are interpreted in the local timezone.
+     *
+     * @default false
+     */
+    UTC?: boolean;
+}
+
+export interface Table2BookOpts extends Table2SheetOpts {
+    /**
+     * Override the worksheet name
+     * @default "Sheet1"
+     */
+     sheet?: string;
 }
 
 /** General utilities */
@@ -730,7 +914,7 @@ export interface XLSX$Utils {
 
     /** BROWSER ONLY! Converts a TABLE DOM element to a worksheet. */
     table_to_sheet(data: any,  opts?: Table2SheetOpts): WorkSheet;
-    table_to_book(data: any,  opts?: Table2SheetOpts): WorkBook;
+    table_to_book(data: any,  opts?: Table2BookOpts): WorkBook;
     sheet_add_dom(ws: WorkSheet, data: any, opts?: Table2SheetOpts): WorkSheet;
 
     /* --- Export Functions --- */
@@ -752,15 +936,6 @@ export interface XLSX$Utils {
     /** Generates a list of the formulae (with value fallbacks) */
     sheet_to_formulae(worksheet: WorkSheet): string[];
 
-    /** Generates DIF */
-    sheet_to_dif(worksheet: WorkSheet, options?: Sheet2HTMLOpts): string;
-
-    /** Generates SYLK (Symbolic Link) */
-    sheet_to_slk(worksheet: WorkSheet, options?: Sheet2HTMLOpts): string;
-
-    /** Generates ETH */
-    sheet_to_eth(worksheet: WorkSheet, options?: Sheet2HTMLOpts): string;
-
     /* --- Cell Address Utilities --- */
 
     /** Converts 0-indexed cell address to A1 form */
@@ -793,11 +968,14 @@ export interface XLSX$Utils {
 
     /* --- General Utilities --- */
 
-    /** Creates a new workbook */
-    book_new(): WorkBook;
+    /** Create a new workbook */
+    book_new(ws?: WorkSheet, wsname?: string): WorkBook;
+
+    /** Create a new worksheet */
+    sheet_new(opts?: DenseOption): WorkSheet;
 
-    /** Append a worksheet to a workbook */
-    book_append_sheet(workbook: WorkBook, worksheet: WorkSheet, name?: string): void;
+    /** Append a worksheet to a workbook, returns new worksheet name */
+    book_append_sheet(workbook: WorkBook, worksheet: WorkSheet, name?: string, roll?: boolean): string;
 
     /** Set sheet visibility (visible/hidden/very hidden) */
     book_set_sheet_visibility(workbook: WorkBook, sheet: number|string, visibility: number): void;
@@ -815,15 +993,15 @@ export interface XLSX$Utils {
     cell_add_comment(cell: CellObject, text: string, author?: string): void;
 
     /** Assign an Array Formula to a range */
-    sheet_set_array_formula(ws: WorkSheet, range: Range|string, formula: string): WorkSheet;
+    sheet_set_array_formula(ws: WorkSheet, range: Range|string, formula: string, dynamic?: boolean): WorkSheet;
 
     /** Add an array of arrays of JS data to a worksheet */
     sheet_add_aoa<T>(ws: WorkSheet, data: T[][], opts?: SheetAOAOpts): WorkSheet;
     sheet_add_aoa(ws: WorkSheet, data: any[][], opts?: SheetAOAOpts): WorkSheet;
 
     /** Add an array of JS objects to a worksheet */
-    sheet_add_json(ws: WorkSheet, data: any[], opts?: SheetJSONOpts): WorkSheet;
-    sheet_add_json<T>(ws: WorkSheet, data: T[], opts?: SheetJSONOpts): WorkSheet;
+    sheet_add_json(ws: WorkSheet, data: any[], opts?: JSON2SheetOpts): WorkSheet;
+    sheet_add_json<T>(ws: WorkSheet, data: T[], opts?: JSON2SheetOpts): WorkSheet;
 
 
     consts: XLSX$Consts;
@@ -850,4 +1028,6 @@ export interface StreamUtils {
     to_html(sheet: WorkSheet, opts?: Sheet2HTMLOpts): any;
     /** JSON object stream, generate one row at a time */
     to_json(sheet: WorkSheet, opts?: Sheet2JSONOpts): any;
+    /** Set `Readable` (internal) */
+    set_readable(Readable: any): void;
 }