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

package/dist/components/ContextMenu.d.ts

@@ -3,6 +3,7 @@ import { ContextMenuProps } from '../types';
 export declare const ContextMenu: () => JSX.Element | null;
 export declare const DividerItem: (props: ContextMenuProps) => JSX.Element;
 export declare const CutItem: (props: ContextMenuProps) => JSX.Element;
+export declare const SearchItem: (props: ContextMenuProps) => JSX.Element;
 export declare const CopyItem: (props: ContextMenuProps) => JSX.Element;
 export declare const PasteItem: (props: ContextMenuProps) => JSX.Element;
 export declare const PasteOnlyValueItem: (props: ContextMenuProps) => JSX.Element;

package/dist/components/EditorOptions.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+interface EditorOptionsProps {
+    filteredOptions: any[];
+    top: number;
+    left: number;
+    selected: number;
+    onOptionMouseDown: (e: React.MouseEvent<HTMLLIElement>, i: number) => void;
+}
+export declare const EditorOptions: React.FC<EditorOptionsProps>;
+export {};
+//# sourceMappingURL=EditorOptions.d.ts.map

package/dist/components/FunctionGuide.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+import { FunctionHelp } from '../formula/mapping';
+import { AutocompleteOption } from '../policy/core';
+type OptionWithGuide = AutocompleteOption & {
+    isFunction?: boolean;
+    example?: string;
+    helpTexts?: string[];
+    helpArgs?: any[];
+};
+export interface FunctionGuideProps {
+    option?: OptionWithGuide;
+    activeFunctionGuide?: FunctionHelp;
+    activeArgIndex?: number;
+    top?: number;
+    left?: number;
+}
+export declare const FunctionGuide: React.FC<FunctionGuideProps>;
+export {};
+//# sourceMappingURL=FunctionGuide.d.ts.map

package/dist/components/useAutocomplete.d.ts

@@ -0,0 +1,25 @@
+import { FunctionHelp } from '../formula/mapping';
+import { FunctionMapping } from '../formula/functions/__base';
+import { AutocompleteOption } from '../policy/core';
+type UseAutocompleteProps = {
+    inputting: string;
+    selectionStart: number;
+    optionsAll: AutocompleteOption[];
+    functions?: FunctionMapping;
+};
+export declare const useAutocomplete: ({ inputting, selectionStart, optionsAll, functions }: UseAutocompleteProps) => {
+    filteredOptions: any[];
+    selected: number;
+    setSelected: import('react').Dispatch<import('react').SetStateAction<number>>;
+    replaceWithOption: (option: any) => {
+        value: string;
+        selectionStart: any;
+    };
+    handleArrowUp: (e: React.KeyboardEvent<HTMLTextAreaElement>) => boolean;
+    handleArrowDown: (e: React.KeyboardEvent<HTMLTextAreaElement>) => boolean;
+    isFormula: boolean;
+    activeFunctionHelp: FunctionHelp | null;
+    activeArgIndex: number;
+};
+export {};
+//# sourceMappingURL=useAutocomplete.d.ts.map

package/dist/constants.d.ts

@@ -11,19 +11,6 @@ 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;

package/dist/formula/evaluator.d.ts

@@ -118,6 +118,8 @@ export declare class Parser {
     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): {

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

@@ -1,4 +1,4 @@
-import { Pending, Special } from '../../constants';
+import { Pending, Sentinel } from '../../sentinels';
 import { Wire } from '../../lib/hub';
 import { PointType } from '../../types';
 /**
@@ -6,7 +6,7 @@ import { PointType } from '../../types';
  * 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;
+export declare const asyncCacheMiss: Sentinel;
 /** Returns true if any element of `args` is a Pending sentinel. */
 export declare const hasPendingArg: (args: any[]) => boolean;
 /**
@@ -32,25 +32,28 @@ export declare const buildAsyncCacheKey: (funcName: string, bareArgs: any[], has
 export declare const getAsyncCache: (table: {
     wire: Wire;
     getId: (p: PointType) => string;
-}, origin: PointType, key: string) => any;
+}, 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. Otherwise start the async work, return a new Pending, and on completion
+ * 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 getOrSaveAsyncCache: (promise: Promise<any>, table: {
+export declare const awaitAndSave: (promise: Promise<any>, table: {
     wire: Wire;
     getId: (p: PointType) => string;
-}, origin: PointType, key: string, ttlMilliseconds?: number) => any;
+}, 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.

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

@@ -6,25 +6,47 @@ export type FunctionProps = {
     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: {
-        name: string;
-        description: 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;
-    private get isMainAsync();
     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;
 };

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class AbsFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(value: number): number;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class AcosFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(value: number): number;
 }

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

@@ -1,12 +1,9 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 import { TimeDelta } from '../../lib/time';
 export declare class AddFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(v1: number | Date | TimeDelta, v2: number | Date | TimeDelta): number | Date;
 }

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

@@ -1,18 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } 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;
-    })[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(...values: boolean[]): boolean;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class AsinFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(value: number): number;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class AtanFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(value: number): number;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class Atan2Function extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(x: number, y: number): number;
 }

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

@@ -1,18 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } 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;
-    })[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(...values: number[]): number;
 }

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

@@ -1,12 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class ColFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-        option: boolean;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(left: number): number;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class ConcatFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(v1: string, v2: string): string;
 }

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

@@ -1,18 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } 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;
-    })[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(...values: string[]): string;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class CosFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(angle: number): number;
 }

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

@@ -1,18 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } 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;
-    })[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(...values: any[]): number;
 }

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

@@ -1,18 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } 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;
-    })[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(...values: any[]): number;
 }

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

@@ -1,12 +1,9 @@
 import { Table } from '../../lib/table';
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class CountifFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(table: Table, condition: string): number;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class DivideFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(divided: number, divisor: number): number;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class EqFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(v1: any, v2: any): boolean;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class ExpFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(exponent: number): number;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class GtFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(v1: number, v2: number): boolean;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class GteFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(v1: number, v2: number): boolean;
 }

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

@@ -1,17 +1,9 @@
 import { Table } from '../../lib/table';
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } 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;
-    })[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(key: any, range: Table, index: number, isSorted: boolean): any;
 }

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

@@ -1,16 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } 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;
-    })[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(condition: boolean, v1: any, v2?: any): any;
 }

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

@@ -1,16 +1,8 @@
-import { FunctionProps } from './__base';
+import { FunctionProps, HelpArg } from './__base';
 export declare class IfErrorFunction {
     example: string;
     helpText: string[];
-    helpArgs: ({
-        name: string;
-        description: string;
-        optional?: undefined;
-    } | {
-        name: string;
-        description: string;
-        optional: boolean;
-    })[];
+    helpArgs: HelpArg[];
     private args;
     private table;
     constructor({ args, table }: FunctionProps);

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

@@ -1,17 +1,9 @@
 import { Table } from '../../lib/table';
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class IndexFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: ({
-        name: string;
-        description: string;
-        optional?: undefined;
-    } | {
-        name: string;
-        description: string;
-        optional: boolean;
-    })[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(table: Table, y?: number, x?: number): Table;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class LenFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(text: string): number;
 }

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

@@ -1,11 +1,8 @@
-import { BaseFunction } from './__base';
+import { BaseFunction, HelpArg } from './__base';
 export declare class LenbFunction extends BaseFunction {
     example: string;
     helpText: string[];
-    helpArgs: {
-        name: string;
-        description: string;
-    }[];
+    helpArgs: HelpArg[];
     protected validate(): void;
     protected main(text: string): number;
 }