@gridsheet/preact-core 3.0.0-rc.1 → 3.0.0-rc.3

package/dist/types.d.ts

@@ -1,18 +1,29 @@
-import { RendererType } from './renderers/core';
-import { ParserType } from './parsers/core';
-import { UserTable, Table } from './lib/table';
-import { FC, RefObject, CSSProperties, KeyboardEvent } from 'react';
-import { HubType, TransmitProps } from './lib/hub';
+import { UserSheet, Sheet, SheetLimits } from './lib/sheet';
+import { RefObject, CSSProperties, KeyboardEvent } from 'react';
+import { BookType, TransmitProps } from './lib/book';
 import { PolicyType } from './policy/core';
 import { Dispatcher } from './store';
-export type RefEvaluation = 'COMPLETE' | 'TABLE' | 'RAW' | 'SYSTEM';
+import { ContextMenuItemDescriptor, RowMenuItemDescriptor, ColMenuItemDescriptor } from './lib/menu';
+/**
+ * Controls how formula values are resolved when reading a cell.
+ *
+ * - `'RESOLVED'` (default) — Fully evaluates formulas to a scalar value.
+ *   Range references (e.g. `=C1:F1`) are unwrapped to the top-left scalar.
+ * - `'EVALUATED'` — Evaluates formulas one level deep but keeps range/Sheet
+ *   results intact. Use this when you need the `Sheet` object a range formula
+ *   produces (e.g. in `renderSheet` policy hooks).
+ * - `'RAW'` — Returns the formula string with cell addresses resolved to their
+ *   display form; does not evaluate.
+ * - `'SYSTEM'` — Returns the raw stored value with no evaluation or transformation.
+ */
+export type Resolution = 'RESOLVED' | 'EVALUATED' | 'RAW' | 'SYSTEM';
 export type Y = number;
 export type X = number;
 export type Height = number;
 export type Width = number;
 export type ShapeType = {
-    height: Height;
-    width: Width;
+    rows: number;
+    cols: number;
 };
 export type RectType = {
     y: Y;
@@ -21,16 +32,6 @@ export type RectType = {
     width: Width;
 };
 export type MatrixType<T = any> = T[][];
-export type Labeler = (n: number) => string;
-export type Renderers = {
-    [s: string]: RendererType;
-};
-export type Parsers = {
-    [s: string]: ParserType;
-};
-export type Labelers = {
-    [s: string]: Labeler;
-};
 export type Policies = {
     [s: string]: PolicyType;
 };
@@ -40,7 +41,7 @@ export type CursorStateType = {
     selectingTo: PointType;
 };
 export type FeedbackType = (args: {
-    table: UserTable;
+    sheet: UserSheet;
     points?: CursorStateType;
 }) => void;
 export type ModeType = 'light' | 'dark';
@@ -55,12 +56,17 @@ export type System = {
     id?: string;
     sheetId?: number;
     changedTime?: number;
-    dependents?: Set<string>;
-    /** Cumulative top offset (px) from table origin. Set on row-header cells (x=0). */
+    /** Cumulative top offset (px) from sheet origin. Set on row-header cells (x=0). */
     offsetTop?: number;
-    /** Cumulative left offset (px) from table origin. Set on col-header cells (y=0). */
+    /** Cumulative left offset (px) from sheet origin. Set on col-header cells (y=0). */
     offsetLeft?: number;
     tmpAsyncCaches?: Record<string, AsyncCache>;
+    /** Address of the origin cell whose array formula spilled its value into this cell. */
+    spilledFrom?: Address;
+    /** IDs of cells whose formula depends on this cell. */
+    dependents?: Set<Id>;
+    /** IDs of cells that this cell's formula depends on. */
+    dependencies?: Set<Id>;
 };
 export type FilterConditionMethod = 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'blank' | 'nonblank' | 'includes' | 'excludes';
 export type FilterCondition = {
@@ -77,29 +83,31 @@ export type CellType<T = any, Custom = any> = {
     justifyContent?: CSSProperties['justifyContent'];
     alignItems?: CSSProperties['alignItems'];
     label?: string;
-    labeler?: string;
     width?: Width;
     height?: Height;
-    renderer?: string;
-    parser?: string;
     policy?: string;
     custom?: Custom;
-    disableFormula?: boolean;
+    formulaEnabled?: boolean;
     prevention?: OperationType;
-    _sys?: System;
     /** Cached result from an async formula. Stored directly on the cell for serializability. */
     asyncCaches?: Record<string, AsyncCache>;
     /** Filter configuration. Set on col-header cells (y=0). */
     filter?: FilterConfig;
     /** Whether this row is hidden by a filter. Set on row-header cells (x=0). */
     filtered?: boolean;
+    /** If true, this row is excluded from sort and stays at its original position. Set on row-header cells (x=0). */
+    sortFixed?: boolean;
+    /** If true, this row is always visible regardless of active filters. Set on row-header cells (x=0). */
+    filterFixed?: boolean;
 };
 export type RawCellType = {
     value?: string;
     style?: CSSProperties;
     skip?: boolean;
 };
-export type CellPatchType = CellType;
+export type CellPatchType<T = any> = Partial<CellType> & {
+    value: T;
+};
 export type CellFilter = (cell: CellType) => boolean;
 export type CellsByAddressType = {
     [address: string]: CellType;
@@ -107,19 +115,20 @@ export type CellsByAddressType = {
 export type CellsByIdType = {
     [id: Id]: CellType | undefined;
 };
+export type SystemsByIdType = {
+    [id: Id]: System;
+};
 export type OptionsType = {
     sheetHeight?: number;
     sheetWidth?: number;
     sheetResize?: CSSProperties['resize'];
     editingOnEnter?: boolean;
-    showAddress?: boolean;
     showFormulaBar?: boolean;
-    minNumRows?: number;
-    maxNumRows?: number;
-    minNumCols?: number;
-    maxNumCols?: number;
+    limits?: SheetLimits;
     mode?: ModeType;
-    contextMenuItems?: FC<ContextMenuProps>[];
+    contextMenu?: ContextMenuItemDescriptor[];
+    rowMenu?: RowMenuItemDescriptor[];
+    colMenu?: ColMenuItemDescriptor[];
 };
 export type RangeType = {
     start: number;
@@ -134,7 +143,7 @@ export type ExtraPointType = {
     x: X;
     absY?: boolean;
     absX?: boolean;
-    table?: Table;
+    sheet?: Sheet;
 };
 export type PositionType = {
     y: Y;
@@ -155,7 +164,7 @@ export type AreaType = {
 export type WriterType = (value: string) => void;
 export type StoreType = {
     sheetId: number;
-    tableReactive: RefObject<Table>;
+    sheetReactive: RefObject<Sheet>;
     rootRef: RefObject<HTMLDivElement>;
     flashRef: RefObject<HTMLDivElement>;
     mainRef: RefObject<HTMLDivElement>;
@@ -175,10 +184,6 @@ export type StoreType = {
     dragging: boolean;
     sheetHeight: number;
     sheetWidth: number;
-    minNumRows: number;
-    maxNumRows: number;
-    minNumCols: number;
-    maxNumCols: number;
     mode: ModeType;
     searchQuery?: string;
     searchCaseSensitive: boolean;
@@ -187,9 +192,10 @@ export type StoreType = {
     matchingCells: string[];
     matchingCellIndex: number;
     editingOnEnter: boolean;
-    showAddress: boolean;
     contextMenuPosition: PositionType;
-    contextMenuItems: FC<ContextMenuProps>[];
+    contextMenu: ContextMenuItemDescriptor[];
+    rowMenu: RowMenuItemDescriptor[];
+    colMenu: ColMenuItemDescriptor[];
     resizingPositionY: [Y, Y, Y];
     resizingPositionX: [X, X, X];
     columnMenuState: {
@@ -206,22 +212,21 @@ export type Manager<T> = {
     instance: T;
     sync: T extends StoreType ? Dispatcher : (instance: T) => void;
 };
-export type Connector = {
-    tableManager: {
-        table: UserTable;
-        sync: (table: UserTable) => void;
-    };
-    storeManager: {
-        store: StoreType;
-        sync: (store: StoreType) => void;
-        dispatch: Dispatcher;
-    };
+export type SheetHandle = {
+    sheet: UserSheet;
+    apply: (sheet: UserSheet) => void;
+};
+export type StoreHandle = {
+    store: StoreType;
+    apply: (store: StoreType) => void;
+    dispatch: Dispatcher;
 };
 export type Props = {
     initialCells: CellsByAddressType;
     sheetName?: string;
-    hub?: HubType;
-    connector?: RefObject<Connector | null>;
+    book?: BookType;
+    sheetRef?: RefObject<SheetHandle | null>;
+    storeRef?: RefObject<StoreHandle | null>;
     options?: OptionsType;
     className?: string;
     style?: CSSProperties;
@@ -361,5 +366,4 @@ export type EditorEventWithNativeEvent = EditorEvent & {
         isComposing: boolean;
     };
 };
-export type ContextMenuProps = StoreDispatchType;
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gridsheet/preact-core",
-  "version": "3.0.0-rc.1",
+  "version": "3.0.0-rc.3",
   "description": "Spreadsheet component for Preact",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/dist/formula/functions/acos.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class AcosFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number): number;
-}
-//# sourceMappingURL=acos.d.ts.map

package/dist/formula/functions/asin.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class AsinFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number): number;
-}
-//# sourceMappingURL=asin.d.ts.map

package/dist/formula/functions/atan.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class AtanFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number): number;
-}
-//# sourceMappingURL=atan.d.ts.map

package/dist/formula/functions/atan2.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class Atan2Function extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(x: number, y: number): number;
-}
-//# sourceMappingURL=atan2.d.ts.map

package/dist/formula/functions/col.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class ColFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(left: number): number;
-}
-//# sourceMappingURL=col.d.ts.map

package/dist/formula/functions/concatenate.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class ConcatenateFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(...values: string[]): string;
-}
-//# sourceMappingURL=concatenate.d.ts.map

package/dist/formula/functions/cos.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class CosFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(angle: number): number;
-}
-//# sourceMappingURL=cos.d.ts.map

package/dist/formula/functions/countif.d.ts

@@ -1,10 +0,0 @@
-import { Table } from '../../lib/table';
-import { BaseFunction, HelpArg } from './__base';
-export declare class CountifFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(table: Table, condition: string): number;
-}
-//# sourceMappingURL=countif.d.ts.map

package/dist/formula/functions/exp.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class ExpFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(exponent: number): number;
-}
-//# sourceMappingURL=exp.d.ts.map

