@freegridjs/core 1.7.1 → 1.9.0

package/dist/index.js

@@ -1296,6 +1296,7 @@ function columnFormulaValue(def, row) {
   if (scope) return valueIn(scope, cacheOf(scope), row, def.field);
   return run(row[def.field], { row, scope, seen: /* @__PURE__ */ new Set([def.field]), depth: 0, memo: /* @__PURE__ */ new Map() });
 }
+var formulasOff = (def) => !!scopes.get(def)?.off?.();
 var isFormula = (v) => typeof v === "string" && v.length > 1 && v.startsWith("=");
 function formulaRefs(formula) {
   let n;
@@ -1327,10 +1328,10 @@ function getCellValue(def, row) {
       return void 0;
     }
   }
-  if (typeof def.formula === "string" && isFormula(def.formula)) return columnFormulaValue(def, row);
+  if (typeof def.formula === "string" && isFormula(def.formula) && !formulasOff(def)) return columnFormulaValue(def, row);
   if (def.field == null) return void 0;
   const raw = row[def.field];
-  return def.formulas && isFormula(raw) ? columnFormulaValue(def, row) : raw;
+  return def.formulas && isFormula(raw) && !formulasOff(def) ? columnFormulaValue(def, row) : raw;
 }
 
 // src/interactions/filterRow.ts
