@fileverse-dev/dsheet 4.1.22 → 4.1.23-stabilise-package-3

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { executeStringFunction } from './editor/utils/executeStringFunction';
 export { FLVURL } from '@fileverse-dev/formulajs';
 export { loadLocale } from './sheet-engine/core';
 export type { ErrorMessageHandlerReturnType, DataBlockEvent, DataBlockEventType, ApiKeyStorage, DSheetEditorHandle, DSheetPermissionMode, } from './editor/types';
-export type { PanelConfig, PanelId, BuiltInPanelType } from './editor/types';
+export type { PanelConfig, PanelId, BuiltInPanelType, DSheetContentChange, } from './editor/types';
 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';

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, 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-DhQTrCQd.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-CQ922vEp.js";
+import { C as s, f as o, g as t, S as r, h as l, j as n, k as d, T as S, l as c, n as i, o as h, p as m, q as p, t as C, u, v as E, w as F, x, z as g, A as R, B as f, D as A, E as I, F as L, G as w, H as T, I as v, J as y, K as D, L as M, M as O, N as b, O as k, P, Q as V } from "./index-BXNWi7s5.js";
+import { cG as B, cH as G, cI as H, cO as K, by as U, e as X, f as _, l as J, a as j, du as q, dv as N, bh as Q, dw as Y, dx as Z, dB as W, dC as $, dE as ee, J as ae, dS as se, eq as oe, ba as te } from "./executeStringFunction-D5BTPrXL.js";
 import { FLVURL as le } from "@fileverse-dev/formulajs";
 import { E as de, S as Se } from "./constants-8Ij49Lxv.js";
 export {
@@ -15,51 +15,51 @@ export {
   d as SupportedChain,
   S as TEMPLATES,
   c as api,
-  G as clearColumnsCellsFormat,
+  B as clearColumnsCellsFormat,
   i as clearFilter,
-  K as clearRowsCellsFormat,
-  U as clearSelectedCellFormat,
-  m as createFilter,
-  h as decryptForRoomKey,
-  X as deleteRowCol,
-  _ as deleteSelectedCellText,
+  G as clearRowsCellsFormat,
+  H as clearSelectedCellFormat,
+  h as createFilter,
+  m as decryptForRoomKey,
+  K as deleteRowCol,
+  U as deleteSelectedCellText,
   p as describeMatchedShortcut,
   C as encryptForRoomKey,
-  j as executeStringFunction,
+  X as executeStringFunction,
   u as fetchSessionState,
-  B as formulaResponseUiSync,
-  H as getFlowdata,
+  _ as formulaResponseUiSync,
+  J as getFlowdata,
   E as getRemoveDuplicatesErrorMessage,
   F as getRemoveDuplicatesPreview,
-  J as getSheetIndex,
-  g as handleCSVUpload,
-  x as handleCopy,
+  j as getSheetIndex,
+  x as handleCSVUpload,
+  g as handleCopy,
   R as handleExportToCSV,
-  A as handleExportToJSON,
-  f as handleExportToODS,
+  f as handleExportToJSON,
+  A as handleExportToODS,
   I as handleExportToXLSX,
-  N as handleFreeze,
-  q as handleHorizontalAlign,
-  Y as handleLink,
-  Z as handleMerge,
+  q as handleFreeze,
+  N as handleHorizontalAlign,
+  Q as handleLink,
+  Y as handleMerge,
   L as handlePasteByClick,
-  Q as handleSort,
+  Z as handleSort,
   W as handleTextSize,
   $ as handleVerticalAlign,
-  T as importSpreadsheetFile,
+  w as importSpreadsheetFile,
   ee as insertRowCol,
-  w as isBrowserZoomShortcut,
-  y as isFormulaListShortcut,
-  v as isOpenShortcutsModalShortcut,
+  T as isBrowserZoomShortcut,
+  v as isFormulaListShortcut,
+  y as isOpenShortcutsModalShortcut,
   ae as jfrefreshgrid,
   se as loadLocale,
   D as remapCommentAnchors,
   M as removeActiveImage,
-  b as removeDuplicates,
-  k as seedSession,
-  z as showImgChooser,
+  O as removeDuplicates,
+  b as seedSession,
+  k as showImgChooser,
   oe as toolbarItemClickHandler,
   te as updateFormat,
-  O as useEnsStatus,
-  P as useXLSXImport
+  P as useEnsStatus,
+  V as useXLSXImport
 };

package/dist/persistence-utils-CSKBobX8.js

@@ -0,0 +1,151 @@
+import * as c from "yjs";
+const p = typeof Buffer == "function";
+typeof TextDecoder == "function" && new TextDecoder();
+typeof TextEncoder == "function" && new TextEncoder();
+const E = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=", l = Array.prototype.slice.call(E), f = ((t) => {
+  let e = {};
+  return t.forEach((r, n) => e[r] = n), e;
+})(l), U = /^(?:[A-Za-z\d+\/]{4})*?(?:[A-Za-z\d+\/]{2}(?:==)?|[A-Za-z\d+\/]{3}=?)?$/, u = String.fromCharCode.bind(String), h = typeof Uint8Array.from == "function" ? Uint8Array.from.bind(Uint8Array) : (t) => new Uint8Array(Array.prototype.slice.call(t, 0)), T = (t) => t.replace(/=/g, "").replace(/[+\/]/g, (e) => e == "+" ? "-" : "_"), m = (t) => t.replace(/[^A-Za-z0-9\+\/]/g, ""), w = (t) => {
+  let e, r, n, a, o = "";
+  const s = t.length % 3;
+  for (let i = 0; i < t.length; ) {
+    if ((r = t.charCodeAt(i++)) > 255 || (n = t.charCodeAt(i++)) > 255 || (a = t.charCodeAt(i++)) > 255)
+      throw new TypeError("invalid character found");
+    e = r << 16 | n << 8 | a, o += l[e >> 18 & 63] + l[e >> 12 & 63] + l[e >> 6 & 63] + l[e & 63];
+  }
+  return s ? o.slice(0, s - 3) + "===".substring(s) : o;
+}, _ = typeof btoa == "function" ? (t) => btoa(t) : p ? (t) => Buffer.from(t, "binary").toString("base64") : w, y = p ? (t) => Buffer.from(t).toString("base64") : (t) => {
+  let r = [];
+  for (let n = 0, a = t.length; n < a; n += 4096)
+    r.push(u.apply(null, t.subarray(n, n + 4096)));
+  return _(r.join(""));
+}, d = (t, e = !1) => e ? T(y(t)) : y(t), C = (t) => {
+  if (t = t.replace(/\s+/g, ""), !U.test(t))
+    throw new TypeError("malformed base64.");
+  t += "==".slice(2 - (t.length & 3));
+  let e, r, n, a = [];
+  for (let o = 0; o < t.length; )
+    e = f[t.charAt(o++)] << 18 | f[t.charAt(o++)] << 12 | (r = f[t.charAt(o++)]) << 6 | (n = f[t.charAt(o++)]), r === 64 ? a.push(u(e >> 16 & 255)) : n === 64 ? a.push(u(e >> 16 & 255, e >> 8 & 255)) : a.push(u(e >> 16 & 255, e >> 8 & 255, e & 255));
+  return a.join("");
+}, x = typeof atob == "function" ? (t) => atob(m(t)) : p ? (t) => Buffer.from(t, "base64").toString("binary") : C, B = p ? (t) => h(Buffer.from(t, "base64")) : (t) => h(x(t).split("").map((e) => e.charCodeAt(0))), k = (t) => B(F(t)), F = (t) => m(t.replace(/[-_]/g, (e) => e == "-" ? "+" : "/")), S = (t) => {
+  let e = 0;
+  return t.clients.forEach((r) => {
+    for (let n = 0; n < r.length; n += 1) e += r[n].len;
+  }), e;
+}, z = (t) => {
+  let e = 0;
+  return t.deleteSet.clients.forEach((r, n) => {
+    const a = t.beforeState.get(n) ?? 0;
+    for (let o = 0; o < r.length; o += 1) {
+      const { clock: s, len: i } = r[o];
+      s < a && (e += Math.min(s + i, a) - s);
+    }
+  }), t.afterState.forEach((r, n) => {
+    const a = t.beforeState.get(n) ?? 0;
+    if (r <= a) return;
+    const o = t.doc.store.clients.get(n);
+    if (o)
+      for (let s = c.findIndexSS(o, a); s < o.length && o[s].id.clock < r; s += 1) {
+        const i = o[s];
+        if (!i.deleted) continue;
+        const A = Math.max(i.id.clock, a), D = Math.min(i.id.clock + i.length, r);
+        e += D - A;
+      }
+  }), e;
+};
+function V(t) {
+  let e = t.store.clients.size === 0 ? 0 : S(c.createDeleteSetFromStructStore(t.store));
+  const r = (n) => {
+    e += z(n);
+  };
+  return t.on("afterTransaction", r), {
+    getFingerprint: () => `${d(c.encodeStateVector(t))}:${e}`,
+    getDeletedCount: () => e,
+    dispose: () => t.off("afterTransaction", r)
+  };
+}
+function I(t) {
+  const e = new c.Doc();
+  try {
+    return c.applyUpdate(e, t), b(e);
+  } finally {
+    e.destroy();
+  }
+}
+function b(t) {
+  const e = t.store.clients.size === 0 ? 0 : S(c.createDeleteSetFromStructStore(t.store));
+  return `${d(c.encodeStateVector(t))}:${e}`;
+}
+const Z = 8e3, P = (t) => t instanceof Error ? t : new Error(String(t)), v = (t, e, r = "dsheet-package-ingress") => {
+  const n = k(e), a = new c.Doc();
+  try {
+    c.applyUpdate(a, n);
+  } finally {
+    a.destroy();
+  }
+  let o = !1;
+  const s = () => {
+    o = !0;
+  };
+  t.on("update", s);
+  try {
+    return c.applyUpdate(t, n, r), o;
+  } finally {
+    t.off("update", s);
+  }
+}, $ = async (t, e) => {
+  let r;
+  try {
+    return await Promise.race([
+      t,
+      new Promise((n, a) => {
+        r = setTimeout(
+          () => a(new Error("dSheet IndexedDB operation timed out")),
+          e
+        );
+      })
+    ]);
+  } finally {
+    r && clearTimeout(r);
+  }
+}, g = (t, e, r) => ({
+  dsheetId: t,
+  status: e,
+  encodedState: null,
+  stateVector: null,
+  fingerprint: null,
+  ...r ? { error: P(r) } : {}
+}), M = (t, e) => {
+  const r = c.encodeStateAsUpdate(e);
+  return {
+    dsheetId: t,
+    status: r.length <= 2 ? "empty" : "available",
+    encodedState: d(r),
+    stateVector: d(c.encodeStateVector(e)),
+    fingerprint: b(e)
+  };
+}, j = (t, e, r) => {
+  if (!r)
+    return g(
+      t,
+      "unavailable",
+      new Error("dSheet document is not ready")
+    );
+  try {
+    return v(r, e, "dsheet-package-ingress"), M(t, r);
+  } catch (n) {
+    return g(t, "corrupt", n);
+  }
+};
+export {
+  Z as D,
+  I as a,
+  V as b,
+  j as c,
+  d as f,
+  v as m,
+  M as s,
+  k as t,
+  g as u,
+  $ as w
+};

