@gridsheet/preact-core 3.0.0-rc.0 → 3.0.0-rc.10

package/dist/components/GridSheet.d.ts

@@ -1,5 +0,0 @@
-import { Connector, Props } from '../types';
-export declare const createConnector: () => import('react').RefObject<Connector | null>;
-export declare const useConnector: () => import('react').MutableRefObject<Connector | null>;
-export declare function GridSheet({ initialCells, sheetName, connector: initialConnector, options, className, style, hub: initialHub, }: Props): JSX.Element;
-//# sourceMappingURL=GridSheet.d.ts.map

package/dist/components/StoreObserver.d.ts

@@ -1,11 +0,0 @@
-import { FC, MutableRefObject } from 'react';
-import { OptionsType, Connector } from '../types';
-type StoreObserverProps = OptionsType & {
-    sheetName?: string;
-    connector?: MutableRefObject<Connector | null>;
-};
-export declare const createConnector: () => import('react').RefObject<Connector | null>;
-export declare const useConnector: () => MutableRefObject<Connector | null>;
-export declare const StoreObserver: FC<StoreObserverProps>;
-export {};
-//# sourceMappingURL=StoreObserver.d.ts.map

package/dist/constants.d.ts

@@ -1,30 +0,0 @@
-import { ZoneType } from './types';
-export declare const DEFAULT_HISTORY_LIMIT = 20;
-export declare const DEFAULT_HEIGHT = 24;
-export declare const DEFAULT_WIDTH = 90;
-export declare const SHEET_HEIGHT = 500;
-export declare const SHEET_WIDTH = 1000;
-export declare const HEADER_HEIGHT = 24;
-export declare const HEADER_WIDTH = 50;
-export declare const MIN_WIDTH = 5;
-export declare const MIN_HEIGHT = 5;
-export declare const OVERSCAN_X = 5;
-export declare const OVERSCAN_Y = 10;
-export declare const DEFAULT_ALPHABET_CACHE_SIZE = 1000;
-export declare class Special {
-    name: string;
-    constructor(name: string);
-}
-/**
- * Sentinel value representing an in-flight async formula computation.
- * Cells whose solved cache contains a Pending will render a loading indicator.
- * Dependent cells that encounter a Pending value also become pending.
- */
-export declare class Pending {
-    promise: Promise<any>;
-    constructor(promise: Promise<any>);
-}
-export declare const SECONDS_IN_DAY = 86400;
-export declare const FULLDATE_FORMAT_UTC = "YYYY-MM-DDTHH:mm:ss.SSSZ";
-export declare const RESET_ZONE: ZoneType;
-//# sourceMappingURL=constants.d.ts.map

package/dist/formula/evaluator.d.ts

