@fileverse-dev/dsheet 2.0.8 → 2.0.9

package/dist/sheet-engine/core/modules/formula.d.ts

@@ -30,6 +30,18 @@ export declare class FormulaCache {
     functionlistMap: any;
     execFunctionExist?: any[];
     execFunctionGlobalData: any;
+    /** Formula dependency graph: cell -> referenced cells. Key format: `${sheetId}:${r}:${c}` */
+    depsByCell: Map<string, Set<string>>;
+    /** Reverse dependency graph: referenced cell -> dependent formula cells. */
+    revDepsByCell: Map<string, Set<string>>;
+    /**
+     * Dependency collection state for the currently-parsed formula, set by `execfunction`.
+     * When null, dependency recording is disabled.
+     */
+    activeDepCollection: null | {
+        originKey: string;
+        deps: Set<string>;
+    };
     constructor();
     tryGetCellAsNumber(cell: Cell): string | number | boolean | undefined;
 }
@@ -52,7 +64,7 @@ export declare function createFormulaRangeSelect(ctx: Context, select: {
     rangeIndex: number;
 } & Rect): void;
 export declare function createRangeHightlight(ctx: Context, inputInnerHtmlStr: string, ignoreRangeIndex?: number): void;
-export declare function moveCursorToEnd(editableDiv: HTMLDivElement): void;
+export declare function moveCursorToEnd(editableDiv: HTMLDivElement | null | undefined): void;
 export declare function setCaretPosition(ctx: Context, textDom: HTMLElement, children: number, pos: number, parentTextDom?: HTMLElement): void;
 export declare function getrangeseleciton(): ParentNode | ChildNode | null | undefined;
 export declare function rangeHightlightselected(ctx: Context, $editor: HTMLDivElement): void;

package/dist/sheet-engine/core/modules/validation.d.ts

@@ -9,6 +9,7 @@ export declare const error: {
     nm: string;
     nl: string;
     sp: string;
+    circ: string;
 };
 export declare const errorMessagesFromValue: Record<string, string>;
 export declare function detectErrorFromValue(input: string): string;

package/dist/sheet-engine/formula-parser/error.d.ts

@@ -20,3 +20,4 @@ export const ERROR_NULL: "NULL";
 export const ERROR_NUM: "NUM";
 export const ERROR_REF: "REF";
 export const ERROR_VALUE: "VALUE";
+export const CIRCULAR_REF_ERROR: "CIRC";

package/dist/sheet-engine/formula-parser/index.d.ts

@@ -1,6 +1,6 @@
 import { default as SUPPORTED_FORMULAS } from './supported-formulas';
-import { ERROR, ERROR_DIV_ZERO, ERROR_NAME, ERROR_NOT_AVAILABLE, ERROR_NULL, ERROR_NUM, ERROR_REF, ERROR_VALUE, default as error } from './error';
+import { ERROR, ERROR_DIV_ZERO, ERROR_NAME, ERROR_NOT_AVAILABLE, ERROR_NULL, ERROR_NUM, ERROR_REF, ERROR_VALUE, CIRCULAR_REF_ERROR, default as error } from './error';
 import { default as Parser } from './parser';
 import { extractLabel, toLabel, columnIndexToLabel, columnLabelToIndex, rowIndexToLabel, rowLabelToIndex } from './helper/cell';
 
-export { SUPPORTED_FORMULAS, ERROR, ERROR_DIV_ZERO, ERROR_NAME, ERROR_NOT_AVAILABLE, ERROR_NULL, ERROR_NUM, ERROR_REF, ERROR_VALUE, Parser, error, extractLabel, toLabel, columnIndexToLabel, columnLabelToIndex, rowIndexToLabel, rowLabelToIndex };
+export { SUPPORTED_FORMULAS, ERROR, ERROR_DIV_ZERO, ERROR_NAME, ERROR_NOT_AVAILABLE, ERROR_NULL, ERROR_NUM, ERROR_REF, ERROR_VALUE, CIRCULAR_REF_ERROR, Parser, error, extractLabel, toLabel, columnIndexToLabel, columnLabelToIndex, rowIndexToLabel, rowLabelToIndex };

package/dist/sheet-engine/react/components/SheetOverlay/helper.d.ts

@@ -21,8 +21,16 @@ export declare function buildFormulaSuggestionText(editableDiv: HTMLDivElement,
     caretOffset: number;
 };
 export declare function isLetterNumberPattern(str: string): boolean;
+export declare function isStrictFormulaEditorText(editor: HTMLDivElement | null): boolean;
 /** Same rule as InputBox/Fx onChange: show function list while typing a name after `=`. */
 export declare function shouldShowFormulaFunctionList(editor: HTMLDivElement | null): boolean;
+/**
+ * True when the formula looks complete at the caret:
+ * - strict first character '='
+ * - caret at end of editor text
+ * - parentheses are balanced (no negative depth; final depth 0)
+ */
+export declare function isFormulaCompleteAtCaret(editor: HTMLDivElement | null): boolean;
 /**
  * When the caret sits on a function name span or its opening-paren span, return
  * that function's name (uppercase). Used so nested formulas like `SUM(MIN(`