@fileverse-dev/dsheet 4.0.5 → 4.1.0-cmt-1

package/dist/index.d.ts

@@ -6,8 +6,9 @@ export { FLVURL } from '@fileverse-dev/formulajs';
 export { loadLocale } from './sheet-engine/core';
 export type { ErrorMessageHandlerReturnType, DataBlockEvent, DataBlockEventType, ApiKeyStorage } from './editor/types';
 export type { PanelConfig, PanelId, BuiltInPanelType } from './editor/types';
-export type { CommentThread, CommentReply, CommentActionParams, CommentsConfig, } from './editor/types/comments';
+export type { CommentThread, CommentReply, CommentActionParams, CommentsConfig, CommentAnchorMove, } from './editor/types/comments';
 export { CommentAction } from './editor/types/comments';
+export { remapCommentAnchors } from './editor/utils/remap-comment-anchors';
 export { CommentsContent } from './editor/components/comments/comment-sidebar';
 export { CommentCellUI } from './editor/components/comments/comment-cell-popup';
 export { useEnsStatus } from './editor/components/comments/ens/use-ens-status';

package/dist/index.es.js

@@ -1,59 +1,60 @@
-import { C as s, d as t, f as o, S as r, g as l, h as d, j as n, T as i, k as S, l as c, n as h, o as m, p, q as C, t as u, u as E, v as F, w as g, x, z as R, A as I, B as f, D as w, E as A, F as L, G as T, H as v, I as D, J as M } from "./index-BqGOKo9u.js";
-import { cw as k, cx as V, cy as y, cE as z, bq as G, e as P, f as U, l as X, a as _, dg as j, dh as B, b9 as H, di as O, dj as q, dn as J, dp as K, dr as N, I as Y, dG as Z, ed as Q, b2 as W } from "./executeStringFunction-B6fhDKyN.js";
-import { FLVURL as ee } from "@fileverse-dev/formulajs";
-import { E as se, S as te } from "./constants-CRFfbkoQ.js";
+import { C as s, d as t, f as o, S as r, g as l, h as n, j as d, T as i, k as c, l as S, n as m, o as h, p, q as C, t as u, u as E, v as F, w as g, x, z as A, A as I, B as R, D as f, E as L, F as w, G as T, H as v, I as b, J as k, K as D } from "./index-CsYiH7pp.js";
+import { cy as z, cz as V, cA as y, cG as G, bs as P, e as U, f as X, l as _, a as j, di as B, dj as H, bb as O, dk as q, dl as J, dq as K, dr as N, dt as Y, I as Z, dI as Q, ef as W, b4 as $ } from "./executeStringFunction-BJ00H04h.js";
+import { FLVURL as ae } from "@fileverse-dev/formulajs";
+import { E as te, S as oe } from "./constants-CRFfbkoQ.js";
 export {
   s as CommentAction,
   t as CommentCellUI,
   o as CommentsContent,
   r as DSheetEditor,
   l as DSheetSkeleton,
-  se as ERROR_MESSAGES_FLAG,
-  ee as FLVURL,
-  d as FortuneCore,
-  te as SERVICES_API_KEY,
-  n as SupportedChain,
+  te as ERROR_MESSAGES_FLAG,
+  ae as FLVURL,
+  n as FortuneCore,
+  oe as SERVICES_API_KEY,
+  d as SupportedChain,
   i as TEMPLATES,
-  S as api,
-  k as clearColumnsCellsFormat,
-  c as clearFilter,
+  c as api,
+  z as clearColumnsCellsFormat,
+  S as clearFilter,
   V as clearRowsCellsFormat,
   y as clearSelectedCellFormat,
-  h as createFilter,
-  z as deleteRowCol,
-  G as deleteSelectedCellText,
-  m as describeMatchedShortcut,
-  P as executeStringFunction,
-  U as formulaResponseUiSync,
-  X as getFlowdata,
+  m as createFilter,
+  G as deleteRowCol,
+  P as deleteSelectedCellText,
+  h as describeMatchedShortcut,
+  U as executeStringFunction,
+  X as formulaResponseUiSync,
+  _ as getFlowdata,
   p as getRemoveDuplicatesErrorMessage,
   C as getRemoveDuplicatesPreview,
-  _ as getSheetIndex,
+  j as getSheetIndex,
   u as handleCSVUpload,
   E as handleCopy,
   F as handleExportToCSV,
   g as handleExportToJSON,
   x as handleExportToXLSX,
-  j as handleFreeze,
-  B as handleHorizontalAlign,
-  H as handleLink,
-  O as handleMerge,
-  R as handlePasteByClick,
-  q as handleSort,
-  J as handleTextSize,
-  K as handleVerticalAlign,
+  B as handleFreeze,
+  H as handleHorizontalAlign,
+  O as handleLink,
+  q as handleMerge,
+  A as handlePasteByClick,
+  J as handleSort,
+  K as handleTextSize,
+  N as handleVerticalAlign,
   I as importSpreadsheetFile,
-  N as insertRowCol,
-  f as isBrowserZoomShortcut,
-  w as isFormulaListShortcut,
-  A as isOpenShortcutsModalShortcut,
-  Y as jfrefreshgrid,
-  Z as loadLocale,
-  L as removeActiveImage,
-  T as removeDuplicates,
-  v as showImgChooser,
-  Q as toolbarItemClickHandler,
-  W as updateFormat,
-  D as useEnsStatus,
-  M as useXLSXImport
+  Y as insertRowCol,
+  R as isBrowserZoomShortcut,
+  f as isFormulaListShortcut,
+  L as isOpenShortcutsModalShortcut,
+  Z as jfrefreshgrid,
+  Q as loadLocale,
+  w as remapCommentAnchors,
+  T as removeActiveImage,
+  v as removeDuplicates,
+  b as showImgChooser,
+  W as toolbarItemClickHandler,
+  $ as updateFormat,
+  k as useEnsStatus,
+  D as useXLSXImport
 };

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