@@ -1,136 +0,0 @@
-import { Table } from '../lib/table';
-import { Id, PointType } from '../types';
-type EvaluateProps = {
-    table: Table;
-};
-export type IdentifyProps = {
-    table: Table;
-    slideY?: number;
-    slideX?: number;
-    operation?: 'move' | 'removeRows' | 'removeCols';
-    dependency: string;
-    idMap?: {
-        [id: string]: string;
-    };
-};
-export type DisplayProps = {
-    table: Table;
-    slideY?: number;
-    slideX?: number;
-};
-export declare class FormulaError {
-    code: string;
-    message: string;
-    error?: Error;
-    __isFormulaError: boolean;
-    constructor(code: string, message: string, error?: Error);
-    static is(obj: any): boolean;
-}
-declare class Entity<T = any> {
-    value: T;
-    constructor(value: T);
-}
-export declare class ValueEntity extends Entity {
-    evaluate(): any;
-}
-export declare class UnreferencedEntity extends Entity {
-    evaluate(): void;
-}
-export declare class InvalidRefEntity extends Entity<string> {
-    evaluate(): void;
-}
-export declare class RefEntity extends Entity<string> {
-    constructor(value: string);
-    stringify(): string;
-    evaluate({ table }: EvaluateProps): Table;
-    identify(props: IdentifyProps): string;
-}
-export declare class RangeEntity extends Entity<string> {
-    stringify(): string;
-    evaluate({ table }: EvaluateProps): Table;
-    identify(props: IdentifyProps): string;
-}
-export declare class IdEntity extends Entity<string> {
-    private parse;
-    evaluate({ table }: EvaluateProps): Table;
-    display({ table, slideY, slideX }: DisplayProps): string;
-    identify(props: IdentifyProps): string;
-}
-export declare class IdRangeEntity extends Entity<string> {
-    private parse;
-    evaluate({ table }: EvaluateProps): Table;
-    display({ table, slideY, slideX }: DisplayProps): string;
-    identify(props: IdentifyProps): string | undefined;
-}
-export declare class FunctionEntity {
-    args: Expression[];
-    name: string;
-    precedence: number;
-    private origin?;
-    constructor(name: string, precedence?: number, args?: Expression[], origin?: PointType);
-    evaluate({ table }: EvaluateProps): any;
-}
-export type Expression = ValueEntity | RefEntity | RangeEntity | IdEntity | IdRangeEntity | FunctionEntity | UnreferencedEntity | InvalidRefEntity;
-export type TokenType = 'VALUE' | 'REF' | 'RANGE' | 'ID' | 'ID_RANGE' | 'FUNCTION' | 'PREFIX_OPERATOR' | 'INFIX_OPERATOR' | 'POSTFIX_OPERATOR' | 'OPEN' | 'CLOSE' | 'COMMA' | 'SPACE' | 'UNREFERENCED' | 'INVALID_REF';
-export declare class Token {
-    type: TokenType;
-    entity: any;
-    precedence: number;
-    private origin?;
-    constructor(type: TokenType, entity: any, precedence?: number, origin?: PointType);
-    length(): number;
-    stringify(): string;
-    convert(): ValueEntity | UnreferencedEntity | InvalidRefEntity | RefEntity | RangeEntity | IdEntity | IdRangeEntity | FunctionEntity | undefined;
-}
-type LexerOption = {
-    origin?: PointType;
-    idMap?: {
-        [id: Id]: Id;
-    };
-};
-export declare class Lexer {
-    private index;
-    private formula;
-    tokens: Token[];
-    foreign: boolean;
-    private origin?;
-    private idMap;
-    constructor(formula: string, options?: LexerOption);
-    private isWhiteSpace;
-    private next;
-    private get;
-    private getToken;
-    getTokenIndexByCharPosition(pos: number): [number, boolean];
-    getTokenPositionRange(index: number, slide?: number): [number, number];
-    stringify(): string;
-    identify(props: IdentifyProps): string;
-    display({ table }: DisplayProps): string;
-    tokenize(): void;
-    private skipSpaces;
-    private getString;
-    private resolveIdRange;
-}
-export declare class Parser {
-    index: number;
-    depth: number;
-    tokens: Token[];
-    constructor(tokens: Token[]);
-    build(): Expression | undefined;
-    private parse;
-}
-export declare const identifyFormula: (value: any, { idMap, ...props }: IdentifyProps) => any;
-export declare const stripSheetName: (sheetName: string) => string;
-export declare function splitRef(ref: string): {
-    sheetName: string | undefined;
-    addresses: string[];
-};
-export declare const parseRef: (ref: string, { table, operation, dependency }: IdentifyProps) => {
-    table: Table;
-    sheetId?: number;
-    formula?: string;
-    sheetName?: string;
-    addresses: string[];
-    ids: string[];
-};
-export {};
-//# sourceMappingURL=evaluator.d.ts.map

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

