@fileverse-dev/dsheet 4.1.23-stabilise-package-1 → 4.1.23-stabilise-package-4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/README.md +10 -0
  2. package/dist/editor/contexts/editor-context.d.ts +4 -0
  3. package/dist/editor/hooks/use-celldata-compaction.d.ts +23 -2
  4. package/dist/editor/hooks/use-celldata-compaction.test.d.ts +1 -0
  5. package/dist/editor/hooks/use-editor-data.d.ts +1 -0
  6. package/dist/editor/types.d.ts +14 -3
  7. package/dist/editor/utils/active-sheet-keeper.test.d.ts +1 -0
  8. package/dist/editor/utils/after-update-cell.d.ts +4 -0
  9. package/dist/editor/utils/format-gate.d.ts +8 -4
  10. package/dist/editor/utils/legacy-on-change.d.ts +20 -0
  11. package/dist/editor/utils/legacy-on-change.test.d.ts +1 -0
  12. package/dist/editor/utils/rebuild-indexeddb-store.d.ts +8 -1
  13. package/dist/editor/utils/remote-apply-guard.d.ts +25 -3
  14. package/dist/editor/utils/structural-edit-other-tabs.test.d.ts +1 -0
  15. package/dist/editor/utils/wait-for-sync.d.ts +35 -0
  16. package/dist/editor/utils/wait-for-sync.test.d.ts +1 -0
  17. package/dist/{executeStringFunction-DKA5MuP0.js → executeStringFunction-BsVLVYUB.js} +9438 -9328
  18. package/dist/formula.js +1 -1
  19. package/dist/{index-ypRdpDnX.js → index-YKT7Lz7Z.js} +18246 -17817
  20. package/dist/index.es.js +29 -29
  21. package/dist/sheet-engine/core/api/sheet-flowdata-lifecycle.d.ts +1 -0
  22. package/dist/sheet-engine/core/api/sheet-flowdata-lifecycle.test.d.ts +1 -0
  23. package/dist/sheet-engine/core/modules/formula.d.ts +9 -0
  24. package/dist/sheet-engine/core/modules/history-calc-chain.d.ts +6 -0
  25. package/dist/sheet-engine/core/modules/history-grid-size.d.ts +16 -0
  26. package/dist/sheet-engine/core/modules/history-grid-size.test.d.ts +1 -0
  27. package/dist/sheet-engine/core/settings.d.ts +9 -1
  28. package/dist/sheet-engine/core/utils/ydoc-celldata-changes.d.ts +14 -3
  29. package/dist/sheet-engine/react/components/ContextMenu/FilterMenu.d.ts +2 -2
  30. package/dist/sheet-engine/react/components/ContextMenu/SheetTab.d.ts +2 -2
  31. package/dist/sheet-engine/react/components/ContextMenu/index.d.ts +2 -2
  32. package/dist/sheet-engine/react/components/NotationBoxes/shown-comments.d.ts +16 -0
  33. package/dist/sheet-engine/react/components/NotationBoxes/shown-comments.test.d.ts +1 -0
  34. package/dist/sheet-engine/react/components/SVGDefines.d.ts +2 -2
  35. package/dist/sheet-engine/react/components/SheetOverlay/editing-as-formula.d.ts +7 -0
  36. package/dist/sheet-engine/react/components/SheetOverlay/editing-as-formula.test.d.ts +1 -0
  37. package/dist/sheet-engine/react/components/SheetOverlay/hover-tracker.d.ts +40 -0
  38. package/dist/sheet-engine/react/components/SheetOverlay/hover-tracker.test.d.ts +1 -0
  39. package/dist/sheet-engine/react/components/SheetTab/index.d.ts +2 -2
  40. package/dist/sheet-engine/react/components/Toolbar/FunctionList/group-functions.d.ts +9 -0
  41. package/dist/sheet-engine/react/components/Toolbar/FunctionList/group-functions.test.d.ts +1 -0
  42. package/dist/sheet-engine/react/components/Toolbar/index.d.ts +2 -2
  43. package/dist/sheet-engine/react/components/Workbook/stable-handle.d.ts +8 -0
  44. package/dist/sheet-engine/react/components/Workbook/stable-handle.test.d.ts +1 -0
  45. package/dist/sheet-engine/react/context/index.d.ts +15 -0
  46. package/dist/sheet-engine/react/context/use-workbook-store.d.ts +30 -0
  47. package/dist/sheet-engine/react/context/workbook-store.d.ts +30 -0
  48. package/dist/sheet-engine/react/context/workbook-store.test.d.ts +1 -0
  49. package/dist/{use-xlsx-import-impl-DQ3tpIAe.js → use-xlsx-import-impl-8Lojcck9.js} +4 -4
  50. package/dist/{xlsx-defined-names-CVVLxbe-.js → xlsx-defined-names-D3F23p2Z.js} +2 -2
  51. package/dist/{xlsx-export-impl-ghSoFZBz.js → xlsx-export-impl-DXWvjnk5.js} +4 -4
  52. package/dist/{xlsx-hyperlink-inline-DXj7AkSf.js → xlsx-hyperlink-inline-07QbQDEt.js} +2 -2
  53. package/package.json +1 -1
