ooxml-core 0.2.0 → 0.4.0

package/dist/xlsx/edit/range-math.d.ts

@@ -0,0 +1,33 @@
+import { type CellAddress, type CellRange } from '../address.js';
+export type Axis = 'row' | 'col';
+/** An axis shift: `count` positive inserts before index `at`, negative deletes `-count` from `at`. */
+export interface AxisShift {
+    axis: Axis;
+    at: number;
+    count: number;
+}
+/**
+ * Shifts a one-dimensional inclusive span. Inserting at the start moves the span; inserting inside
+ * it widens it. Deleting trims it; a span deleted entirely returns undefined.
+ */
+export declare function shiftSpan(start: number, end: number, shift: AxisShift): {
+    start: number;
+    end: number;
+} | undefined;
+/** Shifts one index; undefined when it was deleted (or pushed off the grid). */
+export declare function shiftIndex(index: number, shift: AxisShift): number | undefined;
+/** Shifts an index, clamping deleted positions to the start of the deleted band (drawing anchors). */
+export declare function shiftIndexClamped(index: number, shift: AxisShift): number;
+export declare function shiftRange(range: CellRange, shift: AxisShift): CellRange | undefined;
+export declare function shiftAddress(address: CellAddress, shift: AxisShift): CellAddress | undefined;
+/**
+ * Shifts a range inside a band (only the cells between `lo` and `hi` on the other axis move, as an
+ * insert-cells or delete-cells shift does). Ranges straddling the band edge stay where they are.
+ */
+export declare function shiftRangeInBand(range: CellRange, shift: AxisShift, lo: number, hi: number): CellRange | undefined;
+/** `a` minus `b`: up to four rectangles covering what of `a` lies outside `b`. */
+export declare function subtractRange(a: CellRange, b: CellRange): CellRange[];
+export declare const sameRange: (a: CellRange, b: CellRange) => boolean;
+export declare const rangeWithin: (inner: CellRange, outer: CellRange) => boolean;
+export declare const cellRange: (row: number, col: number, row2?: number, col2?: number) => CellRange;
+//# sourceMappingURL=range-math.d.ts.map

package/dist/xlsx/edit/range-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-math.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/range-math.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAmB,MAAM,eAAe,CAAC;AAEpG,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;AAEjC,sGAAsG;AACtG,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACd;AAID;;;GAGG;AACH,wBAAgB,SAAS,CACxB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAkB5C;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAK9E;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAIzE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAiBpF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAI5F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACR,SAAS,GAAG,SAAS,CAKvB;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAcrE;AAED,eAAO,MAAM,SAAS,GAAI,GAAG,SAAS,EAAE,GAAG,SAAS,KAAG,OAI/B,CAAC;AAEzB,eAAO,MAAM,WAAW,GAAI,OAAO,SAAS,EAAE,OAAO,SAAS,KAAG,OAIlC,CAAC;AAEhC,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,aAAU,EAAE,aAAU,KAAG,SAG3E,CAAC"}

package/dist/xlsx/edit/row-autofit.d.ts

@@ -0,0 +1,17 @@
+import { type CellRange } from '../address.js';
+import type { MeasureText } from '../layout/autofit.js';
+import type { Worksheet } from '../model.js';
+import { type EditContext } from './context.js';
+/**
+ * Re-fits rows that have no custom height after an edit changed their text, wrapping or font
+ * size, as Excel grows (and shrinks back) such rows automatically. Rows with a custom height or
+ * hidden rows are left alone. Nothing happens when no height changes; otherwise the change is
+ * recorded as its own undo entry, which joins the surrounding step when called inside an edit or
+ * a batch (call it from inside `ctx.run` so the edit and the row heights undo together). Returns
+ * the rows whose height changed. Without `measure`, text width is approximated from the font
+ * size, so wrapped line counts are estimates.
+ */
+export declare function autoGrowRows(ctx: EditContext, s: number, rows: Iterable<number>, measure?: MeasureText): number[];
+/** The rows of `ranges` that hold cells or a non-custom height (candidates for re-fitting). */
+export declare function rowsToRefit(sheet: Worksheet, ranges: readonly CellRange[]): number[];
+//# sourceMappingURL=row-autofit.d.ts.map

package/dist/xlsx/edit/row-autofit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-autofit.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/row-autofit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAkB,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,cAAc,CAAC;AAKzD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC3B,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EACtB,OAAO,GAAE,WAAgC,GACvC,MAAM,EAAE,CA8BV;AAKD,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,EAAE,CAepF"}

package/dist/xlsx/edit/session-calc.d.ts