@@ -1,59 +0,0 @@
-import { Pending, Special } from '../../constants';
-import { Wire } from '../../lib/hub';
-import { PointType } from '../../types';
-/**
- * Sentinel value to distinguish cache miss from user-returned undefined/null.
- * Since user functions can return undefined or null, we need a special marker
- * to indicate "no cache entry found" vs "cache entry is undefined".
- */
-export declare const asyncCacheMiss: Special;
-/** Returns true if any element of `args` is a Pending sentinel. */
-export declare const hasPendingArg: (args: any[]) => boolean;
-/**
- * Build a cache key from function name + hashed serialised arguments.
- *
- * Format: `funcName:length:hash1-hash2-...`
- *   - length: byte length of the JSON-serialised args
- *   - hash:   cyrb53 hash of the JSON string, repeated hashPrecision times with different seeds
- *
- * When a Table appears as an argument its trimmed area is converted to a
- * value matrix (`any[][]`) via `getFieldMatrix()` so the key reflects the
- * actual cell values the function will operate on.
- */
-export declare const buildAsyncCacheKey: (funcName: string, bareArgs: any[], hashPrecision?: number) => string;
-/**
- * Try to retrieve a cached or pending async result for the given cache key.
- *
- * Returns:
- * - Cached value if present, valid, and not expired
- * - Pending if there is an in-flight promise for this cell
- * - asyncCacheMiss if no cache/pending exists (distinguishes from user-returned undefined/null)
- */
-export declare const getAsyncCache: (table: {
-    wire: Wire;
-    getId: (p: PointType) => string;
-}, origin: PointType, key: string) => any;
-/**
- * Handle an async (Promise) result returned by BaseFunction.main().
- *
- * Cache is stored per-cell in cell.asyncCache.
- * In-flight tracking uses Wire.asyncPending (keyed by cell ID).
- *
- * Flow:
- * 1. If cell has asyncCache and the key matches (inputs unchanged) and not expired → return cached value
- * 2. If there is already an in-flight promise for this cell → return its Pending
- * 3. Otherwise start the async work, return a new Pending, and on completion
- *    write the result into cell.asyncCache and trigger a re-render.
- *
- * @param ttlMilliseconds - Cache time-to-live in **milliseconds**. undefined = never expires.
- */
-export declare const getOrSaveAsyncCache: (promise: Promise<any>, table: {
-    wire: Wire;
-    getId: (p: PointType) => string;
-}, origin: PointType, key: string, ttlMilliseconds?: number) => any;
-/**
- * Create a Pending sentinel that resolves immediately.
- * Used when an argument is already pending — the result is propagated.
- */
-export declare const createPropagatedPending: () => Pending;
-//# sourceMappingURL=__async.d.ts.map

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

@@ -1,31 +0,0 @@
-import { Table } from '../../lib/table';
-import { PointType } from '../../types';
-import { Expression } from '../evaluator';
-export type FunctionProps = {
-    args: Expression[];
-    table: Table;
-    origin?: PointType;
-};
-export declare class BaseFunction {
-    example: string;
-    helpTexts: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
-    /** Cache TTL in milliseconds. Override in subclass to set expiry. undefined = never expires. */
-    protected ttlMilliseconds?: number;
-    /** Hash precision for cache key generation. Higher values reduce collision risk. Default: 1 */
-    protected hashPrecision: number;
-    protected bareArgs: any[];
-    protected table: Table;
-    protected origin?: PointType;
-    constructor({ args, table, origin }: FunctionProps);
-    protected validate(): void;
-    private get isMainAsync();
-    call(): any;
-}
-export type FunctionMapping = {
-    [functionName: string]: typeof BaseFunction;
-};
-//# sourceMappingURL=__base.d.ts.map

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

@@ -1,19 +0,0 @@
-export declare const gt: (left: any, right: any) => boolean;
-export declare const gte: (left: any, right: any) => boolean;
-export declare const lt: (left: any, right: any) => boolean;
-export declare const lte: (left: any, right: any) => boolean;
-export declare const eq: (left: any, right: any) => boolean;
-export declare const ne: (left: any, right: any) => boolean;
-export type EnsureNumberOptions = {
-    alternative?: number;
-    ignore?: boolean;
-};
-export type EnsureBooleanOptions = {
-    alternative?: boolean;
-    ignore?: boolean;
-};
-export declare const ensureNumber: (value: any, options?: EnsureNumberOptions) => number;
-export declare const ensureString: (value: any) => string;
-export declare const ensureBoolean: (value: any, options?: EnsureBooleanOptions) => boolean;
-export declare const check: (value: any, condition: string) => boolean;
-//# sourceMappingURL=__utils.d.ts.map

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

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

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

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

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

