ooxml-core 0.8.0 → 0.10.0

package/dist/xlsx/layout/anchors.d.ts

@@ -0,0 +1,47 @@
+import type { DrawingAnchor, Worksheet } from '../model.js';
+import { type GridMetrics } from './metrics.js';
+/** A rectangle on the grid plane in pixels at the metrics' zoom (origin: top-left of A1). */
+export interface PixelBox {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Which anchor form `pixelBoxToAnchor` produces. */
+export type AnchorKind = 'twoCell' | 'oneCell';
+/** Extent used when a one-cell anchor has no `ext` (200 px, Excel's default chart size). */
+export declare const DEFAULT_ANCHOR_EXTENT_EMU = 1905000;
+/** Smallest edge of a two-cell box, in pixels, so a collapsed anchor stays selectable. */
+export declare const MIN_TWO_CELL_PIXELS = 4;
+/**
+ * The anchor form of an existing anchor. Absolute anchors are read into the model as a one-cell
+ * marker on A1 with their position as offsets, so they report `oneCell`.
+ */
+export declare function anchorKind(anchor: DrawingAnchor): AnchorKind;
+/**
+ * The plane rectangle of an anchor. Two-cell anchors span their markers (at least
+ * `MIN_TWO_CELL_PIXELS` per edge); one-cell and absolute anchors start at their marker and take
+ * their extent (`DEFAULT_ANCHOR_EXTENT_EMU` when missing). `metrics` defaults to the sheet's grid
+ * at its own zoom.
+ */
+export declare function anchorToPixelBox(sheet: Worksheet, anchor: DrawingAnchor, metrics?: GridMetrics): PixelBox;
+/**
+ * The anchor that puts an object at a plane rectangle. `like` keeps the form of an existing
+ * anchor (pass the object's current anchor when moving or resizing it) or names one; the default
+ * is a one-cell anchor. Offsets and extents are whole EMU at 100% zoom.
+ */
+export declare function pixelBoxToAnchor(sheet: Worksheet, box: PixelBox, metrics?: GridMetrics, like?: DrawingAnchor | AnchorKind): DrawingAnchor;
+/** An EMU extent for a size in pixels at 100% zoom (rounded to whole EMU). */
+export declare function pixelSizeToExtent(width: number, height: number): {
+    cx: number;
+    cy: number;
+};
+/**
+ * A one-cell anchor at a cell for a picture of `width` x `height` pixels, scaled down to at most
+ * `maxWidth` pixels wide (default 640, as Insert > Pictures does) keeping its aspect ratio.
+ */
+export declare function pictureAnchorAt(cell: {
+    row: number;
+    col: number;
+}, width: number, height: number, maxWidth?: number): DrawingAnchor;
+//# sourceMappingURL=anchors.d.ts.map

package/dist/xlsx/layout/anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../../src/xlsx/layout/anchors.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEnE,6FAA6F;AAC7F,MAAM,WAAW,QAAQ;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AAED,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/C,4FAA4F;AAC5F,eAAO,MAAM,yBAAyB,UAAU,CAAC;AAEjD,0FAA0F;AAC1F,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAIrC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAE5D;AAWD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,WAAsC,GAC7C,QAAQ,CAkBV;AAaD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,QAAQ,EACb,OAAO,GAAE,WAAsC,EAC/C,IAAI,GAAE,aAAa,GAAG,UAAsB,GAC1C,aAAa,CAOf;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAE3F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,SAAM,GACZ,aAAa,CAMf"}

package/dist/xlsx/layout/cf-evaluator.d.ts

@@ -1,3 +1,4 @@
+export { iconIndex, scaleColor } from './cf-helpers.js';
 import type { CellValue, Workbook } from '../model.js';
 import type { ConditionalFormatEvaluator } from './types.js';
 export type CellAt = {
@@ -21,6 +22,4 @@ export interface ConditionalFormatOptions {
  * Formulas are relative to the top-left cell of the format's first range, as in SpreadsheetML.
  */
 export declare function createConditionalFormatEvaluator(workbook: Workbook, sheetIndex: number, evaluate: FormulaEvaluator, options?: ConditionalFormatOptions): ConditionalFormatEvaluator;
-/** The colour-scale colour of `value` between threshold positions. */
-export declare function scaleColor(value: number, cuts: readonly number[], colors: readonly string[]): string | undefined;
 //# sourceMappingURL=cf-evaluator.d.ts.map

package/dist/xlsx/layout/cf-evaluator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cf-evaluator.d.ts","sourceRoot":"","sources":["../../../src/xlsx/layout/cf-evaluator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACX,SAAS,EAIT,QAAQ,EAER,MAAM,aAAa,CAAC;AAYrB,OAAO,KAAK,EAAE,0BAA0B,EAA2B,MAAM,YAAY,CAAC;AAEtF,MAAM,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC;AAE1E,MAAM,WAAW,wBAAwB;IACxC,iGAAiG;IACjG,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpE;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB;AAQD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC/C,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE,wBAA6B,GACpC,0BAA0B,CA0M5B;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,EAAE,SAAS,MAAM,EAAE,GACvB,MAAM,GAAG,SAAS,CAepB"}
+{"version":3,"file":"cf-evaluator.d.ts","sourceRoot":"","sources":["../../../src/xlsx/layout/cf-evaluator.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EACX,SAAS,EAIT,QAAQ,EAER,MAAM,aAAa,CAAC;AAYrB,OAAO,KAAK,EAAE,0BAA0B,EAA2B,MAAM,YAAY,CAAC;AAEtF,MAAM,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC;AAE1E,MAAM,WAAW,wBAAwB;IACxC,iGAAiG;IACjG,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpE;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB;AAUD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC/C,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE,wBAA6B,GACpC,0BAA0B,CAoN5B"}

package/dist/xlsx/layout/cf-helpers.d.ts

@@ -1,8 +1,15 @@
-import type { CellValue, DifferentialStyle } from '../model.js';
+import type { CellValue, CfvoThreshold, DifferentialStyle } from '../model.js';
 /** A literal number or string operand, evaluated without the formula engine. */
 export declare function literal(formula: string): CellValue | undefined;
 /** The serial of today's local date. */
 export declare function localTodaySerial(date1904: boolean): number;
 /** Later (lower-priority) differential style under the accumulated one. */
 export declare function mergeDxf(acc: DifferentialStyle | undefined, next: DifferentialStyle): DifferentialStyle;
+/**
+ * The icon a value earns: the last threshold it reaches, where a threshold with `gte: false`
+ * must be exceeded (`>`) rather than met (`>=`).
+ */
+export declare function iconIndex(value: number, cuts: readonly number[], list: readonly CfvoThreshold[]): number;
+/** The colour-scale colour of `value` between threshold positions. */
+export declare function scaleColor(value: number, cuts: readonly number[], colors: readonly string[]): string | undefined;
 //# sourceMappingURL=cf-helpers.d.ts.map

package/dist/xlsx/layout/cf-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cf-helpers.d.ts","sourceRoot":"","sources":["../../../src/xlsx/layout/cf-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhE,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAQ9D;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAK1D;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CACvB,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAClC,IAAI,EAAE,iBAAiB,GACrB,iBAAiB,CAQnB"}
+{"version":3,"file":"cf-helpers.d.ts","sourceRoot":"","sources":["../../../src/xlsx/layout/cf-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAK/E,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAQ9D;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAK1D;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CACvB,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAClC,IAAI,EAAE,iBAAiB,GACrB,iBAAiB,CAQnB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE,SAAS,aAAa,EAAE,GAC5B,MAAM,CAOR;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,EAAE,SAAS,MAAM,EAAE,GACvB,MAAM,GAAG,SAAS,CAepB"}

package/dist/xlsx/layout/index.d.ts

@@ -2,6 +2,7 @@ export { COLUMN_PADDING_PX, DEFAULT_BASE_COL_WIDTH, DEFAULT_MAX_DIGIT_WIDTH, IND
 export { AxisMetrics } from './axis-metrics.js';
 export { createGridMetrics, zoomPercent, type GridMetrics, type GridMetricsOptions, } from './metrics.js';
 export { visibleCells, type Viewport, type VisibleCells } from './viewport.js';
+export { DEFAULT_ANCHOR_EXTENT_EMU, MIN_TWO_CELL_PIXELS, anchorKind, anchorToPixelBox, pictureAnchorAt, pixelBoxToAnchor, pixelSizeToExtent, type AnchorKind, type PixelBox, } from './anchors.js';
 export { applyTint, hls240ToRgb, parseHex, rgbToHls240, toHexColor, type Hls } from './tint.js';
 export { INDEXED_COLORS, THEME_SLOTS, mixColors, resolveColor, themeColor } from './colors.js';
 export type { BordersView, CellView, ConditionalFormatEvaluator, ConditionalFormatResult, DataBarView, EdgeView, FillView, FontView, HAlignView, IconView, MergeView, VAlignView, } from './types.js';

package/dist/xlsx/layout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/xlsx/layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,cAAc,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACN,iBAAiB,EACjB,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/F,YAAY,EACX,WAAW,EACX,QAAQ,EACR,0BAA0B,EAC1B,uBAAuB,EACvB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,SAAS,EACT,UAAU,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,aAAa,EACb,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,GACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,KAAK,eAAe,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,gCAAgC,EAChC,UAAU,EACV,KAAK,MAAM,EACX,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACN,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,cAAc,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACN,eAAe,EACf,SAAS,EACT,aAAa,EACb,KAAK,SAAS,EACd,KAAK,gBAAgB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,cAAc,EACd,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/xlsx/layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,cAAc,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACN,iBAAiB,EACjB,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EACN,yBAAyB,EACzB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,QAAQ,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/F,YAAY,EACX,WAAW,EACX,QAAQ,EACR,0BAA0B,EAC1B,uBAAuB,EACvB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,SAAS,EACT,UAAU,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,aAAa,EACb,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,GACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,KAAK,eAAe,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,gCAAgC,EAChC,UAAU,EACV,KAAK,MAAM,EACX,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACN,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,cAAc,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACN,eAAe,EACf,SAAS,EACT,aAAa,EACb,KAAK,SAAS,EACd,KAAK,gBAAgB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,cAAc,EACd,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/xlsx/load/csv.d.ts

@@ -15,15 +15,36 @@ export declare function parseCsv(input: string, options?: CsvOptions): string[][
 export declare function sheetNameFromFileName(fileName: string | undefined): string;
 export interface CsvWorkbookOptions extends CsvOptions {
     sheetName?: string;
+    /**
+     * Treat fields starting with `=` as formulas, as Excel does when it opens a CSV. Off by
+     * default: a CSV from an untrusted source must not inject formulas (`=HYPERLINK(...)`,
+     * `=WEBSERVICE(...)`) into the workbook, so such fields are imported as text.
+     */
+    formulas?: boolean;
 }
 /**
  * A one-sheet workbook from CSV text. Each field goes through `parseCellInput`, so numbers,
- * dates, percentages, booleans, errors and `=` formulas become typed cells as Excel opens them.
+ * dates, percentages, booleans and errors become typed cells as Excel opens them; `=` fields
+ * become formulas only with `formulas: true` and are text otherwise.
  */
 export declare function csvToWorkbook(text: string, options?: CsvWorkbookOptions): Workbook;
+/**
+ * A text value that would run as a formula when the CSV is opened in a spreadsheet, prefixed
+ * with a single quote so it stays text (OWASP CSV injection guidance). Numbers such as `-5` are
+ * not text cells and are never prefixed.
+ */
+export declare function neutraliseCsvFormula(text: string): string;
+export interface CsvWriteOptions extends CsvOptions {
+    /**
+     * Prefix text that starts with `=`, `+`, `-`, `@`, tab or carriage return with `'` so a
+     * spreadsheet opening the file does not evaluate it. On by default.
+     */
+    escapeFormulas?: boolean;
+}
 /**
  * One sheet as CSV: each cell's formatted display text (as Excel's CSV export writes it), rows
- * from A1 to the end of the used range padded to the same width, CRLF line endings.
+ * from A1 to the end of the used range padded to the same width, CRLF line endings. Text that a
+ * spreadsheet would evaluate as a formula is neutralised (see {@link neutraliseCsvFormula}).
  */
-export declare function sheetToCsv(workbook: Workbook, sheetIndex: number, options?: CsvOptions): string;
+export declare function sheetToCsv(workbook: Workbook, sheetIndex: number, options?: CsvWriteOptions): string;
 //# sourceMappingURL=csv.d.ts.map

package/dist/xlsx/load/csv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../src/xlsx/load/csv.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKlD,MAAM,WAAW,UAAU;IAC1B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAyBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAepD;AAKD,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,MAAM,EAAE,EAAE,CA4C5E;AAKD,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQ1E;AAED,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,QAAQ,CAkCtF;AAMD;;;GAGG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,UAAe,GACtB,MAAM,CAsBR"}
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../src/xlsx/load/csv.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKlD,MAAM,WAAW,UAAU;IAC1B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAyBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAepD;AAKD,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,MAAM,EAAE,EAAE,CA4C5E;AAKD,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQ1E;AAED,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,QAAQ,CAmCtF;AAKD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IAClD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAMD;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,eAAoB,GAC3B,MAAM,CAwBR"}

package/dist/xlsx/load/detect.d.ts

@@ -1,22 +1,54 @@
+import { type EncryptionOptions } from '../../crypto/index.js';
 import type { Workbook } from '../model.js';
-export type WorkbookFormat = 'xlsx' | 'xlsm' | 'xls' | 'csv';
+/**
+ * A detected spreadsheet format. `'encrypted'` is an OOXML package saved with a password to open
+ * (a compound file holding EncryptionInfo and EncryptedPackage, not a legacy .xls); `'xlsb'` is
+ * an Excel Binary Workbook, recognised so it can be refused honestly.
+ */
+export type WorkbookFormat = 'xlsx' | 'xlsm' | 'xls' | 'csv' | 'encrypted' | 'xlsb';
 /** Sniffs a spreadsheet's format from its bytes (and, for macro-enabled packages, its name). */
 export declare function detectWorkbookFormat(input: Uint8Array | ArrayBuffer, fileName?: string): WorkbookFormat;
-/** Decodes CSV bytes: UTF-8 (with or without BOM) or UTF-16 with a BOM. */
+/**
+ * Decodes CSV bytes: a UTF-16 or UTF-8 byte-order mark is honoured; otherwise strict UTF-8,
+ * falling back to Windows-1252 (Excel's default "CSV (Comma delimited)" encoding).
+ */
 export declare function decodeText(bytes: Uint8Array): string;
 export interface LoadWorkbookOptions {
     /** The file name, used for the CSV sheet name and to recognise macro-enabled packages. */
     fileName?: string;
     /** CSV field delimiter; detected when omitted. */
     delimiter?: string;
+    /**
+     * The password to open an encrypted (password-protected) .xlsx/.xlsm. Without it such a file
+     * throws `PasswordRequiredError` (`code: 'password-required'`); a wrong one throws
+     * `IncorrectPasswordError` (`code: 'incorrect-password'`).
+     */
+    password?: string;
+    /**
+     * Import CSV fields starting with `=` as formulas, as Excel does. Off by default: a CSV from an
+     * untrusted source would otherwise inject live formulas (`=HYPERLINK(...)`).
+     */
+    formulas?: boolean;
 }
-/** Loads any supported spreadsheet: .xlsx, .xlsm, .xltx, .xls or CSV. */
+/** Loads any supported spreadsheet: .xlsx, .xlsm, .xltx (also password-protected), .xls or CSV. */
 export declare function loadWorkbook(input: Uint8Array | ArrayBuffer, options?: LoadWorkbookOptions): Promise<Workbook>;
+export interface SaveWorkbookOptions {
+    /** The sheet a CSV save writes (default the active sheet). */
+    sheetIndex?: number;
+    /**
+     * Encrypts an `'xlsx'` save with this password to open (agile encryption, AES-256 and
+     * SHA-512, as Excel 2010 and later write). Not available for CSV.
+     */
+    password?: string;
+    /** Advanced encryption settings for a password save (scheme, key size, spin count). */
+    encryption?: EncryptionOptions;
+}
 /**
  * Serializes a workbook. `'xlsx'` writes the whole workbook as an OOXML package (an .xls or CSV
- * source is converted: the result is always .xlsx/.xlsm content); `'csv'` writes one sheet
- * (`sheetIndex`, default the active sheet) as UTF-8 CSV with a byte-order mark, as Excel's
- * "CSV UTF-8" does.
+ * source is converted: the result is always .xlsx/.xlsm content), encrypted when `password` is
+ * given; `'csv'` writes one sheet (`sheetIndex`, default the active sheet) as UTF-8 CSV with a
+ * byte-order mark, as Excel's "CSV UTF-8" does. A number as the third argument is the
+ * `sheetIndex` (the original signature).
  */
-export declare function saveWorkbook(workbook: Workbook, format: 'xlsx' | 'csv', sheetIndex?: number): Promise<Uint8Array>;
+export declare function saveWorkbook(workbook: Workbook, format: 'xlsx' | 'csv', sheetIndexOrOptions?: number | SaveWorkbookOptions): Promise<Uint8Array>;
 //# sourceMappingURL=detect.d.ts.map

package/dist/xlsx/load/detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/xlsx/load/detect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAgD7D,gGAAgG;AAChG,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,QAAQ,CAAC,EAAE,MAAM,GACf,cAAc,CAShB;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAOpD;AAED,MAAM,WAAW,mBAAmB;IACnC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,wBAAsB,YAAY,CACjC,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,OAAO,GAAE,mBAAwB,GAC/B,OAAO,CAAC,QAAQ,CAAC,CAanB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GAAG,KAAK,EACtB,UAAU,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAIrB"}
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/xlsx/load/detect.ts"],"names":[],"mappings":"AAKA,OAAO,EAIN,KAAK,iBAAiB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ5C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;AAgDpF,gGAAgG;AAChG,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,QAAQ,CAAC,EAAE,MAAM,GACf,cAAc,CAWhB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED,MAAM,WAAW,mBAAmB;IACnC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAmBD,mGAAmG;AACnG,wBAAsB,YAAY,CACjC,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,OAAO,GAAE,mBAAwB,GAC/B,OAAO,CAAC,QAAQ,CAAC,CAqBnB;AAED,MAAM,WAAW,mBAAmB;IACnC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GAAG,KAAK,EACtB,mBAAmB,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAChD,OAAO,CAAC,UAAU,CAAC,CAerB"}

package/dist/xlsx/load/errors.d.ts

@@ -0,0 +1,10 @@
+export { DataIntegrityError, IncorrectPasswordError, PasswordRequiredError, isOoxmlCryptoError, type OoxmlCryptoErrorCode, } from '../../crypto/errors.js';
+export type UnsupportedWorkbookErrorCode = 'xlsb-unsupported';
+/** The file is a spreadsheet format this library recognises but does not open. */
+export declare class UnsupportedWorkbookError extends Error {
+    readonly code: UnsupportedWorkbookErrorCode;
+    constructor(code: UnsupportedWorkbookErrorCode, message: string);
+}
+/** The .xlsb error: Excel Binary Workbook parts are BIFF12 records, not SpreadsheetML. */
+export declare const xlsbUnsupported: () => UnsupportedWorkbookError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/xlsx/load/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/xlsx/load/errors.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,oBAAoB,GACzB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,4BAA4B,GAAG,kBAAkB,CAAC;AAE9D,kFAAkF;AAClF,qBAAa,wBAAyB,SAAQ,KAAK;IAClD,SAAgB,IAAI,EAAE,4BAA4B,CAAC;gBAEhC,IAAI,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM;CAKtE;AAED,0FAA0F;AAC1F,eAAO,MAAM,eAAe,QAAO,wBAIjC,CAAC"}