@@ -3416,6 +3417,8 @@ function nextFocus(key, mods, p, s) {
 
 // src/registry.ts
 var liveGrids = /* @__PURE__ */ new Map();
+var apiGrids = /* @__PURE__ */ new WeakMap();
+var gridOfApi = (api) => api ? apiGrids.get(api) : void 0;
 var gridOfRoot = (root) => root ? liveGrids.get(root) : void 0;
 
 // src/interactions/body.ts
@@ -3492,7 +3495,7 @@ function attachBody(grid) {
       const data = grid.columns.displayed().filter((c) => !isSystemCol(c.id));
       if (data.length) {
         grid.setFocus(ev.rowIndex, data[0].id);
-        grid.setRange({ start: { rowIndex: ev.rowIndex, colId: data[0].id }, end: { rowIndex: ev.rowIndex, colId: data[data.length - 1].id } });
+        if (grid.rangesOn()) grid.setRange({ start: { rowIndex: ev.rowIndex, colId: data[0].id }, end: { rowIndex: ev.rowIndex, colId: data[data.length - 1].id } });
       }
       return;
     }
@@ -3501,9 +3504,9 @@ function attachBody(grid) {
     const prev = grid.store.state.focus;
     const onBox = ev.colId === SELECT_COL_ID;
     if (dragged) {
-    } else if (e.shiftKey && prev && !onBox && !isSystemCol(prev.colId) && grid.options.rangeSelection !== false) {
+    } else if (e.shiftKey && prev && !onBox && !isSystemCol(prev.colId) && grid.rangesOn()) {
       grid.setRange({ start: prev, end: { rowIndex: ev.rowIndex, colId: ev.colId } }, true);
-    } else if ((e.ctrlKey || e.metaKey) && !onBox && !isSystemCol(ev.colId) && grid.options.rangeSelection !== false) {
+    } else if ((e.ctrlKey || e.metaKey) && !onBox && !isSystemCol(ev.colId) && grid.rangesOn()) {
       const at = { rowIndex: ev.rowIndex, colId: ev.colId };
       grid.addRange({ start: at, end: at });
       grid.setFocus(ev.rowIndex, ev.colId);
@@ -3511,7 +3514,7 @@ function attachBody(grid) {
       grid.setFocus(ev.rowIndex, ev.colId);
       grid.setRange(null);
     }
-    if (grid.options.rowSelection && !dragged) {
+    if (grid.options.rowSelection && !dragged && (onBox || grid.options.rowClickSelection !== false)) {
       grid.selectFromClick(ev.rowIndex, onBox || e.ctrlKey || e.metaKey, e.shiftKey);
     }
     grid.events.emit("cellClick", ev);
@@ -3569,7 +3572,7 @@ function attachBody(grid) {
         grid.selectAllCells();
         return true;
       case "find":
-        if (grid.options.findBar === false) return false;
+        if (grid.options.findBar === false || !grid.paid) return false;
         grid.finder.openBar();
         return true;
       case "paste":
@@ -3679,7 +3682,7 @@ function attachBody(grid) {
     clearTimeout(pressTimer);
     pressTimer = window.setTimeout(() => {
       cancel();
-      if (grid.options.contextMenu === false) return;
+      if (!grid.contextMenu.enabled()) return;
       suppressClick = true;
       if (!isSystemCol(hit.colId)) {
         grid.setFocus(hit.rowIndex, hit.colId);
@@ -3698,7 +3701,7 @@ function attachBody(grid) {
       return;
     }
     if (e.button === 0 && onHandleDown(e)) return;
-    if (grid.options.rangeSelection === false) return;
+    if (!grid.rangesOn()) return;
     if (e.button !== 0 || e.shiftKey || e.target.closest("input, a, button")) return;
     const start = renderer.cellAt(e.target);
     if (!start || isSystemCol(start.colId)) return;
@@ -3746,7 +3749,7 @@ function attachBody(grid) {
       grid.setRange(null);
       return;
     }
-    if (ctrl && e.key.toLowerCase() === "a" && grid.options.rangeSelection !== false) {
+    if (ctrl && e.key.toLowerCase() === "a" && grid.rangesOn()) {
       e.preventDefault();
       grid.selectAllCells();
       return;
@@ -3763,7 +3766,7 @@ function attachBody(grid) {
     }
     const size = { rows: count, cols: cols.length, pageRows: renderer.pageRows() };
     const firstData = cols.findIndex((c) => !isSystemCol(c.id));
-    const ranges = grid.options.rangeSelection !== false;
+    const ranges = grid.rangesOn();
     if (ranges && e.shiftKey && e.key !== "Tab" && NAV_KEYS.has(e.key)) {
       const anchor = f ?? { rowIndex: 0, colId: cols[firstData].id };
       const range = grid.store.state.range;
@@ -4264,6 +4267,10 @@ var ContextMenu = class {
     this.close();
     this.detach();
   }
+  /** The cell menu is on: not switched off and the paid feature allowed (closed: the browser's menu shows). */
+  enabled() {
+    return this.grid.options.contextMenu !== false && this.grid.allow("contextMenu");
+  }
   onContextMenu(e) {
     const { grid } = this;
     if (grid.options.contextMenu === false) return;
@@ -4278,7 +4285,7 @@ var ContextMenu = class {
       return;
     }
     const hit = grid.renderer.cellAt(target);
-    if (!hit) return;
+    if (!hit || !this.enabled()) return;
     e.preventDefault();
     grid.renderer.gridEl.focus({ preventScroll: true });
     if (!isSystemCol(hit.colId) && !grid.rangeContains(hit.rowIndex, hit.colId)) {
@@ -4290,7 +4297,7 @@ var ContextMenu = class {
   /** Keyboard: Shift+F10 or the ContextMenu key. */
   openAtFocus() {
     const f = this.grid.store.state.focus;
-    if (!f || this.grid.options.contextMenu === false) return;
+    if (!f || !this.enabled()) return;
     const r = this.grid.renderer.root.getBoundingClientRect();
     const cell = this.grid.renderer.root.querySelector(`.fg-row[data-row="${f.rowIndex}"] .fg-cell[data-col="${CSS.escape(f.colId)}"]`);
     const box = cell?.getBoundingClientRect() ?? r;
@@ -4333,7 +4340,7 @@ var ContextMenu = class {
     if (grid.options.rowSelection === "multiple") items.push({ label: loc.selectAllRows, action: () => grid.api.selectAll() });
     items.push({ label: loc.chooseColumns, action: () => grid.chooser.open() });
     const b = grid.rangeBounds();
-    if (b && (b.r2 > b.r1 || b.c2 > b.c1)) {
+    if (b && (b.r2 > b.r1 || b.c2 > b.c1) && grid.paid) {
       items.push(
         "separator",
         { label: loc.chartBar, action: () => grid.api.createChart({ type: "bar" }) },
@@ -4344,12 +4351,12 @@ var ContextMenu = class {
     items.push(
       "separator",
       { label: loc.exportCsv, action: () => grid.api.exportCsv() },
-      { label: loc.exportExcel, action: () => grid.api.exportXlsx() },
+      ...grid.paid ? [{ label: loc.exportExcel, action: () => grid.api.exportXlsx() }] : [],
       { label: loc.exportJson, action: () => grid.api.exportJson() },
-      ...grid.options.assistant?.url ? [{ label: `${loc.ai.title}\u2026`, action: () => grid.api.openAssistant() }] : [],
-      { label: loc.exportPdf, action: () => grid.api.exportPdf() }
+      ...grid.options.assistant?.url && grid.paid ? [{ label: `${loc.ai.title}\u2026`, action: () => grid.api.openAssistant() }] : [],
+      ...grid.paid ? [{ label: loc.exportPdf, action: () => grid.api.exportPdf() }] : []
     );
-    if (grid.options.advancedFilter !== false && !grid.options.pivot) items.push("separator", { label: `${loc.advancedFilter}\u2026`, action: () => grid.filterBuilder.open() });
+    if (grid.options.advancedFilter !== false && !grid.options.pivot && grid.paid) items.push("separator", { label: `${loc.advancedFilter}\u2026`, action: () => grid.filterBuilder.open() });
     items.push("separator", { label: loc.print, action: () => grid.api.print() });
     return items;
   }
@@ -4492,8 +4499,7 @@ var FillHandle = class {
     this.handle.addEventListener("pointerdown", this.onDown);
   }
   enabled() {
-    const o = this.grid.options;
-    return o.fillHandle !== false && o.rangeSelection !== false;
+    return this.grid.options.fillHandle !== false && this.grid.rangesOn();
   }
   /** Current source block: the range, or the focused cell. */
   source() {
@@ -4670,7 +4676,7 @@ var Finder = class {
     this.countEl.textContent = !this.query ? "" : this.matches.length ? `${this.index + 1}/${this.matches.length}` : loc.noMatches;
   }
   openBar() {
-    if (this.grid.options.findBar === false) return;
+    if (this.grid.options.findBar === false || !this.grid.paid) return;
     if (this.bar) {
       this.bar.querySelector("input").focus();
       return;
@@ -7603,12 +7609,36 @@ function buildPivot(source, config, defOf, labels, locale) {
   return { columns: [...rowColumns, ...valueColumns], rows, groupBy: cfg.rows.slice(0, -1) };
 }
 
+// src/features.ts
+var PAID_FEATURES = {
+  grouping: { en: "Row grouping and aggregation", ko: "\uD589 \uADF8\uB8F9\xB7\uC9D1\uACC4" },
+  pivot: { en: "Pivot", ko: "\uD53C\uBC97" },
+  charts: { en: "Charts", ko: "\uCC28\uD2B8" },
+  range: { en: "Cell range selection", ko: "\uC140 \uBC94\uC704 \uC120\uD0DD" },
+  clipboard: { en: "Range copy and paste", ko: "\uBC94\uC704 \uBCF5\uC0AC\xB7\uBD99\uC5EC\uB123\uAE30" },
+  fill: { en: "Fill handle", ko: "\uCC44\uC6B0\uAE30 \uD578\uB4E4" },
+  excel: { en: "Excel export", ko: "\uC5D1\uC140 \uB0B4\uBCF4\uB0B4\uAE30" },
+  pdf: { en: "PDF export", ko: "PDF \uB0B4\uBCF4\uB0B4\uAE30" },
+  serverGroups: { en: "Server-side groups", ko: "\uC11C\uBC84 \uADF8\uB8F9" },
+  advancedFilter: { en: "Advanced filter", ko: "\uACE0\uAE09 \uD544\uD130" },
+  sideBar: { en: "Side bar panels", ko: "\uC0AC\uC774\uB4DC\uBC14 \uD328\uB110" },
+  contextMenu: { en: "Context menu", ko: "\uCEE8\uD14D\uC2A4\uD2B8 \uBA54\uB274" },
+  summary: { en: "Summary rows", ko: "\uD569\uACC4 \uD589" },
+  formulas: { en: "Formulas", ko: "\uC218\uC2DD" },
+  find: { en: "Find", ko: "\uCC3E\uAE30" },
+  conditional: { en: "Conditional formatting", ko: "\uC870\uAC74\uBD80 \uC11C\uC2DD" },
+  assistant: { en: "AI assistant", ko: "AI \uC5B4\uC2DC\uC2A4\uD134\uD2B8" },
+  merge: { en: "Merged cells", ko: "\uC140 \uBCD1\uD569" },
+  workbook: { en: "Workbook", ko: "\uC6CC\uD06C\uBD81" }
+};
+
 // src/version.ts
-var version = "1.7.1";
+var version = "1.9.0";
 
 // src/license.ts
 var PUBLIC_KEY = { kty: "EC", crv: "P-256", x: "sUTKkglZmk-HMKPNub8p7AeLBKesHCU8irIkw9rJlbE", y: "j0U_aKRDR7iApY9UpaD3hUemhBLZJwDv9-QiT_hUyw8" };
 var PRICING_URL = "https://freegrid.app/pricing/";
+var PERSONAL_URL = "https://freegrid.app/license/personal/";
 var USAGE_URL = "https://freegrid.app/api/usage";
 var STATUS_URL = "https://freegrid.app/api/domain-status";
 var majorOf = (v) => Number.parseInt(String(v).split(".")[0], 10);
@@ -7624,11 +7654,9 @@ function domainMatches(host, domains) {
   const h = host.toLowerCase().replace(/\.$/, "");
   return domains.some((d) => {
     const raw = d.toLowerCase().replace(/\.$/, "");
-    const wildcard = raw.startsWith("*.");
-    const dom = wildcard ? raw.slice(2) : raw;
+    const dom = raw.startsWith("*.") ? raw.slice(2) : raw;
     if (!dom) return false;
-    if (h === dom || h === `www.${dom}`) return true;
-    return wildcard && h.endsWith(`.${dom}`);
+    return h === dom || h.endsWith(`.${dom}`);
   });
 }
 var isDay = (s) => {
@@ -7646,6 +7674,7 @@ async function verifyLicense(key, host, opts = {}) {
     info = JSON.parse(new TextDecoder().decode(b64urlDecode(parts[1])));
     if (!Array.isArray(info.domains) || !isDay(info.expires)) return { ok: false, reason: "format" };
     if (info.major !== void 0 && !(Number.isInteger(info.major) && info.major > 0)) return { ok: false, reason: "format" };
+    if (info.plan !== void 0 && info.plan !== "company" && info.plan !== "personal") return { ok: false, reason: "format" };
   } catch {
     return { ok: false, reason: "format" };
   }
@@ -7666,13 +7695,18 @@ async function verifyLicense(key, host, opts = {}) {
 }
 var globalKey;
 var statuses = /* @__PURE__ */ new Map();
-var badgeCheck = null;
+var statusChecks = /* @__PURE__ */ new Map();
+var gateNotices = /* @__PURE__ */ new Set();
+var blockedWarned = /* @__PURE__ */ new Set();
 function setLicenseKey(key) {
   globalKey = key;
 }
 var NOTICE = {
-  missing: `FreeGrid is free for personal use. Company use needs a domain license (\u20A9200,000 per domain per year): ${PRICING_URL}
-FreeGrid\uB294 \uAC1C\uC778\uC5D0\uAC8C \uBB34\uB8CC\uC785\uB2C8\uB2E4. \uD68C\uC0AC\uC5D0\uC11C \uC4F0\uB824\uBA74 \uB3C4\uBA54\uC778 \uB77C\uC774\uC120\uC2A4(\uB3C4\uBA54\uC778\uB2F9 \uC5F0 20\uB9CC \uC6D0)\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4: ${PRICING_URL}`,
+  missing: `FreeGrid: every feature is free for 30 days on a domain. After that, paid features need a free personal key (${PERSONAL_URL}) or a company key: ${PRICING_URL}
+FreeGrid: \uB3C4\uBA54\uC778\uB9C8\uB2E4 30\uC77C \uB3D9\uC548 \uBAA8\uB4E0 \uAE30\uB2A5\uC744 \uBB34\uB8CC\uB85C \uC4F8 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uADF8 \uB4A4 \uC720\uB8CC \uAE30\uB2A5\uC5D0\uB294 \uBB34\uB8CC \uAC1C\uC778 \uD0A4(${PERSONAL_URL}) \uB610\uB294 \uD68C\uC0AC \uD0A4\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4: ${PRICING_URL}`,
+  trial: (ends) => `FreeGrid: the 30-day trial of paid features on this domain ends ${ends}. / \uC774 \uB3C4\uBA54\uC778\uC758 \uC720\uB8CC \uAE30\uB2A5 30\uC77C \uCCB4\uD5D8\uC740 ${ends}\uC5D0 \uB05D\uB0A9\uB2C8\uB2E4.`,
+  ended: `FreeGrid: the 30-day trial on this domain has ended, so paid features are now off. Get a free personal key (${PERSONAL_URL}) or a company key: ${PRICING_URL}
+FreeGrid: \uC774 \uB3C4\uBA54\uC778\uC758 30\uC77C \uCCB4\uD5D8\uC774 \uB05D\uB098 \uC720\uB8CC \uAE30\uB2A5\uC774 \uAEBC\uC84C\uC2B5\uB2C8\uB2E4. \uBB34\uB8CC \uAC1C\uC778 \uD0A4(${PERSONAL_URL}) \uB610\uB294 \uD68C\uC0AC \uD0A4\uB97C \uBC1B\uC73C\uC138\uC694: ${PRICING_URL}`,
   format: "FreeGrid: the license key is not in the right format. / \uB77C\uC774\uC120\uC2A4 \uD0A4 \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   signature: "FreeGrid: the license key could not be verified. / \uB77C\uC774\uC120\uC2A4 \uD0A4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   expired: "FreeGrid: the license key has expired. / \uB77C\uC774\uC120\uC2A4 \uAE30\uAC04\uC774 \uB05D\uB0AC\uC2B5\uB2C8\uB2E4.",
@@ -7716,31 +7750,98 @@ ${PRICING_URL}`);
   statuses.set(id, status);
   return status;
 }
-function badgeRequested(host = typeof location !== "undefined" ? location.hostname : "") {
-  if (isDevHost(host) || typeof fetch !== "function") return Promise.resolve(false);
-  if (badgeCheck) return badgeCheck;
+var gateHost;
+var currentHost = () => gateHost ?? (typeof location !== "undefined" ? location.hostname : "");
+var parseStatus = (d) => {
+  if (!d || typeof d !== "object") return null;
+  const { badge, trial } = d;
+  const valid = !!trial && typeof trial === "object" && isDay(trial.started) && isDay(trial.ends) && typeof trial.active === "boolean";
+  return { badge: badge === true, trial: valid ? { started: trial.started, ends: trial.ends, active: trial.active } : null };
+};
+function fetchDomainStatus(host = currentHost()) {
+  if (isDevHost(host) || typeof fetch !== "function") return Promise.resolve(null);
+  const pending = statusChecks.get(host);
+  if (pending) return pending;
   const day = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   let store = null;
   try {
     store = typeof localStorage !== "undefined" ? localStorage : null;
-    const cached = JSON.parse(store?.getItem("freegrid:badge") ?? "null");
-    if (cached && cached.host === host && cached.day === day) return badgeCheck = Promise.resolve(cached.show);
+    const cached = JSON.parse(store?.getItem("freegrid:status") ?? "null");
+    const status = cached && cached.host === host && cached.day === day ? parseStatus(cached.status) : null;
+    if (status) {
+      const hit = Promise.resolve(status);
+      statusChecks.set(host, hit);
+      return hit;
+    }
   } catch {
   }
-  badgeCheck = fetch(STATUS_URL, { mode: "cors", credentials: "omit" }).then((r) => r.ok ? r.json() : { badge: false }).then((d) => {
-    const show = d.badge === true;
-    try {
-      store?.setItem("freegrid:badge", JSON.stringify({ host, day, show }));
-    } catch {
+  const check = fetch(STATUS_URL, { mode: "cors", credentials: "omit" }).then((r) => r.ok ? r.json() : null).then((d) => {
+    const status = parseStatus(d);
+    if (status) {
+      try {
+        store?.setItem("freegrid:status", JSON.stringify({ host, day, status }));
+      } catch {
+      }
     }
-    return show;
-  }, () => false);
-  return badgeCheck;
+    return status;
+  }).catch(() => null);
+  statusChecks.set(host, check);
+  return check;
+}
+function badgeRequested(host = currentHost()) {
+  return fetchDomainStatus(host).then((s) => s?.badge === true);
 }
-async function needsFreeBadge(key, host = typeof location !== "undefined" ? location.hostname : "") {
+async function needsFreeBadge(key, host = currentHost()) {
   if (await checkLicense(key, host)) return false;
   return badgeRequested(host);
 }
+var GATE_KEY = "freegrid:gate";
+var keyIdOf = (key) => {
+  if (!key) return "";
+  const parts = key.trim().split(".");
+  return parts[parts.length - 1].slice(-16);
+};
+function paidAllowed(key, host = currentHost()) {
+  if (isDevHost(host)) return true;
+  try {
+    const cache2 = JSON.parse(localStorage.getItem(GATE_KEY) ?? "null");
+    if (!cache2 || cache2.host !== host || cache2.keyId !== keyIdOf(key ?? globalKey)) return true;
+    return cache2.paid !== false;
+  } catch {
+    return true;
+  }
+}
+var writeGate = (cache2) => {
+  try {
+    localStorage.setItem(GATE_KEY, JSON.stringify(cache2));
+  } catch {
+  }
+};
+async function resolveGate(key, host = currentHost()) {
+  const k = key ?? globalKey;
+  const keyId = keyIdOf(k);
+  if (await checkLicense(k, host)) {
+    writeGate({ host, keyId, paid: true });
+    return true;
+  }
+  const trial = (await fetchDomainStatus(host))?.trial;
+  if (!trial) return true;
+  writeGate({ host, keyId, paid: trial.active, trialEnds: trial.ends });
+  const notice = `${trial.active ? "trial" : "ended"}@${host}`;
+  if (!gateNotices.has(notice)) {
+    gateNotices.add(notice);
+    if (trial.active) console.info(NOTICE.trial(trial.ends));
+    else console.warn(NOTICE.ended);
+  }
+  return trial.active;
+}
+function paidBlocked(feature) {
+  if (blockedWarned.has(feature)) return;
+  blockedWarned.add(feature);
+  const name = PAID_FEATURES[feature] ?? { en: feature, ko: feature };
+  console.warn(`FreeGrid: ${name.en} is a paid feature and is off on this domain. Get a free personal key (${PERSONAL_URL}) or a company key: ${PRICING_URL}
+FreeGrid: ${name.ko}\uC740(\uB294) \uC720\uB8CC \uAE30\uB2A5\uC774\uB77C \uC774 \uB3C4\uBA54\uC778\uC5D0\uC11C \uAEBC\uC838 \uC788\uC2B5\uB2C8\uB2E4. \uBB34\uB8CC \uAC1C\uC778 \uD0A4(${PERSONAL_URL}) \uB610\uB294 \uD68C\uC0AC \uD0A4\uB97C \uBC1B\uC73C\uC138\uC694: ${PRICING_URL}`);
+}
 
 // src/interactions/menu.ts
 var OPS = {
@@ -7785,7 +7886,7 @@ var ColumnMenu = class {
       [loc.unpin, () => this.grid.setPinned(colId, null)]
     ]));
     const grouped = this.grid.getGroupBy();
-    if (!this.grid.options.treeData && (this.grid.options.groupPanel || grouped.length)) {
+    if (!this.grid.options.treeData && this.grid.paid && (this.grid.options.groupPanel || grouped.length)) {
       const g = grouped.includes(colId) ? [[loc.ungroup, () => this.grid.setGroupBy(grouped.filter((x) => x !== colId))]] : [[loc.groupByThis, () => this.grid.setGroupBy([...grouped, colId])]];
       if (grouped.length) g.push([loc.expandAll, () => this.grid.expandAll(true)], [loc.collapseAll, () => this.grid.expandAll(false)]);
       popup.append(this.section(g));
@@ -7796,7 +7897,7 @@ var ColumnMenu = class {
     ];
     if (!def.lockVisible) items.push([loc.hideColumn, () => this.grid.setColumnsVisible([colId], false)]);
     items.push([loc.chooseColumns, () => this.grid.chooser.open()], [loc.resetColumns, () => this.grid.resetColumns()]);
-    if (this.grid.options.conditionalFormatMenu !== false) items.push([`${loc.cf.title}\u2026`, () => this.grid.formatDialog.open(colId)]);
+    if (this.grid.options.conditionalFormatMenu !== false && this.grid.paid) items.push([`${loc.cf.title}\u2026`, () => this.grid.formatDialog.open(colId)]);
     popup.append(this.section(items));
     const filter = this.filterSection(colId, () => this.close());
     if (filter) popup.append(filter);
@@ -9704,6 +9805,7 @@ var Grid = class {
     this.pageSize = DEFAULT_PAGE_SIZE;
     /** What formulas see: every source row, and computed columns by id. */
     this.formulaScope = {
+      off: () => !this.allow("formulas"),
       rows: () => this.store.state.data,
       version: () => this.editVersion,
       computed: (name) => {
@@ -9768,6 +9870,7 @@ var Grid = class {
     this.selectionVersion = 0;
     /** Rows select-all acts on: displayed data rows that are selectable. */
     this.selectableCache = null;
+    this.paid = paidAllowed(options.licenseKey);
     if (!Array.isArray(options.columns)) warn("options.columns must be an array");
     if (options.data != null && !Array.isArray(options.data)) warn("options.data must be an array");
     this.store = new Store({
@@ -9809,12 +9912,12 @@ var Grid = class {
       collator: () => this.collator(),
       textVersion: () => `${this.store.state.locale.code}|${this.editVersion}`
     });
-    this.groupBy = this.validGroupBy(options.groupBy ?? []);
-    if (Array.isArray(options.conditionalFormats)) this.cfRules = options.conditionalFormats.filter((r) => r && typeof r === "object" && Array.isArray(r.columns)).map((r) => ({ ...r, columns: [...r.columns] }));
-    this.defaultExpanded = options.groupDefaultExpanded ?? 0;
+    if (options.groupBy?.length && this.allow(this.rowModel.server ? "serverGroups" : "grouping")) this.groupBy = this.validGroupBy(options.groupBy);
+    if (Array.isArray(options.conditionalFormats) && options.conditionalFormats.length && this.allow("conditional")) this.cfRules = options.conditionalFormats.filter((r) => r && typeof r === "object" && Array.isArray(r.columns)).map((r) => ({ ...r, columns: [...r.columns] }));
+    this.defaultExpanded = options.treeData || this.paid ? options.groupDefaultExpanded ?? 0 : 0;
     if (options.treeData && !options.getRowId) warn("treeData needs getRowId so parent ids can be matched");
     this.updateRows();
-    this.summaryOpts = options.summary ?? null;
+    this.summaryOpts = options.summary && this.allow("summary") ? options.summary : null;
     this.summarySnapshot = snapshot(this.summaryOpts);
     this.refreshSummary();
     const explicit = options.fontSize != null && options.fontSize > 0 ? options.fontSize : null;
@@ -9835,9 +9938,9 @@ var Grid = class {
     this.editor = new CellEditor(this);
     this.finder = new Finder(this);
     this.fillHandle = new FillHandle(this);
-    this.groupPanel = options.groupPanel ? new GroupPanel(this) : null;
+    this.groupPanel = options.groupPanel && this.allow("grouping") ? new GroupPanel(this) : null;
     this.pinnedRows = { top: cleanRows(options.pinnedTopRows ?? []), bottom: cleanRows(options.pinnedBottomRows ?? []) };
-    this.sideBar = options.sideBar ? new SideBar(
+    this.sideBar = options.sideBar && this.allow("sideBar") ? new SideBar(
       this,
       typeof options.sideBar === "object" && !!options.sideBar.open,
       (typeof options.sideBar === "object" ? options.sideBar.panels : void 0) ?? (options.pivot || options.pivotPanel ? ["columns", "filters", "pivot"] : void 0)
@@ -9870,11 +9973,23 @@ var Grid = class {
     this.renderer.render();
     this.api = this.createApi();
     liveGrids.set(this.renderer.root, this);
+    apiGrids.set(this.api, this);
+    void resolveGate(options.licenseKey);
   }
   /** Bumped whenever cell values change (edits, transactions, undo). */
   get valuesVersion() {
     return this.editVersion;
   }
+  /** Cell ranges are on: not switched off and paid features allowed. Closed behaves exactly like `rangeSelection: false`. */
+  rangesOn() {
+    return this.options.rangeSelection !== false && this.paid;
+  }
+  /** Whether a paid feature may run; warns once per feature when it may not. */
+  allow(feature) {
+    if (this.paid) return true;
+    paidBlocked(feature);
+    return false;
+  }
   /** The column definitions as given (setColumns), without the system columns. */
   columnDefs() {
     return [...this.sourceDefs];
@@ -9887,6 +10002,7 @@ var Grid = class {
       warn("setConditionalFormats: formats must be an array");
       return;
     }
+    if (list.length && !this.allow("conditional")) return;
     this.cfRules = list.filter((r) => r && typeof r === "object" && Array.isArray(r.columns)).map((r) => ({ ...r, columns: [...r.columns] }));
     this.renderer.invalidate({ rows: true });
     this.events.emit("conditionalFormatsChange", { formats: this.getConditionalFormats() });
@@ -9984,6 +10100,7 @@ var Grid = class {
     return out;
   }
   setPivot(cfg) {
+    if (cfg && !this.allow("pivot")) return;
     if (cfg && this.clientOnly("pivot")) return;
     if (cfg && (typeof cfg !== "object" || !Array.isArray(cfg.rows) || !Array.isArray(cfg.values))) {
       warn("setPivot: expected { rows: string[], values: [...] }");
@@ -10173,6 +10290,15 @@ var Grid = class {
     }
     const update = (r, k, row) => {
       const orig = this.tracker.originals.get(row);
+      if (r === row) {
+        for (const field of Object.keys(r)) {
+          if (orig) orig[field] = r[field];
+          changed.fields.add(field);
+        }
+        changed.ids.add(k);
+        result.updated.push(row);
+        return;
+      }
       for (const [field, value] of Object.entries(r)) {
         if (orig) orig[field] = value;
         const old = row[field];
@@ -10230,6 +10356,7 @@ var Grid = class {
   }
   setAdvancedFilter(filter) {
     const next = filter && typeof filter === "object" && Array.isArray(filter.conditions) && filter.conditions.length ? filter : null;
+    if (next && !this.allow("advancedFilter")) return;
     if (next === this.store.state.advancedFilter) return;
     this.store.set({ advancedFilter: next });
     this.events.emit("advancedFilterChange", { advancedFilter: next });
@@ -10441,6 +10568,7 @@ var Grid = class {
     return [...this.groupBy];
   }
   setGroupBy(ids) {
+    if (Array.isArray(ids) && ids.length && !this.allow(this.rowModel.server ? "serverGroups" : "grouping")) return;
     const next = this.validGroupBy(ids);
     if (next.join("
") === this.groupBy.join("
")) return;
     this.groupBy = next;
@@ -10726,6 +10854,7 @@ var Grid = class {
       warn("setSummary: summary.rows must be an array");
       return;
     }
+    if (opts && !this.allow("summary")) return;
     if (same2(opts, this.summarySnapshot)) {
       this.summaryOpts = opts;
       return;
@@ -10750,13 +10879,14 @@ var Grid = class {
     return this.columns.displayed().filter((c) => !isSystemCol(c.id));
   }
   validRange(range) {
-    if (!range || this.options.rangeSelection === false) return null;
+    if (!range || !this.rangesOn()) return null;
     const count = this.rowModel.getRowCount();
     const ok = (p) => !!p && !isSystemCol(p.colId) && !!this.columns.getColumn(p.colId) && p.rowIndex >= 0 && p.rowIndex < count;
     return ok(range.start) && ok(range.end) ? { start: { ...range.start }, end: { ...range.end } } : null;
   }
   /** Set the active range. Earlier Ctrl ranges are dropped unless `keepOthers`. */
   setRange(range, keepOthers = false) {
+    if (range && (range.start?.rowIndex !== range.end?.rowIndex || range.start?.colId !== range.end?.colId) && !this.allow("range")) return;
     const next = this.validRange(range);
     const extras = keepOthers || !this.store.state.extraRanges.length ? this.store.state.extraRanges : [];
     const cur = this.store.state.range;
@@ -10766,6 +10896,7 @@ var Grid = class {
   }
   /** Ctrl+click / Ctrl+drag: keep what is selected (the focused cell when there is no range) and start a new range. */
   addRange(range) {
+    if (!this.allow("range")) return;
     const { range: active, focus } = this.store.state;
     const keep = this.validRange(active ?? (focus ? { start: focus, end: focus } : null));
     if (keep) this.store.set({ extraRanges: [...this.store.state.extraRanges, keep] });
@@ -10777,6 +10908,7 @@ var Grid = class {
     return all2.map((r) => ({ start: { ...r.start }, end: { ...r.end } }));
   }
   setRanges(ranges) {
+    if (Array.isArray(ranges) && ranges.length && !this.allow("range")) return;
     const list = (Array.isArray(ranges) ? ranges : []).map((r) => this.validRange(r)).filter((r) => !!r);
     this.store.set({ extraRanges: list.slice(0, -1) });
     this.setRange(list[list.length - 1] ?? null, true);
@@ -10800,6 +10932,7 @@ var Grid = class {
     return !!col && this.allRangeBounds().some((b) => rangeContains(b, rowIndex, col.index));
   }
   selectAllCells() {
+    if (!this.allow("range")) return;
     const cols = this.dataColumns();
     const count = this.rowModel.getRowCount();
     if (!cols.length || !count) return;
@@ -10809,6 +10942,7 @@ var Grid = class {
   // ── clipboard ───────────────────────────────────────────────
   /** TSV for the range, else the focused cell; `rows` copies the checked rows instead. */
   selectionTSV(headers, rows = false) {
+    if (!rows && this.multiCell() && !this.allow("clipboard")) return "";
     const code = this.store.state.locale.code;
     const displayed = this.columns.displayed();
     const b = rows ? null : this.rangeBounds();
@@ -10850,6 +10984,11 @@ var Grid = class {
     if (headers) matrix.unshift(cols.map((c) => c.def.header ?? c.def.field ?? c.id));
     return toTSV(matrix);
   }
+  /** The selection covers more than one cell (several ranges, or one range wider than a cell). */
+  multiCell() {
+    const all2 = this.allRangeBounds();
+    return all2.length > 1 || all2.some((b) => b.r1 !== b.r2 || b.c1 !== b.c2);
+  }
   /** Like Excel: ranges stack when they share columns or rows; otherwise only the active one is copied. */
   rangesStack(all2) {
     return all2.length > 1 && (all2.every((x) => x.c1 === all2[0].c1 && x.c2 === all2[0].c2) || all2.every((x) => x.r1 === all2[0].r1 && x.r2 === all2[0].r2));
@@ -10900,6 +11039,7 @@ var Grid = class {
     const matrix = parseTSV(text2);
     const result = { changed: 0, skipped: 0 };
     if (!matrix.length) return result;
+    if ((matrix.length > 1 || matrix[0].length > 1) && !this.allow("clipboard")) return result;
     const displayed = this.columns.displayed();
     const count = this.rowModel.getRowCount();
     const b = this.rangeBounds();
@@ -11008,6 +11148,7 @@ var Grid = class {
   /** Merge blocks for every `merge` column over the displayed rows (memoized). */
   mergeSpans() {
     if (this.rowModel.server || !this.columns.displayed().some((c) => c.def.merge || c.def.rowSpan)) return NO_SPANS;
+    if (!this.allow("merge")) return NO_SPANS;
     const rows = this.rowModel.rows();
     const ver = this.editVersion * 1e6 + this.columns.displayed().length;
     if (this.spanCache && this.spanCache.rows === rows && this.spanCache.ver === ver) return this.spanCache.spans;
@@ -11022,7 +11163,7 @@ var Grid = class {
   }
   rangeAggregates() {
     const all2 = this.allRangeBounds();
-    if (!all2.length) return null;
+    if (!all2.length || !this.paid) return null;
     const displayed = this.columns.displayed();
     const key = [JSON.stringify(all2), this.rowModel.rows(), this.editVersion, ...displayed.map((c) => c.def)];
     const memo = this.aggMemo;
@@ -11061,6 +11202,7 @@ var Grid = class {
   }
   /** Fill from the current selection into `target`, Excel-style (one undo step). */
   fillRange(target) {
+    if (!this.allow("fill")) return;
     const src = this.rangeBounds() ?? (() => {
       const f = this.store.state.focus;
       const col = f && this.columns.getColumn(f.colId);
@@ -11109,30 +11251,31 @@ var Grid = class {
     this.renderer.invalidate({ rows: true });
   }
   // ── edits, change tracking, undo ────────────────────────────
-  /** Write one cell, record it for undo, and emit cellValueChanged. Returns false when unchanged. */
+  /** Write one cell and record it for undo; endCellTx emits cellValueChanged. Returns false when unchanged. */
   writeCell(changes, row, field, colId, rowIndex, value) {
     const oldValue = row[field];
     if (Object.is(oldValue, value)) return false;
     if (this.veto("beforeCellChange", { row, rowIndex, colId, oldValue, newValue: value })) return false;
     this.tracker.beforeChange(row);
     row[field] = value;
-    changes.push({ row, field, colId, oldValue, newValue: value });
-    this.events.emit("cellValueChanged", { row, rowIndex, colId, oldValue, newValue: value });
+    changes.push({ row, field, colId, rowIndex, oldValue, newValue: value });
     return true;
   }
-  /** Finish a batch of cell writes: one undo step, refresh summary and repaint. */
+  /** Finish a batch of cell writes: one undo step, refresh summary and repaint, then emit cellValueChanged. */
   endCellTx(changes) {
     if (!changes.length) return;
     const apply = (list, key) => {
-      for (const c of list) {
+      const done = list.map((c) => {
         const from = c.row[c.field];
         c.row[c.field] = c[key];
-        this.events.emit("cellValueChanged", { row: c.row, rowIndex: this.rowModel.indexOfId(this.rowModel.idOf(c.row)), colId: c.colId, oldValue: from, newValue: c[key] });
-      }
+        return { row: c.row, rowIndex: this.rowModel.indexOfId(this.rowModel.idOf(c.row)), colId: c.colId, oldValue: from, newValue: c[key] };
+      });
       this.afterDataEdit();
+      for (const e of done) this.events.emit("cellValueChanged", e);
     };
     this.history.push({ undo: () => apply([...changes].reverse(), "oldValue"), redo: () => apply(changes, "newValue") });
     this.afterDataEdit();
+    for (const c of changes) this.events.emit("cellValueChanged", { row: c.row, rowIndex: c.rowIndex, colId: c.colId, oldValue: c.oldValue, newValue: c.newValue });
   }
   afterDataEdit() {
     this.renderer.invalidateHeights();
@@ -11536,7 +11679,8 @@ var Grid = class {
     this.treeLoaded.clear();
     this.treeLoading.clear();
     this.renderer.dropDetail();
-    this.store.set({ data: cleanRows(rows) });
+    const clean = cleanRows(rows);
+    this.store.set({ data: clean === this.store.state.data ? [...clean] : clean });
     if (options?.scrollToTop) this.renderer.setScroll({ top: 0, left: 0 });
     const sel = this.store.state.selected;
     if (sel.size) {
@@ -11644,11 +11788,13 @@ var Grid = class {
         this.forcedOverlay = kind === "loading" || kind === "noRows" ? kind : null;
         this.renderer.invalidate();
       }),
-      getXlsxSheet: guard((o) => buildXlsxSheet(this, o)),
+      // closed: an empty sheet, so writeXlsx([api.getXlsxSheet()]) is not an Excel export
+      getXlsxSheet: guard((o) => this.allow("excel") ? buildXlsxSheet(this, o) : { name: o?.sheetName ?? "Sheet1", rows: [] }),
       print: guard((o) => printHtml(buildPrintHtml(this, o))),
       getPrintHtml: guard((o) => buildPrintHtml(this, o)),
-      getPdf: guard((o) => renderPdf(printModel(this, o), browserSurface, { scale: o?.resolution, quality: o?.quality })),
+      getPdf: guard((o) => this.allow("pdf") ? renderPdf(printModel(this, o), browserSurface, { scale: o?.resolution, quality: o?.quality }) : null),
       exportPdf: guard((name = "export.pdf", o) => {
+        if (!this.allow("pdf")) return;
         const bytes = renderPdf(printModel(this, o), browserSurface, { scale: o?.resolution, quality: o?.quality });
         if (bytes) download(name, [bytes], "application/pdf");
         else warn("exportPdf: this browser cannot draw on a canvas");
@@ -11656,16 +11802,26 @@ var Grid = class {
       setColumnGroupOpened: guard((id, open) => this.setColumnGroupOpened(id, open)),
       setAdvancedFilter: guard((f) => this.setAdvancedFilter(f)),
       getAdvancedFilter: guard(() => this.store.state.advancedFilter ? JSON.parse(JSON.stringify(this.store.state.advancedFilter)) : null),
-      openFilterBuilder: guard(() => this.filterBuilder.open()),
+      openFilterBuilder: guard(() => {
+        if (!this.allow("advancedFilter")) return;
+        this.filterBuilder.open();
+      }),
       isColumnGroupOpened: guard((id) => !!this.columns.getNode(id)?.open),
       applyTransaction: guard((tx) => this.applyTransaction(tx)),
       applyTransactionAsync: guard((tx) => this.applyTransactionAsync(tx)),
       flushAsyncTransactions: guard(() => this.flushAsyncTransactions()),
       setConditionalFormats: guard((f) => this.setConditionalFormats(f)),
       getConditionalFormats: guard(() => this.getConditionalFormats()),
-      openConditionalFormats: guard((colId) => this.formatDialog.open(colId)),
-      askAssistant: guard((prompt) => askAssistant(this, prompt, this.options.assistant)),
-      openAssistant: guard(() => this.assistantPanel.open()),
+      openConditionalFormats: guard((colId) => {
+        if (!this.allow("conditional")) return;
+        this.formatDialog.open(colId);
+      }),
+      // closed: as if `assistant` were not set
+      askAssistant: guard((prompt) => askAssistant(this, prompt, this.allow("assistant") ? this.options.assistant : void 0)),
+      openAssistant: guard(() => {
+        if (!this.allow("assistant")) return;
+        this.assistantPanel.open();
+      }),
       getState: guard(() => this.getState()),
       setState: guard((s, o) => this.setState(s, o)),
       getScrollPosition: guard(() => this.renderer.getScroll()),
@@ -11679,7 +11835,10 @@ var Grid = class {
       resetColumnState: guard(() => this.resetColumns()),
       openColumnChooser: guard(() => this.chooser.open()),
       closeColumnChooser: guard(() => this.chooser.close()),
-      toggleSideBar: guard((open, panel) => this.sideBar?.toggle(open, panel)),
+      toggleSideBar: guard((open, panel) => {
+        if (!this.allow("sideBar")) return;
+        this.sideBar?.toggle(open, panel);
+      }),
       setSummary: guard((s) => this.setSummary(s)),
       getSummaryValues: guard(() => this.summaryValues.map((v) => ({ ...v }))),
       getRange: guard(() => {
@@ -11709,7 +11868,7 @@ var Grid = class {
       canRedo: guard(() => this.history.canRedo()),
       fillRange: guard((t) => this.fillRange(t)),
       setPinnedRows: guard((r) => this.setPinnedRows(r)),
-      find: guard((text2) => this.finder.find(text2)),
+      find: guard((text2) => this.allow("find") ? this.finder.find(text2) : 0),
       findNext: guard(() => this.finder.next()),
       findPrevious: guard(() => this.finder.previous()),
       clearFind: guard(() => this.finder.clear()),
@@ -11730,13 +11889,17 @@ var Grid = class {
       refreshRows: guard(() => this.refreshRows()),
       setPivot: guard((p) => this.setPivot(p)),
       getPivot: guard(() => this.getPivot()),
-      createChart: guard((o) => this.charts.create(o)),
+      // closed: an inert handle whose methods do nothing
+      createChart: guard((o) => this.allow("charts") ? this.charts.create(o) : { el: el("div", "fg-chart-body"), setType: () => void 0, update: () => void 0, destroy: () => void 0 }),
       getCsv: guard((o) => buildCsv(this, o)),
       getJson: guard((o) => buildJson(this, o)),
       exportJson: guard((name = "export.json", o) => download(name, [buildJson(this, o)], "application/json;charset=utf-8")),
       exportCsv: guard((name = "export.csv", o) => download(name, ["\uFEFF", buildCsv(this, o)], "text/csv;charset=utf-8")),
-      getXlsx: guard((o) => buildXlsx(this, o)),
-      exportXlsx: guard((name = "export.xlsx", o) => download(name, [buildXlsx(this, o)], "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")),
+      getXlsx: guard((o) => this.allow("excel") ? buildXlsx(this, o) : new Uint8Array(0)),
+      exportXlsx: guard((name = "export.xlsx", o) => {
+        if (!this.allow("excel")) return;
+        download(name, [buildXlsx(this, o)], "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
+      }),
       importFile: guard((file, o) => importInto(this, file, o)),
       on: guard((type, fn) => this.events.on(type, fn)),
       destroy: () => this.destroy()
@@ -11764,10 +11927,13 @@ function buildWorkbook(sheets) {
     warn("buildWorkbook: no grids given; the file has one empty sheet");
     return writeXlsx([{ name: "Sheet1", rows: [] }]);
   }
+  if (list.some((s) => gridOfApi(s.grid)?.allow("workbook") === false)) return new Uint8Array(0);
   return writeXlsx(list.map((s, i) => s.grid.getXlsxSheet({ ...s.options, sheetName: s.sheetName ?? s.options?.sheetName ?? `Sheet${i + 1}` })));
 }
 function exportWorkbook(filename, sheets) {
-  download(filename || "export.xlsx", [buildWorkbook(sheets)], "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
+  const bytes = buildWorkbook(sheets);
+  if (!bytes.length) return;
+  download(filename || "export.xlsx", [bytes], "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
 }
 
 // src/rest.ts