@freegridjs/core 1.1.0 → 1.6.0

package/dist/index.js

@@ -331,6 +331,8 @@ var FormulaError = class extends Error {
     this.code = code;
   }
 };
+var ERROR_RE = /^#[A-Z/0]+[!?]$/;
+var isFormulaError = (v) => typeof v === "string" && ERROR_RE.test(v);
 function tokenize(src) {
   const out = [];
   let i = 0;
@@ -366,7 +368,7 @@ function tokenize(src) {
       out.push({ t: "id", v: src.slice(i + 1, end) });
       i = end + 1;
     } else if (/[A-Za-z_À-￿]/.test(c)) {
-      const m = /^[A-Za-z_À-￿][\wÀ-￿]*/.exec(src.slice(i));
+      const m = /^[A-Za-z_À-￿][\wÀ-￿.]*/.exec(src.slice(i));
       out.push({ t: "id", v: m[0] });
       i += m[0].length;
     } else {
@@ -374,8 +376,8 @@ function tokenize(src) {
       if (two === "<>" || two === "<=" || two === ">=") {
         out.push({ t: "op", v: two });
         i += 2;
-      } else if ("+-*/%^&=<>(),".includes(c)) {
-        out.push({ t: "op", v: c });
+      } else if ("+-*/%^&=<>(),;".includes(c)) {
+        out.push({ t: "op", v: c === ";" ? "," : c });
         i++;
       } else throw new FormulaError("#ERROR!");
     }
@@ -387,35 +389,271 @@ function num(v) {
   if (typeof v === "number") return v;
   if (typeof v === "boolean") return v ? 1 : 0;
   if (isBlankValue(v)) return 0;
+  if (v instanceof Date) return v.getTime();
   if (typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v))) return Number(v);
   throw new FormulaError("#VALUE!");
 }