package/dist/index.es.js CHANGED
@@ -1,5 +1,5 @@
1
- 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 m, p as h, q as p, t as C, u, v as E, w as F, x as g, z as x, A as R, B as L, D as f, E as A, F as I, G as T, H as w, I as y, J as D, K as v, L as M, M as b, N as k, O as z, P as O, Q as P } from "./index-ypRdpDnX.js";
2
- import { cD as B, cE as K, cF as U, cL as X, bx as _, e as G, f as H, l as J, a as j, dr as N, ds as Q, bg as q, dt as Y, du as Z, dy as W, dz as $, dB as ee, J as ae, dQ as se, eo as oe, b9 as te } from "./executeStringFunction-DKA5MuP0.js";
1
+ 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-YKT7Lz7Z.js";
2
+ 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-BsVLVYUB.js";
3
3
  import { FLVURL as le } from "@fileverse-dev/formulajs";
4
4
  import { E as de, S as Se } from "./constants-8Ij49Lxv.js";
5
5
  export {
@@ -17,49 +17,49 @@ export {
17
17
  c as api,
18
18
  B as clearColumnsCellsFormat,
19
19
  i as clearFilter,
20
- K as clearRowsCellsFormat,
21
- U as clearSelectedCellFormat,
22
- m as createFilter,
23
- h as decryptForRoomKey,
24
- X as deleteRowCol,
25
- _ as deleteSelectedCellText,
20
+ G as clearRowsCellsFormat,
21
+ H as clearSelectedCellFormat,
22
+ h as createFilter,
23
+ m as decryptForRoomKey,
24
+ K as deleteRowCol,
25
+ U as deleteSelectedCellText,
26
26
  p as describeMatchedShortcut,
27
27
  C as encryptForRoomKey,
28
- G as executeStringFunction,
28
+ X as executeStringFunction,
29
29
  u as fetchSessionState,
30
- H as formulaResponseUiSync,
30
+ _ as formulaResponseUiSync,
31
31
  J as getFlowdata,
32
32
  E as getRemoveDuplicatesErrorMessage,
33
33
  F as getRemoveDuplicatesPreview,
34
34
  j as getSheetIndex,
35
- g as handleCSVUpload,
36
- x as handleCopy,
35
+ x as handleCSVUpload,
36
+ g as handleCopy,
37
37
  R as handleExportToCSV,
38
- L as handleExportToJSON,
39
- f as handleExportToODS,
40
- A as handleExportToXLSX,
41
- N as handleFreeze,
42
- Q as handleHorizontalAlign,
43
- q as handleLink,
38
+ f as handleExportToJSON,
39
+ A as handleExportToODS,
40
+ I as handleExportToXLSX,
41
+ q as handleFreeze,
42
+ N as handleHorizontalAlign,
43
+ Q as handleLink,
44
44
  Y as handleMerge,
45
- I as handlePasteByClick,
45
+ L as handlePasteByClick,
46
46
  Z as handleSort,
47
47
  W as handleTextSize,
48
48
  $ as handleVerticalAlign,
49
- T as importSpreadsheetFile,
49
+ w as importSpreadsheetFile,
50
50
  ee as insertRowCol,
51
- w as isBrowserZoomShortcut,
52
- y as isFormulaListShortcut,
53
- D as isOpenShortcutsModalShortcut,
51
+ T as isBrowserZoomShortcut,
52
+ v as isFormulaListShortcut,
53
+ y as isOpenShortcutsModalShortcut,
54
54
  ae as jfrefreshgrid,
55
55
  se as loadLocale,
56
- v as remapCommentAnchors,
56
+ D as remapCommentAnchors,
57
57
  M as removeActiveImage,
58
- b as removeDuplicates,
59
- k as seedSession,
60
- z as showImgChooser,
58
+ O as removeDuplicates,
59
+ b as seedSession,
60
+ k as showImgChooser,
61
61
  oe as toolbarItemClickHandler,
62
62
  te as updateFormat,
63
- O as useEnsStatus,
64
- P as useXLSXImport
63
+ P as useEnsStatus,
64
+ V as useXLSXImport
65
65
  };
@@ -1,5 +1,6 @@
1
1
  import { Context } from '../context';
2
2
 
3
+ export declare function collectSheetIdsFromFormulaText(ctx: Context, formula: string): Set<string>;
3
4
  /** Drop cached dense-sheet set (e.g. after structural workbook changes). */
4
5
  export declare function invalidateSheetsRequiredDenseCache(): void;
5
6
  /**
@@ -110,6 +110,15 @@ export declare class FormulaCache {
110
110
  export declare function iscelldata(txt: string): boolean;
111
111
  export declare function getcellrange(ctx: Context, txt: string, formulaId?: string): any;
112
112
  export declare function getAllFunctionGroup(ctx: Context): any[];
113
+ /**
114
+ * delFunctionGroup for many cells of one sheet: the chain and the dynamic
115
+ * array list are filtered once, not scanned and copied per cell. Same result
116
+ * as calling delFunctionGroup for each cell.
117
+ */
118
+ export declare function delFunctionGroupBatch(ctx: Context, id: string, cells: {
119
+ r: number;
120
+ c: number;
121
+ }[]): void;
113
122
  export declare function delFunctionGroup(ctx: Context, r: number, c: number, id?: string): void;
114
123
  export declare function insertUpdateFunctionGroup(ctx: Context, r: number, c: number, id?: string, calcChainSet?: Set<string>): void;
115
124
  /**
@@ -29,5 +29,11 @@ export declare function planHistoryPatches(patches: Patch[]): {
29
29
  * Register the restored cells that hold a formula and drop the ones that no
30
30
  * longer do. Run on a draft after the patches were applied. The graph is left
31
31
  * incomplete: restored formulas are not evaluated.
32
+ *
33
+ * A row-level patch lists every cell of the row, so most restored cells are
34
+ * unchanged. The chain is read once into a set; only a formula missing from it
35
+ * is added and only an entry whose cell lost its formula is removed (in one
36
+ * batch). Calling insertUpdateFunctionGroup / delFunctionGroup per cell
37
+ * scanned the chain each time: 6.8 s for 1,000 formulas on 1,000 rows.
32
38
  */
33
39
  export declare function reregisterRestoredFormulas(ctx: Context, restored: RestoredCell[]): void;
@@ -0,0 +1,16 @@
1
+ import { Patch } from 'immer';
2
+ import { Context } from '../context';
3
+
4
+ export type GridSizeChange = {
5
+ sheetId: string;
6
+ path: ['row'] | ['column'];
7
+ value: number;
8
+ type: 'update';
9
+ };
10
+ /**
11
+ * Undo and redo of a row/column insert or delete change a sheet's `row` /
12
+ * `column`. The forward edit writes them to Yjs (`emitGridSizeToYdoc`); history
13
+ * wrote the restored cells only, so a peer kept the grown grid until a later
14
+ * effect fixed it, and only for the current sheet.
15
+ */
16
+ export declare function gridSizeChangesFromPatches(ctxAfter: Context, patches: Patch[]): GridSizeChange[];
@@ -31,7 +31,15 @@ export type Hooks = {
31
31
  onLocalCellEdit?: () => void;
32
32
  afterUpdateCell?: (row: number, column: number, oldValue: any, newValue: any,
33
33
  /** Sheet that held the cell when it was committed (updateCell only). */
34
- sheetId?: string) => void;
34
+ sheetId?: string,
35
+ /**
36
+ * `skipPersist`: the caller writes this cell to Yjs in its own batch (paste
37
+ * and fill), after the cell is final. Persisting here too wrote the
38
+ * pre-format value first, so every formula was written twice.
39
+ */
40
+ options?: {
41
+ skipPersist?: boolean;
42
+ }) => void;
35
43
  afterSelectionChange?: (sheetId: string, selection: Selection) => void;
36
44
  beforeRenderRowHeaderCell?: (rowNumber: string, rowIndex: number, top: number, width: number, height: number, ctx: CanvasRenderingContext2D) => boolean;
37
45
  afterRenderRowHeaderCell?: (rowNumber: string, rowIndex: number, top: number, width: number, height: number, ctx: CanvasRenderingContext2D) => void;
@@ -1,6 +1,17 @@
1
1
  import { Context } from '../context';
2
2
  import { Cell, CellWithRowAndCol } from '../types';
3
3
 
4
+ /** Receives changes instead of the updateCellYdoc hook (see createYdocBatch). */
5
+ export type YdocChangeSink = (changes: any[]) => void;
6
+ /**
7
+ * Collect the Yjs changes of one structural edit and send them in a single
8
+ * updateCellYdoc call, so the edit is one transaction and one update for peers
9
+ * (an insert used to send four and a delete five).
10
+ */
11
+ export declare function createYdocBatch(ctx: Context): {
12
+ sink: YdocChangeSink;
13
+ flush: () => void;
14
+ };
4
15
  export type CelldataYdocChange = {
5
16
  sheetId: string;
6
17
  path: string[];
@@ -17,7 +28,7 @@ export declare function cellsEqualForYdocPersist(before: unknown, after: unknown
17
28
  export declare function snapshotPersistedCelldataInRange(data: unknown[][] | null | undefined, r1: number, r2: number, c1: number, c2: number, celldata?: CellWithRowAndCol[] | null): Map<string, Cell | string | number | boolean>;
18
29
  export declare function appendCelldataDiffChange(changes: CelldataYdocChange[], sheetId: string, r: number, c: number, cell: unknown, beforePersisted?: Map<string, Cell | string | number | boolean>): void;
19
30
  export declare function buildCelldataChangesForRange(sheetId: string, data: unknown[][], r1: number, r2: number, c1: number, c2: number, beforePersisted?: Map<string, Cell | string | number | boolean>): CelldataYdocChange[];
20
- export declare function emitCelldataRangeDiffToYdoc(ctx: Context, sheetId: string, data: unknown[][], r1: number, r2: number, c1: number, c2: number, beforePersisted?: Map<string, Cell | string | number | boolean>): void;
31
+ export declare function emitCelldataRangeDiffToYdoc(ctx: Context, sheetId: string, data: unknown[][], r1: number, r2: number, c1: number, c2: number, beforePersisted?: Map<string, Cell | string | number | boolean>, sink?: YdocChangeSink): void;
21
32
  /** Formula text per tab and cell key, taken before a structural edit rewrites it. */
22
33
  export type FormulaTextSnapshot = Map<string, Map<string, string>>;
23
34
  /**
@@ -33,13 +44,13 @@ export declare function snapshotFormulaTexts(ctx: Context): FormulaTextSnapshot;
33
44
  * pre-edit coordinates, which equal post-edit ones for every cell outside
34
45
  * that range.
35
46
  */
36
- export declare function emitRewrittenFormulasToYdoc(ctx: Context, before: FormulaTextSnapshot, editedSheetId: string, editedFromR: number, editedFromC: number): void;
47
+ export declare function emitRewrittenFormulasToYdoc(ctx: Context, before: FormulaTextSnapshot, editedSheetId: string, editedFromR: number, editedFromC: number, sink?: YdocChangeSink): void;
37
48
  /**
38
49
  * After delete row/col, emit deletes for persisted keys that now sit past the
39
50
  * shrunken grid. Range diffs only visit coordinates still inside `data`, so
40
51
  * tail keys would otherwise resurrect on peers/reload.
41
52
  */
42
- export declare function emitCelldataDeletesBeyondGrid(ctx: Context, sheetId: string, beforePersisted: Map<string, Cell | string | number | boolean> | undefined, rowCount: number, colCount: number): void;
53
+ export declare function emitCelldataDeletesBeyondGrid(ctx: Context, sheetId: string, beforePersisted: Map<string, Cell | string | number | boolean> | undefined, rowCount: number, colCount: number, sink?: YdocChangeSink): void;
43
54
  export type MergeBounds = {
44
55
  minR: number;
45
56
  minC: number;
@@ -1,4 +1,4 @@
1
1
  import { default as React } from 'react';
2
2
 
3
- declare const FilterMenu: React.FC;
4
- export default FilterMenu;
3
+ declare const _default: React.NamedExoticComponent<{}>;
4
+ export default _default;
@@ -1,4 +1,4 @@
1
1
  import { default as React } from 'react';
2
2
 
3
- declare const SheetTabContextMenu: React.FC;
4
- export default SheetTabContextMenu;
3
+ declare const _default: React.NamedExoticComponent<{}>;
4
+ export default _default;
@@ -1,4 +1,4 @@
1
1
  import { default as React } from 'react';
2
2
 
3
- declare const ContextMenu: React.FC;
4
- export default ContextMenu;
3
+ declare const _default: React.NamedExoticComponent<{}>;
4
+ export default _default;
@@ -0,0 +1,16 @@
1
+ import { Cell } from '../../../core/types';
2
+
3
+ export type ShownCommentCell = {
4
+ r: number;
5
+ c: number;
6
+ };
7
+ /** Cells whose comment popup is pinned open (`ps.isShow`), in row-major order. */
8
+ export declare function collectShownCommentCells(data: (Cell | null)[][]): ShownCommentCell[];
9
+ /**
10
+ * Identity of a shown-comment set. NotationBoxes applies `showComments` only
11
+ * when this changes, so an edit that leaves the set alone costs no second
12
+ * context update. The sheet id is part of the key so that switching to a sheet
13
+ * with an equal (for example empty) set still replaces the previous sheet's
14
+ * boxes.
15
+ */
16
+ export declare function shownCommentsKey(sheetId: string | undefined, cells: ShownCommentCell[]): string;
@@ -1,6 +1,6 @@
1
1
  import { default as React } from 'react';
2
2
 
3
- declare const SVGDefines: React.FC<{
3
+ declare const _default: React.NamedExoticComponent<{
4
4
  currency: string;
5
5
  }>;
6
- export default SVGDefines;
6
+ export default _default;
@@ -0,0 +1,7 @@
1
+ /**
2
+ * True while a cell is being edited and either input holds a formula. The
3
+ * inputs' `innerText` is read only when `editing` is true (a read forces
4
+ * layout), and the formula bar is read only when the cell input did not
5
+ * already say yes.
6
+ */
7
+ export declare function isEditingAsFormula(editing: boolean, readCellInputText: () => string | undefined, readFxInputText: () => string | undefined): boolean;
@@ -0,0 +1,40 @@
1
+ import { Context, GlobalCache } from '../../../core';
2
+
3
+ export type HoverCell = {
4
+ row: number;
5
+ col: number;
6
+ } | null;
7
+ type Rect = {
8
+ left: number;
9
+ top: number;
10
+ width: number;
11
+ height: number;
12
+ };
13
+ type HoverTrackerOptions = {
14
+ /** Position of the cell area; read at most once per animation frame. */
15
+ getRect: () => Rect | undefined;
16
+ /** Cell under a page position, or null outside the cell area. */
17
+ locate: (pageX: number, pageY: number, rect: Rect | undefined) => HoverCell;
18
+ /** True while a drag, resize or popup needs every mouse move. */
19
+ isInteracting: () => boolean;
20
+ requestFrame: (cb: () => void) => void;
21
+ };
22
+ /**
23
+ * Decides whether a mouse move needs the full `setContext` pass. A move that
24
+ * stays in the same cell, with nothing being dragged or hovered, changes
25
+ * nothing, so it is skipped (E1).
26
+ */
27
+ export declare function createHoverTracker({ getRect, locate, isInteracting, requestFrame, }: HoverTrackerOptions): {
28
+ shouldProcess(e: {
29
+ pageX: number;
30
+ pageY: number;
31
+ }): boolean;
32
+ reset(): void;
33
+ };
34
+ /**
35
+ * True when `handleOverlayMouseMove` or `overShowLinkCard` do something that
36
+ * depends on more than the hovered cell: a comment box, image, cell or dialog
37
+ * drag, or a popup that must see the pointer leave it.
38
+ */
39
+ export declare function isHoverInteractionActive(ctx: Context, globalCache: GlobalCache): boolean;
40
+ export {};
@@ -1,4 +1,4 @@
1
1
  import { default as React } from 'react';
2
2
 
3
- declare const SheetTab: React.FC;
4
- export default SheetTab;
3
+ declare const _default: React.NamedExoticComponent<{}>;
4
+ export default _default;
@@ -0,0 +1,9 @@
1
+ export type FunctionLocaleItem = {
2
+ n?: string;
3
+ t?: number | string;
4
+ };
5
+ /** Groups the locale's function list by category for the function picker. */
6
+ export declare function groupFunctions(functionlist: FunctionLocaleItem[]): {
7
+ categories: ("Text" | "Date" | "Other" | "Logical" | "All" | "Array" | "Database" | "Engineering" | "Datablock" | "Financial" | "Lookup" | "Math" | "Operator" | "Parser" | "Statistical" | "Info")[];
8
+ getFunctions: (categoryKey: string) => string[];
9
+ };
@@ -7,11 +7,11 @@ export declare const CurrencySelector: ({ cell, defaultTextFormat, toolTipText,
7
7
  defaultTextFormat: string;
8
8
  toolTipText: string;
9
9
  }) => import("react/jsx-runtime").JSX.Element;
10
- declare const Toolbar: React.FC<{
10
+ declare const _default: React.NamedExoticComponent<{
11
11
  setMoreItems: React.Dispatch<React.SetStateAction<React.ReactNode>>;
12
12
  moreItemsOpen: boolean;
13
13
  onMoreToolbarItemsClose?: () => void;
14
14
  moreToolbarItems?: React.ReactNode;
15
15
  trailingContent?: React.ReactNode;
16
16
  }>;
17
- export default Toolbar;
17
+ export default _default;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * An object with the keys of `getLatest()` whose identity never changes. Each
3
+ * function member calls the function of the same name on the latest api, and
4
+ * each other member reads the latest value, so a host that keeps the handle
5
+ * across renders always sees current state (E3). The key set is taken from the
6
+ * first call and is expected to stay the same.
7
+ */
8
+ export declare function createStableHandle<T extends object>(getLatest: () => T): T;
@@ -1,5 +1,6 @@
1
1
  import { default as React } from 'react';
2
2
  import { Context, Settings, GlobalCache, PatchOptions } from '../../core';
3
+ import { WorkbookStore } from './workbook-store';
3
4
 
4
5
  export type RefValues = {
5
6
  globalCache: GlobalCache;
@@ -23,4 +24,18 @@ declare const WorkbookContext: React.Context<{
23
24
  handleUndo: () => void;
24
25
  handleRedo: () => void;
25
26
  }>;
27
+ /**
28
+ * The parts of the workbook that rarely change (setters, settings, refs) plus
29
+ * the store holding the latest context. Components that must not render on
30
+ * every update read this instead of `WorkbookContext` (E2).
31
+ */
32
+ export type WorkbookStable = {
33
+ store: WorkbookStore<Context>;
34
+ setContext: (recipe: (ctx: Context) => void, options?: SetContextOptions) => void;
35
+ settings: Required<Settings>;
36
+ refs: RefValues;
37
+ handleUndo: () => void;
38
+ handleRedo: () => void;
39
+ };
40
+ export declare const WorkbookStableContext: React.Context<WorkbookStable>;
26
41
  export default WorkbookContext;
@@ -0,0 +1,30 @@
1
+ import { Context } from '../../core';
2
+
3
+ export declare function useWorkbookSelector<S>(selector: (ctx: Context) => S, isEqual?: (a: S, b: S) => boolean): S;
4
+ /**
5
+ * Drop-in for `useContext(WorkbookContext)` in components that should not
6
+ * render on every context update: it returns the same shape, but the
7
+ * component renders again only when `equal` says the context changed in a way
8
+ * it cares about (or when its own props or state change). The returned
9
+ * `context` is always the latest one.
10
+ */
11
+ export declare function useWorkbookContextWhen(equal: (previous: Context, next: Context) => boolean): {
12
+ context: Context;
13
+ setContext: (recipe: (ctx: Context) => void, options?: import('./index').SetContextOptions) => void;
14
+ settings: Required<import('../../core').Settings>;
15
+ refs: import('./index').RefValues;
16
+ handleUndo: () => void;
17
+ handleRedo: () => void;
18
+ };
19
+ /**
20
+ * `useContext(WorkbookContext)` for components that must not render when only
21
+ * the scroll position or the row and column offsets changed (E2).
22
+ */
23
+ export declare function useWorkbookContextIgnoringScroll(): {
24
+ context: Context;
25
+ setContext: (recipe: (ctx: Context) => void, options?: import('./index').SetContextOptions) => void;
26
+ settings: Required<import('../../core').Settings>;
27
+ refs: import('./index').RefValues;
28
+ handleUndo: () => void;
29
+ handleRedo: () => void;
30
+ };
@@ -0,0 +1,30 @@
1
+ export type WorkbookStore<T> = {
2
+ getState: () => T;
3
+ setState: (next: T) => void;
4
+ subscribe: (listener: () => void) => () => void;
5
+ };
6
+ /** A one-value store; Workbook sets the latest context after every commit (E2). */
7
+ export declare function createWorkbookStore<T>(initial: T): WorkbookStore<T>;
8
+ /**
9
+ * The snapshot logic behind `useWorkbookSelector`: `getSnapshot` returns the
10
+ * previously handed-out value while `isEqual` says the newly selected one is
11
+ * the same, so `useSyncExternalStore` sees no change and the component does
12
+ * not render. The selector runs once per state.
13
+ */
14
+ export declare function createSelection<T, S>(store: WorkbookStore<T>, selector: (state: T) => S, isEqual?: (a: S, b: S) => boolean): {
15
+ subscribe: (listener: () => void) => () => void;
16
+ getSnapshot(): S;
17
+ };
18
+ /** True when two states differ only in the listed keys. */
19
+ export declare function onlyIgnoredKeysChanged(ignored: readonly string[]): (a: object, b: object) => boolean;
20
+ /**
21
+ * Context keys that change on scroll or when the row and column offsets are
22
+ * rebuilt after an edit, and that the components converted in E2 do not read:
23
+ * Toolbar and its popovers, SheetTab, ContextMenu, FilterMenu and
24
+ * SheetTabContextMenu. Checked with grep in those directories and in the
25
+ * helpers they call with the context (`updateCellsDecimalFormat`,
26
+ * `convertCellsToCrypto`, `isHyperlinkCreationBlocked`,
27
+ * `captureLinkEditorOpenSnapshot`).
28
+ */
29
+ export declare const SCROLL_ONLY_KEYS: readonly ["scrollLeft", "scrollTop", "visibledatarow", "visibledatacolumn"];
30
+ export declare const contextEqualIgnoringScroll: (a: object, b: object) => boolean;
@@ -1,10 +1,10 @@
1
1
  import * as BZ from "yjs";
2
- 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-ypRdpDnX.js";
3
- import { g as al } from "./executeStringFunction-DKA5MuP0.js";
2
+ 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-YKT7Lz7Z.js";
3
+ import { g as al } from "./executeStringFunction-BsVLVYUB.js";
4
4
  import { Workbook as Kl } from "exceljs";
5
5
  import Jl from "luckyexcel";
6
- import { e as xl, b as Ml, n as Sl } from "./xlsx-hyperlink-inline-DXj7AkSf.js";
7
- import { parseDefinedNamesFromXlsxBuffer as Nl, excelEntriesToDefinedNames as OZ } from "./xlsx-defined-names-CVVLxbe-.js";
6
+ import { e as xl, b as Ml, n as Sl } from "./xlsx-hyperlink-inline-07QbQDEt.js";
7
+ import { parseDefinedNamesFromXlsxBuffer as Nl, excelEntriesToDefinedNames as OZ } from "./xlsx-defined-names-D3F23p2Z.js";
8
8
  import { toast as fZ } from "@fileverse/ui";
9
9
  var Zl = { exports: {} };
10
10
  (function(m) {
@@ -1,5 +1,5 @@
1
- import { i as w } from "./executeStringFunction-DKA5MuP0.js";
2
- import { J as x } from "./xlsx-hyperlink-inline-DXj7AkSf.js";
1
+ import { i as w } from "./executeStringFunction-BsVLVYUB.js";
2
+ import { J as x } from "./xlsx-hyperlink-inline-07QbQDEt.js";
3
3
  function g(o) {
4
4
  return o.startsWith("_xlnm.");
5
5
  }
@@ -1,9 +1,9 @@
1
1
  import { utils as S, write as nt } from "xlsx-js-style";
2
2
  import { Workbook as pt } from "exceljs";
3
3
  import { toast as rt } from "@fileverse/ui";
4
- import { J as dt, c as X, g as ht, a as mt } from "./xlsx-hyperlink-inline-DXj7AkSf.js";
5
- import { b as gt } from "./executeStringFunction-DKA5MuP0.js";
6
- import { e as bt } from "./index-ypRdpDnX.js";
4
+ import { J as dt, c as X, g as ht, a as mt } from "./xlsx-hyperlink-inline-07QbQDEt.js";
5
+ import { b as gt } from "./executeStringFunction-BsVLVYUB.js";
6
+ import { e as bt } from "./index-YKT7Lz7Z.js";
7
7
  const xt = {
8
8
  1: "thin",
9
9
  2: "hair",
@@ -854,7 +854,7 @@ const Z = (t) => {
854
854
  O
855
855
  );
856
856
  });
857
- const { applyDefinedNamesToExcelWorkbook: ct } = await import("./xlsx-defined-names-CVVLxbe-.js");
857
+ const { applyDefinedNamesToExcelWorkbook: ct } = await import("./xlsx-defined-names-D3F23p2Z.js");
858
858
  ct(
859
859
  B,
860
860
  (k = (C = (s = t.current).getWorkbookContext) == null ? void 0 : C.call(s)) == null ? void 0 : k.definedNames,
@@ -1,5 +1,5 @@
1
- import { g as Rt, c as yt } from "./executeStringFunction-DKA5MuP0.js";
2
- import { c as wt } from "./index-ypRdpDnX.js";
1
+ import { g as Rt, c as yt } from "./executeStringFunction-BsVLVYUB.js";
2
+ import { c as wt } from "./index-YKT7Lz7Z.js";
3
3
  function jt(J, nt) {
4
4
  const g = J.getImages();
5
5
  if (!g.length) return [];
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@fileverse-dev/dsheet",
3
3
  "private": false,
4
4
  "description": "DSheet",
5
- "version": "4.1.23-stabilise-package-1",
5
+ "version": "4.1.23-stabilise-package-4",
6
6
  "repository": {
7
7
  "type": "git",
8
8
  "url": "git+https://github.com/fileverse/fileverse-dsheets.git"