@sheetxl/sdk 0.7.21 → 0.7.23-beta.2

package/types/src/address/AddressUtils.d.ts

@@ -0,0 +1,252 @@
+import { FormulaError, IRange } from '@sheetxl/primitives';
+import { RunCoords, RunCoordValue } from '@sheetxl/utils';
+import { ISpatialMap } from '../collections';
+import { ICell } from '../cell';
+import { ICellRanges } from '../cellRange';
+/**
+ * A string value that represents an invalid reference.
+ */
+export declare const InvalidRef: string;
+export declare const MAX_COL: number;
+export declare const MAX_ROW: number;
+export declare function rowToString(row: number): string;
+export declare function colToString(col: number): string;
+export declare function cellToString(cell: Readonly<IRange.CellCoords>): string | null;
+export declare function sheetCellToString(cell: Readonly<IRange.FixableCellCoords>): string;
+export declare function sheetNameToString(sheetName: string | null | undefined, defaultName?: string | null): string | null | undefined;
+export declare function sheetAndRangeToString(sheetName: string | null | undefined, rangeStr: string): string;
+export declare function rangeToString(address: IRange.Address, defaultRange?: IRange.Coords, toCellString?: CellToString): string | null;
+/**
+ * If `range` (ABSOLUTE coords) spans an ENTIRE column or row — detected via `entireCoords`, or the
+ * `MIN_SAFE_INTEGER` entire-axis sentinel — return its collapsed `A:A` / `1:1` notation; otherwise
+ * `null`. Excel collapses a full-height/width range to entire notation (`C1:C1048576` → `C:C`), and the
+ * SDK does NOT preserve the distinction; the token serializer ({@link tokensToString}) calls this to
+ * normalize any reference — however produced (parsed, `setReferenceAt`, file load) — to that form. Only a
+ * SINGLE-axis span collapses (a genuine entire column/row); an entire-sheet range returns `null` (left to
+ * the per-cell path). `$` flags are preserved on the collapsed axis.
+ */
+export declare function entireRangeToString(range: Readonly<IRange.FixableCoords>, entireCoords: Readonly<IRange.Coords> | undefined): string | null;
+export declare function fixableRangeToString2(cell: Readonly<IRange.FixableCoords>, defaultSheetName: string, r1c1?: boolean): string;
+export declare function fixableCellToString(cell: Readonly<IRange.FixableCellCoords>, defaultSheetName: string, r1c1?: boolean): string;
+/**
+ * Duplicated rangeToString.
+ * If we used the from/to range type we wouldn't have to.
+ */
+export declare function fixableCellToA1(cell: Readonly<IRange.FixableCellCoords>, defaultScope?: string | null, toCellString?: CellToString<IRange.FixableCellCoords>): string;
+/**
+ * Duplicated rangeToString.
+ * If we used the from/to range type we wouldn't have to.
+ */
+export declare function sheetRangeToString(fixable: Readonly<Partial<IRange.FixableCoords>>, defaultRange?: Readonly<IRange.Coords>, toCellString?: CellToString<IRange.FixableCellCoords>, asRange?: boolean): string;
+/**
+ * Convert a fixable cell to A1 format.
+ *
+ * @param fixable
+ * @param defaultRange
+ * @param toRangeString
+ * @returns a string
+ */
+export declare function sheetRangesToString(fixable: readonly Partial<Readonly<IRange.FixableCoords>>[], defaultRange?: Readonly<IRange.Coords>, toRangeString?: RangeToString<IRange.FixableCoords, IRange.FixableCellCoords>): string;
+/**
+ * Workbook range still used IRange.FixableCellCoords.
+ */
+export declare function fixableRangeToString(range: Readonly<Partial<IRange.FixableCoords>>, defaultRange?: Readonly<IRange.Coords>, toCellString?: CellToString<IRange.FixableCellCoords>): string;
+export type CellToString<C extends IRange.CellCoords = IRange.CellCoords> = (cell: C) => string | null;
+export type RangeToString<R extends IRange.Coords = IRange.Coords, C extends IRange.CellCoords = IRange.CellCoords> = (range: Partial<R>, defaultRange?: R, toCellString?: CellToString<C>, asRange?: boolean) => string;
+export type StringToCell = (str: string, allow1D?: boolean) => Partial<IRange.CellCoords> | null | undefined;
+export type StringToRange = (str: string, defaultRange?: IRange.Coords, allowR1C1?: boolean) => Partial<IRange.Coords> | null | undefined;
+/**
+ * @param allow1D When parsing ranges that are row or columns we allow a single dimension.
+ */
+export declare function stringToCell(str: string, allow1D?: boolean): Partial<IRange.CellCoords> | null | undefined;
+/**
+ * Decodes a cell address into a row and column index
+ * @param str The string to parse
+ * @param allow1D When parsing ranges that are row or columns we allow a single dimension.
+ */
+export declare function stringToSheetCell(str: string, allow1D?: boolean): Partial<IRange.FixableCellCoords> | null | undefined;
+export declare function stringToFixableCell(str: string, allow1D?: boolean): Partial<IRange.FixableCellCoords> | null | undefined;
+export declare function stringToSheetRange(str: string, rangeDefault?: Readonly<IRange.Coords>, isR1C1?: boolean): Partial<IRange.FixableCoords> | null;
+/**
+ * This doesn't fail but will return null if unable to parse.
+ */
+export declare function stringToWorkbookRange(str: string, defaultRange?: Readonly<IRange.Coords>, allowR1C1?: boolean): Partial<IRange.FixableCoords> | null;
+/**
+ * Parse a string into an array of coords.
+ *
+ * @param str The string to parse.
+ * @param defaultRange The range to default from.
+ * @param allow1D If R1C1 is allows **NOT IMPLEMENTED**
+ */
+export declare function stringToCoordsArray(str: string, defaultRange: Readonly<IRange.Coords>, allowR1C1: boolean, toRange?: StringToRange, toCell?: StringToCell): (Partial<IRange.CellCoords | IRange.Coords> | string)[] | null;
+/**
+ * This is only used to persist arrays so the toStringRange does not use workbook.
+ */
+export declare function coordsArrayToStringArray(coords: readonly (Partial<IRange.Coords | IRange.CellCoords> | string)[], defaultRange?: Readonly<IRange.Coords>, toStringRange?: RangeToString, //fixableRangeToString,
+toStringCell?: CellToString, r1c1?: boolean): string[] | null;
+export declare function coordsArrayToString(coords: readonly (Partial<IRange.Coords | IRange.CellCoords> | string)[], defaultRange?: Readonly<IRange.Coords>, toStringRange?: RangeToString, toStringCell?: CellToString, r1c1?: boolean): string;
+export declare function rangesAddressToRangesCoords<R extends IRange.Coords = IRange.Coords, C extends IRange.CellCoords = IRange.CellCoords>(address: ICellRanges.Address | ICell.Address, defaultRange: Readonly<R>, toRange?: StringToRange, onNoParse?: (coord: Partial<C | R> | string) => readonly R[], allowR1C1?: boolean): R[];
+/** `Fast` just scans through each character. */
+export declare function fastStringToCell(address: string, reuse?: IRange.CellCoords): IRange.CellCoords | undefined;
+/**
+ * `Creates a coords from a string with R1C1 notion.
+ *
+ * @remarks
+ * This is 1 based and will return Number.MIN_SAFE_INTEGER if the row or col is not specified.
+ */
+export declare function stringToSheetCellR1C1(str: string, allow1D?: boolean, reuseCoord?: IRange.FixableCellCoords): IRange.FixableCellCoords | null;
+/**
+ * `Fast` just scans through each character.
+ *
+ * @remarks
+ * This is 1 based and will return -1 if the row or col is not specified.
+ */
+export declare function fasterStringToCell(address: string, _reuse: IRange.FixableCellCoords): IRange.FixableCellCoords;
+/** `Fast` just scans through each character. */
+export declare function fastStringToCol(address: string): number;
+/**
+ * `Fast` decode ranges but has no error checking.
+ * If does not support fixed cells, sheets, or partials. Useful
+ * for reading from save strings.
+ */
+export declare function fastStringToRange(address: string, _reuse?: IRange.Coords): IRange.Coords;
+/**
+ *
+ * @param cstr
+ * @returns
+ */
+/** Matches just the cell portion of a range */
+export declare function matchRangeString(range: string, isR1C1?: boolean): RegExpMatchArray | null;
+/**
+ * Returns `true` is the string is a valid format for a cell address.
+ *
+ * @param address The address as a string.
+ * @param maxRow The maximum row index.
+ * @param maxCol The maximum column index.
+ * @param isR1C1 If the address is in R1C1 format.
+ */
+export declare function validateCellString(address: string, maxRow?: number, maxCol?: number, isR1C1?: boolean): boolean;
+export declare function resolveRelativeToA1(tokens: (string | IRange.CellCoords)[], rowIndex: number, colIndex: number): string;
+export declare function fixableCellToR1C1(fixable: IRange.FixableCellCoords, defaultScope?: string | null): string;
+export declare function toAbsoluteCellString(fixable: IRange.FixableCellCoords, positionRow: number, positionCol: number): string;
+/**
+ * Returns the range as A1 (relative to zero).
+ */
+export declare function toAbsoluteRange(fixable: IRange.FixableCoords, positionRow: number, positionCol: number, reuseRange?: IRange.FixableCoords): IRange.FixableCoords;
+/**
+ * Returns relative range (inverse of toAbsoluteRange).
+ * Stores R1C1-style offsets from the given cell position for non-anchored coords;
+ * anchored ($) coords are left as-is.
+ */
+export declare function toRelativeRange(absolute: IRange.FixableCoords, positionRow: number, positionCol: number): IRange.FixableCoords;
+/**
+ * Returns a relative single cell — the inverse of {@link toAbsoluteCell} (subtracts the anchor from each
+ * non-`$`-anchored axis). Mirrors {@link toRelativeRange} for a `FixableCellCoords`.
+ */
+export declare function toRelativeCell(absolute: IRange.FixableCellCoords, positionRow: number, positionCol: number): IRange.FixableCellCoords;
+/**
+ * Returns absolute cell
+ */
+export declare function toAbsoluteCell(fixable: IRange.FixableCellCoords, positionRow: number, positionCol: number, reuseRange?: IRange.FixableCellCoords): IRange.FixableCellCoords;
+/**
+ * Returns fixable ranges
+ */
+export declare function adjustRelationalRange(fixable: IRange.FixableCoords, positionRow: number, positionCol: number, reuseRange?: IRange.FixableCoords): IRange.FixableCoords;
+/**
+ * Creates a string that can be shared by replacing all addresses with '#REF#' with a single value.
+ *
+ * @param formula A formula string.
+ * @param rowIndex The current row.
+ * @param colIndex The current column.
+ * @param normalize Uppercase and remove whitespace.
+ *
+ * @remarks
+ * This is used for quick identification of formula blocks
+ */
+export declare function normalizeA1ToR1C1(formula: string, rowIndex: number, colIndex: number, tokens?: (string | IRange.FixableCellCoords)[]): string;
+/**
+ * Decodes both references and address
+ */
+export declare function refToEntry(ref: IRange.JSONReference, entireRange: IRange.Coords): ISpatialMap.Entry | null;
+/**
+ * Splits a JSON reference into **all** of the ranges it names, plus its value.
+ *
+ * @param ref The reference to decode.
+ * @param entireRange Used to resolve entire-row/entire-column shorthand.
+ * @returns `null` if nothing in the reference decoded to a range.
+ *
+ * @remarks
+ * Unlike {@link refToEntry}, a comma-separated address (`'A1:B2,D5:D9'`) yields every range rather
+ * than only the first. Data validations, conditional formats and protected ranges are all persisted
+ * that way — one rule, several ranges.
+ */
+export declare function refToEntries(ref: IRange.JSONReference, entireRange: IRange.Coords): {
+    coords: IRange.Coords[];
+    value: any;
+} | null;
+/**
+ * Serializes a 0-based run as an entire-column/row address (`'E:E'`, `'E:H'`, `'5:12'`).
+ *
+ * @param min The 0-based start of the run.
+ * @param max The 0-based end of the run (inclusive).
+ * @param isColumn If `true` the run is written as columns, otherwise as rows.
+ */
+export declare function runToString(min: number, max: number, isColumn: boolean): string;
+/**
+ * Parses an entire-column/row address (`'E:H'`, `'5:12'`) into a 0-based run.
+ *
+ * @param address The address to parse.
+ * @param isColumn The axis to read a two dimensional address against.
+ * @returns `null` if the address does not describe a run.
+ *
+ * @remarks
+ * The orientation comes from the address itself - letters are a column run, digits a row run - so
+ * a row address reads the same in either the column or the row collection. `isColumn` only
+ * resolves a two dimensional address (`'A1:D5'`), which is projected onto that axis.
+ */
+export declare function stringToRun(address: string, isColumn: boolean): RunCoords | null;
+/**
+ * Serializes a run and its value as a {@link IRange.JSONReferenceEntry}.
+ */
+export declare function runToRef<T = any>(run: Readonly<RunCoordValue<T>>, isColumn: boolean): IRange.JSONReferenceEntry<T>;
+/**
+ * Parses a {@link IRange.JSONReference} back into a run and its value.
+ *
+ * @returns `null` if the reference does not describe a run.
+ * @see {@link stringToRun} for how the orientation is resolved.
+ */
+export declare function refToRun<T = any>(ref: IRange.JSONReference<T>, isColumn: boolean): RunCoordValue<T> | null;
+/**
+ * Serializes runs as {@link IRange.JSONReferenceEntry | references}.
+ */
+export declare function runsToRefs<T = any>(runs: readonly Readonly<RunCoordValue<T>>[], isColumn: boolean): IRange.JSONReferenceEntry<T>[];
+/**
+ * Parses {@link IRange.JSONReference | references} back into runs.
+ *
+ * @remarks
+ * References that do not describe a run are skipped.
+ */
+export declare function refsToRuns<T = any>(refs: readonly IRange.JSONReference<T>[], isColumn: boolean): RunCoordValue<T>[];
+/**
+ * Serializes a list of ranges into the comma-separated form {@link refToEntries} reads back.
+ */
+export declare function rangesToString(ranges: readonly IRange.Address[], defaultRange?: IRange.Coords, toCellString?: CellToString): string | null;
+export declare function addressToRangeCoords(address: IRange.Address, entireRange: Readonly<IRange.Coords>): IRange.Coords | null;
+export declare function addressToString(address: IRange.Address, entireRange: Readonly<IRange.Coords>): string;
+/**
+ * Finds the intersection of 2 ranges.
+ *
+ * @returns `null` if no intersection.
+ *
+ * @remarks
+ * Like CoordsUtils.intersectRanges but considers scope.
+ */
+export declare function intersectScopedRanges(a: IRange.Coords, b: IRange.Coords, reuse?: IRange.Coords): IRange.Coords | FormulaError.Known | null;
+/**
+ * Finds the union of 2 ranges.
+ *
+ * @remarks
+ * Like CoordsUtils.intersectRanges but considers scope.
+ */
+export declare function unionScopedRanges(a: IRange.Coords, b: IRange.Coords, reuse?: IRange.Coords): IRange.Coords | FormulaError.Known | null;
+//# sourceMappingURL=AddressUtils.d.ts.map