package/dist/persistence-utils.d.ts

@@ -6,6 +6,8 @@ export type DSheetContentSnapshot = {
     status: DSheetContentStatus;
     encodedState: string | null;
     stateVector: string | null;
+    /** A1 content fingerprint of the document read; null when unavailable. */
+    fingerprint: string | null;
     error?: Error;
 };
 export type DSheetContentReadOptions = {

package/dist/persistence.append.test.d.ts

@@ -0,0 +1 @@
+

package/dist/persistence.d.ts

@@ -1,6 +1,7 @@
 import { DSheetContentReadOptions, DSheetContentSnapshot } from './persistence-utils';
 
 export type { DSheetContentReadOptions, DSheetContentSnapshot, DSheetContentStatus, } from './persistence-utils';
+export { fingerprintFromUpdate } from './editor/utils/content-fingerprint';
 export declare const getDsheetStateVector: (encodedState: string | Uint8Array) => string;
 /**
  * Read the package-owned Y-IndexedDB database without attaching another
@@ -10,3 +11,15 @@ export declare const readDsheetContent: (dsheetId: string, options?: DSheetConte
 /** Merge content into the package-owned Y-IndexedDB document. */
 export declare const mergeDsheetContent: (dsheetId: string, encodedState: string, options?: DSheetContentReadOptions) => Promise<DSheetContentSnapshot>;
 export declare const deleteDsheetContent: (dsheetId: string) => Promise<void>;
+/**
+ * Append one Yjs update as a single row of the package-owned y-indexeddb
+ * `updates` store. Unlike mergeDsheetContent it never builds a Y.Doc and never
+ * writes a full copy of the document: the caller passes only what is missing
+ * (for example Y.diffUpdate(remote, localStateVector)).
+ *
+ * If the database does not exist yet it is created with the same schema
+ * y-indexeddb uses (`updates` autoIncrement, `custom`). Rejects with
+ * "IndexedDB is unavailable" when there is no indexedDB, and with the
+ * underlying error if the transaction fails or aborts.
+ */
+export declare const appendDsheetUpdate: (dsheetId: string, update: Uint8Array, options?: DSheetContentReadOptions) => Promise<void>;

package/dist/persistence.fingerprint.test.d.ts

@@ -0,0 +1 @@
+

package/dist/persistence.js

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

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

@@ -1,5 +1,5 @@
 import { Context } from '../context';
-import { Cell, SingleRange } from '../types';
+import { Cell, SingleRange, Sheet } from '../types';
 import { CommonOptions } from './common';
 
 export declare function getCellValue(ctx: Context, row: number, column: number, options?: CommonOptions & {
@@ -7,6 +7,25 @@ export declare function getCellValue(ctx: Context, row: number, column: number,
 }): any;
 export declare function setCellValue(ctx: Context, row: number, column: number, value: any, cellInput: HTMLDivElement | null, options?: CommonOptions, callAfterUpdate?: boolean): void;
 export declare function applyRemoteCellValue(ctx: Context, row: number, column: number, value: any, options?: CommonOptions): void;
+/**
+ * Replace a sheet's formula list with the collaborator's value from Yjs and
+ * reset the formula dependency indexes to a fresh mount's state (A4). This
+ * is what the grid rebuild it replaces produced, without the rebuild. The
+ * caller runs it with noHistory.
+ */
+export declare function setSheetCalcChain(ctx: Context, calcChain: Sheet['calcChain'], options?: CommonOptions): void;
+export type RemoteCellChange = {
+    r: number;
+    c: number;
+    v: unknown;
+};
+/**
+ * Apply a remote batch of cells inside one draft (A5). The caller runs it in
+ * one setContext with noHistory, so a batch is one Immer pass and never
+ * lands on the local undo stack. A cell that fails is reported through
+ * onSkip and the rest still apply.
+ */
+export declare function applyRemoteCells(ctx: Context, cells: RemoteCellChange[], options?: CommonOptions, onSkip?: (cell: RemoteCellChange, error: unknown) => void): 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/api/remote-apply.test.d.ts

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

package/dist/sheet-engine/core/api/sheet-flowdata-lifecycle.d.ts

@@ -1,5 +1,6 @@
 import { Context } from '../context';
 
+export declare function collectSheetIdsFromFormulaText(ctx: Context, formula: string): Set<string>;
 /** Drop cached dense-sheet set (e.g. after structural workbook changes). */
 export declare function invalidateSheetsRequiredDenseCache(): void;
 /**

package/dist/sheet-engine/core/api/sheet-flowdata-lifecycle.test.d.ts

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

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

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

package/dist/sheet-engine/core/locale/en.d.ts

@@ -548,6 +548,7 @@ declare const _default: {
         cancelText: string;
         chooseText: string;
         focus: string;
+        copyLink: string;
         tipNameRepeat: string;
         noMoreSheet: string;
         confirmDelete: string;

package/dist/sheet-engine/core/locale/es.d.ts

@@ -700,6 +700,7 @@ declare const _default: {
         cancelText: string;
         chooseText: string;
         focus: string;
+        copyLink: string;
         tipNameRepeat: string;
         noMoreSheet: string;
         confirmDelete: string;

package/dist/sheet-engine/core/locale/hi.d.ts

@@ -575,6 +575,7 @@ declare const _default: {
         cancelText: string;
         chooseText: string;
         focus: string;
+        copyLink: string;
         tipNameRepeat: string;
         noMoreSheet: string;
         confirmDelete: string;

package/dist/sheet-engine/core/locale/zh.d.ts

@@ -593,6 +593,7 @@ declare const _default: {
         cancelText: string;
         chooseText: string;
         focus: string;
+        copyLink: string;
         tipNameRepeat: string;
         noMoreSheet: string;
         confirmDelete: string;