@gridsheet/react-core 3.0.0-rc.2 → 3.0.0-rc.3

package/dist/lib/sheet.d.ts

@@ -1,3 +1,508 @@
-export declare const escapeSheetName: (name: string) => string;
-export declare const getSheetPrefix: (name?: string) => string;
+import { Id, AreaType, CellsByAddressType, PointType, Address, CellFilter, MatrixType, CellType, FilterConfig, HistoryType, StorePatchType, ShapeType, RectType, OperatorType, OperationType, RawCellType, StoreType, Resolution, System } from '../types';
+import { FunctionMapping } from '../formula/functions/__base';
+import { ProcessFormulaProps } from '../formula/evaluator';
+import { SolveOptions } from '../formula/solver';
+import { Registry } from './book';
+import { PolicyType, RenderProps } from '../policy/core';
+type CellField = keyof CellType;
+export type SheetLimits = {
+    minRows?: number;
+    maxRows?: number;
+    minCols?: number;
+    maxCols?: number;
+};
+type Props = {
+    limits?: SheetLimits;
+    functions?: FunctionMapping;
+    name?: string;
+    registry?: Registry;
+};
+type MoveProps = {
+    srcSheet?: UserSheet;
+    src: AreaType;
+    dst: AreaType;
+    operator?: OperatorType;
+    undoReflection?: StorePatchType;
+    redoReflection?: StorePatchType;
+    historicize?: boolean;
+};
+export interface UserSheet {
+    changedTime: number;
+    lastChangedTime?: number;
+    area: AreaType;
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+    minNumRows: number;
+    maxNumRows: number;
+    minNumCols: number;
+    maxNumCols: number;
+    headerWidth: number;
+    headerHeight: number;
+    name: string;
+    /**
+     * Returns the raw sheet object, which is used for internal operations.
+     * This is not intended for public use and may change in future versions.
+     */
+    __raw__: Sheet;
+    getRectSize(area: AreaType): RectType;
+    getCell(point: PointType, options?: {
+        resolution?: Resolution;
+        raise?: boolean;
+    }): CellType | undefined;
+    getPolicy(point: PointType): PolicyType;
+    get numRows(): number;
+    get numCols(): number;
+    get shape(): ShapeType;
+    move(args: MoveProps): UserSheet;
+    copy(args: MoveProps & {
+        onlyValue?: boolean;
+    }): UserSheet;
+    update(args: {
+        diff: CellsByAddressType;
+        historicize?: boolean;
+        partial?: boolean;
+        updateChangedTime?: boolean;
+        reflection?: StorePatchType;
+    }): UserSheet;
+    writeMatrix(args: {
+        point: PointType;
+        matrix: MatrixType<string>;
+        updateChangedTime?: boolean;
+        reflection?: StorePatchType;
+    }): UserSheet;
+    write(args: {
+        point: PointType;
+        value: string;
+        updateChangedTime?: boolean;
+        reflection?: StorePatchType;
+    }): UserSheet;
+    insertRows(args: {
+        y: number;
+        numRows: number;
+        baseY: number;
+        diff?: CellsByAddressType;
+        partial?: boolean;
+        updateChangedTime?: boolean;
+        reflection?: StorePatchType;
+    }): UserSheet;
+    removeRows(args: {
+        y: number;
+        numRows: number;
+        reflection?: StorePatchType;
+    }): UserSheet;
+    insertCols(args: {
+        x: number;
+        numCols: number;
+        baseX: number;
+        diff?: CellsByAddressType;
+        partial?: boolean;
+        updateChangedTime?: boolean;
+        reflection?: StorePatchType;
+    }): UserSheet;
+    removeCols(args: {
+        x: number;
+        numCols: number;
+        reflection?: StorePatchType;
+    }): UserSheet;
+    undo(): {
+        history: HistoryType | null;
+    };
+    redo(): {
+        history: HistoryType | null;
+    };
+    histories(): HistoryType[];
+    historyIndex(): number;
+    historySize(): number;
+    setHeaderHeight(height: number, historicize?: boolean): UserSheet;
+    setHeaderWidth(width: number, historicize?: boolean): UserSheet;
+    sortRows(args: {
+        x: number;
+        direction: 'asc' | 'desc';
+    }): UserSheet;
+    filterRows(args?: {
+        x?: number;
+        filter?: FilterConfig;
+    }): UserSheet;
+    isRowFiltered(y: number): boolean;
+    hasActiveFilters(): boolean;
+    hasPendingCells(): boolean;
+    waitForPending(): Promise<void>;
+    getLastChangedAddresses(): Address[];
+    getSerializedValue(props: {
+        point: PointType;
+        cell?: CellType;
+        resolution?: Resolution;
+    }): string;
+}
+type InternalToValueMatrixProps = {
+    area?: AreaType;
+    resolution?: Resolution;
+    raise?: boolean;
+    filter?: CellFilter;
+    asScalar?: boolean;
+    at?: Id;
+};
+export declare class Sheet implements UserSheet {
+    /** @internal */
+    __gsType: string;
+    changedTime: number;
+    lastChangedTime?: number;
+    area: AreaType;
+    /** @internal */
+    private _limits;
+    get minNumRows(): number;
+    get maxNumRows(): number;
+    get minNumCols(): number;
+    get maxNumCols(): number;
+    /** @internal */
+    id: number;
+    name: string;
+    /** @internal */
+    prevName: string;
+    /** @internal */
+    status: 0 | 1 | 2;
+    /** @internal */
+    registry: Registry;
+    /** @internal */
+    idsToBeIdentified: Id[];
+    /** @internal */
+    totalWidth: number;
+    /** @internal */
+    totalHeight: number;
+    /** @internal */
+    fullHeight: number;
+    /** @internal */
+    defaultColWidth: number;
+    /** @internal */
+    defaultRowHeight: number;
+    /** @internal */
+    private version;
+    /** @internal */
+    private idMatrix;
+    /** @internal */
+    private addressCaches;
+    /** @internal */
+    private lastChangedAddresses;
+    constructor({ limits, name, registry }: Props);
+    static is(obj: any): obj is Sheet;
+    toString(): string;
+    get headerHeight(): number;
+    setHeaderHeight(height: number, historicize?: boolean): Sheet;
+    get headerWidth(): number;
+    setHeaderWidth(width: number, historicize?: boolean): Sheet;
+    /**
+     * Get the raw (mutable) cell data for a point. Unlike getCell, this returns the actual registry.data reference.
+     * @internal
+     */
+    private _pointToRawCell;
+    isRowFiltered(y: number): boolean;
+    hasActiveFilters(): boolean;
+    /**
+     * Returns true if any data cell in this sheet currently holds a Pending value
+     * (i.e. an async formula that hasn't resolved yet).
+     */
+    hasPendingCells(): boolean;
+    /**
+     * Returns a Promise that resolves when all in-flight async formula computations
+     * have completed and no data cells hold Pending values.
+     * If nothing is pending, resolves immediately.
+     * Useful for waiting before sort/filter so that cell values are fully resolved.
+     */
+    waitForPending(): Promise<void>;
+    /**
+     * Returns the addresses that were changed in the most recent `_update()` call.
+     * Useful inside `onChange` to know which cells were modified.
+     */
+    getLastChangedAddresses(): Address[];
+    /**
+     * Capture the full cell state of all filter-related header cells as a CellsByIdType snapshot.
+     * @internal
+     */
+    private _captureFilterCellStates;
+    filterRows({ x, filter, }?: {
+        x?: number;
+        filter?: FilterConfig;
+    }): Sheet;
+    /** @internal */
+    private _reapplyFilters;
+    sortRows({ x, direction }: {
+        x: number;
+        direction: 'asc' | 'desc';
+    }): Sheet;
+    /** @internal */
+    private _sortRowMapping;
+    get isInitialized(): boolean;
+    get policies(): {
+        [policyName: string]: import('../policy/core').Policy | null;
+    };
+    /** @internal */
+    getSystem(point: PointType): System | undefined;
+    /** @internal */
+    processFormula(value: any, { idMap, ...props }: ProcessFormulaProps): any;
+    /** @internal */
+    resolveFormulas(): void;
+    /** @internal */
+    getSheetBySheetName(sheetName: string): Sheet | null;
+    /** @internal */
+    getSheetBySheetId(sheetId: number): Sheet | null;
+    /** @internal */
+    private static _stack;
+    /** @internal */
+    initialize(cells: CellsByAddressType): void;
+    /** @internal */
+    private _incrementVersion;
+    /** @internal */
+    private _xsheetDispatch;
+    /** @internal */
+    private _generateId;
+    getRectSize({ top, left, bottom, right }: AreaType): RectType;
+    /** @internal */
+    setTotalSize(): void;
+    /** @internal */
+    refresh(relocate?: boolean, resize?: boolean): Sheet;
+    /** @internal */
+    clone(relocate?: boolean): Sheet;
+    /** @internal */
+    getPointById(id: Id, slideY?: number, slideX?: number): PointType & {
+        absCol: boolean;
+        absRow: boolean;
+    };
+    /** @internal */
+    getAddressById(id: Id, slideY?: number, slideX?: number): string | undefined;
+    /** @internal */
+    clearAddressCaches(): void;
+    /** @internal */
+    private _warmAddressCaches;
+    /** @internal */
+    getId(point: PointType): string;
+    /** @internal */
+    getCell(point: PointType, { resolution, raise }?: SolveOptions): CellType | undefined;
+    /** @internal */
+    get numRows(): number;
+    get numCols(): number;
+    get top(): number;
+    get left(): number;
+    get bottom(): number;
+    get right(): number;
+    /** @internal */
+    _toValueMatrix({ area, at, resolution, raise, filter, asScalar, }?: InternalToValueMatrixProps): any[][];
+    /** @internal */
+    private _pushHistory;
+    /** @internal */
+    private _cleanObsolete;
+    /** @internal */
+    private _cleanStrayed;
+    /**
+     * Remove an id from registry.data and registry.dependents entirely.
+     * @internal
+     */
+    private _deleteOrphanedId;
+    /** @internal */
+    private _copyCellLayout;
+    move({ srcSheet, src, dst, historicize, operator, undoReflection, redoReflection, }: MoveProps): Sheet;
+    /**
+     * Build MoveRelations from src area to dst area, skipping filtered rows.
+     *
+     * Layout of the returned array (processed in this order by _moveCells):
+     *   1. Entries where [0] is a newly-generated ID — these fill the vacated src cells (processed last in forward order)
+     *   2. Entries where [0] is a src address and [1] is a dst address — the actual moves (processed first in forward order, descending)
+     *   Entries whose [1] is an existing ID mean the destination cell is displaced/overflowed and
+     *   is no longer addressable; on forward pass they are skipped; on reverse pass the ID is written back.
+     */
+    /** @internal */
+    private _createMoveRelations;
+    get defaultPolicy(): PolicyType;
+    /**
+     * Apply (or reverse) a MoveRelations list.
+     *
+     * Forward (reverse=false): process descending — actual ID moves happen bottom-up so
+     *   earlier entries don't clobber later ones; vacate entries (at front of array) are
+     *   applied last.
+     * Reverse (reverse=true): process ascending — restores IDs in the natural order.
+     *
+     * On forward pass: applies policy, collects diffBefore, runs ReferencePreserver.
+     * On reverse pass: only moves IDs (caller is responsible for applyDiff(diffBefore)).
+     */
+    /** @internal */
+    private _moveCells;
+    copy({ srcSheet, src, dst, onlyValue, operator, undoReflection, redoReflection, }: MoveProps & {
+        onlyValue?: boolean;
+    }): Sheet;
+    getPolicy(point: PointType): PolicyType;
+    /** @internal */
+    private _update;
+    update({ diff, partial, updateChangedTime, historicize, operator, operation: op, ignoreFields, undoReflection, redoReflection, }: {
+        diff: CellsByAddressType;
+        partial?: boolean;
+        updateChangedTime?: boolean;
+        historicize?: boolean;
+        operator?: OperatorType;
+        operation?: OperationType;
+        ignoreFields?: CellField[];
+        undoReflection?: StorePatchType;
+        redoReflection?: StorePatchType;
+    }): Sheet;
+    /** @internal */
+    writeRawCellMatrix({ point, matrix, updateChangedTime, historicize, onlyValue, operator, undoReflection, redoReflection, }: {
+        point: PointType;
+        matrix: MatrixType<RawCellType>;
+        updateChangedTime?: boolean;
+        historicize?: boolean;
+        onlyValue?: boolean;
+        operator?: OperatorType;
+        undoReflection?: StorePatchType;
+        redoReflection?: StorePatchType;
+    }): Sheet;
+    writeMatrix(props: {
+        point: PointType;
+        matrix: MatrixType<string>;
+        updateChangedTime?: boolean;
+        historicize?: boolean;
+        operator?: OperatorType;
+        undoReflection?: StorePatchType;
+        redoReflection?: StorePatchType;
+    }): Sheet;
+    write(props: {
+        point: PointType;
+        value: string;
+        updateChangedTime?: boolean;
+        historicize?: boolean;
+        operator?: OperatorType;
+        undoReflection?: StorePatchType;
+        redoReflection?: StorePatchType;
+    }): Sheet;
+    insertRows({ y, numRows, baseY, diff, partial, updateChangedTime, operator, undoReflection, redoReflection, }: {
+        y: number;
+        numRows: number;
+        baseY: number;
+        diff?: CellsByAddressType;
+        partial?: boolean;
+        updateChangedTime?: boolean;
+        operator?: OperatorType;
+        undoReflection?: StorePatchType;
+        redoReflection?: StorePatchType;
+    }): Sheet;
+    removeRows({ y, numRows, operator, undoReflection, redoReflection, }: {
+        y: number;
+        numRows: number;
+        operator?: OperatorType;
+        undoReflection?: StorePatchType;
+        redoReflection?: StorePatchType;
+    }): Sheet;
+    insertCols({ x, numCols, baseX, diff, partial, updateChangedTime, operator, undoReflection, redoReflection, }: {
+        x: number;
+        numCols: number;
+        baseX: number;
+        diff?: CellsByAddressType;
+        partial?: boolean;
+        updateChangedTime?: boolean;
+        operator?: OperatorType;
+        undoReflection?: StorePatchType;
+        redoReflection?: StorePatchType;
+    }): Sheet;
+    removeCols({ x, numCols, operator, undoReflection, redoReflection, }: {
+        x: number;
+        numCols: number;
+        operator?: OperatorType;
+        undoReflection?: StorePatchType;
+        redoReflection?: StorePatchType;
+    }): Sheet;
+    /** @internal */
+    histories(): HistoryType[];
+    /** @internal */
+    historyIndex(): number;
+    /** @internal */
+    historySize(): number;
+    /** @internal */
+    getHistoryLimit(): number;
+    /** @internal */
+    parse(point: PointType, value: any): CellType;
+    /** @internal */
+    render(props: RenderProps): any;
+    getSerializedValue({ point, cell, resolution, }: {
+        point: PointType;
+        cell?: CellType;
+        resolution?: Resolution;
+    }): string;
+    /** @internal */
+    trim(area: AreaType): Sheet;
+    /**
+     * Solve all formulas in this sheet and return a 2D matrix of resolved values.
+     * @internal
+     */
+    solve({ raise, at }: {
+        raise?: boolean;
+        at: Id;
+    }): any[][];
+    /**
+     * Collapse this sheet to a scalar (top-left cell value).
+     * @internal
+     */
+    strip({ raise, at }: {
+        raise?: boolean;
+        at?: Id;
+    }): any;
+    /** @internal */
+    private _applyDiff;
+    undo(): {
+        history: null;
+        newSheet: Sheet;
+        callback?: undefined;
+    } | {
+        history: HistoryType;
+        callback: ({ sheetReactive: sheetRef }: StoreType) => void;
+        newSheet?: undefined;
+    };
+    redo(): {
+        history: null;
+        newSheet: Sheet;
+        callback?: undefined;
+    } | {
+        history: HistoryType;
+        callback: ({ sheetReactive: sheetRef }: StoreType) => void;
+        newSheet?: undefined;
+    };
+    /** @internal */
+    getFunctionByName(name: string): typeof import('../formula/functions/__base').BaseFunction;
+    /** @internal */
+    clearDependencies(id: Id): void;
+    /** @internal */
+    addDependency(id: Id, dependency: Id): void;
+    /** @internal */
+    getSolvedCache(point: PointType): [boolean, any];
+    /** @internal */
+    setSolvingCache(point: PointType): void;
+    /** @internal */
+    finishSolvedCache(point: PointType, value: any): void;
+    /** @internal */
+    clearSolvedCaches(): void;
+    /**
+     * Spill a 2D matrix of values starting from the origin cell.
+     * The origin cell receives matrix[0][0] and adjacent cells receive spill values in solvedCaches.
+     * For a 1×1 matrix, no spill occurs — the single value is cached directly.
+     * Throws FormulaError('#REF!') if the spill range is obstructed.
+     *
+     * @param origin  The anchor cell that produced the spill.
+     * @param matrix  The 2D array of resolved scalar values.
+     * @returns The top-left value (matrix[0][0]).
+     * @internal
+     */
+    spill(origin: PointType, matrix: any[][]): any;
+    /** @internal */
+    sheetPrefix(omit?: boolean): string;
+    /** @internal */
+    rangeToArea(range: string): {
+        top: number;
+        left: number;
+        bottom: number;
+        right: number;
+    };
+    get __raw__(): Sheet;
+    get shape(): ShapeType;
+    get hasSingleCell(): boolean;
+    get currentVersion(): number;
+}
+export {};
 //# sourceMappingURL=sheet.d.ts.map

