@node-projects/excelforge 2.0.0

package/README.md

@@ -0,0 +1,566 @@
+# ExcelForge 📊
+
+A **complete TypeScript library** for reading and writing Excel `.xlsx` files with **zero external dependencies**. Works in browsers, Node.js, Deno, Bun, and edge runtimes.
+
+Inspired by EPPlus (C#), ExcelForge gives you the full power of the OOXML spec — including real DEFLATE compression, round-trip editing of existing files, and rich property support.
+
+---
+
+## Features
+
+| Category | Features |
+|---|---|
+| **Read existing files** | Load `.xlsx` from file, `Uint8Array`, `base64`, or `Blob` |
+| **Patch-only writes** | Re-serialise only changed sheets; preserve pivot tables, VBA, charts, unknown parts verbatim |
+| **Compression** | Full LZ77 + Huffman DEFLATE (levels 0–9). Typical XML compresses 80–85% |
+| **Cell Values** | Strings, numbers, booleans, dates, formulas, array formulas, rich text |
+| **Styles** | Fonts, solid/pattern/gradient fills, all border styles, alignment, 30+ number format presets |
+| **Layout** | Merge cells, freeze/split panes, column widths, row heights, hide rows/cols, outline grouping |
+| **Charts** | Bar, column (stacked/100%), line, area, pie, doughnut, scatter, radar, bubble |
+| **Images** | PNG, JPEG, GIF — two-cell or one-cell anchors |
+| **Tables** | Styled Excel tables with totals row, filter buttons, column definitions |
+| **Conditional Formatting** | Cell rules, color scales, data bars, icon sets, top/bottom N, above/below average |
+| **Data Validation** | Dropdowns, whole number, decimal, date, time, text length, custom formula |
+| **Sparklines** | Line, bar, stacked — with high/low/first/last/negative colors |
+| **Page Setup** | Paper size, orientation, margins, headers/footers (odd/even/first), print options |
+| **Protection** | Sheet protection with password, cell locking/hiding |
+| **Named Ranges** | Workbook and sheet-scoped |
+| **Auto Filter** | Dropdown filters on column headers |
+| **Hyperlinks** | External URLs, mailto, internal navigation |
+| **Comments** | Cell comments with author |
+| **Multiple Sheets** | Any number, hidden/veryHidden, tab colors |
+| **Core Properties** | Title, author, subject, keywords, description, language, revision, category… |
+| **Extended Properties** | Company, manager, application, appVersion, hyperlinkBase, word/line/page counts… |
+| **Custom Properties** | Typed key-value store: string, int, decimal, bool, date, r8, i8 |
+
+---
+
+## Installation
+
+```bash
+# Copy the src/ directory into your project, or compile to dist/ first:
+tsc --outDir dist --target ES2020 --module NodeNext --moduleResolution NodeNext \
+    --declaration --strict --skipLibCheck src/index.ts [all src files]
+```
+
+No `npm install` required — zero runtime dependencies.
+
+---
+
+## Quick Start — Create a workbook
+
+```typescript
+import { Workbook, style, Colors, NumFmt } from './src/index.js';
+
+const wb = new Workbook();
+wb.coreProperties = { title: 'Q4 Report', creator: 'Alice', language: 'en-US' };
+wb.extendedProperties = { company: 'Acme Corp', appVersion: '1.0' };
+
+const ws = wb.addSheet('Sales Data');
+
+// Header row
+ws.writeRow(1, 1, ['Product', 'Q1', 'Q2', 'Q3', 'Q4', 'Total']);
+for (let c = 1; c <= 6; c++) {
+  ws.setStyle(1, c, style().bold().bg(Colors.ExcelBlue).fontColor(Colors.White).center().build());
+}
+
+// Data rows
+ws.writeArray(2, 1, [
+  ['Widget A', 1200, 1350, 1100, 1500],
+  ['Widget B',  800,  950,  870, 1020],
+  ['Gadget X', 2100, 1980, 2250, 2400],
+]);
+
+// SUM formulas
+for (let r = 2; r <= 4; r++) {
+  ws.setFormula(r, 6, `SUM(B${r}:E${r})`);
+  ws.setStyle(r, 6, style().bold().build());
+}
+
+ws.freeze(1, 0); // freeze first row
+
+// Output — compression level 6 by default (80–85% smaller than STORE)
+await wb.writeFile('./report.xlsx');          // Node.js
+await wb.download('report.xlsx');             // Browser
+const bytes = await wb.build();              // Uint8Array (any runtime)
+const b64   = await wb.buildBase64();        // base64 string
+```
+
+---
+
+## Reading & modifying existing files
+
+ExcelForge can load existing `.xlsx` files and either read their contents or patch them. Only the sheets you mark as dirty are re-serialised on write; everything else — pivot tables, VBA, drawings, slicers, macros — is preserved verbatim from the original ZIP.
+
+### Loading
+
+```typescript
+// Node.js / Deno / Bun
+const wb = await Workbook.fromFile('./existing.xlsx');
+
+// Universal (Uint8Array)
+const wb = await Workbook.fromBytes(uint8Array);
+
+// Browser (File / Blob input element)
+const wb = await Workbook.fromBlob(fileInputElement.files[0]);
+
+// base64 string (e.g. from an API or email attachment)
+const wb = await Workbook.fromBase64(base64String);
+```
+
+### Reading data
+
+```typescript
+console.log(wb.getSheetNames());         // ['Sheet1', 'Summary', 'Config']
+
+const ws = wb.getSheet('Summary');
+const cell = ws.getCell(3, 2);           // row 3, col 2
+console.log(cell.value);                 // 'Q4 Revenue'
+console.log(cell.formula);              // 'SUM(B10:B20)'
+console.log(cell.style?.font?.bold);    // true
+```
+
+### Modifying and saving
+
+```typescript
+const wb = await Workbook.fromFile('./report.xlsx');
+const ws = wb.getSheet('Sales');
+
+// Make changes
+ws.setValue(5, 3, 99000);
+ws.setStyle(5, 3, style().bg(Colors.LightGreen).build());
+ws.writeRow(20, 1, ['TOTAL', '', '=SUM(C2:C19)']);
+
+// Mark the sheet dirty — it will be re-serialised on write.
+// Sheets NOT marked dirty are written back byte-for-byte from the original.
+wb.markDirty('Sales');
+
+// Patch properties without re-serialising any sheets
+wb.coreProperties.title = 'Updated Report';
+wb.setCustomProperty('Status', { type: 'string', value: 'Approved' });
+
+await wb.writeFile('./report_updated.xlsx');
+```
+
+> **Tip:** If you forget to call `markDirty()`, your cell changes won't appear in the output because the original sheet XML will be used. Always call it after modifying a loaded sheet.
+
+---
+
+## Compression
+
+ExcelForge includes a full pure-TypeScript DEFLATE implementation (LZ77 lazy matching + dynamic/fixed Huffman coding) with no external dependencies. XML content — the bulk of any `.xlsx` — typically compresses to 80–85% of its original size.
+
+### Setting the compression level
+
+```typescript
+const wb = new Workbook();
+wb.compressionLevel = 6;  // 0–9, default 6
+```
+
+| Level | Description | Typical size vs STORE |
+|---|---|---|
+| `0` | STORE — no compression, fastest | baseline |
+| `1` | FAST — fixed Huffman, minimal LZ77 | ~75% smaller |
+| `6` | **DEFAULT** — dynamic Huffman + lazy LZ77 | ~82% smaller |
+| `9` | BEST — maximum LZ77 effort | ~83% smaller (marginal gain over 6) |
+
+Level 6 is the default and the recommended choice — it achieves most of the compression benefit of level 9 at a fraction of the CPU cost.
+
+### Per-entry level override
+
+The `buildZip` function used internally also supports per-entry overrides, useful if you want images (already compressed) stored uncompressed while XML entries are compressed:
+
+```typescript
+import { buildZip } from './src/utils/zip.js';
+
+const zip = buildZip([
+  { name: 'xl/worksheets/sheet1.xml', data: xmlBytes },         // uses global level
+  { name: 'xl/media/image1.png',      data: pngBytes, level: 0 }, // forced STORE
+  { name: 'xl/styles.xml',            data: stylesBytes, level: 9 }, // max compression
+], { level: 6 });
+```
+
+By default, `buildZip` automatically stores image file types (`png`, `jpg`, `gif`, `tiff`, `emf`, `wmf`) uncompressed since they're already compressed formats.
+
+---
+
+## Document Properties
+
+ExcelForge reads and writes all three OOXML property namespaces.
+
+### Core properties (`docProps/core.xml`)
+
+```typescript
+wb.coreProperties = {
+  title:          'Annual Report 2024',
+  subject:        'Financial Summary',
+  creator:        'Finance Team',
+  keywords:       'excel quarterly finance',
+  description:    'Auto-generated from ERP export',
+  lastModifiedBy: 'Alice',
+  revision:       '3',
+  language:       'en-US',
+  category:       'Finance',
+  contentStatus:  'Final',
+  created:        new Date('2024-01-01'),
+  // modified is always set to current time on write
+};
+```
+
+### Extended properties (`docProps/app.xml`)
+
+```typescript
+wb.extendedProperties = {
+  application:       'ExcelForge',
+  appVersion:        '1.0.0',
+  company:           'Acme Corp',
+  manager:           'Bob Smith',
+  hyperlinkBase:     'https://intranet.acme.com/',
+  docSecurity:       0,
+  linksUpToDate:     true,
+  // These are computed automatically on write:
+  // titlesOfParts, headingPairs
+};
+```
+
+### Custom properties (`docProps/custom.xml`)
+
+Custom properties support typed values — they appear in Excel under **File → Properties → Custom**.
+
+```typescript
+// Set custom properties at workbook level
+wb.customProperties = [
+  { name: 'ProjectCode',  value: { type: 'string',  value: 'PRJ-2024-007' } },
+  { name: 'Revision',     value: { type: 'int',     value: 5             } },
+  { name: 'Budget',       value: { type: 'decimal', value: 125000.00     } },
+  { name: 'IsApproved',   value: { type: 'bool',    value: true          } },
+  { name: 'ReviewDate',   value: { type: 'date',    value: new Date()    } },
+];
+
+// Or use the helper methods
+wb.setCustomProperty('Status', { type: 'string', value: 'In Review' });
+wb.setCustomProperty('Score',  { type: 'decimal', value: 9.7 });
+wb.removeCustomProperty('OldField');
+
+// Read back
+const proj = wb.getCustomProperty('ProjectCode');
+console.log(proj?.value.value);  // 'PRJ-2024-007'
+
+// Full list
+for (const p of wb.customProperties) {
+  console.log(p.name, p.value.type, p.value.value);
+}
+```
+
+Available value types: `string`, `int`, `decimal`, `bool`, `date`, `r8` (8-byte float), `i8` (BigInt).
+
+---
+
+## Cell API reference
+
+### Writing values
+
+```typescript
+ws.setValue(row, col, value);          // string | number | boolean | Date
+ws.setFormula(row, col, 'SUM(A1:A5)');
+ws.setArrayFormula(row, col, 'row*col formula', 'A1:C3');
+ws.setStyle(row, col, cellStyle);
+ws.setCell(row, col, { value, formula, style, comment, hyperlink });
+
+// Bulk writes
+ws.writeRow(row, startCol, [v1, v2, v3]);
+ws.writeArray(startRow, startCol, [[...], [...], ...]);
+```
+
+### Reading values
+
+```typescript
+const cell = ws.getCell(row, col);
+cell.value     // the stored value (string | number | boolean | undefined)
+cell.formula   // formula string if present
+cell.style     // CellStyle object
+```
+
+### Styles
+
+```typescript
+import { style, Colors, NumFmt, Styles } from './src/index.js';
+
+// Fluent builder
+const headerStyle = style()
+  .bold()
+  .italic()
+  .fontSize(13)
+  .fontColor(Colors.White)
+  .bg(Colors.ExcelBlue)
+  .border('thin')
+  .center()
+  .wrapText()
+  .numFmt(NumFmt.Currency)
+  .build();
+
+// Built-in presets
+ws.setStyle(1, 1, Styles.bold);
+ws.setStyle(1, 2, Styles.headerBlue);
+ws.setStyle(2, 3, Styles.currency);
+ws.setStyle(3, 4, Styles.percent);
+```
+
+### Number formats
+
+```typescript
+NumFmt.General      // General
+NumFmt.Integer      // 0
+NumFmt.Decimal2     // #,##0.00
+NumFmt.Currency     // $#,##0.00
+NumFmt.Percent      // 0%
+NumFmt.Percent2     // 0.00%
+NumFmt.Scientific   // 0.00E+00
+NumFmt.ShortDate    // mm-dd-yy
+NumFmt.LongDate     // d-mmm-yy
+NumFmt.Time         // h:mm:ss AM/PM
+NumFmt.DateTime     // m/d/yy h:mm
+NumFmt.Accounting   // _($* #,##0.00_)
+NumFmt.Text         // @
+```
+
+### Layout
+
+```typescript
+ws.merge(r1, c1, r2, c2);              // merge a range
+ws.mergeByRef('A1:D1');
+ws.freeze(rows, cols);                 // freeze panes
+ws.setColumn(colIndex, { width: 20, hidden: false, style });
+ws.setRow(rowIndex, { height: 30, hidden: false });
+ws.autoFilter = { ref: 'A1:E1' };
+```
+
+### Conditional formatting
+
+```typescript
+ws.addConditionalFormat({
+  sqref: 'C2:C100',
+  type: 'colorScale',
+  colorScale: {
+    min: { type: 'min', color: 'FFF8696B' },
+    max: { type: 'max', color: 'FF63BE7B' },
+  },
+  priority: 1,
+});
+
+ws.addConditionalFormat({
+  sqref: 'D2:D100',
+  type: 'dataBar',
+  dataBar: { color: 'FF638EC6' },
+  priority: 2,
+});
+```
+
+### Data validation
+
+```typescript
+ws.addDataValidation({
+  sqref: 'B2:B100',
+  type: 'list',
+  formula1: '"North,South,East,West"',
+  showDropDown: false,
+  errorTitle: 'Invalid Region',
+  error: 'Please select a valid region.',
+});
+```
+
+### Charts
+
+```typescript
+ws.addChart({
+  type: 'bar',
+  title: 'Sales by Region',
+  series: [{ name: 'Q1 Sales', dataRange: 'Sheet1!B2:B6', catRange: 'Sheet1!A2:A6' }],
+  position: { from: { row: 1, col: 8 }, to: { row: 20, col: 16 } },
+  legend: { position: 'bottom' },
+});
+```
+
+Supported chart types: `bar`, `col`, `colStacked`, `col100`, `barStacked`, `bar100`, `line`, `lineStacked`, `area`, `pie`, `doughnut`, `scatter`, `radar`, `bubble`.
+
+### Images
+
+```typescript
+import { readFileSync } from 'fs';
+const imgData = readFileSync('./logo.png');
+
+ws.addImage({
+  data:   imgData,          // Buffer, Uint8Array, or base64 string
+  format: 'png',
+  from:   { row: 1, col: 1 },
+  to:     { row: 8, col: 4 },
+});
+```
+
+### Page setup
+
+```typescript
+ws.pageSetup = {
+  paperSize:   9,             // A4
+  orientation: 'landscape',
+  scale:       90,
+  fitToPage:   true,
+  fitToWidth:  1,
+  fitToHeight: 0,
+};
+
+ws.pageMargins = {
+  left: 0.5, right: 0.5, top: 0.75, bottom: 0.75,
+  header: 0.3, footer: 0.3,
+};
+
+ws.headerFooter = {
+  oddHeader: '&C&BQ4 Report&B',
+  oddFooter: '&LExcelForge&RPage &P of &N',
+};
+```
+
+### Sheet protection
+
+```typescript
+ws.protect('mypassword', {
+  formatCells:   false,   // allow formatting
+  insertRows:    false,   // allow inserting rows
+  deleteRows:    false,
+  sort:          false,
+  autoFilter:    false,
+});
+
+// Lock individual cells (requires sheet protection to take effect)
+ws.setCell(1, 1, { value: 'Locked', style: { locked: true } });
+ws.setCell(2, 1, { value: 'Editable', style: { locked: false } });
+```
+
+---
+
+## Output methods
+
+```typescript
+// Node.js: write to file
+await wb.writeFile('./output.xlsx');
+
+// Browser: trigger download
+await wb.download('report.xlsx');
+
+// Any runtime: get bytes
+const bytes: Uint8Array = await wb.build();
+const b64: string       = await wb.buildBase64();
+```
+
+---
+
+## ZIP / Compression API
+
+The `buildZip` and `deflateRaw` utilities are exported for direct use:
+
+```typescript
+import { buildZip, deflateRaw, type ZipEntry, type ZipOptions } from './src/utils/zip.js';
+
+// deflateRaw: compress bytes with raw DEFLATE (no zlib header)
+const compressed = deflateRaw(data, 6);  // level 0–9
+
+// buildZip: assemble a ZIP archive
+const zip = buildZip(entries, { level: 6 });
+
+// ZipEntry shape
+interface ZipEntry {
+  name:   string;
+  data:   Uint8Array;
+  level?: number;  // per-entry override
+}
+
+// ZipOptions shape
+interface ZipOptions {
+  level?:       number;    // global default (0–9)
+  noCompress?:  string[];  // extensions to always STORE
+}
+```
+
+---
+
+## Architecture overview
+
+```
+ExcelForge
+├── core/
+│   ├── Workbook.ts         — orchestrates build/read/patch, holds properties
+│   ├── Worksheet.ts        — cells, formulas, styles, drawings, page setup
+│   ├── WorkbookReader.ts   — parse existing XLSX (ZIP → XML → object model)
+│   ├── SharedStrings.ts    — string deduplication table
+│   ├── properties.ts       — core / extended / custom property read+write
+│   └── types.ts            — all 80+ TypeScript interfaces
+├── styles/
+│   ├── StyleRegistry.ts    — interns fonts/fills/borders/xfs, emits styles.xml
+│   └── builders.ts         — fluent style() builder, Colors/NumFmt/Styles presets
+├── features/
+│   ├── ChartBuilder.ts     — DrawingML chart XML for 15+ chart types
+│   └── TableBuilder.ts     — Excel table XML
+└── utils/
+    ├── zip.ts              — ZIP writer with full LZ77+Huffman DEFLATE
+    ├── zipReader.ts        — ZIP reader (STORE + DEFLATE via DecompressionStream)
+    ├── xmlParser.ts        — roundtrip-safe XML parser (preserves unknown nodes)
+    └── helpers.ts          — cell ref math, XML escaping, date serials, EMU conversion
+```
+
+### Round-trip / patch strategy
+
+When you load an existing `.xlsx` and call `wb.build()`:
+
+1. The original ZIP is read and every entry is retained as raw bytes.
+2. Sheets **not** marked dirty via `wb.markDirty(name)` are written back verbatim — their original bytes are preserved unchanged.
+3. Sheets that **are** marked dirty are re-serialised with any changes applied.
+4. Core/extended/custom properties are always rewritten (they're cheap and typically user-modified).
+5. Styles and shared strings are always rewritten (dirty sheets need fresh indices).
+6. All other parts — drawings, charts, images, pivot tables, VBA modules, custom XML, connections, theme — are preserved verbatim.
+
+This means you can safely open a complex Excel file produced by another tool, change a few cells, and save without losing any features ExcelForge doesn't understand.
+
+---
+
+## Browser usage
+
+ExcelForge is fully tree-shakeable and has zero runtime dependencies. In the browser, use `CompressionStream` / `DecompressionStream` (available in all modern browsers since 2022) for decompression when reading files.
+
+```html
+<input type="file" id="file" accept=".xlsx">
+<script type="module">
+import { Workbook } from './dist/index.js';
+
+document.getElementById('file').addEventListener('change', async (e) => {
+  const file = e.target.files[0];
+  const wb   = await Workbook.fromBlob(file);
+
+  console.log('Sheets:', wb.getSheetNames());
+  console.log('Title:', wb.coreProperties.title);
+
+  const ws = wb.getSheet(wb.getSheetNames()[0]);
+  console.log('A1:', ws.getCell(1, 1).value);
+
+  // Modify and re-download
+  ws.setValue(1, 1, 'Modified!');
+  wb.markDirty(wb.getSheetNames()[0]);
+  await wb.download('modified.xlsx');
+});
+</script>
+```
+
+---
+
+## Changelog
+
+### v2.0 — Read, Modify, Compress
+
+- **Read existing XLSX files** — `Workbook.fromFile()`, `fromBytes()`, `fromBase64()`, `fromBlob()`
+- **Patch-only writes** — preserve unknown parts verbatim, only re-serialise dirty sheets
+- **Full DEFLATE compression** — pure-TypeScript LZ77 + dynamic Huffman (levels 0–9), 80–85% smaller output
+- **Extended & custom properties** — full read/write of `core.xml`, `app.xml`, `custom.xml`
+- **New utilities** — `zipReader.ts`, `xmlParser.ts`, `properties.ts`
+
+### v1.0 — Initial release
+
+- Full XLSX write support: cells, formulas, styles, charts, images, tables, conditional formatting, data validation, sparklines, page setup, protection, named ranges, auto filter, hyperlinks, comments

package/dist/core/SharedStrings.d.ts

@@ -0,0 +1,11 @@
+import type { RichTextRun } from '../core/types.js';
+export declare class SharedStrings {
+    private table;
+    private strings;
+    private _count;
+    get count(): number;
+    get uniqueCount(): number;
+    intern(s: string): number;
+    internRichText(runs: RichTextRun[]): number;
+    toXml(): string;
+}

package/dist/core/SharedStrings.js

@@ -0,0 +1,67 @@
+import { escapeXml } from '../utils/helpers.js';
+export class SharedStrings {
+    constructor() {
+        this.table = new Map();
+        this.strings = [];
+        this._count = 0;
+    }
+    get count() { return this._count; }
+    get uniqueCount() { return this.strings.length; }
+    intern(s) {
+        this._count++;
+        const existing = this.table.get(s);
+        if (existing !== undefined)
+            return existing;
+        const idx = this.strings.length;
+        this.strings.push(s);
+        this.table.set(s, idx);
+        return idx;
+    }
+    internRichText(runs) {
+        const key = JSON.stringify(runs);
+        this._count++;
+        const existing = this.table.get(key);
+        if (existing !== undefined)
+            return existing;
+        const xml = runs.map(r => {
+            const rPr = r.font ? richFontXml(r.font) : '';
+            return `<r>${rPr}<t xml:space="preserve">${escapeXml(r.text)}</t></r>`;
+        }).join('');
+        const idx = this.strings.length;
+        this.strings.push('\x00RICH\x00' + xml);
+        this.table.set(key, idx);
+        return idx;
+    }
+    toXml() {
+        const items = this.strings.map(s => {
+            if (s.startsWith('\x00RICH\x00')) {
+                return `<si>${s.slice(6)}</si>`;
+            }
+            const needsSpace = s !== s.trim() || s.includes('\n');
+            return `<si><t${needsSpace ? ' xml:space="preserve"' : ''}>${escapeXml(s)}</t></si>`;
+        }).join('');
+        return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" count="${this._count}" uniqueCount="${this.strings.length}">
+${items}
+</sst>`;
+    }
+}
+function richFontXml(f) {
+    const parts = [];
+    if (f.bold)
+        parts.push('<b/>');
+    if (f.italic)
+        parts.push('<i/>');
+    if (f.strike)
+        parts.push('<strike/>');
+    if (f.underline && f.underline !== 'none')
+        parts.push(`<u val="${f.underline}"/>`);
+    if (f.size)
+        parts.push(`<sz val="${f.size}"/>`);
+    if (f.color)
+        parts.push(`<color rgb="${f.color.startsWith('#') ? 'FF' + f.color.slice(1) : f.color}"/>`);
+    if (f.name)
+        parts.push(`<name val="${escapeXml(f.name)}"/>`);
+    return parts.length ? `<rPr>${parts.join('')}</rPr>` : '';
+}
+//# sourceMappingURL=SharedStrings.js.map

package/dist/core/SharedStrings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharedStrings.js","sourceRoot":"","sources":["../../src/core/SharedStrings.ts"],"names":[],"mappings":"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"}

package/dist/core/Workbook.d.ts

@@ -0,0 +1,42 @@
+import type { WorkbookProperties, NamedRange, WorksheetOptions } from '../core/types.js';
+import { Worksheet } from './Worksheet.js';
+import { type CoreProperties, type ExtendedProperties, type CustomProperty } from './properties.js';
+export declare class Workbook {
+    private sheets;
+    private namedRanges;
+    properties: WorkbookProperties;
+    compressionLevel: number;
+    coreProperties: CoreProperties;
+    extendedProperties: ExtendedProperties;
+    customProperties: CustomProperty[];
+    private _readResult?;
+    private _dirtySheets;
+    markDirty(sheetIndexOrName: number | string): void;
+    static fromBytes(data: Uint8Array): Promise<Workbook>;
+    static fromBase64(b64: string): Promise<Workbook>;
+    static fromFile(path: string): Promise<Workbook>;
+    static fromBlob(blob: Blob): Promise<Workbook>;
+    addSheet(name: string, options?: WorksheetOptions): Worksheet;
+    getSheet(name: string): Worksheet | undefined;
+    getSheetByIndex(idx: number): Worksheet | undefined;
+    getSheetNames(): string[];
+    removeSheet(name: string): this;
+    addNamedRange(nr: NamedRange): this;
+    getCustomProperty(name: string): CustomProperty | undefined;
+    setCustomProperty(name: string, value: CustomProperty['value']): this;
+    removeCustomProperty(name: string): this;
+    build(): Promise<Uint8Array>;
+    private _buildPatched;
+    private _buildFresh;
+    private _syncLegacyProperties;
+    private _patchWorkbookXml;
+    private _buildWorkbookRels;
+    private _relsToXml;
+    private _buildRootRels;
+    private _patchContentTypes;
+    buildBase64(): Promise<string>;
+    writeFile(path: string): Promise<void>;
+    private _buildCommentsXml;
+    private _buildVmlXml;
+    download(filename?: string): Promise<void>;
+}