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

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

@@ -1,9 +1,10 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class DivideFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected validate(args: any[]): any[];
     protected main(divided: number, divisor: number): number;
 }
 //# sourceMappingURL=divide.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class EqFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
     protected main(v1: any, v2: any): boolean;
 }
 //# sourceMappingURL=eq.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class GtFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: number, v2: number): boolean;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(v1: any, v2: any): boolean;
 }
 //# sourceMappingURL=gt.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class GteFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: number, v2: number): boolean;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(v1: any, v2: any): boolean;
 }
 //# sourceMappingURL=gte.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class IfFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(condition: boolean, v1: any, v2?: any): any;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(condition: any, v1: any, v2?: any): any;
 }
 //# sourceMappingURL=if.d.ts.map

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

@@ -1,12 +1,10 @@
-import { FunctionProps, HelpArg } from './__base';
-export declare class IfErrorFunction {
+import { FunctionArgumentDefinition, BaseFunction, FunctionCategory } from './__base';
+export declare class IfErrorFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    private args;
-    private table;
-    constructor({ args, table }: FunctionProps);
-    protected validate(): void;
-    call(): any;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected broadcastDisabled: boolean;
+    protected main(value: any, valueIfError?: any): any;
 }
 //# sourceMappingURL=iferror.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class LenFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(text: string): number;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(text: any): number;
 }
 //# sourceMappingURL=len.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class LtFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: number, v2: number): boolean;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(v1: any, v2: any): boolean;
 }
 //# sourceMappingURL=lt.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class LteFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: number, v2: number): boolean;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(v1: any, v2: any): boolean;
 }
 //# sourceMappingURL=lte.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class MaxFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(...values: number[]): number;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(...values: any[]): number;
 }
 //# sourceMappingURL=max.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class MinFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(...values: number[]): number;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(...values: any[]): number;
 }
 //# sourceMappingURL=min.d.ts.map

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

@@ -1,10 +1,10 @@
-import { TimeDelta } from '../../lib/time';
-import { BaseFunction, HelpArg } from './__base';
+import { Time } from '../../lib/time';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class MinusFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: number | Date | TimeDelta, v2: number | Date | TimeDelta): number | Date | TimeDelta;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(v1: number | Date | Time, v2: number | Date | Time): number | Date | Time;
 }
 //# sourceMappingURL=minus.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class MultiplyFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: number, v2: number): number;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(v1: any, v2: any): number;
 }
 //# sourceMappingURL=multiply.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class NeFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
     protected main(v1: number, v2: number): boolean;
 }
 //# sourceMappingURL=ne.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class NotFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: boolean): boolean;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(v1: any): boolean;
 }
 //# sourceMappingURL=not.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class NowFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
     protected main(): Date;
 }
 //# sourceMappingURL=now.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class OrFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(...values: boolean[]): boolean;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(...values: any[]): boolean;
 }
 //# sourceMappingURL=or.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class PowerFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(base: number, exponent: number): number;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(base: any, exponent: any): number;
 }
 //# sourceMappingURL=power.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class SumFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(...values: number[]): number;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(...values: any[]): number;
 }
 //# sourceMappingURL=sum.d.ts.map

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

@@ -1,9 +1,9 @@
-import { BaseFunction, HelpArg } from './__base';
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
 export declare class UminusFunction extends BaseFunction {
     example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: number): number;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(v1: any): number;
 }
 //# sourceMappingURL=uminus.d.ts.map

package/dist/formula/mapping.d.ts

@@ -1,10 +1,11 @@
-import { FunctionMapping, HelpArg } from './functions/__base';
+import { FunctionCategory, FunctionMapping, FunctionArgumentDefinition } from './functions/__base';
 export declare const functions: FunctionMapping;
 export type FunctionHelp = {
     name: string;
+    category: FunctionCategory;
     example: string;
-    helpTexts: string[];
-    helpArgs: HelpArg[];
+    description: string;
+    defs: FunctionArgumentDefinition[];
 };
 export declare const getFunctionHelps: (customFunctions?: FunctionMapping) => FunctionHelp[];
 //# sourceMappingURL=mapping.d.ts.map

