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

package/dist/formula/evaluator.d.ts

@@ -1,138 +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;
-}
-/** Alias for Parser, exported for external tooling (e.g. Debugger). */
-export declare const FormulaParser: typeof Parser;
-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,62 +0,0 @@
-import { Pending, Sentinel } from '../../sentinels';
-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: Sentinel;
-/** 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, useInflight?: boolean) => 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).
- * If useInflight is true, also tracks by cache key in Wire.asyncInflight.
- *
- * 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. If useInflight is true and there is an in-flight promise for this key → return its Pending
- * 4. 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.
- * @param useInflight - If true, reuse the same promise for matching cache keys across different cells.
- */
-export declare const awaitAndSave: (promise: Promise<any>, table: {
-    wire: Wire;
-    getId: (p: PointType) => string;
-}, origin: PointType, key: string, ttlMilliseconds?: number, useInflight?: boolean) => Pending;
-/**
- * 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,53 +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 type HelpArg = {
-    name: string;
-    description: string;
-    optional?: boolean;
-    iterable?: boolean;
-    type?: ('number' | 'string' | 'boolean' | 'date' | 'time' | 'range' | 'reference' | 'any')[];
-};
-export declare const conditionArg: HelpArg;
-export declare class BaseFunction {
-    example: string;
-    helpTexts: string[];
-    helpArgs: HelpArg[];
-    /** Indicates if this function is async. Override in subclass or use BaseFunctionAsync. */
-    protected isAsync: boolean;
-    /** 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;
-    /** If true, reuse the same in-flight promise for matching cache keys across different cells. */
-    protected useInflight: boolean;
-    protected bareArgs: any[];
-    protected table: Table;
-    protected origin?: PointType;
-    constructor({ args, table, origin }: FunctionProps);
-    protected validate(): void;
-    call(): any;
-}
-/**
- * Base class for sync functions.
- * Extend this class to create sync functions that support caching.
- */
-export declare class BaseFunctionSync extends BaseFunction {
-    protected isAsync: boolean;
-}
-/**
- * Base class for async functions.
- * Extend this class to create async functions that support caching.
- */
-export declare class BaseFunctionAsync extends BaseFunction {
-    protected isAsync: boolean;
-}
-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,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class AbsFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(value: number): number;
-}
-//# sourceMappingURL=abs.d.ts.map

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/add.d.ts

@@ -1,10 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-import { TimeDelta } from '../../lib/time';
-export declare class AddFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    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,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class AndFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(...values: boolean[]): boolean;
-}
-//# sourceMappingURL=and.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/average.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class AverageFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(...values: number[]): number;
-}
-//# sourceMappingURL=average.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/concat.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class ConcatFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: string, v2: string): string;
-}
-//# sourceMappingURL=concat.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/count.d.ts

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

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

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class CountaFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(...values: any[]): number;
-}
-//# sourceMappingURL=counta.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/divide.d.ts

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

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

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class EqFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: any, v2: any): boolean;
-}
-//# sourceMappingURL=eq.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/gt.d.ts

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

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

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class GteFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: number, v2: number): boolean;
-}
-//# sourceMappingURL=gte.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/if.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } 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;
-}
-//# sourceMappingURL=if.d.ts.map

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

@@ -1,12 +0,0 @@
-import { FunctionProps, HelpArg } from './__base';
-export declare class IfErrorFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    private args;
-    private table;
-    constructor({ args, table }: FunctionProps);
-    protected validate(): void;
-    call(): any;
-}
-//# sourceMappingURL=iferror.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/len.d.ts

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class LenFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(text: string): number;
-}
-//# sourceMappingURL=len.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/lt.d.ts

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

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

@@ -1,9 +0,0 @@
-import { BaseFunction, HelpArg } from './__base';
-export declare class LteFunction extends BaseFunction {
-    example: string;
-    helpText: string[];
-    helpArgs: HelpArg[];
-    protected validate(): void;
-    protected main(v1: number, v2: number): boolean;
-}
-//# sourceMappingURL=lte.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/max.d.ts

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

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

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