@fileverse-dev/dsheet 4.1.23-stabilise-package-8 → 4.1.24-stabilise-package-1

package/dist/index.d.ts

@@ -23,7 +23,7 @@ export { ERROR_MESSAGES_FLAG, SERVICES_API_KEY, } from './editor/constants/share
 export { TEMPLATES } from '@fileverse-dev/dsheets-templates/template-metadata-list';
 export { handleCSVUpload } from './editor/utils/csv-import';
 export { importSpreadsheetFile, type ImportSpreadsheetFileOptions, type ImportSpreadsheetFileResult, type SpreadsheetImportFileType, } from './editor/utils/spreadsheet-import';
-export { handleExportToXLSX, handleExportToODS } from './editor/utils/xlsx-export';
+export { handleExportToXLSX, handleExportToODS, exportToXLSXBytes, } from './editor/utils/xlsx-export';
 export { handleExportToCSV } from './editor/utils/csv-export';
 export { handleExportToJSON } from './editor/utils/json-export';
 export { useXLSXImport } from './editor/hooks/use-xlsx-import';

package/dist/index.es.js

@@ -1,65 +1,66 @@
-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 F, w as E, x, z as g, A as R, B as f, D as A, E as I, F as L, G as w, H as y, I as T, J as v, K as D, L as M, M as b, N as k, O as K, P as O, Q as P } from "./index-Dbl7Dh2_.js";
-import { cI as z, cJ as J, cK as U, cQ as X, by as _, e as B, f as G, l as H, a as j, dv as q, dw as N, bh as Q, dx as Y, dy as Z, dC as W, dD as $, dF as ee, J as ae, dS as se, eq as oe, ba as te } from "./executeStringFunction-CN6ZZqZM.js";
-import { FLVURL as le } from "@fileverse-dev/formulajs";
-import { E as de, S as Se } from "./constants-8Ij49Lxv.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 R, A as g, B as L, D as A, E as T, F as f, G as I, H as v, I as w, J as y, K as D, L as M, M as X, N as b, O as k, P as z, Q as B, R as O } from "./index-CfRtF9ry.js";
+import { cL as V, cM as G, cN as H, cT as J, bD as K, e as U, f as _, l as N, a as j, dz as q, dA as Q, bh as Y, dB as Z, dC as W, dG as $, dH as ee, dJ as ae, J as se, dX as oe, ev as te, ba as re } from "./executeStringFunction-CT-4of9q.js";
+import { FLVURL as ne } from "@fileverse-dev/formulajs";
+import { E as Se, S as ce } from "./constants-8Ij49Lxv.js";
 export {
   s as CommentAction,
   o as CommentCellUI,
   t as CommentsContent,
   r as DSheetEditor,
   l as DSheetSkeleton,
-  de as ERROR_MESSAGES_FLAG,
-  le as FLVURL,
+  Se as ERROR_MESSAGES_FLAG,
+  ne as FLVURL,
   n as FortuneCore,
-  Se as SERVICES_API_KEY,
+  ce as SERVICES_API_KEY,
   d as SupportedChain,
   S as TEMPLATES,
   c as api,
-  z as clearColumnsCellsFormat,
+  V as clearColumnsCellsFormat,
   i as clearFilter,
-  J as clearRowsCellsFormat,
-  U as clearSelectedCellFormat,
+  G as clearRowsCellsFormat,
+  H as clearSelectedCellFormat,
   h as createFilter,
   m as decryptForRoomKey,
-  X as deleteRowCol,
-  _ as deleteSelectedCellText,
+  J as deleteRowCol,
+  K as deleteSelectedCellText,
   p as describeMatchedShortcut,
   C as encryptForRoomKey,
-  B as executeStringFunction,
-  u as fetchSessionState,
-  G as formulaResponseUiSync,
-  H as getFlowdata,
+  U as executeStringFunction,
+  u as exportToXLSXBytes,
+  E as fetchSessionState,
+  _ as formulaResponseUiSync,
+  N as getFlowdata,
   F as getRemoveDuplicatesErrorMessage,
-  E as getRemoveDuplicatesPreview,
+  x as getRemoveDuplicatesPreview,
   j as getSheetIndex,
-  x as handleCSVUpload,
+  R as handleCSVUpload,
   g as handleCopy,
-  R as handleExportToCSV,
-  f as handleExportToJSON,
-  A as handleExportToODS,
-  I as handleExportToXLSX,
+  L as handleExportToCSV,
+  A as handleExportToJSON,
+  T as handleExportToODS,
+  f as handleExportToXLSX,
   q as handleFreeze,
-  N as handleHorizontalAlign,
-  Q as handleLink,
-  Y as handleMerge,
-  L as handlePasteByClick,
-  Z as handleSort,
-  W as handleTextSize,
-  $ as handleVerticalAlign,
-  w as importSpreadsheetFile,
-  ee as insertRowCol,
-  y as isBrowserZoomShortcut,
-  T as isFormulaListShortcut,
-  v as isOpenShortcutsModalShortcut,
-  ae as jfrefreshgrid,
-  se as loadLocale,
-  D as remapCommentAnchors,
-  M as removeActiveImage,
+  Q as handleHorizontalAlign,
+  Y as handleLink,
+  Z as handleMerge,
+  I as handlePasteByClick,
+  W as handleSort,
+  $ as handleTextSize,
+  ee as handleVerticalAlign,
+  v as importSpreadsheetFile,
+  ae as insertRowCol,
+  w as isBrowserZoomShortcut,
+  y as isFormulaListShortcut,
+  D as isOpenShortcutsModalShortcut,
+  se as jfrefreshgrid,
+  oe as loadLocale,
+  M as remapCommentAnchors,
+  X as removeActiveImage,
   b as removeDuplicates,
   k as seedSession,
-  K as showImgChooser,
-  oe as toolbarItemClickHandler,
-  te as updateFormat,
-  O as useEnsStatus,
-  P as useXLSXImport
+  z as showImgChooser,
+  te as toolbarItemClickHandler,
+  re as updateFormat,
+  B as useEnsStatus,
+  O 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, finishFullFormulaPass, resetFormulaDependencyIndexes, 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, deleteCellsShift, insertCellsShift, } 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, finishFullFormulaPass, resetFormulaDependencyIndexes, 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, deleteCellsShift, insertCellsShift, } 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 { WideRange } from './formula-transitive-deps';
@@ -29,6 +30,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;
@@ -180,6 +184,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;
@@ -228,7 +240,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;
 /**
@@ -247,6 +259,25 @@ export type FormulaTabs = {
 /** 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, tabs: FormulaTabs): 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/sync-local/SyncManager.test.d.ts

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

package/dist/sync-local/socketClient.d.ts

@@ -8,6 +8,7 @@ interface ISocketClientConfig {
     ownerEdSecret?: string;
     contractAddress?: string;
     ownerAddress?: string;
+    appFileId?: string;
     editLock?: string;
     encryptedTitle?: string;
     identityToken?: string;
@@ -72,6 +73,7 @@ export declare class SocketClient {
     private collaborationUcan?;
     private serverClock;
     private ownerAddress?;
+    private appFileId?;
     private editLock?;
     private encryptedTitle?;
     private identityToken?;

package/dist/sync-local/socketClient.test.d.ts

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

package/dist/sync-local/types/index.d.ts

@@ -77,6 +77,8 @@ export interface CollabConnectionConfig {
     ownerEdSecret?: string;
     contractAddress?: string;
     ownerAddress?: string;
+    /** Host signal (opaque-link sheets): the on-chain dsheetId, sent to the server as ddocId alongside the public room id. */
+    appFileId?: string;
     roomInfo?: {
         documentTitle: string;
         portalAddress: string;
@@ -300,6 +302,7 @@ export interface IAuthArgs {
     ownerToken?: string;
     ownerAddress?: string;
     contractAddress?: string;
+    ddocId?: string;
     sessionDid?: string;
     roomInfo?: string;
     identityToken?: string;

package/dist/{use-xlsx-import-impl-sGRvmOlI.js → use-xlsx-import-impl-Yyav1K_X.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-Dbl7Dh2_.js";
-import { g as al } from "./executeStringFunction-CN6ZZqZM.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-CfRtF9ry.js";
+import { g as al } from "./executeStringFunction-CT-4of9q.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-DjtQMKIL.js";
-import { parseDefinedNamesFromXlsxBuffer as Nl, excelEntriesToDefinedNames as OZ } from "./xlsx-defined-names-C6c8LJn5.js";
+import { e as xl, b as Ml, n as Sl } from "./xlsx-hyperlink-inline-DGb-w2IM.js";
+import { parseDefinedNamesFromXlsxBuffer as Nl, excelEntriesToDefinedNames as OZ } from "./xlsx-defined-names-D6d7zKHF.js";
 import { toast as fZ } from "@fileverse/ui";
 var Zl = { exports: {} };
 (function(m) {

package/dist/{xlsx-defined-names-C6c8LJn5.js → xlsx-defined-names-D6d7zKHF.js}

@@ -1,5 +1,5 @@
-import { i as w } from "./executeStringFunction-CN6ZZqZM.js";
-import { J as x } from "./xlsx-hyperlink-inline-DjtQMKIL.js";
+import { i as w } from "./executeStringFunction-CT-4of9q.js";
+import { J as x } from "./xlsx-hyperlink-inline-DGb-w2IM.js";
 function g(o) {
   return o.startsWith("_xlnm.");
 }