package/types/src/address/AddressUtils.d.ts.map

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

package/types/src/address/_AddressMessages.d.ts

@@ -0,0 +1,7 @@
+import { ICell } from '../cell';
+import { ICellRanges } from '../cellRange';
+export declare const ERROR_INVALID_ADDRESS: (address?: ICell.Address) => string;
+export declare const ERROR_INVALID_RANGE_ADDRESS: (address: ICellRanges.Address) => string;
+export declare const ERROR_INVALID_RANGE_RELATIVE: (address: string) => string;
+export declare const ERROR_INVALID_REF: () => never;
+//# sourceMappingURL=_AddressMessages.d.ts.map

package/types/src/address/_AddressMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_AddressMessages.d.ts","sourceRoot":"","sources":["../../../../src/address/_AddressMessages.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,eAAO,MAAM,qBAAqB,GAAI,UAAU,KAAK,CAAC,OAAO,WAElB,CAAC;AAI5C,eAAO,MAAM,2BAA2B,GAAI,SAAS,WAAW,CAAC,OAAO,WAE3B,CAAC;AAC9C,eAAO,MAAM,4BAA4B,GAAI,SAAS,MAAM,WACN,CAAC;AACvD,eAAO,MAAM,iBAAiB,aAE7B,CAAC"}