package/dist/formula/functions/hlookup.d.ts

@@ -1,10 +0,0 @@
-import { Table } from '../../lib/table';
-import { BaseFunction, HelpArg } from './__base';
-export declare class HlookupFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(key: any, range: Table, index: number, isSorted: boolean): any;
-}
-//# sourceMappingURL=hlookup.d.ts.map

package/dist/formula/functions/index.d.ts

@@ -1,10 +0,0 @@
-import { Table } from '../../lib/table';
-import { BaseFunction, HelpArg } from './__base';
-export declare class IndexFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(table: Table, y?: number, x?: number): Table;
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/formula/functions/lenb.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class LenbFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(text: string): number;
-}
-//# sourceMappingURL=lenb.d.ts.map

package/dist/formula/functions/ln.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class LnFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number): number;
-}
-//# sourceMappingURL=ln.d.ts.map

package/dist/formula/functions/log.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class LogFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number, base: number): number;
-}
-//# sourceMappingURL=log.d.ts.map

package/dist/formula/functions/log10.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class Log10Function extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number): number;
-}
-//# sourceMappingURL=log10.d.ts.map

package/dist/formula/functions/match.d.ts

@@ -1,10 +0,0 @@
-import { Table } from '../../lib/table';
-import { BaseFunction, HelpArg } from './__base';
-export declare class MatchFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(searchKey: any, range: Table, searchType?: number): number;
-}
-//# sourceMappingURL=match.d.ts.map

