@gridsheet/preact-core 3.0.0-rc.7 → 3.0.0-rc.8

package/dist/lib/operation.d.ts

@@ -1,31 +0,0 @@
-import { OperationType as operations } from '../types';
-export declare const RemoveRows: operations;
-export declare const RemoveCols: operations;
-export declare const InsertRowsAbove: operations;
-export declare const InsertRowsBelow: operations;
-export declare const InsertColsLeft: operations;
-export declare const InsertColsRight: operations;
-export declare const MoveFrom: operations;
-export declare const MoveTo: operations;
-export declare const Write: operations;
-export declare const Style: operations;
-export declare const Copy: operations;
-export declare const Resize: operations;
-export declare const SetPolicy: operations;
-export declare const Sort: operations;
-export declare const Filter: operations;
-export declare const SetLabel: operations;
-export declare const NoOperation: operations;
-export declare const Move: operations;
-export declare const Update: operations;
-export declare const InsertRows: operations;
-export declare const InsertCols: operations;
-export declare const Add: operations;
-export declare const Delete: operations;
-export declare const ReadOnly: operations;
-export declare const ColumnMenu: operations;
-export declare const RowMenu: operations;
-export declare const ViewOnly: operations;
-export declare const hasOperation: (operation: operations | undefined, flag: operations) => boolean;
-export declare const debugOperations: (prevention: operations | undefined) => string[];
-//# sourceMappingURL=operation.d.ts.map

package/dist/lib/palette.d.ts

@@ -1,2 +0,0 @@
-export declare const COLOR_PALETTE: string[];
-//# sourceMappingURL=palette.d.ts.map

package/dist/lib/popup.d.ts

@@ -1,24 +0,0 @@
-/**
- * lib/popup.ts
- *
- * Utility functions for computing the position of floating UI elements
- * (tooltips, dropdowns, autocomplete lists, function guides, etc.)
- * so they don't overflow the viewport.
- */
-export type HAlign = 'left' | 'right';
-export type VAlign = 'top' | 'bottom';
-export type PopupPosition = {
-    x: number;
-    y: number;
-    hAlign: HAlign;
-};
-export declare const calcBelowPosition: (rect: DOMRect, maxWidth?: number, margin?: number) => PopupPosition;
-export declare const clampLeft: (left: number, width: number, margin?: number) => number;
-export type SideStyle = {
-    left: string;
-    right: string;
-};
-export declare const calcSideStyle: (el: HTMLElement, gap?: number) => SideStyle;
-export declare const clampPopup: (el: HTMLElement) => void;
-export declare const hAlignTransform: (hAlign: HAlign) => string;
-//# sourceMappingURL=popup.d.ts.map

package/dist/lib/reference.d.ts

@@ -1,19 +0,0 @@
-import { CellsByIdType, Id } from '../types';
-import { Sheet } from './sheet';
-export declare class ReferencePreserver {
-    map: {
-        [id: Id]: Id;
-    };
-    private sheet;
-    private dependentIds;
-    constructor(sheet: Sheet);
-    collectDependents(...ids: Id[]): void;
-    /**
-     * Compare two idMatrix snapshots (`before` and `after`) and populate
-     * `this.map` and collect dependents for every position where the occupying
-     * cell ID changed. Works for any rearrangement (sort, move, etc.).
-     */
-    buildMap(before: Id[], after: Id[]): void;
-    resolveDependents(operation?: 'move' | 'removeRows' | 'removeCols'): CellsByIdType;
-}
-//# sourceMappingURL=reference.d.ts.map

package/dist/lib/sheet.d.ts

@@ -1,508 +0,0 @@
-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_utils.d.ts

@@ -1,55 +0,0 @@
-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