@fileverse-dev/dsheet 2.0.36 → 2.1.0-shortcut-2

package/dist/index.d.ts

@@ -1,10 +1,12 @@
 export { default as DSheetEditor } from './editor/dsheet-editor';
+export { default as DSheetSkeleton } from './editor/components/skeleton-loader';
 export { formulaResponseUiSync } from './editor/utils/formula-ui-sync';
 export { executeStringFunction } from './editor/utils/executeStringFunction';
 export { FLVURL } from '@fileverse-dev/formulajs';
 export { loadLocale } from './sheet-engine/core';
 export type { ErrorMessageHandlerReturnType } from './editor/types';
 export type { WorkbookInstance } from './sheet-engine/react';
+export type { CollaborationProps, CollabConnectionConfig, CollabSessionMeta, CollabServices, CollabCallbacks, CollabState, CollabStatus, CollabError, CollabErrorCode, CollabUser, } from './sync-local/types';
 export { ERROR_MESSAGES_FLAG, SERVICES_API_KEY, } from './editor/constants/shared-constants';
 export { TEMPLATES } from '@fileverse-dev/dsheets-templates/template-metadata-list';
 export { handleCSVUpload } from './editor/utils/csv-import';
@@ -13,5 +15,5 @@ export { handleExportToCSV } from './editor/utils/csv-export';
 export { handleExportToJSON } from './editor/utils/json-export';
 export { useXLSXImport } from './editor/hooks/use-xlsx-import';
 export * as FortuneCore from './sheet-engine/core';
-export { createFilter, clearFilter, handleSort, handleCopy, handlePasteByClick, removeActiveImage, jfrefreshgrid, deleteSelectedCellText, deleteRowCol, getFlowdata, updateFormat, handleTextSize, handleHorizontalAlign, handleVerticalAlign, toolbarItemClickHandler, getSheetIndex, handleMerge, clearSelectedCellFormat, clearColumnsCellsFormat, clearRowsCellsFormat, handleFreeze, insertRowCol, showImgChooser, handleLink, api, } from './sheet-engine/core';
+export { createFilter, clearFilter, handleSort, handleCopy, handlePasteByClick, removeActiveImage, jfrefreshgrid, deleteSelectedCellText, deleteRowCol, getFlowdata, updateFormat, handleTextSize, handleHorizontalAlign, handleVerticalAlign, toolbarItemClickHandler, getSheetIndex, handleMerge, clearSelectedCellFormat, clearColumnsCellsFormat, clearRowsCellsFormat, handleFreeze, insertRowCol, showImgChooser, handleLink, api, describeMatchedShortcut, isFormulaListShortcut, isOpenShortcutsModalShortcut, isZoomInShortcut, isZoomOutShortcut, } from './sheet-engine/core';
 export type { PatchOptions } from './sheet-engine/core';

package/dist/index.es.js

