@node-projects/excelforge 2.4.0 → 3.0.0

package/README.md

@@ -1,8 +1,11 @@
 # 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.
+[![npm version](https://badge.fury.io/js/%40node-projects%2Fexcelforge.svg)](https://badge.fury.io/js/%40node-projects%2Fexcelforge)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-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.
+A **complete TypeScript library** for reading and writing Excel `.xlsx` and `.xlsm` (macro-enabled) files with **zero external dependencies**. Works in browsers, Node.js, Deno, Bun, and edge runtimes.
+
+ExcelForge gives you the full power of the OOXML spec — including real DEFLATE compression, round-trip editing of existing files, and rich property support.
 
 ---
 
@@ -13,22 +16,38 @@ Inspired by EPPlus (C#), ExcelForge gives you the full power of the OOXML spec
 | **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 |
+| **Cell Values** | Strings, numbers, booleans, dates, formulas, array formulas, dynamic arrays, shared 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 |
+| **Charts** | Bar, column (stacked/100%), line, area, pie, doughnut, scatter, radar, bubble; chart sheets; modern styling with 18 color palettes, gradients, data labels, shadows; chart templates |
+| **Images** | PNG, JPEG, GIF, BMP, SVG, WebP, ICO, EMF, WMF, TIFF — two-cell, one-cell, or absolute anchors |
+| **In-Cell Pictures** | Embed images directly inside cells via richData/metadata (Excel 365+) |
+| **Shapes** | 28 preset shapes (rect, ellipse, arrows, flowchart, etc.) with fill, line, text, rotation |
+| **WordArt** | Text effects with 20 preset transforms (arch, wave, inflate, etc.) |
+| **Tables** | Styled Excel tables with totals row, filter buttons, custom table styles, table slicers |
+| **Conditional Formatting** | Cell rules, color scales, data bars, icon sets (incl. custom), cross-worksheet refs |
 | **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 |
+| **Pivot Tables** | Row/column/data fields, aggregation, calculated fields, grouping, custom styles, slicers |
+| **Page Setup** | Paper size, orientation, margins, headers/footers (odd/even/first), print options, page breaks |
 | **Protection** | Sheet protection with password, cell locking/hiding |
 | **Named Ranges** | Workbook and sheet-scoped |
-| **Auto Filter** | Dropdown filters on column headers |
+| **Connections** | OLEDB, ODBC, text/CSV, web — create, read, round-trip; query tables |
+| **Power Query** | Read M formulas from DataMashup; full round-trip preservation |
+| **External Links** | Cross-workbook references with sheet names and defined names |
+| **VBA Macros** | Create/read `.xlsm` with standard modules, class modules, document modules; code signing; full round-trip |
+| **Auto Filter** | Dropdown filters — value, date, custom, top-10, dynamic filters |
 | **Hyperlinks** | External URLs, mailto, internal navigation |
-| **Comments** | Cell comments with author |
+| **Form Controls** | Button, checkbox, combobox, listbox, radio, groupbox, label, scrollbar, spinner — with macro assignment |
+| **Dialog Sheets** | Excel 5 dialog sheets with dialog frame, OK/Cancel buttons, combo boxes |
+| **Comments** | Cell comments with author, rich text formatting |
+| **Themes** | Full Office theme XML with customizable colors and fonts |
 | **Multiple Sheets** | Any number, hidden/veryHidden, tab colors |
+| **Formula Engine** | 60+ functions including GETPIVOTDATA — tree-shakeable |
+| **Export** | CSV, JSON, HTML (with CF visualization, sparklines, charts, shapes, form controls) |
+| **Encryption** | OOXML Agile Encryption with AES-256-CBC + SHA-512 via Web Crypto API |
+| **Digital Signatures** | Package signing (XML-DSig) + VBA code signing (PKCS#7/CMS, SHA-256) |
+| **Locale** | Configurable decimal/thousands separators, date format, currency symbol |
 | **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 |
@@ -383,18 +402,212 @@ ws.addChart({
 
 Supported chart types: `bar`, `col`, `colStacked`, `col100`, `barStacked`, `bar100`, `line`, `lineStacked`, `area`, `pie`, `doughnut`, `scatter`, `radar`, `bubble`.
 
+**Modern chart styling (Excel 2019+):**
+
+```typescript
+ws.addChart({
+  type: 'column',
+  title: 'Styled Chart',
+  series: [{
+    name: 'Revenue', values: "'Sheet1'!$A$2:$D$2",
+    dataLabels: { showValue: true, position: 'outEnd' },
+    fillType: 'gradient',
+    gradientStops: [{ pos: 0, color: '4472C4' }, { pos: 100, color: 'B4C7E7' }],
+  }],
+  from: { col: 0, row: 5 }, to: { col: 8, row: 20 },
+  colorPalette: 'blue',    // 18 palettes: office, blue, orange, green, red, purple, teal...
+  shadow: true,
+  roundedCorners: true,
+  dataLabels: { showPercent: true },  // global data labels
+});
+```
+
+**Chart templates:**
+
+```typescript
+import { saveChartTemplate, applyChartTemplate, serializeChartTemplate, deserializeChartTemplate } from 'excelforge';
+
+// Save a chart's style as a template
+const template = saveChartTemplate(chart);
+const json = serializeChartTemplate(template);  // serialize to JSON string
+const restored = deserializeChartTemplate(json); // deserialize back
+
+// Apply template to a new chart
+const newChart = applyChartTemplate(template, {
+  series: [{ name: 'New', values: "'Sheet1'!$A$1:$A$5" }],
+  from: { col: 0, row: 0 }, to: { col: 5, row: 10 },
+});
+```
+
 ### Images
 
+Supported formats: `png`, `jpeg`, `gif`, `bmp`, `svg`, `webp`, `ico`, `emf`, `wmf`, `tiff`.
+
 ```typescript
 import { readFileSync } from 'fs';
 const imgData = readFileSync('./logo.png');
 
+// Floating image (two-cell anchor)
 ws.addImage({
   data:   imgData,          // Buffer, Uint8Array, or base64 string
   format: 'png',
   from:   { row: 1, col: 1 },
   to:     { row: 8, col: 4 },
 });
+
+// One-cell anchor with explicit pixel size
+ws.addImage({
+  data:   readFileSync('./icon.svg'),
+  format: 'svg',
+  from:   { row: 1, col: 6 },
+  width:  80,
+  height: 80,
+  altText: 'Company icon',
+});
+
+// Absolute positioning (not tied to any cell)
+ws.addImage({
+  data:   imgData,
+  format: 'png',
+  position: { x: 200, y: 100 },   // pixels from top-left of sheet
+  width:  120,
+  height: 80,
+});
+```
+
+### In-Cell Pictures
+
+Embed images directly inside cells (Excel 365+ feature). Uses richData/metadata internally.
+
+```typescript
+import type { CellImage } from '@node-projects/excelforge';
+
+ws.addCellImage({
+  data:    readFileSync('./photo.png'),
+  format:  'png',
+  cell:    'B2',          // cell reference
+  altText: 'Product photo',
+});
+```
+
+### Pivot tables
+
+```typescript
+const wb = new Workbook();
+
+// Source data sheet
+const wsData = wb.addSheet('Data');
+wsData.writeRow(1, 1, ['Region', 'Product', 'Sales', 'Units']);
+wsData.writeArray(2, 1, [
+  ['North', 'Widget', 12000, 150],
+  ['South', 'Widget', 9500,  120],
+  ['North', 'Gadget', 8700,  90],
+  ['South', 'Gadget', 11200, 140],
+]);
+
+// Pivot table on a separate sheet
+const wsPivot = wb.addSheet('Summary');
+wsPivot.addPivotTable({
+  name:        'SalesBreakdown',
+  sourceSheet: 'Data',
+  sourceRef:   'A1:D5',
+  targetCell:  'A1',
+  rowFields:   ['Region'],
+  colFields:   ['Product'],
+  dataFields:  [{ field: 'Sales', name: 'Sum of Sales', func: 'sum' }],
+  style:       'PivotStyleMedium9',
+  rowGrandTotals: true,
+  colGrandTotals: true,
+});
+
+await wb.writeFile('./pivot_report.xlsx');
+```
+
+Available aggregation functions: `sum`, `count`, `average`, `max`, `min`, `product`, `countNums`, `stdDev`, `stdDevp`, `var`, `varp`.
+
+### VBA macros
+
+ExcelForge can create, read, and round-trip `.xlsm` files with VBA macros. All module types are supported: standard modules, class modules, and document modules (auto-created for `ThisWorkbook` and each worksheet).
+
+```typescript
+import { Workbook, VbaProject } from './src/index.js';
+
+const wb = new Workbook();
+const ws = wb.addSheet('Sheet1');
+ws.setValue(1, 1, 'Hello');
+
+const vba = new VbaProject();
+
+// Standard module
+vba.addModule({
+  name: 'Module1',
+  type: 'standard',
+  code: 'Sub HelloWorld()\r\n    MsgBox "Hello from VBA!"\r\nEnd Sub\r\n',
+});
+
+// Class module
+vba.addModule({
+  name: 'MyClass',
+  type: 'class',
+  code: [
+    'Private pValue As String',
+    'Public Property Get Value() As String',
+    '    Value = pValue',
+    'End Property',
+    'Public Property Let Value(v As String)',
+    '    pValue = v',
+    'End Property',
+  ].join('\r\n') + '\r\n',
+});
+
+wb.vbaProject = vba;
+await wb.writeFile('./macros.xlsm');  // must use .xlsm extension
+```
+
+Reading VBA from existing files:
+
+```typescript
+const wb = await Workbook.fromFile('./macros.xlsm');
+if (wb.vbaProject) {
+  for (const mod of wb.vbaProject.modules) {
+    console.log(`${mod.name} (${mod.type}): ${mod.code.length} chars`);
+  }
+}
+
+// Modify and re-save — existing modules are preserved
+wb.vbaProject.addModule({ name: 'Module2', type: 'standard', code: '...' });
+wb.vbaProject.removeModule('OldModule');
+await wb.writeFile('./macros_updated.xlsm');
+```
+
+> **Note:** Document modules for `ThisWorkbook` and each worksheet are automatically created if not explicitly provided. VBA code uses `\r\n` line endings.
+
+### Digital Signatures
+
+Sign OOXML packages and VBA projects using RSA with SHA-256 via Web Crypto API.
+
+```typescript
+import { signPackage, signVbaProject, signWorkbook } from 'excelforge';
+
+// Sign the entire package
+const parts = new Map<string, Uint8Array>();
+parts.set('xl/workbook.xml', workbookBytes);
+parts.set('xl/worksheets/sheet1.xml', sheetBytes);
+
+const sigEntries = await signPackage(parts, {
+  certificate: pemCertificate,   // PEM-encoded X.509 certificate
+  privateKey: pemPrivateKey,     // PEM-encoded PKCS#8 private key
+});
+// sigEntries contains _xmlsignatures/sig1.xml, origin.sigs, and rels
+
+// Sign a VBA project
+const vbaSignature = await signVbaProject(vbaProjectBin, {
+  certificate: pemCertificate,
+  privateKey: pemPrivateKey,
+});
+
+// Or sign both at once
+const result = await signWorkbook(parts, { certificate, privateKey }, vbaProjectBin);
 ```
 
 ### Page setup
@@ -420,6 +633,244 @@ ws.headerFooter = {
 };
 ```
 
+### Page breaks
+
+```typescript
+// Add manual page breaks for printing
+ws.addRowBreak(20);    // page break after row 20
+ws.addRowBreak(40);    // page break after row 40
+ws.addColBreak(5);     // page break after column E
+
+// Read page breaks from an existing file
+const wb = await Workbook.fromBytes(data);
+const ws = wb.getSheet('Sheet1')!;
+for (const brk of ws.getRowBreaks()) {
+  console.log(`Row break at ${brk.id}, manual: ${brk.manual}`);
+}
+for (const brk of ws.getColBreaks()) {
+  console.log(`Col break at ${brk.id}, manual: ${brk.manual}`);
+}
+```
+
+Page breaks are fully preserved during round-trip editing, even when sheets are modified.
+
+### Named ranges
+
+```typescript
+// Define workbook-scoped named ranges
+wb.addNamedRange({ name: 'SalesData', ref: 'Data!$A$1:$A$5' });
+wb.addNamedRange({ name: 'Products', ref: 'Data!$B$1:$B$5', comment: 'Product list' });
+
+// Define sheet-scoped named range
+wb.addNamedRange({ name: 'LocalTotal', ref: 'Data!$A$6', scope: 'Data' });
+
+// Use in formulas
+ws.setFormula(1, 1, 'SUM(SalesData)');
+
+// Read named ranges from an existing file
+const wb2 = await Workbook.fromBytes(data);
+const ranges = wb2.getNamedRanges();         // all named ranges
+const sales = wb2.getNamedRange('SalesData'); // find by name
+console.log(sales?.ref);                      // "Data!$A$1:$A$5"
+
+// Remove a named range
+wb2.removeNamedRange('SalesData');
+```
+
+Named ranges (including scope and comments) are fully preserved during round-trip editing.
+
+### Connections & Power Query
+
+```typescript
+// Add a data connection (OLEDB, ODBC, text/CSV, web, etc.)
+wb.addConnection({
+  id: 1,
+  name: 'SalesDB',
+  type: 'oledb',  // 'odbc' | 'dao' | 'file' | 'web' | 'oledb' | 'text' | 'dsp'
+  connectionString: 'Provider=SQLOLEDB;Data Source=server;Initial Catalog=Sales;',
+  command: 'SELECT * FROM Orders',
+  commandType: 'sql',  // 'sql' | 'table' | 'default' | 'web' | 'oledb'
+  description: 'Sales database connection',
+  background: true,
+  saveData: true,
+});
+
+// Read connections from an existing file
+const wb2 = await Workbook.fromBytes(data);
+const conns = wb2.getConnections();           // all connections
+const sales = wb2.getConnection('SalesDB');   // find by name
+wb2.removeConnection('SalesDB');              // remove by name
+
+// Read Power Query M formulas (extracted from DataMashup)
+const queries = wb2.getPowerQueries();        // all queries
+const q = wb2.getPowerQuery('MyQuery');       // find by name
+console.log(q?.formula);                       // Power Query M code
+```
+
+Connections are fully preserved during round-trip editing. Power Query formulas (M code) stored in DataMashup binary blobs are automatically extracted for read access. Power Query/Power Pivot data models created in Excel are preserved verbatim during round-trip — you can safely open, modify cells, and save without losing any Power Query or Power Pivot features.
+
+### Form Controls
+
+```typescript
+// Add a button with a macro
+ws.addFormControl({
+  type: 'button',
+  from: { col: 1, row: 2 },
+  to:   { col: 3, row: 4 },
+  text: 'Run Report',
+  macro: 'Sheet1.RunReport',
+});
+
+// Button sized by width/height (no 'to' anchor needed)
+ws.addFormControl({
+  type: 'button',
+  from: { col: 1, row: 5 },
+  width: 120, height: 30,    // pixels
+  text: 'Compact Button',
+});
+
+// CheckBox linked to a cell
+ws.addFormControl({
+  type: 'checkBox',
+  from: { col: 1, row: 7 },
+  to:   { col: 3, row: 8 },
+  text: 'Enable Feature',
+  linkedCell: '$B$10',
+  checked: 'checked',   // 'checked' | 'unchecked' | 'mixed'
+});
+
+// ComboBox (dropdown) with input range
+ws.addFormControl({
+  type: 'comboBox',
+  from: { col: 1, row: 7 },
+  to:   { col: 3, row: 8 },
+  linkedCell: '$B$11',
+  inputRange: '$D$1:$D$5',
+  dropLines: 5,
+});
+
+// ListBox, OptionButton, GroupBox, Label, ScrollBar, Spinner
+ws.addFormControl({
+  type: 'scrollBar',
+  from: { col: 4, row: 6 },
+  to:   { col: 6, row: 7 },
+  linkedCell: '$B$14',
+  min: 0, max: 100, inc: 1, page: 10, val: 50,
+});
+
+// Read form controls from an existing file
+const wb2 = await Workbook.fromBytes(data);
+const controls = ws.getFormControls();
+for (const ctrl of controls) {
+  console.log(ctrl.type, ctrl.linkedCell, ctrl.macro);
+}
+```
+
+Supported control types: `button`, `checkBox`, `comboBox`, `listBox`, `optionButton`, `groupBox`, `label`, `scrollBar`, `spinner`. All control types support `macro` assignment and are fully preserved during round-trip editing.
+
+### Shapes
+
+```typescript
+ws.addShape({
+  type: 'roundRect',
+  from: { col: 1, row: 3 },
+  to:   { col: 5, row: 8 },
+  fillColor: '4472C4',
+  lineColor: '2F5496',
+  text: 'Process Step',
+  rotation: 0,
+});
+```
+
+Supported shape types: `rect`, `roundRect`, `ellipse`, `triangle`, `diamond`, `pentagon`, `hexagon`, `octagon`, `star5`, `star6`, `rightArrow`, `leftArrow`, `upArrow`, `downArrow`, `line`, `curvedConnector3`, `callout1`, `callout2`, `cloud`, `heart`, `lightningBolt`, `sun`, `moon`, `smileyFace`, `flowChartProcess`, `flowChartDecision`, `flowChartTerminator`, `flowChartDocument`.
+
+### WordArt
+
+```typescript
+ws.addWordArt({
+  text: 'SALE!',
+  preset: 'textArchUp',
+  font: { name: 'Impact', size: 48, bold: true },
+  fillColor: 'FF0000',
+  outlineColor: '990000',
+  from: { col: 1, row: 1 },
+  to:   { col: 8, row: 6 },
+});
+```
+
+Supported presets: `textPlain`, `textArchUp`, `textArchDown`, `textCircle`, `textWave1`, `textWave2`, `textInflate`, `textDeflate`, `textFadeUp`, `textFadeDown`, `textSlantUp`, `textSlantDown`, and more.
+
+### Themes
+
+```typescript
+wb.theme = {
+  name: 'Corporate Theme',
+  colors: [
+    { name: 'dk1', color: '000000' }, { name: 'lt1', color: 'FFFFFF' },
+    { name: 'dk2', color: '44546A' }, { name: 'lt2', color: 'E7E6E6' },
+    { name: 'accent1', color: '4472C4' }, { name: 'accent2', color: 'ED7D31' },
+    { name: 'accent3', color: 'A5A5A5' }, { name: 'accent4', color: 'FFC000' },
+    { name: 'accent5', color: '5B9BD5' }, { name: 'accent6', color: '70AD47' },
+    { name: 'hlink', color: '0563C1' }, { name: 'folHlink', color: '954F72' },
+  ],
+  majorFont: 'Calibri Light',
+  minorFont: 'Calibri',
+};
+```
+
+### Table Slicers
+
+```typescript
+ws.addTableSlicer({
+  name: 'RegionSlicer',
+  tableName: 'SalesTable',
+  columnName: 'Region',
+  caption: 'Filter by Region',
+  style: 'SlicerStyleLight1',
+});
+```
+
+### Pivot Slicers & Custom Pivot Styles
+
+```typescript
+wb.registerPivotStyle({
+  name: 'BrandedPivot',
+  elements: [
+    { type: 'headerRow', style: { font: { bold: true, color: 'FFFFFF' }, fill: { type: 'pattern', pattern: 'solid', fgColor: '4472C4' } } },
+  ],
+});
+
+wb.addPivotSlicer({
+  name: 'ProductSlicer',
+  pivotTableName: 'SalesPivot',
+  fieldName: 'Product',
+  caption: 'Product Filter',
+});
+```
+
+### External Links
+
+```typescript
+wb.addExternalLink({
+  target: 'file:///C:/Reports/Budget.xlsx',
+  sheets: [{ name: 'Sheet1' }, { name: 'Summary' }],
+});
+
+// Reference external data in formulas
+ws.setFormula(1, 1, '[1]Sheet1!A1');
+```
+
+### Locale Settings
+
+```typescript
+wb.locale = {
+  decimalSeparator: ',',
+  thousandsSeparator: '.',
+  dateFormat: 'DD.MM.YYYY',
+  currencySymbol: '€',
+};
+```
+
 ### Sheet protection
 
 ```typescript
@@ -498,8 +949,15 @@ ExcelForge
 │   ├── 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
+│   ├── ChartBuilder.ts     — DrawingML chart XML for 15+ chart types, templates, modern styling
+│   ├── TableBuilder.ts     — Excel table XML
+│   ├── PivotTableBuilder.ts — pivot table + cache XML
+│   ├── Encryption.ts       — OOXML Agile Encryption (AES-256-CBC + SHA-512)
+│   └── Signing.ts          — Digital signatures (XML-DSig + VBA PKCS#7/CMS)
+├── vba/
+│   ├── VbaProject.ts       — VBA project build/parse, module management
+│   ├── cfb.ts              — Compound Binary File (OLE2) reader & writer
+│   └── ovba.ts             — MS-OVBA compression/decompression
 └── utils/
     ├── zip.ts              — ZIP writer with full LZ77+Huffman DEFLATE
     ├── zipReader.ts        — ZIP reader (STORE + DEFLATE via DecompressionStream)
@@ -553,6 +1011,20 @@ document.getElementById('file').addEventListener('change', async (e) => {
 
 ## Changelog
 
+### v3.0 — More
+- **Form Controls** - create Form Controls
+- Wordart
+- Formula Objects
+- Chart Pages
+- Many more features....
+
+### v2.4 — Pivot Tables & VBA Macros
+
+- **Pivot tables** — create pivot tables with row/column/data fields, 11 aggregation functions, customisable styles
+- **VBA macros** — create, read, and round-trip `.xlsm` files with standard, class, and document modules
+- **CFB (OLE2) support** — MS-CFB reader/writer for vbaProject.bin, with MS-OVBA compression
+- **Automatic sheet modules** — document modules for ThisWorkbook and each worksheet are auto-generated
+
 ### v2.0 — Read, Modify, Compress
 
 - **Read existing XLSX files** — `Workbook.fromFile()`, `fromBytes()`, `fromBase64()`, `fromBlob()`

package/dist/core/SharedStrings.js

@@ -58,8 +58,12 @@ function richFontXml(f) {
         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.color) {
+        if (f.color.startsWith('theme:'))
+            parts.push(`<color theme="${f.color.slice(6)}"/>`);
+        else
+            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>` : '';

package/dist/core/SharedStrings.js.map

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

package/dist/core/Workbook.d.ts

@@ -1,14 +1,24 @@
-import type { WorkbookProperties, NamedRange, WorksheetOptions } from '../core/types.js';
+import type { WorkbookProperties, NamedRange, WorksheetOptions, Connection, PowerQuery, Theme, ExternalLink, CustomPivotStyle, LocaleSettings, PivotSlicer } from '../core/types.js';
 import { Worksheet } from './Worksheet.js';
+import { VbaProject } from '../vba/VbaProject.js';
 import { type CoreProperties, type ExtendedProperties, type CustomProperty } from './properties.js';
 export declare class Workbook {
     private sheets;
     private namedRanges;
+    private connections;
+    private powerQueries;
+    private externalLinks;
+    private customPivotStyles;
+    private pivotSlicers;
+    theme?: Theme;
+    locale?: LocaleSettings;
     properties: WorkbookProperties;
     compressionLevel: number;
     coreProperties: CoreProperties;
     extendedProperties: ExtendedProperties;
     customProperties: CustomProperty[];
+    vbaProject?: VbaProject;
+    isTemplate: boolean;
     private _readResult?;
     private _dirtySheets;
     markDirty(sheetIndexOrName: number | string): void;
@@ -20,18 +30,48 @@ export declare class Workbook {
     getSheet(name: string): Worksheet | undefined;
     getSheetByIndex(idx: number): Worksheet | undefined;
     getSheetNames(): string[];
+    getSheets(): readonly Worksheet[];
     removeSheet(name: string): this;
+    addChartSheet(name: string, chart: import('./types.js').Chart): Worksheet;
+    addDialogSheet(name: string): Worksheet;
+    copySheet(sourceName: string, newName: string): Worksheet;
+    private _customTableStyles;
+    registerTableStyle(name: string, def: {
+        headerRow?: import('./types.js').CellStyle;
+        dataRow1?: import('./types.js').CellStyle;
+        dataRow2?: import('./types.js').CellStyle;
+        totalRow?: import('./types.js').CellStyle;
+    }): this;
     addNamedRange(nr: NamedRange): this;
+    getNamedRanges(): readonly NamedRange[];
+    getNamedRange(name: string): NamedRange | undefined;
+    removeNamedRange(name: string): this;
+    addConnection(conn: Connection): this;
+    getConnections(): readonly Connection[];
+    getConnection(name: string): Connection | undefined;
+    removeConnection(name: string): this;
+    getPowerQueries(): readonly PowerQuery[];
+    getPowerQuery(name: string): PowerQuery | undefined;
     getCustomProperty(name: string): CustomProperty | undefined;
     setCustomProperty(name: string, value: CustomProperty['value']): this;
     removeCustomProperty(name: string): this;
+    addExternalLink(link: ExternalLink): this;
+    getExternalLinks(): readonly ExternalLink[];
+    registerPivotStyle(style: CustomPivotStyle): this;
+    addPivotSlicer(slicer: PivotSlicer): this;
+    getPivotSlicers(): readonly PivotSlicer[];
     build(): Promise<Uint8Array>;
     private _buildPatched;
     private _buildFresh;
+    private _headingPairs;
     private _syncLegacyProperties;
+    private _ensureVbaSheetModules;
     private _patchWorkbookXml;
+    private _definedNamesXml;
+    private _connectionsXml;
     private _buildWorkbookRels;
     private _relsToXml;
+    private _buildThemeXml;
     private _buildRootRels;
     private _patchContentTypes;
     buildBase64(): Promise<string>;