@@ -0,0 +1,24 @@
+import type { Workbook } from '../model.js';
+import type { CalcEngine } from './deps.js';
+import { type HistoryStep } from './history.js';
+export declare class SessionCalculator {
+    private readonly workbook;
+    private readonly calc;
+    /** False when the session was created with `recalc: false`. */
+    readonly enabled: boolean;
+    /** Structural edits made in manual mode leave the dependency graph stale until a full pass. */
+    private staleGraph;
+    constructor(workbook: Workbook, calc: CalcEngine, 
+    /** False when the session was created with `recalc: false`. */
+    enabled: boolean);
+    /** Recalculates after an applied, undone or redone step (failures become warnings). */
+    afterStep(step: HistoryStep): void;
+    /** Rebuilds the dependency graph and recalculates every formula (F9). */
+    full(): void;
+    /**
+     * Recalculates one sheet's formulas and their dependents (Shift+F9); after structural edits
+     * in manual mode the graph is stale, so the whole workbook is recalculated instead.
+     */
+    sheet(s: number): void;
+}
+//# sourceMappingURL=session-calc.d.ts.map

package/dist/xlsx/edit/session-calc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-calc.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/session-calc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,cAAc,CAAC;AAK9D,qBAAa,iBAAiB;IAK5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,OAAO;IAP1B,+FAA+F;IAC/F,OAAO,CAAC,UAAU,CAAS;gBAGT,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,UAAU;IACjC,+DAA+D;IACtD,OAAO,EAAE,OAAO;IAG1B,uFAAuF;IACvF,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAkBlC,yEAAyE;IACzE,IAAI,IAAI,IAAI;IAMZ;;;OAGG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;CAatB"}

package/dist/xlsx/edit/session.d.ts

@@ -0,0 +1,5 @@
+import type { Workbook } from '../model.js';
+import type { EditSession, EditSessionOptions } from './types.js';
+/** Wraps a workbook in an undoable editing session. */
+export declare function createEditSession(workbook: Workbook, options?: EditSessionOptions): EditSession;
+//# sourceMappingURL=session.d.ts.map

package/dist/xlsx/edit/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAqC5C,OAAO,KAAK,EACX,WAAW,EACX,kBAAkB,EAGlB,MAAM,YAAY,CAAC;AAWpB,uDAAuD;AACvD,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,kBAAuB,GAC9B,WAAW,CA0Ob"}

package/dist/xlsx/edit/sheets.d.ts

@@ -0,0 +1,19 @@
+import type { Color, SheetState } from '../model.js';
+import { type EditContext } from './context.js';
+/** Adds an empty sheet (appended by default), makes it active and returns its index. */
+export declare function addSheet(ctx: EditContext, name?: string, at?: number): number;
+/**
+ * Deletes a sheet. Its sheet-scoped names go with it; references to it (and to its tables) in
+ * formulas, defined names, conditional formats, validations, chart series and hyperlink
+ * locations elsewhere become `#REF!`, as in Excel.
+ */
+export declare function deleteSheet(ctx: EditContext, index: number): void;
+/** Renames a sheet and every formula, name, chart and link reference to it. */
+export declare function renameSheet(ctx: EditContext, index: number, name: string): void;
+/** Moves the sheet at `from` so it ends up at index `to`. */
+export declare function moveSheet(ctx: EditContext, from: number, to: number): void;
+/** Copies a sheet next to the original (named `Name (2)`) and returns the copy's index. */
+export declare function duplicateSheet(ctx: EditContext, index: number): number;
+export declare function setSheetState(ctx: EditContext, index: number, state: SheetState): void;
+export declare function setTabColor(ctx: EditContext, index: number, color?: Color): void;
+//# sourceMappingURL=sheets.d.ts.map

package/dist/xlsx/edit/sheets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheets.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/sheets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAmB,MAAM,aAAa,CAAC;AAQtE,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,cAAc,CAAC;AA4BzD,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAmB7E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAwBjE;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAkB/E;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAuB1E;AAqBD,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA0CtE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAoBtF;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAYhF"}

package/dist/xlsx/edit/shift-formulas.d.ts

@@ -0,0 +1,14 @@
+import type { Workbook, Worksheet } from '../model.js';
+/** Rewrites one formula; `formulaSheet` is the sheet unqualified references point at. */
+export type FormulaRewrite = (formula: string, formulaSheet: string) => string;
+/**
+ * Visits every formula the workbook keeps: cell formulas, conditional-format and validation
+ * formulas, defined names, chart series references and in-workbook hyperlink locations.
+ */
+export declare function rewriteFormulas(workbook: Workbook, rewrite: FormulaRewrite): void;
+/**
+ * The per-sheet part of {@link rewriteFormulas}: cell, conditional-format, validation, table
+ * column (calculated and totals) formulas, hyperlink locations and chart series references.
+ */
+export declare function rewriteSheetFormulas(sheet: Worksheet, rewrite: FormulaRewrite): void;
+//# sourceMappingURL=shift-formulas.d.ts.map