@@ -1,45 +1,51 @@
-import { S as s, i as l, T as o, a as r, c as t, b as n, h as d, d as S, e as h, f as c, g as i, j as m, k as C, l as p, n as E, o as F, p as x, q as g, r as R, s as f, t as L, u as b, v as u, w as T } from "./index-CqPhp0yr.js";
-import { bL as I, bM as w, bN as V, bR as k, bb as M, e as X, f as _, h as j, a as v, cc as y, aq as z, cj as P } from "./executeStringFunction-Bl4AYetV.js";
-import { FLVURL as q } from "@fileverse-dev/formulajs";
-import { E as H, S as N } from "./constants-CnhOvijG.js";
+import { S as s, a as o, i as t, T as l, b as r, d as n, e as d, f as S, h, g as c, j as i, k as m, l as u, n as C, o as p, p as E, q as F, r as x, s as g, t as f, u as R, v as L, w as b, x as A, z as I, A as T, B as w, C as V, D as k, E as M } from "./index-llRXqdgK.js";
+import { bP as O, bQ as P, bR as X, bV as _, bg as v, e as y, f as D, h as U, a as j, cf as q, aq as B, cm as G } from "./executeStringFunction-tdvZ0KTi.js";
+import { FLVURL as Z } from "@fileverse-dev/formulajs";
+import { E as K, S as N } from "./constants-yStXQJiK.js";
 export {
   s as DSheetEditor,
-  H as ERROR_MESSAGES_FLAG,
-  q as FLVURL,
-  l as FortuneCore,
+  o as DSheetSkeleton,
+  K as ERROR_MESSAGES_FLAG,
+  Z as FLVURL,
+  t as FortuneCore,
   N as SERVICES_API_KEY,
-  o as TEMPLATES,
+  l as TEMPLATES,
   r as api,
-  I as clearColumnsCellsFormat,
-  t as clearFilter,
-  w as clearRowsCellsFormat,
-  V as clearSelectedCellFormat,
-  n as createFilter,
-  k as deleteRowCol,
-  M as deleteSelectedCellText,
-  X as executeStringFunction,
-  _ as formulaResponseUiSync,
-  j as getFlowdata,
-  v as getSheetIndex,
-  d as handleCSVUpload,
-  S as handleCopy,
-  h as handleExportToCSV,
-  c as handleExportToJSON,
-  i as handleExportToXLSX,
-  m as handleFreeze,
-  C as handleHorizontalAlign,
-  p as handleLink,
-  E as handleMerge,
-  F as handlePasteByClick,
-  x as handleSort,
-  g as handleTextSize,
+  O as clearColumnsCellsFormat,
+  n as clearFilter,
+  P as clearRowsCellsFormat,
+  X as clearSelectedCellFormat,
+  d as createFilter,
+  _ as deleteRowCol,
+  v as deleteSelectedCellText,
+  S as describeMatchedShortcut,
+  y as executeStringFunction,
+  D as formulaResponseUiSync,
+  U as getFlowdata,
+  j as getSheetIndex,
+  h as handleCSVUpload,
+  c as handleCopy,
+  i as handleExportToCSV,
+  m as handleExportToJSON,
+  u as handleExportToXLSX,
+  C as handleFreeze,
+  p as handleHorizontalAlign,
+  E as handleLink,
+  F as handleMerge,
+  x as handlePasteByClick,
+  g as handleSort,
+  f as handleTextSize,
   R as handleVerticalAlign,
-  y as insertRowCol,
-  z as jfrefreshgrid,
-  P as loadLocale,
-  f as removeActiveImage,
-  L as showImgChooser,
-  b as toolbarItemClickHandler,
-  u as updateFormat,
-  T as useXLSXImport
+  q as insertRowCol,
+  L as isFormulaListShortcut,
+  b as isOpenShortcutsModalShortcut,
+  A as isZoomInShortcut,
+  I as isZoomOutShortcut,
+  B as jfrefreshgrid,
+  G as loadLocale,
+  T as removeActiveImage,
+  w as showImgChooser,
+  V as toolbarItemClickHandler,
+  k as updateFormat,
+  M as useXLSXImport
 };

package/dist/sheet-engine/core/api/cell.d.ts

@@ -6,6 +6,27 @@ export declare function getCellValue(ctx: Context, row: number, column: number,
     type?: keyof Cell;
 }): any;
 export declare function setCellValue(ctx: Context, row: number, column: number, value: any, cellInput: HTMLDivElement | null, options?: CommonOptions, callAfterUpdate?: boolean): void;
+/**
+ * Apply a cell value coming from a remote RTC peer, verbatim.
+ *
+ * This differs from `setCellValue` in two important ways and must be used for
+ * every Yjs-driven remote apply:
+ *
+ * 1. It NEVER runs the formula engine and NEVER fires the local-edit hooks
+ *    (`onLocalCellEdit` / `afterUpdateCell`). The peer already computed the
+ *    value, so we use the synced `v`/`m`/`f` as-is. This avoids both
+ *    recomputation divergence and an update loop back into Yjs.
+ *
+ * 2. It PRESERVES the formula calc list. The regular `setCellValue` object
+ *    branch calls `delFunctionGroup`, which removes the cell from `calcChain`
+ *    and strips its dependency edges. Because `execFunctionGroup` walks
+ *    `calcChain` to decide what to recompute, dropping a formula cell there
+ *    permanently breaks its reactivity on that client (even after RTC stops).
+ *    Here we instead keep formula cells registered via
+ *    `insertUpdateFunctionGroup`, so they stay reactive to future local edits
+ *    on both owner and peer.
+ */
+export declare function applyRemoteCellValue(ctx: Context, row: number, column: number, value: any, options?: CommonOptions): void;
 export declare function clearCell(ctx: Context, row: number, column: number, options?: CommonOptions): void;
 export declare function setCellFormat(ctx: Context, row: number, column: number, attr: keyof Cell, value: any, options?: CommonOptions): void;
 export declare function autoFillCell(ctx: Context, copyRange: SingleRange, applyRange: SingleRange, direction: 'up' | 'down' | 'left' | 'right'): void;

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