@@ -1,13 +0,0 @@
-import { BaseFunction } from './__base';
-import { TimeDelta } from '../../lib/time';
-export declare class AddFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
-    protected validate(): void;
-    protected main(v1: number | Date | TimeDelta, v2: number | Date | TimeDelta): number | Date;
-}
-//# sourceMappingURL=add.d.ts.map

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

@@ -1,19 +0,0 @@
-import { BaseFunction } from './__base';
-export declare class AndFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: ({
-        name: string;
-        description: string;
-        optional?: undefined;
-        iterable?: undefined;
-    } | {
-        name: string;
-        description: string;
-        optional: boolean;
-        iterable: boolean;
-    })[];
-    protected validate(): void;
-    protected main(...values: boolean[]): boolean;
-}
-//# sourceMappingURL=and.d.ts.map

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

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

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

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

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

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

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

@@ -1,19 +0,0 @@
-import { BaseFunction } from './__base';
-export declare class AverageFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: ({
-        name: string;
-        description: string;
-        optional?: undefined;
-        iterable?: undefined;
-    } | {
-        name: string;
-        description: string;
-        optional: boolean;
-        iterable: boolean;
-    })[];
-    protected validate(): void;
-    protected main(...values: number[]): number;
-}
-//# sourceMappingURL=average.d.ts.map

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

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

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

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

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

@@ -1,19 +0,0 @@
-import { BaseFunction } from './__base';
-export declare class ConcatenateFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: ({
-        name: string;
-        description: string;
-        optional?: undefined;
-        iterable?: undefined;
-    } | {
-        name: string;
-        description: string;
-        optional: boolean;
-        iterable: boolean;
-    })[];
-    protected validate(): void;
-    protected main(...values: string[]): string;
-}
-//# sourceMappingURL=concatenate.d.ts.map

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

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

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

@@ -1,19 +0,0 @@
-import { BaseFunction } from './__base';
-export declare class CountFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: ({
-        name: string;
-        description: string;
-        optional?: undefined;
-        iterable?: undefined;
-    } | {
-        name: string;
-        description: string;
-        optional: boolean;
-        iterable: boolean;
-    })[];
-    protected validate(): void;
-    protected main(...values: any[]): number;
-}
-//# sourceMappingURL=count.d.ts.map

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

@@ -1,19 +0,0 @@
-import { BaseFunction } from './__base';
-export declare class CountaFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: ({
-        name: string;
-        description: string;
-        optional?: undefined;
-        iterable?: undefined;
-    } | {
-        name: string;
-        description: string;
-        optional: boolean;
-        iterable: boolean;
-    })[];
-    protected validate(): void;
-    protected main(...values: any[]): number;
-}
-//# sourceMappingURL=counta.d.ts.map

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

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

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

@@ -1,12 +0,0 @@
-import { BaseFunction } from './__base';
-export declare class DivideFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
-    protected validate(): void;
-    protected main(divided: number, divisor: number): number;
-}
-//# sourceMappingURL=divide.d.ts.map

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

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

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

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

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

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

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

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

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

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

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

@@ -1,17 +0,0 @@
-import { BaseFunction } from './__base';
-export declare class IfFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: ({
-        name: string;
-        description: string;
-        optional?: undefined;
-    } | {
-        name: string;
-        description: string;
-        optional: boolean;
-    })[];
-    protected validate(): void;
-    protected main(condition: boolean, v1: any, v2?: any): any;
-}
-//# sourceMappingURL=if.d.ts.map

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

@@ -1,20 +0,0 @@
-import { FunctionProps } from './__base';
-export declare class IfErrorFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: ({
-        name: string;
-        description: string;
-        optional?: undefined;
-    } | {
-        name: string;
-        description: string;
-        optional: boolean;
-    })[];
-    private args;
-    private table;
-    constructor({ args, table }: FunctionProps);
-    protected validate(): void;
-    call(): any;
-}
-//# sourceMappingURL=iferror.d.ts.map