package/dist/xlsx/edit/shift-formulas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shift-formulas.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/shift-formulas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExE,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;AAuB/E;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAOjF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CA4BpF"}

package/dist/xlsx/edit/shift-sheet.d.ts

@@ -0,0 +1,15 @@
+import type { Worksheet } from '../model.js';
+import { type AxisShift } from './range-math.js';
+/** Limits a shift to the cells between `lo` and `hi` on the other axis (insert/delete cells). */
+export interface Band {
+    lo: number;
+    hi: number;
+}
+/**
+ * Moves everything positioned on a sheet for a row or column insert/delete: cells, merges,
+ * conditional-format and validation ranges, hyperlinks, comments, tables, drawing anchors, row and
+ * column formats, the auto-filter, the freeze pane and the print area. Formulas are rewritten
+ * separately (they live on every sheet).
+ */
+export declare function shiftSheetContent(sheet: Worksheet, shift: AxisShift, band?: Band): void;
+//# sourceMappingURL=shift-sheet.d.ts.map

package/dist/xlsx/edit/shift-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shift-sheet.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/shift-sheet.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA2C,SAAS,EAAE,MAAM,aAAa,CAAC;AAEtF,OAAO,EACN,KAAK,SAAS,EAMd,MAAM,iBAAiB,CAAC;AAEzB,iGAAiG;AACjG,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CA6CvF"}

package/dist/xlsx/edit/sort.d.ts

@@ -0,0 +1,17 @@
+import { type CellRange } from '../address.js';
+import type { CellValue, Worksheet } from '../model.js';
+import { type EditContext } from './context.js';
+export interface SortKey {
+    col: number;
+    descending?: boolean;
+}
+/**
+ * Compares two cell values as Excel's sort does. Blanks always sort last, whatever the direction;
+ * text compares case-insensitively.
+ */
+export declare function compareCellValues(a: CellValue, b: CellValue, descending?: boolean): number;
+/** Sorts rows of a range in place (no undo step). Exported for the auto-filter sort. */
+export declare function sortRows(sheet: Worksheet, range: CellRange, keys: SortKey[], hasHeader: boolean): void;
+/** Sorts the rows of `range` by `keys` (absolute column indices), stable, header kept in place. */
+export declare function sortRange(ctx: EditContext, s: number, range: CellRange, keys: SortKey[], hasHeader: boolean): void;
+//# sourceMappingURL=sort.d.ts.map

package/dist/xlsx/edit/sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/sort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAmC,MAAM,eAAe,CAAC;AAEhF,OAAO,KAAK,EAAQ,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,cAAc,CAAC;AAIzD,MAAM,WAAW,OAAO;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAeD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,UAAQ,GAAG,MAAM,CAaxF;AAED,wFAAwF;AACxF,wBAAgB,QAAQ,CACvB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,OAAO,EAAE,EACf,SAAS,EAAE,OAAO,GAChB,IAAI,CAiDN;AAsBD,mGAAmG;AACnG,wBAAgB,SAAS,CACxB,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,OAAO,EAAE,EACf,SAAS,EAAE,OAAO,GAChB,IAAI,CAUN"}

package/dist/xlsx/edit/structure.d.ts

@@ -0,0 +1,10 @@
+import type { Worksheet } from '../model.js';
+import { type EditContext } from './context.js';
+import type { AxisShift } from './range-math.js';
+/** Applies an axis shift to a sheet and every formula in the workbook (no undo step). */
+export declare function applyAxisShift(ctx: EditContext, sheet: Worksheet, shift: AxisShift): void;
+export declare const insertRows: (ctx: EditContext, s: number, at: number, count: number) => void;
+export declare const deleteRows: (ctx: EditContext, s: number, at: number, count: number) => void;
+export declare const insertColumns: (ctx: EditContext, s: number, at: number, count: number) => void;
+export declare const deleteColumns: (ctx: EditContext, s: number, at: number, count: number) => void;
+//# sourceMappingURL=structure.d.ts.map

package/dist/xlsx/edit/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/structure.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EAAQ,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAUvD,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAMzF;AA+CD,eAAO,MAAM,UAAU,GAAI,KAAK,WAAW,EAAE,GAAG,MAAM,EAAE,IAAI,MAAM,EAAE,OAAO,MAAM,KAAG,IAC1C,CAAC;AAC3C,eAAO,MAAM,UAAU,GAAI,KAAK,WAAW,EAAE,GAAG,MAAM,EAAE,IAAI,MAAM,EAAE,OAAO,MAAM,KAAG,IACzC,CAAC;AAC5C,eAAO,MAAM,aAAa,GAAI,KAAK,WAAW,EAAE,GAAG,MAAM,EAAE,IAAI,MAAM,EAAE,OAAO,MAAM,KAAG,IAC7C,CAAC;AAC3C,eAAO,MAAM,aAAa,GAAI,KAAK,WAAW,EAAE,GAAG,MAAM,EAAE,IAAI,MAAM,EAAE,OAAO,MAAM,KAAG,IAC5C,CAAC"}

