@fileverse-dev/dsheet 4.1.12 → 4.1.13-b

package/dist/index.es.js

@@ -1,5 +1,5 @@
-import { C as s, d as o, f as t, S as r, g as l, h as n, j as d, T as S, k as c, l as i, n as m, o as h, p, q as C, t as u, u as E, v as F, w as g, x, z as R, A as f, B as A, D as I, E as L, F as T, G as w, H as y, I as v, J as D, K as M, L as b, M as k, N as z, O, P } from "./index-D0OdnFi2.js";
-import { cy as G, cz as K, cA as U, cG as X, bs as _, e as j, f as B, l as H, a as q, di as J, dj as N, bb as Y, dk as Z, dl as Q, dq as W, dr as $, dt as ee, I as ae, dI as se, ef as oe, b4 as te } from "./executeStringFunction-BaZeRysE.js";
+import { C as s, d as o, f as t, S as r, g as l, h as n, j as d, T as S, k as c, l as i, n as m, o as h, p, q as C, t as u, u as E, v as F, w as g, x, z as R, A, B as f, D as I, E as L, F as T, G as w, H as y, I as v, J as D, K as M, L as b, M as k, N as z, O, P } from "./index-7Fa_Mod8.js";
+import { cy as G, cz as K, cA as U, cG as X, bs as _, e as j, f as B, l as H, a as J, dj as N, dk as q, bb as Y, dl as Z, dm as Q, dr as W, ds as $, du as ee, I as ae, dJ as se, eg as oe, b4 as te } from "./executeStringFunction-D1IXrBP2.js";
 import { FLVURL as le } from "@fileverse-dev/formulajs";
 import { E as de, S as Se } from "./constants-8Ij49Lxv.js";
 export {
@@ -31,15 +31,15 @@ export {
   H as getFlowdata,
   E as getRemoveDuplicatesErrorMessage,
   F as getRemoveDuplicatesPreview,
-  q as getSheetIndex,
+  J as getSheetIndex,
   g as handleCSVUpload,
   x as handleCopy,
   R as handleExportToCSV,
-  f as handleExportToJSON,
-  A as handleExportToODS,
+  A as handleExportToJSON,
+  f as handleExportToODS,
   I as handleExportToXLSX,
-  J as handleFreeze,
-  N as handleHorizontalAlign,
+  N as handleFreeze,
+  q as handleHorizontalAlign,
   Y as handleLink,
   Z as handleMerge,
   L as handlePasteByClick,

package/dist/persistence-compaction-CIxc1USC.js

@@ -0,0 +1,123 @@
+import * as i from "yjs";
+const p = typeof Buffer == "function";
+typeof TextDecoder == "function" && new TextDecoder();
+typeof TextEncoder == "function" && new TextEncoder();
+const C = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=", l = Array.prototype.slice.call(C), u = ((t) => {
+  let e = {};
+  return t.forEach((r, o) => e[r] = o), e;
+})(l), x = /^(?:[A-Za-z\d+\/]{4})*?(?:[A-Za-z\d+\/]{2}(?:==)?|[A-Za-z\d+\/]{3}=?)?$/, d = String.fromCharCode.bind(String), b = typeof Uint8Array.from == "function" ? Uint8Array.from.bind(Uint8Array) : (t) => new Uint8Array(Array.prototype.slice.call(t, 0)), B = (t) => t.replace(/=/g, "").replace(/[+\/]/g, (e) => e == "+" ? "-" : "_"), E = (t) => t.replace(/[^A-Za-z0-9\+\/]/g, ""), P = (t) => {
+  let e, r, o, n, a = "";
+  const s = t.length % 3;
+  for (let c = 0; c < t.length; ) {
+    if ((r = t.charCodeAt(c++)) > 255 || (o = t.charCodeAt(c++)) > 255 || (n = t.charCodeAt(c++)) > 255)
+      throw new TypeError("invalid character found");
+    e = r << 16 | o << 8 | n, a += l[e >> 18 & 63] + l[e >> 12 & 63] + l[e >> 6 & 63] + l[e & 63];
+  }
+  return s ? a.slice(0, s - 3) + "===".substring(s) : a;
+}, v = typeof btoa == "function" ? (t) => btoa(t) : p ? (t) => Buffer.from(t, "binary").toString("base64") : P, A = p ? (t) => Buffer.from(t).toString("base64") : (t) => {
+  let r = [];
+  for (let o = 0, n = t.length; o < n; o += 4096)
+    r.push(d.apply(null, t.subarray(o, o + 4096)));
+  return v(r.join(""));
+}, S = (t, e = !1) => e ? B(A(t)) : A(t), R = (t) => {
+  if (t = t.replace(/\s+/g, ""), !x.test(t))
+    throw new TypeError("malformed base64.");
+  t += "==".slice(2 - (t.length & 3));
+  let e, r, o, n = [];
+  for (let a = 0; a < t.length; )
+    e = u[t.charAt(a++)] << 18 | u[t.charAt(a++)] << 12 | (r = u[t.charAt(a++)]) << 6 | (o = u[t.charAt(a++)]), r === 64 ? n.push(d(e >> 16 & 255)) : o === 64 ? n.push(d(e >> 16 & 255, e >> 8 & 255)) : n.push(d(e >> 16 & 255, e >> 8 & 255, e & 255));
+  return n.join("");
+}, k = typeof atob == "function" ? (t) => atob(E(t)) : p ? (t) => Buffer.from(t, "base64").toString("binary") : R, z = p ? (t) => b(Buffer.from(t, "base64")) : (t) => b(k(t).split("").map((e) => e.charCodeAt(0))), I = (t) => z(Z(t)), Z = (t) => E(t.replace(/[-_]/g, (e) => e == "-" ? "+" : "/")), q = 8e3, j = (t) => t instanceof Error ? t : new Error(String(t)), K = (t, e, r = "dsheet-package-ingress") => {
+  const o = I(e), n = new i.Doc();
+  try {
+    i.applyUpdate(n, o);
+  } finally {
+    n.destroy();
+  }
+  let a = !1;
+  const s = () => {
+    a = !0;
+  };
+  t.on("update", s);
+  try {
+    return i.applyUpdate(t, o, r), a;
+  } finally {
+    t.off("update", s);
+  }
+}, M = async (t, e) => {
+  let r;
+  try {
+    return await Promise.race([
+      t,
+      new Promise((o, n) => {
+        r = setTimeout(
+          () => n(new Error("dSheet IndexedDB operation timed out")),
+          e
+        );
+      })
+    ]);
+  } finally {
+    r && clearTimeout(r);
+  }
+}, w = (t, e, r) => ({
+  dsheetId: t,
+  status: e,
+  encodedState: null,
+  stateVector: null,
+  ...r ? { error: j(r) } : {}
+}), V = (t, e) => {
+  const r = i.encodeStateAsUpdate(e);
+  return {
+    dsheetId: t,
+    status: r.length <= 2 ? "empty" : "available",
+    encodedState: S(r),
+    stateVector: S(i.encodeStateVector(e))
+  };
+}, N = (t, e, r) => {
+  if (!r)
+    return w(
+      t,
+      "unavailable",
+      new Error("dSheet document is not ready")
+    );
+  try {
+    return K(r, e, "dsheet-package-ingress"), V(t, r);
+  } catch (o) {
+    return w(t, "corrupt", o);
+  }
+}, y = "updates", O = async (t, e = 2) => {
+  if (t._destroyed) return 0;
+  const r = await t._db;
+  if (!r.objectStoreNames.contains(y)) return 0;
+  const o = await new Promise((n, a) => {
+    const s = r.transaction(y, "readwrite"), c = s.objectStore(y);
+    let h = 0;
+    const m = c.getAllKeys();
+    m.onsuccess = () => {
+      const f = m.result;
+      if (f.length < e) return;
+      const g = c.getAll();
+      g.onsuccess = () => {
+        const U = g.result.filter(
+          (T) => T instanceof Uint8Array
+        ), _ = i.mergeUpdates([
+          ...U,
+          i.encodeStateAsUpdate(t.doc)
+        ]), D = f[f.length - 1];
+        c.delete(IDBKeyRange.upperBound(D)), c.add(_), h = f.length;
+      };
+    }, s.oncomplete = () => n(h), s.onerror = () => a(s.error), s.onabort = () => a(s.error ?? new Error("compaction aborted"));
+  });
+  return o > 0 && (t._dbsize = 1), o;
+};
+export {
+  q as D,
+  N as a,
+  O as c,
+  S as f,
+  K as m,
+  V as s,
+  I as t,
+  w as u,
+  M as w
+};

