@fileverse-dev/dsheet 4.1.23-stabilise-package-3 → 4.1.23-stabilise-package-5

package/dist/index.es.js

@@ -1,5 +1,5 @@
-import { C as s, f as o, g as t, S as r, h as l, j as n, k as d, T as S, l as c, n as i, o as h, p as m, q as p, t as C, u, v as E, w as F, x, z as g, A as R, B as f, D as A, E as I, F as L, G as w, H as T, I as v, J as y, K as D, L as M, M as O, N as b, O as k, P, Q as V } from "./index-BXNWi7s5.js";
-import { cG as B, cH as G, cI as H, cO as K, by as U, e as X, f as _, l as J, a as j, du as q, dv as N, bh as Q, dw as Y, dx as Z, dB as W, dC as $, dE as ee, J as ae, dS as se, eq as oe, ba as te } from "./executeStringFunction-D5BTPrXL.js";
+import { C as s, f as o, g as t, S as r, h as l, j as n, k as d, T as S, l as c, n as i, o as h, p as m, q as p, t as C, u, v as E, w as F, x, z as g, A as R, B as f, D as A, E as I, F as L, G as w, H as T, I as v, J as y, K as D, L as M, M as O, N as b, O as k, P, Q as V } from "./index-B2qRWUrt.js";
+import { cG as B, cH as G, cI as H, cO as K, by as U, e as X, f as _, l as J, a as j, du as q, dv as N, bh as Q, dw as Y, dx as Z, dB as W, dC as $, dE as ee, J as ae, dS as se, eq as oe, ba as te } from "./executeStringFunction-BEXVKyb4.js";
 import { FLVURL as le } from "@fileverse-dev/formulajs";
 import { E as de, S as Se } from "./constants-8Ij49Lxv.js";
 export {

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

@@ -0,0 +1,15 @@
+import { Context } from '../context';
+
+/** Same cap as `execfunction` (MAX_RANGE_DEPS in formula.ts). */
+export declare const MAX_TEXT_RANGE_DEPS = 10000;
+export type FormulaTextDeps = {
+    /** `${sheetId}:${r}:${c}` of every cell the formula reads. */
+    deps: Set<string>;
+    /** Too wide or unresolvable to list: the formula runs on every commit. */
+    wide: boolean;
+};
+/**
+ * Collect the references of formula text `f` (with its leading `=`) written
+ * in cell (`r`, `c`) of tab `sheetId`.
+ */
+export declare function collectFormulaTextDeps(ctx: Context, f: string, sheetId: string, r: number, c: number): FormulaTextDeps;

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

@@ -0,0 +1 @@
+export {};

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

@@ -5,19 +5,14 @@ export declare const FORMULA_WARMUP_DEBOUNCE_MS = 2000;
 export declare const FORMULA_WARMUP_IDLE_TIMEOUT_MS = 1000;
 export type FormulaWarmupResult = 'complete' | 'aborted';
 export type FormulaWarmupOptions = {
-    /** Longest a slice keeps evaluating before it yields (default 8). */
+    /** Longest a slice keeps reading formulas before it yields (default 8). */
     budgetMs: number;
     /** Runs the next slice later (idle callback in the app). */
     schedule: (cb: () => void) => void;
     isCancelled?: () => boolean;
 };
 /**
- * Formula functions that are `async` (they fetch over the network, e.g.
- * ETHERSCAN, EOA). The warm-up records their arguments but never calls them.
- */
-export declare function isAsyncFormulaFunction(name: string): boolean;
-/**
- * Walk the calc chain in slices and record every formula's dependencies, then
+ * Walk the calc chain in slices and read every formula's references, then
  * mark the graph complete (C8). Resolves 'aborted' if the graph is cleared
  * while it runs, a tab holding formulas is sparse, or `isCancelled` says so.
  *

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

@@ -131,6 +131,12 @@ export declare function resetFormulaDependencyIndexes(ctx: Context): void;
  * has recorded its dependencies, unless the graph was invalidated meanwhile.
  */
 export declare function finishFullFormulaPass(ctx: Context, epoch: number | null | undefined): void;
+/**
+ * INDIRECT and OFFSET would resolve references at run time, which the graph
+ * cannot see. Today both evaluate to an error (formulajs implements neither),
+ * but formulas using them are kept on every commit's run list regardless.
+ */
+export declare const RUNTIME_REFERENCE_RE: RegExp;
 export declare function execfunction(ctx: Context, txt: string, r: number, c: number, id?: string, calcChainSet?: Set<string>, isrefresh?: boolean, notInsertFunc?: boolean): any[];
 export declare function groupValuesRefresh(ctx: Context): void;
 /** Apply worker chunk output onto the live context (main thread only). */

package/dist/sheet-engine/react/components/ContextMenu/FilterMenu.d.ts

@@ -1,4 +1,4 @@
 import { default as React } from 'react';
 
-declare const FilterMenu: React.FC;
-export default FilterMenu;
+declare const _default: React.NamedExoticComponent<{}>;
+export default _default;

package/dist/sheet-engine/react/components/ContextMenu/SheetTab.d.ts

@@ -1,4 +1,4 @@
 import { default as React } from 'react';
 
-declare const SheetTabContextMenu: React.FC;
-export default SheetTabContextMenu;
+declare const _default: React.NamedExoticComponent<{}>;
+export default _default;

package/dist/sheet-engine/react/components/ContextMenu/index.d.ts

@@ -1,4 +1,4 @@
 import { default as React } from 'react';
 
-declare const ContextMenu: React.FC;
-export default ContextMenu;
+declare const _default: React.NamedExoticComponent<{}>;
+export default _default;

package/dist/sheet-engine/react/components/NotationBoxes/shown-comments.d.ts

@@ -0,0 +1,16 @@
+import { Cell } from '../../../core/types';
+
+export type ShownCommentCell = {
+    r: number;
+    c: number;
+};
+/** Cells whose comment popup is pinned open (`ps.isShow`), in row-major order. */
+export declare function collectShownCommentCells(data: (Cell | null)[][]): ShownCommentCell[];
+/**
+ * Identity of a shown-comment set. NotationBoxes applies `showComments` only
+ * when this changes, so an edit that leaves the set alone costs no second
+ * context update. The sheet id is part of the key so that switching to a sheet
+ * with an equal (for example empty) set still replaces the previous sheet's
+ * boxes.
+ */
+export declare function shownCommentsKey(sheetId: string | undefined, cells: ShownCommentCell[]): string;

package/dist/sheet-engine/react/components/NotationBoxes/shown-comments.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sheet-engine/react/components/SVGDefines.d.ts

@@ -1,6 +1,6 @@
 import { default as React } from 'react';
 
-declare const SVGDefines: React.FC<{
+declare const _default: React.NamedExoticComponent<{
     currency: string;
 }>;
-export default SVGDefines;
+export default _default;

package/dist/sheet-engine/react/components/SheetOverlay/editing-as-formula.d.ts

@@ -0,0 +1,7 @@
+/**
+ * True while a cell is being edited and either input holds a formula. The
+ * inputs' `innerText` is read only when `editing` is true (a read forces
+ * layout), and the formula bar is read only when the cell input did not
+ * already say yes.
+ */
+export declare function isEditingAsFormula(editing: boolean, readCellInputText: () => string | undefined, readFxInputText: () => string | undefined): boolean;

package/dist/sheet-engine/react/components/SheetOverlay/editing-as-formula.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,40 @@
+import { Context, GlobalCache } from '../../../core';
+
+export type HoverCell = {
+    row: number;
+    col: number;
+} | null;
+type Rect = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+type HoverTrackerOptions = {
+    /** Position of the cell area; read at most once per animation frame. */
+    getRect: () => Rect | undefined;
+    /** Cell under a page position, or null outside the cell area. */
+    locate: (pageX: number, pageY: number, rect: Rect | undefined) => HoverCell;
+    /** True while a drag, resize or popup needs every mouse move. */
+    isInteracting: () => boolean;
+    requestFrame: (cb: () => void) => void;
+};
+/**
+ * Decides whether a mouse move needs the full `setContext` pass. A move that
+ * stays in the same cell, with nothing being dragged or hovered, changes
+ * nothing, so it is skipped (E1).
+ */
+export declare function createHoverTracker({ getRect, locate, isInteracting, requestFrame, }: HoverTrackerOptions): {
+    shouldProcess(e: {
+        pageX: number;
+        pageY: number;
+    }): boolean;
+    reset(): void;
+};
+/**
+ * True when `handleOverlayMouseMove` or `overShowLinkCard` do something that
+ * depends on more than the hovered cell: a comment box, image, cell or dialog
+ * drag, or a popup that must see the pointer leave it.
+ */
+export declare function isHoverInteractionActive(ctx: Context, globalCache: GlobalCache): boolean;
+export {};

package/dist/sheet-engine/react/components/SheetOverlay/hover-tracker.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sheet-engine/react/components/SheetTab/index.d.ts

@@ -1,4 +1,4 @@
 import { default as React } from 'react';
 
-declare const SheetTab: React.FC;
-export default SheetTab;
+declare const _default: React.NamedExoticComponent<{}>;
+export default _default;

package/dist/sheet-engine/react/components/Toolbar/FunctionList/group-functions.d.ts

@@ -0,0 +1,9 @@
+export type FunctionLocaleItem = {
+    n?: string;
+    t?: number | string;
+};
+/** Groups the locale's function list by category for the function picker. */
+export declare function groupFunctions(functionlist: FunctionLocaleItem[]): {
+    categories: ("Text" | "Date" | "Other" | "Logical" | "All" | "Array" | "Database" | "Engineering" | "Datablock" | "Financial" | "Lookup" | "Math" | "Operator" | "Parser" | "Statistical" | "Info")[];
+    getFunctions: (categoryKey: string) => string[];
+};

package/dist/sheet-engine/react/components/Toolbar/FunctionList/group-functions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sheet-engine/react/components/Toolbar/index.d.ts

@@ -7,11 +7,11 @@ export declare const CurrencySelector: ({ cell, defaultTextFormat, toolTipText,
     defaultTextFormat: string;
     toolTipText: string;
 }) => import("react/jsx-runtime").JSX.Element;
-declare const Toolbar: React.FC<{
+declare const _default: React.NamedExoticComponent<{
     setMoreItems: React.Dispatch<React.SetStateAction<React.ReactNode>>;
     moreItemsOpen: boolean;
     onMoreToolbarItemsClose?: () => void;
     moreToolbarItems?: React.ReactNode;
     trailingContent?: React.ReactNode;
 }>;
-export default Toolbar;
+export default _default;

package/dist/sheet-engine/react/components/Workbook/stable-handle.d.ts

@@ -0,0 +1,8 @@
+/**
+ * An object with the keys of `getLatest()` whose identity never changes. Each
+ * function member calls the function of the same name on the latest api, and
+ * each other member reads the latest value, so a host that keeps the handle
+ * across renders always sees current state (E3). The key set is taken from the
+ * first call and is expected to stay the same.
+ */
+export declare function createStableHandle<T extends object>(getLatest: () => T): T;

package/dist/sheet-engine/react/components/Workbook/stable-handle.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sheet-engine/react/context/index.d.ts

@@ -1,5 +1,6 @@
 import { default as React } from 'react';
 import { Context, Settings, GlobalCache, PatchOptions } from '../../core';
+import { WorkbookStore } from './workbook-store';
 
 export type RefValues = {
     globalCache: GlobalCache;
@@ -23,4 +24,18 @@ declare const WorkbookContext: React.Context<{
     handleUndo: () => void;
     handleRedo: () => void;
 }>;
+/**
+ * The parts of the workbook that rarely change (setters, settings, refs) plus
+ * the store holding the latest context. Components that must not render on
+ * every update read this instead of `WorkbookContext` (E2).
+ */
+export type WorkbookStable = {
+    store: WorkbookStore<Context>;
+    setContext: (recipe: (ctx: Context) => void, options?: SetContextOptions) => void;
+    settings: Required<Settings>;
+    refs: RefValues;
+    handleUndo: () => void;
+    handleRedo: () => void;
+};
+export declare const WorkbookStableContext: React.Context<WorkbookStable>;
 export default WorkbookContext;

package/dist/sheet-engine/react/context/use-workbook-store.d.ts

@@ -0,0 +1,30 @@
+import { Context } from '../../core';
+
+export declare function useWorkbookSelector<S>(selector: (ctx: Context) => S, isEqual?: (a: S, b: S) => boolean): S;
+/**
+ * Drop-in for `useContext(WorkbookContext)` in components that should not
+ * render on every context update: it returns the same shape, but the
+ * component renders again only when `equal` says the context changed in a way
+ * it cares about (or when its own props or state change). The returned
+ * `context` is always the latest one.
+ */
+export declare function useWorkbookContextWhen(equal: (previous: Context, next: Context) => boolean): {
+    context: Context;
+    setContext: (recipe: (ctx: Context) => void, options?: import('./index').SetContextOptions) => void;
+    settings: Required<import('../../core').Settings>;
+    refs: import('./index').RefValues;
+    handleUndo: () => void;
+    handleRedo: () => void;
+};
+/**
+ * `useContext(WorkbookContext)` for components that must not render when only
+ * the scroll position or the row and column offsets changed (E2).
+ */
+export declare function useWorkbookContextIgnoringScroll(): {
+    context: Context;
+    setContext: (recipe: (ctx: Context) => void, options?: import('./index').SetContextOptions) => void;
+    settings: Required<import('../../core').Settings>;
+    refs: import('./index').RefValues;
+    handleUndo: () => void;
+    handleRedo: () => void;
+};

package/dist/sheet-engine/react/context/workbook-store.d.ts

@@ -0,0 +1,30 @@
+export type WorkbookStore<T> = {
+    getState: () => T;
+    setState: (next: T) => void;
+    subscribe: (listener: () => void) => () => void;
+};
+/** A one-value store; Workbook sets the latest context after every commit (E2). */
+export declare function createWorkbookStore<T>(initial: T): WorkbookStore<T>;
+/**
+ * The snapshot logic behind `useWorkbookSelector`: `getSnapshot` returns the
+ * previously handed-out value while `isEqual` says the newly selected one is
+ * the same, so `useSyncExternalStore` sees no change and the component does
+ * not render. The selector runs once per state.
+ */
+export declare function createSelection<T, S>(store: WorkbookStore<T>, selector: (state: T) => S, isEqual?: (a: S, b: S) => boolean): {
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot(): S;
+};
+/** True when two states differ only in the listed keys. */
+export declare function onlyIgnoredKeysChanged(ignored: readonly string[]): (a: object, b: object) => boolean;
+/**
+ * Context keys that change on scroll or when the row and column offsets are
+ * rebuilt after an edit, and that the components converted in E2 do not read:
+ * Toolbar and its popovers, SheetTab, ContextMenu, FilterMenu and
+ * SheetTabContextMenu. Checked with grep in those directories and in the
+ * helpers they call with the context (`updateCellsDecimalFormat`,
+ * `convertCellsToCrypto`, `isHyperlinkCreationBlocked`,
+ * `captureLinkEditorOpenSnapshot`).
+ */
+export declare const SCROLL_ONLY_KEYS: readonly ["scrollLeft", "scrollTop", "visibledatarow", "visibledatacolumn"];
+export declare const contextEqualIgnoringScroll: (a: object, b: object) => boolean;

package/dist/sheet-engine/react/context/workbook-store.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/{use-xlsx-import-impl-gsG9w9qV.js → use-xlsx-import-impl-C8P5kg6K.js}

@@ -1,10 +1,10 @@
 import * as BZ from "yjs";
-import { i as Yl, a as hl, b as ul, s as eZ, r as Il, y as pl, d as Rl, m as sl } from "./index-BXNWi7s5.js";
-import { g as al } from "./executeStringFunction-D5BTPrXL.js";
+import { i as Yl, a as hl, b as ul, s as eZ, r as Il, y as pl, d as Rl, m as sl } from "./index-B2qRWUrt.js";
+import { g as al } from "./executeStringFunction-BEXVKyb4.js";
 import { Workbook as Kl } from "exceljs";
 import Jl from "luckyexcel";
-import { e as xl, b as Ml, n as Sl } from "./xlsx-hyperlink-inline-BFbPe75M.js";
-import { parseDefinedNamesFromXlsxBuffer as Nl, excelEntriesToDefinedNames as OZ } from "./xlsx-defined-names-dZveijsB.js";
+import { e as xl, b as Ml, n as Sl } from "./xlsx-hyperlink-inline-yhXVMMJ9.js";
+import { parseDefinedNamesFromXlsxBuffer as Nl, excelEntriesToDefinedNames as OZ } from "./xlsx-defined-names-BPf5_A0O.js";
 import { toast as fZ } from "@fileverse/ui";
 var Zl = { exports: {} };
 (function(m) {

package/dist/{xlsx-defined-names-dZveijsB.js → xlsx-defined-names-BPf5_A0O.js}

@@ -1,5 +1,5 @@
-import { i as w } from "./executeStringFunction-D5BTPrXL.js";
-import { J as x } from "./xlsx-hyperlink-inline-BFbPe75M.js";
+import { i as w } from "./executeStringFunction-BEXVKyb4.js";
+import { J as x } from "./xlsx-hyperlink-inline-yhXVMMJ9.js";
 function g(o) {
   return o.startsWith("_xlnm.");
 }

package/dist/{xlsx-export-impl-B10lK_L2.js → xlsx-export-impl-GUjuzWHG.js}

@@ -1,9 +1,9 @@
 import { utils as S, write as nt } from "xlsx-js-style";
 import { Workbook as pt } from "exceljs";
 import { toast as rt } from "@fileverse/ui";
-import { J as dt, c as X, g as ht, a as mt } from "./xlsx-hyperlink-inline-BFbPe75M.js";
-import { b as gt } from "./executeStringFunction-D5BTPrXL.js";
-import { e as bt } from "./index-BXNWi7s5.js";
+import { J as dt, c as X, g as ht, a as mt } from "./xlsx-hyperlink-inline-yhXVMMJ9.js";
+import { b as gt } from "./executeStringFunction-BEXVKyb4.js";
+import { e as bt } from "./index-B2qRWUrt.js";
 const xt = {
   1: "thin",
   2: "hair",
@@ -854,7 +854,7 @@ const Z = (t) => {
           O
         );
       });
-      const { applyDefinedNamesToExcelWorkbook: ct } = await import("./xlsx-defined-names-dZveijsB.js");
+      const { applyDefinedNamesToExcelWorkbook: ct } = await import("./xlsx-defined-names-BPf5_A0O.js");
       ct(
         B,
         (k = (C = (s = t.current).getWorkbookContext) == null ? void 0 : C.call(s)) == null ? void 0 : k.definedNames,

package/dist/{xlsx-hyperlink-inline-BFbPe75M.js → xlsx-hyperlink-inline-yhXVMMJ9.js}

@@ -1,5 +1,5 @@
-import { g as Rt, c as yt } from "./executeStringFunction-D5BTPrXL.js";
-import { c as wt } from "./index-BXNWi7s5.js";
+import { g as Rt, c as yt } from "./executeStringFunction-BEXVKyb4.js";
+import { c as wt } from "./index-B2qRWUrt.js";
 function jt(J, nt) {
   const g = J.getImages();
   if (!g.length) return [];

package/package.json

@@ -2,7 +2,7 @@
   "name": "@fileverse-dev/dsheet",
   "private": false,
   "description": "DSheet",
-  "version": "4.1.23-stabilise-package-3",
+  "version": "4.1.23-stabilise-package-5",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fileverse/fileverse-dsheets.git"