package/dist/xlsx/edit/table-edits.d.ts

@@ -0,0 +1,25 @@
+import { type CellRange } from '../address.js';
+import type { Table, Workbook, Worksheet } from '../model.js';
+import { type EditContext } from './context.js';
+/** A table by index in `sheet.tables` or by name (case-insensitive). */
+export type TableRef = number | string;
+/** What `updateTable` may change. */
+export type TablePatch = Partial<Omit<Table, 'id' | 'partName'>>;
+export declare function tableIndex(sheet: Worksheet, ref: TableRef): number;
+/** Why `name` cannot name a table in this workbook (ignoring `self`), or undefined. */
+export declare function validateTableName(workbook: Workbook, name: string, self?: Table): string | undefined;
+/** Renames a table and every structured reference to it (no undo step). */
+export declare function renameTableIn(workbook: Workbook, table: Table, name: string): void;
+/**
+ * Updates a table: style and stripe options, name (structured references follow), header and
+ * totals rows (cells are added or cleared like Excel), columns and range.
+ */
+export declare function updateTable(ctx: EditContext, s: number, ref: TableRef, patch: TablePatch): void;
+/** Resizes a table to `range` (Table Design > Resize Table). */
+export declare function resizeTable(ctx: EditContext, s: number, ref: TableRef, range: CellRange): void;
+/**
+ * Turns a table back into a plain range: its cells stay, structured references to it become
+ * absolute A1 references everywhere, and the table (with its auto-filter) goes.
+ */
+export declare function convertTableToRange(ctx: EditContext, s: number, ref: TableRef): void;
+//# sourceMappingURL=table-edits.d.ts.map

package/dist/xlsx/edit/table-edits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-edits.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/table-edits.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAmC,MAAM,eAAe,CAAC;AAIhF,OAAO,KAAK,EAAE,KAAK,EAAe,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG3E,OAAO,EAAE,KAAK,WAAW,EAAwB,MAAM,cAAc,CAAC;AAOtE,wEAAwE;AACxE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,qCAAqC;AACrC,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC;AAEjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,GAAG,MAAM,CAOlE;AAID,uFAAuF;AACvF,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,KAAK,GACV,MAAM,GAAG,SAAS,CAWpB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAYlF;AAwHD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAsC/F;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAU9F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAyCpF"}

package/dist/xlsx/edit/table-rows.d.ts

@@ -0,0 +1,11 @@
+import type { Table, Worksheet } from '../model.js';
+/** Whether a row holds no values or formulas between two columns. */
+export declare function rowIsEmpty(sheet: Worksheet, row: number, lo: number, hi: number): boolean;
+/** Clears the contents of a row between two columns (formats stay). */
+export declare function clearRow(sheet: Worksheet, row: number, lo: number, hi: number): void;
+/**
+ * Fills the totals row from the columns' `totalsRowLabel` / `totalsRowFunction`. When no column
+ * has either yet, Excel's default applies: `Total` in the first column and a sum in the last.
+ */
+export declare function applyTotalsRow(sheet: Worksheet, table: Table): void;
+//# sourceMappingURL=table-rows.d.ts.map

package/dist/xlsx/edit/table-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-rows.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/table-rows.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIpD,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAWzF;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAOpF;AAeD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAmBnE"}

package/dist/xlsx/edit/tables.d.ts

@@ -0,0 +1,11 @@
+import { type CellRange } from '../address.js';
+import type { Table } from '../model.js';
+import { type EditContext } from './context.js';
+/** Unique header names: blanks become `ColumnN`, repeats get a number suffix (`Name2`). */
+export declare function uniqueHeaders(texts: string[]): string[];
+/**
+ * Turns a range into a table (a single cell expands to its current region). Without a header
+ * row, cells are shifted down one row and a `Column1`, `Column2`, ... header is inserted.
+ */
+export declare function createTable(ctx: EditContext, s: number, range: CellRange, hasHeader: boolean, styleName?: string): Table;
+//# sourceMappingURL=tables.d.ts.map

package/dist/xlsx/edit/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAmC,MAAM,eAAe,CAAC;AAEhF,OAAO,KAAK,EAAE,KAAK,EAAyB,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAE,KAAK,WAAW,EAAwB,MAAM,cAAc,CAAC;AAYtE,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAiBvD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,OAAO,EAClB,SAAS,SAAsB,GAC7B,KAAK,CAyDP"}