package/dist/formula/functions/match.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=match.test.d.ts.map

package/dist/formula/functions/mod.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class ModFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: number, v2: number): number;
-}
-//# sourceMappingURL=mod.d.ts.map

package/dist/formula/functions/pi.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class PiFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(): number;
-}
-//# sourceMappingURL=pi.d.ts.map

package/dist/formula/functions/product.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class ProductFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(...values: number[]): number;
-}
-//# sourceMappingURL=product.d.ts.map

package/dist/formula/functions/radians.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class RadiansFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(angle: number): number;
-}
-//# sourceMappingURL=radians.d.ts.map

package/dist/formula/functions/rand.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class RandFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(): number;
-}
-//# sourceMappingURL=rand.d.ts.map

package/dist/formula/functions/round.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class RoundFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number, digit?: number): number;
-}
-//# sourceMappingURL=round.d.ts.map

package/dist/formula/functions/rounddown.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class RounddownFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number, digit?: number): number;
-}
-//# sourceMappingURL=rounddown.d.ts.map

package/dist/formula/functions/roundup.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class RoundupFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number, digit?: number): number;
-}
-//# sourceMappingURL=roundup.d.ts.map

package/dist/formula/functions/row.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class RowFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(top: number): number;
-}
-//# sourceMappingURL=row.d.ts.map

package/dist/formula/functions/sin.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class SinFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(angle: number): number;
-}
-//# sourceMappingURL=sin.d.ts.map

package/dist/formula/functions/sqrt.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class SqrtFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number): number;
-}
-//# sourceMappingURL=sqrt.d.ts.map

package/dist/formula/functions/sumif.d.ts

@@ -1,10 +0,0 @@
-import { Table } from '../../lib/table';
-import { BaseFunction, HelpArg } from './__base';
-export declare class SumifFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(range: Table, condition: string, sumRange: Table): number;
-}
-//# sourceMappingURL=sumif.d.ts.map

package/dist/formula/functions/tan.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class TanFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(angle: number): number;
-}
-//# sourceMappingURL=tan.d.ts.map

package/dist/formula/functions/vlookup.d.ts

@@ -1,10 +0,0 @@
-import { Table } from '../../lib/table';
-import { BaseFunction, HelpArg } from './__base';
-export declare class VlookupFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(key: any, range: Table, index: number, isSorted: boolean): any;
-}
-//# sourceMappingURL=vlookup.d.ts.map