@ai-matrx/alchemy 0.20.6 → 0.22.2

package/dist/operate-xlsx.d.ts

@@ -1,1144 +1,5 @@
 import { Payload } from '@ai-matrx/kit/transfer-json';
-
-/* index.d.ts (C) 2015-present SheetJS and contributors */
-// TypeScript Version: 2.2
-// import * as CFB from "cfb";
-// import * as SSF from "ssf";
-
-/** Version string */
-declare const version: string;
-
-/** SSF Formatter Library */
-// export { SSF };
-declare const SSF: any;
-
-/** CFB Library */
-// export { CFB };
-declare const CFB: any;
-
-/** Set internal `fs` instance */
-declare function set_fs(fs: any): void;
-/** Set internal codepage tables */
-declare function set_cptable(cptable: any): void;
-
-/** NODE ONLY! Attempts to read filename and parse */
-declare function readFile(filename: string, opts?: ParsingOptions): WorkBook;
-/** Attempts to parse data */
-declare function read(data: any, opts?: ParsingOptions): WorkBook;
-/** Attempts to write or download workbook data to file */
-declare function writeFile(data: WorkBook, filename: string, opts?: WritingOptions): void;
-/** Attempts to write or download workbook data to XLSX file */
-declare function writeFileXLSX(data: WorkBook, filename: string, opts?: WritingOptions): void;
-/** Attempts to write or download workbook data to file asynchronously */
-type CBFunc = () => void;
-declare function writeFileAsync(filename: string, data: WorkBook, opts: WritingOptions | CBFunc, cb?: CBFunc): void;
-/** Attempts to write the workbook data */
-declare function write(data: WorkBook, opts: WritingOptions): any;
-/** Attempts to write the workbook data as XLSX */
-declare function writeXLSX(data: WorkBook, opts: WritingOptions): any;
-
-/** Utility Functions */
-declare const utils: XLSX$Utils;
-/** Stream Utility Functions */
-declare const stream: StreamUtils;
-
-/** Number Format (either a string or an index to the format table) */
-type NumberFormat = string | number;
-
-/** Worksheet specifier (string, number, worksheet) */
-type WSSpec = string | number | WorkSheet;
-
-/** Range specifier (string or range or cell), single-cell lifted to range */
-type RangeSpec = string | Range | CellAddress;
-
-/** Basic File Properties */
-interface Properties {
-    /** Summary tab "Title" */
-    Title?: string;
-    /** Summary tab "Subject" */
-    Subject?: string;
-    /** Summary tab "Author" */
-    Author?: string;
-    /** Summary tab "Manager" */
-    Manager?: string;
-    /** Summary tab "Company" */
-    Company?: string;
-    /** Summary tab "Category" */
-    Category?: string;
-    /** Summary tab "Keywords" */
-    Keywords?: string;
-    /** Summary tab "Comments" */
-    Comments?: string;
-    /** Statistics tab "Last saved by" */
-    LastAuthor?: string;
-    /** Statistics tab "Created" */
-    CreatedDate?: Date;
-}
-
-/** Other supported properties */
-interface FullProperties extends Properties {
-    ModifiedDate?: Date;
-    Application?: string;
-    AppVersion?: string;
-    DocSecurity?: string;
-    HyperlinksChanged?: boolean;
-    SharedDoc?: boolean;
-    LinksUpToDate?: boolean;
-    ScaleCrop?: boolean;
-    Worksheets?: number;
-    SheetNames?: string[];
-    ContentStatus?: string;
-    LastPrinted?: string;
-    Revision?: string | number;
-    Version?: string;
-    Identifier?: string;
-    Language?: string;
-}
-
-interface CommonOptions {
-    /**
-     * If true, throw errors when features are not understood
-     * @default false
-     */
-    WTF?: boolean;
-
-    /**
-     * When reading a file with VBA macros, expose CFB blob to `vbaraw` field
-     * When writing BIFF8/XLSB/XLSM, reseat `vbaraw` and export to file
-     * @default false
-     */
-    bookVBA?: boolean;
-
-    /**
-     * When reading a file, store dates as type d (default is n)
-     * When writing XLSX/XLSM file, use native date (default uses date codes)
-     * @default false
-     */
-    cellDates?: boolean;
-
-    /**
-     * Create cell objects for stub cells
-     * @default false
-     */
-    sheetStubs?: boolean;
-
-    /**
-     * When reading a file, save style/theme info to the .s field
-     * When writing a file, export style/theme info
-     * @default false
-     */
-    cellStyles?: boolean;
-
-    /**
-     * If defined and file is encrypted, use password
-     * @default ''
-     */
-    password?: string;
-}
-
-interface DateNFOption {
-    /** Use specified date format */
-    dateNF?: NumberFormat;
-}
-
-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;
-}
-
-interface DenseOption {
-    /** If true, generate dense-mode worksheets */
-    dense?: boolean;
-}
-
-/** Options for read and readFile */
-interface ParsingOptions extends UTCOption, CommonOptions, DenseOption {
-    /** Input data encoding */
-    type?: 'base64' | 'binary' | 'buffer' | 'file' | 'array' | 'string';
-
-    /**
-     * 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;
-
-    /**
-     * Save formulae to the .f field
-     * @default true
-     */
-    cellFormula?: boolean;
-
-    /**
-     * Parse rich text and save HTML to the .h field
-     * @default true
-     */
-    cellHTML?: boolean;
-
-    /**
-     * Save number format string to the .z field
-     * @default false
-     */
-    cellNF?: boolean;
-
-    /**
-     * Generate formatted text to the .w field
-     * @default true
-     */
-    cellText?: boolean;
-
-    /** Override default date format (code 14) */
-    dateNF?: string;
-
-    /** Field Separator ("Delimiter" override) */
-    FS?: string;
-
-    /**
-     * If >0, read the first sheetRows rows
-     * @default 0
-     */
-    sheetRows?: number;
-
-    /**
-     * If true, parse calculation chains
-     * @default false
-     */
-    bookDeps?: boolean;
-
-    /**
-     * If true, add raw files to book object
-     * @default false
-     */
-    bookFiles?: boolean;
-
-    /**
-     * If true, only parse enough to get book metadata
-     * @default false
-     */
-    bookProps?: boolean;
-
-    /**
-     * If true, only parse enough to get the sheet names
-     * @default false
-     */
-    bookSheets?: boolean;
-
-    /** If specified, only parse the specified sheets or sheet names */
-    sheets?: number | string | Array<number | string>;
-
-    /** If true, plaintext parsing will not parse values */
-    raw?: 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 */
-interface WritingOptions extends CommonOptions {
-    /** Output data encoding */
-    type?: 'base64' | 'binary' | 'buffer' | 'file' | 'array' | 'string';
-
-    /**
-     * Generate Shared String Table
-     * @default false
-     */
-    bookSST?: boolean;
-
-    /**
-     * File format of generated workbook
-     * @default 'xlsx'
-     */
-    bookType?: BookType;
-
-    /**
-     * Use ZIP compression for ZIP-based formats
-     * @default false
-     */
-    compression?: boolean;
-
-    /** Override theme XML when exporting to XLSX/XLSM/XLSB */
-    themeXLSX?: string;
-
-    /**
-     * Suppress "number stored as text" errors in generated files
-     * @default true
-     */
-    ignoreEC?: boolean;
-
-    /** 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 */
-interface WorkBook {
-    /**
-     * A dictionary of the worksheets in the workbook.
-     * Use SheetNames to reference these.
-     */
-    Sheets: { [sheet: string]: WorkSheet };
-
-    /** Ordered list of the sheet names in the workbook */
-    SheetNames: string[];
-
-    /** Standard workbook Properties */
-    Props?: FullProperties;
-
-    /** Custom workbook Properties */
-    Custprops?: object;
-
-    Workbook?: WBProps;
-
-    vbaraw?: any;
-
-    /** Original file type (when parsed with `read` or `readFile`) */
-    bookType?: BookType;
-}
-
-interface SheetProps {
-    /** Name of Sheet */
-    name?: string;
-
-    /** Sheet Visibility (0=Visible 1=Hidden 2=VeryHidden) */
-    Hidden?: 0 | 1 | 2;
-
-    /** Name of Document Module in associated VBA Project */
-    CodeName?: string;
-}
-
-/** Defined Name Object */
-interface DefinedName {
-    /** Name */
-    Name: string;
-
-    /** Reference */
-    Ref: string;
-
-    /** Scope (undefined for workbook scope) */
-    Sheet?: number;
-
-    /** Name comment */
-    Comment?: string;
-}
-
-/** Workbook-Level Attributes */
-interface WBProps {
-    /** Sheet Properties */
-    Sheets?: SheetProps[];
-
-    /** Defined Names */
-    Names?: DefinedName[];
-
-    /** Workbook Views */
-    Views?: WBView[];
-
-    /** Other Workbook Properties */
-    WBProps?: WorkbookProperties;
-}
-
-/** Workbook View */
-interface WBView {
-    /** Right-to-left mode */
-    RTL?: boolean;
-}
-
-/** Other Workbook Properties */
-interface WorkbookProperties {
-    /** Worksheet Epoch (1904 if true, 1900 if false) */
-    date1904?: boolean;
-
-    /** Warn or strip personally identifying info on save */
-    filterPrivacy?: boolean;
-
-    /** Name of Document Module in associated VBA Project */
-    CodeName?: string;
-}
-
-/** DBF Field Header */
-interface DBFField {
-    /** Original Field Name */
-    name?: string;
-
-    /** Field Type */
-    type?: string;
-
-    /** Field Length */
-    len?: number;
-
-    /** Field Decimal Count */
-    dec?: number;
-}
-
-/** Column Properties Object */
-interface ColInfo {
-    /* --- visibility --- */
-
-    /** if true, the column is hidden */
-    hidden?: boolean;
-
-    /* --- column width --- */
-
-    /** width in Excel's "Max Digit Width", width*256 is integral */
-    width?: number;
-
-    /** width in screen pixels */
-    wpx?: number;
-
-    /** width in "characters" */
-    wch?: number;
-
-    /** outline / group level */
-    level?: number;
-
-    /** Excel's "Max Digit Width" unit, always integral */
-    MDW?: number;
-
-    /** DBF Field Header */
-    DBF?: DBFField;
-}
-
-/** Row Properties Object */
-interface RowInfo {
-    /* --- visibility --- */
-
-    /** if true, the column is hidden */
-    hidden?: boolean;
-
-    /* --- row height --- */
-
-    /** height in screen pixels */
-    hpx?: number;
-
-    /** height in points */
-    hpt?: number;
-
-    /** outline / group level */
-    level?: number;
-}
-
-/**
- * Write sheet protection properties.
- */
-interface ProtectInfo {
-    /**
-     * The password for formats that support password-protected sheets
-     * (XLSX/XLSB/XLS). The writer uses the XOR obfuscation method.
-     */
-    password?: string;
-    /**
-     * Select locked cells
-     * @default: true
-     */
-    selectLockedCells?: boolean;
-    /**
-     * Select unlocked cells
-     * @default: true
-     */
-    selectUnlockedCells?: boolean;
-    /**
-     * Format cells
-     * @default: false
-     */
-    formatCells?: boolean;
-    /**
-     * Format columns
-     * @default: false
-     */
-    formatColumns?: boolean;
-    /**
-     * Format rows
-     * @default: false
-     */
-    formatRows?: boolean;
-    /**
-     * Insert columns
-     * @default: false
-     */
-    insertColumns?: boolean;
-    /**
-     * Insert rows
-     * @default: false
-     */
-    insertRows?: boolean;
-    /**
-     * Insert hyperlinks
-     * @default: false
-     */
-    insertHyperlinks?: boolean;
-    /**
-     * Delete columns
-     * @default: false
-     */
-    deleteColumns?: boolean;
-    /**
-     * Delete rows
-     * @default: false
-     */
-    deleteRows?: boolean;
-    /**
-     * Sort
-     * @default: false
-     */
-    sort?: boolean;
-    /**
-     * Filter
-     * @default: false
-     */
-    autoFilter?: boolean;
-    /**
-     * Use PivotTable reports
-     * @default: false
-     */
-    pivotTables?: boolean;
-    /**
-     * Edit objects
-     * @default: true
-     */
-    objects?: boolean;
-    /**
-     * Edit scenarios
-     * @default: true
-     */
-    scenarios?: boolean;
-}
-
-/** Page Margins -- see Excel Page Setup .. Margins diagram for explanation */
-interface MarginInfo {
-    /** Left side margin (inches) */
-    left?: number;
-    /** Right side margin (inches) */
-    right?: number;
-    /** Top side margin (inches) */
-    top?: number;
-    /** Bottom side margin (inches) */
-    bottom?: number;
-    /** Header top margin (inches) */
-    header?: number;
-    /** Footer bottom height (inches) */
-    footer?: number;
-}
-type SheetType = 'sheet' | 'chart';
-type SheetKeys = string | MarginInfo | SheetType;
-/** General object representing a Sheet (worksheet or chartsheet) */
-interface Sheet {
-    /**
-     * 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 | 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 (A1-style) */
-    '!ref'?: string;
-
-    /** Page Margins */
-    '!margins'?: MarginInfo;
-}
-/** General object representing a dense Sheet (worksheet or chartsheet) */
-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) */
-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 */
-interface AutoFilterInfo {
-    /** Range of the AutoFilter table */
-    ref: string;
-}
-
-type WSKeys = SheetKeys | ColInfo[] | RowInfo[] | Range[] | ProtectInfo | AutoFilterInfo;
-
-/** Worksheet Object */
-interface WorkSheet extends Sheet {
-    /**
-     * Indexing with a cell address string maps to a cell object
-     * Special keys start with '!'
-     */
-    [cell: string]: CellObject | WSKeys | any;
-
-    /** Column Info */
-    '!cols'?: ColInfo[];
-
-    /** Row Info */
-    '!rows'?: RowInfo[];
-
-    /** Merge Ranges */
-    '!merges'?: Range[];
-
-    /** Worksheet Protection info */
-    '!protect'?: ProtectInfo;
-
-    /** AutoFilter info */
-    '!autofilter'?: AutoFilterInfo;
-}
-/** Dense Worksheet Object */
-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
- *
- * The normal Worksheet type uses indexer of type `any` -- this enforces CellObject
- */
-interface StrictWS { [addr: string]: CellObject; }
-
-/**
- * The Excel data type for a cell.
- * b Boolean, n Number, e error, s String, d Date, z Stub
- */
-type ExcelDataType = 'b' | 'n' | 'e' | 's' | 'd' | 'z';
-
-/**
- * Type of generated workbook
- * @default 'xlsx'
- */
-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 */
-interface Comment {
-    /** Author of the comment block */
-    a?: string;
-
-    /** Plaintext of the comment */
-    t: string;
-
-    /** If true, mark the comment as a part of a thread */
-    T?: boolean;
-}
-
-/** Cell comments */
-interface Comments extends Array<Comment> {
-    /** Hide comment by default */
-    hidden?: boolean;
-}
-
-/** Link object */
-interface Hyperlink {
-    /** Target of the link (HREF) */
-    Target: string;
-
-    /** Plaintext tooltip to display when mouse is over cell */
-    Tooltip?: string;
-}
-
-/** Worksheet Cell Object */
-interface CellObject {
-    /** The raw value of the cell.  Can be omitted if a formula is specified */
-    v?: string | number | boolean | Date;
-
-    /** Formatted text (if applicable) */
-    w?: string;
-
-    /**
-     * The Excel Data Type of the cell.
-     * b Boolean, n Number, e Error, s String, d Date, z Empty
-     */
-    t: ExcelDataType;
-
-    /** Cell formula (if applicable) */
-    f?: string;
-
-    /** 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;
-
-    /** HTML rendering of the rich text (if applicable) */
-    h?: string;
-
-    /** Comments associated with the cell */
-    c?: Comments;
-
-    /** Number format string associated with the cell (if requested) */
-    z?: NumberFormat;
-
-    /** Cell hyperlink object (.Target holds link, .tooltip is tooltip) */
-    l?: Hyperlink;
-
-    /** The style/theme of the cell (if applicable) */
-    s?: any;
-}
-
-/** Simple Cell Address */
-interface CellAddress {
-    /** Column number */
-    c: number;
-    /** Row number */
-    r: number;
-}
-
-/** Range object (representing ranges like "A1:B2") */
-interface Range {
-    /** Starting cell */
-    s: CellAddress;
-    /** Ending cell */
-    e: CellAddress;
-}
-
-interface Sheet2CSVOpts extends DateNFOption {
-    /** Field Separator ("delimiter") */
-    FS?: string;
-
-    /** Record Separator ("row separator") */
-    RS?: string;
-
-    /** Remove trailing field separators in each record */
-    strip?: boolean;
-
-    /** Include blank lines in the CSV output */
-    blankrows?: boolean;
-
-    /** Skip hidden rows and columns in the CSV output */
-    skipHidden?: boolean;
-
-    /** Force quotes around fields */
-    forceQuotes?: boolean;
-
-    /** if true, return raw numbers; if false, return formatted numbers */
-    rawNumbers?: boolean;
-}
-
-interface OriginOption {
-    /** Top-Left cell for operation (CellAddress or A1 string or row) */
-    origin?: number | string | CellAddress;
-}
-
-interface Sheet2HTMLOpts {
-    /** TABLE element id attribute */
-    id?: string;
-
-    /** Add contenteditable to every cell */
-    editable?: boolean;
-
-    /** Header HTML */
-    header?: string;
-
-    /** Footer HTML */
-    footer?: string;
-}
-
-interface Sheet2JSONOpts extends DateNFOption {
-    /** Output format */
-    header?: "A"|number|string[];
-
-    /** Override worksheet range */
-    range?: any;
-
-    /** Include or omit blank lines in the output */
-    blankrows?: boolean;
-
-    /** Default value for null/undefined values */
-    defval?: any;
-
-    /** 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;
-}
-
-interface Sheet2FormulaOpts {
-    /**
-     * If false, only export cells with formulae.
-     * By default, synthetic formulae are generated for each cell.
-     */
-    values?: boolean;
-}
-
-interface UTCDateOption {
-    /**
-     * If true, dates are interpreted using the UTC methods
-     * By default, dates are interpreted in the local timezone
-     *
-     * @default false
-     */
-    UTC?: boolean;
-}
-
-interface AOA2SheetOpts extends CommonOptions, UTCDateOption, DateNFOption, DenseOption {
-    /**
-     * Create cell objects for stub cells
-     * @default false
-     */
-    sheetStubs?: boolean;
-}
-
-interface SheetAOAOpts extends AOA2SheetOpts, OriginOption {}
-
-interface JSON2SheetOpts extends CommonOptions, UTCDateOption, DateNFOption, OriginOption, DenseOption {
-    /** Use specified column order */
-    header?: string[];
-
-    /** Skip header row in generated sheet */
-    skipHeader?: boolean;
-}
-
-interface Table2SheetOpts extends CommonOptions, DateNFOption, OriginOption {
-    /** If true, plaintext parsing will not parse values */
-    raw?: boolean;
-
-    /**
-     * If >0, read the first sheetRows rows
-     * @default 0
-     */
-    sheetRows?: number;
-
-    /** 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;
-}
-
-interface Table2BookOpts extends Table2SheetOpts {
-    /**
-     * Override the worksheet name
-     * @default "Sheet1"
-     */
-     sheet?: string;
-}
-
-/** General utilities */
-interface XLSX$Utils {
-    /* --- Import Functions --- */
-
-    /** Converts an array of arrays of JS data to a worksheet. */
-    aoa_to_sheet<T>(data: T[][], opts?: AOA2SheetOpts): WorkSheet;
-    aoa_to_sheet(data: any[][], opts?: AOA2SheetOpts): WorkSheet;
-
-    /** Converts an array of JS objects to a worksheet. */
-    json_to_sheet<T>(data: T[], opts?: JSON2SheetOpts): WorkSheet;
-    json_to_sheet(data: any[], opts?: JSON2SheetOpts): WorkSheet;
-
-    /** BROWSER ONLY! Converts a TABLE DOM element to a worksheet. */
-    table_to_sheet(data: any,  opts?: Table2SheetOpts): WorkSheet;
-    table_to_book(data: any,  opts?: Table2BookOpts): WorkBook;
-    sheet_add_dom(ws: WorkSheet, data: any, opts?: Table2SheetOpts): WorkSheet;
-
-    /* --- Export Functions --- */
-
-    /** Converts a worksheet object to an array of JSON objects */
-    sheet_to_json<T>(worksheet: WorkSheet, opts?: Sheet2JSONOpts): T[];
-    sheet_to_json(worksheet: WorkSheet, opts?: Sheet2JSONOpts): any[][];
-    sheet_to_json(worksheet: WorkSheet, opts?: Sheet2JSONOpts): any[];
-
-    /** Generates delimiter-separated-values output */
-    sheet_to_csv(worksheet: WorkSheet, options?: Sheet2CSVOpts): string;
-
-    /** Generates UTF16 Formatted Text */
-    sheet_to_txt(worksheet: WorkSheet, options?: Sheet2CSVOpts): string;
-
-    /** Generates HTML */
-    sheet_to_html(worksheet: WorkSheet, options?: Sheet2HTMLOpts): string;
-
-    /** Generates a list of the formulae (with value fallbacks) */
-    sheet_to_formulae(worksheet: WorkSheet, options?: Sheet2FormulaOpts): string[];
-
-    /* --- Cell Address Utilities --- */
-
-    /** Converts 0-indexed cell address to A1 form */
-    encode_cell(cell: CellAddress): string;
-
-    /** Converts 0-indexed row to A1 form */
-    encode_row(row: number): string;
-
-    /** Converts 0-indexed column to A1 form */
-    encode_col(col: number): string;
-
-    /** Converts 0-indexed range to A1 form */
-    encode_range(s: CellAddress, e: CellAddress): string;
-    encode_range(r: Range): string;
-
-    /** Converts A1 cell address to 0-indexed form */
-    decode_cell(address: string): CellAddress;
-
-    /** Converts A1 row to 0-indexed form */
-    decode_row(row: string): number;
-
-    /** Converts A1 column to 0-indexed form */
-    decode_col(col: string): number;
-
-    /** Converts A1 range to 0-indexed form */
-    decode_range(range: string): Range;
-
-    /** Format cell */
-    format_cell(cell: CellObject, v?: any, opts?: any): string;
-
-    /* --- General Utilities --- */
-
-    /** 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, 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;
-
-    /** Set number format for a cell */
-    cell_set_number_format(cell: CellObject, fmt: string|number): CellObject;
-
-    /** Set hyperlink for a cell */
-    cell_set_hyperlink(cell: CellObject, target: string, tooltip?: string): CellObject;
-
-    /** Set internal link for a cell */
-    cell_set_internal_link(cell: CellObject, target: string, tooltip?: string): CellObject;
-
-    /** Add comment to a cell */
-    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, 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?: JSON2SheetOpts): WorkSheet;
-    sheet_add_json<T>(ws: WorkSheet, data: T[], opts?: JSON2SheetOpts): WorkSheet;
-
-
-    consts: XLSX$Consts;
-}
-
-interface XLSX$Consts {
-    /* --- Sheet Visibility --- */
-
-    /** Visibility: Visible */
-    SHEET_VISIBLE: 0;
-
-    /** Visibility: Hidden */
-    SHEET_HIDDEN: 1;
-
-    /** Visibility: Very Hidden */
-    SHEET_VERYHIDDEN: 2;
-}
-
-interface StrideOption {
-    /** Number of rows to write per step */
-    stride?: number;
-}
-
-interface XLMLStreamOpts extends WritingOptions, StrideOption {}
-
-/**
- * Streaming write methods
- *
- * These methods are directly compatible with NodeJS `stream.Readable` API
- *
- * Web Streams (modern browsers) can play nice with NodeJS streams. See the Web
- * Demo at https://docs.sheetjs.com/docs/demos/bigdata/worker#streaming-write
- *
- * NOTE: These methods are not included in the `xlsx.mini.min.js` build!
- */
-interface StreamUtils {
-    /** Set `Readable` (for environments that do not support NodeJS Streams) */
-    set_readable(Readable: any): void;
-
-    /* --- Worksheet writers --- */
-
-    /** CSV output stream, generate one line at a time */
-    to_csv(sheet: WorkSheet, opts?: Sheet2CSVOpts): any;
-    /** HTML output stream, generate one line at a time */
-    to_html(sheet: WorkSheet, opts?: Sheet2HTMLOpts): any;
-    /** JSON object stream, generate one row at a time */
-    to_json(sheet: WorkSheet, opts?: Sheet2JSONOpts): any;
-
-    /* --- Workbook writers --- */
-
-    /** XLML output string stream (bookType `xlml`) */
-    to_xlml(data: WorkBook, opts?: XLMLStreamOpts): any;
-}
-
-type xlsx_AOA2SheetOpts = AOA2SheetOpts;
-type xlsx_AutoFilterInfo = AutoFilterInfo;
-type xlsx_BookType = BookType;
-declare const xlsx_CFB: typeof CFB;
-type xlsx_CellAddress = CellAddress;
-type xlsx_CellObject = CellObject;
-type xlsx_ColInfo = ColInfo;
-type xlsx_Comment = Comment;
-type xlsx_Comments = Comments;
-type xlsx_CommonOptions = CommonOptions;
-type xlsx_DBFField = DBFField;
-type xlsx_DateNFOption = DateNFOption;
-type xlsx_DefinedName = DefinedName;
-type xlsx_DenseOption = DenseOption;
-type xlsx_DenseSheet = DenseSheet;
-type xlsx_DenseWorkSheet = DenseWorkSheet;
-type xlsx_ExcelDataType = ExcelDataType;
-type xlsx_FullProperties = FullProperties;
-type xlsx_Hyperlink = Hyperlink;
-type xlsx_JSON2SheetOpts = JSON2SheetOpts;
-type xlsx_MarginInfo = MarginInfo;
-type xlsx_NumberFormat = NumberFormat;
-type xlsx_OriginOption = OriginOption;
-type xlsx_ParsingOptions = ParsingOptions;
-type xlsx_Properties = Properties;
-type xlsx_ProtectInfo = ProtectInfo;
-type xlsx_Range = Range;
-type xlsx_RangeSpec = RangeSpec;
-type xlsx_RowInfo = RowInfo;
-declare const xlsx_SSF: typeof SSF;
-type xlsx_Sheet = Sheet;
-type xlsx_Sheet2CSVOpts = Sheet2CSVOpts;
-type xlsx_Sheet2FormulaOpts = Sheet2FormulaOpts;
-type xlsx_Sheet2HTMLOpts = Sheet2HTMLOpts;
-type xlsx_Sheet2JSONOpts = Sheet2JSONOpts;
-type xlsx_SheetAOAOpts = SheetAOAOpts;
-type xlsx_SheetKeys = SheetKeys;
-type xlsx_SheetProps = SheetProps;
-type xlsx_SheetType = SheetType;
-type xlsx_SparseSheet = SparseSheet;
-type xlsx_StreamUtils = StreamUtils;
-type xlsx_StrictWS = StrictWS;
-type xlsx_StrideOption = StrideOption;
-type xlsx_Table2BookOpts = Table2BookOpts;
-type xlsx_Table2SheetOpts = Table2SheetOpts;
-type xlsx_UTCDateOption = UTCDateOption;
-type xlsx_UTCOption = UTCOption;
-type xlsx_WBProps = WBProps;
-type xlsx_WBView = WBView;
-type xlsx_WSKeys = WSKeys;
-type xlsx_WSSpec = WSSpec;
-type xlsx_WorkBook = WorkBook;
-type xlsx_WorkSheet = WorkSheet;
-type xlsx_WorkbookProperties = WorkbookProperties;
-type xlsx_WritingOptions = WritingOptions;
-type xlsx_XLMLStreamOpts = XLMLStreamOpts;
-type xlsx_XLSX$Consts = XLSX$Consts;
-type xlsx_XLSX$Utils = XLSX$Utils;
-declare const xlsx_read: typeof read;
-declare const xlsx_readFile: typeof readFile;
-declare const xlsx_set_cptable: typeof set_cptable;
-declare const xlsx_set_fs: typeof set_fs;
-declare const xlsx_stream: typeof stream;
-declare const xlsx_utils: typeof utils;
-declare const xlsx_version: typeof version;
-declare const xlsx_write: typeof write;
-declare const xlsx_writeFile: typeof writeFile;
-declare const xlsx_writeFileAsync: typeof writeFileAsync;
-declare const xlsx_writeFileXLSX: typeof writeFileXLSX;
-declare const xlsx_writeXLSX: typeof writeXLSX;
-declare namespace xlsx {
-  export { type xlsx_AOA2SheetOpts as AOA2SheetOpts, type xlsx_AutoFilterInfo as AutoFilterInfo, type xlsx_BookType as BookType, xlsx_CFB as CFB, type xlsx_CellAddress as CellAddress, type xlsx_CellObject as CellObject, type xlsx_ColInfo as ColInfo, type xlsx_Comment as Comment, type xlsx_Comments as Comments, type xlsx_CommonOptions as CommonOptions, type xlsx_DBFField as DBFField, type xlsx_DateNFOption as DateNFOption, type xlsx_DefinedName as DefinedName, type xlsx_DenseOption as DenseOption, type xlsx_DenseSheet as DenseSheet, type xlsx_DenseWorkSheet as DenseWorkSheet, type xlsx_ExcelDataType as ExcelDataType, type xlsx_FullProperties as FullProperties, type xlsx_Hyperlink as Hyperlink, type xlsx_JSON2SheetOpts as JSON2SheetOpts, type xlsx_MarginInfo as MarginInfo, type xlsx_NumberFormat as NumberFormat, type xlsx_OriginOption as OriginOption, type xlsx_ParsingOptions as ParsingOptions, type xlsx_Properties as Properties, type xlsx_ProtectInfo as ProtectInfo, type xlsx_Range as Range, type xlsx_RangeSpec as RangeSpec, type xlsx_RowInfo as RowInfo, xlsx_SSF as SSF, type xlsx_Sheet as Sheet, type xlsx_Sheet2CSVOpts as Sheet2CSVOpts, type xlsx_Sheet2FormulaOpts as Sheet2FormulaOpts, type xlsx_Sheet2HTMLOpts as Sheet2HTMLOpts, type xlsx_Sheet2JSONOpts as Sheet2JSONOpts, type xlsx_SheetAOAOpts as SheetAOAOpts, type xlsx_SheetKeys as SheetKeys, type xlsx_SheetProps as SheetProps, type xlsx_SheetType as SheetType, type xlsx_SparseSheet as SparseSheet, type xlsx_StreamUtils as StreamUtils, type xlsx_StrictWS as StrictWS, type xlsx_StrideOption as StrideOption, type xlsx_Table2BookOpts as Table2BookOpts, type xlsx_Table2SheetOpts as Table2SheetOpts, type xlsx_UTCDateOption as UTCDateOption, type xlsx_UTCOption as UTCOption, type xlsx_WBProps as WBProps, type xlsx_WBView as WBView, type xlsx_WSKeys as WSKeys, type xlsx_WSSpec as WSSpec, type xlsx_WorkBook as WorkBook, type xlsx_WorkSheet as WorkSheet, type xlsx_WorkbookProperties as WorkbookProperties, type xlsx_WritingOptions as WritingOptions, type xlsx_XLMLStreamOpts as XLMLStreamOpts, type xlsx_XLSX$Consts as XLSX$Consts, type xlsx_XLSX$Utils as XLSX$Utils, xlsx_read as read, xlsx_readFile as readFile, xlsx_set_cptable as set_cptable, xlsx_set_fs as set_fs, xlsx_stream as stream, xlsx_utils as utils, xlsx_version as version, xlsx_write as write, xlsx_writeFile as writeFile, xlsx_writeFileAsync as writeFileAsync, xlsx_writeFileXLSX as writeFileXLSX, xlsx_writeXLSX as writeXLSX };
-}
+export { loadSheetJs, readWorkbookBytes, writeWorkbookBytes } from '@ai-matrx/print/xlsx';
 
 interface AssetResolverPort {
     resolve(url: string, signal: AbortSignal): Promise<{
@@ -1221,95 +82,17 @@ interface FormatEngine {
 }
 
 /**
- * `@ai-matrx/alchemy/operate/read` — the one parse door (ALC-19 T4–T12). Write has `buildFile`; read has `readFile`.
+ * `@ai-matrx/alchemy/operate/formats/xlsx` — the Excel workbook (CONTRACT §1.9: records' headless
+ * bytes-in/bytes-out shape over the `rows` payload; SheetJS loads only here).
  *
- * One engine per format across read and write:
- *  - CSV / TSV / delimited text: kit's `parseDelimited` (no library; it sits in `@ai-matrx/kit/delimited`
- *    beside the one writer so packages below alchemy read through it too), re-exported here. `parseDelimited` is Papa Parse–compatible in the options the platform
- *    uses (auto delimiter + line ending, quotes, `skipEmptyLines` true | "greedy", `header`,
- *    `transformHeader`, `dynamicTyping`) and answers the same `{ data, errors, meta }` shape and
- *    error codes, so a repointed importer keeps its behaviour.
- *  - XLSX / XLS / ODS: SheetJS, the library the `xlsx` writer uses, loaded on first use from the
- *    `/operate/formats/xlsx` leaf (`readWorkbook`). A caller that needs spreadsheet typing of a CSV
- *    (dates, numbers, formulas as SheetJS reads them) reads it through `readWorkbook` too.
+ * The projection rules are the same as CSV/TSV: only visible, exportable, non-secret columns;
+ * `null` is an empty cell; nested values are compact JSON text. Cells are written as values,
+ * never formulas (a typed text cell is never evaluated, so the workbook itself is not formula-guarded).
+ * The artifact's plain text is the spreadsheet-safe TSV of the same rows, through kit `toDelimited`.
  */
 
-type WorkbookCellAddress = {
-    r: number;
-    c: number;
-};
-type WorkbookCellRange = {
-    s: WorkbookCellAddress;
-    e: WorkbookCellAddress;
-};
-/** A cell as the workbook engine reads it: type, raw value, formatted text, formula source. */
-type WorkbookCell = {
-    t: "s" | "n" | "b" | "d" | "e" | "z";
-    v?: string | number | boolean | Date;
-    w?: string;
-    f?: string;
-    styled: boolean;
-};
-/** Grid shape options (header row included): `raw: false` → formatted text; `defval` fills gaps. */
-type WorkbookGridOptions = {
-    raw?: boolean;
-    defval?: unknown;
-    blankrows?: boolean;
-    dateNF?: string;
-    rawNumbers?: boolean;
-};
-type WorkbookRecordOptions = {
-    raw?: boolean;
-    defval?: unknown;
-    blankrows?: boolean;
-    dateNF?: string;
-    rawNumbers?: boolean;
-};
-interface WorkbookSheet {
-    name: string;
-    /** The used range, null for a sheet without one. */
-    range: WorkbookCellRange | null;
-    merges: WorkbookCellRange[];
-    cell(r: number, c: number): WorkbookCell | null;
-    cells(): Iterable<readonly [WorkbookCellAddress, WorkbookCell]>;
-    grid(options?: WorkbookGridOptions): unknown[][];
-    records(options?: WorkbookRecordOptions): Record<string, unknown>[];
-}
-interface Workbook {
-    sheetNames: string[];
-    sheets: WorkbookSheet[];
-    sheet(name: string): WorkbookSheet | undefined;
-}
-/** `dates`: date cells as Date (`t: "d"`); `formulas`: keep formula source; `styles`: read cell styles. */
-type WorkbookReadOptions = {
-    dates?: boolean;
-    formulas?: boolean;
-    styles?: boolean;
-};
-/** A typed cell for the `xlsx-workbook` format; a bare string/number/boolean is a value cell. */
-type WorkbookCellJson = {
-    t?: "s" | "n" | "b";
-    v?: string | number | boolean | null;
-    f?: string;
-};
-/** The `xlsx-workbook` payload value (`{ kind: "registered", format: "workbook", value }`). */
-type WorkbookJson = {
-    sheets: {
-        name: string;
-        rows: (WorkbookCellJson | string | number | boolean | null)[][];
-        merges?: WorkbookCellRange[];
-    }[];
-};
-
 declare const xlsxEngine: FormatEngine;
-type SheetJs = typeof xlsx;
-/** The bundled SheetJS module itself — ONLY for the code runtime's user-code scope (a person's code imports `xlsx`). App code reads and writes through the functions here. */
-declare function loadSheetJs(): Promise<SheetJs>;
-/** Read workbook bytes (XLSX, XLS, ODS — and CSV/TSV text when a caller needs spreadsheet typing). */
-declare function readWorkbookBytes(bytes: ArrayBuffer | Uint8Array, options?: WorkbookReadOptions): Promise<Workbook>;
-/** The workbook bytes for a `WorkbookJson` (the `xlsx-workbook` format's engine; no download). */
-declare function writeWorkbookBytes(value: WorkbookJson): Promise<Uint8Array>;
 /** `xlsx-workbook`: a `registered` payload of format "workbook" (`WorkbookJson`) → .xlsx. */
 declare const workbookEngine: FormatEngine;
 
-export { loadSheetJs, readWorkbookBytes, workbookEngine, writeWorkbookBytes, xlsxEngine };
+export { workbookEngine, xlsxEngine };