package/dist/xlsx/edit/test-context.d.ts

@@ -0,0 +1,15 @@
+import type { Workbook } from '../model.js';
+import type { EditContext } from './context.js';
+import { type HistoryEntry } from './history.js';
+import type { WorkbookChangeKind } from './types.js';
+export interface TestContext extends EditContext {
+    readonly steps: {
+        label: string;
+        kind: WorkbookChangeKind;
+        entries: HistoryEntry[];
+    }[];
+    /** Restores the last step's snapshots. */
+    undo(): void;
+}
+export declare function testContext(workbook: Workbook): TestContext;
+//# sourceMappingURL=test-context.d.ts.map

package/dist/xlsx/edit/test-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-context.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/test-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAgB,KAAK,YAAY,EAAmB,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,QAAQ,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,kBAAkB,CAAC;QAAC,OAAO,EAAE,YAAY,EAAE,CAAA;KAAE,EAAE,CAAC;IACvF,0CAA0C;IAC1C,IAAI,IAAI,IAAI,CAAC;CACb;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAyB3D"}

package/dist/xlsx/edit/types-clipboard.d.ts

@@ -0,0 +1,66 @@
+import type { CellRange } from '../address.js';
+import type { CellStyle, CellValue, RichTextRun } from '../model.js';
+/** One copied cell, self-contained so it can be pasted into another workbook. */
+export interface ClipboardCell {
+    value: CellValue;
+    formula?: string;
+    /** The resolved format (not an index), so it survives a paste into another workbook. */
+    style?: CellStyle;
+    richText?: RichTextRun[];
+    /** Number format implied by pasted text (`15%`), applied when the target is `General`. */
+    numFmt?: string;
+    /** Display text as the grid shows it. */
+    text: string;
+    /** The formula uses pre-dynamic-array semantics (see `Cell.legacyFormula`). */
+    legacyFormula?: true;
+    /**
+     * A dynamic-array result whose anchor formula is part of the same copy: pasting formulas
+     * recreates it from the anchor, so only `values` pastes write it.
+     */
+    spilled?: true;
+}
+export interface ClipboardCells {
+    rows: number;
+    cols: number;
+    /** `data[r][c]`; `null` for an empty cell. */
+    data: (ClipboardCell | null)[][];
+    /** Merged areas, relative to the top-left of the copied block. */
+    merges: CellRange[];
+    /** Where the cells were copied from, when they came from a session. */
+    source?: {
+        sheet: number;
+        range: CellRange;
+    };
+}
+/** What `copy` returns: text for the system clipboard plus the cells for an internal paste. */
+export interface ClipboardPayload {
+    tsv: string;
+    html: string;
+    cells: ClipboardCells;
+    /** Set by `cut`; the first paste clears the source and then resets this flag. */
+    cut?: boolean;
+}
+export interface FindQuery {
+    text: string;
+    /** Sheet to search; all sheets when absent. */
+    sheet?: number;
+    /** Limit the search to a range (only with `sheet`). */
+    range?: CellRange;
+    matchCase?: boolean;
+    /** The whole cell content must match. */
+    wholeCell?: boolean;
+    /** `formulas` searches what was typed (formula text, raw constants); `values` the display text. */
+    lookIn?: 'formulas' | 'values' | 'comments';
+    /** Excel wildcards: `*` any run, `?` one character, `~` escapes. Default true. */
+    wildcards?: boolean;
+    /** Search order; rows by default. */
+    order?: 'rows' | 'columns';
+}
+export interface FindMatch {
+    sheet: number;
+    row: number;
+    col: number;
+    /** The text that was searched in this cell. */
+    text: string;
+}
+//# sourceMappingURL=types-clipboard.d.ts.map

package/dist/xlsx/edit/types-clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-clipboard.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/types-clipboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErE,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,CAAC,aAAa,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IACjC,kEAAkE;IAClE,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,uEAAuE;IACvE,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC;CAC7C;AAED,+FAA+F;AAC/F,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,iFAAiF;IACjF,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mGAAmG;IACnG,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC5C,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CACb"}

package/dist/xlsx/edit/types.d.ts