package/types/src/address/index.d.ts

@@ -0,0 +1,35 @@
+import { IRange } from '@sheetxl/primitives';
+import { RunCoords, RunCoordValue } from '@sheetxl/utils';
+import { CellToString } from './AddressUtils';
+/**
+ * Collection of functions used for parsing Address string.
+ *
+ * Needed for OOXML import.
+ * @hidden
+ */
+export declare namespace AddressUtils {
+    const fastStringToCol: (address: string) => number;
+    const fastStringToCell: (address: string, reuse?: IRange.CellCoords) => IRange.CellCoords | undefined;
+    const fastStringToRange: (address: string, _reuse?: IRange.Coords) => IRange.Coords;
+    const rangeToString: (address: IRange.Address, defaultRange?: IRange.Coords, toCellString?: CellToString) => string | null;
+    const cellToString: CellToString<IRange.CellCoords>;
+    const normalizeA1ToR1C1: (formula: string, rowIndex: number, colIndex: number, tokens?: (string | IRange.FixableCellCoords)[]) => string;
+    const resolveRelativeToA1: (tokens: (string | IRange.CellCoords)[], rowIndex: number, colIndex: number) => string;
+    /** Quote/escape a sheet name for use in an address (`My Sheet` → `'My Sheet'`). */
+    const sheetNameToString: (sheetName: string | null | undefined, defaultName?: string | null) => string | null | undefined;
+    /** Join a (already quoted) sheet name and a range string into a scoped address (`Sheet2!A1:B2`). */
+    const sheetAndRangeToString: (sheetName: string, rangeStr: string) => string;
+    /** Write a 0-based run as an entire-column/row address (`'E:H'`, `'5:12'`). */
+    const runToString: (min: number, max: number, isColumn: boolean) => string;
+    /** Read an entire-column/row address back into a 0-based run. */
+    const stringToRun: (address: string, isColumn: boolean) => RunCoords | null;
+    /** Write a run and its value as an address/value pair. */
+    const runToRef: <T = any>(run: Readonly<RunCoordValue<T>>, isColumn: boolean) => IRange.JSONReferenceEntry<T>;
+    /** Read an address/value pair back into a run. */
+    const refToRun: <T = any>(ref: IRange.JSONReference<T>, isColumn: boolean) => RunCoordValue<T> | null;
+    /** {@inheritDoc runToRef} */
+    const runsToRefs: <T = any>(runs: readonly Readonly<RunCoordValue<T>>[], isColumn: boolean) => IRange.JSONReferenceEntry<T>[];
+    /** {@inheritDoc refToRun} */
+    const refsToRuns: <T = any>(refs: readonly IRange.JSONReference<T>[], isColumn: boolean) => RunCoordValue<T>[];
+}
+//# sourceMappingURL=index.d.ts.map