@@ -4,7 +4,7 @@ export { Canvas, defaultStyle } from './canvas';
 export { defaultContext, getFlowdata, ensureSheetIndex, initSheetIndex, updateContextWithSheetData, updateContextWithCanvas, } from './context';
 export type { Context } from './context';
 export { defaultSettings } from './settings';
-export type { Settings, Hooks, DateBaseLocale } 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, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, buildFiatCurrencyFormat, quoteSsfLiteral, FormulaCache, groupValuesRefresh, execFunctionGroup, runFormulaEvalChunk, applyWorkerFormulaChunkResults, isFormulaEvalPending, FORMULA_ASYNC_CHUNK_SIZE, FORMULA_ASYNC_EVAL_THRESHOLD, FORMULA_WORKER_CHUNK_SIZE, FORMULA_WORKER_THRESHOLD, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, ensureFormulaRangeToSheet, shouldPreserveFormulaEditOnSheetSwitch, activateSheetForNavigation, returnToFormulaOriginSheet, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, getFilterHiddenRowsUnionFromFilterMap, getFilterHiddenRowsUnion, ensureManualHiddenInitialized, rebuildRowHiddenUnion, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, defaultLuckysheetSelectRanges, normalizeSelection, syncPrimaryCellActiveFromSelection, selectionIsExactlyOneMergeBlock, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, snapSheetSelectionFocusToCellPreserveMultiRange, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, addSheet, deleteSheet, editSheetName, changeSheet, updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, mergeSelectionHasValues, handleSort, getRemoveDuplicatesPreview, removeDuplicates, getRemoveDuplicatesErrorMessage, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, isHyperlinkCreationBlocked, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, removeOverShowComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, copyActiveImage, cutActiveImage, pasteImageItem, loadImageFromFile, getImageClipboard, getImageCutSourceId, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, createDropCellRange, sortSelection, sortSheetBySelectedColumn, searchAll, searchNext, replace, replaceAll, replaceAllScoped, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, createFilterOptions, clearFilter, clearFilterForColumn, toggleViewerFilter, createFilter, applySheetFilterState, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, onCellsMoveStart, cfSplitRange, updateMoreCell, getRegStr, getDataArr, applyLocation, getOptionValue, getSelectRange, getDropdownList, setDropdownValue, confirmMessage, setConditionRules, CF_DATE_DEFAULT_FORMAT, parseCfDateConditionForUi, formatCfDatePresetSnapshot, parseDdMmYyyyToSerial, handleOverlayTouchStart, handleOverlayTouchEnd, MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, jfrefreshgrid, sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, setCellError, clearCellError, detectDateFormat, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, iscelldata, getcellrange, cancelFunctionrangeSelected, seletedHighlistByindex, spillSortResult, execfunction, insertUpdateFunctionGroup, remapFormulaReferencesByMap, refreshFormulasUsingDefinedNames, checkCF, getComputeMap, isValidDefinedNameIdentifier, getDefinedNameDisplayRange, findDefinedNameForSelection, findDefinedNameByName, resolveDefinedNameForFormula, addDefinedName, updateDefinedName, deleteDefinedName, selectDefinedName, openNamedRangesSidebar, scheduleDefinedNamesSync, shiftDefinedNamesOnInsert, shiftDefinedNamesOnDelete, removeDefinedNamesForSheet, cancelPaintModel, hideCRCount, getdatabyselection, } from './modules';

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