@@ -1,4 +1,5 @@
 export { handleCopy } from './copy';
 export { handleGlobalKeyDown } from './keyboard';
+export { describeMatchedShortcut, isOpenShortcutsModalShortcut, isFormulaListShortcut, isZoomInShortcut, isZoomOutShortcut, } from './keyboard-shortcut-utils';
 export { fixPositionOnFrozenCells, handleCellAreaMouseDown, handleCellAreaDoubleClick, handleContextMenu, mouseRender, handleOverlayMouseMove, handleOverlayMouseUp, handleRowHeaderMouseDown, handleColumnHeaderMouseDown, handleColSizeHandleMouseDown, handleColSizeHandleDoubleClick, handleRowSizeHandleMouseDown, handleColFreezeHandleMouseDown, handleRowFreezeHandleMouseDown, } from './mouse';
 export { handlePaste, handlePasteByClick } from './paste';

package/dist/sheet-engine/core/events/keyboard-shortcut-utils.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Google Sheets–style keyboard matchers.
+ * - Letters / digits / F-keys: physical `code`
+ * - Punctuation (docs show characters): `code` + `key` + modifiers
+ */
+export declare function hasMod(e: KeyboardEvent): boolean;
+/**
+ * Insert date — Cmd/Ctrl+; (Google Sheets).
+ * Match on typed `;` character (AZERTY often uses Shift+, → code Comma).
+ * US QWERTY: physical Semicolon key without shift.
+ */
+export declare function isInsertDateShortcut(e: KeyboardEvent): boolean;
+/**
+ * Insert time — Cmd/Ctrl+Shift+; (Google Sheets).
+ * US QWERTY: Shift+; → key ":" code Semicolon.
+ * AZERTY (runtime): Cmd+Shift+; → code Comma with key "." or ","; Cmd+Shift+. → code Period with key "/" or ".".
+ */
+export declare function isInsertTimeShortcut(e: KeyboardEvent): boolean;
+/** Google Mac: ⌘+Option+Shift+; — insert date and time (AZERTY-safe). */
+export declare function isInsertDateTimeShortcut(e: KeyboardEvent): boolean;
+/**
+ * US / EU: Cmd/Ctrl+Shift+" — insert date and time.
+ * Mac AZERTY: `"` is Shift+3, but ⌘+Shift+3 is macOS screenshot (never reaches the page).
+ * Use ⌘+Option+Shift+3/; or Ctrl+Shift+3 instead (Google Mac alternates).
+ */
+export declare function isUsInsertDateTimeQuoteShortcut(e: KeyboardEvent): boolean;
+export declare function isPlainTextFormatShortcut(e: KeyboardEvent): boolean;
+/**
+ * Strikethrough — Google Sheets:
+ * Mac: Cmd+Shift+X, Ctrl+Option+Shift+5
+ * Win: Alt+Shift+5, Ctrl+Shift+X
+ */
+export declare function isStrikethroughShortcut(e: KeyboardEvent): boolean;
+/** Google / dSheets: Cmd+Option+M (Mac), Ctrl+Alt+M (Win). AZERTY M-key slot. */
+export declare function isInsertCommentShortcut(e: KeyboardEvent): boolean;
+/** Google Sheets: Cmd/Ctrl+A — select all. AZERTY types "a" on physical KeyQ. */
+export declare function isSelectAllShortcut(e: KeyboardEvent): boolean;
+/**
+ * Number formats — Google Mac: Ctrl+Shift+1–6; also Cmd/Ctrl+Shift+1–6.
+ */
+export declare function isNumberFormatModifier(e: KeyboardEvent): boolean;
+export declare function isDigitFormatKey(e: KeyboardEvent, digit: string): boolean;
+/**
+ * Formula list — Ctrl/Cmd+) (Google Sheets).
+ * US: Shift+0 → ")"; AZERTY: Shift+5 → ")" (code Digit5, often Equal-adjacent noise).
+ */
+export declare function isFormulaListShortcut(e: KeyboardEvent): boolean;
+export declare function isFindShortcut(e: KeyboardEvent): boolean;
+export declare function isFindReplaceShortcut(e: KeyboardEvent): boolean;
+export declare function isZoomInShortcut(e: KeyboardEvent): boolean;
+export declare function isZoomOutShortcut(e: KeyboardEvent): boolean;
+/**
+ * Open shortcuts modal — Ctrl/Cmd+/ (Google Sheets).
+ * AZERTY Mac: `/` is Shift+7; must not overlap zoom (+/=) or formula list `)`.
+ */
+export declare function isOpenShortcutsModalShortcut(e: KeyboardEvent): boolean;
+/** Label which engine shortcut would match (best-effort; for host debug tooling). */
+export declare function describeMatchedShortcut(e: KeyboardEvent): string | null;