package/types/src/address/index.d.ts.map

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

package/types/src/anchored/AbstractAnchored.d.ts

@@ -0,0 +1,200 @@
+import { IRange } from '@sheetxl/primitives';
+import { ITransaction } from '../transaction';
+import { IListener } from '../listener';
+import { ICellRange, ICellRanges } from '../cellRange';
+import { IAnchored } from './IAnchored';
+import { Anchored } from './Anchored';
+import { ListenerEmitter } from '../listener/ListenerEmitter';
+/**
+ * Abstract implement of {@link IAnchorItem}.
+ */
+export declare abstract class AbstractAnchored<STATE extends AbstractAnchored.State = AbstractAnchored.State, VIEW extends AbstractAnchored.CommitView = AbstractAnchored.CommitView, EVENTS extends IAnchored.Events = IAnchored.Events> implements IAnchored, ITransaction.ITransactional, IListener.ISource<IAnchored> {
+    protected _options: Anchored.ConstructorOptions;
+    protected _emitter: ListenerEmitter<IAnchored, EVENTS>;
+    private _transactions;
+    private _transactionsRemoveListener;
+    private _id;
+    private _closed;
+    protected _range: ICellRange | null;
+    protected _ranges: ICellRanges | null;
+    constructor(options: Anchored.ConstructorOptions);
+    protected _initializeOptions(options: Anchored.ConstructorOptions): Anchored.ConstructorOptions;
+    protected _initialize(options: Anchored.ConstructorOptions): void;
+    /** @internal */
+    protected _getEmitter<SOURCE, E extends EVENTS>(): ListenerEmitter<SOURCE, E>;
+    /** {@inheritDoc IAnchored.delete} */
+    delete(options?: ITransaction.OperationOptions): void;
+    /** {@inheritDoc IAnchored.isProtected} */
+    isProtected(): boolean;
+    /**
+     * The anchor coordinates in authored order, or `null` when unanchored.
+     *
+     * @remarks
+     * Deliberately **not** on {@link IAnchored}: coordinates are the internal representation, and
+     * the public contract is ranges ({@link getRanges} / the single-range `getRange()` each concrete
+     * type declares). Kept here so subclasses can read their own geometry without paying for a range.
+     */
+    getAnchorCoords(): IRange.Coords[] | null;
+    /**
+     * The first anchor coordinates, or `null` when unanchored.
+     *
+     * @remarks
+     * The coords-level peer of {@link getRange}. Like {@link getAnchorCoords}, not on
+     * {@link IAnchored} — see there.
+     */
+    getFirstAnchorCoords(): IRange.Coords | null;
+    /**
+     * Drops the memoized {@link getRange} / {@link getRanges} results.
+     *
+     * @remarks
+     * Called from every path that can move or remove the anchor. The cache is what lets the range
+     * accessors be the public contract — without it every caller pays a `getRanges` construction,
+     * and several read on the selection-change and style-resolution paths.
+     */
+    protected _invalidateRangeCache(): void;
+    /**
+     * Whether this item's anchor is an **absolute** reference (`$C$3:$C$7`).
+     *
+     * @remarks
+     * An anchor is a pinned position, so for the types users address as ranges the answer is yes —
+     * a data validation or conditional format never shifts the way a relative reference does, and
+     * Excel presents both as absolute. Off by default: the anchor coords themselves are stored
+     * without fixable flags (`CoordUtils.sanitizeRange` strips them on the way in), so only a type
+     * that knows its own semantics can put them back.
+     *
+     * Presentation and address-level only — {@link AnchoredMap.toJSON} serializes from the map's
+     * entries via `rangesToString`, so the persisted OOXML `sqref` stays unadorned either way.
+     */
+    protected _isAnchorAbsolute(): boolean;
+    /** {@inheritDoc IAnchored.getRanges} */
+    getRanges(options?: ICellRange.GetRangeOptions): ICellRanges;
+    /**
+     * The first anchor range.
+     *
+     * @remarks
+     * Not on {@link IAnchored} — single-range-ness is a property of the concrete type, so `ITable`,
+     * `IMovable`, `IDataValidation` and `IConditionalFormat` declare it themselves. Invalid, never
+     * null, when unanchored.
+     */
+    getRange(options?: ICellRange.GetRangeOptions): ICellRange;
+    /**
+     * Re-anchors this item to `address`, REPLACING every range it currently occupies.
+     *
+     * @remarks
+     * The container owns the geometry — it holds the spatial index every read goes through, and it
+     * is where the protection check and the undo entry belong — so this hands the address over and
+     * lets the write arrive back through `processAfterShift`, the same path a row insert takes.
+     * One code path for "my ranges changed", however they changed.
+     *
+     * A DETACHED item (the temporary draft an editor panel edits) has no container to hand it to,
+     * so it writes its own state instead; the host applies the draft's ranges on save.
+     *
+     * Protected because re-anchoring is not something every anchored type should offer — a movable
+     * owns its bounds, a table its structure. The types a user addresses as ranges (data
+     * validations, conditional formats, protected ranges) expose it as `setRanges`.
+     */
+    protected _setAnchorRanges(address: ICellRanges.Address, options?: ITransaction.OperationOptions): this;
+    /** {@inheritDoc IAnchored.getAnchorType} */
+    getAnchorType(): IAnchored.Type;
+    /** {@inheritDoc ITransaction.ITransactional.getId} */
+    getId(): string;
+    /** {@inheritDoc ITransaction.ITransactional.getVersionId} */
+    getVersionId(): number;
+    /** {@inheritDoc ITransaction.ITransactional.beginCommit} */
+    beginCommit(options?: string | ITransaction.OperationOptions): ITransaction;
+    /** {@inheritDoc ITransaction.ITransactional.doBatch} */
+    doBatch<R>(callback: (commit: ITransaction.ICommit) => Promise<R> | R, options?: string | ITransaction.OperationOptions): Promise<R> | R;
+    /** @internal */
+    protected _processTransactionDone(_transaction: ITransaction): void;
+    protected _getState(): Readonly<STATE>;
+    protected _beginCommit(options?: string | ITransaction.OperationOptions): ITransaction;
+    protected _getTransactions(): ITransaction.IStore;
+    protected _updateState(updateState?: Partial<STATE>, //(prevState: STATE) => STATE,
+    options?: string | ITransaction.OperationOptions | null, events?: (keyof EVENTS)[] | null, skipProtection?: boolean): this;
+    protected _notify(events?: (keyof EVENTS)[] | keyof EVENTS): void;
+    /**
+     * The authoritative anchor write for a shift.
+     *
+     * @remarks
+     * The container calls this **once** per operation with the model's complete range list, which is
+     * the only view that is correct for a multi-range item: {@link _processContainerShift} sees one
+     * range at a time and cannot tell "this range is gone" from "this item is gone", and a split
+     * never reaches it for the pieces at all.
+     */
+    protected _processAfterContainerShift(before: IRange.Coords[] | null, after: IRange.Coords[] | null): void;
+    /** @internal */
+    protected _processContainerShift(options: Anchored.ShiftOptions): IRange.Coords | null | void;
+    /** @internal */
+    protected _processBeforeCommitStart(_state: STATE, _view: VIEW, _commit: ITransaction.ICommit): void;
+    /** @internal */
+    protected _processAfterStateChange(_state: STATE, _view: VIEW, _commit: ITransaction.ICommit): void;
+    /**
+     * Called before local commit
+     * @internal
+     */
+    protected _processUpdateState(prevState: Partial<STATE>, newState: Partial<STATE>): void;
+    /** @internal */
+    protected _processRestoreOrRevert(_state: STATE, _view: VIEW, _commit: ITransaction.ICommit): void;
+    /** @internal */
+    protected _processAnchorCoords(): void;
+    /** @internal */
+    protected _processContainerLayout(): void;
+    /** @internal */
+    /**
+     * A COMPLETE undo description for `action`, or null for the generic one.
+     *
+     * Whole sentences, not a noun: the old hook returned `Data Validation` and the caller wrote
+     * `Delete ${noun}`, which cannot be translated — verb/noun order and the noun's case move with
+     * the language. Return a `messageKey` (static, follows a language switch) or, only when the text
+     * carries per-instance data, a `t()`-formatted string.
+     */
+    protected _getActionDescription(_action: 'delete' | 'initialize' | 'updateListener'): string | null;
+    /** @internal */
+    protected _delete(): void;
+    /** @internal */
+    protected _processContainerDelete(): void;
+    /** @internal */
+    protected _processDelete(): void;
+    /** @internal */
+    protected _processContainerProtection(): void;
+    /** {@inheritDoc IListener.ISource.addListeners} */
+    addListeners(listeners: IListener.Callbacks<IAnchored, EVENTS>, options?: IListener.Options): IListener.Remove;
+    /** {@inheritDoc IAnchored.isClosed} */
+    isClosed(): boolean;
+    /** {@inheritDoc IAnchored.isDeleted} */
+    isDeleted(): boolean;
+    /** @internal */
+    protected _processClose(): void;
+    /** {@inheritDoc IAnchored.close} */
+    close(): void;
+    /** {@inheritDoc IAnchored.isIAnchored} */
+    get isIAnchored(): true;
+}
+/**
+ * Interfaces for creating `IAnchored`.
+ *
+ * @see
+ * ### **Interface**
+ *
+ * {@link AbstractAnchored}
+ * @internal
+ */
+export declare namespace AbstractAnchored {
+    interface State {
+        /**
+         * One range, or several in authored order.
+         *
+         * @remarks
+         * The union is deliberate: single-range types (tables, movables) narrow this back to
+         * `IRange.Coords` in their own `State` and keep reading it directly, while data validations and
+         * conditional formats hold a list. {@link AbstractAnchored.getAnchorCoords} normalizes both
+         * shapes for readers who do not care which they have.
+         */
+        anchorCoords: IRange.Coords | IRange.Coords[];
+        anchorType: IAnchored.Type;
+        isDeleted: boolean;
+    }
+    interface CommitView {
+    }
+}
+//# sourceMappingURL=AbstractAnchored.d.ts.map

package/types/src/anchored/AbstractAnchored.d.ts.map

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