@@ -62,9 +62,13 @@ export declare function buildFiatCurrencyFormat(symbol: string, decimals?: numbe
 export declare function update(fmt: string, v: any): string;
 /** Max decimal places for toolbar +/- on General (Auto) without switching to a numeric `fa`. */
 export declare const MAX_GENERAL_AUTO_DP = 15;
+/** Count decimal places currently shown for a General/Auto numeric cell. */
+export declare function countGeneralDisplayDecimalPlaces(cell: Cell): number;
+/** Effective decimal places for toolbar +/- (explicit `ct.dp` or inferred from display). */
+export declare function getEffectiveGeneralDp(cell: Cell): number;
 /**
  * Recompute `m` for numeric cells with `fa === "General"`.
- * When `ct.dp` is set (1..MAX), uses fixed decimals like Sheets Auto + decimal buttons.
+ * When `ct.dp` is set (0..MAX), uses fixed decimals like Sheets Auto + decimal buttons.
  * Otherwise uses the usual `genarate` General display.
  */
 export declare function refreshGeneralNumericDisplay(cell: Cell): void;

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

@@ -94,6 +94,46 @@ export type Hooks = {
     afterShowGridLinesChange?: () => void;
     afterNameChanges?: () => void;
     afterStatusChanges?: () => void;
+    /**
+     * Fired after row/column drag-drop, cell-range move, or insert/delete
+     * so host apps can remap comment keys (`${sheetId}_${row}_${col}`).
+     */
+    afterCommentAnchorMove?: (move: CommentAnchorMove) => void;
+};
+export type CommentAnchorMove = {
+    type: 'row' | 'column';
+    sheetId: string;
+    /** Prefixes that identify this sheet in comment keys (id, order, index). */
+    sheetKeys?: string[];
+    /** old index → new index for every row/col on the sheet */
+    indexMap: Record<number, number>;
+} | {
+    type: 'cells';
+    sheetId: string;
+    sheetKeys?: string[];
+    source: {
+        row: [number, number];
+        column: [number, number];
+    };
+    target: {
+        row: [number, number];
+        column: [number, number];
+    };
+} | {
+    type: 'insert';
+    axis: 'row' | 'column';
+    sheetId: string;
+    sheetKeys?: string[];
+    index: number;
+    count: number;
+    direction: 'lefttop' | 'rightbottom';
+} | {
+    type: 'delete';
+    axis: 'row' | 'column';
+    sheetId: string;
+    sheetKeys?: string[];
+    start: number;
+    end: number;
 };
 type CommentUIDragFn = (e: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
 export type Settings = {

package/dist/sheet-engine/core/utils/comment-anchor-move.d.ts

@@ -0,0 +1,17 @@
+import { CommentAnchorMove } from '../settings';
+
+/**
+ * Build oldIndex → newIndex for a contiguous block move (row or column drag).
+ * `targetIndex` is the insertion index *after* the block has been removed,
+ * matching the splice used on the sheet data.
+ */
+export declare function buildBlockMoveIndexMap(length: number, sourceStart: number, moveCount: number, targetIndex: number): Record<number, number>;
+export declare function getSheetCommentKeyPrefixes(sheet: {
+    id?: string;
+    order?: number;
+} | null | undefined, sheetIndex: number): string[];
+export declare function notifyCommentAnchorMove(ctx: {
+    hooks?: {
+        afterCommentAnchorMove?: (move: CommentAnchorMove) => void;
+    };
+}, move: CommentAnchorMove): void;