package/dist/sheet-engine/core/events/shortcuts-v2.d.ts

@@ -0,0 +1,7 @@
+import { Context } from '../context';
+import { GlobalCache } from '../types';
+
+/**
+ * TEC-2311 shortcuts v2 — returns true when the event was handled.
+ */
+export declare function handleShortcutsV2(ctx: Context, cellInput: HTMLDivElement, e: KeyboardEvent, cache: GlobalCache, canvas?: CanvasRenderingContext2D): boolean;

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

@@ -5,9 +5,9 @@ export { defaultContext, getFlowdata, ensureSheetIndex, initSheetIndex, updateCo
 export type { Context } from './context';
 export { defaultSettings } from './settings';
 export type { Settings, Hooks, DateBaseLocale } from './settings';
-export { handleCopy, handleGlobalKeyDown, handlePaste, handlePasteByClick, fixPositionOnFrozenCells, handleCellAreaMouseDown, handleCellAreaDoubleClick, handleContextMenu, mouseRender, handleOverlayMouseMove, handleOverlayMouseUp, handleRowHeaderMouseDown, handleColumnHeaderMouseDown, handleColSizeHandleMouseDown, handleColSizeHandleDoubleClick, handleRowSizeHandleMouseDown, handleColFreezeHandleMouseDown, handleRowFreezeHandleMouseDown, } from './events';
+export { handleCopy, handleGlobalKeyDown, handlePaste, handlePasteByClick, fixPositionOnFrozenCells, handleCellAreaMouseDown, handleCellAreaDoubleClick, handleContextMenu, mouseRender, handleOverlayMouseMove, handleOverlayMouseUp, handleRowHeaderMouseDown, handleColumnHeaderMouseDown, handleColSizeHandleMouseDown, handleColSizeHandleDoubleClick, handleRowSizeHandleMouseDown, handleColFreezeHandleMouseDown, handleRowFreezeHandleMouseDown, describeMatchedShortcut, isOpenShortcutsModalShortcut, isFormulaListShortcut, isZoomInShortcut, isZoomOutShortcut, } 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, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, buildFiatCurrencyFormat, quoteSsfLiteral, FormulaCache, groupValuesRefresh, execFunctionGroup, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, 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, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, isHyperlinkCreationBlocked, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, removeOverShowComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, 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, 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, handleKeydownForZoom, 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, checkCF, getComputeMap, 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, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, buildFiatCurrencyFormat, quoteSsfLiteral, FormulaCache, groupValuesRefresh, execFunctionGroup, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, 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, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, isHyperlinkCreationBlocked, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, removeOverShowComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, 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, handleKeydownForZoom, 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, checkCF, getComputeMap, cancelPaintModel, hideCRCount, getdatabyselection, } from './modules';
 export type { FilterDate, FilterValue, FilterColor } from './modules';
 export { getFreezeState, 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/filter.d.ts

@@ -46,3 +46,16 @@ export declare function getFilterColumnColors(ctx: Context, col: number, startRo
     fcColors: FilterColor[];
 };
 export declare function saveFilter(ctx: Context, optionState: boolean, hiddenRows: Record<string, number>, caljs: any, st_r: number, ed_r: number, cindex: number, st_c: number, ed_c: number): void;
+type SheetFilterState = {
+    filter?: Record<string, any> | null;
+    filter_select?: {
+        row: number[];
+        column: number[];
+    } | null;
+};
+/**
+ * Apply filter state from Yjs on a remote RTC peer without a Workbook remount.
+ * Bypasses isAllowEdit — caller must only invoke for remote-origin updates.
+ */
+export declare function applySheetFilterState(ctx: Context, sheetId: string, state: SheetFilterState): void;
+export {};

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

@@ -22,7 +22,7 @@ export { sortSelection, sortSheetBySelectedColumn, spillSortResult, } from './so
 export { searchAll, searchNext, replace, replaceAll, replaceAllScoped, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, } from './searchReplace';
 export type { CheckModes, HyperlinkMap, FindSearchScope, ReplaceScope, SearchHiddenConfig, SearchNextResult, ReplaceAllResult, } from './searchReplace';
 export { getCellRowColumn, getCellHyperlink, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, saveHyperlink, removeHyperlink, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, showLinkCard, goToLink, isLinkValid, } from './hyperlink';
-export { createFilterOptions, clearFilter, clearFilterForColumn, toggleViewerFilter, createFilter, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, } from './filter';
+export { createFilterOptions, clearFilter, clearFilterForColumn, toggleViewerFilter, createFilter, applySheetFilterState, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, } from './filter';
 export type { FilterDate, FilterValue, FilterColor } from './filter';
 export { onCellsMoveStart, onCellsMove, onCellsMoveEnd } from './moveCells';
 export { cfSplitRange } from './conditionalFormat';

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

@@ -70,6 +70,7 @@ export declare function fillDownData(ctx: Context): string;
 export declare function textFormat(ctx: Context, type: 'left' | 'center' | 'right'): string;
 export declare function fillDate(ctx: Context): string;
 export declare function fillTime(ctx: Context): string;
+export declare function fillDateTime(ctx: Context): string;
 export declare function selectIsOverlap(ctx: Context, range?: any): boolean;
 export declare function selectAll(ctx: Context): void;
 export declare function fixRowStyleOverflowInFreeze(ctx: Context, r1: number, r2: number, freeze: Freezen | undefined): {
@@ -90,4 +91,11 @@ export declare function calcSelectionInfo(ctx: Context): {
     min: number;
     average: string;
 };
+/** Move the active selection focus to an absolute row/column (Home/End navigation). */
+export declare function jumpHighlightCell(ctx: Context, targetRow: number, targetCol: number): void;
+/**
+ * Fill every cell in the current selection with the active/focus cell value
+ * (Ctrl/Cmd+Enter — same value across the whole selection).
+ */
+export declare function fillSelectionWithActiveValue(ctx: Context, cellInput: HTMLDivElement, canvas?: CanvasRenderingContext2D): boolean;
 export {};

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

@@ -1,3 +1,4 @@
 export declare const MAX_ZOOM_RATIO = 4;
 export declare const MIN_ZOOM_RATIO = 0.1;
 export declare function handleKeydownForZoom(ev: KeyboardEvent, currentZoom: number): number;
+export declare function applyZoomStep(currentZoom: number, direction: 'in' | 'out' | 'reset'): number;

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

@@ -25,6 +25,8 @@ export type Hooks = {
     updateCellYdoc?: (changes: SheetChangePath[]) => void;
     updateAllCell?: (sheetId: string) => void;
     beforeUpdateCell?: (r: number, c: number, value: any) => boolean;
+    /** Clears RTC remote-apply lock so local edits can run data-block formulas. */
+    onLocalCellEdit?: () => void;
     afterUpdateCell?: (row: number, column: number, oldValue: any, newValue: any) => void;
     afterSelectionChange?: (sheetId: string, selection: Selection) => void;
     beforeRenderRowHeaderCell?: (rowNumber: string, rowIndex: number, top: number, width: number, height: number, ctx: CanvasRenderingContext2D) => boolean;
@@ -131,6 +133,7 @@ export type Settings = {
     onSheetCountChange?: (count: number) => void;
     isAuthorized?: boolean;
     isFlvReadOnly?: boolean;
+    isRTCActive?: boolean;
     dateBaseLocale?: DateBaseLocale;
     /** When true, do not auto-select A1 on load (e.g. onboarding modal runs first). */
     suppressInitialCellSelection?: boolean;

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

@@ -112,6 +112,7 @@ export type Presence = {
     username: string;
     userId?: string;
     color: string;
+    isEns?: boolean;
     selection: {
         r: number;
         c: number;

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

@@ -19,6 +19,17 @@ export declare function generateAPIs(context: Context, setContext: (recipe: (ctx
     setCellValue: (row: number, column: number, value: any, options?: api.CommonOptions & {
         type?: keyof Cell;
     }, callAfterUpdate?: boolean) => void;
+    /**
+     * Apply a cell value coming from a remote RTC peer, verbatim.
+     *
+     * Use this (instead of `setCellValue`) for every Yjs-driven remote apply:
+     * it writes the synced value/formula as-is without running the formula
+     * engine and without firing local-edit hooks, while keeping formula cells
+     * registered in `calcChain` so they remain reactive to future local edits.
+     */
+    applyRemoteCellValue: (row: number, column: number, value: any, options?: api.CommonOptions & {
+        type?: keyof Cell;
+    }) => void;
     setCellError: (row: number, column: number, errorMessage: {
         title: string;
         message: string;
@@ -126,6 +137,18 @@ export declare function generateAPIs(context: Context, setContext: (recipe: (ctx
     activateSheet: (options?: api.CommonOptions) => void;
     setSheetName: (name: string, options?: api.CommonOptions) => void;
     setSheetOrder: (orderList: Record<string, number>) => void;
+    setSheetImages: (images: any[], options?: api.CommonOptions) => void;
+    setSheetIframes: (iframes: any[], options?: api.CommonOptions) => void;
+    setSheetDataVerification: (dataVerification: Record<string, any>, options?: api.CommonOptions) => void;
+    setSheetFilterState: (state: {
+        filter?: Record<string, any> | null;
+        filter_select?: {
+            row: number[];
+            column: number[];
+        } | null;
+    }, options?: api.CommonOptions) => void;
+    setSheetMapField: (field: string, value: Record<string, any> | null | undefined, options?: api.CommonOptions) => void;
+    setSheetConditionFormatRules: (rules: any[], options?: api.CommonOptions) => void;
     scroll: (options: {
         scrollLeft?: number;
         scrollTop?: number;

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

@@ -23,6 +23,9 @@ declare const Workbook: React.ForwardRefExoticComponent<Settings & AdditionalPro
     setCellValue: (row: number, column: number, value: any, options?: api.CommonOptions & {
         type?: keyof import('../../../core').Cell;
     }, callAfterUpdate?: boolean) => void;
+    applyRemoteCellValue: (row: number, column: number, value: any, options?: api.CommonOptions & {
+        type?: keyof import('../../../core').Cell;
+    }) => void;
     setCellError: (row: number, column: number, errorMessage: {
         title: string;
         message: string;
@@ -130,6 +133,18 @@ declare const Workbook: React.ForwardRefExoticComponent<Settings & AdditionalPro
     activateSheet: (options?: api.CommonOptions) => void;
     setSheetName: (name: string, options?: api.CommonOptions) => void;
     setSheetOrder: (orderList: Record<string, number>) => void;
+    setSheetImages: (images: any[], options?: api.CommonOptions) => void;
+    setSheetIframes: (iframes: any[], options?: api.CommonOptions) => void;
+    setSheetDataVerification: (dataVerification: Record<string, any>, options?: api.CommonOptions) => void;
+    setSheetFilterState: (state: {
+        filter?: Record<string, any> | null;
+        filter_select?: {
+            row: number[];
+            column: number[];
+        } | null;
+    }, options?: api.CommonOptions) => void;
+    setSheetMapField: (field: string, value: Record<string, any> | null | undefined, options?: api.CommonOptions) => void;
+    setSheetConditionFormatRules: (rules: any[], options?: api.CommonOptions) => void;
     scroll: (options: {
         scrollLeft?: number;
         scrollTop?: number;