package/dist/lib/sheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../../src/lib/sheet.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAG9C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAK9C,CAAC"}
+{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../../src/lib/sheet.ts"],"names":[],"mappings":"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"}

package/dist/lib/sheet_utils.d.ts

@@ -0,0 +1,55 @@
+import { Address, AreaType, CellsByAddressType, CellType, CellFilter, Resolution } from '../types';
+import { UserSheet } from './sheet';
+import { SolveOptions } from '../formula/solver';
+type CellField = keyof CellType;
+type ToProps = {
+    resolution?: Resolution;
+    raise?: boolean;
+    filter?: CellFilter;
+    asScalar?: boolean;
+};
+type ToCellProps = ToProps & {
+    ignoreFields?: CellField[];
+};
+/**
+ * @internal — used by Sheet._toValueMatrix and solver.ts; keeps resolution for internal wiring.
+ */
+export type ToValueMatrixProps = ToProps & {
+    area?: AreaType;
+};
+export type ToCellMatrixProps = ToCellProps & {
+    area?: AreaType;
+};
+export type ToValueObjectProps = ToProps & {
+    addresses?: Address[];
+};
+export type ToCellObjectProps = ToCellProps & {
+    addresses?: Address[];
+};
+export type ToValueRowsProps = ToProps & {
+    rows?: number[];
+};
+export type ToCellRowsProps = ToCellProps & {
+    rows?: number[];
+};
+export type ToValueColsProps = ToProps & {
+    cols?: (number | string)[];
+};
+export type ToCellColsProps = ToCellProps & {
+    cols?: (number | string)[];
+};
+export declare const getCellByAddress: (sheet: UserSheet, address: Address, options?: SolveOptions) => CellType | undefined;
+export declare const toValueMatrix: (sheet: UserSheet, { area, resolution, raise, filter, asScalar }?: ToValueMatrixProps) => any[][];
+export declare const toValueObject: (sheet: UserSheet, { resolution, raise, filter, addresses, asScalar }?: ToValueObjectProps) => {
+    [address: Address]: any;
+};
+export declare const toValueRows: (sheet: UserSheet, { resolution, raise, filter, rows, asScalar }?: ToValueRowsProps) => CellsByAddressType[];
+export declare const toValueCols: (sheet: UserSheet, { resolution, raise, filter, cols, asScalar }?: ToValueColsProps) => CellsByAddressType[];
+export declare const toCellMatrix: (sheet: UserSheet, { area, resolution, raise, filter, ignoreFields }?: ToCellMatrixProps) => (CellType | null)[][];
+export declare const toCellObject: (sheet: UserSheet, { resolution, raise, filter, addresses, ignoreFields }?: ToCellObjectProps) => CellsByAddressType;
+export declare const toCellRows: (sheet: UserSheet, { resolution, raise, filter, rows, ignoreFields }?: ToCellRowsProps) => CellsByAddressType[];
+export declare const escapeSheetName: (name: string) => string;
+export declare const toSheetPrefix: (name?: string) => string;
+export declare const toCellCols: (sheet: UserSheet, { resolution, raise, filter, cols, ignoreFields }?: ToCellColsProps) => CellsByAddressType[];
+export {};
+//# sourceMappingURL=sheet_utils.d.ts.map

package/dist/lib/sheet_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet_utils.d.ts","sourceRoot":"","sources":["../../src/lib/sheet_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAM,MAAM,UAAU,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzC,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,KAAK,SAAS,GAAG,MAAM,QAAQ,CAAC;AAEhC,KAAK,OAAO,GAAG;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,KAAK,WAAW,GAAG,OAAO,GAAG;IAC3B,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;CAC5B,CAAC;AAEF;;GAEG;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG;IACzC,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAC5C,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG;IACzC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAC5C,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG;IACvC,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAC1C,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,SAAS,EAChB,SAAS,OAAO,EAChB,UAAS,YAAiB,KACzB,QAAQ,GAAG,SAGb,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,OAAO,SAAS,EAChB,gDAAuF,kBAAuB,KAC7G,GAAG,EAAE,EAEP,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,OAAO,SAAS,EAChB,qDAA4F,kBAAuB,KAClH;IAAE,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAAA;CAgC3B,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,OAAO,SAAS,EAChB,gDAAuF,gBAAqB,KAC3G,kBAAkB,EAoBpB,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,OAAO,SAAS,EAChB,gDAAuF,gBAAqB,KAC3G,kBAAkB,EAsBpB,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,OAAO,SAAS,EAChB,oDAAwF,iBAAsB,KAC7G,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,EAkBrB,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,OAAO,SAAS,EAChB,yDAA6F,iBAAsB,KAClH,kBAqBF,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,OAAO,SAAS,EAChB,oDAAwF,eAAoB,KAC3G,kBAAkB,EAepB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAG9C,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAK7C,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,OAAO,SAAS,EAChB,oDAAwF,eAAoB,KAC3G,kBAAkB,EAiBpB,CAAC"}

package/dist/lib/spatial.d.ts

@@ -1,5 +1,4 @@
-import { MatrixType, AreaType, ZoneType, RangeType, PointType, Y, X, CellsByAddressType, ShapeType, MatricesByAddress, CellType, Address } from '../types';
-export declare const slideArea: (area: AreaType, y: Y, x: X) => AreaType;
+import { MatrixType, AreaType, ZoneType, RangeType, PointType, CellsByAddressType, ShapeType, MatricesByAddress, CellType, Address } from '../types';
 export declare const superposeArea: (srcArea: AreaType, dstArea: AreaType) => ShapeType;
 export declare const concatAreas: (area1: AreaType, area2: AreaType) => AreaType;
 export declare const zoneToArea: (zone: ZoneType) => AreaType;
@@ -10,8 +9,10 @@ export declare const among: (area: AreaType, point: PointType) => boolean;
 type ShapeExtension = {
     base?: number;
 };
-export declare const zoneShape: ({ base, ...zone }: ZoneType & ShapeExtension) => ShapeType;
-export declare const areaShape: ({ base, ...area }: AreaType & ShapeExtension) => ShapeType;
+export declare const zoneDiff: (zone: ZoneType) => ShapeType;
+export declare const zoneShape: (zone: ZoneType) => ShapeType;
+export declare const areaDiff: (area: AreaType) => ShapeType;
+export declare const areaShape: (area: AreaType) => ShapeType;
 export declare const matrixShape: ({ base, matrix }: {
     matrix: MatrixType;
 } & ShapeExtension) => ShapeType;
@@ -22,15 +23,7 @@ export declare const oa2aa: (oa: {
 export declare const aa2oa: (aa: MatrixType, fields: string[]) => {
     [s: string]: any;
 }[];
-type PutMatrixFilterProps<T = any> = {
-    srcValue: T;
-    dstValue: T;
-    srcPoint: PointType;
-    dstPoint: PointType;
-};
-export declare const putMatrix: <T = any>(dst: T[][], src: T[][], dstArea: AreaType, filter?: (arg: PutMatrixFilterProps) => boolean) => MatricesByAddress<T>;
 export declare const createMatrix: <T = any>(numRows: number, numCols: number, fill?: T) => T[][];
-export declare const cropMatrix: <T = any>(matrix: T[][], area: AreaType) => T[][];
 export declare const buildInitialCellsFromOrigin: ({ cells, ensured, matrix, flattenAs, origin, }: {
     cells?: CellsByAddressType;
     ensured?: {
@@ -61,17 +54,10 @@ export declare const getMaxSizesFromCells: (cells?: CellsByAddressType) => {
 };
 export declare const range: (start: number, end: number) => number[];
 export declare const complementSelectingArea: (selectingArea: AreaType, choosing: PointType) => AreaType;
-export declare const isSameArea: (area1: AreaType, area2: AreaType) => boolean;
 export declare const expandRange: (range: string) => Address[];
 export declare const restrictZone: (zone: ZoneType) => ZoneType;
 export type BinarySearchPredicate = (mid: number) => boolean;
 export declare const binarySearch: (low: number, high: number, predicate: BinarySearchPredicate, lessThan: boolean) => number;
-export declare const moveKey: (obj: any, keyFrom: string, keyTo: string) => void;
-export declare const invertObject: (obj: {
-    [key: string]: string;
-}) => {
-    [value: string]: string;
-};
 /**
  * Convert a list of addresses into an array of bounding areas.
  * Adjacent cells (4-connected: up/down/left/right) are grouped into the same area.
@@ -88,7 +74,6 @@ export declare const addressesToCols: (addresses: Address[], asc?: boolean | nul
  * @param asc - true: ascending, false: descending, null: insertion order
  */
 export declare const addressesToRows: (addresses: Address[], asc?: boolean | null) => number[];
-export declare const isAreaNotSelected: (area: AreaType) => boolean;
 export declare const isZoneNotSelected: (zone: ZoneType) => boolean;
 export {};
 //# sourceMappingURL=spatial.d.ts.map

package/dist/lib/spatial.d.ts.map

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