@pixerate/editor 0.19.0 → 0.20.0

package/dist/controller-OUdxPY-X.d.cts

@@ -0,0 +1,754 @@
+type CellFormat = 'text' | 'number' | 'currency' | 'percentage' | 'date' | 'badge' | 'status' | 'assignee';
+type ColumnType = 'bound' | 'freeform' | 'formula';
+interface ColumnBinding {
+    dataSource: string;
+    field: string;
+}
+interface SpreadsheetColumn {
+    id: string;
+    key: string;
+    title: string;
+    width?: number;
+    type: ColumnType;
+    binding?: ColumnBinding;
+    formula?: string;
+    format?: CellFormat;
+    readOnly?: boolean;
+    hidden?: boolean;
+}
+type RowType = 'record' | 'freeform';
+interface SpreadsheetRow {
+    id: string;
+    index: number;
+    height?: number;
+    recordId?: string;
+    type: RowType;
+    hidden?: boolean;
+}
+interface CellCoordinate {
+    row: number;
+    col: number;
+    rowId?: string;
+    colId?: string;
+}
+interface CellRange {
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+}
+interface CellData {
+    raw: string;
+    value: any;
+    error?: string;
+    /** Why the formula failed, e.g. `Argument 2 of SUMIF must be a range.` Set alongside `error`. */
+    errorMessage?: string;
+    format?: CellFormat;
+    readOnly?: boolean;
+}
+interface SpreadsheetDocument {
+    id: string;
+    name: string;
+    columns: SpreadsheetColumn[];
+    rows: SpreadsheetRow[];
+    cells: Record<string, Record<string, CellData>>;
+    createdAt?: number;
+    updatedAt?: number;
+    table?: SpreadsheetTableSettings;
+}
+type SortDirection = 'asc' | 'desc';
+interface SortKey {
+    colId: string;
+    direction?: SortDirection;
+}
+type FilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'greaterThan' | 'greaterThanOrEqual' | 'lessThan' | 'lessThanOrEqual' | 'between' | 'isBlank' | 'isNotBlank' | 'oneOf';
+interface FilterRule {
+    id: string;
+    colId: string;
+    operator: FilterOperator;
+    value?: string | number;
+    value2?: string | number;
+    values?: string[];
+}
+interface SpreadsheetFilterState {
+    enabled: boolean;
+    rules: FilterRule[];
+}
+type GroupAggregate = 'sum' | 'count' | 'average' | 'min' | 'max';
+interface GroupSummary {
+    colId: string;
+    aggregate: GroupAggregate;
+}
+interface SpreadsheetGrouping {
+    colId: string;
+    summaries: GroupSummary[];
+    collapsed: string[];
+}
+interface SpreadsheetTableSettings {
+    headerRowCount?: number;
+    footerRowCount?: number;
+    headerColumnCount?: number;
+    frozenRowCount?: number;
+    frozenColumnCount?: number;
+    merges?: CellRange[];
+    filter?: SpreadsheetFilterState;
+    grouping?: SpreadsheetGrouping;
+}
+interface SpreadsheetDataSourceField {
+    key: string;
+    label: string;
+    type: 'string' | 'number' | 'date' | 'boolean' | 'enum';
+    options?: Array<{
+        key: string;
+        label: string;
+        color?: string;
+    }>;
+}
+interface SpreadsheetDataSource {
+    id: string;
+    name: string;
+    getRecords(): Array<{
+        id: string;
+        [key: string]: any;
+    }>;
+    getFields(): SpreadsheetDataSourceField[];
+    updateRecord(recordId: string, field: string, value: any): Promise<void> | void;
+}
+
+type FormulaTokenType = 'NUMBER' | 'STRING' | 'BOOLEAN' | 'ERROR' | 'CELL_REF' | 'RANGE' | 'PROPERTY_REF' | 'IDENTIFIER' | 'OPERATOR' | 'LPAREN' | 'RPAREN' | 'COMMA' | 'EOF';
+interface FormulaToken {
+    type: FormulaTokenType;
+    value: string;
+    position: number;
+}
+declare function tokenizeFormula(formula: string): FormulaToken[];
+
+/** Row number used for the open end of whole-column ranges such as `A:A`. */
+declare const WHOLE_COLUMN_END_ROW = 1048576;
+type ASTNode = LiteralNode | CellRefNode | RangeNode | PropertyRefNode | BinaryOpNode | UnaryOpNode | FunctionCallNode;
+interface LiteralNode {
+    type: 'Literal';
+    value: number | string | boolean;
+}
+interface CellRefNode {
+    type: 'CellRef';
+    ref: string;
+    col: string;
+    row: number;
+}
+interface RangeNode {
+    type: 'Range';
+    raw: string;
+    startCol: string;
+    startRow: number;
+    endCol: string;
+    endRow: number;
+}
+interface PropertyRefNode {
+    type: 'PropertyRef';
+    property: string;
+}
+interface BinaryOpNode {
+    type: 'BinaryOp';
+    op: string;
+    left: ASTNode;
+    right: ASTNode;
+}
+interface UnaryOpNode {
+    type: 'UnaryOp';
+    op: string;
+    argument: ASTNode;
+}
+interface FunctionCallNode {
+    type: 'FunctionCall';
+    name: string;
+    args: ASTNode[];
+}
+declare function parseCellReference(ref: string): {
+    col: string;
+    row: number;
+};
+declare function parseRange(rangeStr: string): RangeNode;
+declare class FormulaParser {
+    private tokens;
+    private current;
+    constructor(tokens: FormulaToken[]);
+    parse(): ASTNode;
+    private expression;
+    private comparison;
+    private concatenation;
+    private addition;
+    private multiplication;
+    private exponentiation;
+    private unary;
+    private primary;
+    private match;
+    private matchOperator;
+    private check;
+    private advance;
+    private isAtEnd;
+    private peek;
+    private previous;
+    private consume;
+}
+declare function parseFormula(formula: string): ASTNode;
+
+/**
+ * Value helpers shared by the formula evaluator and the built-in functions:
+ * error values, spreadsheet coercion rules, comparisons, ranges and dates.
+ */
+/** Spreadsheet error values. They propagate through operators and functions. */
+declare const FORMULA_ERRORS: Set<string>;
+type FormulaErrorCode = '#DIV/0!' | '#VALUE!' | '#REF!' | '#NAME?' | '#N/A' | '#NUM!' | '#CYCLE!' | '#ERROR!';
+declare function isFormulaError(value: unknown): value is string;
+declare function colNameToIndex(col: string): number;
+declare function indexToColName(index: number): string;
+/**
+ * A rectangular block of values. `values` is column-major (the order in which
+ * `EvaluationContext.resolveRange` returns cells): `values[col * rows + row]`.
+ */
+interface FormulaRange {
+    rows: number;
+    cols: number;
+    values: any[];
+}
+
+interface EvaluationContext {
+    resolveCell?: (col: string, row: number) => any;
+    /**
+     * Values of a rectangular range, column by column (all rows of the first
+     * column, then the next column). Lookup functions rely on this order.
+     */
+    resolveRange?: (startCol: string, startRow: number, endCol: string, endRow: number) => any[];
+    resolveProperty?: (property: string) => any;
+}
+/** A human-readable reason for an error value. */
+interface FormulaDiagnostic {
+    code: FormulaErrorCode;
+    message: string;
+}
+interface FormulaEvaluationResult {
+    /** The computed value; an error code such as `#VALUE!` when the formula fails. */
+    value: any;
+    /** The error code when `value` is an error. */
+    error?: FormulaErrorCode;
+    /** Why the formula failed, e.g. `Argument 2 of SUMIF must be a range.` */
+    message?: string;
+}
+/** Generic explanation of an error code, used when no specific reason was recorded. */
+declare function describeFormulaError(code: string): string;
+declare class FormulaEvaluator {
+    private context;
+    private diagnostics;
+    constructor(context?: EvaluationContext);
+    /**
+     * Evaluates a formula. Errors in the formula are returned as error values
+     * (`#VALUE!` etc.); malformed formulas and missing resolvers throw.
+     */
+    evaluate(astOrFormula: ASTNode | string): any;
+    /**
+     * Evaluates a formula and explains errors. Never throws: malformed formulas
+     * return `#ERROR!` with the parser's message. A result that is a whole range
+     * (no dynamic-array spilling) is reduced to its first value.
+     */
+    evaluateWithDiagnostics(astOrFormula: ASTNode | string): FormulaEvaluationResult;
+    /** Records why an error happened and returns the error code. */
+    private fail;
+    private evaluateNode;
+    private evaluateRange;
+    private callFunction;
+    private createContext;
+}
+
+interface CellDep {
+    col: string;
+    row: number;
+}
+/**
+ * Dependency key for "every cell in column `col`", used by whole-column ranges
+ * (`A:A`) instead of expanding a million cell keys.
+ */
+declare const columnDependencyKey: (col: string) => string;
+declare function extractCellDependencies(node: ASTNode): CellDep[];
+declare class DependencyGraph {
+    private dependencies;
+    private dependents;
+    setCellFormula(cellKey: string, formulaStr: string | null): void;
+    /** Removes every registered formula and dependency. */
+    clear(): void;
+    getDependencies(cellKey: string): string[];
+    getDependents(cellKey: string): string[];
+    /**
+     * Detects if there is a cycle containing cellKey.
+     */
+    hasCycle(cellKey: string): boolean;
+    /**
+     * Returns cells affected by updating cellKey in topological order.
+     */
+    getEvaluationOrder(startCellKey: string): {
+        order: string[];
+        hasCycle: boolean;
+    };
+    /**
+     * Plans a recalculation over `cellKeys` (and, with `includeDependents`, every
+     * cell that transitively depends on them). Returns the keys in evaluation
+     * order (dependencies first) and the set of keys that are part of a cycle,
+     * which must be marked `#CYCLE!` instead of evaluated. Every member of a
+     * cycle is reported, not just the cell that closed it.
+     */
+    getEvaluationPlan(cellKeys: Iterable<string>, options?: {
+        includeDependents?: boolean;
+    }): {
+        order: string[];
+        cyclic: Set<string>;
+    };
+}
+
+/**
+ * A row or column insertion/deletion. `index` is the 0-based position of the
+ * inserted or deleted row/column.
+ */
+interface StructuralChange {
+    axis: 'row' | 'col';
+    index: number;
+    type: 'insert' | 'delete';
+}
+/**
+ * Rewrites the cell and range references in `formula` after a row or column
+ * is inserted or deleted, the way spreadsheet apps do: references after the
+ * change shift, ranges grow or shrink, and references to a deleted row/column
+ * become `#REF!`. Absolute (`$`) markers are kept. String literals, property
+ * references and function names are left untouched.
+ */
+declare function shiftFormulaReferences(formula: string, change: StructuralChange): string;
+/**
+ * Calls `rewrite` with the source text of every cell or range reference in
+ * `formula` (e.g. `"$A1"`, `"B2:C10"`, `"A:A"`) and splices in its result.
+ * String literals, property references and function names (e.g. `LOG10(`)
+ * are skipped. Formulas that fail to tokenize are returned unchanged.
+ */
+declare function mapFormulaReferences(formula: string, rewrite: (reference: string) => string): string;
+/**
+ * Moves a formula by (`rowOffset`, `colOffset`), as copy/paste and autofill
+ * do: relative row/column parts shift, `$`-absolute parts stay. A reference
+ * pushed above row 1 or left of column A becomes `#REF!`.
+ */
+declare function offsetFormulaReferences(formula: string, rowOffset: number, colOffset: number): string;
+/** A 0-based cell position. */
+interface CellPosition {
+    row: number;
+    col: number;
+}
+/**
+ * Rewrites references when cells *move* (sort, transpose): references follow
+ * the cell they point at, whether relative or absolute. `moveCell` returns a
+ * cell's new position, or null when it did not move. A range is remapped only
+ * when its cells moved together as a rectangle of the same size (e.g. a
+ * one-row range inside a sorted row, or a range inside a transposed block);
+ * otherwise it is kept, since it still covers the same rows and columns.
+ */
+declare function remapFormulaReferences(formula: string, moveCell: (position: CellPosition) => CellPosition | null): string;
+
+declare class DataSourceBinder {
+    private dataSources;
+    register(dataSource: SpreadsheetDataSource): void;
+    unregister(dataSourceId: string): void;
+    getDataSource(id: string): SpreadsheetDataSource | undefined;
+    /**
+     * Generates or reconciles spreadsheet rows from a primary data source.
+     */
+    syncRows(currentRows: SpreadsheetRow[], dataSourceId: string): SpreadsheetRow[];
+    /**
+     * Resolves a record's bound field value.
+     */
+    resolveBoundValue(dataSourceId: string, recordId: string, field: string): any;
+    /**
+     * Dispatches an update to the underlying data source.
+     */
+    commitBoundValue(dataSourceId: string, recordId: string, field: string, value: any): Promise<void>;
+}
+
+/**
+ * Spreadsheet clipboard formats. Copying writes three representations:
+ *
+ * - `text/plain`: TSV of the displayed values (pastes into any app)
+ * - `text/html`: an HTML `<table>` (pastes into docs, mail, other sheets)
+ * - `application/x.pixerate.spreadsheet+json`: raw inputs and formulas, so a
+ *   paste into a pixerate spreadsheet is lossless; formulas are re-based to
+ *   the paste position like a spreadsheet copy/paste
+ *
+ * Pasting prefers the custom format, then an HTML table, then TSV. All
+ * functions here are pure and DOM-free.
+ */
+
+declare const SPREADSHEET_CLIPBOARD_MIME = "application/x.pixerate.spreadsheet+json";
+interface SpreadsheetClipboardCell {
+    raw: string;
+    value: unknown;
+}
+interface SpreadsheetClipboardPayload {
+    type: 'pixerate-spreadsheet';
+    version: 1;
+    /** Position of the copied block's top-left cell, used to re-base formulas. */
+    origin: CellPosition;
+    cells: SpreadsheetClipboardCell[][];
+}
+/** MIME type -> data, as written to `DataTransfer.setData`. */
+type SpreadsheetClipboardData = Record<string, string>;
+/** Anything clipboard data can be read from: a `DataTransfer` or a plain record. */
+type SpreadsheetClipboardSource = {
+    getData(format: string): string;
+} | Record<string, string | undefined>;
+interface ParsedSpreadsheetClipboard {
+    format: 'internal' | 'html' | 'text';
+    /** Raw inputs to write, row by row. */
+    rows: string[][];
+    /** For internal pastes: where the block was copied from. */
+    origin?: CellPosition;
+}
+/** Serializes displayed values as an HTML table. Line breaks become `<br>`. */
+declare function serializeHtmlTable(values: ReadonlyArray<ReadonlyArray<unknown>>): string;
+/**
+ * Extracts cell texts from the first `<table>` in `html` (as written by
+ * spreadsheet apps and browsers). `colspan`/`rowspan` cells are expanded with
+ * blank cells so positions line up. Returns null when there is no table.
+ */
+declare function parseHtmlTable(html: string): string[][] | null;
+/** Builds the three clipboard representations of a copied block. */
+declare function createSpreadsheetClipboardData(cells: SpreadsheetClipboardCell[][], origin: CellPosition): SpreadsheetClipboardData;
+/**
+ * Reads clipboard data, preferring the lossless internal format, then an
+ * HTML table, then TSV text. Returns null when there is nothing to paste.
+ */
+declare function readSpreadsheetClipboard(source: SpreadsheetClipboardSource): ParsedSpreadsheetClipboard | null;
+/**
+ * Moves formulas copied from `origin` so they keep their relative references
+ * when pasted at `target`. Non-formula inputs are returned unchanged.
+ */
+declare function rebaseClipboardRows(rows: string[][], origin: CellPosition, target: CellPosition): string[][];
+
+/**
+ * The render model of a spreadsheet: which rows and columns are shown, in
+ * which order, with group header rows, frozen (sticky) offsets and merged
+ * cell spans. Filters, hidden rows/columns and collapsed groups only affect
+ * this view; the document keeps every row.
+ */
+
+declare const DEFAULT_ROW_HEIGHT = 32;
+declare const DEFAULT_COLUMN_WIDTH = 130;
+type SpreadsheetRowSection = 'header' | 'body' | 'footer';
+interface SpreadsheetRowGroup {
+    key: string;
+    label: string;
+    rowIndices: number[];
+    collapsed: boolean;
+    summaries: Record<string, number | null>;
+}
+type SpreadsheetViewRow = {
+    kind: 'row';
+    row: SpreadsheetRow;
+    index: number;
+    section: SpreadsheetRowSection;
+    frozen: boolean;
+    stickyTop: number;
+    groupKey?: string;
+} | {
+    kind: 'group';
+    group: SpreadsheetRowGroup;
+};
+interface SpreadsheetViewColumn {
+    column: SpreadsheetColumn;
+    index: number;
+    header: boolean;
+    frozen: boolean;
+    stickyLeft: number;
+}
+interface SpreadsheetCellSpan {
+    rowSpan: number;
+    colSpan: number;
+    /** The cell whose content is shown (a merge's top-left cell). */
+    source: CellPosition;
+    merge?: CellRange;
+}
+interface SpreadsheetViewModel {
+    rows: SpreadsheetViewRow[];
+    columns: SpreadsheetViewColumn[];
+    groups: SpreadsheetRowGroup[];
+    /** Visible document row indices in display order (for keyboard navigation). */
+    rowOrder: number[];
+    /** Visible document column indices in display order. */
+    columnOrder: number[];
+    filteredOutCount: number;
+    hiddenRowCount: number;
+    hiddenColumnCount: number;
+    /**
+     * Span of the cell rendered at (row, col): `{ rowSpan: 1, colSpan: 1 }` for
+     * an ordinary cell, the visible extent for a merge's first visible cell, and
+     * null for cells covered by a merge (render nothing).
+     */
+    getCellSpan(row: number, col: number): SpreadsheetCellSpan | null;
+}
+type CellValueReader = (rowIndex: number, colIndex: number) => unknown;
+/** Header and footer row counts, clamped so they never overlap. */
+declare function getTableSections(doc: SpreadsheetDocument): {
+    headerRows: number;
+    footerRows: number;
+};
+declare function getRowSection(doc: SpreadsheetDocument, rowIndex: number): SpreadsheetRowSection;
+/** Whether a body row passes the active filters. Header/footer rows always do. */
+declare function rowPassesFilters(doc: SpreadsheetDocument, rowIndex: number, getValue: CellValueReader): boolean;
+/** Category groups of the (unhidden, unfiltered) body rows. */
+declare function computeRowGroups(doc: SpreadsheetDocument, getValue: CellValueReader): SpreadsheetRowGroup[];
+declare function buildSpreadsheetView(doc: SpreadsheetDocument, getValue: CellValueReader): SpreadsheetViewModel;
+
+interface CsvExportOptions {
+    range?: CellRange | null;
+    delimiter?: string;
+    lineEnding?: string;
+    bom?: boolean;
+    /** Export formulas as typed (`=SUM(A1:A3)`) instead of their values. */
+    formulas?: boolean;
+}
+interface CsvImportOptions {
+    startRow?: number;
+    startCol?: number;
+    delimiter?: string;
+}
+type NewFilterRule = Omit<FilterRule, 'id'> & {
+    id?: string;
+};
+interface SpreadsheetControllerOptions {
+    document?: Partial<SpreadsheetDocument>;
+    dataSources?: SpreadsheetDataSource[];
+    primaryDataSourceId?: string;
+    onDocumentChange?: (doc: SpreadsheetDocument) => void;
+    onSelectionChange?: (activeCell: CellCoordinate | null, range: CellRange | null) => void;
+    onCellCommit?: (rowId: string, colId: string, raw: string, value: any) => void;
+}
+declare class SpreadsheetController {
+    document: SpreadsheetDocument;
+    activeCell: CellCoordinate | null;
+    selectedRange: CellRange | null;
+    editingCell: CellCoordinate | null;
+    draftValue: string;
+    readonly binder: DataSourceBinder;
+    readonly depGraph: DependencyGraph;
+    readonly evaluator: FormulaEvaluator;
+    private primaryDataSourceId?;
+    private onDocumentChange?;
+    private onSelectionChange?;
+    private onCellCommit?;
+    private undoStack;
+    private redoStack;
+    private isApplyingHistory;
+    private batching;
+    private pendingCommits;
+    private evaluatingRowIndex;
+    constructor(options?: SpreadsheetControllerOptions);
+    loadDocument(document: SpreadsheetDocument): void;
+    registerDataSource(ds: SpreadsheetDataSource): void;
+    setPrimaryDataSource(dataSourceId: string | undefined): void;
+    syncWithDataSource(): void;
+    private recomputeRowIndices;
+    getColumn(colIdOrKey: string): SpreadsheetColumn | undefined;
+    getRow(rowIdOrIndex: string | number): SpreadsheetRow | undefined;
+    getCell(rowId: string, colId: string): CellData;
+    /** Value of a cell with no stored data: bound record value, column formula, or blank. */
+    private getDerivedCell;
+    setCellValue(rowId: string, colId: string, raw: string): void;
+    private getCellKey;
+    /**
+     * Recalculates a cell and everything that depends on it, in dependency
+     * order. Every cell in a reference cycle is marked `#CYCLE!`.
+     */
+    recalculateCell(rowId: string, colId: string): void;
+    /**
+     * Rebuilds the dependency graph from scratch and recalculates every formula
+     * in dependency order.
+     */
+    recalculateAll(): void;
+    private runEvaluationPlan;
+    private locateCellKey;
+    private markCycle;
+    private evalSingleCellByKey;
+    private resolveCellByCoord;
+    private resolveRangeByCoords;
+    private resolveCurrentRowProperty;
+    selectCell(row: number, col: number, extendSelection?: boolean): void;
+    selectRange(range: CellRange): void;
+    startEditing(row?: number, col?: number, initialValue?: string): void;
+    commitEditing(valueToCommit?: string): void;
+    cancelEditing(): void;
+    moveCursor(direction: 'up' | 'down' | 'left' | 'right', extendSelection?: boolean): void;
+    insertColumn(index: number, config?: Partial<SpreadsheetColumn>): void;
+    deleteColumn(colId: string): void;
+    insertRow(index: number, config?: Partial<SpreadsheetRow>): void;
+    deleteRow(rowId: string): void;
+    private generateId;
+    /**
+     * Rewrites references in every cell formula (and, for column changes, every
+     * column formula) so they keep pointing at the same cells.
+     */
+    private shiftReferences;
+    setColumnWidth(colId: string, width: number): void;
+    autoFitColumnWidth(colId: string, customWidth?: number): void;
+    /**
+     * Exports cell values as TSV: the whole sheet, or only `range` (e.g. the
+     * current selection) when given.
+     */
+    exportToTsv(range?: CellRange | null): string;
+    /**
+     * Pastes tab-separated values starting at (startRow, startCol), adding rows
+     * and columns as needed. The whole paste is a single undo step.
+     */
+    importFromTsv(tsvData: string, startRow?: number, startCol?: number): void;
+    /** Adds rows/columns at the end until (rowIndex, colIndex) exists. */
+    private growGrid;
+    /**
+     * Writes raw inputs starting at (startRow, startCol), growing the grid as
+     * needed, as a single undo step with one recalculation.
+     */
+    private writeMatrix;
+    /**
+     * Runs `fn` as one undo step: cell writes inside it are batched and
+     * recalculated once, then listeners are notified.
+     */
+    private runBatch;
+    /**
+     * Exports the sheet (or `range`) as RFC 4180 CSV. Values are exported as
+     * displayed unless `formulas` is set.
+     */
+    exportToCsv(options?: CsvExportOptions): string;
+    /**
+     * Imports CSV text at (startRow, startCol) (default A1), growing the grid
+     * as needed. The whole import is a single undo step.
+     */
+    importFromCsv(csv: string, options?: CsvImportOptions): void;
+    /**
+     * Writes already-parsed rows of raw inputs (e.g. from an import adapter)
+     * starting at (startRow, startCol), as a single undo step.
+     */
+    importRows(rows: string[][], options?: Omit<CsvImportOptions, 'delimiter'>): void;
+    /** The cells of `range` (or the whole sheet), row by row. */
+    private readMatrix;
+    /**
+     * Builds clipboard data for `range` (default: the selection) as TSV,
+     * an HTML table and the lossless internal JSON format. Write every entry
+     * with `clipboardData.setData(type, data)` in a `copy` event.
+     */
+    copyToClipboardData(range?: CellRange | null): SpreadsheetClipboardData;
+    /**
+     * Pastes clipboard data at `target` (default: the selection's top-left).
+     * Prefers the internal format (formulas re-based to the target), then an
+     * HTML table, then TSV. Returns false when there was nothing to paste.
+     */
+    pasteClipboardData(source: SpreadsheetClipboardSource, target?: CellPosition): boolean;
+    private getSelectionTopLeft;
+    /** The table settings object, created on first use. */
+    private get table();
+    /** Records an undo step, applies `fn`, then notifies listeners. */
+    private applyTableChange;
+    /** First and last (inclusive) body row: rows between header and footer rows. */
+    private getBodyRowBounds;
+    private getCellValueAt;
+    /** Rewrites every formula so references follow cells that moved. */
+    private remapAllFormulas;
+    /**
+     * Keeps merges in place when rows/columns are inserted or deleted:
+     * merges after the change shift, merges across it grow or shrink, and
+     * merges reduced to a single cell are dropped.
+     */
+    private adjustTableForStructuralChange;
+    /**
+     * Sorts rows by one or more columns (stable; numbers before text, blanks
+     * last). Without a range (or with a range spanning every column) whole rows
+     * move; with a range only the cells inside it move. Header and footer rows
+     * never move. References follow the moved cells. Returns false when the
+     * sort is rejected (no valid keys, a key outside the range, or merged
+     * cells in the sorted area).
+     */
+    sortRows(keys: SortKey[], options?: {
+        range?: CellRange | null;
+    }): boolean;
+    getFilterState(): SpreadsheetFilterState;
+    /** Replaces all filter rules (and turns filters on when there are any). */
+    setFilterRules(rules: NewFilterRule[]): void;
+    /** Adds a filter rule (AND-combined with the others) and turns filters on. Returns its id. */
+    addFilterRule(rule: NewFilterRule): string;
+    updateFilterRule(ruleId: string, changes: Partial<Omit<FilterRule, 'id'>>): void;
+    removeFilterRule(ruleId: string): void;
+    clearFilters(): void;
+    /** Turns filtering on or off, keeping the rules. */
+    setFiltersEnabled(enabled: boolean): void;
+    toggleFilters(): void;
+    private generateFilterId;
+    setHeaderRowCount(count: number): void;
+    setFooterRowCount(count: number): void;
+    setHeaderColumnCount(count: number): void;
+    /** Keeps the first `count` rows visible while scrolling. 0 unfreezes. */
+    setFrozenRowCount(count: number): void;
+    /** Keeps the first `count` columns visible while scrolling. 0 unfreezes. */
+    setFrozenColumnCount(count: number): void;
+    private setTableCount;
+    hideRows(indices: number[]): void;
+    unhideRows(indices: number[]): void;
+    hideColumns(indices: number[]): void;
+    unhideColumns(indices: number[]): void;
+    /** Unhides every hidden row and column (filters are unaffected). */
+    unhideAll(): void;
+    private setHidden;
+    getMerges(): CellRange[];
+    /** The merge containing (row, col), or null. */
+    getMergeAt(row: number, col: number): CellRange | null;
+    /** Grows `range` until no merge crosses its edge. Keeps the drag direction. */
+    expandRangeToMerges(range: CellRange): CellRange;
+    /**
+     * Merges `range` (default: the selection) into one cell anchored on its
+     * top-left cell; the other cells are cleared. Merges fully inside the range
+     * are absorbed. Returns false for single cells and for ranges that
+     * partially overlap an existing merge.
+     */
+    mergeCells(range?: CellRange | null): boolean;
+    /** Removes every merge intersecting `range` (default: the selection). */
+    unmergeCells(range?: CellRange | null): boolean;
+    /**
+     * Fills `target` from `source` like dragging the fill handle. `target` is
+     * the extended range (source included) and must extend `source` down, up,
+     * right or left. Numbers and dates continue their series, text ending in a
+     * number counts up, other text repeats, and formulas are copied with
+     * their relative references shifted (`$` parts stay). Returns false when
+     * the ranges don't line up.
+     */
+    autofill(source: CellRange, target: CellRange): boolean;
+    /**
+     * Groups body rows by the value in `colId`, with optional per-group
+     * summaries (e.g. `[{ colId, aggregate: 'sum' }]`).
+     */
+    groupRowsBy(colId: string, summaries?: GroupSummary[]): void;
+    ungroupRows(): void;
+    /** Sets (or with `null`, removes) the group summary for a column. */
+    setGroupSummary(colId: string, aggregate: GroupAggregate | null): void;
+    setGroupCollapsed(key: string, collapsed: boolean): void;
+    toggleGroupCollapsed(key: string): void;
+    /** The current row groups with their summaries (empty when not grouped). */
+    getGroups(): SpreadsheetRowGroup[];
+    /**
+     * Transposes `range` (default: the selection) in place around its top-left
+     * cell: rows become columns. Cells left uncovered are cleared, the grid
+     * grows if needed, and references follow the moved cells. Returns false
+     * for single cells or when merged cells are involved.
+     */
+    transposeRange(range?: CellRange | null): boolean;
+    /**
+     * What to render: visible rows (with group headers) and columns in display
+     * order, frozen offsets and merged-cell spans. Filters, hidden rows/columns
+     * and collapsed groups only affect this view, never the document.
+     */
+    getViewModel(): SpreadsheetViewModel;
+    private recordSnapshot;
+    undo(): void;
+    redo(): void;
+    private notifyChange;
+}
+
+export { type SpreadsheetFilterState as $, type ASTNode as A, type BinaryOpNode as B, type CellCoordinate as C, DEFAULT_COLUMN_WIDTH as D, type EvaluationContext as E, FORMULA_ERRORS as F, type GroupAggregate as G, type PropertyRefNode as H, type RowType as I, type SortDirection as J, type SortKey as K, type LiteralNode as L, type SpreadsheetCellSpan as M, type NewFilterRule as N, type SpreadsheetClipboardCell as O, type ParsedSpreadsheetClipboard as P, type SpreadsheetClipboardData as Q, type RangeNode as R, SPREADSHEET_CLIPBOARD_MIME as S, type SpreadsheetClipboardPayload as T, type SpreadsheetClipboardSource as U, type SpreadsheetColumn as V, SpreadsheetController as W, type SpreadsheetControllerOptions as X, type SpreadsheetDataSource as Y, type SpreadsheetDataSourceField as Z, type SpreadsheetDocument as _, type CellData as a, type SpreadsheetGrouping as a0, type SpreadsheetRow as a1, type SpreadsheetRowGroup as a2, type SpreadsheetRowSection as a3, type SpreadsheetTableSettings as a4, type SpreadsheetViewColumn as a5, type SpreadsheetViewModel as a6, type SpreadsheetViewRow as a7, type StructuralChange as a8, type UnaryOpNode as a9, WHOLE_COLUMN_END_ROW as aa, buildSpreadsheetView as ab, colNameToIndex as ac, columnDependencyKey as ad, computeRowGroups as ae, createSpreadsheetClipboardData as af, describeFormulaError as ag, extractCellDependencies as ah, getRowSection as ai, getTableSections as aj, indexToColName as ak, isFormulaError as al, mapFormulaReferences as am, offsetFormulaReferences as an, parseCellReference as ao, parseFormula as ap, parseHtmlTable as aq, parseRange as ar, readSpreadsheetClipboard as as, rebaseClipboardRows as at, remapFormulaReferences as au, rowPassesFilters as av, serializeHtmlTable as aw, shiftFormulaReferences as ax, tokenizeFormula as ay, type CellDep as b, type CellFormat as c, type CellPosition as d, type CellRange as e, type CellRefNode as f, type CellValueReader as g, type ColumnBinding as h, type ColumnType as i, type CsvExportOptions as j, type CsvImportOptions as k, DEFAULT_ROW_HEIGHT as l, DataSourceBinder as m, DependencyGraph as n, type FilterOperator as o, type FilterRule as p, type FormulaDiagnostic as q, type FormulaErrorCode as r, type FormulaEvaluationResult as s, FormulaEvaluator as t, FormulaParser as u, type FormulaRange as v, type FormulaToken as w, type FormulaTokenType as x, type FunctionCallNode as y, type GroupSummary as z };