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

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, isBrowserZoomShortcut, isFormulaListShortcut, isOpenShortcutsModalShortcut, } from './sheet-engine/core';
 export type { PatchOptions } from './sheet-engine/core';

package/dist/index.es.js

@@ -1,45 +1,50 @@
-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 i, g as c, j as m, k as C, l as p, n as E, o as F, p as x, q as g, r as f, s as R, t as u, u as L, v as T, w as b } from "./index-DXRs6xeV.js";
-import { bO as I, bP as w, bQ as V, bU as k, be as P, e as U, f as X, h as _, a as v, ce as y, aq as z, cl as M } from "./executeStringFunction-6r6Tl4Z6.js";
-import { FLVURL as j } from "@fileverse-dev/formulajs";
-import { E as G, S as H } 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 C, n as p, o as u, 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 T, A as w, B as I, C as V, D as k } from "./index-D_IxoHMJ.js";
+import { bP as z, bQ as P, bR as X, bV as _, bg as v, e as y, f as B, h as D, a as O, cf as U, aq as j, cm as q } from "./executeStringFunction-tdvZ0KTi.js";
+import { FLVURL as H } from "@fileverse-dev/formulajs";
+import { E as K, S as N } from "./constants-yStXQJiK.js";
 export {
   s as DSheetEditor,
-  G as ERROR_MESSAGES_FLAG,
-  j as FLVURL,
-  l as FortuneCore,
-  H as SERVICES_API_KEY,
-  o as TEMPLATES,
+  o as DSheetSkeleton,
+  K as ERROR_MESSAGES_FLAG,
+  H as FLVURL,
+  t as FortuneCore,
+  N as SERVICES_API_KEY,
+  l as TEMPLATES,
   r as api,
-  I as clearColumnsCellsFormat,
-  t as clearFilter,
-  w as clearRowsCellsFormat,
-  V as clearSelectedCellFormat,
-  n as createFilter,
-  k as deleteRowCol,
-  P as deleteSelectedCellText,
-  U as executeStringFunction,
-  X as formulaResponseUiSync,
-  _ as getFlowdata,
-  v as getSheetIndex,
-  d as handleCSVUpload,
-  S as handleCopy,
-  h as handleExportToCSV,
-  i as handleExportToJSON,
-  c as handleExportToXLSX,
-  m as handleFreeze,
-  C as handleHorizontalAlign,
-  p as handleLink,
-  E as handleMerge,
-  F as handlePasteByClick,
-  x as handleSort,
-  g as handleTextSize,
-  f as handleVerticalAlign,
-  y as insertRowCol,
-  z as jfrefreshgrid,
-  M as loadLocale,
-  R as removeActiveImage,
-  u as showImgChooser,
-  L as toolbarItemClickHandler,
-  T as updateFormat,
-  b as useXLSXImport
+  z 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,
+  B as formulaResponseUiSync,
+  D as getFlowdata,
+  O as getSheetIndex,
+  h as handleCSVUpload,
+  c as handleCopy,
+  i as handleExportToCSV,
+  m as handleExportToJSON,
+  C as handleExportToXLSX,
+  p as handleFreeze,
+  u as handleHorizontalAlign,
+  E as handleLink,
+  F as handleMerge,
+  x as handlePasteByClick,
+  g as handleSort,
+  f as handleTextSize,
+  R as handleVerticalAlign,
+  U as insertRowCol,
+  L as isBrowserZoomShortcut,
+  b as isFormulaListShortcut,
+  A as isOpenShortcutsModalShortcut,
+  j as jfrefreshgrid,
+  q as loadLocale,
+  T as removeActiveImage,
+  w as showImgChooser,
+  I as toolbarItemClickHandler,
+  V as updateFormat,
+  k 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, isBrowserZoomShortcut, isOpenShortcutsModalShortcut, isFormulaListShortcut, } 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,61 @@
+/**
+ * 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+Shift+) (Google Sheets).
+ * US: Shift+0 → ")"; AZERTY: Shift+5 → ")".
+ */
+export declare function isFormulaListShortcut(e: KeyboardEvent): boolean;
+export declare function isFindShortcut(e: KeyboardEvent): boolean;
+export declare function isFindReplaceShortcut(e: KeyboardEvent): boolean;
+/**
+ * Browser page zoom (Cmd/Ctrl + +/−). Never intercept — sheet has no keyboard zoom.
+ * Match by physical `code` and by AZERTY-remapped `key` values.
+ */
+export declare function isBrowserZoomShortcut(e: KeyboardEvent): boolean;
+/**
+ * Open shortcuts modal.
+ * Win: Ctrl+/. Mac/AZERTY: Option+/ or Option+: (WY). US fallback: Cmd+/.
+ */
+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/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, 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, 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, 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';
@@ -32,7 +32,7 @@ export { applyLocation, getOptionValue, getSelectRange, } from './locationCondit
 export { getDropdownList, setDropdownValue, confirmMessage, cellFocus, validateCellData, } from './dataVerification';
 export { setConditionRules, CF_DATE_DEFAULT_FORMAT, parseCfDateConditionForUi, formatCfDatePresetSnapshot, parseDdMmYyyyToSerial, } from './ConditionFormat';
 export { handleOverlayTouchStart, handleOverlayTouchEnd } from './mobile';
-export { MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, handleKeydownForZoom } from './zoom';
+export { MAX_ZOOM_RATIO, MIN_ZOOM_RATIO } from './zoom';
 export { jfrefreshgrid } from './refresh';
 export { sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, } from './iframe';
 export { setCellError, clearCellError, overShowError, } from './error-state-helpers';

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): {

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

@@ -1,3 +1,2 @@
 export declare const MAX_ZOOM_RATIO = 4;
 export declare const MIN_ZOOM_RATIO = 0.1;
-export declare function handleKeydownForZoom(ev: KeyboardEvent, currentZoom: number): 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;