package/dist/formula/solver.d.ts

@@ -1,26 +1,39 @@
-import { Table } from '../lib/table';
-import { Id, MatrixType, PointType, RefEvaluation } from '../types';
+import { Sheet } from '../lib/sheet';
+import { Id, MatrixType, PointType, Resolution } from '../types';
+export type SolveOptions = {
+    raise?: boolean;
+    resolution?: Resolution;
+};
 type SolveFormulaProps = {
     value: any;
-    table: Table;
+    sheet: Sheet;
+    point: PointType;
     raise?: boolean;
-    refEvaluation?: RefEvaluation;
-    origin: PointType;
+    resolution?: Resolution;
+    at?: Id;
 };
-export declare const solveFormula: ({ value, table, raise, refEvaluation, origin }: SolveFormulaProps) => any;
-type SolveTableProps = {
-    table: Table;
+/**
+ * Evaluates a single cell value (formula or literal) within the context of a sheet.
+ * Handles caching, circular reference detection, spilling, and async pending states.
+ * Returns the resolved scalar value (or error) for the given cell.
+ */
+export declare const solveFormula: ({ value, sheet, point, raise, resolution, at }: SolveFormulaProps) => any;
+export type SolveSheetProps = {
+    sheet: Sheet;
     raise?: boolean;
-    refEvaluation?: RefEvaluation;
+    at?: Id;
 };
-export declare const solveTable: ({ table, raise }: SolveTableProps) => MatrixType;
-export type StripTableProps = {
+/**
+ * Evaluates all cells in a Sheet and returns the results as a 2D array (MatrixType).
+ * Each cell formula is resolved in order, with caching to avoid redundant computation.
+ * Use this when you need the full evaluated contents of a range.
+ */
+export declare const solveSheet: ({ sheet, raise, at }: SolveSheetProps) => MatrixType;
+export type StripSheetProps = {
     value: any;
-    y?: number;
-    x?: number;
+    at?: Id;
     raise?: boolean;
-    history?: Set<Id>;
 };
-export declare const stripTable: ({ value, y, x, raise, history }: StripTableProps) => any;
+export declare const stripSheet: ({ value, at, raise }: StripSheetProps) => any;
 export {};
 //# sourceMappingURL=solver.d.ts.map

package/dist/index.d.ts

@@ -1,34 +1,36 @@
-export { GridSheet, createConnector, useConnector } from './components/GridSheet';
-export { Renderer } from './renderers/core';
-export type { RendererMixinType, RendererCallProps, RenderProps } from './renderers/core';
-export { Parser } from './parsers/core';
-export type { ParserMixinType } from './parsers/core';
-export { oa2aa, aa2oa, buildInitialCells, buildInitialCellsFromOrigin, zoneToArea, areaToZone, areaToRange, addressesToAreas, addressesToCols, addressesToRows, } from './lib/spatial';
-export { TimeDelta } from './lib/time';
-export { x2c, c2x, y2r, r2y, p2a, a2p } from './lib/coords';
-export { updateTable } from './store/actions';
+export { GridSheet, createSheetRef, useSheetRef, createStoreRef, useStoreRef } from './components/GridSheet';
+export { oa2aa, aa2oa, buildInitialCells, buildInitialCellsFromOrigin, zoneToArea, areaToZone, areaToRange, matrixShape, addressesToAreas, addressesToCols, addressesToRows, } from './lib/spatial';
+export { Time } from './lib/time';
+export { x2c, c2x, y2r, r2y, p2a, a2p, rh, ch } from './lib/coords';
+export { updateSheet } from './store/actions';
 export { PluginBase, useInitialPluginContext, usePluginContext } from './components/PluginBase';
-export type { MatrixType, CellType, Address, AsyncCache, FilterCondition, FilterConditionMethod, FilterConfig, FeedbackType, OptionsType, WriterType, CellsByAddressType, CellsByIdType, ModeType, HeadersType, HistoryType, HistorySortRowsType, StoreType, PointType, AreaType, ZoneType, Props, Connector, EditorEvent, CursorStateType, } from './types';
-export type { HubType, HubProps, WireProps, TransmitProps } from './lib/hub';
-export { Wire, useHub, createHub } from './lib/hub';
+export { MenuItem, MenuDivider } from './components/MenuItem';
+export type { MatrixType, CellType, System, Address, AsyncCache, FilterCondition, FilterConditionMethod, FilterConfig, FeedbackType, OptionsType, WriterType, CellsByAddressType, CellsByIdType, SystemsByIdType, ModeType, HeadersType, HistoryType, HistorySortRowsType, StoreType, PointType, AreaType, ZoneType, Props, SheetHandle, StoreHandle, EditorEvent, CursorStateType, } from './types';
+export type { BookType, BookProps, RegistryProps, TransmitProps } from './lib/book';
+export { Registry, useBook, createBook } from './lib/book';
 export type { Dispatcher } from './store';
-export { ThousandSeparatorRendererMixin } from './renderers/thousand_separator';
-export { CheckboxRendererMixin } from './renderers/checkbox';
-export { BaseFunction, BaseFunctionSync, BaseFunctionAsync } from './formula/functions/__base';
-export { FormulaError, Lexer, FormulaParser } from './formula/evaluator';
-export { Table, type UserTable } from './lib/table';
+export { ThousandSeparatorPolicyMixin } from './policy/thousand_separator';
+export { CheckboxPolicyMixin } from './policy/checkbox';
+export { BaseFunction, BaseFunctionAsync } from './formula/functions/__base';
+export type { FunctionProps, FunctionArgumentDefinition as FunctionArgumentDefinition, FunctionCategory, FunctionMapping, } from './formula/functions/__base';
+export { Lexer, FormulaParser, RefEntity, ValueEntity, RangeEntity } from './formula/evaluator';
+export { FormulaError } from './formula/formula-error';
+export { Sheet, type UserSheet, type SheetLimits } from './lib/sheet';
+export { toValueMatrix, toValueObject, toValueRows, toValueCols, toCellMatrix, toCellObject, toCellRows, toCellCols, type ToValueMatrixProps, type ToValueObjectProps, type ToValueRowsProps, type ToValueColsProps, type ToCellMatrixProps, type ToCellObjectProps, type ToCellRowsProps, type ToCellColsProps, } from './lib/sheet_utils';
 export { Policy } from './policy/core';
-export type { PolicyType, AutocompleteOption, PolicyMixinType } from './policy/core';
+export type { PolicyType, AutocompleteOption, PolicyMixinType, RenderProps, SerializeProps, SelectProps, SelectFallbackProps, SerializeForClipboardProps, } from './policy/core';
 export * as operations from './lib/operation';
 export { DEFAULT_HISTORY_LIMIT } from './constants';
-export { Pending } from './sentinels';
+export { Pending, Spilling } from './sentinels';
 export { userActions } from './store/actions';
-export { clip } from './lib/clipboard';
+export { clip, sheet2csv } from './lib/clipboard';
 export { makeBorder } from './styles/utils';
-export { syncers } from './store/dispatchers';
-export { ensureString, ensureNumber, ensureBoolean } from './formula/functions/__utils';
+export { applyers } from './store/dispatchers';
+export type { MenuContext, MenuItemBase, MenuComponentItem, ContextMenuItemDescriptor, RowMenuItemDescriptor, ColMenuItemDescriptor, MenuDividerItem, ContextMenuSectionProps, RowMenuSectionProps, ColMenuSectionProps, } from './lib/menu';
+export { defaultContextMenuDescriptors, defaultRowMenuDescriptors, defaultColMenuDescriptors, registerMenuComponent, } from './lib/menu';
+export { ensureString, ensureNumber, ensureBoolean, check, eachMatrix, createBooleanMask, } from './formula/functions/__utils';
 export type { EnsureNumberOptions, EnsureBooleanOptions } from './formula/functions/__utils';
-export { solveTable } from './formula/solver';
+export { conditionArg, stripMatrix } from './formula/functions/__base';
 //# sourceMappingURL=index.d.ts.map
 export { h, render } from "preact";
 export {