@@ -0,0 +1,188 @@
+import type { CellAddress, CellRange } from '../address.js';
+import type { BorderEdge, CellStyle, CellValue, ChartObject, Color, ConditionalFormat, ImageObject, DataValidation, DefinedName, DrawingAnchor, FreezePane, Hyperlink, PageSetup, PrintOptions, SheetProtection, SheetState, SheetView, Table, Workbook } from '../model.js';
+import type { FontView } from '../layout/types.js';
+import type { StylePatch } from '../styles.js';
+import type { CalcEngine } from './deps.js';
+import type { ChartPatch } from './charts.js';
+import type { TablePatch, TableRef } from './table-edits.js';
+/** Border presets of the ribbon's border drop-down. */
+export type BorderPreset = 'all' | 'outside' | 'thickOutside' | 'none' | 'top' | 'bottom' | 'left' | 'right' | 'inside' | 'insideH' | 'insideV' | 'thickBottom' | 'doubleBottom' | 'topAndBottom';
+/** What `clearRange` removes. */
+export type ClearWhat = 'all' | 'contents' | 'formats' | 'comments' | 'hyperlinks';
+export type PasteMode = 'all' | 'values' | 'formats' | 'formulas' | 'transpose';
+export type MergeMode = 'merge' | 'center' | 'across';
+export type { ClipboardCell, ClipboardCells, ClipboardPayload, FindMatch, FindQuery, } from './types-clipboard.js';
+import type { ClipboardPayload, FindMatch, FindQuery } from './types-clipboard.js';
+export type WorkbookChangeKind = 'cells' | 'format' | 'structure' | 'sheets' | 'annotations' | 'view' | 'names' | 'batch' | 'undo' | 'redo';
+export interface WorkbookChange {
+    kind: WorkbookChangeKind;
+    /** Undo label of the edit. */
+    label: string;
+    /** The sheet the edit touched, when it touched one. */
+    sheet?: number;
+    ranges?: CellRange[];
+    /** Rows, columns or sheets moved: views must rebuild metrics, not only repaint cells. */
+    structural: boolean;
+}
+export interface ValidationFailure {
+    ok: false;
+    style: 'stop' | 'warning' | 'information';
+    title?: string;
+    message: string;
+}
+export type ValidationResult = {
+    ok: true;
+} | ValidationFailure;
+export interface EditSessionOptions {
+    /** Recalculate formulas after every edit (default true). */
+    recalc?: boolean;
+    /** Undo depth (default 100). */
+    historyLimit?: number;
+    /** Base of new sheet names (`Sheet` gives `Sheet2`, ...), for localized UIs. */
+    defaultSheetBase?: string;
+    /**
+     * Re-fit rows without a custom height after edits that change cell text or formats, as Excel
+     * grows and shrinks such rows (default true). The re-fit undoes together with the edit.
+     */
+    autoRowHeight?: boolean;
+    /** Text measurement for the row re-fit, in CSS px (default: an estimate from the font size). */
+    measureText?: (text: string, font: FontView) => number;
+}
+/** The editing API every UI drives. Each method is one undo step; `batch` groups several. */
+export interface EditSession {
+    readonly workbook: Workbook;
+    readonly calc: CalcEngine;
+    setCellInput(sheet: number, row: number, col: number, text: string): void;
+    setCellValue(sheet: number, row: number, col: number, value: CellValue): void;
+    setRangeValues(sheet: number, at: CellAddress, values: CellValue[][]): void;
+    clearRange(sheet: number, range: CellRange, what: ClearWhat): void;
+    applyStyle(sheet: number, ranges: CellRange[], patch: StylePatch): void;
+    setBorders(sheet: number, range: CellRange, preset: BorderPreset, edge?: BorderEdge): void;
+    insertRows(sheet: number, at: number, count: number): void;
+    deleteRows(sheet: number, at: number, count: number): void;
+    insertColumns(sheet: number, at: number, count: number): void;
+    deleteColumns(sheet: number, at: number, count: number): void;
+    insertCellsShift(sheet: number, range: CellRange, direction: 'down' | 'right'): void;
+    deleteCellsShift(sheet: number, range: CellRange, direction: 'up' | 'left'): void;
+    setColumnWidth(sheet: number, cols: number[], width: number | 'auto', measure?: (text: string, style: CellStyle) => number): void;
+    setRowHeight(sheet: number, rows: number[], height: number | 'auto'): void;
+    setHidden(sheet: number, axis: 'row' | 'col', indices: number[], hidden: boolean): void;
+    merge(sheet: number, range: CellRange, mode: MergeMode): void;
+    unmerge(sheet: number, range: CellRange): void;
+    sort(sheet: number, range: CellRange, keys: {
+        col: number;
+        descending?: boolean;
+    }[], hasHeader: boolean): void;
+    fill(sheet: number, source: CellRange, target: CellRange): void;
+    copy(sheet: number, range: CellRange): ClipboardPayload;
+    cut(sheet: number, range: CellRange): ClipboardPayload;
+    paste(sheet: number, at: CellAddress, payload: ClipboardPayload | string, mode?: PasteMode): CellRange;
+    findAll(query: FindQuery): FindMatch[];
+    replaceAll(query: FindQuery, replacement: string): number;
+    /** Replaces the query in one matched cell; false when the cell no longer matches. */
+    replaceOne(query: FindQuery, replacement: string, at: FindMatch): boolean;
+    addSheet(name?: string, at?: number): number;
+    deleteSheet(index: number): void;
+    renameSheet(index: number, name: string): void;
+    moveSheet(from: number, to: number): void;
+    duplicateSheet(index: number): number;
+    setSheetState(index: number, state: SheetState): void;
+    setTabColor(index: number, color?: Color): void;
+    setFreeze(sheet: number, freeze: FreezePane | undefined): void;
+    setComment(sheet: number, at: CellAddress, text: string | undefined, author: string): void;
+    setHyperlink(sheet: number, range: CellRange, link: Omit<Hyperlink, 'range'> | undefined): void;
+    addConditionalFormat(sheet: number, format: ConditionalFormat): void;
+    clearConditionalFormats(sheet: number, range?: CellRange): void;
+    setDataValidation(sheet: number, validation: DataValidation | undefined, range: CellRange): void;
+    setAutoFilter(sheet: number, range: CellRange | undefined): void;
+    /** Filters an auto-filter column to display texts in `values` (`''` keeps blanks); undefined clears. */
+    filterColumn(sheet: number, col: number, values: string[] | undefined): void;
+    /** Sorts the auto-filter (or table) containing `col` by that column, keeping the header. */
+    sortByColumn(sheet: number, col: number, descending?: boolean): void;
+    createTable(sheet: number, range: CellRange, hasHeader: boolean, styleName?: string): Table;
+    setSheetView(sheet: number, patch: Partial<SheetView>): void;
+    setDefinedName(name: DefinedName): void;
+    deleteDefinedName(name: string, localSheet?: number): void;
+    /** Moves or resizes the picture, chart or shape at `index` of the sheet's drawings. */
+    setDrawingAnchor(sheet: number, index: number, anchor: DrawingAnchor): void;
+    /** Deletes the picture, chart or shape at `index` of the sheet's drawings. */
+    deleteDrawing(sheet: number, index: number): void;
+    /** Adds a chart drawn from the model; returns its index in the sheet's drawings. */
+    addChart(sheet: number, chart: Omit<ChartObject, 'kind'>): number;
+    /** Edits the chart at `index` of the sheet's drawings (a loaded chart part is patched on save). */
+    updateChart(sheet: number, index: number, patch: ChartPatch): void;
+    /** Inserts a picture (bytes stored as a new media part) and returns it. */
+    addImage(sheet: number, bytes: Uint8Array, contentType: string, anchor: DrawingAnchor, name?: string): ImageObject;
+    /** Replaces the conditional format at `index` (Rules Manager > Edit Rule). */
+    replaceConditionalFormat(sheet: number, index: number, format: ConditionalFormat): void;
+    /** Removes the conditional format at `index` (Rules Manager > Delete Rule). */
+    removeConditionalFormat(sheet: number, index: number): void;
+    /** Gives a rule a new priority (1 is evaluated first); every rule is renumbered 1..n. */
+    setConditionalRulePriority(sheet: number, formatIndex: number, ruleIndex: number, priority: number): void;
+    /** Moves a rule one step up or down in the evaluation order. */
+    moveConditionalRule(sheet: number, formatIndex: number, ruleIndex: number, direction: 'up' | 'down'): void;
+    /**
+     * Updates a table (by index in `sheet.tables` or by name): style options, name (structured
+     * references follow), header and totals rows, columns and range.
+     */
+    updateTable(sheet: number, table: TableRef, patch: TablePatch): void;
+    /** Resizes a table; its header row must stay on the same row. */
+    resizeTable(sheet: number, table: TableRef, range: CellRange): void;
+    /** Converts a table to a plain range; structured references become absolute A1 references. */
+    convertTableToRange(sheet: number, table: TableRef): void;
+    /** Applies a named cell style (built-in such as `Good`, or one the workbook defines). */
+    applyCellStyle(sheet: number, ranges: CellRange[], name: string): void;
+    /** Patches the page setup; `undefined` entries clear a setting. */
+    setPageSetup(sheet: number, patch: {
+        [K in keyof PageSetup]?: PageSetup[K] | undefined;
+    }): void;
+    /** Patches the print options (gridlines, headings, centring); false clears one. */
+    setPrintOptions(sheet: number, patch: Partial<PrintOptions>): void;
+    /**
+     * Protects a sheet (`undefined` unprotects). A non-empty `password` stores its legacy hash,
+     * `''` removes it; unprotecting with a wrong password throws.
+     */
+    setSheetProtection(sheet: number, protection: SheetProtection | undefined, password?: string): void;
+    /** Locks or unlocks the workbook structure, optionally with a password (checked on unlock). */
+    setWorkbookProtection(locked: boolean, password?: string): void;
+    /** Raises the outline level of rows `from`..`to` (inclusive). */
+    groupRows(sheet: number, from: number, to: number): void;
+    ungroupRows(sheet: number, from: number, to: number): void;
+    /** Raises the outline level of columns `from`..`to` (inclusive). */
+    groupColumns(sheet: number, from: number, to: number): void;
+    ungroupColumns(sheet: number, from: number, to: number): void;
+    /** The sheet's standard column width in characters; undefined restores Excel's default. */
+    setDefaultColumnWidth(sheet: number, width: number | undefined): void;
+    /** Removes rows whose `columns` (absolute; empty = all) repeat an earlier row's display text. */
+    removeDuplicates(sheet: number, range: CellRange, columns: number[], hasHeader: boolean): {
+        removed: number;
+        remaining: number;
+    };
+    /** Automatic or manual calculation (saved with the workbook). */
+    setCalcMode(mode: 'auto' | 'manual'): void;
+    /** `setCalcMode(enabled ? 'auto' : 'manual')`. */
+    setAutoRecalc(enabled: boolean): void;
+    /**
+     * Whether edits recalculate: false when the session was created with `recalc: false` (which
+     * always wins) or the workbook is in manual calculation mode.
+     */
+    autoRecalc(): boolean;
+    /** Recalculates every formula (F9); not an undo step. */
+    calculateNow(): void;
+    /**
+     * Recalculates the formulas of one sheet and their dependents (Shift+F9). After structural
+     * edits made in manual mode the whole workbook is recalculated instead.
+     */
+    calculateSheet(sheet: number): void;
+    /** Validates `value` against the cell's data validation, using this session's calc engine. */
+    validate(sheet: number, row: number, col: number, value: CellValue): ValidationResult;
+    batch(label: string, fn: () => void): void;
+    undo(): boolean;
+    redo(): boolean;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    undoLabel(): string | undefined;
+    redoLabel(): string | undefined;
+    onChange(listener: (change: WorkbookChange) => void): () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/xlsx/edit/types.d.ts.map

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

package/dist/xlsx/edit/validation.d.ts

@@ -0,0 +1,21 @@
+import type { CellValue, DataValidation, Workbook } from '../model.js';
+import type { ValidationResult } from './types.js';
+export interface ValidationOptions {
+    /** Evaluates a validation formula at the cell (the session passes its calc engine). */
+    evaluate?: (formula: string, at: {
+        sheet: number;
+        row: number;
+        col: number;
+    }) => CellValue;
+}
+export declare const DEFAULT_VALIDATION_MESSAGE = "This value doesn't match the data validation restrictions defined for this cell.";
+/** The validation rule covering a cell, if any. */
+export declare function validationAt(workbook: Workbook, sheet: number, row: number, col: number): DataValidation | undefined;
+/** The drop-down entries of a list validation on a cell, or undefined when it has none. */
+export declare function listValidationOptions(workbook: Workbook, sheet: number, row: number, col: number, options?: ValidationOptions): string[] | undefined;
+/**
+ * Checks a value against the data validation of a cell. Blank values pass unless `allowBlank`
+ * is explicitly false; rules whose error alert is turned off never reject.
+ */
+export declare function validateCellInput(workbook: Workbook, sheet: number, row: number, col: number, value: CellValue, options?: ValidationOptions): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/xlsx/edit/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAuB,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IACjC,uFAAuF;IACvF,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAC;CAC3F;AAED,eAAO,MAAM,0BAA0B,qFAC4C,CAAC;AAcpF,mDAAmD;AACnD,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACT,cAAc,GAAG,SAAS,CAI5B;AAkGD,2FAA2F;AAC3F,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iBAAsB,GAC7B,MAAM,EAAE,GAAG,SAAS,CAStB;AAgCD;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,iBAAsB,GAC7B,gBAAgB,CAMlB"}

package/dist/xlsx/edit/view.d.ts

@@ -0,0 +1,12 @@
+import type { DefinedName, FreezePane, SheetView } from '../model.js';
+import { type EditContext } from './context.js';
+/** Freezes the top `rows` and left `cols` (both zero, or undefined, unfreezes). */
+export declare function setFreeze(ctx: EditContext, s: number, freeze: FreezePane | undefined): void;
+/** Patches the sheet view (zoom, gridlines, headers, selection, ...). */
+export declare function setSheetView(ctx: EditContext, s: number, patch: Partial<SheetView>): void;
+/** Why a defined name is not acceptable, or undefined when it is. */
+export declare function validateDefinedName(name: string): string | undefined;
+/** Adds or replaces a defined name (matched by name, case-insensitively, and scope). */
+export declare function setDefinedName(ctx: EditContext, name: DefinedName): void;
+export declare function deleteDefinedName(ctx: EditContext, name: string, localSheet?: number): void;
+//# sourceMappingURL=view.d.ts.map