-var text = (v) => isBlankValue(v) ? "" : typeof v === "boolean" ? v ? "TRUE" : "FALSE" : String(v);
-function round(x, digits) {
+var text = (v) => isBlankValue(v) ? "" : typeof v === "boolean" ? v ? "TRUE" : "FALSE" : v instanceof Date ? ymd(v) : String(v);
+var bool = (v) => typeof v === "boolean" ? v : typeof v === "string" && /^(true|false)$/i.test(v) ? v.toLowerCase() === "true" : num(v) !== 0;
+function round(x, digits, mode = "near") {
   const d = Math.trunc(digits);
-  const r = Number(`${Math.round(Number(`${Math.abs(x)}e${d}`))}e${-d}`);
+  const f = mode === "near" ? Math.round : mode === "up" ? Math.ceil : Math.floor;
+  const r = Number(`${f(Number(`${Math.abs(x)}e${d}`))}e${-d}`);
   return x < 0 ? -r : r;
 }
+function compare(a, b) {
+  const numeric = (v) => typeof v === "number" || typeof v === "boolean" || isBlankValue(v);
+  if (numeric(a) && numeric(b)) return num(a) - num(b);
+  if (a instanceof Date || b instanceof Date) return num(toDate(a)) - num(toDate(b));
+  return text(a).localeCompare(text(b), void 0, { sensitivity: "accent" });
+}
+var flat = (a) => a.flatMap((v) => Array.isArray(v) ? v : [v]);
+var numsLoose = (a) => a.flatMap((v) => Array.isArray(v) ? noErrors(v).filter((x) => typeof x === "number" && Number.isFinite(x)) : isBlankValue(v) ? [] : [num(v)]);
+function noErrors(list) {
+  const bad = list.find(isFormulaError);
+  if (bad !== void 0) throw new FormulaError(bad);
+  return list;
+}
+function toDate(v) {
+  if (v instanceof Date) return v;
+  if (typeof v === "number") return new Date(v);
+  if (typeof v === "string") {
+    const m = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2}))?)?/.exec(v.trim());
+    if (m) return new Date(+m[1], +m[2] - 1, +m[3], +(m[4] ?? 0), +(m[5] ?? 0), +(m[6] ?? 0));
+  }
+  throw new FormulaError("#VALUE!");
+}
+var pad = (n) => String(n).padStart(2, "0");
+function ymd(d) {
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+var DAY = 864e5;
+var dayNumber = (d) => Math.round(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()) / DAY);
+function criteria(c) {
+  if (typeof c !== "string") return (v) => compare(v, c) === 0 && !isBlankValue(v) === !isBlankValue(c);
+  const m = /^(<=|>=|<>|<|>|=)?(.*)$/s.exec(c);
+  const op = m[1] ?? "=";
+  const raw = m[2];
+  const target = raw.trim() !== "" && Number.isFinite(Number(raw)) ? Number(raw) : raw;
+  if ((op === "=" || op === "<>") && typeof target === "string" && /[*?]/.test(target)) {
+    const re = new RegExp(`^${target.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".")}$`, "i");
+    return op === "=" ? (v) => re.test(text(v)) : (v) => !re.test(text(v));
+  }
+  return (v) => {
+    if (op === "=" && target === "") return isBlankValue(v);
+    if (op === "<>" && target === "") return !isBlankValue(v);
+    if (typeof target === "number" && (typeof v !== "number" && !(typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v))))) return op === "<>";
+    let r;
+    try {
+      r = compare(v, target);
+    } catch {
+      return false;
+    }
+    return op === "=" ? r === 0 : op === "<>" ? r !== 0 : op === "<" ? r < 0 : op === ">" ? r > 0 : op === "<=" ? r <= 0 : r >= 0;
+  };
+}
+function arr(v) {
+  if (Array.isArray(v)) return v;
+  throw new FormulaError("#VALUE!");
+}
+function ifs(a, test, crit) {
+  const t = arr(test), keep = criteria(crit);
+  const out = [];
+  const vals = noErrors(a.length ? arr(a[0]) : t);
+  t.forEach((v, i) => {
+    const x = vals[i];
+    if (keep(v) && typeof x === "number" && Number.isFinite(x)) out.push(x);
+  });
+  return out;
+}
 var FUNCS = {
+  // math
+  SUM: (a) => numsLoose(a).reduce((s, v) => s + v, 0),
+  AVG: (a) => {
+    const n = numsLoose(a);
+    if (!n.length) throw new FormulaError("#DIV/0!");
+    return n.reduce((s, v) => s + v, 0) / n.length;
+  },
+  MIN: (a) => {
+    const n = numsLoose(a);
+    return n.length ? Math.min(...n) : 0;
+  },
+  MAX: (a) => {
+    const n = numsLoose(a);
+    return n.length ? Math.max(...n) : 0;
+  },
+  MEDIAN: (a) => {
+    const n = numsLoose(a).sort((x, y) => x - y);
+    if (!n.length) throw new FormulaError("#NUM!");
+    const m = n.length >> 1;
+    return n.length % 2 ? n[m] : (n[m - 1] + n[m]) / 2;
+  },
+  COUNT: (a) => flat(a).filter((v) => typeof v === "number" && Number.isFinite(v)).length,
+  COUNTA: (a) => flat(a).filter((v) => !isBlankValue(v)).length,
+  COUNTBLANK: (a) => flat(a).filter(isBlankValue).length,
+  PRODUCT: (a) => numsLoose(a).reduce((s, v) => s * v, 1),
   ROUND: (a) => round(num(a[0]), a.length > 1 ? num(a[1]) : 0),
+  ROUNDUP: (a) => round(num(a[0]), a.length > 1 ? num(a[1]) : 0, "up"),
+  ROUNDDOWN: (a) => round(num(a[0]), a.length > 1 ? num(a[1]) : 0, "down"),
+  INT: (a) => Math.floor(num(a[0])),
+  TRUNC: (a) => round(num(a[0]), a.length > 1 ? num(a[1]) : 0, num(a[0]) < 0 ? "up" : "down"),
   ABS: (a) => Math.abs(num(a[0])),
-  MIN: (a) => a.length ? Math.min(...a.map(num)) : 0,
-  MAX: (a) => a.length ? Math.max(...a.map(num)) : 0,
-  SUM: (a) => a.reduce((s, v) => s + num(v), 0),
-  AVG: (a) => {
-    if (!a.length) throw new FormulaError("#DIV/0!");
-    return a.reduce((s, v) => s + num(v), 0) / a.length;
+  SIGN: (a) => Math.sign(num(a[0])),
+  SQRT: (a) => {
+    const x = num(a[0]);
+    if (x < 0) throw new FormulaError("#NUM!");
+    return Math.sqrt(x);
+  },
+  POWER: (a) => num(a[0]) ** num(a[1]),
+  EXP: (a) => Math.exp(num(a[0])),
+  LN: (a) => {
+    const x = num(a[0]);
+    if (x <= 0) throw new FormulaError("#NUM!");
+    return Math.log(x);
+  },
+  LOG10: (a) => {
+    const x = num(a[0]);
+    if (x <= 0) throw new FormulaError("#NUM!");
+    return Math.log10(x);
+  },
+  MOD: (a) => {
+    const d = num(a[1]);
+    if (d === 0) throw new FormulaError("#DIV/0!");
+    const x = num(a[0]);
+    return x - d * Math.floor(x / d);
+  },
+  CEILING: (a) => {
+    const s = a.length > 1 ? num(a[1]) : 1;
+    return s === 0 ? 0 : Math.ceil(num(a[0]) / s) * s;
+  },
+  FLOOR: (a) => {
+    const s = a.length > 1 ? num(a[1]) : 1;
+    return s === 0 ? 0 : Math.floor(num(a[0]) / s) * s;
+  },
+  PI: () => Math.PI,
+  // text
+  CONCAT: (a) => flat(a).map(text).join(""),
+  TEXTJOIN: (a) => flat(a.slice(2)).filter((v) => !bool(a[1]) || !isBlankValue(v)).map(text).join(text(a[0])),
+  LEN: (a) => text(a[0]).length,
+  LEFT: (a) => text(a[0]).slice(0, a.length > 1 ? Math.max(0, num(a[1])) : 1),
+  RIGHT: (a) => {
+    const s = text(a[0]);
+    const n = a.length > 1 ? Math.max(0, num(a[1])) : 1;
+    return n ? s.slice(-n) : "";
+  },
+  MID: (a) => text(a[0]).substr(Math.max(0, num(a[1]) - 1), Math.max(0, num(a[2]))),
+  UPPER: (a) => text(a[0]).toUpperCase(),
+  LOWER: (a) => text(a[0]).toLowerCase(),
+  PROPER: (a) => text(a[0]).toLowerCase().replace(/(^|[^\p{L}])(\p{L})/gu, (_, p, c) => p + c.toUpperCase()),
+  TRIM: (a) => text(a[0]).trim().replace(/\s+/g, " "),
+  SUBSTITUTE: (a) => text(a[0]).split(text(a[1])).join(text(a[2])),
+  REPLACE: (a) => {
+    const s = text(a[0]);
+    const at = Math.max(0, num(a[1]) - 1);
+    return s.slice(0, at) + text(a[3]) + s.slice(at + Math.max(0, num(a[2])));
+  },
+  REPT: (a) => text(a[0]).repeat(Math.max(0, Math.min(1e4, num(a[1])))),
+  FIND: (a) => {
+    const i = text(a[1]).indexOf(text(a[0]), a.length > 2 ? num(a[2]) - 1 : 0);
+    if (i < 0) throw new FormulaError("#VALUE!");
+    return i + 1;
+  },
+  SEARCH: (a) => {
+    const i = text(a[1]).toLowerCase().indexOf(text(a[0]).toLowerCase(), a.length > 2 ? num(a[2]) - 1 : 0);
+    if (i < 0) throw new FormulaError("#VALUE!");
+    return i + 1;
+  },
+  VALUE: (a) => num(text(a[0]).replace(/,/g, "")),
+  TEXT: (a) => {
+    const v = a[0], f = text(a[1]);
+    const dec = /0\.(0+)/.exec(f)?.[1].length ?? 0;
+    if (/[yd]/i.test(f)) {
+      const d = toDate(v);
+      return f.replace(/yyyy/gi, String(d.getFullYear())).replace(/mm/g, pad(d.getMonth() + 1)).replace(/dd/gi, pad(d.getDate()));
+    }
+    const n = num(v);
+    const s = f.includes("%") ? (n * 100).toFixed(dec) + "%" : f.includes(",") ? n.toLocaleString("en-US", { minimumFractionDigits: dec, maximumFractionDigits: dec }) : n.toFixed(dec);
+    return s;
+  },
+  // logic and types
+  AND: (a) => flat(a).every(bool),
+  OR: (a) => flat(a).some(bool),
+  XOR: (a) => flat(a).filter(bool).length % 2 === 1,
+  NOT: (a) => !bool(a[0]),
+  ISBLANK: (a) => isBlankValue(a[0]),
+  ISNUMBER: (a) => typeof a[0] === "number" && Number.isFinite(a[0]),
+  ISTEXT: (a) => typeof a[0] === "string" && !isFormulaError(a[0]),
+  ISERROR: (a) => isFormulaError(a[0]),
+  // dates (as "YYYY-MM-DD" text, like date columns)
+  TODAY: () => ymd(/* @__PURE__ */ new Date()),
+  NOW: () => /* @__PURE__ */ new Date(),
+  DATE: (a) => ymd(new Date(num(a[0]), num(a[1]) - 1, num(a[2]))),
+  YEAR: (a) => toDate(a[0]).getFullYear(),
+  MONTH: (a) => toDate(a[0]).getMonth() + 1,
+  DAY: (a) => toDate(a[0]).getDate(),
+  WEEKDAY: (a) => toDate(a[0]).getDay() + 1,
+  DAYS: (a) => dayNumber(toDate(a[0])) - dayNumber(toDate(a[1])),
+  EDATE: (a) => {
+    const d = toDate(a[0]);
+    const day = d.getDate();
+    const r = new Date(d.getFullYear(), d.getMonth() + num(a[1]), 1);
+    r.setDate(Math.min(day, new Date(r.getFullYear(), r.getMonth() + 1, 0).getDate()));
+    return ymd(r);
+  },
+  EOMONTH: (a) => {
+    const d = toDate(a[0]);
+    return ymd(new Date(d.getFullYear(), d.getMonth() + num(a[1]) + 1, 0));
+  },
+  // over columns
+  SUMIF: (a) => ifs(a.slice(2), arr(a[0]), a[1]).reduce((s, v) => s + v, 0),
+  COUNTIF: (a) => {
+    const keep = criteria(a[1]);
+    return arr(a[0]).filter(keep).length;
+  },
+  AVERAGEIF: (a) => {
+    const n = ifs(a.slice(2), arr(a[0]), a[1]);
+    if (!n.length) throw new FormulaError("#DIV/0!");
+    return n.reduce((s, v) => s + v, 0) / n.length;
+  },
+  LOOKUP: (a) => {
+    const keys = arr(a[1]), vals = a.length > 2 ? arr(a[2]) : keys;
+    const i = keys.findIndex((k) => {
+      try {
+        return compare(k, a[0]) === 0;
+      } catch {
+        return false;
+      }
+    });
+    if (i < 0) {
+      if (a.length > 3) return a[3];
+      throw new FormulaError("#N/A");
+    }
+    return vals[i];
+  },
+  RANK: (a) => {
+    const v = num(a[0]);
+    const list = numsLoose([arr(a[1])]);
+    const asc = a.length > 2 && bool(a[2]);
+    return 1 + list.filter((x) => asc ? x < v : x > v).length;
   }
 };
-function compare(a, b) {
-  const bothNum = (typeof a === "number" || isBlankValue(a)) && (typeof b === "number" || isBlankValue(b));
-  if (bothNum) return num(a) - num(b);
-  return text(a).localeCompare(text(b), void 0, { sensitivity: "accent" });
-}
+FUNCS.AVERAGE = FUNCS.AVG;
+FUNCS.XLOOKUP = FUNCS.LOOKUP;
+FUNCS.CONCATENATE = FUNCS.CONCAT;
+var custom = /* @__PURE__ */ new Map();
+function registerFormulaFunction(name, fn) {
+  if (typeof name !== "string" || !/^[A-Za-z_][\w.]*$/.test(name) || typeof fn !== "function") return;
+  custom.set(name.toUpperCase(), fn);
+  compiled.clear();
+}
+function formulaFunctions() {
+  return [.../* @__PURE__ */ new Set([...Object.keys(FUNCS), ...LAZY, ...SPECIAL, ...custom.keys()])].sort();
+}
+var LAZY = ["IF", "IFS", "IFERROR", "IFNA", "SWITCH", "CHOOSE"];
+var SPECIAL = ["COL", "PREV", "NEXT", "ROW"];
 var Parser = class {
-  constructor(tokens, resolve) {
+  constructor(tokens) {
     this.tokens = tokens;
-    this.resolve = resolve;
     this.i = 0;
   }
   parse() {
@@ -435,52 +673,46 @@ var Parser = class {
   comparison() {
     const a = this.concat();
     for (const op of ["=", "<>", "<=", ">=", "<", ">"]) {
-      if (this.take(op)) {
-        const c = compare(a, this.concat());
-        return op === "=" ? c === 0 : op === "<>" ? c !== 0 : op === "<" ? c < 0 : op === ">" ? c > 0 : op === "<=" ? c <= 0 : c >= 0;
-      }
+      if (this.take(op)) return { k: "bin", op, a, b: this.concat() };
     }
     return a;
   }
   concat() {
     let v = this.additive();
-    while (this.take("&")) v = text(v) + text(this.additive());
+    while (this.take("&")) v = { k: "bin", op: "&", a: v, b: this.additive() };
     return v;
   }
   additive() {
     let v = this.multiplicative();
     for (; ; ) {
-      if (this.take("+")) v = num(v) + num(this.multiplicative());
-      else if (this.take("-")) v = num(v) - num(this.multiplicative());
+      if (this.take("+")) v = { k: "bin", op: "+", a: v, b: this.multiplicative() };
+      else if (this.take("-")) v = { k: "bin", op: "-", a: v, b: this.multiplicative() };
       else return v;
     }
   }
   multiplicative() {
     let v = this.unary();
     for (; ; ) {
-      if (this.take("*")) v = num(v) * num(this.unary());
-      else if (this.take("/") || this.take("%")) {
-        const op = this.tokens[this.i - 1].v;
-        const d = num(this.unary());
-        if (d === 0) throw new FormulaError("#DIV/0!");
-        v = op === "/" ? num(v) / d : num(v) % d;
-      } else return v;
+      if (this.take("*")) v = { k: "bin", op: "*", a: v, b: this.unary() };
+      else if (this.take("/")) v = { k: "bin", op: "/", a: v, b: this.unary() };
+      else if (this.take("%")) v = { k: "bin", op: "%", a: v, b: this.unary() };
+      else return v;
     }
   }
   unary() {
-    if (this.take("-")) return -num(this.unary());
-    if (this.take("+")) return num(this.unary());
+    if (this.take("-")) return { k: "un", op: "-", a: this.unary() };
+    if (this.take("+")) return { k: "un", op: "+", a: this.unary() };
     return this.power();
   }
   power() {
     const base = this.primary();
-    if (this.take("^")) return num(base) ** num(this.unary());
+    if (this.take("^")) return { k: "bin", op: "^", a: base, b: this.unary() };
     return base;
   }
   primary() {
     const t = this.tokens[this.i++];
     if (!t) throw new FormulaError("#ERROR!");
-    if (t.t === "num" || t.t === "str") return t.v;
+    if (t.t === "num" || t.t === "str") return { k: "lit", v: t.v };
     if (t.t === "op") {
       if (t.v !== "(") throw new FormulaError("#ERROR!");
       const v = this.comparison();
@@ -498,46 +730,296 @@ var Parser = class {
         if (!this.take(")")) throw new FormulaError("#ERROR!");
       }
       const upper = name.toUpperCase();
-      if (upper === "IF") {
-        if (args.length < 2) throw new FormulaError("#ERROR!");
-        const cond = typeof args[0] === "boolean" ? args[0] : num(args[0]) !== 0;
-        return cond ? args[1] : args.length > 2 ? args[2] : false;
+      if (upper === "COL" || upper === "PREV" || upper === "NEXT") {
+        if (!args.length || args[0].k !== "ref") throw new FormulaError("#ERROR!");
       }
-      const fn = Object.hasOwn(FUNCS, upper) ? FUNCS[upper] : void 0;
-      if (!fn) throw new FormulaError("#NAME?");
-      return fn(args);
+      const rowFree = upper !== "PREV" && upper !== "NEXT" && upper !== "ROW" && args.every((a) => isRowFree(a, upper === "COL"));
+      return { k: "call", name: upper, args, rowFree };
     }
-    if (/^(true|false)$/i.test(name)) return name.toLowerCase() === "true";
-    return this.resolve(name);
+    if (/^(true|false)$/i.test(name)) return { k: "lit", v: name.toLowerCase() === "true" };
+    return { k: "ref", name };
   }
 };
+function isRowFree(n, inCol = false) {
+  if (n.k === "lit") return true;
+  if (n.k === "ref") return inCol;
+  if (n.k === "un") return isRowFree(n.a);
+  if (n.k === "bin") return isRowFree(n.a) && isRowFree(n.b);
+  return n.rowFree;
+}
+var compiled = /* @__PURE__ */ new Map();
+var MAX_COMPILED = 2e3;
+function compile(formula) {
+  let n = compiled.get(formula);
+  if (!n) {
+    try {
+      n = new Parser(tokenize(formula.slice(1))).parse();
+    } catch (e) {
+      n = e instanceof FormulaError ? e : new FormulaError("#ERROR!");
+    }
+    if (compiled.size >= MAX_COMPILED) compiled.delete(compiled.keys().next().value);
+    compiled.set(formula, n);
+  }
+  if (n instanceof FormulaError) throw n;
+  return n;
+}
+var caches = /* @__PURE__ */ new WeakMap();
+function cacheOf(scope) {
+  const data = scope.rows();
+  const version2 = scope.version();
+  let c = caches.get(scope);
+  if (!c || c.data !== data || c.version !== version2) {
+    c = { data, version: version2, index: null, cols: /* @__PURE__ */ new Map(), values: /* @__PURE__ */ new WeakMap(), rowFree: /* @__PURE__ */ new Map(), filled: /* @__PURE__ */ new Map() };
+    caches.set(scope, c);
+  }
+  return c;
+}
+var scopes = /* @__PURE__ */ new WeakMap();
+function setFormulaScope(defs, scope) {
+  for (const d of defs) if (d && typeof d === "object") scopes.set(d, scope);
+}
 var MAX_DEPTH = 32;
-function evaluateFormula(formula, row, seen2 = /* @__PURE__ */ new Set(), depth = 0, memo = /* @__PURE__ */ new Map()) {
+function cellOf(ctx, name) {
+  const { row, scope } = ctx;
+  if (row && Object.hasOwn(row, name)) {
+    const v = row[name];
+    if (typeof v === "string" && v.startsWith("=") && v.length > 1) return formulaOf(ctx, name, v);
+    return v;
+  }
+  const f = scope?.computed(name);
+  if (f !== void 0) return formulaOf(ctx, name, f);
+  throw new FormulaError("#REF!");
+}
+function formulaOf(ctx, name, formula) {
+  if (ctx.seen.has(name) || ctx.depth >= MAX_DEPTH) throw new FormulaError("#CYCLE!");
+  let r;
+  if (ctx.memo.has(name)) r = ctx.memo.get(name);
+  else {
+    const shared = ctx.scope ? cacheOf(ctx.scope).values.get(ctx.row) : void 0;
+    if (shared?.has(name)) r = shared.get(name);
+    else {
+      r = run(formula, { ...ctx, seen: /* @__PURE__ */ new Set([...ctx.seen, name]), depth: ctx.depth + 1 });
+      ctx.memo.set(name, r);
+    }
+  }
+  if (isFormulaError(r)) throw new FormulaError(r);
+  return r;
+}
+function cellAt(ctx, index, name) {
+  const scope = ctx.scope;
+  if (!scope) throw new FormulaError("#REF!");
+  const c = cacheOf(scope);
+  if (index < 0 || index >= c.data.length) return null;
+  const row = c.data[index];
+  const done = c.filled.get(name) ?? -1;
+  if (index > done + 1 && index - done > 1) {
+    for (let k = done + 1; k < index; k++) valueIn(scope, c, c.data[k], name);
+  }
+  const v = valueIn(scope, c, row, name);
+  if (index > (c.filled.get(name) ?? -1)) c.filled.set(name, index);
+  if (isFormulaError(v)) throw new FormulaError(v);
+  return v;
+}
+function valueIn(scope, c, row, name) {
+  let m = c.values.get(row);
+  if (m?.has(name)) return m.get(name);
+  let v;
   try {
-    const resolve = (name) => {
-      if (!row || !Object.hasOwn(row, name)) throw new FormulaError("#REF!");
-      const v2 = row[name];
-      if (typeof v2 === "string" && v2.startsWith("=")) {
-        if (seen2.has(name) || depth >= MAX_DEPTH) throw new FormulaError("#CYCLE!");
-        let r;
-        if (memo.has(name)) r = memo.get(name);
-        else {
-          r = evaluateFormula(v2, row, /* @__PURE__ */ new Set([...seen2, name]), depth + 1, memo);
-          memo.set(name, r);
+    v = cellOf({ row, scope, seen: /* @__PURE__ */ new Set(), depth: 0, memo: /* @__PURE__ */ new Map() }, name);
+  } catch (e) {
+    v = e instanceof FormulaError ? e.code : "#ERROR!";
+  }
+  if (!m) c.values.set(row, m = /* @__PURE__ */ new Map());
+  m.set(name, v);
+  return v;
+}
+function indexOf(ctx) {
+  if (!ctx.scope) throw new FormulaError("#REF!");
+  const c = cacheOf(ctx.scope);
+  if (!c.index) c.index = new Map(c.data.map((r, i2) => [r, i2]));
+  const i = c.index.get(ctx.row);
+  if (i === void 0) throw new FormulaError("#REF!");
+  return i;
+}
+function column(ctx, name) {
+  if (!ctx.scope) throw new FormulaError("#REF!");
+  const scope = ctx.scope;
+  const c = cacheOf(scope);
+  let col = c.cols.get(name);
+  if (!col) {
+    c.cols.set(name, CYCLE);
+    col = c.data.map((r) => valueIn(scope, c, r, name));
+    c.cols.set(name, col);
+  }
+  if (col === CYCLE) throw new FormulaError("#CYCLE!");
+  return col;
+}
+var CYCLE = [];
+function evaluate(n, ctx) {
+  switch (n.k) {
+    case "lit":
+      return n.v;
+    case "ref":
+      return cellOf(ctx, n.name);
+    case "un":
+      return n.op === "-" ? -num(evaluate(n.a, ctx)) : num(evaluate(n.a, ctx));
+    case "bin": {
+      const a = evaluate(n.a, ctx), b = evaluate(n.b, ctx);
+      switch (n.op) {
+        case "+":
+          return num(a) + num(b);
+        case "-":
+          return num(a) - num(b);
+        case "*":
+          return num(a) * num(b);
+        case "/":
+        case "%": {
+          const d = num(b);
+          if (d === 0) throw new FormulaError("#DIV/0!");
+          return n.op === "/" ? num(a) / d : num(a) % d;
+        }
+        case "^":
+          return num(a) ** num(b);
+        case "&":
+          return text(a) + text(b);
+        default: {
+          const c = compare(a, b);
+          return n.op === "=" ? c === 0 : n.op === "<>" ? c !== 0 : n.op === "<" ? c < 0 : n.op === ">" ? c > 0 : n.op === "<=" ? c <= 0 : c >= 0;
         }
-        if (typeof r === "string" && /^#[A-Z/0]+[!?]$/.test(r)) throw new FormulaError(r);
-        return r;
       }
-      return v2;
-    };
-    const v = new Parser(tokenize(formula.slice(1)), resolve).parse();
+    }
+    case "call": {
+      if (n.rowFree && ctx.scope) {
+        const c = cacheOf(ctx.scope);
+        if (c.rowFree.has(n)) {
+          const v = c.rowFree.get(n);
+          if (v instanceof FormulaError) throw v;
+          return v;
+        }
+        try {
+          const v = call(n, ctx);
+          c.rowFree.set(n, v);
+          return v;
+        } catch (e) {
+          if (e instanceof FormulaError) c.rowFree.set(n, e);
+          throw e;
+        }
+      }
+      return call(n, ctx);
+    }
+  }
+}
+function call(n, ctx) {
+  const { name, args } = n;
+  const ev = (i) => evaluate(args[i], ctx);
+  switch (name) {
+    case "IF": {
+      if (args.length < 2) throw new FormulaError("#ERROR!");
+      return bool(ev(0)) ? ev(1) : args.length > 2 ? ev(2) : false;
+    }
+    case "IFS":
+      for (let i = 0; i + 1 < args.length; i += 2) if (bool(ev(i))) return ev(i + 1);
+      throw new FormulaError("#N/A");
+    case "IFERROR":
+    case "IFNA": {
+      try {
+        const v = ev(0);
+        if (isFormulaError(v) && (name === "IFERROR" || v === "#N/A")) return args.length > 1 ? ev(1) : "";
+        return v;
+      } catch (e) {
+        if (!(e instanceof FormulaError) || name === "IFNA" && e.code !== "#N/A") throw e;
+        return args.length > 1 ? ev(1) : "";
+      }
+    }
+    case "SWITCH": {
+      const v = ev(0);
+      for (let i = 1; i + 1 < args.length; i += 2) if (compare(v, ev(i)) === 0) return ev(i + 1);
+      if (args.length % 2 === 0) return ev(args.length - 1);
+      throw new FormulaError("#N/A");
+    }
+    case "CHOOSE": {
+      const i = Math.trunc(num(ev(0)));
+      if (i < 1 || i >= args.length) throw new FormulaError("#VALUE!");
+      return ev(i);
+    }
+    case "COL":
+      return column(ctx, args[0].name);
+    case "ROW":
+      return indexOf(ctx) + 1;
+    case "PREV":
+    case "NEXT": {
+      const step = args.length > 1 ? Math.trunc(num(ev(1))) : 1;
+      const at = indexOf(ctx) + (name === "PREV" ? -step : step);
+      const fieldName = args[0].name;
+      if (name === "NEXT" && ctx.depth >= MAX_DEPTH) throw new FormulaError("#CYCLE!");
+      return name === "PREV" ? cellAt(ctx, at, fieldName) : nextCell(ctx, at, fieldName);
+    }
+  }
+  const fn = (Object.hasOwn(FUNCS, name) ? FUNCS[name] : void 0) ?? custom.get(name);
+  if (!fn) throw new FormulaError("#NAME?");
+  const values = args.map((_, i) => ev(i));
+  if (custom.has(name) && !Object.hasOwn(FUNCS, name)) {
+    try {
+      return fn(values);
+    } catch (e) {
+      throw e instanceof FormulaError ? e : new FormulaError("#VALUE!");
+    }
+  }
+  return fn(values);
+}
+function nextCell(ctx, index, name) {
+  const c = ctx.scope ? cacheOf(ctx.scope) : null;
+  if (!c) throw new FormulaError("#REF!");
+  if (index < 0 || index >= c.data.length) return null;
+  return cellOf({ ...ctx, row: c.data[index], seen: /* @__PURE__ */ new Set(), depth: ctx.depth + 1, memo: /* @__PURE__ */ new Map() }, name);
+}
+function run(formula, ctx) {
+  try {
+    const v = evaluate(compile(formula), ctx);
     if (typeof v === "number" && !Number.isFinite(v)) return "#NUM!";
+    if (Array.isArray(v)) return "#VALUE!";
     return v;
   } catch (e) {
+    if (e instanceof RangeError) return "#CYCLE!";
     return e instanceof FormulaError ? e.code : "#ERROR!";
   }
 }
+function evaluateFormula(formula, row, seen2 = /* @__PURE__ */ new Set(), depth = 0, memo = /* @__PURE__ */ new Map(), scope = null) {
+  return run(formula, { row, scope, seen: seen2, depth, memo });
+}
+function columnFormulaValue(def, row) {
+  const scope = scopes.get(def) ?? null;
+  const id = def.id ?? def.field;
+  if (def.formula) {
+    if (scope && id) {
+      const c = cacheOf(scope);
+      return valueIn(scope, c, row, id);
+    }
+    return run(def.formula, { row, scope, seen: new Set(id ? [id] : []), depth: 0, memo: /* @__PURE__ */ new Map() });
+  }
+  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 isFormula = (v) => typeof v === "string" && v.length > 1 && v.startsWith("=");
+function formulaRefs(formula) {
+  let n;
+  try {
+    n = compile(formula);
+  } catch {
+    return null;
+  }
+  const out = /* @__PURE__ */ new Set();
+  const walk = (x) => {
+    if (x.k === "ref") out.add(x.name);
+    else if (x.k === "un") walk(x.a);
+    else if (x.k === "bin") {
+      walk(x.a);
+      walk(x.b);
+    } else if (x.k === "call") x.args.forEach(walk);
+  };
+  walk(n);
+  return [...out];
+}
 
 // src/rows/values.ts
 function getCellValue(def, row) {
@@ -549,9 +1031,10 @@ function getCellValue(def, row) {
       return void 0;
     }
   }
+  if (typeof def.formula === "string" && isFormula(def.formula)) return columnFormulaValue(def, row);
   if (def.field == null) return void 0;
   const raw = row[def.field];
-  return def.formulas && isFormula(raw) ? evaluateFormula(raw, row, /* @__PURE__ */ new Set([def.field])) : raw;
+  return def.formulas && isFormula(raw) ? columnFormulaValue(def, row) : raw;
 }
 
 // src/interactions/filterRow.ts
@@ -764,13 +1247,13 @@ var FilterRow = class {
 function isBlank(v) {
   return v == null || typeof v === "string" && v.trim() === "" || typeof v === "number" && Number.isNaN(v);
 }
-var pad = (n) => String(n).padStart(2, "0");
+var pad2 = (n) => String(n).padStart(2, "0");
 function toDateKey2(v) {
   if (isBlank(v)) return null;
   if (typeof v === "string" && /^\d{4}-\d{2}-\d{2}$/.test(v)) return v;
   const d = v instanceof Date ? v : new Date(v);
   if (Number.isNaN(d.getTime())) return null;
-  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
 }
 function setKey(v) {
   if (isBlank(v)) return "";
@@ -925,7 +1408,7 @@ var DATE_PRESETS = {
   medium: { dateStyle: "medium" },
   long: { dateStyle: "long" }
 };
-function toDate(v) {
+function toDate2(v) {
   if (isBlank(v)) return null;
   if (v instanceof Date) return Number.isNaN(v.getTime()) ? null : v;
   if (typeof v === "string") {
@@ -954,13 +1437,13 @@ function create(type, format, locale) {
     }
     case "date": {
       if (locale.toLowerCase().startsWith("ko") && (format === void 0 || format === "date" || format === "datetime")) {
-        const pad3 = (n) => String(n).padStart(2, "0");
+        const pad4 = (n) => String(n).padStart(2, "0");
         const withTime = format === "datetime";
         return (v) => {
-          const d = toDate(v);
+          const d = toDate2(v);
           if (!d) return isBlank(v) ? "" : String(v);
-          const day = `${d.getFullYear()}-${pad3(d.getMonth() + 1)}-${pad3(d.getDate())}`;
-          return withTime ? `${day} ${pad3(d.getHours())}:${pad3(d.getMinutes())}` : day;
+          const day = `${d.getFullYear()}-${pad4(d.getMonth() + 1)}-${pad4(d.getDate())}`;
+          return withTime ? `${day} ${pad4(d.getHours())}:${pad4(d.getMinutes())}` : day;
         };
       }
       let opts = DATE_PRESETS.date;
@@ -970,7 +1453,7 @@ function create(type, format, locale) {
       } else if (format) opts = format;
       const df = new Intl.DateTimeFormat(locale, opts);
       return (v) => {
-        const d = toDate(v);
+        const d = toDate2(v);
         return d ? df.format(d) : isBlank(v) ? "" : String(v);
       };
     }
@@ -1173,6 +1656,8 @@ var Renderer = class {
     this.frame = 0;
     this.headerDirty = true;
     this.version = 0;
+    /** Per-row repaint counters on top of `version` (live updates paint only the rows that changed). */
+    this.rowVersions = /* @__PURE__ */ new Map();
     this.lastRange = { first: 0, last: -1 };
     /** Pinned summary section (top or bottom) and its per-region inners. */
     this.summaryEl = null;
@@ -1298,7 +1783,15 @@ var Renderer = class {
   }
   invalidate(what = {}) {
     if (what.header) this.headerDirty = true;
-    if (what.rows) this.version++;
+    if (what.rows) {
+      this.version++;
+      this.rowVersions.clear();
+    }
+    this.schedule();
+  }
+  /** Paint these rows again on the next frame; the others stay as they are. */
+  invalidateRowIds(ids) {
+    for (const id of ids) this.rowVersions.set(id, (this.rowVersions.get(id) ?? 0) + 1);
     this.schedule();
   }
   schedule() {
@@ -1416,18 +1909,18 @@ var Renderer = class {
       return;
     }
     const filtered = !rowModel.server && store.state.data.length > 0;
-    const custom = kind === "loading" ? options.loadingOverlay : options.noRowsOverlay;
+    const custom2 = kind === "loading" ? options.loadingOverlay : options.noRowsOverlay;
     const key = `${kind}|${filtered}|${store.state.locale.code}`;
     if (key === this.overlayKey) return;
     this.overlayKey = key;
-    this.overlay.classList.toggle("fg-overlay-custom", typeof custom === "function");
-    if (custom === void 0 || custom === null) {
+    this.overlay.classList.toggle("fg-overlay-custom", typeof custom2 === "function");
+    if (custom2 === void 0 || custom2 === null) {
       this.overlay.textContent = kind === "loading" ? store.state.locale.loading : store.state.locale.noRows;
-    } else if (typeof custom === "string") {
-      this.overlay.textContent = custom;
+    } else if (typeof custom2 === "string") {
+      this.overlay.textContent = custom2;
     } else {
       try {
-        const out = custom({ filtered });
+        const out = custom2({ filtered });
         if (typeof out === "string") this.overlay.textContent = out;
         else this.overlay.replaceChildren(out);
       } catch {
@@ -1645,7 +2138,7 @@ var Renderer = class {
         const inRange = hits.map((b) => `${b.c1}-${b.c2}`).join(",");
         const merge2 = this.mergeState(spans, cols, i, range.first);
         const pos = node.kind === "detail" ? `${this.scroller.scrollLeft}:${this.scroller.clientWidth}` : "";
-        const key = `${node.id}|${this.version}|${colKey}|${isSel ? 1 : 0}${node.kind === "group" ? `:${this.grid.selectionVersion}` : ""}|${focusCol}|${inRange}|${merge2}|${pos}`;
+        const key = `${node.id}|${this.version}.${this.rowVersions.get(node.id) ?? 0}|${colKey}|${isSel ? 1 : 0}${node.kind === "group" ? `:${this.grid.selectionVersion}` : ""}|${focusCol}|${inRange}|${merge2}|${pos}`;
         let row = map.get(i);
         if (!row) {
           const rowEl = this.pool[r].pop() ?? el("div", "fg-row", { role: "row" });
@@ -1775,8 +2268,11 @@ var Renderer = class {
     if (def.wrapText) cls += " fg-cell-wrap";
     if (typeof def.editable === "function" && i >= 0 && !cellEditable(def, node.data, i)) cls += " fg-cell-readonly";
     if (i >= 0) cls += this.grid.finder.classFor(i, col.id);
-    if (this.grid.isFlashing(node.id, col.id)) cls += " fg-cell-flash";
+    cls += this.grid.flashClass(node.id, col.id);
+    const cf = i >= 0 && !node.kind ? this.grid.cellFormat(node.data, col.id, value) : null;
+    if (cf?.bar) cls += " fg-cf-bar";
     cell.className = cls;
+    this.applyFormat(cell, cf);
     if (def.sparkline && !def.renderer) {
       const nums = Array.isArray(value) ? value.map(Number).filter(Number.isFinite) : [];
       if (nums.length) cell.replaceChildren(sparkline(nums, def.sparkline === true ? {} : def.sparkline, col.width, this.opts.rowHeight));
@@ -1786,6 +2282,12 @@ var Renderer = class {
     }
     if (!def.renderer) {
       cell.textContent = formatted;
+      if (cf?.icon) {
+        const icon = el("span", "fg-cf-icon", { "aria-hidden": "true" });
+        icon.textContent = cf.icon.char;
+        icon.style.color = cf.icon.color;
+        cell.prepend(icon);
+      }
       return;
     }
     try {
@@ -1797,6 +2299,36 @@ var Renderer = class {
       cell.textContent = "";
     }
   }
+  /** Inline styles of a conditional format; pooled cells are reset first. */
+  applyFormat(cell, cf) {
+    const st = cell.style;
+    if (!cf) {
+      if (cell.dataset.cf) {
+        st.color = st.background = st.fontWeight = st.fontStyle = st.textDecoration = "";
+        st.removeProperty("--fg-bar-from");
+        st.removeProperty("--fg-bar-to");
+        st.removeProperty("--fg-bar-color");
+        delete cell.dataset.cf;
+      }
+      return;
+    }
+    cell.dataset.cf = "1";
+    const s = cf.style;
+    st.color = s.color ?? "";
+    st.background = s.background ?? "";
+    st.fontWeight = s.bold ? "600" : "";
+    st.fontStyle = s.italic ? "italic" : "";
+    st.textDecoration = s.strike ? "line-through" : "";
+    if (cf.bar) {
+      st.setProperty("--fg-bar-from", `${(cf.bar.from * 100).toFixed(2)}%`);
+      st.setProperty("--fg-bar-to", `${(cf.bar.to * 100).toFixed(2)}%`);
+      st.setProperty("--fg-bar-color", cf.bar.color);
+    } else {
+      st.removeProperty("--fg-bar-from");
+      st.removeProperty("--fg-bar-to");
+      st.removeProperty("--fg-bar-color");
+    }
+  }
   cellAt(target) {
     const cell = target instanceof Element ? target.closest(".fg-cell") : null;
     const row = cell?.parentElement;
@@ -2236,9 +2768,9 @@ var Renderer = class {
     }
     const { scroller, canvas } = this.cards;
     const cols = grid.columns.displayed().filter((c) => !isSystemCol(c.id));
-    const line = Math.round(this.opts.rowHeight * 0.75);
+    const line2 = Math.round(this.opts.rowHeight * 0.75);
     const select = !!grid.options.rowSelection;
-    const cardH = 20 + cols.length * line + (select ? line : 0);
+    const cardH = 20 + cols.length * line2 + (select ? line2 : 0);
     const gap = 10;
     canvas.style.height = `${count * (cardH + gap)}px`;
     const first = Math.max(0, Math.floor(scroller.scrollTop / (cardH + gap)) - 2);
@@ -2252,7 +2784,7 @@ var Renderer = class {
       card.dataset.row = String(i);
       card.style.transform = `translateY(${i * (cardH + gap)}px)`;
       card.style.height = `${cardH}px`;
-      card.style.setProperty("--fg-card-line", `${line}px`);
+      card.style.setProperty("--fg-card-line", `${line2}px`);
       if (node.kind === "group" && node.group) {
         const def = grid.columns.getNode(node.group.colId)?.def;
         card.textContent = `${def?.header ?? node.group.colId}: ${String(node.group.value ?? locale.blanks)} (${node.group.rows.length})`;
@@ -2599,6 +3131,22 @@ var en = {
   chartCombo: "Bar and line chart",
   chartScatter: "Scatter chart",
   freeBadge: "Free version",
+  exportPdf: "Export PDF",
+  exportJson: "Export JSON",
+  ai: { title: "AI assistant", placeholder: "Ask about the data or tell the grid what to do", send: "Send", thinking: "Working\u2026", undo: "Undo", undone: "Undone", failed: "The assistant did not answer", skipped: "Skipped", done: "Done" },
+  cf: {
+    title: "Conditional formatting",
+    add: "Add rule",
+    clear: "Clear rules",
+    none: "No rules for this column",
+    type: "Rule",
+    style: "Format",
+    wholeRow: "Whole row",
+    count: "Count",
+    types: { value: "Cell value", formula: "Formula", top: "Top", bottom: "Bottom", aboveAverage: "Above average", belowAverage: "Below average", duplicate: "Duplicate values", unique: "Unique values", dataBar: "Data bars", colorScale: "Color scale", iconSet: "Icon set" },
+    ops: { notBetween: "Not between", notContains: "Does not contain" },
+    styles: { red: "Light red fill", yellow: "Yellow fill", green: "Green fill", blue: "Blue fill", redText: "Red text", bold: "Bold" }
+  },
   ops: {
     contains: "Contains",
     equals: "Equals",
@@ -2703,9 +3251,9 @@ function nextFocus(key, mods, p, s) {
     case "End":
       return { rowIndex: mods.ctrl ? s.rows - 1 : p.rowIndex, colIndex: s.cols - 1 };
     case "Tab": {
-      const flat = p.rowIndex * s.cols + p.colIndex + (mods.shift ? -1 : 1);
-      if (flat < 0 || flat >= s.rows * s.cols) return null;
-      return { rowIndex: Math.floor(flat / s.cols), colIndex: flat % s.cols };
+      const flat2 = p.rowIndex * s.cols + p.colIndex + (mods.shift ? -1 : 1);
+      if (flat2 < 0 || flat2 >= s.rows * s.cols) return null;
+      return { rowIndex: Math.floor(flat2 / s.cols), colIndex: flat2 % s.cols };
     }
     default:
       return null;
@@ -2925,7 +3473,7 @@ function attachBody(grid) {
       const box = under?.getBoundingClientRect();
       let target = null;
       let position = "after";
-      let line;
+      let line2;
       if (under && box) {
         const over = into.rowModel.getRow(Number(under.dataset.row));
         if (!over || over.kind === "group") return;
@@ -2934,17 +3482,17 @@ function attachBody(grid) {
         if (over.kind === "detail") position = "after";
         else if (into.options.treeData) position = y < 0.25 ? "before" : y > 0.75 ? "after" : "inside";
         else position = y < 0.5 ? "before" : "after";
-        line = position === "before" ? box.top : box.bottom;
+        line2 = position === "before" ? box.top : box.bottom;
       } else {
         if (!point.closest(".fg-body")) return;
         const rows = intoRoot.querySelectorAll(".fg-body-pane-center .fg-row[data-row]");
-        line = rows.length ? Math.max(...[...rows].map((r) => r.getBoundingClientRect().bottom)) : intoRoot.querySelector(".fg-body").getBoundingClientRect().top;
+        line2 = rows.length ? Math.max(...[...rows].map((r) => r.getBoundingClientRect().bottom)) : intoRoot.querySelector(".fg-body").getBoundingClientRect().top;
       }
       if (!into.canDropRow(row, target, position, grid)) return;
       drop = { into, target, position };
       const top = intoRoot.getBoundingClientRect().top;
       marker.classList.toggle("fg-row-drop-inside", position === "inside");
-      marker.style.top = `${position === "inside" ? box.top - top : line - top - 1}px`;
+      marker.style.top = `${position === "inside" ? box.top - top : line2 - top - 1}px`;
       marker.style.height = position === "inside" ? `${box.height}px` : "";
       intoRoot.append(marker);
     };
@@ -3528,6 +4076,7 @@ var SideBar = class {
     this.grid.renderer.invalidate({ header: true, rows: true });
   }
   syncTabs() {
+    this.el.classList.toggle("fg-sidebar-open", this.isOpen);
     for (const [p, tab] of this.tabs) {
       const on = this.isOpen && p === this.current;
       tab.setAttribute("aria-expanded", String(on));
@@ -3641,7 +4190,10 @@ var ContextMenu = class {
     items.push(
       "separator",
       { label: loc.exportCsv, action: () => grid.api.exportCsv() },
-      { label: loc.exportExcel, action: () => grid.api.exportXlsx() }
+      { 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() }
     );
     if (grid.options.advancedFilter !== false && !grid.options.pivot) items.push("separator", { label: `${loc.advancedFilter}\u2026`, action: () => grid.filterBuilder.open() });
     items.push("separator", { label: loc.print, action: () => grid.api.print() });
@@ -3667,11 +4219,11 @@ var ContextMenu = class {
       value: node && col && !isSystemCol(colId) ? getCellValue(col.def, node.data) : void 0,
       defaultItems: defaults
     };
-    const custom = grid.options.contextMenu;
+    const custom2 = grid.options.contextMenu;
     let items = defaults;
-    if (typeof custom === "function") {
+    if (typeof custom2 === "function") {
       try {
-        items = custom(params);
+        items = custom2(params);
       } catch {
         items = defaults;
       }
@@ -3931,10 +4483,10 @@ var Finder = class {
     const bar = el("div", "fg-findbar", { role: "search" });
     const input = el("input", "fg-input", { type: "search", placeholder: loc.findPlaceholder, "aria-label": loc.findPlaceholder });
     this.countEl = el("span", "fg-findbar-count", { "aria-live": "polite" });
-    const btn = (label, text2, run) => {
+    const btn = (label, text2, run2) => {
       const b = el("button", "fg-findbar-btn", { type: "button", "aria-label": label, title: label });
       b.textContent = text2;
-      b.addEventListener("click", run);
+      b.addEventListener("click", run2);
       return b;
     };
     bar.append(
@@ -3970,7 +4522,7 @@ var Finder = class {
 };
 
 // src/fill.ts
-var DAY = 864e5;
+var DAY2 = 864e5;
 function fillSeries(source, count) {
   if (!source.length || count <= 0) return [];
   const repeat = () => Array.from({ length: count }, (_, i) => source[i % source.length]);
@@ -3982,9 +4534,9 @@ function fillSeries(source, count) {
     const last2 = nums[nums.length - 1];
     return Array.from({ length: count }, (_, i) => Math.round((last2 + step * (i + 1)) * 1e12) / 1e12);
   }
-  const dates = source.map((v) => v instanceof Date || typeof v === "string" && /^\d{4}-\d{2}-\d{2}/.test(v) ? toDate(v) : null);
+  const dates = source.map((v) => v instanceof Date || typeof v === "string" && /^\d{4}-\d{2}-\d{2}/.test(v) ? toDate2(v) : null);
   if (dates.every(Boolean) && source.length >= 2) {
-    const times = dates.map((d) => Math.round(d.getTime() / DAY));
+    const times = dates.map((d) => Math.round(d.getTime() / DAY2));
     const step = times[1] - times[0];
     if (times.every((t, i) => i === 0 || t - times[i - 1] === step)) {
       const lastDate = dates[dates.length - 1];
@@ -4119,7 +4671,7 @@ function parseDate(text2, previous) {
   let m = /^(\d{4})\s*[-./년]\s*(\d{1,2})\s*[-./월]\s*(\d{1,2})\s*[.일]?$/.exec(s);
   if (m) date = validDate(+m[1], +m[2], +m[3]);
   else if (m = /^(\d{1,2})\/(\d{1,2})\/(\d{4})$/.exec(s)) date = validDate(+m[3], +m[1], +m[2]);
-  else if (/^\d{4}-\d{2}-\d{2}T/.test(s)) date = toDate(s);
+  else if (/^\d{4}-\d{2}-\d{2}T/.test(s)) date = toDate2(s);
   if (!date) return { ok: false };
   return { ok: true, value: previous instanceof Date ? date : toDateKey2(date) };
 }
@@ -4143,16 +4695,16 @@ function parseValue(def, text2, previous) {
 
 // src/editing/editor.ts
 var normalizeOptions = (opts) => opts.map((o) => o !== null && typeof o === "object" && "value" in o ? o : { value: o, label: String(o), disabled: false });
-var pad2 = (n) => String(n).padStart(2, "0");
+var pad3 = (n) => String(n).padStart(2, "0");
 function localDateTime(v) {
   const d = v instanceof Date ? v : typeof v === "string" && v ? new Date(v) : null;
   if (!d || Number.isNaN(d.getTime())) return "";
-  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}T${pad2(d.getHours())}:${pad2(d.getMinutes())}`;
+  return `${d.getFullYear()}-${pad3(d.getMonth() + 1)}-${pad3(d.getDate())}T${pad3(d.getHours())}:${pad3(d.getMinutes())}`;
 }
 function timeOf(v) {
-  if (v instanceof Date) return `${pad2(v.getHours())}:${pad2(v.getMinutes())}`;
+  if (v instanceof Date) return `${pad3(v.getHours())}:${pad3(v.getMinutes())}`;
   const m = typeof v === "string" ? /(\d{1,2}):(\d{2})/.exec(v) : null;
-  return m ? `${pad2(Number(m[1]))}:${m[2]}` : "";
+  return m ? `${pad3(Number(m[1]))}:${m[2]}` : "";
 }
 var CellEditor = class {
   constructor(grid) {
@@ -4227,20 +4779,20 @@ var CellEditor = class {
     grid.setFocus(rowIndex, colId);
     renderer.ensureVisible(rowIndex, colId);
     renderer.render();
-    const wrap = el("div", "fg-editor");
-    this.place(wrap, rowIndex, colId);
+    const wrap2 = el("div", "fg-editor");
+    this.place(wrap2, rowIndex, colId);
     let control;
     let read;
     let dispose = () => {
     };
     const spec = def.editor;
     if (typeof spec === "function") {
-      const custom = spec({ value, row, column: def, initialText });
-      control = custom.el;
-      read = () => ({ value: custom.getValue() });
-      dispose = () => custom.destroy?.();
-      wrap.append(control);
-      queueMicrotask(() => custom.focus?.());
+      const custom2 = spec({ value, row, column: def, initialText });
+      control = custom2.el;
+      read = () => ({ value: custom2.getValue() });
+      dispose = () => custom2.destroy?.();
+      wrap2.append(control);
+      queueMicrotask(() => custom2.focus?.());
     } else if (spec?.type === "select") {
       const options = normalizeOptions(typeof spec.options === "function" ? spec.options(row) : spec.options);
       const select = el("select", "fg-editor-control");
@@ -4254,7 +4806,7 @@ var CellEditor = class {
       select.selectedIndex = Math.max(0, options.findIndex((o) => Object.is(o.value, value)));
       control = select;
       read = () => ({ value: options[select.selectedIndex]?.value ?? null });
-      wrap.append(select);
+      wrap2.append(select);
     } else if (spec?.type === "time" || spec?.type === "datetime" || !spec && def.type === "date" && def.format === "datetime") {
       const isTime = spec?.type === "time";
       const input = el("input", "fg-editor-control", { type: isTime ? "time" : "datetime-local" });
@@ -4265,7 +4817,7 @@ var CellEditor = class {
         if (isTime) return { value: input.value };
         return { value: value instanceof Date ? new Date(input.value) : input.value };
       };
-      wrap.append(input);
+      wrap2.append(input);
     } else {
       const textarea = spec?.type === "textarea";
       const input = textarea ? el("textarea", "fg-editor-control") : el("input", "fg-editor-control");
@@ -4277,11 +4829,11 @@ var CellEditor = class {
       input.value = initialText ?? start;
       control = input;
       read = () => ({ text: input.value });
-      wrap.append(input);
+      wrap2.append(input);
     }
     control.setAttribute("aria-label", def.header ?? def.field ?? colId);
     const msg = el("div", "fg-editor-msg", { role: "alert" });
-    wrap.append(msg);
+    wrap2.append(msg);
     const onKey = (e) => {
       e.stopPropagation();
       if (e.key === "Escape") {
@@ -4297,26 +4849,26 @@ var CellEditor = class {
       }
     };
     const onFocusOut = (e) => {
-      if (this.cur?.wrap === wrap && !wrap.contains(e.relatedTarget)) this.commit(null);
+      if (this.cur?.wrap === wrap2 && !wrap2.contains(e.relatedTarget)) this.commit(null);
     };
     const onScroll = () => this.commit(null);
-    wrap.addEventListener("keydown", onKey);
-    wrap.addEventListener("focusout", onFocusOut);
+    wrap2.addEventListener("keydown", onKey);
+    wrap2.addEventListener("focusout", onFocusOut);
     renderer.scroller.addEventListener("scroll", onScroll, { passive: true });
-    renderer.root.append(wrap);
+    renderer.root.append(wrap2);
     this.cur = {
       rowIndex,
       colId,
       row,
       def,
-      wrap,
+      wrap: wrap2,
       read,
       dispose: () => {
-        wrap.removeEventListener("keydown", onKey);
-        wrap.removeEventListener("focusout", onFocusOut);
+        wrap2.removeEventListener("keydown", onKey);
+        wrap2.removeEventListener("focusout", onFocusOut);
         renderer.scroller.removeEventListener("scroll", onScroll);
         dispose();
-        wrap.remove();
+        wrap2.remove();
       }
     };
     if (typeof spec !== "function") {
@@ -4327,15 +4879,15 @@ var CellEditor = class {
     return true;
   }
   /** Put the editor over its cell; false when the cell is not rendered. */
-  place(wrap, rowIndex, colId) {
+  place(wrap2, rowIndex, colId) {
     const { renderer } = this.grid;
     const cellEl = renderer.root.querySelector(`.fg-row[data-row="${rowIndex}"] .fg-cell[data-col="${CSS.escape(colId)}"]`);
     const rootBox = renderer.root.getBoundingClientRect();
     const box = cellEl?.getBoundingClientRect();
-    wrap.style.left = `${(box?.left ?? rootBox.left) - rootBox.left}px`;
-    wrap.style.top = `${(box?.top ?? rootBox.top) - rootBox.top}px`;
-    wrap.style.width = `${box?.width || this.grid.columns.getColumn(colId)?.width}px`;
-    wrap.style.height = `${box?.height || renderer.opts.rowHeight}px`;
+    wrap2.style.left = `${(box?.left ?? rootBox.left) - rootBox.left}px`;
+    wrap2.style.top = `${(box?.top ?? rootBox.top) - rootBox.top}px`;
+    wrap2.style.width = `${box?.width || this.grid.columns.getColumn(colId)?.width}px`;
+    wrap2.style.height = `${box?.height || renderer.opts.rowHeight}px`;
     return !!cellEl;
   }
   /** Display index of a row object, or -1 when it is no longer shown. */
@@ -4679,6 +5231,610 @@ function attachHeader(grid) {
   };
 }
 
+// src/export/pdf.ts
+var PAPER_MM = {
+  A4: [210, 297],
+  A3: [297, 420],
+  A5: [148, 210],
+  B4: [250, 353],
+  B5: [176, 250],
+  letter: [215.9, 279.4],
+  legal: [215.9, 355.6]
+};
+var PX_PER_MM = 96 / 25.4;
+var PT_PER_MM = 72 / 25.4;
+var FONT = "system-ui, 'Pretendard', 'Malgun Gothic', 'Apple SD Gothic Neo', 'Noto Sans CJK KR', sans-serif";
+var FS = 10.5;
+var LINE = 15;
+var PAD_X = 7;
+var PAD_Y = 4;
+var MAX_LINES = 8;
+function base64Bytes(b64) {
+  const bin = atob(b64);
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  return out;
+}
+var browserSurface = {
+  surface(width, height) {
+    if (typeof document === "undefined") return null;
+    const canvas = document.createElement("canvas");
+    canvas.width = width;
+    canvas.height = height;
+    let ctx = null;
+    try {
+      ctx = canvas.getContext("2d");
+    } catch {
+      ctx = null;
+    }
+    if (!ctx) return null;
+    return {
+      ctx,
+      jpeg: (q) => base64Bytes(canvas.toDataURL("image/jpeg", q).split(",")[1] ?? "")
+    };
+  }
+};
+var fontOf = (weight, size = FS) => `${weight} ${size}px ${FONT}`;
+function wrap(ctx, text2, width) {
+  if (!text2) return [""];
+  const out = [];
+  for (const para of text2.split(/\r?\n/)) {
+    let line2 = "";
+    const parts = para.match(/[　-鿿가-힯＀-￯]|[^\s　-鿿가-힯＀-￯]+\s*|\s+/g) ?? [""];
+    for (const part of parts) {
+      const next = line2 + part;
+      if (!line2 || ctx.measureText(next.trimEnd()).width <= width) {
+        if (!line2 && ctx.measureText(part.trimEnd()).width > width) {
+          for (const ch of part) {
+            if (line2 && ctx.measureText(line2 + ch).width > width) {
+              out.push(line2);
+              line2 = "";
+            }
+            line2 += ch;
+          }
+        } else line2 = next;
+      } else {
+        out.push(line2.trimEnd());
+        line2 = part.trimStart();
+      }
+      if (out.length >= MAX_LINES) break;
+    }
+    out.push(line2.trimEnd());
+    if (out.length >= MAX_LINES) break;
+  }
+  if (out.length > MAX_LINES) out.length = MAX_LINES;
+  return out;
+}
+function geometry(m) {
+  const [w, h] = PAPER_MM[m.paper] ?? PAPER_MM.A4;
+  const [pw, ph] = m.orientation === "landscape" ? [h, w] : [w, h];
+  const pageW = pw * PX_PER_MM, pageH = ph * PX_PER_MM;
+  const margin = 12 * PX_PER_MM, marginBottom = 14 * PX_PER_MM;
+  const contentW = pageW - margin * 2;
+  const fixed = m.numbered ? 40 : 0;
+  const data = m.widths.slice(m.numbered ? 1 : 0);
+  const sum = data.reduce((a, b) => a + b, 0) || 1;
+  const scale = m.fit ? (contentW - fixed) / sum : Math.min(1, (contentW - fixed) / sum);
+  const colW = [...m.numbered ? [fixed] : [], ...data.map((x2) => x2 * scale)];
+  const colX = [];
+  let x = margin;
+  for (const cw of colW) {
+    colX.push(x);
+    x += cw;
+  }
+  return { pageW, pageH, margin, marginBottom, colX, colW };
+}
+function placeLine(ctx, g, cells, kind, level) {
+  const placed = { cells: [], kind, level, y: 0, h: 0 };
+  let col = 0, h = 22;
+  for (const cell of cells) {
+    const span = Math.max(1, cell.span ?? 1);
+    const x = g.colX[col] ?? g.margin;
+    let w = 0;
+    for (let k = col; k < col + span && k < g.colW.length; k++) w += g.colW[k];
+    col += span;
+    ctx.font = fontOf(kind === "group" ? 600 : kind === "total" || cell.bold ? 700 : 400);
+    const indent = (cell.indent ?? 0) * 14;
+    const lines = wrap(ctx, cell.text, Math.max(8, w - PAD_X * 2 - indent - (cell.icon ? 14 : 0)));
+    h = Math.max(h, lines.length * LINE + PAD_Y * 2);
+    placed.cells.push({ cell, x, w, y: 0, h: 0, lines });
+  }
+  placed.h = h;
+  return placed;
+}
+function placeHead(ctx, g, head) {
+  const rows = head.map(() => ({ cells: [], kind: "head", y: 0, h: 22 }));
+  const taken = head.map(() => g.colW.map(() => false));
+  const items = [];
+  ctx.font = fontOf(600);
+  head.forEach((tr, r) => {
+    let col = 0;
+    for (const cell of tr) {
+      while (col < g.colW.length && taken[r][col]) col++;
+      const span = Math.max(1, cell.span ?? 1), rs = Math.max(1, Math.min(head.length - r, cell.rowspan ?? 1));
+      for (let a = r; a < r + rs; a++) for (let b = col; b < col + span && b < g.colW.length; b++) taken[a][b] = true;
+      let w = 0;
+      for (let k = col; k < col + span && k < g.colW.length; k++) w += g.colW[k];
+      const lines = wrap(ctx, cell.text, Math.max(8, w - PAD_X * 2));
+      items.push({ cell, r, col, span, rs, lines, x: g.colX[col] ?? g.margin, w });
+      col += span;
+    }
+  });
+  for (const it of items) {
+    const need = it.lines.length * LINE + PAD_Y * 2;
+    const each = need / it.rs;
+    for (let a = it.r; a < it.r + it.rs; a++) rows[a].h = Math.max(rows[a].h, each);
+  }
+  for (const it of items) {
+    rows[it.r].cells.push({ cell: it.cell, x: it.x, w: it.w, y: 0, h: rows.slice(it.r, it.r + it.rs).reduce((s, x) => s + x.h, 0), lines: it.lines });
+  }
+  return rows;
+}
+function titleHeight(m) {
+  if (!m.title && !m.subtitle && !m.printed) return 0;
+  return (m.title ? 24 : 12) + (m.subtitle ? 17 : 0) + 18;
+}
+function paginate(ctx, m) {
+  const g = geometry(m);
+  const head = placeHead(ctx, g, m.head);
+  let n = 0;
+  const lines = m.body.map((l) => {
+    const p = placeLine(ctx, g, l.cells, l.kind, l.level);
+    if (l.kind === "row") p.odd = n++ % 2 === 1;
+    return p;
+  });
+  const repeated = lines.slice(0, m.repeatRows);
+  const rest = lines.slice(m.repeatRows);
+  const foot = m.foot.map((l) => placeLine(ctx, g, l.cells, l.kind, l.level));
+  const bottom = g.pageH - g.marginBottom;
+  const tH = titleHeight(m);
+  const pages = [];
+  const queue = [...rest, ...foot];
+  const clone = (p) => ({ ...p, cells: p.cells.map((c) => ({ ...c })) });
+  let i = 0;
+  do {
+    const first = pages.length === 0;
+    const page = { rows: [], title: first || m.repeatTitle };
+    let y = g.margin + (page.title ? tH : 0);
+    const put = (p) => {
+      const c = clone(p);
+      c.y = y;
+      for (const cell of c.cells) {
+        cell.y = y;
+        if (c.kind !== "head") cell.h = c.h;
+      }
+      page.rows.push(c);
+      y += c.h;
+    };
+    if (first || m.repeatHeader) head.forEach(put);
+    repeated.forEach(put);
+    const top = y;
+    while (i < queue.length) {
+      const p = queue[i];
+      const need = p.kind === "group" && i + 1 < queue.length ? p.h + queue[i + 1].h : p.h;
+      if (y + need > bottom && y > top) break;
+      put(p);
+      i++;
+    }
+    pages.push(page);
+  } while (i < queue.length && pages.length < 5e3);
+  return { pages, g };
+}
+function line(ctx, x1, y1, x2, y2, color, width) {
+  ctx.strokeStyle = color;
+  ctx.lineWidth = width;
+  ctx.beginPath();
+  ctx.moveTo(x1, y1);
+  ctx.lineTo(x2, y2);
+  ctx.stroke();
+}
+function paintRow(ctx, row, m, g) {
+  const right = g.colX.length ? g.colX[g.colX.length - 1] + g.colW[g.colW.length - 1] : g.pageW - g.margin;
+  const rowFill = row.kind === "head" ? "#f3f4f6" : row.kind === "group" ? row.level ? "#eef2f7" : "#e2e8f0" : row.kind === "total" ? "#f3f4f6" : m.striped && row.odd ? "#f9fafb" : "";
+  for (const c of row.cells) {
+    const fill = c.cell.fill || rowFill;
+    if (fill) {
+      ctx.fillStyle = fill;
+      ctx.fillRect(c.x, c.y, c.w, c.h);
+    }
+    if (c.cell.bar) {
+      ctx.save();
+      ctx.globalAlpha = 0.4;
+      ctx.fillStyle = c.cell.bar.color;
+      ctx.fillRect(c.x + c.w * c.cell.bar.from, c.y + c.h * 0.15, c.w * (c.cell.bar.to - c.cell.bar.from), c.h * 0.7);
+      ctx.restore();
+    }
+    const weight = row.kind === "head" || row.kind === "group" ? 600 : row.kind === "total" ? 700 : c.cell.bold ? 600 : 400;
+    ctx.font = `${c.cell.italic ? "italic " : ""}${fontOf(weight)}`;
+    ctx.fillStyle = c.cell.num ? "#9ca3af" : c.cell.color || (row.kind === "head" ? "#374151" : "#111827");
+    ctx.textBaseline = "middle";
+    ctx.save();
+    ctx.beginPath();
+    ctx.rect(c.x, c.y, c.w, c.h);
+    ctx.clip();
+    const indent = (c.cell.indent ?? 0) * 14;
+    const textH = c.lines.length * LINE;
+    let ty = row.kind === "head" ? c.y + c.h - PAD_Y - textH + LINE / 2 : c.y + PAD_Y + LINE / 2;
+    if (row.kind !== "head" && c.h > textH + PAD_Y * 2) ty = c.y + PAD_Y + LINE / 2;
+    for (const [k, text2] of c.lines.entries()) {
+      let x = c.x + PAD_X + indent;
+      const wText = ctx.measureText(text2).width + (c.cell.icon && k === 0 ? 14 : 0);
+      const align = c.cell.group ? "center" : c.cell.align;
+      if (align === "right") x = c.x + c.w - PAD_X - wText;
+      else if (align === "center") x = c.x + (c.w - wText) / 2;
+      ctx.textAlign = "left";
+      if (c.cell.icon && k === 0) {
+        const keep = ctx.fillStyle;
+        ctx.fillStyle = c.cell.icon.color;
+        ctx.fillText(c.cell.icon.char, x, ty);
+        ctx.fillStyle = keep;
+        x += 14;
+      }
+      ctx.fillText(text2, x, ty);
+      if (c.cell.strike) line(ctx, x, ty, x + ctx.measureText(text2).width, ty, String(ctx.fillStyle), 1);
+      ty += LINE;
+    }
+    ctx.restore();
+    if (row.kind === "head" && c.x > g.margin + 0.5) line(ctx, c.x, c.y, c.x, c.y + c.h, "#e5e7eb", 1);
+    if (row.kind === "head") line(ctx, c.x, c.y + c.h, c.x + c.w, c.y + c.h, "#9ca3af", 1.5);
+  }
+  if (row.kind === "group") line(ctx, g.margin, row.y, right, row.y, "#cbd5e1", 1);
+  if (row.kind === "total") line(ctx, g.margin, row.y, right, row.y, "#111827", 1.5);
+  else if (row.kind !== "head") line(ctx, g.margin, row.y + row.h, right, row.y + row.h, "#e5e7eb", 1);
+}
+function paintTitle(ctx, m, g) {
+  const h = titleHeight(m);
+  if (!h) return;
+  const right = g.pageW - g.margin;
+  let y = g.margin;
+  ctx.textAlign = "left";
+  ctx.textBaseline = "top";
+  if (m.title) {
+    ctx.font = fontOf(700, 17);
+    ctx.fillStyle = "#111827";
+    ctx.fillText(m.title, g.margin, y);
+    y += 24;
+  }
+  if (m.subtitle) {
+    ctx.font = fontOf(400, 11);
+    ctx.fillStyle = "#4b5563";
+    ctx.fillText(m.subtitle, g.margin, y);
+    y += 17;
+  }
+  if (m.printed) {
+    ctx.font = fontOf(400, 9.5);
+    ctx.fillStyle = "#6b7280";
+    const w = ctx.measureText(m.printed).width;
+    ctx.fillText(m.printed, right - w, g.margin + h - 18 - 13);
+  }
+  line(ctx, g.margin, g.margin + h - 10, right, g.margin + h - 10, "#111827", 2);
+}
+function paintFooter(ctx, m, g, index, total) {
+  const y = g.pageH - 7 * PX_PER_MM;
+  ctx.font = fontOf(400, 8.5);
+  ctx.fillStyle = "#6b7280";
+  ctx.textBaseline = "middle";
+  ctx.textAlign = "left";
+  if (m.footer) ctx.fillText(m.footer, g.margin, y);
+  if (m.pageNumbers) {
+    const t = `${index + 1} / ${total}`;
+    ctx.fillText(t, g.pageW - g.margin - ctx.measureText(t).width, y);
+  }
+}
+function renderPdf(m, deps = browserSurface, opts = {}) {
+  const scale = typeof opts.scale === "number" && opts.scale > 0 ? Math.min(4, opts.scale) : 2;
+  const quality = typeof opts.quality === "number" && opts.quality > 0 && opts.quality <= 1 ? opts.quality : 0.92;
+  const probe = deps.surface(8, 8);
+  if (!probe) return null;
+  const { pages, g } = paginate(probe.ctx, m);
+  const wPx = Math.round(g.pageW * scale), hPx = Math.round(g.pageH * scale);
+  const images = [];
+  pages.forEach((page, i) => {
+    const s = deps.surface(wPx, hPx);
+    if (!s) return;
+    const ctx = s.ctx;
+    ctx.setTransform(scale, 0, 0, scale, 0, 0);
+    ctx.fillStyle = "#ffffff";
+    ctx.fillRect(0, 0, g.pageW, g.pageH);
+    if (page.title) paintTitle(ctx, m, g);
+    for (const row of page.rows) paintRow(ctx, row, m, g);
+    paintFooter(ctx, m, g, i, pages.length);
+    images.push(s.jpeg(quality));
+  });
+  const [mw, mh] = PAPER_MM[m.paper] ?? PAPER_MM.A4;
+  const [pw, ph] = m.orientation === "landscape" ? [mh, mw] : [mw, mh];
+  return writePdf(images.map((jpeg) => ({ jpeg, width: wPx, height: hPx })), pw * PT_PER_MM, ph * PT_PER_MM, m.title);
+}
+function pdfString(s) {
+  if (/^[\x20-\x7e]*$/.test(s)) return `(${s.replace(/[\\()]/g, (c) => `\\${c}`)})`;
+  let hex2 = "FEFF";
+  for (let i = 0; i < s.length; i++) hex2 += s.charCodeAt(i).toString(16).padStart(4, "0").toUpperCase();
+  return `<${hex2}>`;
+}
+function writePdf(pages, ptW, ptH, title = "") {
+  const enc = new TextEncoder();
+  const parts = [];
+  const offsets = [];
+  let size = 0;
+  const push = (b) => {
+    const bytes = typeof b === "string" ? enc.encode(b) : b;
+    parts.push(bytes);
+    size += bytes.length;
+  };
+  const obj = (n2, body) => {
+    offsets[n2] = size;
+    push(`${n2} 0 obj
+`);
+    if (typeof body === "string") push(body);
+    else body();
+    push("\nendobj\n");
+  };
+  push("%PDF-1.4\n");
+  push(new Uint8Array([37, 226, 227, 207, 211, 10]));
+  const n = pages.length;
+  const pageIds = pages.map((_, i) => 4 + i * 3);
+  const w = ptW.toFixed(2), h = ptH.toFixed(2);
+  obj(1, "<< /Type /Catalog /Pages 2 0 R >>");
+  obj(2, `<< /Type /Pages /Count ${n} /Kids [${pageIds.map((id) => `${id} 0 R`).join(" ")}] >>`);
+  obj(3, `<< /Producer (FreeGrid)${title ? ` /Title ${pdfString(title)}` : ""} >>`);
+  pages.forEach((p, i) => {
+    const id = pageIds[i];
+    const content = `q ${w} 0 0 ${h} 0 0 cm /Im0 Do Q`;
+    obj(id, `<< /Type /Page /Parent 2 0 R /MediaBox [0 0 ${w} ${h}] /Resources << /XObject << /Im0 ${id + 2} 0 R >> >> /Contents ${id + 1} 0 R >>`);
+    obj(id + 1, `<< /Length ${content.length} >>
+stream
+${content}
+endstream`);
+    obj(id + 2, () => {
+      push(`<< /Type /XObject /Subtype /Image /Width ${p.width} /Height ${p.height} /ColorSpace /DeviceRGB /BitsPerComponent 8 /Filter /DCTDecode /Length ${p.jpeg.length} >>
+stream
+`);
+      push(p.jpeg);
+      push("\nendstream");
+    });
+  });
+  const count = 4 + n * 3;
+  const xref = size;
+  let table = `xref
+0 ${count}
+0000000000 65535 f 
+`;
+  for (let k = 1; k < count; k++) table += `${String(offsets[k] ?? 0).padStart(10, "0")} 00000 n 
+`;
+  push(`${table}trailer
+<< /Size ${count} /Root 1 0 R /Info 3 0 R >>
+startxref
+${xref}
+%%EOF
+`);
+  const out = new Uint8Array(size);
+  let at = 0;
+  for (const part of parts) {
+    out.set(part, at);
+    at += part.length;
+  }
+  return out;
+}
+
+// src/conditional.ts
+var NUMERIC = (v) => {
+  if (typeof v === "number") return Number.isFinite(v) ? v : null;
+  if (typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v))) return Number(v);
+  if (v instanceof Date) return v.getTime();
+  return null;
+};
+var STAT_TYPES = /* @__PURE__ */ new Set(["top", "bottom", "aboveAverage", "belowAverage", "duplicate", "unique", "dataBar", "colorScale", "iconSet"]);
+var ICON_SETS = {
+  // high, middle, low
+  arrows: [{ char: "\u25B2", color: "#16a34a", label: "up" }, { char: "\u25B6", color: "#d97706", label: "level" }, { char: "\u25BC", color: "#dc2626", label: "down" }],
+  traffic: [{ char: "\u25CF", color: "#16a34a", label: "good" }, { char: "\u25CF", color: "#f59e0b", label: "fair" }, { char: "\u25CF", color: "#dc2626", label: "poor" }],
+  signs: [{ char: "\u2714", color: "#16a34a", label: "good" }, { char: "!", color: "#d97706", label: "fair" }, { char: "\u2716", color: "#dc2626", label: "poor" }]
+};
+function hex(c) {
+  const m = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(c.trim());
+  if (!m) return null;
+  const h = m[1].length === 3 ? [...m[1]].map((x) => x + x).join("") : m[1];
+  return [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16));
+}
+function mixColor(a, b, t) {
+  const x = hex(a), y = hex(b);
+  if (!x || !y) return t < 0.5 ? a : b;
+  const c = x.map((v, i) => Math.round(v + (y[i] - v) * Math.max(0, Math.min(1, t))));
+  return `#${c.map((v) => v.toString(16).padStart(2, "0")).join("")}`;
+}
+function textOf(v) {
+  return v == null ? "" : v instanceof Date ? v.toISOString() : String(v);
+}
+function valueMatches(rule, value) {
+  const op = rule.op ?? "eq";
+  if (op === "blank") return isBlank(value);
+  if (op === "notBlank") return !isBlank(value);
+  if (op === "contains" || op === "notContains" || op === "startsWith" || op === "endsWith") {
+    const s2 = textOf(value).toLowerCase(), q = textOf(rule.value).toLowerCase();
+    const hit = op === "startsWith" ? s2.startsWith(q) : op === "endsWith" ? s2.endsWith(q) : s2.includes(q);
+    return op === "notContains" ? !hit : hit;
+  }
+  if (isBlank(value)) return op === "ne";
+  const a = NUMERIC(value), b = NUMERIC(rule.value), c = NUMERIC(rule.valueTo);
+  if (a !== null && b !== null) {
+    switch (op) {
+      case "eq":
+        return a === b;
+      case "ne":
+        return a !== b;
+      case "gt":
+        return a > b;
+      case "gte":
+        return a >= b;
+      case "lt":
+        return a < b;
+      case "lte":
+        return a <= b;
+      case "between":
+      case "notBetween": {
+        if (c === null) return false;
+        const inside = a >= Math.min(b, c) && a <= Math.max(b, c);
+        return op === "between" ? inside : !inside;
+      }
+    }
+  }
+  const s = textOf(value).toLowerCase(), t = textOf(rule.value).toLowerCase(), u = textOf(rule.valueTo).toLowerCase();
+  switch (op) {
+    case "eq":
+      return s === t;
+    case "ne":
+      return s !== t;
+    case "gt":
+      return s > t;
+    case "gte":
+      return s >= t;
+    case "lt":
+      return s < t;
+    case "lte":
+      return s <= t;
+    case "between":
+      return s >= t && s <= u;
+    case "notBetween":
+      return s < t || s > u;
+  }
+  return false;
+}
+var ConditionalFormatter = class {
+  constructor(deps) {
+    this.deps = deps;
+    this.stats = /* @__PURE__ */ new Map();
+    this.statsKey = [];
+    this.rowCache = /* @__PURE__ */ new WeakMap();
+  }
+  /** True when any rule looks at other rows (an update to one row can restyle others). */
+  dependsOnOtherRows() {
+    return this.deps.rules().some((r) => r && (STAT_TYPES.has(r.type ?? "value") || r.type === "formula"));
+  }
+  fresh() {
+    const key = [this.deps.rows(), this.deps.version(), this.deps.rules()];
+    if (key.every((k, i) => k === this.statsKey[i])) return;
+    this.statsKey = key;
+    this.stats.clear();
+    this.rowCache = /* @__PURE__ */ new WeakMap();
+  }
+  statsOf(colId) {
+    let s = this.stats.get(colId);
+    if (!s) {
+      const nums = [];
+      const counts = /* @__PURE__ */ new Map();
+      for (const row of this.deps.rows()) {
+        const v = this.deps.value(colId, row);
+        const n = NUMERIC(v);
+        if (n !== null) nums.push(n);
+        if (!isBlank(v)) {
+          const k = setKey(v);
+          counts.set(k, (counts.get(k) ?? 0) + 1);
+        }
+      }
+      nums.sort((a, b) => a - b);
+      const sum = nums.reduce((a, b) => a + b, 0);
+      s = { min: nums[0] ?? 0, max: nums[nums.length - 1] ?? 0, avg: nums.length ? sum / nums.length : 0, sorted: nums, counts };
+      this.stats.set(colId, s);
+    }
+    return s;
+  }
+  test(rule, colId, value, row) {
+    const type = rule.type ?? "value";
+    switch (type) {
+      case "value":
+        return valueMatches(rule, value);
+      case "formula": {
+        if (typeof rule.formula !== "string") return false;
+        const r = this.deps.formula(rule.formula.startsWith("=") ? rule.formula : `=${rule.formula}`, row);
+        return r === true || typeof r === "number" && r !== 0;
+      }
+      case "top":
+      case "bottom": {
+        const n = NUMERIC(value);
+        if (n === null) return false;
+        const s = this.statsOf(colId);
+        if (!s.sorted.length) return false;
+        const k = Math.max(1, rule.percent ? Math.ceil(s.sorted.length * (rule.rank ?? 10) / 100) : Math.floor(rule.rank ?? 10));
+        return type === "top" ? n >= s.sorted[Math.max(0, s.sorted.length - k)] : n <= s.sorted[Math.min(s.sorted.length - 1, k - 1)];
+      }
+      case "aboveAverage":
+      case "belowAverage": {
+        const n = NUMERIC(value);
+        if (n === null) return false;
+        const avg = this.statsOf(colId).avg;
+        return type === "aboveAverage" ? n > avg : n < avg;
+      }
+      case "duplicate":
+      case "unique": {
+        if (isBlank(value)) return false;
+        const c = this.statsOf(colId).counts.get(setKey(value)) ?? 0;
+        return type === "duplicate" ? c > 1 : c === 1;
+      }
+    }
+    return false;
+  }
+  /** Style from rules with `row: true`, for every cell of the row. */
+  rowStyle(row) {
+    if (this.rowCache.has(row)) return this.rowCache.get(row);
+    let style = null;
+    for (const rule of this.deps.rules()) {
+      if (!rule?.row || !Array.isArray(rule.columns) || !rule.columns.length) continue;
+      const colId = rule.columns[0];
+      if (this.test(rule, colId, this.deps.value(colId, row), row)) {
+        style = { ...style ?? {}, ...rule.style };
+        if (rule.stopIfTrue) break;
+      }
+    }
+    this.rowCache.set(row, style);
+    return style;
+  }
+  /** Format of one cell; null when no rule applies. */
+  cell(colId, row, value) {
+    const rules = this.deps.rules();
+    if (!rules.length) return null;
+    this.fresh();
+    let out = null;
+    const rs = this.rowStyle(row);
+    if (rs) out = { style: { ...rs } };
+    for (const rule of rules) {
+      if (!rule || rule.row || !Array.isArray(rule.columns) || !rule.columns.includes(colId)) continue;
+      const type = rule.type ?? "value";
+      if (type === "dataBar" || type === "colorScale" || type === "iconSet") {
+        const n = NUMERIC(value);
+        if (n === null) continue;
+        const s = this.statsOf(colId);
+        const lo = typeof rule.min === "number" ? rule.min : s.min;
+        const hi = typeof rule.max === "number" ? rule.max : s.max;
+        const t = hi === lo ? 1 : Math.max(0, Math.min(1, (n - lo) / (hi - lo)));
+        out ?? (out = { style: {} });
+        if (type === "dataBar") {
+          const zero = lo < 0 && hi > 0 ? -lo / (hi - lo) : lo >= 0 ? 0 : 1;
+          const at = hi === lo ? 1 : t;
+          out.bar = { from: Math.min(zero, at), to: Math.max(zero, at), color: rule.color || "var(--fg-accent)" };
+        } else if (type === "colorScale") {
+          const cs = Array.isArray(rule.colors) && rule.colors.length >= 2 ? rule.colors : ["#f8696b", "#ffeb84", "#63be7b"];
+          const bg = cs.length >= 3 ? t < 0.5 ? mixColor(cs[0], cs[1], t * 2) : mixColor(cs[1], cs[2], (t - 0.5) * 2) : mixColor(cs[0], cs[1], t);
+          out.style = { ...out.style, background: bg };
+        } else {
+          const set = ICON_SETS[rule.icons ?? "arrows"] ?? ICON_SETS.arrows;
+          out.icon = t >= 2 / 3 ? set[0] : t >= 1 / 3 ? set[1] : set[2];
+        }
+        continue;
+      }
+      if (this.test(rule, colId, value, row)) {
+        out ?? (out = { style: {} });
+        out.style = { ...out.style, ...rule.style };
+        if (rule.stopIfTrue) break;
+      }
+    }
+    return out;
+  }
+};
+function argbOf(c) {
+  const x = c ? hex(c) : null;
+  return x ? `FF${x.map((v) => v.toString(16).padStart(2, "0")).join("").toUpperCase()}` : void 0;
+}
+
 // src/rows/sort.ts
 function compareNonBlank(a, b, collator) {
   if (typeof a === "number" && typeof b === "number") return a - b;
@@ -4692,7 +5848,7 @@ function normalize(def, v) {
     const n = typeof v === "number" ? v : Number(v);
     return Number.isNaN(n) ? null : n;
   }
-  if (def.type === "date") return toDate(v)?.getTime() ?? null;
+  if (def.type === "date") return toDate2(v)?.getTime() ?? null;
   return v;
 }
 function compareValues(a, b, collator) {
@@ -4743,8 +5899,8 @@ function toCsv(rows, sep = ",") {
   return rows.map((r) => r.map(cell).join(sep)).join("\r\n");
 }
 function detectSeparator(text2) {
-  const line = text2.slice(0, text2.search(/\r?\n|$/));
-  const count = (ch) => line.split(ch).length - 1;
+  const line2 = text2.slice(0, text2.search(/\r?\n|$/));
+  const count = (ch) => line2.split(ch).length - 1;
   const tabs = count("	"), semis = count(";"), commas = count(",");
   if (tabs && tabs >= commas && tabs >= semis) return "	";
   if (semis > commas) return ";";
@@ -4901,12 +6057,12 @@ function colName(i) {
   return s;
 }
 var EPOCH = Date.UTC(1899, 11, 30);
-var DAY2 = 864e5;
+var DAY3 = 864e5;
 function toSerial(d) {
-  return (Date.UTC(d.getFullYear(), d.getMonth(), d.getDate(), d.getHours(), d.getMinutes(), d.getSeconds(), d.getMilliseconds()) - EPOCH) / DAY2;
+  return (Date.UTC(d.getFullYear(), d.getMonth(), d.getDate(), d.getHours(), d.getMinutes(), d.getSeconds(), d.getMilliseconds()) - EPOCH) / DAY3;
 }
 function fromSerial(n) {
-  const u = new Date(Math.round(n * DAY2) + EPOCH);
+  const u = new Date(Math.round(n * DAY3) + EPOCH);
   return new Date(u.getUTCFullYear(), u.getUTCMonth(), u.getUTCDate(), u.getUTCHours(), u.getUTCMinutes(), u.getUTCSeconds());
 }
 var BAD_XML = /[\u0000-\u0008\u000b\u000c\u000e-\u001f￾￿]/g;
@@ -4938,7 +6094,7 @@ function writeXlsx(sheets) {
   ];
   const fillIndex = /* @__PURE__ */ new Map([["FFF2F4F7", 2]]);
   const argb = (c) => c && /^[0-9a-f]{8}$/i.test(c) ? c.toUpperCase() : c && /^[0-9a-f]{6}$/i.test(c) ? `FF${c.toUpperCase()}` : "";
-  const fontOf = (bold, color) => {
+  const fontOf2 = (bold, color) => {
     const key = `${bold ? 1 : 0}|${color}`;
     let i = fontIndex.get(key);
     if (i === void 0) {
@@ -4972,7 +6128,7 @@ function writeXlsx(sheets) {
       customFmts.push(fmt);
       fmtIds.set(fmt, id);
     }
-    const fontId = fontOf(bold, color);
+    const fontId = fontOf2(bold, color);
     const fillId = fillOf(fill);
     const attrs = `numFmtId="${id}" fontId="${fontId}" fillId="${fillId}" borderId="0" xfId="0"` + (id ? ' applyNumberFormat="1"' : "") + (fontId ? ' applyFont="1"' : "") + (fillId ? ' applyFill="1"' : "") + (align ? ' applyAlignment="1"' : "");
     i = xfs.length;
@@ -5025,9 +6181,13 @@ function writeXlsx(sheets) {
     },
     {
       name: "xl/workbook.xml",
-      data: `${XML}<workbook xmlns="${NS}" xmlns:r="${REL_NS}"><sheets>` + names.map((n, i) => `<sheet name="${esc(n)}" sheetId="${i + 1}" r:id="rId${i + 1}"/>`).join("") + "</sheets>" + (sheets.some((s) => s.autoFilter && s.freezeRows) ? `<definedNames>${sheets.map((s, i) => {
+      data: `${XML}<workbook xmlns="${NS}" xmlns:r="${REL_NS}"><sheets>` + names.map((n, i) => `<sheet name="${esc(n)}" sheetId="${i + 1}" r:id="rId${i + 1}"/>`).join("") + "</sheets>" + (sheets.some((s) => s.autoFilter && s.freezeRows || s.printTitleRows) ? `<definedNames>${sheets.map((s, i) => {
         const w = Math.max(0, ...s.rows.map((r) => r.length));
-        return s.autoFilter && s.freezeRows && w ? `<definedName name="_xlnm._FilterDatabase" localSheetId="${i}" hidden="1">'${esc(names[i].replace(/'/g, "''"))}'!$A$${s.freezeRows}:$${colName(w - 1)}$${s.rows.length}</definedName>` : "";
+        const ref = `'${esc(names[i].replace(/'/g, "''"))}'`;
+        const filter = s.autoFilter && s.freezeRows && w ? `<definedName name="_xlnm._FilterDatabase" localSheetId="${i}" hidden="1">${ref}!$A$${s.freezeRows}:$${colName(w - 1)}$${s.rows.length}</definedName>` : "";
+        const n = Math.min(s.printTitleRows ?? 0, s.rows.length);
+        const titles = n > 0 && Number.isInteger(n) ? `<definedName name="_xlnm.Print_Titles" localSheetId="${i}">${ref}!$1:$${n}</definedName>` : "";
+        return filter + titles;
       }).join("")}</definedNames>` : "") + "</workbook>"
     },
     {
@@ -5071,11 +6231,11 @@ async function readXlsx(input) {
   const shared = parseXml(files.get("xl/sharedStrings.xml"));
   const strings = shared ? tags(shared, "si").map((si) => tags(si, "t").map((t) => t.textContent ?? "").join("")) : [];
   const stylesDoc = parseXml(files.get("xl/styles.xml"));
-  const custom = new Map(stylesDoc ? tags(stylesDoc, "numFmt").map((f) => [Number(f.getAttribute("numFmtId")), f.getAttribute("formatCode") ?? ""]) : []);
+  const custom2 = new Map(stylesDoc ? tags(stylesDoc, "numFmt").map((f) => [Number(f.getAttribute("numFmtId")), f.getAttribute("formatCode") ?? ""]) : []);
   const cellXfs = stylesDoc ? tags(stylesDoc, "cellXfs")[0] : void 0;
   const dateStyle = (cellXfs ? [...cellXfs.children].filter((x) => x.localName === "xf") : []).map((xf) => {
     const id = Number(xf.getAttribute("numFmtId") ?? 0);
-    return BUILTIN_DATE_FMTS.has(id) || custom.has(id) && isDateFormat(custom.get(id));
+    return BUILTIN_DATE_FMTS.has(id) || custom2.has(id) && isDateFormat(custom2.get(id));
   });
   const sheets = [];
   for (const s of tags(workbook, "sheet")) {
@@ -5193,9 +6353,11 @@ tr { break-inside: avoid; page-break-inside: avoid; }
 .num { text-align: right; color: #9ca3af; }
 tr.group td { background: #eef2f7; font-weight: 600; border-top: 1px solid #cbd5e1; break-after: avoid; page-break-after: avoid; }
 tr.group.level-0 td { background: #e2e8f0; }
+tr.title td { border: 0; padding: 0 0 4px; background: none; }
 tr.total td { font-weight: 700; background: #f3f4f6; border-top: 1.5px solid #111827; border-bottom: 0; }
 `;
-function buildPrintHtml(grid, opts = {}) {
+var colorOk = (c) => typeof c === "string" && /^(#[0-9a-f]{3,8}|[a-z]+|rgba?\([\d\s.,%]+\)|hsla?\([\d\s.,%deg]+\))$/i.test(c.trim()) ? c.trim() : void 0;
+function printModel(grid, opts = {}) {
   const cols = exportColumns(grid, opts.columns);
   const loc = grid.store.state.locale;
   const code = loc.code;
@@ -5210,23 +6372,24 @@ function buildPrintHtml(grid, opts = {}) {
   });
   const depth = Math.max(1, ...chains.map((ch) => ch.length));
   const head = [];
-  for (let level = 0; level < depth; level++) {
-    let tr = level === 0 && numbered ? `<th class="num" rowspan="${depth}">#</th>` : "";
-    for (let ci = 0; ci < cols.length; ci++) {
-      const chain = chains[ci];
-      const leaf = chain.length - 1;
-      if (level < leaf) {
-        const g = chain[level];
-        if (ci > 0 && chains[ci - 1][level] === g) continue;
-        let span = 1;
-        while (ci + span < cols.length && chains[ci + span][level] === g) span++;
-        tr += `<th colspan="${span}"${span > 1 ? ' class="span"' : ""}>${escHtml(header(g.def, g.id))}</th>`;
-      } else if (level === leaf) {
-        const a = align(cols[ci].def);
-        tr += `<th colspan="1" rowspan="${depth - level}"${a === "left" ? "" : ` style="text-align:${a}"`}>${escHtml(header(cols[ci].def, cols[ci].id))}</th>`;
-      }
-    }
-    head.push(`<tr>${tr}</tr>`);
+  if (opts.headers !== false) {
+    for (let level = 0; level < depth; level++) {
+      const tr = level === 0 && numbered ? [{ text: "#", align: "right", num: true, rowspan: depth }] : [];
+      for (let ci = 0; ci < cols.length; ci++) {
+        const chain = chains[ci];
+        const leaf = chain.length - 1;
+        if (level < leaf) {
+          const g = chain[level];
+          if (ci > 0 && chains[ci - 1][level] === g) continue;
+          let span = 1;
+          while (ci + span < cols.length && chains[ci + span][level] === g) span++;
+          tr.push({ text: header(g.def, g.id), align: span > 1 ? "center" : "left", span, group: true });
+        } else if (level === leaf) {
+          tr.push({ text: header(cols[ci].def, cols[ci].id), align: align(cols[ci].def), span: 1, rowspan: depth - level });
+        }
+      }
+      head.push(tr);
+    }
   }
   const aggText = (c, i, v, agg) => {
     if (v == null || v === "") return "";
@@ -5234,64 +6397,75 @@ function buildPrintHtml(grid, opts = {}) {
     const type = c.def.type ?? (typeof v === "number" ? "number" : v instanceof Date ? "date" : void 0);
     return type === c.def.type ? fmts[i](v) : getFormatter({ ...c.def, type }, code)(v);
   };
-  const labelled = (cls, label, values, indent = 0) => {
+  const labelled = (kind, label, values, level = 0) => {
     let lead = 0;
     while (lead < cols.length - 1 && !values[lead]) lead++;
     lead = Math.max(1, lead);
-    let tr = numbered ? '<td class="num"></td>' : "";
-    tr += `<td colspan="${lead}"${indent ? ` style="padding-left:${7 + indent * 14}px"` : ""}>${escHtml(label)}</td>`;
-    for (let i = lead; i < cols.length; i++) tr += `<td style="text-align:${align(cols[i].def)}">${escHtml(values[i] ?? "")}</td>`;
-    return `<tr class="${cls}">${tr}</tr>`;
+    const cells = numbered ? [{ text: "", align: "right", num: true }] : [];
+    cells.push({ text: label, align: "left", span: lead, indent: level });
+    for (let i = lead; i < cols.length; i++) cells.push({ text: values[i] ?? "", align: align(cols[i].def) });
+    return { kind, level, cells };
   };
   const rows = exportRows(grid, opts.rows);
   const groupBy = opts.groups !== false && !grid.rowModel.server && !grid.options.treeData ? grid.getGroupBy() : [];
   const probe = opts.styles !== false && cols.some((c) => c.def.cellClass) ? classStyles(grid) : null;
-  let body = "";
+  const body = [];
   try {
-    for (const line of printLines(grid, rows, groupBy)) {
-      if (line.kind === "group") {
-        const def = grid.columns.getNode(line.colId)?.def;
-        const value = isBlank(line.value) ? loc.blanks : def ? getFormatter(def, code)(line.value) : String(line.value);
-        const label = `${def ? header(def, line.colId) : line.colId}: ${value} (${nf.format(line.rows.length)})`;
+    for (const line2 of printLines(grid, rows, groupBy)) {
+      if (line2.kind === "group") {
+        const def = grid.columns.getNode(line2.colId)?.def;
+        const value = isBlank(line2.value) ? loc.blanks : def ? getFormatter(def, code)(line2.value) : String(line2.value);
+        const label = `${def ? header(def, line2.colId) : line2.colId}: ${value} (${nf.format(line2.rows.length)})`;
         const values = cols.map((c, i) => {
           if (!c.def.aggFunc || groupBy.includes(c.id)) return void 0;
           try {
-            return aggText(c, i, aggregate(c.def.aggFunc, line.rows.map((r2) => getCellValue(c.def, r2)), line.rows), c.def.aggFunc) || void 0;
+            return aggText(c, i, aggregate(c.def.aggFunc, line2.rows.map((r2) => getCellValue(c.def, r2)), line2.rows), c.def.aggFunc) || void 0;
           } catch {
             return void 0;
           }
         });
-        body += labelled(`group level-${Math.min(line.level, 5)}`, label, values, line.level);
+        body.push(labelled("group", label, values, line2.level));
         continue;
       }
-      const r = line.row;
-      let tr = numbered ? `<td class="num">${line.n}</td>` : "";
+      const r = line2.row;
+      const cells = numbered ? [{ text: String(line2.n), align: "right", num: true }] : [];
       cols.forEach((c, i) => {
         const v = getCellValue(c.def, r);
         const text2 = isBlank(v) ? "" : fmts[i](v);
-        let style = `text-align:${align(c.def)}`;
+        const cell = { text: text2, align: align(c.def) };
         if (probe && c.def.cellClass) {
           let cls;
           try {
-            cls = typeof c.def.cellClass === "function" ? c.def.cellClass({ value: v, formatted: text2, row: r, rowIndex: line.n - 1, column: c.def }) : c.def.cellClass;
+            cls = typeof c.def.cellClass === "function" ? c.def.cellClass({ value: v, formatted: text2, row: r, rowIndex: line2.n - 1, column: c.def }) : c.def.cellClass;
           } catch {
             cls = void 0;
           }
           if (cls) {
             const st = probe.of(cls);
-            if (st.color) style += `;color:${hexOf(st.color)}`;
-            if (st.fill) style += `;background:${hexOf(st.fill)}`;
-            if (st.bold) style += ";font-weight:600";
+            if (st.color) cell.color = hexOf(st.color);
+            if (st.fill) cell.fill = hexOf(st.fill);
+            if (st.bold) cell.bold = true;
           }
         }
-        tr += `<td style="${style}">${escHtml(text2)}</td>`;
+        const cf = opts.styles !== false ? grid.cellFormat(r, c.id, v) : null;
+        if (cf) {
+          const s = cf.style;
+          if (colorOk(s.color)) cell.color = colorOk(s.color);
+          if (colorOk(s.background)) cell.fill = colorOk(s.background);
+          if (s.bold) cell.bold = true;
+          if (s.italic) cell.italic = true;
+          if (s.strike) cell.strike = true;
+          if (cf.bar) cell.bar = { from: cf.bar.from, to: cf.bar.to, color: /^#[0-9a-f]{3,8}$/i.test(cf.bar.color) ? cf.bar.color : "#93c5fd" };
+          if (cf.icon) cell.icon = { char: cf.icon.char, color: cf.icon.color };
+        }
+        cells.push(cell);
       });
-      body += `<tr>${tr}</tr>`;
+      body.push({ kind: "row", cells });
     }
   } finally {
     probe?.dispose();
   }
-  let foot = "";
+  const foot = [];
   const summary = opts.summary !== false ? grid.summary() : null;
   if (summary) {
     summary.opts.rows.forEach((def, ri) => {
@@ -5299,29 +6473,89 @@ function buildPrintHtml(grid, opts = {}) {
         const spec = def.columns?.[c.id];
         return spec === void 0 ? void 0 : aggText(c, i, summary.values[ri]?.[c.id], cellSpec(spec).agg) || void 0;
       });
-      foot += labelled("total", def.label ?? "", values);
+      foot.push(labelled("total", def.label ?? "", values));
     });
   }
   const widths = cols.map((c) => Math.max(1, c.width));
   const sum = widths.reduce((a, b) => a + b, 0);
   const paper = PAPERS.includes(opts.paper) ? opts.paper : "A4";
   const orientation = opts.orientation === "portrait" || opts.orientation === "landscape" ? opts.orientation : sum + (numbered ? 40 : 0) > PORTRAIT_WIDTH ? "landscape" : "portrait";
-  const fit = opts.fitToWidth !== false;
-  const colgroup = fit ? `<colgroup>${numbered ? '<col style="width:40px">' : ""}${widths.map((w) => `<col style="width:${Math.round(w / sum * 1e3) / 10}%">`).join("")}</colgroup>` : "";
-  const title = escHtml(opts.title ?? document.title ?? "");
   const printed = opts.printedAt !== false ? new Intl.DateTimeFormat(code, { dateStyle: "medium", timeStyle: "short" }).format(/* @__PURE__ */ new Date()) : "";
-  const heading = opts.title || opts.subtitle ? `<div>${opts.title ? `<h1>${title}</h1>` : ""}${opts.subtitle ? `<p class="sub">${escHtml(opts.subtitle)}</p>` : ""}</div>` : "<div></div>";
-  const top = opts.title || opts.subtitle || printed ? `<header>${heading}${printed ? `<p class="printed">${escHtml(printed)}</p>` : ""}</header>` : "";
+  const repeatRows = Number.isInteger(opts.repeatRows) && opts.repeatRows > 0 ? Math.min(opts.repeatRows, body.length) : 0;
+  return {
+    lang: code,
+    title: opts.title ?? "",
+    subtitle: opts.subtitle ?? "",
+    printed,
+    footer: opts.footer ?? "",
+    paper,
+    orientation,
+    fit: opts.fitToWidth !== false,
+    numbered,
+    widths: numbered ? [40, ...widths] : widths,
+    head,
+    body,
+    foot,
+    striped: opts.striped !== false,
+    pageNumbers: opts.pageNumbers !== false,
+    repeatHeader: opts.repeatHeader !== false,
+    repeatTitle: !!opts.repeatTitle,
+    repeatRows
+  };
+}
+function cellCss(c, head = false) {
+  let s = head ? c.align === "left" || c.group ? "" : `text-align:${c.align}` : `text-align:${c.align}`;
+  const add = (x) => {
+    s += s ? `;${x}` : x;
+  };
+  if (c.indent) add(`padding-left:${7 + c.indent * 14}px`);
+  if (c.color) add(`color:${c.color}`);
+  if (c.fill) add(`background:${c.fill}`);
+  if (c.bold) add("font-weight:600");
+  if (c.italic) add("font-style:italic");
+  if (c.strike) add("text-decoration:line-through");
+  if (c.bar) {
+    const from = (c.bar.from * 100).toFixed(1), to = (c.bar.to * 100).toFixed(1);
+    add(`background-image:linear-gradient(to right,transparent ${from}%,${c.bar.color}66 ${from}%,${c.bar.color}66 ${to}%,transparent ${to}%)`);
+  }
+  return s;
+}
+function cellHtml(c, tag) {
+  const attrs = [
+    c.num ? ' class="num"' : c.group && (c.span ?? 1) > 1 ? ' class="span"' : "",
+    c.span !== void 0 && (tag === "th" || c.span > 1) ? ` colspan="${c.span}"` : "",
+    c.rowspan !== void 0 && tag === "th" ? ` rowspan="${c.rowspan}"` : ""
+  ].join("");
+  if (c.num) return `<${tag}${attrs}>${escHtml(c.text)}</${tag}>`;
+  const css = cellCss(c, tag === "th");
+  const icon = c.icon ? `<span style="color:${escHtml(c.icon.color)};margin-right:5px">${escHtml(c.icon.char)}</span>` : "";
+  return `<${tag}${attrs}${css ? ` style="${escHtml(css)}"` : ""}>${icon}${escHtml(c.text)}</${tag}>`;
+}
+var lineHtml = (l) => `<tr${l.kind === "group" ? ` class="group level-${Math.min(l.level ?? 0, 5)}"` : l.kind === "total" ? ' class="total"' : ""}>${l.cells.map((c) => cellHtml(c, "td")).join("")}</tr>`;
+function buildPrintHtml(grid, opts = {}) {
+  const m = printModel(grid, opts);
+  const sum = m.widths.slice(m.numbered ? 1 : 0).reduce((a, b) => a + b, 0);
+  const colgroup = m.fit ? `<colgroup>${m.numbered ? '<col style="width:40px">' : ""}${m.widths.slice(m.numbered ? 1 : 0).map((w) => `<col style="width:${Math.round(w / sum * 1e3) / 10}%">`).join("")}</colgroup>` : "";
+  const title = escHtml(m.title || (typeof document !== "undefined" ? document.title : "") || "");
+  const heading = m.title || m.subtitle ? `<div>${m.title ? `<h1>${title}</h1>` : ""}${m.subtitle ? `<p class="sub">${escHtml(m.subtitle)}</p>` : ""}</div>` : "<div></div>";
+  const top = m.title || m.subtitle || m.printed ? `<header>${heading}${m.printed ? `<p class="printed">${escHtml(m.printed)}</p>` : ""}</header>` : "";
   const small = "font: 8.5px system-ui, sans-serif; color: #6b7280;";
   const page = [
-    `size: ${paper} ${orientation}; margin: 12mm 12mm 14mm;`,
-    opts.footer ? `@bottom-left { content: ${cssStr(opts.footer)}; ${small} }` : "",
-    opts.pageNumbers !== false ? `@bottom-right { content: counter(page) " / " counter(pages); ${small} }` : ""
+    `size: ${m.paper} ${m.orientation}; margin: 12mm 12mm 14mm;`,
+    m.footer ? `@bottom-left { content: ${cssStr(m.footer)}; ${small} }` : "",
+    m.pageNumbers ? `@bottom-right { content: counter(page) " / " counter(pages); ${small} }` : ""
   ].join(" ");
-  const stripes = opts.striped !== false ? "tbody tr:not(.group):nth-child(even) td { background: #f9fafb; }" : "";
-  return `<!doctype html><html lang="${escHtml(code)}"><head><meta charset="utf-8"><title>${title}</title><style>
+  const stripes = m.striped ? "tbody tr:not(.group):nth-child(even) td { background: #f9fafb; }" : "";
+  const headRows = m.head.map((tr) => `<tr>${tr.map((c) => cellHtml(c, "th")).join("")}</tr>`).join("");
+  const repeated = m.body.slice(0, m.repeatRows).map(lineHtml).join("");
+  const span = Math.max(1, m.widths.length);
+  const titleRow = m.repeatTitle && top ? `<tr class="title"><td colspan="${span}">${top}</td></tr>` : "";
+  const thead = m.repeatHeader ? `${titleRow}${headRows}${repeated}` : `${titleRow}${repeated}`;
+  const body = (m.repeatHeader ? "" : headRows) + m.body.slice(m.repeatRows).map(lineHtml).join("");
+  const foot = m.foot.map(lineHtml).join("");
+  return `<!doctype html><html lang="${escHtml(m.lang)}"><head><meta charset="utf-8"><title>${title}</title><style>
 @page { ${page} }${PRINT_CSS}${stripes}
-</style></head><body>${top}<table${fit ? ' class="fit"' : ""}>${colgroup}<thead>${opts.headers === false ? "" : head.join("")}</thead><tbody>${body}</tbody>${foot ? `<tfoot>${foot}</tfoot>` : ""}</table></body></html>`;
+</style></head><body>${m.repeatTitle ? "" : top}<table${m.fit ? ' class="fit"' : ""}>${colgroup}<thead>${thead}</thead><tbody>${body}</tbody>${foot ? `<tfoot>${foot}</tfoot>` : ""}</table></body></html>`;
 }
 function printHtml(html) {
   if (typeof document === "undefined") return;
@@ -5363,6 +6597,22 @@ function buildCsv(grid, opts = {}) {
   if (opts.headers !== false) matrix.unshift(cols.map((c) => ({ value: header(c.def, c.id), text: true })));
   return toCsv(matrix, sep);
 }
+function buildJson(grid, opts = {}) {
+  const cols = exportColumns(grid, opts.columns);
+  const code = grid.store.state.locale.code;
+  const fmts = opts.formatted ? cols.map((c) => getFormatter(c.def, code)) : null;
+  const keys = cols.map((c) => opts.keys === "header" ? header(c.def, c.id) : c.id);
+  const rows = exportRows(grid, opts.rows).map((r) => {
+    const o = {};
+    cols.forEach((c, i) => {
+      const v = getCellValue(c.def, r);
+      o[keys[i]] = fmts ? isBlank(v) ? "" : fmts[i](v) : v === void 0 ? null : v;
+    });
+    return o;
+  });
+  const space = typeof opts.space === "number" && opts.space >= 0 ? Math.min(10, opts.space) : 2;
+  return JSON.stringify(rows, null, space);
+}
 function excelFormat(def) {
   const f = def.format;
   if (def.type === "date") {
@@ -5385,9 +6635,9 @@ function excelFormat(def) {
   return `${o.useGrouping === false ? "0" : "#,##0"}${decimals}`;
 }
 function toArgb(css) {
-  const hex = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(css.trim());
-  if (hex) {
-    const h = hex[1].length === 3 ? [...hex[1]].map((c) => c + c).join("") : hex[1];
+  const hex2 = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(css.trim());
+  if (hex2) {
+    const h = hex2[1].length === 3 ? [...hex2[1]].map((c) => c + c).join("") : hex2[1];
     return `FF${h.toUpperCase()}`;
   }
   const m = /^rgba?\(\s*(\d+)[\s,]+(\d+)[\s,]+(\d+)(?:[\s,/]+([\d.]+%?))?\s*\)$/i.exec(css.trim());
@@ -5486,7 +6736,7 @@ function buildXlsxSheet(grid, opts = {}) {
         return Number.isFinite(n) ? { v: n, fmt } : String(v);
       }
       case "date": {
-        const d = toDate(v);
+        const d = toDate2(v);
         return d ? { v: d, fmt } : String(v);
       }
       case "boolean":
@@ -5511,6 +6761,13 @@ function buildXlsxSheet(grid, opts = {}) {
           }
           if (cls) style = { ...style, ...probe.of(cls) };
         }
+        const cf = grid.cellFormat(r, c.id, v);
+        if (cf) {
+          const color = argbOf(cf.style.color), fill = argbOf(cf.style.background);
+          if (color) style.color = color;
+          if (fill) style.fill = fill;
+          if (cf.style.bold) style.bold = true;
+        }
         if (!Object.keys(style).length) return cell;
         return cell !== null && typeof cell === "object" && !(cell instanceof Date) ? { ...cell, ...style } : { v: cell, ...style };
       }));
@@ -5544,6 +6801,8 @@ function buildXlsxSheet(grid, opts = {}) {
     widths: cols.map((c) => Math.round(c.width / 7)),
     merges,
     freezeRows: headRows,
+    // header rows (and repeatRows data rows) print on every page
+    printTitleRows: opts.repeatHeader === false ? 0 : headRows + (Number.isInteger(opts.repeatRows) && opts.repeatRows > 0 ? opts.repeatRows : 0),
     autoFilter: headRows > 0
   };
 }
@@ -5612,13 +6871,13 @@ async function importInto(grid, file, opts = {}) {
   const sample = grid.store.state.data[0];
   let skipped = 0;
   const rows = [];
-  for (const line of matrix.slice(headRows)) {
-    if (!line || line.every((v) => v === null || v === void 0 || String(v).trim() === "")) continue;
+  for (const line2 of matrix.slice(headRows)) {
+    if (!line2 || line2.every((v) => v === null || v === void 0 || String(v).trim() === "")) continue;
     const row = {};
     mapped.forEach((node, i) => {
       if (!node) return;
       const def = node.def;
-      const raw = asText(line[i]);
+      const raw = asText(line2[i]);
       const res = grid.acceptText(def, row, raw, sample?.[def.field]);
       if (res.ok) {
         if (!(raw === "" && (res.value === null || res.value === ""))) row[def.field] = res.value;
@@ -6094,7 +7353,7 @@ function buildPivot(source, config, defOf, labels, locale) {
 }
 
 // src/version.ts
-var version = "1.1.0";
+var version = "1.6.0";
 
 // src/license.ts
 var PUBLIC_KEY = { kty: "EC", crv: "P-256", x: "sUTKkglZmk-HMKPNub8p7AeLBKesHCU8irIkw9rJlbE", y: "j0U_aKRDR7iApY9UpaD3hUemhBLZJwDv9-QiT_hUyw8" };
@@ -6282,6 +7541,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)]);
     popup.append(this.section(items));
     const filter = this.filterSection(colId, () => this.close());
     if (filter) popup.append(filter);
@@ -6328,11 +7588,11 @@ var ColumnMenu = class {
   }
   section(items) {
     const s = el("div", "fg-menu-section");
-    for (const [label, run] of items) {
+    for (const [label, run2] of items) {
       const b = el("button", "fg-menu-item", { type: "button" });
       b.textContent = label;
       b.addEventListener("click", () => {
-        run();
+        run2();
         this.close();
       });
       s.append(b);
@@ -7464,6 +8724,611 @@ var FilterBuilder = class {
   }
 };
 
+// src/interactions/formatDialog.ts
+var CF_PRESETS = [
+  { key: "red", style: { background: "#ffc7ce", color: "#9c0006" } },
+  { key: "yellow", style: { background: "#ffeb9c", color: "#9c5700" } },
+  { key: "green", style: { background: "#c6efce", color: "#006100" } },
+  { key: "blue", style: { background: "#dbeafe", color: "#1e3a8a" } },
+  { key: "redText", style: { color: "#dc2626" } },
+  { key: "bold", style: { bold: true } }
+];
+var TYPES2 = ["value", "formula", "top", "bottom", "aboveAverage", "belowAverage", "duplicate", "unique", "dataBar", "colorScale", "iconSet"];
+var OPS2 = ["gt", "gte", "lt", "lte", "eq", "ne", "between", "notBetween", "contains", "notContains", "startsWith", "endsWith", "blank", "notBlank"];
+var NO_VALUE3 = ["blank", "notBlank"];
+var SCALES = ["dataBar", "colorScale", "iconSet"];
+var FormatDialog = class {
+  constructor(grid) {
+    this.grid = grid;
+    this.popup = null;
+    this.off = [];
+  }
+  get isOpen() {
+    return !!this.popup;
+  }
+  open(colId) {
+    this.close();
+    const { grid } = this;
+    const node = grid.columns.getNode(colId);
+    if (!node || node.children || isSystemCol(colId)) return;
+    const loc = grid.store.state.locale;
+    const cf = loc.cf;
+    const label = node.def.header ?? node.def.field ?? colId;
+    const popup = el("div", `fg-menu fg-cf-dialog fg-theme-${grid.store.state.theme}`, { role: "dialog", "aria-label": `${cf.title}: ${label}` });
+    grid.applyFontTo(popup);
+    const head = el("div", "fg-chooser-head");
+    const title = el("span", "fg-menu-title");
+    title.textContent = `${cf.title} \xB7 ${label}`;
+    const x = el("button", "fg-chooser-close", { type: "button", "aria-label": loc.close });
+    x.textContent = "\xD7";
+    x.addEventListener("click", () => this.close());
+    head.append(title, x);
+    const list = el("div", "fg-cf-list");
+    const opName = (op) => cf.ops[op] ?? loc.ops[op] ?? op;
+    const describe = (r2) => {
+      const type = r2.type ?? "value";
+      const name = cf.types[type];
+      if (type === "value") {
+        const op = r2.op ?? "eq";
+        if (NO_VALUE3.includes(op)) return opName(op);
+        return `${opName(op)} ${String(r2.value ?? "")}${op === "between" || op === "notBetween" ? ` \u2013 ${String(r2.valueTo ?? "")}` : ""}`;
+      }
+      if (type === "formula") return `${name}: ${r2.formula ?? ""}`;
+      if (type === "top" || type === "bottom") return `${name} ${r2.rank ?? 10}${r2.percent ? "%" : ""}`;
+      return name;
+    };
+    const paintList = () => {
+      list.replaceChildren();
+      const all2 = grid.getConditionalFormats();
+      const mine = all2.map((r2, i) => ({ r: r2, i })).filter(({ r: r2 }) => r2.columns.includes(colId));
+      if (!mine.length) {
+        const empty = el("div", "fg-cf-empty");
+        empty.textContent = cf.none;
+        list.append(empty);
+        return;
+      }
+      for (const { r: r2, i } of mine) {
+        const row = el("div", "fg-cf-rule");
+        const sample = el("span", "fg-cf-sample", { "aria-hidden": "true" });
+        sample.textContent = r2.type === "iconSet" ? "\u25B2" : r2.type === "dataBar" ? "\u25AC" : "Aa";
+        if (r2.style?.background) sample.style.background = r2.style.background;
+        if (r2.style?.color) sample.style.color = r2.style.color;
+        if (r2.style?.bold) sample.style.fontWeight = "700";
+        if (r2.type === "colorScale") sample.style.background = `linear-gradient(to right, ${(r2.colors ?? ["#f8696b", "#ffeb84", "#63be7b"]).join(",")})`;
+        const text2 = el("span", "fg-cf-rule-text");
+        text2.textContent = `${describe(r2)}${r2.row ? ` \xB7 ${cf.wholeRow}` : ""}`;
+        text2.title = text2.textContent;
+        const del = el("button", "fg-chooser-close", { type: "button", "aria-label": `${loc.close}: ${text2.textContent}` });
+        del.textContent = "\xD7";
+        del.addEventListener("click", () => {
+          const next = grid.getConditionalFormats();
+          const rule = next[i];
+          rule.columns = rule.columns.filter((c) => c !== colId);
+          grid.setConditionalFormats(next.filter((f) => f.columns.length));
+          paintList();
+        });
+        row.append(sample, text2, del);
+        list.append(row);
+      }
+    };
+    paintList();
+    const form = el("div", "fg-cf-form");
+    const typeSel = el("select", "fg-filter-op fg-cf-wide fg-cf-type", { "aria-label": cf.type });
+    for (const t of TYPES2) {
+      const o = el("option");
+      o.value = t;
+      o.textContent = cf.types[t];
+      typeSel.append(o);
+    }
+    const opSel = el("select", "fg-filter-op fg-cf-wide fg-cf-op", { "aria-label": loc.filter });
+    for (const op of OPS2) {
+      const o = el("option");
+      o.value = op;
+      o.textContent = opName(op);
+      opSel.append(o);
+    }
+    const numeric = node.def.type === "number";
+    const v1 = el("input", "fg-input fg-cf-value", { type: numeric ? "number" : "text", placeholder: loc.value, "aria-label": loc.value });
+    const v2 = el("input", "fg-input fg-cf-value-to", { type: numeric ? "number" : "text", placeholder: loc.valueTo, "aria-label": loc.valueTo });
+    const formula = el("input", "fg-input fg-cf-wide fg-cf-formula", { type: "text", placeholder: `=${node.def.field ?? colId} > 100`, "aria-label": cf.types.formula, spellcheck: "false" });
+    const rank = el("input", "fg-input fg-cf-rank", { type: "number", min: "1", value: "10", "aria-label": cf.count });
+    const pctLabel = el("label", "fg-cf-pct");
+    const pct = el("input", "", { type: "checkbox" });
+    pctLabel.append(pct, " %");
+    const swatches = el("div", "fg-cf-swatches fg-cf-wide", { role: "group", "aria-label": cf.style });
+    let preset = 0;
+    CF_PRESETS.forEach((p, k) => {
+      const b = el("button", "fg-cf-swatch", { type: "button", "aria-label": cf.styles[p.key], title: cf.styles[p.key], "aria-pressed": String(k === preset) });
+      b.textContent = p.key === "bold" ? "B" : "Aa";
+      if (p.style.background) b.style.background = p.style.background;
+      if (p.style.color) b.style.color = p.style.color;
+      b.addEventListener("click", () => {
+        preset = k;
+        for (const s of swatches.children) s.setAttribute("aria-pressed", String(s === b));
+      });
+      swatches.append(b);
+    });
+    const rowLabel = el("label", "fg-cf-wide fg-cf-row");
+    const rowBox = el("input", "", { type: "checkbox" });
+    rowLabel.append(rowBox, ` ${cf.wholeRow}`);
+    form.append(typeSel, opSel, v1, v2, formula, rank, pctLabel, swatches, rowLabel);
+    const sync = () => {
+      const t = typeSel.value;
+      const op = opSel.value;
+      opSel.hidden = t !== "value";
+      v1.hidden = t !== "value" || NO_VALUE3.includes(op);
+      v2.hidden = t !== "value" || op !== "between" && op !== "notBetween";
+      formula.hidden = t !== "formula";
+      rank.hidden = pctLabel.hidden = t !== "top" && t !== "bottom";
+      swatches.hidden = SCALES.includes(t);
+      rowLabel.hidden = t !== "value" && t !== "formula";
+    };
+    typeSel.addEventListener("change", sync);
+    opSel.addEventListener("change", sync);
+    sync();
+    const read = () => {
+      const type = typeSel.value;
+      const rule = { columns: [colId], type };
+      const val = (input) => numeric && input.value !== "" ? Number(input.value) : input.value;
+      if (type === "value") {
+        rule.op = opSel.value;
+        if (!NO_VALUE3.includes(rule.op)) {
+          if (v1.value === "") return null;
+          rule.value = val(v1);
+          if (rule.op === "between" || rule.op === "notBetween") {
+            if (v2.value === "") return null;
+            rule.valueTo = val(v2);
+          }
+        }
+      } else if (type === "formula") {
+        const f = formula.value.trim();
+        if (!f) return null;
+        rule.formula = f.startsWith("=") ? f : `=${f}`;
+      } else if (type === "top" || type === "bottom") {
+        rule.rank = Math.max(1, Math.floor(Number(rank.value) || 10));
+        if (pct.checked) rule.percent = true;
+      }
+      if (!SCALES.includes(type)) rule.style = { ...CF_PRESETS[preset].style };
+      if (rowBox.checked && (type === "value" || type === "formula")) rule.row = true;
+      return rule;
+    };
+    const actions = el("div", "fg-menu-actions");
+    const clear = el("button", "fg-btn", { type: "button" });
+    clear.textContent = cf.clear;
+    clear.addEventListener("click", () => {
+      grid.setConditionalFormats(grid.getConditionalFormats().map((r2) => ({ ...r2, columns: r2.columns.filter((c) => c !== colId) })).filter((r2) => r2.columns.length));
+      paintList();
+    });
+    const add = el("button", "fg-btn fg-btn-primary", { type: "button" });
+    add.textContent = cf.add;
+    add.addEventListener("click", () => {
+      const rule = read();
+      if (!rule) {
+        (typeSel.value === "formula" ? formula : v1).focus();
+        return;
+      }
+      grid.setConditionalFormats([...grid.getConditionalFormats(), rule]);
+      v1.value = v2.value = formula.value = "";
+      paintList();
+    });
+    actions.append(clear, add);
+    popup.append(head, list, form, actions);
+    popupParent(grid.renderer.root).append(popup);
+    const r = grid.renderer.root.getBoundingClientRect();
+    const w = popup.offsetWidth || 340;
+    popup.style.left = `${Math.max(4, Math.min(r.left + 24, (window.innerWidth || 1024) - w - 4))}px`;
+    popup.style.top = `${Math.max(4, r.top + 24)}px`;
+    this.popup = popup;
+    typeSel.focus();
+    const onDown = (e) => {
+      if (!eventInside(e, popup)) this.close();
+    };
+    const onKey = (e) => {
+      if (e.key === "Escape") this.close();
+    };
+    document.addEventListener("pointerdown", onDown, true);
+    document.addEventListener("keydown", onKey, true);
+    this.off.push(
+      () => document.removeEventListener("pointerdown", onDown, true),
+      () => document.removeEventListener("keydown", onKey, true)
+    );
+  }
+  close() {
+    for (const f of this.off) f();
+    this.off = [];
+    this.popup?.remove();
+    this.popup = null;
+  }
+};
+
+// src/assistant.ts
+var FILTER_TYPES = ["text", "number", "date", "set", "combined"];
+var CHART_TYPES = ["bar", "stackedBar", "line", "area", "pie", "donut", "combo", "scatter"];
+var MAX_ACTIONS = 30;
+function describeColumn(grid, id, def, rows) {
+  const col = { id, header: def.header ?? def.field ?? id };
+  if (def.type) col.type = def.type;
+  if (def.formula) col.formula = def.formula;
+  if (def.aggFunc && typeof def.aggFunc === "string") col.aggFunc = def.aggFunc;
+  let blanks = 0;
+  const counts = /* @__PURE__ */ new Map();
+  let min = Infinity, max = -Infinity, sum = 0, nums = 0;
+  let minText = "", maxText = "";
+  for (const r of rows) {
+    const v = getCellValue(def, r);
+    if (isBlank(v)) {
+      blanks++;
+      continue;
+    }
+    if (typeof v === "number" && Number.isFinite(v)) {
+      nums++;
+      sum += v;
+      if (v < min) min = v;
+      if (v > max) max = v;
+    } else if (def.type === "date") {
+      const t = v instanceof Date ? v.toISOString().slice(0, 10) : String(v);
+      if (!minText || t < minText) minText = t;
+      if (!maxText || t > maxText) maxText = t;
+    }
+    if (counts.size < 5e3) {
+      const k = setKey(v);
+      const c = counts.get(k);
+      if (c) c.n++;
+      else counts.set(k, { value: v, n: 1 });
+    }
+  }
+  col.blanks = blanks;
+  col.distinct = counts.size;
+  if (nums) Object.assign(col, { min, max, avg: Math.round(sum / nums * 1e3) / 1e3 });
+  if (minText) Object.assign(col, { min: minText, max: maxText });
+  if (!nums && counts.size) {
+    col.top = [...counts.values()].sort((a, b) => b.n - a.n).slice(0, 12).map((c) => ({ value: String(c.value).slice(0, 80), count: c.n }));
+  }
+  return col;
+}
+function assistantRequest(grid, prompt, options) {
+  const rows = grid.rowModel.dataRows().map((n) => n.data);
+  const all2 = grid.columns.getState().map((s2) => grid.columns.getNode(s2.colId)).filter((n) => n && !n.children && !isSystemCol(n.id));
+  const columns = all2.map((n) => ({ ...describeColumn(grid, n.id, n.def, rows), hidden: grid.columns.getState().find((s2) => s2.colId === n.id)?.hide || void 0 }));
+  const sampleN = typeof options.sampleRows === "number" && options.sampleRows >= 0 ? Math.min(50, options.sampleRows) : 5;
+  const sample = rows.slice(0, sampleN).map((r) => Object.fromEntries(all2.map((n) => [n.id, getCellValue(n.def, r)])));
+  const s = grid.store.state;
+  return {
+    prompt: String(prompt).slice(0, 2e3),
+    locale: s.locale.code,
+    rowCount: rows.length,
+    totalRows: grid.rowModel.server ? rows.length : grid.store.state.data.length,
+    columns,
+    sample,
+    state: {
+      sort: s.sort,
+      filters: s.filters,
+      quickFilter: s.quickFilter,
+      advancedFilter: s.advancedFilter,
+      groupBy: grid.getGroupBy(),
+      pivot: grid.getPivot(),
+      conditionalFormats: grid.getConditionalFormats()
+    },
+    ...options.context ? { context: options.context() } : {}
+  };
+}
+function applyAssistantActions(grid, actions) {
+  const before = { state: grid.api.getState(), defs: grid.columnDefs(), summary: grid.summaryOptions() };
+  const applied = [];
+  const skipped = [];
+  const charts = [];
+  const list = Array.isArray(actions) ? actions.slice(0, MAX_ACTIONS) : [];
+  const known = (id) => typeof id === "string" && !!grid.columns.getNode(id) && !grid.columns.getNode(id).children && !isSystemCol(id);
+  const ok = (a) => applied.push(a);
+  const skip = (a, reason) => skipped.push({ action: a, reason });
+  for (const raw of list) {
+    const a = raw;
+    if (!a || typeof a !== "object" || typeof a.type !== "string") {
+      skip(raw, "not an action");
+      continue;
+    }
+    try {
+      switch (a.type) {
+        case "sort": {
+          const sort = (Array.isArray(a.sort) ? a.sort : []).filter((x) => !!x && known(x.colId) && (x.dir === "asc" || x.dir === "desc"));
+          if (Array.isArray(a.sort) && sort.length !== a.sort.length) skip(a, "unknown column in sort");
+          grid.setSort(sort.map((x) => ({ colId: x.colId, dir: x.dir })));
+          ok(a);
+          break;
+        }
+        case "filter": {
+          if (!known(a.colId)) {
+            skip(a, "unknown column");
+            break;
+          }
+          const m = a.model;
+          if (m !== null && (!m || typeof m !== "object" || !FILTER_TYPES.includes(m.type))) {
+            skip(a, "bad filter model");
+            break;
+          }
+          grid.setFilter(a.colId, m);
+          ok(a);
+          break;
+        }
+        case "clearFilters":
+          for (const id of Object.keys(grid.store.state.filters)) grid.setFilter(id, null);
+          grid.setAdvancedFilter(null);
+          grid.api.setQuickFilter("");
+          ok(a);
+          break;
+        case "quickFilter":
+          grid.api.setQuickFilter(typeof a.text === "string" ? a.text.slice(0, 200) : "");
+          ok(a);
+          break;
+        case "advancedFilter": {
+          const f = a.filter;
+          const ids = [];
+          const walk = (x) => {
+            const o = x;
+            if (Array.isArray(o?.conditions)) o.conditions.forEach(walk);
+            else ids.push(o?.colId);
+          };
+          if (f) walk(f);
+          if (f && (!Array.isArray(f.conditions) || !ids.every(known))) {
+            skip(a, "unknown column in advanced filter");
+            break;
+          }
+          grid.setAdvancedFilter(f ?? null);
+          ok(a);
+          break;
+        }
+        case "groupBy": {
+          const ids = Array.isArray(a.colIds) ? a.colIds.filter(known) : [];
+          grid.setGroupBy(ids);
+          if (a.expand) grid.expandAll(true);
+          ok(a);
+          break;
+        }
+        case "pivot": {
+          const p = a.pivot;
+          if (p && (!Array.isArray(p.rows) || !Array.isArray(p.values) || !p.rows.every(known) || !(p.columns ?? []).every(known) || !p.values.every((v) => v && known(v.colId)))) {
+            skip(a, "unknown column in pivot");
+            break;
+          }
+          grid.setPivot(p ?? null);
+          ok(a);
+          break;
+        }
+        case "showColumns":
+        case "hideColumns": {
+          const ids = Array.isArray(a.colIds) ? a.colIds.filter(known) : [];
+          if (ids.length) grid.setColumnsVisible(ids, a.type === "showColumns");
+          ok(a);
+          break;
+        }
+        case "conditionalFormat": {
+          const f = a.format;
+          if (!f || !Array.isArray(f.columns) || !f.columns.length || !f.columns.every(known)) {
+            skip(a, "unknown column in format");
+            break;
+          }
+          grid.setConditionalFormats([...grid.getConditionalFormats(), f]);
+          ok(a);
+          break;
+        }
+        case "clearConditionalFormats":
+          grid.setConditionalFormats([]);
+          ok(a);
+          break;
+        case "addColumn": {
+          const c = a.column;
+          if (!c || typeof c.id !== "string" || !/^[\w.-]{1,40}$/.test(c.id) || grid.columns.getNode(c.id)) {
+            skip(a, "bad or taken column id");
+            break;
+          }
+          const f = typeof c.formula === "string" ? c.formula.startsWith("=") ? c.formula : `=${c.formula}` : "";
+          const refs = f ? formulaRefs(f) : null;
+          if (!refs) {
+            skip(a, "formula does not parse");
+            break;
+          }
+          const def = { id: c.id, header: typeof c.header === "string" ? c.header.slice(0, 80) : c.id, formula: f };
+          if (c.type === "number" || c.type === "date" || c.type === "text") def.type = c.type;
+          grid.api.setColumns([...grid.columnDefs(), def]);
+          ok(a);
+          break;
+        }
+        case "summary": {
+          const s = a.summary;
+          if (s && (!Array.isArray(s.rows) || !s.rows.every((r) => r && Object.keys(r.columns ?? {}).every(known)))) {
+            skip(a, "unknown column in summary");
+            break;
+          }
+          grid.setSummary(s ?? null);
+          ok(a);
+          break;
+        }
+        case "chart": {
+          const ids = Array.isArray(a.colIds) ? a.colIds.filter(known) : [];
+          const displayed = grid.columns.displayed().map((c) => c.id);
+          const idx = ids.map((id) => displayed.indexOf(id)).filter((i) => i >= 0);
+          const count = grid.rowModel.getRowCount();
+          if (!idx.length || !count) {
+            skip(a, "nothing to chart");
+            break;
+          }
+          const range = { start: { rowIndex: 0, colId: displayed[Math.min(...idx)] }, end: { rowIndex: Math.min(count, 200) - 1, colId: displayed[Math.max(...idx)] } };
+          charts.push(grid.api.createChart({ type: CHART_TYPES.includes(a.chartType) ? a.chartType : "bar", range, title: typeof a.title === "string" ? a.title.slice(0, 80) : void 0 }));
+          ok(a);
+          break;
+        }
+        case "message":
+          ok(a);
+          break;
+        default:
+          skip(a, "unknown action");
+      }
+    } catch {
+      skip(a, "failed");
+    }
+  }
+  const undo = () => {
+    for (const c of charts) c.destroy();
+    if (grid.columnDefs().length !== before.defs.length || grid.columnDefs().some((d, i) => d !== before.defs[i])) grid.api.setColumns(before.defs);
+    grid.setSummary(before.summary);
+    grid.api.setState(before.state);
+    if (!before.state.conditionalFormats) grid.setConditionalFormats([]);
+  };
+  return { applied, skipped, undo };
+}
+async function askAssistant(grid, prompt, options, signal) {
+  if (!options?.url) throw new Error("assistant.url is not set");
+  const headers = typeof options.headers === "function" ? options.headers() : options.headers ?? {};
+  const res = await fetch(options.url, {
+    method: "POST",
+    credentials: options.credentials ?? "same-origin",
+    headers: { "Content-Type": "application/json", Accept: "application/json", ...headers },
+    body: JSON.stringify(assistantRequest(grid, prompt, options)),
+    signal
+  });
+  if (!res.ok) throw new Error(`HTTP ${res.status} from the assistant`);
+  const json = await res.json();
+  const result = applyAssistantActions(grid, Array.isArray(json?.actions) ? json.actions : []);
+  const say = typeof json?.message === "string" ? json.message : result.applied.filter((a) => a.type === "message").map((a) => a.text ?? "").join("\n");
+  return { ...result, message: say.slice(0, 4e3) };
+}
+
+// src/interactions/assistantPanel.ts
+var AssistantPanel = class {
+  constructor(grid) {
+    this.grid = grid;
+    this.popup = null;
+    this.log = null;
+    this.off = [];
+    this.busy = null;
+  }
+  get isOpen() {
+    return !!this.popup;
+  }
+  open() {
+    if (this.popup) {
+      this.popup.querySelector(".fg-ai-input")?.focus();
+      return;
+    }
+    const { grid } = this;
+    const loc = grid.store.state.locale;
+    const opts = grid.options.assistant;
+    const popup = el("div", `fg-menu fg-ai-panel fg-theme-${grid.store.state.theme}`, { role: "dialog", "aria-label": loc.ai.title });
+    grid.applyFontTo(popup);
+    const head = el("div", "fg-chooser-head");
+    const title = el("span", "fg-menu-title");
+    title.textContent = loc.ai.title;
+    const x = el("button", "fg-chooser-close", { type: "button", "aria-label": loc.close });
+    x.textContent = "\xD7";
+    x.addEventListener("click", () => this.close());
+    head.append(title, x);
+    const log = el("div", "fg-ai-log", { role: "log", "aria-live": "polite" });
+    this.log = log;
+    const form = el("form", "fg-ai-form");
+    const input = el("textarea", "fg-input fg-ai-input", { rows: "2", placeholder: loc.ai.placeholder, "aria-label": loc.ai.placeholder, maxlength: "2000" });
+    const send2 = el("button", "fg-btn fg-btn-primary fg-ai-send", { type: "submit" });
+    send2.textContent = loc.ai.send;
+    form.append(input, send2);
+    const tips = el("div", "fg-ai-tips");
+    for (const s of (opts?.suggestions ?? []).slice(0, 6)) {
+      const b = el("button", "fg-ai-tip", { type: "button" });
+      b.textContent = s;
+      b.addEventListener("click", () => {
+        input.value = s;
+        input.focus();
+      });
+      tips.append(b);
+    }
+    input.addEventListener("keydown", (e) => {
+      if (e.key === "Enter" && !e.shiftKey && !e.isComposing) {
+        e.preventDefault();
+        form.requestSubmit?.() ?? form.dispatchEvent(new Event("submit", { cancelable: true }));
+      }
+    });
+    form.addEventListener("submit", (e) => {
+      e.preventDefault();
+      const prompt = input.value.trim();
+      if (!prompt || this.busy) return;
+      input.value = "";
+      void this.ask(prompt, send2);
+    });
+    popup.append(head, log, form);
+    if (tips.childElementCount) popup.append(tips);
+    popupParent(grid.renderer.root).append(popup);
+    const r = grid.renderer.root.getBoundingClientRect();
+    const w = popup.offsetWidth || 360;
+    popup.style.left = `${Math.max(4, Math.min(r.right - w - 16, (window.innerWidth || 1024) - w - 4))}px`;
+    popup.style.top = `${Math.max(4, r.top + 16)}px`;
+    this.popup = popup;
+    input.focus();
+    const onDown = (e) => {
+      if (!eventInside(e, popup) && !this.busy) this.close();
+    };
+    const onKey = (e) => {
+      if (e.key === "Escape") this.close();
+    };
+    document.addEventListener("pointerdown", onDown, true);
+    document.addEventListener("keydown", onKey, true);
+    this.off.push(
+      () => document.removeEventListener("pointerdown", onDown, true),
+      () => document.removeEventListener("keydown", onKey, true)
+    );
+  }
+  say(who, text2) {
+    const msg = el("div", `fg-ai-msg fg-ai-${who}`);
+    msg.textContent = text2;
+    this.log?.append(msg);
+    if (this.log) this.log.scrollTop = this.log.scrollHeight;
+    return msg;
+  }
+  async ask(prompt, send2) {
+    const loc = this.grid.store.state.locale;
+    this.say("user", prompt);
+    const wait = this.say("ai", loc.ai.thinking);
+    wait.classList.add("fg-ai-wait");
+    this.busy = new AbortController();
+    send2.disabled = true;
+    try {
+      const res = await askAssistant(this.grid, prompt, this.grid.options.assistant, this.busy.signal);
+      wait.classList.remove("fg-ai-wait");
+      const changed = res.applied.filter((a) => a.type !== "message").length;
+      wait.textContent = res.message || (changed ? loc.ai.done : "");
+      if (res.skipped.length) {
+        const note = el("div", "fg-ai-note");
+        note.textContent = `${loc.ai.skipped}: ${res.skipped.map((s) => s.reason).join(", ")}`;
+        wait.append(note);
+      }
+      if (changed) {
+        const undo = el("button", "fg-btn fg-ai-undo", { type: "button" });
+        undo.textContent = loc.ai.undo;
+        undo.addEventListener("click", () => {
+          res.undo();
+          undo.disabled = true;
+          undo.textContent = loc.ai.undone;
+        });
+        wait.append(undo);
+      }
+      this.grid.events.emit("assistantAnswer", { prompt, message: res.message, applied: res.applied, skipped: res.skipped });
+    } catch (e) {
+      if (e?.name === "AbortError") return;
+      wait.remove();
+      this.say("error", loc.ai.failed);
+    } finally {
+      this.busy = null;
+      send2.disabled = false;
+    }
+  }
+  close() {
+    this.busy?.abort();
+    this.busy = null;
+    for (const f of this.off) f();
+    this.off = [];
+    this.popup?.remove();
+    this.popup = null;
+    this.log = null;
+  }
+};
+
 // src/grid.ts
 var autoRowHeight = (size) => Math.round(size * 2.75);
 var autoHeaderHeight = (size) => Math.round(size * 3.1);
@@ -7508,11 +9373,34 @@ var Grid = class {
     /** 0-based page and rows per page (pagination only). */
     this.page = 0;
     this.pageSize = DEFAULT_PAGE_SIZE;
+    /** What formulas see: every source row, and computed columns by id. */
+    this.formulaScope = {
+      rows: () => this.store.state.data,
+      version: () => this.editVersion,
+      computed: (name) => {
+        const def = this.columns.getNode(name)?.def;
+        return def && typeof def.formula === "string" && def.formula.startsWith("=") ? def.formula : void 0;
+      }
+    };
+    this.cfRules = [];
+    this.formats = new ConditionalFormatter({
+      rules: () => this.cfRules,
+      rows: () => this.rowModel.dataRows().map((n) => n.data),
+      value: (colId, row) => {
+        const def = this.columns.getNode(colId)?.def;
+        return def ? getCellValue(def, row) : void 0;
+      },
+      version: () => this.editVersion,
+      formula: (f, row) => evaluateFormula(f, row, /* @__PURE__ */ new Set(), 0, /* @__PURE__ */ new Map(), this.formulaScope)
+    });
+    this.formatDialog = new FormatDialog(this);
+    this.assistantPanel = new AssistantPanel(this);
     // ── pagination and server rows ──────────────────────────────
     /** Cells flashing after a transaction: `${rowId}\u0000${colId}` → time the flash ends. */
     /** showOverlay: an overlay the app asked for, shown whatever the row count. */
     this.forcedOverlay = null;
     this.filterBuilder = new FilterBuilder(this);
+    /** `${rowId}\u0000${colId}` → when the flash ends and which way a number moved. */
     this.flashing = /* @__PURE__ */ new Map();
     this.flashTimer = 0;
     this.txQueue = [];
@@ -7552,6 +9440,7 @@ var Grid = class {
     });
     this.sourceDefs = Array.isArray(options.columns) ? options.columns : [];
     this.columns = new ColumnModel(this.withSelect(this.sourceDefs));
+    this.bindFormulas();
     const pg = options.pagination;
     if (pg && typeof pg === "object" && pg.pageSize !== void 0) {
       if (Number.isInteger(pg.pageSize) && pg.pageSize > 0) this.pageSize = pg.pageSize;
@@ -7573,6 +9462,7 @@ var Grid = class {
       collator: () => this.collator()
     });
     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.treeData && !options.getRowId) warn("treeData needs getRowId so parent ids can be matched");
     this.updateRows();
@@ -7588,6 +9478,7 @@ var Grid = class {
     });
     this.density = this.densityOf(options.density);
     this.renderer.applyTheme();
+    if (options.flashDuration) this.renderer.root.style.setProperty("--fg-flash-duration", `${this.flashMs()}ms`);
     this.renderer.applyFont(this.font.size, this.font.family);
     this.menu = new ColumnMenu(this);
     this.chooser = new ColumnChooserDialog(this);
@@ -7614,6 +9505,8 @@ var Grid = class {
       () => this.groupPanel?.destroy(),
       () => this.charts.destroy(),
       () => this.filterBuilder.close(),
+      () => this.formatDialog.close(),
+      () => this.assistantPanel.close(),
       attachTooltips(this)
     );
     if (typeof ResizeObserver !== "undefined") {
@@ -7629,6 +9522,45 @@ var Grid = class {
     this.api = this.createApi();
     liveGrids.set(this.renderer.root, this);
   }
+  /** The column definitions as given (setColumns), without the system columns. */
+  columnDefs() {
+    return [...this.sourceDefs];
+  }
+  summaryOptions() {
+    return this.summaryOpts ? JSON.parse(JSON.stringify(this.summaryOpts)) : null;
+  }
+  setConditionalFormats(list) {
+    if (!Array.isArray(list)) {
+      warn("setConditionalFormats: formats must be an array");
+      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() });
+  }
+  getConditionalFormats() {
+    return JSON.parse(JSON.stringify(this.cfRules));
+  }
+  /** Conditional format of one cell, or null. */
+  cellFormat(row, colId, value) {
+    return this.cfRules.length ? this.formats.cell(colId, row, value) : null;
+  }
+  bindFormulas() {
+    const defs = [];
+    const walk = (list) => {
+      for (const d of list) {
+        if (!d || typeof d !== "object") continue;
+        defs.push(d);
+        if (Array.isArray(d.children)) walk(d.children);
+      }
+    };
+    walk(this.sourceDefs);
+    for (const st of this.columns.getState()) {
+      const d = this.columns.getNode(st.colId)?.def;
+      if (d) defs.push(d);
+    }
+    setFormulaScope(defs, this.formulaScope);
+  }
   collator() {
     const code = this.store.state.locale.code;
     if (this.collatorCache?.code !== code) {
@@ -7766,17 +9698,35 @@ var Grid = class {
   isFlashing(rowId, colId) {
     return this.flashing.size > 0 && this.flashing.has(`${rowId}\0${colId}`);
   }
+  /** Classes of a flashing cell ('' when it is not flashing). */
+  flashClass(rowId, colId) {
+    if (!this.flashing.size) return "";
+    const f = this.flashing.get(`${rowId}\0${colId}`);
+    return f ? f.dir ? ` fg-cell-flash fg-cell-flash-${f.dir}` : " fg-cell-flash" : "";
+  }
+  flashMs() {
+    const d = this.options.flashDuration;
+    return typeof d === "number" && d > 0 ? d : 1e3;
+  }
   flash(keys) {
-    const until = Date.now() + 1e3;
-    for (const k of keys) this.flashing.set(k, until);
+    const ms = this.flashMs();
+    const until = Date.now() + ms;
+    for (const [k, dir] of keys) this.flashing.set(k, { until, dir });
     if (this.flashTimer) return;
     const tick = () => {
       const now = Date.now();
-      for (const [k, t] of this.flashing) if (t <= now) this.flashing.delete(k);
-      this.renderer.invalidate({ rows: true });
-      this.flashTimer = this.flashing.size && !this.destroyed ? window.setTimeout(tick, 250) : 0;
+      const ended = /* @__PURE__ */ new Set();
+      let next = Infinity;
+      for (const [k, f] of this.flashing) {
+        if (f.until <= now) {
+          this.flashing.delete(k);
+          ended.add(k.slice(0, k.indexOf("\0")));
+        } else next = Math.min(next, f.until);
+      }
+      if (ended.size) this.renderer.invalidateRowIds(ended);
+      this.flashTimer = this.flashing.size && !this.destroyed ? window.setTimeout(tick, Math.max(16, next - now)) : 0;
     };
-    this.flashTimer = window.setTimeout(tick, 1e3);
+    this.flashTimer = window.setTimeout(tick, ms);
   }
   applyTransaction(tx) {
     if (!tx || typeof tx !== "object") return { added: [], updated: [], removed: [], notFound: [] };
@@ -7791,32 +9741,55 @@ var Grid = class {
       const f = this.columns.getNode(st.colId)?.def.field;
       if (f) colsByField.set(f, [...colsByField.get(f) ?? [], st.colId]);
     }
-    const flashKeys = [];
+    const flashKeys = /* @__PURE__ */ new Map();
+    const changed = { fields: /* @__PURE__ */ new Set(), ids: /* @__PURE__ */ new Set() };
     let next = this.store.state.data;
     const present = new Set(next);
     const byId = new Map(next.map((r) => [this.rowModel.idOf(r), r]));
     for (const tx of list) {
-      if (tx && typeof tx === "object") next = this.txStep(tx, next, { present, byId }, result, flashKeys, colsByField);
+      if (tx && typeof tx === "object") next = this.txStep(tx, next, { present, byId }, result, flashKeys, colsByField, changed);
     }
     if (!result.added.length && !result.updated.length && !result.removed.length) {
       if (result.notFound.length) this.events.emit("transactionApplied", result);
       return result;
     }
     this.editVersion++;
-    this.renderer.invalidateHeights();
-    this.keepRange = true;
-    try {
-      this.replaceData(next === this.store.state.data ? [...next] : next);
-    } finally {
-      this.keepRange = false;
+    if (next === this.store.state.data && !this.viewReads(changed.fields)) {
+      if (this.options.autoRowHeight || this.options.getRowHeight) this.renderer.invalidateHeights();
+      this.refreshSummary();
+      this.finder.refresh();
+      if (this.columns.displayed().some((c) => c.def.merge || c.def.rowSpan || c.def.formula || c.def.formulas) || this.formats.dependsOnOtherRows()) {
+        this.renderer.invalidate({ rows: true });
+      } else this.renderer.invalidateRowIds(changed.ids);
+    } else {
+      this.renderer.invalidateHeights();
+      this.keepRange = true;
+      try {
+        this.replaceData(next === this.store.state.data ? [...next] : next);
+      } finally {
+        this.keepRange = false;
+      }
     }
     this.editor.sync();
-    if (flashKeys.length && this.options.flashCells !== false) this.flash(flashKeys);
+    if (flashKeys.size && this.options.flashCells !== false) this.flash(flashKeys);
     this.events.emit("transactionApplied", result);
     return result;
   }
   /** One transaction against `data` (remove → update → add); returns the new array. */
-  txStep(tx, data, index, result, flashKeys, colsByField) {
+  /** Whether rows changed in `fields` could filter, sort, group or move differently. */
+  viewReads(fields) {
+    if (!fields.size) return false;
+    const st = this.store.state;
+    if (this.pivotCfg || this.options.treeData || st.quickFilter || st.advancedFilter || this.groupBy.length) return true;
+    const ids = [...st.sort.map((x) => x.colId), ...Object.keys(st.filters)];
+    return ids.some((id) => {
+      const def = this.columns.getNode(id)?.def;
+      if (!def) return false;
+      if (def.valueGetter || def.formulas || def.formula) return true;
+      return def.field != null && fields.has(def.field);
+    });
+  }
+  txStep(tx, data, index, result, flashKeys, colsByField, changed) {
     const getId = this.options.getRowId;
     const { present, byId } = index;
     const keyOf = (r) => {
@@ -7841,6 +9814,20 @@ var Grid = class {
         this.tracker.originals.delete(row);
       } else if (!row) result.notFound.push(r);
     }
+    const update = (r, k, row) => {
+      const orig = this.tracker.originals.get(row);
+      for (const [field, value] of Object.entries(r)) {
+        if (orig) orig[field] = value;
+        const old = row[field];
+        if (Object.is(old, value)) continue;
+        row[field] = value;
+        changed.fields.add(field);
+        changed.ids.add(k);
+        const dir = typeof old === "number" && typeof value === "number" ? value > old ? "up" : "down" : "";
+        for (const colId of colsByField.get(field) ?? []) flashKeys.set(`${k}\0${colId}`, dir);
+      }
+      result.updated.push(row);
+    };
     for (const r of tx.update ?? []) {
       const k = keyOf(r);
       const row = k === null ? void 0 : byId.get(k);
@@ -7848,16 +9835,16 @@ var Grid = class {
         result.notFound.push(r);
         continue;
       }
-      const orig = this.tracker.originals.get(row);
-      for (const [field, value] of Object.entries(r)) {
-        if (orig) orig[field] = value;
-        if (Object.is(row[field], value)) continue;
-        row[field] = value;
-        for (const colId of colsByField.get(field) ?? []) flashKeys.push(`${k}\0${colId}`);
-      }
-      result.updated.push(row);
+      update(r, k, row);
     }
-    const added = cleanRows(Array.isArray(tx.add) ? tx.add : []);
+    const fresh = Array.isArray(tx.add) ? [...tx.add] : [];
+    for (const r of Array.isArray(tx.upsert) ? tx.upsert : []) {
+      const k = keyOf(r);
+      const row = k === null ? void 0 : byId.get(k);
+      if (row && !gone.has(row)) update(r, k, row);
+      else if (r && typeof r === "object") fresh.push(r);
+    }
+    const added = cleanRows(fresh);
     result.added.push(...added);
     for (const r of added) {
       present.add(r);
@@ -7873,13 +9860,16 @@ var Grid = class {
     if (!tx || typeof tx !== "object") return;
     this.txQueue.push(tx);
     if (this.txTimer) return;
-    this.txTimer = window.setTimeout(() => {
-      this.txTimer = 0;
-      const queue = this.txQueue;
-      this.txQueue = [];
-      if (this.destroyed || !queue.length) return;
-      this.applyTransactions(queue);
-    }, 50);
+    const wait = this.options.asyncTransactionWait;
+    this.txTimer = window.setTimeout(() => this.flushAsyncTransactions(), typeof wait === "number" && wait >= 0 ? wait : 50);
+  }
+  flushAsyncTransactions() {
+    clearTimeout(this.txTimer);
+    this.txTimer = 0;
+    const queue = this.txQueue;
+    this.txQueue = [];
+    if (this.destroyed || !queue.length) return;
+    this.applyTransactions(queue);
   }
   setAdvancedFilter(filter) {
     const next = filter && typeof filter === "object" && Array.isArray(filter.conditions) && filter.conditions.length ? filter : null;
@@ -7908,6 +9898,7 @@ var Grid = class {
       expanded: Object.fromEntries(expanded),
       selected: [...s.selected]
     };
+    if (this.cfRules.length) state.conditionalFormats = this.getConditionalFormats();
     if (this.options.pagination) {
       state.page = this.page;
       state.pageSize = this.pageSize;
@@ -7945,6 +9936,7 @@ var Grid = class {
     }
     if (want("pageSize") && typeof state.pageSize === "number") this.setPageSize(state.pageSize);
     if (want("page") && typeof state.page === "number") this.setPage(state.page);
+    if (want("conditionalFormats") && Array.isArray(state.conditionalFormats)) this.setConditionalFormats(state.conditionalFormats);
     if (want("selected") && Array.isArray(state.selected)) {
       const ids = new Set(this.rowModel.allNodes().map((n) => n.id));
       this.setSelected(new Set(state.selected.map(String).filter((id) => ids.has(id))));
@@ -9194,6 +11186,7 @@ var Grid = class {
       return;
     }
     this.columns.setDefs(this.withSelect(defs));
+    this.bindFormulas();
     const known = (id) => !!this.columns.getNode(id);
     const groupBy = this.groupBy.filter(known);
     if (groupBy.length !== this.groupBy.length) {
@@ -9271,6 +11264,12 @@ var Grid = class {
       getXlsxSheet: guard((o) => buildXlsxSheet(this, o)),
       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 })),
+      exportPdf: guard((name = "export.pdf", o) => {
+        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");
+      }),
       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),
@@ -9278,6 +11277,12 @@ var Grid = class {
       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()),
       getState: guard(() => this.getState()),
       setState: guard((s, o) => this.setState(s, o)),
       getScrollPosition: guard(() => this.renderer.getScroll()),
@@ -9344,6 +11349,8 @@ var Grid = class {
       getPivot: guard(() => this.getPivot()),
       createChart: guard((o) => this.charts.create(o)),
       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")),
@@ -9441,13 +11448,13 @@ function saveChanges(grid, url, options = {}) {
   if (!grid.hasChanges()) return Promise.resolve(null);
   const { created, updated, deleted } = grid.getModifiedRows();
   const rows = new Map([...created, ...updated].map((r) => [r, { ...r }]));
-  const run = (async () => {
+  const run2 = (async () => {
     const json = await send(url, "POST", { created, updated, deleted, ...options.params?.() ?? {} }, options);
     grid.commitChanges({ rows, deleted });
     return json;
   })().finally(() => saving.delete(grid));
-  saving.set(grid, run);
-  return run;
+  saving.set(grid, run2);
+  return run2;
 }
 async function loadData(grid, url, options = {}) {
   const { rows } = await restDatasource(url, options).getRows({ start: 0, end: options.maxRows ?? 1e4, sort: [], filters: {}, quickFilter: "" });
@@ -9459,15 +11466,186 @@ function csrfHeaders(doc = document) {
   const header2 = doc.querySelector('meta[name="_csrf_header"]')?.content || "X-CSRF-TOKEN";
   return token ? { [header2]: token } : {};
 }
+
+// src/live.ts
+var TX_KEYS = ["add", "update", "remove", "upsert"];
+function messageToTransaction(message) {
+  let m = message;
+  if (typeof m === "string") {
+    if (!m.trim()) return null;
+    m = JSON.parse(m);
+  }
+  if (Array.isArray(m)) return { upsert: m.filter((r) => r && typeof r === "object") };
+  if (!m || typeof m !== "object") return null;
+  const o = m;
+  if (TX_KEYS.some((k) => Array.isArray(o[k]))) return o;
+  if (Array.isArray(o.rows)) return { rows: o.rows };
+  return null;
+}
+function connectLive(api, options) {
+  const opts = options ?? {};
+  let status = "connecting";
+  let closed = false;
+  let paused = false;
+  let held = [];
+  let socket = null;
+  let timer = 0;
+  let attempt = 0;
+  const setStatus = (s) => {
+    if (status === s) return;
+    status = s;
+    try {
+      opts.onStatus?.(s);
+    } catch {
+    }
+  };
+  const apply = (tx) => {
+    if ("rows" in tx && Array.isArray(tx.rows) && !TX_KEYS.some((k) => k in tx)) {
+      api.flushAsyncTransactions();
+      api.setData(tx.rows);
+    } else if (opts.immediate) api.applyTransaction(tx);
+    else api.applyTransactionAsync(tx);
+  };
+  const handle = (message) => {
+    if (closed) return;
+    let tx;
+    try {
+      tx = opts.parse ? opts.parse(message) : messageToTransaction(message);
+      if (Array.isArray(tx)) tx = { upsert: tx };
+    } catch (e) {
+      if (opts.onError) opts.onError(e);
+      else warn("connectLive: a message could not be read");
+      return;
+    }
+    if (!tx || typeof tx !== "object") return;
+    if (paused) held.push(tx);
+    else apply(tx);
+  };
+  const retry = () => {
+    if (closed || opts.reconnect === false) {
+      setStatus("closed");
+      return;
+    }
+    const max = typeof opts.maxDelay === "number" && opts.maxDelay > 0 ? opts.maxDelay : 3e4;
+    const delay = Math.min(max, 500 * 2 ** Math.min(attempt++, 10)) * (0.8 + Math.random() * 0.4);
+    setStatus("connecting");
+    timer = window.setTimeout(open, delay);
+  };
+  const open = () => {
+    if (closed) return;
+    timer = 0;
+    if (opts.poll) {
+      void pollOnce();
+      return;
+    }
+    const url = opts.url;
+    if (!url) {
+      warn("connectLive: give a url or a poll function");
+      setStatus("error");
+      return;
+    }
+    setStatus(paused ? "paused" : "connecting");
+    try {
+      if (/^wss?:/i.test(url)) {
+        if (typeof WebSocket === "undefined") throw new Error("no WebSocket");
+        const ws = new WebSocket(url, opts.protocols);
+        socket = ws;
+        ws.onopen = () => {
+          attempt = 0;
+          setStatus(paused ? "paused" : "open");
+        };
+        ws.onmessage = (e) => handle(e.data);
+        ws.onerror = () => setStatus("error");
+        ws.onclose = () => {
+          if (socket === ws) socket = null;
+          if (!closed) retry();
+        };
+      } else {
+        if (typeof EventSource === "undefined") throw new Error("no EventSource");
+        const es = new EventSource(url, { withCredentials: !!opts.withCredentials });
+        socket = es;
+        es.onopen = () => {
+          attempt = 0;
+          setStatus(paused ? "paused" : "open");
+        };
+        es.addEventListener(opts.event || "message", (e) => handle(e.data));
+        es.onerror = () => {
+          if (es.readyState === 2) {
+            if (socket === es) socket = null;
+            if (!closed) retry();
+          } else setStatus("connecting");
+        };
+      }
+    } catch {
+      setStatus("error");
+      retry();
+    }
+  };
+  const pollOnce = async () => {
+    if (closed) return;
+    try {
+      const result = await opts.poll();
+      if (closed) return;
+      attempt = 0;
+      setStatus(paused ? "paused" : "open");
+      handle(result);
+      const every = typeof opts.interval === "number" && opts.interval > 0 ? opts.interval : 2e3;
+      timer = window.setTimeout(pollOnce, every);
+    } catch {
+      if (closed) return;
+      setStatus("error");
+      retry();
+    }
+  };
+  open();
+  return {
+    get status() {
+      return status;
+    },
+    pause() {
+      if (closed || paused) return;
+      paused = true;
+      setStatus("paused");
+    },
+    resume() {
+      if (closed || !paused) return;
+      paused = false;
+      const list = held;
+      held = [];
+      for (const tx of list) apply(tx);
+      setStatus(socket || opts.poll ? "open" : "connecting");
+    },
+    close() {
+      if (closed) return;
+      closed = true;
+      clearTimeout(timer);
+      socket?.close();
+      socket = null;
+      held = [];
+      setStatus("closed");
+    },
+    send(data) {
+      const ws = socket;
+      if (!ws || typeof ws.send !== "function" || ws.readyState !== 1) return false;
+      ws.send(data);
+      return true;
+    }
+  };
+}
 export {
   buildWorkbook,
+  connectLive,
   createGrid,
   csrfHeaders,
   en_default as en,
+  evaluateFormula,
   exportWorkbook,
+  formulaFunctions,
   loadData,
+  messageToTransaction,
   parseCsv,
   readXlsx,
+  registerFormulaFunction,
   registerLocale,
   renderChart,
   resolveLocale,