package/dist/persistence-compaction.d.ts

@@ -0,0 +1,15 @@
+import { IndexeddbPersistence } from 'y-indexeddb';
+
+/**
+ * y-indexeddb appends a FULL copy of the doc every time a provider is attached
+ * to a Y.Doc that already holds content, and only trims after 500 rows. dSheet
+ * attaches to pre-filled docs on every open (published content, remote merges),
+ * so the store grows by one full copy per open and every load replays them all.
+ *
+ * This collapses the store into a single row. It runs in ONE readwrite
+ * transaction and merges every stored row (not just this provider's doc), so
+ * rows written by another tab/provider in the meantime are never lost.
+ *
+ * Returns the number of rows removed (0 when nothing needed compacting).
+ */
+export declare const compactDsheetPersistence: (persistence: IndexeddbPersistence, minRows?: number) => Promise<number>;

package/dist/persistence.js

@@ -1,118 +1,124 @@
-import { t as D, f as h, D as b, u as p, w as S, s as w } from "./persistence-utils-BXFajzvq.js";
+import { t as D, f as g, D as b, u as p, w as S, c as v, s as w } from "./persistence-compaction-CIxc1USC.js";
 import * as u from "yjs";
-import { clearDocument as v, IndexeddbPersistence as E } from "y-indexeddb";
-const f = /* @__PURE__ */ new Map(), M = (e) => {
-  const o = new u.Doc();
+import { clearDocument as x, IndexeddbPersistence as E } from "y-indexeddb";
+const f = /* @__PURE__ */ new Map(), A = (e) => {
+  const a = new u.Doc();
   try {
     return u.applyUpdate(
-      o,
+      a,
       typeof e == "string" ? D(e) : e
-    ), h(u.encodeStateVector(o));
+    ), g(u.encodeStateVector(a));
   } finally {
-    o.destroy();
+    a.destroy();
   }
-}, x = (e, o) => new Promise((s) => {
-  const a = new u.Doc();
-  let r = null, t = null, i = !1, m = !1;
-  const y = (n) => {
-    i || (i = !0, clearTimeout(g), r == null || r.close(), a.destroy(), s(n));
-  }, c = (n, d) => y(p(e, n, d)), g = setTimeout(() => {
+}, B = (e, a) => new Promise((c) => {
+  const s = new u.Doc();
+  let r = null, t = null, o = !1, y = !1;
+  const m = (n) => {
+    o || (o = !0, clearTimeout(h), r == null || r.close(), s.destroy(), c(n));
+  }, i = (n, d) => m(p(e, n, d)), h = setTimeout(() => {
     try {
       t == null || t.abort();
     } catch {
     }
-    c("timed-out", new Error("dSheet IndexedDB read timed out"));
-  }, o);
+    i("timed-out", new Error("dSheet IndexedDB read timed out"));
+  }, a);
   let l;
   try {
     l = indexedDB.open(e);
   } catch (n) {
-    c("unavailable", n);
+    i("unavailable", n);
     return;
   }
   l.onupgradeneeded = () => {
     var n;
-    m = !0, (n = l.transaction) == null || n.abort();
+    y = !0, (n = l.transaction) == null || n.abort();
   }, l.onerror = () => {
-    m ? y(p(e, "missing")) : c("unavailable", l.error);
+    y ? m(p(e, "missing")) : i("unavailable", l.error);
   }, l.onsuccess = () => {
     if (r = l.result, !r.objectStoreNames.contains("updates") || !r.objectStoreNames.contains("custom")) {
-      c("corrupt", new Error("dSheet IndexedDB schema is invalid"));
+      i("corrupt", new Error("dSheet IndexedDB schema is invalid"));
       return;
     }
     try {
       t = r.transaction("updates", "readonly");
       const n = t.objectStore("updates").getAll();
-      n.onerror = () => c("unavailable", n.error), n.onsuccess = () => {
+      n.onerror = () => i("unavailable", n.error), n.onsuccess = () => {
         try {
           for (const d of n.result ?? []) {
             if (!(d instanceof Uint8Array))
               throw new Error("dSheet IndexedDB contains a non-Yjs update");
-            u.applyUpdate(a, d);
+            u.applyUpdate(s, d);
           }
         } catch (d) {
-          c("corrupt", d);
+          i("corrupt", d);
         }
-      }, t.oncomplete = () => y(w(e, a)), t.onabort = () => {
-        i || c("unavailable", t == null ? void 0 : t.error);
+      }, t.oncomplete = () => m(w(e, s)), t.onabort = () => {
+        o || i("unavailable", t == null ? void 0 : t.error);
       }, t.onerror = () => {
-        i || c("unavailable", t == null ? void 0 : t.error);
+        o || i("unavailable", t == null ? void 0 : t.error);
       };
     } catch (n) {
-      c("unavailable", n);
+      i("unavailable", n);
     }
   };
-}), B = async (e, o) => {
+}), T = async (e, a) => {
   if (typeof indexedDB > "u")
     return p(
       e,
       "unavailable",
       new Error("IndexedDB is unavailable")
     );
-  const s = indexedDB;
-  if (s.databases)
+  const c = indexedDB;
+  if (c.databases)
     try {
-      if (!(await s.databases()).some((r) => r.name === e))
+      if (!(await c.databases()).some((r) => r.name === e))
         return p(e, "missing");
     } catch {
     }
-  return x(e, o);
-}, A = (e, o = {}) => {
-  const s = f.get(e);
-  if (s) return s;
-  const a = B(
+  return B(e, a);
+}, C = (e, a = {}) => {
+  const c = f.get(e);
+  if (c) return c;
+  const s = T(
     e,
-    o.timeoutMs ?? b
+    a.timeoutMs ?? b
   ).finally(() => {
-    f.get(e) === a && f.delete(e);
+    f.get(e) === s && f.delete(e);
   });
-  return f.set(e, a), a;
-}, C = async (e, o, s = {}) => {
-  const a = s.timeoutMs ?? b, r = new u.Doc();
+  return f.set(e, s), s;
+}, P = async (e, a, c = {}) => {
+  const s = c.timeoutMs ?? b, r = new u.Doc();
   try {
-    u.applyUpdate(r, D(o), "dsheet-package-ingress");
-  } catch (i) {
-    return r.destroy(), p(e, "corrupt", i);
+    u.applyUpdate(r, D(a), "dsheet-package-ingress");
+  } catch (o) {
+    return r.destroy(), p(e, "corrupt", o);
   }
   let t = null;
   try {
-    return t = new E(e, r), await S(t.whenSynced, a), w(e, r);
-  } catch (i) {
+    t = new E(e, r), await S(t.whenSynced, s);
+    try {
+      await v(t);
+    } catch (o) {
+      console.warn("[DSheet] IndexedDB compaction failed:", o);
+    }
+    return w(e, r);
+  } catch (o) {
     return p(
       e,
-      /timed out/i.test(String(i)) ? "timed-out" : "unavailable",
-      i
+      /timed out/i.test(String(o)) ? "timed-out" : "unavailable",
+      o
     );
   } finally {
     await (t == null ? void 0 : t.destroy().catch(() => {
     })), r.destroy();
   }
 }, j = async (e) => {
-  f.delete(e), typeof indexedDB < "u" && await v(e);
+  f.delete(e), typeof indexedDB < "u" && await x(e);
 };
 export {
   j as deleteDsheetContent,
-  M as getDsheetStateVector,
-  C as mergeDsheetContent,
-  A as readDsheetContent
+  A as getDsheetStateVector,
+  P as mergeDsheetContent,
+  C as readDsheetContent
 };

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

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

package/dist/sheet-engine/core/modules/date-base-locale.d.ts

@@ -3,6 +3,8 @@ export declare function normalizeDateBaseLocale(locale: unknown): DateBaseLocale
 export declare function setDateBaseLocale(locale: unknown): void;
 export declare function getDateBaseLocale(): DateBaseLocale;
 export declare function isUsDateBaseLocale(): boolean;
+/** Standard Date toolbar / formula display format (no leading zeros). */
+export declare function getCanonicalDateDisplayFormat(hasTime?: boolean): string;
 export declare function getCanonicalDateEditFormat(hasTime: boolean): string;
 export declare function shouldPreserveDateFormatForEdit(format: string): boolean;
 export declare function getDateEditFormatForCell(cellDateFormat: string, hasTime: boolean): string;

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

@@ -2,7 +2,7 @@ export { getBorderInfoComputeRange, getBorderInfoCompute } from './border';
 export { normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, isValidRangeText, getInlineStringHTML, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, cancelFunctionrangeSelected, } from './cell';
 export { default as clipboard } from './clipboard';
 export { moveToEnd, getRangeRectsByCharacterOffset } from './cursor';
-export { getDateBaseLocale, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, } from './date-base-locale';
+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 { FORMULA_ASYNC_CHUNK_SIZE, FORMULA_ASYNC_EVAL_THRESHOLD, FORMULA_WORKER_CHUNK_SIZE, FORMULA_WORKER_THRESHOLD, isFormulaEvalPending, } from './formula-async-eval';

package/dist/sheet-engine/core/modules/validation.date.test.d.ts

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

package/dist/sheet-engine/core/utils/freeze.d.ts

@@ -4,5 +4,20 @@ export declare const getFreezeState: (ctx: Context) => {
     isRowFrozen: boolean;
     isColFrozen: boolean;
 };
+/**
+ * Pixel size (in the same zoomed screen-pixel space as visibledatarow /
+ * visibledatacolumn) of the frozen strip currently pinned to the top-left
+ * of the viewport. Zero on an axis that isn't frozen.
+ *
+ * Frozen rows/columns are only ever redrawn at a fixed on-screen position
+ * by the canvas itself -- there's no separate DOM layer for them -- so any
+ * DOM overlay positioned in document space (e.g. inserted images) needs
+ * this boundary to know when it has scrolled into the area the frozen
+ * pane owns and should stay hidden behind it.
+ */
+export declare const getFrozenPixelBounds: (ctx: Context) => {
+    widthPx: number;
+    heightPx: number;
+};
 export type FreezeType = 'row' | 'column' | 'both' | 'unfreeze-row' | 'unfreeze-column' | 'unfreeze-all';
 export declare const toggleFreeze: (ctx: Context, type: FreezeType) => void;

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

@@ -3,7 +3,8 @@ import { Sheet } from '../types';
 
 export { filterPatch, patchToOp, opToPatch, inverseRowColOptions, extractFormulaCellOps, } from './patch';
 export type { PatchOptions, ChangedSheet } from './patch';
-export { getFreezeState, toggleFreeze } from './freeze';
+export { getFreezeState, getFrozenPixelBounds, toggleFreeze } from './freeze';
+export { sheetNameNeedsQuotes, formatSheetNameForFormula, quoteSheetNamesInFormula, } from './sheet-name-ref';
 export type { FreezeType } from './freeze';
 export declare function generateRandomSheetName(file: Sheet[], isPivotTable: boolean, ctx: Context): any;
 export declare function rgbToHex(color: string): string;

package/dist/sheet-engine/core/utils/sheet-name-ref.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Helpers for sheet-qualified references in formulas (`Sheet1!A1`,
+ * `'Finance - 1'!A1`, `'It''s'!A1`).
+ *
+ * Like Google Sheets / Excel, a sheet name can only appear bare when it is a
+ * plain identifier. Anything else (spaces, `-`, punctuation, a leading digit,
+ * a name that looks like a cell such as `A1`, non-Latin scripts) must be
+ * wrapped in single quotes, with embedded `'` doubled.
+ */
+export declare function sheetNameNeedsQuotes(name: string): boolean;
+/** `Sheet1` -> `Sheet1`, `Finance - 1` -> `'Finance - 1'`, `It's` -> `'It''s'`. */
+export declare function formatSheetNameForFormula(name: string): string;
+/**
+ * Wraps bare references to existing sheets whose names need quoting, e.g.
+ * `=SUM(Sheet-4!H6,B2:C2)` -> `=SUM('Sheet-4'!H6,B2:C2)`.
+ *
+ * Only exact (case-insensitive) matches of an existing sheet name immediately
+ * followed by `!` are rewritten; text inside "strings" and already-quoted
+ * '...' names is left untouched.
+ */
+export declare function quoteSheetNamesInFormula(formula: string, sheetNames: string[]): string;

package/dist/sheet-engine/core/utils/sheet-name-ref.test.d.ts

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

package/dist/sheet-engine/formula-parser/quoted-sheet-ref.test.d.ts

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

package/dist/sheet-engine/react/hooks/useLastFormulaCaretOffset.d.ts

@@ -0,0 +1,14 @@
+import { RefObject } from 'react';
+
+/**
+ * Remembers the last caret position (text offset) inside a formula editor.
+ *
+ * Clicking a sheet tab moves the DOM selection out of the editor, so by the
+ * time the sheet switch finishes the caret is gone. The value kept here lets
+ * the editor put the caret back exactly where the user left it (e.g. after the
+ * `,` in `=SUM('Sheet - 2'!B2,`) instead of guessing.
+ *
+ * The offset counts characters across text nodes, matching
+ * `setCursorPosition`. It resets to `null` when the edit session ends.
+ */
+export declare function useLastFormulaCaretOffset(editorRef: RefObject<HTMLDivElement | null>, editSessionActive: boolean): RefObject<number | null>;