@fileverse-dev/dsheet 4.1.23 → 4.1.24

package/dist/index.es.js

@@ -1,5 +1,5 @@
-import { C as s, d as o, f as t, S as r, g as l, h as n, j as d, T as S, k as c, l as i, n as m, o as h, p, q as C, t as u, u as E, v as F, w as g, x, z as R, A, B as f, D as I, E as L, F as T, G as w, H as y, I as v, J as D, K as M, L as b, M as k, N as z, O, P } from "./index-8_qnUyMl.js";
-import { cy as G, cz as K, cA as U, cG as X, bs as _, e as j, f as B, l as H, a as J, dj as N, dk as q, bb as Y, dl as Z, dm as Q, dr as W, ds as $, du as ee, I as ae, dJ as se, eg as oe, b4 as te } from "./executeStringFunction-ZHYCWIpK.js";
+import { C as s, d as o, f as t, S as r, g as l, h as n, j as d, T as S, k as c, l as i, n as m, o as h, p, q as C, t as u, u as E, v as F, w as x, x as g, z as R, A as f, B as A, D as I, E as L, F as w, G as T, H as v, I as y, J as D, K as M, L as b, M as O, N as k, O as P, P as V } from "./index-DvpQioe4.js";
+import { cB as B, cC as K, cD as U, cJ as X, bx as _, e as G, f as H, l as J, a as j, dn as q, dp as N, bb as Y, dq as Z, dr as Q, dv as W, dw as $, dy as ee, I as ae, dO as se, el as oe, b4 as te } from "./executeStringFunction-B3Tw7e1U.js";
 import { FLVURL as le } from "@fileverse-dev/formulajs";
 import { E as de, S as Se } from "./constants-8Ij49Lxv.js";
 export {
@@ -15,7 +15,7 @@ export {
   d as SupportedChain,
   S as TEMPLATES,
   c as api,
-  G as clearColumnsCellsFormat,
+  B as clearColumnsCellsFormat,
   i as clearFilter,
   K as clearRowsCellsFormat,
   U as clearSelectedCellFormat,
@@ -25,41 +25,41 @@ export {
   _ as deleteSelectedCellText,
   p as describeMatchedShortcut,
   C as encryptForRoomKey,
-  j as executeStringFunction,
+  G as executeStringFunction,
   u as fetchSessionState,
-  B as formulaResponseUiSync,
-  H as getFlowdata,
+  H as formulaResponseUiSync,
+  J as getFlowdata,
   E as getRemoveDuplicatesErrorMessage,
   F as getRemoveDuplicatesPreview,
-  J as getSheetIndex,
-  g as handleCSVUpload,
-  x as handleCopy,
+  j as getSheetIndex,
+  x as handleCSVUpload,
+  g as handleCopy,
   R as handleExportToCSV,
-  A as handleExportToJSON,
-  f as handleExportToODS,
+  f as handleExportToJSON,
+  A as handleExportToODS,
   I as handleExportToXLSX,
-  N as handleFreeze,
-  q as handleHorizontalAlign,
+  q as handleFreeze,
+  N as handleHorizontalAlign,
   Y as handleLink,
   Z as handleMerge,
   L as handlePasteByClick,
   Q as handleSort,
   W as handleTextSize,
   $ as handleVerticalAlign,
-  T as importSpreadsheetFile,
+  w as importSpreadsheetFile,
   ee as insertRowCol,
-  w as isBrowserZoomShortcut,
-  y as isFormulaListShortcut,
-  v as isOpenShortcutsModalShortcut,
+  T as isBrowserZoomShortcut,
+  v as isFormulaListShortcut,
+  y as isOpenShortcutsModalShortcut,
   ae as jfrefreshgrid,
   se as loadLocale,
   D as remapCommentAnchors,
   M as removeActiveImage,
   b as removeDuplicates,
-  k as seedSession,
-  z as showImgChooser,
+  O as seedSession,
+  k as showImgChooser,
   oe as toolbarItemClickHandler,
   te as updateFormat,
-  O as useEnsStatus,
-  P as useXLSXImport
+  P as useEnsStatus,
+  V as useXLSXImport
 };

package/dist/sheet-engine/core/index.d.ts

@@ -7,7 +7,7 @@ export { defaultSettings } from './settings';
 export type { Settings, Hooks, DateBaseLocale, CommentAnchorMove, } from './settings';
 export { handleCopy, handleGlobalKeyDown, handlePaste, handlePasteByClick, fixPositionOnFrozenCells, handleCellAreaMouseDown, handleCellAreaDoubleClick, handleContextMenu, mouseRender, handleOverlayMouseMove, handleOverlayMouseUp, handleRowHeaderMouseDown, handleColumnHeaderMouseDown, handleColSizeHandleMouseDown, handleColSizeHandleDoubleClick, handleRowSizeHandleMouseDown, handleColFreezeHandleMouseDown, handleRowFreezeHandleMouseDown, describeMatchedShortcut, isBrowserZoomShortcut, isOpenShortcutsModalShortcut, isFormulaListShortcut, } from './events';
 export * from './locale';
-export { getBorderInfoComputeRange, getBorderInfoCompute, normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, isValidRangeText, getInlineStringHTML, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, clipboard, moveToEnd, getRangeRectsByCharacterOffset, getDateBaseLocale, getCanonicalDateDisplayFormat, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, buildFiatCurrencyFormat, quoteSsfLiteral, FormulaCache, groupValuesRefresh, execFunctionGroup, runFormulaEvalChunk, applyWorkerFormulaChunkResults, isFormulaEvalPending, FORMULA_ASYNC_CHUNK_SIZE, FORMULA_ASYNC_EVAL_THRESHOLD, FORMULA_WORKER_CHUNK_SIZE, FORMULA_WORKER_THRESHOLD, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, ensureFormulaRangeToSheet, shouldPreserveFormulaEditOnSheetSwitch, activateSheetForNavigation, returnToFormulaOriginSheet, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, getFilterHiddenRowsUnionFromFilterMap, getFilterHiddenRowsUnion, ensureManualHiddenInitialized, rebuildRowHiddenUnion, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, defaultLuckysheetSelectRanges, normalizeSelection, syncPrimaryCellActiveFromSelection, selectionIsExactlyOneMergeBlock, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, snapSheetSelectionFocusToCellPreserveMultiRange, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, addSheet, deleteSheet, editSheetName, changeSheet, updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, mergeSelectionHasValues, handleSort, getRemoveDuplicatesPreview, removeDuplicates, getRemoveDuplicatesErrorMessage, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, isHyperlinkCreationBlocked, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, removeOverShowComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, copyActiveImage, cutActiveImage, pasteImageItem, loadImageFromFile, getImageClipboard, getImageCutSourceId, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, createDropCellRange, sortSelection, sortSheetBySelectedColumn, searchAll, searchNext, replace, replaceAll, replaceAllScoped, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, createFilterOptions, clearFilter, clearFilterForColumn, toggleViewerFilter, createFilter, applySheetFilterState, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, onCellsMoveStart, cfSplitRange, updateMoreCell, getRegStr, getDataArr, applyLocation, getOptionValue, getSelectRange, getDropdownList, setDropdownValue, confirmMessage, setConditionRules, CF_DATE_DEFAULT_FORMAT, parseCfDateConditionForUi, formatCfDatePresetSnapshot, parseDdMmYyyyToSerial, handleOverlayTouchStart, handleOverlayTouchEnd, MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, jfrefreshgrid, sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, setCellError, clearCellError, detectDateFormat, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, iscelldata, getcellrange, cancelFunctionrangeSelected, seletedHighlistByindex, spillSortResult, execfunction, insertUpdateFunctionGroup, remapFormulaReferencesByMap, refreshFormulasUsingDefinedNames, checkCF, getComputeMap, isValidDefinedNameIdentifier, getDefinedNameDisplayRange, findDefinedNameForSelection, findDefinedNameByName, resolveDefinedNameForFormula, addDefinedName, updateDefinedName, deleteDefinedName, selectDefinedName, openNamedRangesSidebar, scheduleDefinedNamesSync, shiftDefinedNamesOnInsert, shiftDefinedNamesOnDelete, removeDefinedNamesForSheet, cancelPaintModel, hideCRCount, getdatabyselection, } from './modules';
+export { getBorderInfoComputeRange, getBorderInfoCompute, normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, isValidRangeText, getInlineStringHTML, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, clipboard, moveToEnd, getRangeRectsByCharacterOffset, getDateBaseLocale, getCanonicalDateDisplayFormat, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, buildFiatCurrencyFormat, quoteSsfLiteral, FormulaCache, groupValuesRefresh, execFunctionGroup, runFormulaEvalChunk, applyWorkerFormulaChunkResults, isFormulaEvalPending, FORMULA_ASYNC_CHUNK_SIZE, FORMULA_ASYNC_EVAL_THRESHOLD, FORMULA_WORKER_CHUNK_SIZE, FORMULA_WORKER_THRESHOLD, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, resetFormulaArrowSession, ensureFormulaRangeToSheet, shouldPreserveFormulaEditOnSheetSwitch, activateSheetForNavigation, returnToFormulaOriginSheet, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, getFilterHiddenRowsUnionFromFilterMap, getFilterHiddenRowsUnion, ensureManualHiddenInitialized, rebuildRowHiddenUnion, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, defaultLuckysheetSelectRanges, normalizeSelection, syncPrimaryCellActiveFromSelection, selectionIsExactlyOneMergeBlock, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, snapSheetSelectionFocusToCellPreserveMultiRange, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, addSheet, deleteSheet, editSheetName, changeSheet, updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, mergeSelectionHasValues, handleSort, getRemoveDuplicatesPreview, removeDuplicates, getRemoveDuplicatesErrorMessage, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, isHyperlinkCreationBlocked, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, removeOverShowComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, copyActiveImage, cutActiveImage, pasteImageItem, loadImageFromFile, getImageClipboard, getImageCutSourceId, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, createDropCellRange, sortSelection, sortSheetBySelectedColumn, searchAll, searchNext, replace, replaceAll, replaceAllScoped, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, createFilterOptions, clearFilter, clearFilterForColumn, toggleViewerFilter, createFilter, applySheetFilterState, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, onCellsMoveStart, cfSplitRange, updateMoreCell, getRegStr, getDataArr, applyLocation, getOptionValue, getSelectRange, getDropdownList, setDropdownValue, confirmMessage, setConditionRules, CF_DATE_DEFAULT_FORMAT, parseCfDateConditionForUi, formatCfDatePresetSnapshot, parseDdMmYyyyToSerial, handleOverlayTouchStart, handleOverlayTouchEnd, MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, jfrefreshgrid, sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, setCellError, clearCellError, detectDateFormat, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, iscelldata, getcellrange, cancelFunctionrangeSelected, seletedHighlistByindex, spillSortResult, execfunction, insertUpdateFunctionGroup, remapFormulaReferencesByMap, refreshFormulasUsingDefinedNames, checkCF, getComputeMap, isValidDefinedNameIdentifier, getDefinedNameDisplayRange, findDefinedNameForSelection, findDefinedNameByName, resolveDefinedNameForFormula, addDefinedName, updateDefinedName, deleteDefinedName, selectDefinedName, openNamedRangesSidebar, scheduleDefinedNamesSync, shiftDefinedNamesOnInsert, shiftDefinedNamesOnDelete, removeDefinedNamesForSheet, cancelPaintModel, hideCRCount, getdatabyselection, } from './modules';
 export type { FilterDate, FilterValue, FilterColor } from './modules';
 export { getFreezeState, getFrozenPixelBounds, toggleFreeze, indexToColumnChar, escapeScriptTag, escapeHTMLTag, getSheetIndex, replaceHtml, isAllowEdit, isAllowEditReadOnly, filterPatch, patchToOp, opToPatch, inverseRowColOptions, } from './utils';
 export type { PatchOptions, ChangedSheet } from './utils';

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

@@ -0,0 +1,81 @@
+/**
+ * Pure (DOM-free, ctx-free) logic that decides what an arrow key does while a
+ * formula is being edited.
+ *
+ * GRID             - not editing: arrows move the grid selection
+ * TEXT_EDIT        - arrows move the text caret
+ * REFERENCE_READY  - next arrow inserts a new cell reference at the caret
+ * REFERENCE_ACTIVE - arrows move/extend the reference that was just inserted
+ */
+export type FormulaArrowMode = 'GRID' | 'TEXT_EDIT' | 'REFERENCE_READY' | 'REFERENCE_ACTIVE';
+/** Sticky, user-controlled (F2). `null` = automatic behavior. */
+export type FormulaArrowOverride = null | 'TEXT_EDIT' | 'REFERENCE';
+export type TokenKind = 'EQ' | 'SPACE' | 'STRING' | 'REF' | 'NAME' | 'NUMBER' | 'FUNC_NAME' | 'LPAREN' | 'RPAREN' | 'COMMA' | 'OPERATOR' | 'POSTFIX' | 'UNKNOWN';
+export type Token = {
+    kind: TokenKind;
+    start: number;
+    end: number;
+    text: string;
+    /** STRING / quoted sheet name: closing quote present. */
+    terminated?: boolean;
+    /** REF that is not (yet) a complete reference, e.g. `A1:A`, `A1:`. */
+    partial?: boolean;
+};
+/** Never throws. Offsets index into `text` as given. */
+export declare function tokenizeFormula(text: string): Token[];
+export type CaretContext = {
+    inString: boolean;
+    /** Caret strictly inside a non-string token (e.g. `A|1`, `SU|M(`). */
+    insideToken: Token | null;
+    /** REF token the caret is inside or right after (start < caret <= end). */
+    touchingRef: Token | null;
+    prevSig: Token | null;
+    nextSig: Token | null;
+};
+export declare function getCaretContext(tokens: Token[], caret: number): CaretContext;
+/**
+ * True when a new operand (cell reference) can be entered at the caret:
+ * the previous significant token wants an operand, the caret is not inside a
+ * string or token, and no operand sits immediately to the right.
+ */
+export declare function isOperandSlot(ctx: CaretContext): boolean;
+export type ArrowModeInput = {
+    editing: boolean;
+    /** Full editor text (offsets of `caretOffset` index into it). */
+    text: string;
+    /** null when the caret is not inside the editor. */
+    caretOffset: number | null;
+    override: FormulaArrowOverride;
+    /** false for sessions opened on an existing formula (F2 / dblclick / bar). */
+    autoAllowed: boolean;
+    /**
+     * The engine is driving a reference right now (mouse drag, or a reference the
+     * keyboard just inserted and the caret is still on).
+     */
+    refActive: boolean;
+};
+/** Decision priority from the product spec, evaluated in this exact order. */
+export declare function resolveArrowMode(input: ArrowModeInput): FormulaArrowMode;
+/**
+ * F2 while editing a formula: flip between caret and reference selection.
+ *
+ * Toggles the stored override once one exists, so a second press always undoes
+ * the first, even at a caret where the derived mode cannot change (e.g. after
+ * `)`). With no stored override, flips from the mode the user is looking at.
+ */
+export declare function overrideAfterF2(mode: FormulaArrowMode, current?: FormulaArrowOverride): FormulaArrowOverride;
+/**
+ * Rule 4: keys typed while a reference is active end the arrow-driven
+ * reference. The next mode is then derived from the caret position
+ * (operator or `,` -> READY, `)` or anything else -> TEXT_EDIT).
+ * keyCode based because it is called from keyup/keydown handlers.
+ */
+export declare function isTextChangingKeyCode(kcode: number): boolean;
+/**
+ * Keys that edit characters *inside* a reference token (letters, digits incl.
+ * numpad digits, Backspace/Delete). Typing them over an arrow-inserted
+ * reference makes it a hand-edited token, so its highlight must be dropped.
+ * Operators, commas and spaces are not here: they end the reference but leave
+ * its highlight alone (see `isTextChangingKeyCode`).
+ */
+export declare function isReferenceDirtyingKeyCode(kcode: number): boolean;

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

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

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

@@ -1,5 +1,6 @@
 import { Cell, CellMatrix, Rect, Selection } from '../types';
 import { Context } from '../context';
+import { FormulaArrowMode, FormulaArrowOverride } from './formula-arrow-mode';
 import { FormulaAsyncEvalJob } from './formula-async-eval';
 import { RangePassCacheEntry } from './formula-range-cache';
 import { SnapshotEvalOutput } from './formula-snapshot-eval';
@@ -28,6 +29,9 @@ export declare class FormulaCache {
     rangedrag_row_start?: boolean;
     rangeSelectionActive?: boolean | null;
     keyboardRangeSelectionLock?: boolean;
+    arrowOverride?: FormulaArrowOverride;
+    arrowAutoAllowed?: boolean;
+    arrowSessionCell?: [number, number];
     /** True after arrow/Shift+arrow moved `func_selectedrange` without updating yellow selection. */
     formulaKeyboardRefSync?: boolean;
     formulaEditorOwner?: 'cell' | 'fx' | null;
@@ -98,6 +102,14 @@ export declare function execFunctionGroup(ctx: Context, origin_r: number, origin
  * without resizing `luckysheet_select_save`.
  */
 export declare function seedFormulaFuncSelectedRangeFromLastSelection(ctx: Context): boolean;
+/**
+ * Explicit reference selection (F2) with the caret on an existing reference:
+ * seed the keyboard range from *that reference*, so the first arrow moves it
+ * from where it is (`=SUM(A1|)` + Right -> `=SUM(B1)`), not from the edited
+ * cell. Replaces any stale `func_selectedrange`. Returns false when the caret
+ * is not on a complete reference on the visible sheet.
+ */
+export declare function seedFormulaFuncSelectedRangeFromTouchedReference(ctx: Context): boolean;
 export declare function createFormulaRangeSelect(ctx: Context, select: {
     rangeIndex: number;
 } & Rect): void;
@@ -146,7 +158,7 @@ export declare function isBareCellOrRangeOnlyFormula(formulaText: string): boole
  * disable sheet-driven range selection until the caret reaches a fresh insertion slot
  * (comma, open paren, operator, etc.) or the user starts an active range drag.
  */
-export declare function suppressFormulaRangeSelectionForInitialEdit(ctx: Context): void;
+export declare function suppressFormulaRangeSelectionForInitialEdit(ctx: Context, cell?: [number, number]): void;
 export declare function isCaretAtValidFormulaRangeInsertionPoint(editor: HTMLElement | null): boolean;
 export declare function markRangeSelectionDirty(ctx: Context): void;
 /**
@@ -161,6 +173,25 @@ export declare function toggleFormulaAbsoluteReferenceAtCaret(ctx: Context, $cop
 /** True while picking a range for a formula (sheet selection drives references). */
 export declare function isLegacyFormulaRangeMode(ctx: Context): boolean;
 export declare function israngeseleciton(ctx: Context, istooltip?: boolean): boolean;
+/**
+ * Start (or end) an arrow-key session with the defaults: automatic reference
+ * selection on, no F2 override. Call when a session opens on a cell that does
+ * not hold a formula, and when one ends.
+ */
+export declare function resetFormulaArrowSession(ctx: Context): void;
+/** The F2 override / auto flag in effect for the cell being edited right now. */
+export declare function getFormulaArrowSession(ctx: Context): {
+    override: FormulaArrowOverride;
+    autoAllowed: boolean;
+};
+/** F2 pressed while editing: store the new override for this cell's session. */
+export declare function setFormulaArrowOverride(ctx: Context, override: FormulaArrowOverride): void;
+/**
+ * Single source of truth for what an arrow key does while editing.
+ * Thin ctx/DOM adapter over the pure `resolveArrowMode`.
+ */
+export declare function getFormulaArrowMode(ctx: Context): FormulaArrowMode;
+/** True while arrows should drive a cell reference (READY or ACTIVE). */
 export declare function isFormulaReferenceInputMode(ctx: Context): boolean;
 export declare function maybeRecoverDirtyRangeSelection(ctx: Context): boolean;
 export declare function functionStrChange(txt: string, type: string, rc: 'row' | 'col', orient: string | null, stindex: number, step: number): string;

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

@@ -4,7 +4,7 @@ export { default as clipboard } from './clipboard';
 export { moveToEnd, getRangeRectsByCharacterOffset } from './cursor';
 export { getDateBaseLocale, getCanonicalDateDisplayFormat, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, } from './date-base-locale';
 export { update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, buildFiatCurrencyFormat, quoteSsfLiteral, } from './format';
-export { FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, createFormulaRangeSelect, maybeRecoverDirtyRangeSelection, delFunctionGroup, functionHTMLGenerate, onFormulaRangeDragEnd, rangeDrag, rangeSetValue, remapFormulaReferencesByMap, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, getFormulaRangeIndexForKeyboardSync, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, functionStrChange, setFormulaEditorOwner, getAllFunctionGroup, suppressFormulaRangeSelectionForInitialEdit, ensureFormulaRangeToSheet, shouldPreserveFormulaEditOnSheetSwitch, activateSheetForNavigation, returnToFormulaOriginSheet, } from './formula';
+export { FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, createFormulaRangeSelect, maybeRecoverDirtyRangeSelection, delFunctionGroup, functionHTMLGenerate, onFormulaRangeDragEnd, rangeDrag, rangeSetValue, remapFormulaReferencesByMap, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, getFormulaRangeIndexForKeyboardSync, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, functionStrChange, setFormulaEditorOwner, getAllFunctionGroup, suppressFormulaRangeSelectionForInitialEdit, resetFormulaArrowSession, ensureFormulaRangeToSheet, shouldPreserveFormulaEditOnSheetSwitch, activateSheetForNavigation, returnToFormulaOriginSheet, } from './formula';
 export { FORMULA_ASYNC_CHUNK_SIZE, FORMULA_ASYNC_EVAL_THRESHOLD, FORMULA_WORKER_CHUNK_SIZE, FORMULA_WORKER_THRESHOLD, isFormulaEvalPending, } from './formula-async-eval';
 export type { FormulaAsyncEvalJob } from './formula-async-eval';
 export { initFreeze } from './freeze';

package/dist/{use-xlsx-import-impl-cgDH14_y.js → use-xlsx-import-impl-DWkIjd5v.js}

@@ -1,10 +1,10 @@
 import * as BZ from "yjs";
-import { i as Yl, a as hl, s as eZ, r as ul, y as Il, b as pl, m as Rl } from "./index-8_qnUyMl.js";
-import { g as sl } from "./executeStringFunction-ZHYCWIpK.js";
+import { i as Yl, a as hl, s as eZ, r as ul, y as Il, b as pl, m as Rl } from "./index-DvpQioe4.js";
+import { g as sl } from "./executeStringFunction-B3Tw7e1U.js";
 import { Workbook as al } from "exceljs";
 import Kl from "luckyexcel";
-import { e as Jl, b as xl, n as Ml } from "./xlsx-hyperlink-inline-T4GsXFm7.js";
-import { parseDefinedNamesFromXlsxBuffer as Sl, excelEntriesToDefinedNames as OZ } from "./xlsx-defined-names-DCK7aKIO.js";
+import { e as Jl, b as xl, n as Ml } from "./xlsx-hyperlink-inline-DaxgypSu.js";
+import { parseDefinedNamesFromXlsxBuffer as Sl, excelEntriesToDefinedNames as OZ } from "./xlsx-defined-names-776Vg9GT.js";
 import { toast as fZ } from "@fileverse/ui";
 var Zl = { exports: {} };
 (function(m) {

package/dist/{xlsx-defined-names-DCK7aKIO.js → xlsx-defined-names-776Vg9GT.js}

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

package/dist/{xlsx-export-impl-BHDWz0aW.js → xlsx-export-impl-C60SB8Ve.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-T4GsXFm7.js";
-import { b as gt } from "./executeStringFunction-ZHYCWIpK.js";
-import { e as bt } from "./index-8_qnUyMl.js";
+import { J as dt, c as X, g as ht, a as mt } from "./xlsx-hyperlink-inline-DaxgypSu.js";
+import { b as gt } from "./executeStringFunction-B3Tw7e1U.js";
+import { e as bt } from "./index-DvpQioe4.js";
 const xt = {
   1: "thin",
   2: "hair",
@@ -854,7 +854,7 @@ const Z = (t) => {
           O
         );
       });
-      const { applyDefinedNamesToExcelWorkbook: ct } = await import("./xlsx-defined-names-DCK7aKIO.js");
+      const { applyDefinedNamesToExcelWorkbook: ct } = await import("./xlsx-defined-names-776Vg9GT.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-T4GsXFm7.js → xlsx-hyperlink-inline-DaxgypSu.js}

@@ -1,5 +1,5 @@
-import { g as Rt, c as yt } from "./executeStringFunction-ZHYCWIpK.js";
-import { c as wt } from "./index-8_qnUyMl.js";
+import { g as Rt, c as yt } from "./executeStringFunction-B3Tw7e1U.js";
+import { c as wt } from "./index-DvpQioe4.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",
+  "version": "4.1.24",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fileverse/fileverse-dsheets.git"