@graphysdk/viz-engine 0.0.1-plugins.4 → 0.0.1-plugins.6

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { isValid as U, isBefore as Da, parse as Be, differenceInDays as Ra, isWithinInterval as Pa, addDays as $r } from "date-fns";
-import { table as _e, desc as Na, op as Gr } from "arquero";
+import { isValid as U, isBefore as Da, parse as Be, differenceInDays as Ra, isWithinInterval as Na, addDays as $r } from "date-fns";
+import { table as _e, desc as Pa, op as Gr } from "arquero";
 import { isEqual as Oa, isInteger as Ba, merge as Ae } from "lodash-es";
 import { utcYear as $a, utcMonth as Ga, utcMonday as Ua, utcDay as Wa, utcHour as Ya } from "d3-time";
 import { differenceInDays as Ha } from "date-fns/differenceInDays";
@@ -8,7 +8,7 @@ import Yr from "lodash-es/merge";
 import { regressionLoess as qa, regressionPoly as Qa, regressionPow as Za, regressionQuad as Ja, regressionLog as es, regressionExp as ts, regressionLinear as ns } from "d3-regression";
 import rs from "humanize-duration";
 import { Delaunay as os } from "d3-delaunay";
-typeof window < "u" && (window.__GRAPHY_SDK__ ??= {}, window.__GRAPHY_SDK__.vizEngine = "0.0.1-plugins.4");
+typeof window < "u" && (window.__GRAPHY_SDK__ ??= {}, window.__GRAPHY_SDK__.vizEngine = "0.0.1-plugins.6");
 const Hr = (e) => e.length > 0;
 function h(e) {
   return e != null;
@@ -24,7 +24,7 @@ function We(e, t) {
     t
   );
 }
-function kt(e, t) {
+function Vt(e, t) {
   for (const n of Object.keys(t)) {
     const r = t[n];
     if (r !== void 0 && r !== e[n])
@@ -55,9 +55,9 @@ function xt(e) {
   };
 }
 let St = !0;
-const Ay = (e) => {
+const My = (e) => {
   St = e;
-}, Ty = () => St, as = () => {
+}, ky = () => St, as = () => {
   let e = null;
   const t = { hits: 0, misses: 0 };
   return Object.assign((r, o) => {
@@ -116,7 +116,7 @@ class re {
     return this.singletonKey;
   }
 }
-function My(e) {
+function Ly(e) {
   return { type: "mapping", mapping: e };
 }
 function jr(e, t) {
@@ -194,17 +194,17 @@ const is = new Set(Object.values($e)), cs = (e) => e.startsWith(qr), ls = (e) =>
 }, $n = (e, t) => {
   const n = e[t];
   return n !== void 0 && n.kind === "position" ? n : null;
-}, P = (e) => e instanceof Date && U(e), ps = (e) => P(e) || e === null, He = (e) => typeof e == "string", k = (e) => typeof e == "number" && !Number.isNaN(e) && Number.isFinite(e);
+}, N = (e) => e instanceof Date && U(e), ps = (e) => N(e) || e === null, He = (e) => typeof e == "string", V = (e) => typeof e == "number" && !Number.isNaN(e) && Number.isFinite(e);
 function Zr(e) {
   return e[de.color];
 }
-function Ly(e) {
+function Vy(e) {
   return e[de.alpha];
 }
 function fs(e) {
   return e[de.size];
 }
-function Vy(e) {
+function Ey(e) {
   return e[de.strokeWidth];
 }
 function hs(e) {
@@ -221,7 +221,7 @@ const jt = (e, t, n, r) => {
       const c = r.resolveAnchorPosition(o.geom, i, n);
       if (c === null) continue;
       const l = s !== null ? i[s] ?? null : null;
-      if (k(l))
+      if (V(l))
         return { ...c, measurementValue: l, color: Zr(i) };
     }
   }
@@ -341,7 +341,7 @@ class Ms extends re {
     };
   }
 }
-class Ls extends re {
+class ks extends re {
   dependencies(t) {
     return [t.data, t.mapping];
   }
@@ -352,12 +352,12 @@ class Ls extends re {
       const a = te(r[o]);
       if (a === void 0) continue;
       const s = A(`const_${o}`);
-      n = n.addConstantVariable(s, Vs(a), a), r = { ...r, [o]: s };
+      n = n.addConstantVariable(s, Ls(a), a), r = { ...r, [o]: s };
     }
     return { data: n, mapping: r };
   }
 }
-const Vs = (e) => typeof e == "number" ? "numeric" : e instanceof Date ? "temporal" : "categorical";
+const Ls = (e) => typeof e == "number" ? "numeric" : e instanceof Date ? "temporal" : "categorical";
 class Te {
   constructor() {
     this.perLayerMemo = zr(), this.listMemo = as();
@@ -372,7 +372,7 @@ class Te {
     return this.listMemo(r, () => r);
   }
 }
-class ks extends re {
+class Vs extends re {
   constructor(t) {
     super(), this.registry = t;
   }
@@ -399,7 +399,7 @@ class Es extends Te {
 }
 class Is {
   constructor(t) {
-    this.setupStage = new ks(t), this.transformStage = new Es(t);
+    this.setupStage = new Vs(t), this.transformStage = new Es(t);
   }
   get setupStats() {
     return this.setupStage.stats;
@@ -511,11 +511,11 @@ class Ds {
   transform(t) {
     return t.layers.map((n) => {
       const r = this.geomRegistry.get(n.geom), o = Jr(r.positionChannels);
-      return Ns(n, o);
+      return Ps(n, o);
     });
   }
 }
-const Wn = A("flipSwap"), Rs = (e, t) => Ps(t) ? e.map((n) => n.scaledAesthetic !== "x" || n.scaleType !== "continuous" && n.scaleType !== "datetime" && n.scaleType !== "discrete" ? n : { ...n, reverse: !n.reverse }) : e, Ps = (e) => {
+const Wn = A("flipSwap"), Rs = (e, t) => Ns(t) ? e.map((n) => n.scaledAesthetic !== "x" || n.scaleType !== "continuous" && n.scaleType !== "datetime" && n.scaleType !== "discrete" ? n : { ...n, reverse: !n.reverse }) : e, Ns = (e) => {
   for (const t of e) {
     const n = v(t.mapping.x);
     if (!n || !t.data.hasVariable(n)) continue;
@@ -523,7 +523,7 @@ const Wn = A("flipSwap"), Rs = (e, t) => Ps(t) ? e.map((n) => n.scaledAesthetic
     if (r === "categorical" || r === "temporal") return !0;
   }
   return !1;
-}, Ns = (e, t) => {
+}, Ps = (e, t) => {
   let n = e.data;
   for (const [r, o] of t) {
     const a = n.hasVariable(r), s = n.hasVariable(o);
@@ -597,7 +597,7 @@ const Ys = /* @__PURE__ */ new Set(["count", "sum", "mean", "median"]);
 function eo(e, t) {
   return Ys.has(e) ? "numeric" : t;
 }
-const L = (e) => (Array.isArray(e) ? e : [e]).map((n) => n instanceof Date ? n.toISOString() : String(n ?? "<null>")).join("\0"), Hs = "key", Ks = "value", Hn = "\0__rowMaskIndex", Pe = {
+const k = (e) => (Array.isArray(e) ? e : [e]).map((n) => n instanceof Date ? n.toISOString() : String(n ?? "<null>")).join("\0"), Hs = "key", Ks = "value", Hn = "\0__rowMaskIndex", Ne = {
   numeric: { type: "decimal" },
   categorical: { type: "text" },
   temporal: { type: "datetime" }
@@ -769,7 +769,7 @@ class M {
    * Orders the dataset by a variable, in ascending (default) or descending order.
    */
   orderBy(t, n = "asc") {
-    const r = this.table.orderby(n === "asc" ? t : Na(t));
+    const r = this.table.orderby(n === "asc" ? t : Pa(t));
     return M.fromTrusted(r, this.variableMetadata);
   }
   /**
@@ -814,7 +814,7 @@ class M {
       )
     ), r = {};
     for (const [o, { variableName: a, aggregation: s }] of Object.entries(t)) {
-      const i = this.variableMetadata[a], c = i?.type ?? "numeric", l = i?.valueFormat ?? Pe[c], u = eo(s, c);
+      const i = this.variableMetadata[a], c = i?.type ?? "numeric", l = i?.valueFormat ?? Ne[c], u = eo(s, c);
       r[o] = { type: u, valueFormat: to(s, l) };
     }
     return M.fromTrusted(n, r);
@@ -904,7 +904,7 @@ class M {
   resolveAddedVariableFormat(t, n, r) {
     if (r !== void 0) return r;
     const o = this.variableMetadata[t];
-    return o ? o.valueFormat : Pe[n];
+    return o ? o.valueFormat : Ne[n];
   }
   /**
    * Parses the variable map into a table and variable metadata.
@@ -912,7 +912,7 @@ class M {
   parseVariableMap(t) {
     const n = {}, r = {};
     for (const [a, { type: s, values: i, valueFormat: c }] of Object.entries(t))
-      n[a] = i, r[a] = { type: s, valueFormat: c ?? Pe[s] };
+      n[a] = i, r[a] = { type: s, valueFormat: c ?? Ne[s] };
     return { table: _e(n), variableMetadata: r };
   }
   /**
@@ -985,12 +985,12 @@ class Xs {
       )
     ), r = Object.fromEntries(
       this.groupedBy.map((o) => {
-        const a = this.variableMetadata[o], s = a?.type ?? "categorical", i = a?.valueFormat ?? Pe[s];
+        const a = this.variableMetadata[o], s = a?.type ?? "categorical", i = a?.valueFormat ?? Ne[s];
         return [o, { type: s, valueFormat: i }];
       })
     );
     for (const [o, { variableName: a, aggregation: s }] of Object.entries(t)) {
-      const i = this.variableMetadata[a], c = i?.type ?? "numeric", l = i?.valueFormat ?? Pe[c], u = eo(s, c);
+      const i = this.variableMetadata[a], c = i?.type ?? "numeric", l = i?.valueFormat ?? Ne[c], u = eo(s, c);
       r[o] = { type: u, valueFormat: to(s, l) };
     }
     return M.fromTrusted(n, r);
@@ -999,7 +999,7 @@ class Xs {
    * Computes the group key based on the first value of the grouped variable. If multiple variables are grouped, returns a composite key.
    */
   getStableKey(t, n) {
-    return L(t.map((r) => r.get(n)));
+    return k(t.map((r) => r.get(n)));
   }
 }
 function js(e, t, n) {
@@ -1011,7 +1011,7 @@ function js(e, t, n) {
   if (a.every((c) => Oa(c, o)) || o.type === "lookup") return o;
   const i = {};
   for (const [c, l] of t.entries()) {
-    const u = L([l]), d = r[c];
+    const u = k([l]), d = r[c];
     d && d.type !== "lookup" && (i[u] = d);
   }
   return {
@@ -1048,7 +1048,7 @@ const ro = (e) => {
   if (Qs(e)) return "categorical";
   const t = e;
   throw new Error(`No data type found for value format: ${t.type}`);
-}, Ne = {
+}, Pe = {
   k: 1e3,
   m: 1e6,
   b: 1e9,
@@ -1187,7 +1187,7 @@ const ro = (e) => {
     const i = Be(o, s.dateFormat, /* @__PURE__ */ new Date()), c = Be(a, s.dateFormat, /* @__PURE__ */ new Date());
     if (!U(i) || !U(c)) return !1;
     const l = new no(), u = l.incrementYearIfNeeded(i), d = l.incrementYearIfNeeded(c), m = Ra(d, u);
-    return Pa(new Date(u.getFullYear(), ci, li), {
+    return Na(new Date(u.getFullYear(), ci, li), {
       start: u,
       end: d
     }) && m === ii ? !0 : m === si;
@@ -1350,7 +1350,7 @@ const ro = (e) => {
   let n = 1;
   for (const r of rn)
     if (new RegExp(`${r}$`, "i").test(t)) {
-      n = Ne[r], t = t.slice(0, -1);
+      n = Pe[r], t = t.slice(0, -1);
       break;
     }
   return Number(t.split(",").join("")) * n;
@@ -1387,31 +1387,31 @@ class Ti extends re {
     return [t];
   }
   run(t) {
-    const n = t._metadata?.parsingLocale ?? nn, r = {}, o = Vi(t), a = Mi(t);
+    const n = t._metadata?.parsingLocale ?? nn, r = {}, o = Li(t), a = Mi(t);
     for (const [s, i] of t.columns.entries()) {
       if (i._metadata?.isHidden) continue;
       const c = o.get(i.key);
       if (Ke(c)) continue;
       const l = s === a ? Ai : yi(c, n), u = io(l);
-      r[i.key] = Li(i.key, t.rows, l, u, n);
+      r[i.key] = ki(i.key, t.rows, l, u, n);
     }
     return new M(r);
   }
 }
 const Mi = (e) => {
-  const t = ki(e.rows, 5);
+  const t = Vi(e.rows, 5);
   return e.columns.findIndex((n) => {
     const r = t.map((o) => o[n.key]).filter((o) => !Ke(o));
     return r.length >= 2 && r.every(di);
   });
-}, Li = (e, t, n, r, o) => {
+}, ki = (e, t, n, r, o) => {
   const a = new no(), s = t.reduce((i, c) => {
     if (ro(c)) return i;
     const l = bi(c[e], n, o);
-    return so(n) && P(l) ? i.push(a.incrementYearIfNeeded(l)) : i.push(l), i;
+    return so(n) && N(l) ? i.push(a.incrementYearIfNeeded(l)) : i.push(l), i;
   }, []);
   return { type: r, values: s, valueFormat: n };
-}, Vi = (e) => {
+}, Li = (e) => {
   const t = /* @__PURE__ */ new Map(), n = new Set(e.columns.map((r) => r.key));
   for (const r of e.rows) {
     for (const o of n) {
@@ -1422,7 +1422,7 @@ const Mi = (e) => {
       break;
   }
   return t;
-}, ki = (e, t) => {
+}, Vi = (e, t) => {
   const n = [];
   for (const r of e)
     if (ro(r) || n.push(r), n.length === t)
@@ -1629,7 +1629,7 @@ class Ri extends Xe {
     return { data: t, mapping: {} };
   }
 }
-class Pi extends Xe {
+class Ni extends Xe {
   constructor() {
     super(...arguments), this.type = "rule", this.positionChannels = [
       { axis: "x", role: "point", valueKind: "value" },
@@ -1652,7 +1652,7 @@ class Pi extends Xe {
    * time, e.g. `stat.mean()` on `y`) — it draws a single reference line on one axis.
    */
   validateMapping({ layerId: t, mapping: n, computedVariables: r }) {
-    const o = r.has("x") || k(te(n.x)), a = r.has("y") || k(te(n.y));
+    const o = r.has("x") || V(te(n.x)), a = r.has("y") || V(te(n.y));
     return o && a ? [
       {
         code: "INVALID_RULE_MAPPING",
@@ -1670,15 +1670,15 @@ class Pi extends Xe {
 }
 const jn = (e, t) => {
   const n = te(e);
-  if (k(n)) return { value: n, sourceFormat: void 0 };
+  if (V(n)) return { value: n, sourceFormat: void 0 };
   const r = v(e);
   if (r === null || !ls(r) || !t.hasVariable(r)) return null;
   const [o] = t.getValues(r);
-  return k(o) ? { value: o, sourceFormat: t.getValueFormat(r) } : null;
+  return V(o) ? { value: o, sourceFormat: t.getValueFormat(r) } : null;
 };
-class Ni extends Me {
+class Pi extends Me {
   constructor(t) {
-    super("geom"), this.register("bar", new _i()), this.register("point", new Ri()), this.register("line", new Di()), this.register("area", new Ii()), this.register("rule", new Pi());
+    super("geom"), this.register("bar", new _i()), this.register("point", new Ri()), this.register("line", new Di()), this.register("area", new Ii()), this.register("rule", new Ni());
     for (const n of t?.geoms ?? [])
       this.register(n.type, n);
   }
@@ -1706,7 +1706,7 @@ class Oi {
       return { data: t.addConstantVariable(D.group, "categorical", null) };
     const o = t.size(), a = r.map((i) => t.getValues(i)), s = new Array(o);
     for (let i = 0; i < o; i++)
-      s[i] = L(a.map((c) => c[i]));
+      s[i] = k(a.map((c) => c[i]));
     return { data: t.addVariable(D.group, "categorical", s) };
   }
 }
@@ -1888,7 +1888,7 @@ const Ct = (e) => {
     default:
       return null;
   }
-}, Lo = {
+}, ko = {
   left: "right",
   right: "left",
   top: "bottom",
@@ -1898,7 +1898,7 @@ function nc(e, t) {
   const { scales: n, config: r, layers: o, coordSystem: a, variableLabels: s, geomCompiler: i } = e;
   if (a.type === "polar" && a.axisMapping.x.geometry !== "circular") return [];
   const c = oc(o, a.type, r, i), l = new Set(t.map((m) => m.position)), u = sc(
-    Vo(r.axes.y.position, a.axisMapping.y.position),
+    Lo(r.axes.y.position, a.axisMapping.y.position),
     l
   ), d = [];
   for (const m of To) {
@@ -1956,7 +1956,7 @@ function ac(e, t, n, r) {
     case "x":
       return {
         axisConfig: t.axes[e],
-        position: Vo(t.axes[e].position, n[e].position)
+        position: Lo(t.axes[e].position, n[e].position)
       };
     case "y":
       return {
@@ -1964,7 +1964,7 @@ function ac(e, t, n, r) {
         position: r
       };
     case "ySecondary": {
-      const o = Lo[r], a = Ae(
+      const o = ko[r], a = Ae(
         {
           isVisible: t.axes.y.isVisible,
           label: null,
@@ -1981,11 +1981,11 @@ function ac(e, t, n, r) {
     }
   }
 }
-function Vo(e, t) {
+function Lo(e, t) {
   return Qn.has(e) === Qn.has(t) ? e : t;
 }
 function sc(e, t) {
-  return t.has(e) ? Lo[e] : e;
+  return t.has(e) ? ko[e] : e;
 }
 function ic(e, t, n) {
   const { gridVisible: r } = n === "x" ? t.x : t.y;
@@ -1995,7 +1995,7 @@ const cc = (e, t) => {
   if (e.spec.scaleType === "continuous") {
     const r = /* @__PURE__ */ new Set(), o = [];
     for (let a = 1; a <= ec; a++) {
-      const s = e.generateTicks({ count: a }), i = L(s);
+      const s = e.generateTicks({ count: a }), i = k(s);
       r.has(i) || (r.add(i), o.push({ ticks: s.map((c) => ht(e, c)) }));
     }
     return o;
@@ -2003,11 +2003,11 @@ const cc = (e, t) => {
   return e.spec.scaleType === "datetime" ? lc(e, t) : [{ ticks: e.generateTicks().map((r) => ht(e, r)) }];
 }, lc = (e, t) => {
   const [n, r] = e.domain;
-  if (!P(n) || !P(r))
+  if (!N(n) || !N(r))
     return [{ ticks: e.generateTicks().map((c) => ht(e, c)) }];
   const o = /* @__PURE__ */ new Set(), a = [], s = (i, c) => {
     if (i.length === 0) return;
-    const l = L(i);
+    const l = k(i);
     o.has(l) || (o.add(l), a.push({
       ticks: i.map((u) => ht(e, u)),
       valueFormat: c
@@ -2020,7 +2020,7 @@ const cc = (e, t) => {
 function Ue(e, t) {
   return t.type === "polar" && e === "square" ? "slice" : e;
 }
-function ko({
+function Vo({
   scale: e,
   aesthetics: t,
   layers: n,
@@ -2057,11 +2057,11 @@ function Eo({
     const i = v(a.mapping[s]);
     if (!(i === null || !a.data.hasVariable(i)))
       for (const c of a.data.getValues(i, { distinct: !0 })) {
-        const l = L(c);
+        const l = k(c);
         r.has(l) || r.set(l, { layer: a, layerIndex: o });
       }
   }
-  return (o) => r.get(L(o));
+  return (o) => r.get(k(o));
 }
 const un = (e) => {
   if (e.kind === "identity") return !1;
@@ -2080,7 +2080,7 @@ function dc({ scales: e, layers: t, coordSystem: n, valueLabels: r }) {
     isMergedWithAnotherAesthetic: mc(e, t, a)
   })) return [];
   const i = o.spec.scaleType, c = t.findIndex((u) => h(u.mapping.color));
-  return ko({ scale: o, aesthetics: ["color"], layers: t, coordSystem: n }).map(({ value: u, swatchShape: d, owner: m }) => {
+  return Vo({ scale: o, aesthetics: ["color"], layers: t, coordSystem: n }).map(({ value: u, swatchShape: d, owner: m }) => {
     const p = m?.layerIndex ?? c, f = t[p], y = f ? v(f.mapping.color) : null;
     return {
       value: u,
@@ -2138,8 +2138,8 @@ function fc(e, t, n, r) {
 }
 function Jn(e, t, n) {
   if (n === null || t === null) return [...e];
-  const r = L(n);
-  return e.filter((o, a) => L(t[a] ?? null) === r);
+  const r = k(n);
+  return e.filter((o, a) => k(t[a] ?? null) === r);
 }
 const hc = (e, t) => {
   switch (t) {
@@ -2241,14 +2241,14 @@ function Ac(e, t) {
 function Tc(e, t) {
   return t === null || !["numeric", "temporal"].includes(e.getType(t)) ? e : e.orderBy(t);
 }
-const Mc = ["point", "line", "area", "bar", "rule"], Lc = new Set(Mc);
-function Vc(e) {
-  return Lc.has(e);
+const Mc = ["point", "line", "area", "bar", "rule"], kc = new Set(Mc);
+function Lc(e) {
+  return kc.has(e);
 }
 function X(e) {
   return e === "stack" || e === "fill";
 }
-const kc = 3;
+const Vc = 3;
 function Ec({
   scales: e,
   config: t,
@@ -2259,7 +2259,7 @@ function Ec({
   geomCompiler: s
 }) {
   if (t.legend.position === "none") return [];
-  const i = new Map(a.map((b) => [L(b.value), b])), c = Fc({ scales: e, layers: n, geomCompiler: s }), l = Nc(c), u = le(n, "x"), d = l.map((b) => {
+  const i = new Map(a.map((b) => [k(b.value), b])), c = Fc({ scales: e, layers: n, geomCompiler: s }), l = Pc(c), u = le(n, "x"), d = l.map((b) => {
     if (Rc(b, u, n)) return null;
     const S = Bc({ group: b, variableLabels: o, layers: n, coordSystem: r, colorGroupsByValue: i });
     return S.items.length === 0 ? null : { group: b, built: S };
@@ -2315,15 +2315,15 @@ function Rc(e, t, n) {
   return r.scaleAestheticKey !== "color" ? !1 : Io({
     colorVariableName: r.variableName,
     xVariableName: t,
-    mapsColorAcrossMultipleLayers: Pc(r.scaleAestheticKey, n),
+    mapsColorAcrossMultipleLayers: Nc(r.scaleAestheticKey, n),
     isMergedWithAnotherAesthetic: e.length > 1
   });
 }
-function Pc(e, t) {
+function Nc(e, t) {
   const n = z(e);
   return t.filter((r) => h(r.mapping[n])).length > 1;
 }
-function Nc(e) {
+function Pc(e) {
   const t = /* @__PURE__ */ new Map();
   for (const n of e) {
     const r = Xc(n), o = t.get(r);
@@ -2349,7 +2349,7 @@ function Bc({
   coordSystem: r,
   colorGroupsByValue: o
 }) {
-  const a = e[0], s = e.map((u) => z(u.scaleAestheticKey)), i = ko({ scale: a.scale, aesthetics: s, layers: n, coordSystem: r }), c = ln(a.variableName, t), l = ue({
+  const a = e[0], s = e.map((u) => z(u.scaleAestheticKey)), i = Vo({ scale: a.scale, aesthetics: s, layers: n, coordSystem: r }), c = ln(a.variableName, t), l = ue({
     layers: n,
     scaleType: a.scale.spec.scaleType,
     variableName: a.variableName
@@ -2375,11 +2375,11 @@ function $c(e, t, n, r, o) {
   };
 }
 function Gc(e, t, n) {
-  return e[0].scaleAestheticKey !== "color" ? null : n.get(L(t.value))?.label ?? null;
+  return e[0].scaleAestheticKey !== "color" ? null : n.get(k(t.value))?.label ?? null;
 }
 function Uc(e, t, n, r, o) {
   if (t[0].scaleAestheticKey === "color")
-    return o.get(L(e.value))?.valueFormat ?? r;
+    return o.get(k(e.value))?.valueFormat ?? r;
   const a = e.owner?.layer, s = Wc(a, n);
   return a === void 0 || s === null ? r : ue({
     layers: [a],
@@ -2405,7 +2405,7 @@ function Yc(e, t, n) {
 function Hc(e, t, n, r) {
   if (e !== "auto") return e;
   if (r.type === "polar") return "top";
-  const o = it(n, ["line", "area"]), a = it(n, ["bar"]), s = it(n, ["bar"], (c) => X(c.position)), i = t >= kc;
+  const o = it(n, ["line", "area"]), a = it(n, ["bar"]), s = it(n, ["bar"], (c) => X(c.position)), i = t >= Vc;
   return o && a ? "top" : o ? i ? "right" : "top" : s ? Co(r) ? "top" : i ? "right" : "top" : "top";
 }
 function Kc(e, t) {
@@ -2431,7 +2431,7 @@ function it(e, t, n) {
   return e.some((r) => t.includes(r.geom) && (n?.(r) ?? !0));
 }
 function Xc(e) {
-  const t = e.scale.domain.map(L);
+  const t = e.scale.domain.map(k);
   return JSON.stringify([e.variableName, e.guideType, ...t]);
 }
 function jc(e, t) {
@@ -2494,9 +2494,9 @@ class Qc extends re {
     };
   }
 }
-const Zc = (e, t) => e?.kind !== "perGroup" || t.some((r) => r.display === "direct") ? t : [], dn = (e) => e[Qr.key], Jc = (e) => L([Ye(e)]), mn = (e, t) => {
+const Zc = (e, t) => e?.kind !== "perGroup" || t.some((r) => r.display === "direct") ? t : [], dn = (e) => e[Qr.key], Jc = (e) => k([Ye(e)]), mn = (e, t) => {
   const n = t !== null ? e[t] ?? null : null;
-  return L([n]);
+  return k([n]);
 }, j = (e, t) => {
   const n = te(t);
   if (n !== void 0) return () => n;
@@ -2506,16 +2506,16 @@ const Zc = (e, t) => e?.kind !== "perGroup" || t.some((r) => r.display === "dire
     if (a === void 0) return null;
     switch (e.getType(r)) {
       case "numeric":
-        return k(a) ? a : null;
+        return V(a) ? a : null;
       case "categorical":
         return He(a) ? a : null;
       case "temporal":
-        return P(a) ? a : null;
+        return N(a) ? a : null;
       default:
         return null;
     }
   } : () => null;
-}, Fo = (e, t) => j(e, t.x), el = (e, t) => j(e, t.y), ky = (e, t) => j(e, t.label), tl = (e, t) => j(e, t.color), Ey = (e, t) => j(e, t.size), Iy = (e, t) => j(e, t.alpha), Cy = (e, t) => j(e, t.group), Fy = (e, t) => j(e, t.strokeWidth), tr = { variable: g.yRaw };
+}, Fo = (e, t) => j(e, t.x), el = (e, t) => j(e, t.y), Iy = (e, t) => j(e, t.label), tl = (e, t) => j(e, t.color), Cy = (e, t) => j(e, t.size), Fy = (e, t) => j(e, t.alpha), _y = (e, t) => j(e, t.group), Dy = (e, t) => j(e, t.strokeWidth), tr = { variable: g.yRaw };
 function Mt(e, t) {
   return X(e) ? tr : t.y ?? tr;
 }
@@ -2617,14 +2617,14 @@ function ol(e) {
 }
 function fe(e, t) {
   if (e === null || t === null) return "incomparable";
-  if (P(e) && P(t)) {
+  if (N(e) && N(t)) {
     const n = e.getTime(), r = t.getTime();
     return n < r ? "less" : n > r ? "greater" : "equal";
   }
-  return k(e) && k(t) ? e < t ? "less" : e > t ? "greater" : "equal" : "incomparable";
+  return V(e) && V(t) ? e < t ? "less" : e > t ? "greater" : "equal" : "incomparable";
 }
 function rr(e, t) {
-  return e === t ? !0 : P(e) && P(t) ? e.getTime() === t.getTime() : !1;
+  return e === t ? !0 : N(e) && N(t) ? e.getTime() === t.getTime() : !1;
 }
 function ee(e, t, n) {
   return t !== "temporal" || !He(e) ? e : an(e, void 0, n);
@@ -2688,21 +2688,21 @@ function il({
   }
   if (y.size === 0 && b.size === 0 && !S)
     return Do();
-  const w = new Uint8Array(u), V = [];
+  const w = new Uint8Array(u), L = [];
   let E = 0;
   for (let T = 0; T < u; T++) {
-    const q = d?.[T], ae = m?.[T], Qe = q !== void 0 && y.has(q), Ze = ae !== void 0 && b.has(ae), Nn = f[T] === 1;
+    const q = d?.[T], ae = m?.[T], Qe = q !== void 0 && y.has(q), Ze = ae !== void 0 && b.has(ae), Pn = f[T] === 1;
     if (r === "observation-rerender")
-      (Qe || Nn || Ze) && (w[T] = 1, E++);
+      (Qe || Pn || Ze) && (w[T] = 1, E++);
     else if (Qe)
       w[T] = 1, E++;
-    else if (Nn || Ze) {
+    else if (Pn || Ze) {
       const On = p?.[T];
-      On !== void 0 && V.push({ observation: On, observationIndex: T });
+      On !== void 0 && L.push({ observation: On, observationIndex: T });
     }
   }
   const W = E > 0 ? { ...e, data: e.data.filterByMask(w) } : null;
-  return { isDimmed: (r === "observation-rerender" || y.size > 0) && W !== null, matchedLayer: W, overlayCandidates: V };
+  return { isDimmed: (r === "observation-rerender" || y.size > 0) && W !== null, matchedLayer: W, overlayCandidates: L };
 }
 function cl(e, t) {
   const n = v(e.mapping.y), r = _o(e);
@@ -2793,7 +2793,7 @@ function hl(e) {
     }
   return !0;
 }
-const yl = (e) => e.kind === "index" ? (t, n) => String(n) : (t) => L(e.variables.map((n) => t[n])), gl = (e, t) => {
+const yl = (e) => e.kind === "index" ? (t, n) => String(n) : (t) => k(e.variables.map((n) => t[n])), gl = (e, t) => {
   if (e === "index")
     return { kind: "index" };
   const n = v(t.x);
@@ -2869,7 +2869,7 @@ class vl extends Te {
 function ar(e) {
   return e.scales.some((t) => t.scaledAesthetic === "x" && t.scaleType === "discrete");
 }
-class Po extends Error {
+class No extends Error {
   constructor(t) {
     const n = t.map((r) => `- ${r.message}`).join(`
 `);
@@ -2898,7 +2898,7 @@ class xl {
       );
     }
     if (n.length > 0)
-      throw new Po(n);
+      throw new No(n);
   }
 }
 class Sl {
@@ -2984,7 +2984,7 @@ class Sl {
 }
 const sr = A("__ungrouped__"), wl = (e, t) => t === null ? !0 : e.some(
   (n) => n.axis === t.axis && n.role === t.role && n.valueKind === t.valueKind
-), No = (e, t, n = "y") => {
+), Po = (e, t, n = "y") => {
   const r = n === "y" ? "x" : "y", o = v(t[n]), a = v(t[r]);
   if (!o || !a)
     return null;
@@ -3010,7 +3010,7 @@ class Al {
     return wl(n, a) ? o.adjust(r) : { data: r.data, mapping: {} };
   }
 }
-class Lt {
+class kt {
   /**
    * The single position channel this adjuster reads to compute the adjustment, expressed in the
    * geom-agnostic channel vocabulary. A geom is adjuster-compatible only when its manifest declares
@@ -3021,7 +3021,7 @@ class Lt {
     return null;
   }
 }
-class Tl extends Lt {
+class Tl extends kt {
   constructor() {
     super(...arguments), this.type = "dodge";
   }
@@ -3049,7 +3049,7 @@ class Tl extends Lt {
     return { data: t.addVariable(g.xMin, "numeric", d).addVariable(g.xMax, "numeric", m), mapping: {} };
   }
 }
-class Ml extends Lt {
+class Ml extends kt {
   constructor() {
     super(...arguments), this.type = "fill";
   }
@@ -3057,7 +3057,7 @@ class Ml extends Lt {
     return { axis: t, role: "point", valueKind: "value" };
   }
   adjust({ data: t, mapping: n, axis: r = "y" }) {
-    const o = No(t, n, r);
+    const o = Po(t, n, r);
     if (o === null)
       return { data: t, mapping: {} };
     const { values: a, observationIndexByPartitionAndGroup: s, uniqueGroupKeys: i, observationCount: c } = o, l = [...a], u = new Array(c).fill(0);
@@ -3079,12 +3079,12 @@ class Ml extends Lt {
           u[x] = null, l[x] = null;
           continue;
         }
-        const V = w >= 0 ? p : f;
-        if (V === 0) {
+        const L = w >= 0 ? p : f;
+        if (L === 0) {
           u[x] = 0, l[x] = 0;
           continue;
         }
-        const E = w / V;
+        const E = w / L;
         w >= 0 ? (u[x] = y, l[x] = y += E) : (l[x] = b, u[x] = b += E);
       }
     }
@@ -3092,7 +3092,7 @@ class Ml extends Lt {
     return r === "y" && (d = d.addVariable(g.yRaw, "numeric", a)), { data: d, mapping: {} };
   }
 }
-class Ll extends Lt {
+class kl extends kt {
   constructor() {
     super(...arguments), this.type = "identity";
   }
@@ -3103,7 +3103,7 @@ class Ll extends Lt {
     };
   }
 }
-class Vl extends Lt {
+class Ll extends kt {
   constructor() {
     super(...arguments), this.type = "stack";
   }
@@ -3111,7 +3111,7 @@ class Vl extends Lt {
     return { axis: t, role: "point", valueKind: "value" };
   }
   adjust({ data: t, mapping: n, axis: r = "y" }) {
-    const o = No(t, n, r);
+    const o = Po(t, n, r);
     if (o === null)
       return { data: t, mapping: {} };
     const { values: a, observationIndexByPartitionAndGroup: s, uniqueGroupKeys: i, observationCount: c } = o, l = [...a], u = new Array(c).fill(0);
@@ -3136,9 +3136,9 @@ class Vl extends Lt {
     return m !== null && (d = d.addVariable(m, "numeric", l)), { data: d, mapping: {} };
   }
 }
-class kl extends Me {
+class Vl extends Me {
   constructor() {
-    super("position"), this.register("identity", new Ll()), this.register("stack", new Vl()), this.register("fill", new Ml()), this.register("dodge", new Tl());
+    super("position"), this.register("identity", new kl()), this.register("stack", new Ll()), this.register("fill", new Ml()), this.register("dodge", new Tl());
   }
 }
 function El(e) {
@@ -3204,11 +3204,11 @@ function Rl(e, t, n, r, o) {
   }
   return t.addVariable(r, "numeric", d).addVariable(o, "numeric", m);
 }
-function Pl(e, t) {
+function Nl(e, t) {
   const n = e[t];
   return n?.kind === "position" ? n : null;
 }
-class Nl extends Te {
+class Pl extends Te {
   constructor(t) {
     super(), this.geomRegistry = t;
   }
@@ -3221,7 +3221,7 @@ class Nl extends Te {
       data: t.data,
       mapping: t.mapping,
       yScaleType: t.yScaleType,
-      getPositionScale: (a) => Pl(n.scales, a)
+      getPositionScale: (a) => Nl(n.scales, a)
     });
     return { ...t, data: o };
   }
@@ -3270,7 +3270,7 @@ class Ol extends re {
       }
     }
     if (n.length > 0)
-      throw new Po(n);
+      throw new No(n);
   }
   /**
    * Walk all layers' mappings and collect data values per scale aesthetic key.
@@ -3431,7 +3431,7 @@ class Gl extends qe {
     });
   }
 }
-const Ul = (e) => e.length === 2 && P(e[0]) && P(e[1]), he = {
+const Ul = (e) => e.length === 2 && N(e[0]) && N(e[1]), he = {
   transform: "linear",
   reverse: !1,
   nice: !0,
@@ -3689,7 +3689,7 @@ const Kl = ["grey", "red", "orange", "yellow", "green", "cyan", "blue", "purple"
     7: [900, 800, 700, 600, 500, 400, 300],
     default: [900, 800, 700, 600, 500, 400, 300, 200]
   }
-}, N = {
+}, P = {
   cyan: "#22D3EE",
   pink: "#F377EF",
   purple: "#6528F7",
@@ -3699,19 +3699,19 @@ const Kl = ["grey", "red", "orange", "yellow", "green", "cyan", "blue", "purple"
   green: "#06FF00",
   blue: "#0079FF"
 }, tt = [
-  N.cyan,
-  N.pink,
-  N.purple,
-  N.red,
-  N.orange,
-  N.yellow,
-  N.green,
-  N.blue
+  P.cyan,
+  P.pink,
+  P.purple,
+  P.red,
+  P.orange,
+  P.yellow,
+  P.green,
+  P.blue
 ], Ql = [
-  N.cyan,
-  N.green,
-  N.red,
-  N.cyan
+  P.cyan,
+  P.green,
+  P.red,
+  P.cyan
 ], nt = {
   start: "#84D1FC",
   positive: "#84FC89",
@@ -3727,7 +3727,7 @@ function Jl(e, t = "light", n) {
   return ((n !== void 0 ? cr[t][n] : void 0) ?? cr[t].default).map((o) => qt[`${e}${o}`]);
 }
 function eu(e) {
-  const t = tt.indexOf(N[e]);
+  const t = tt.indexOf(P[e]);
   return t <= 0 ? tt : [...tt.slice(t), ...tt.slice(0, t)];
 }
 function tu(e, t) {
@@ -3941,7 +3941,7 @@ const lr = "#%_ENCODED_%#", $o = (e) => {
         break;
       }
       case "arrow": {
-        a.push(Lu(d));
+        a.push(ku(d));
         break;
       }
       case "highlight":
@@ -4004,7 +4004,7 @@ const lr = "#%_ENCODED_%#", $o = (e) => {
 }, Mu = (e, t, n) => {
   const r = yt({ dataset: n, input: e, anchorVariable: t });
   return r === null ? null : e.caption === null || e.caption === void 0 ? { kind: "pinnedNumber", value: { id: e.id, anchor: r } } : { kind: "comment", value: { id: e.id, anchor: r, content: e.caption } };
-}, Lu = (e) => ({
+}, ku = (e) => ({
   id: e.id,
   start: { x: e.startX, y: e.startY },
   end: { x: e.endX, y: e.endY },
@@ -4020,9 +4020,9 @@ const lr = "#%_ENCODED_%#", $o = (e) => {
   anchorVariable: n
 }) => {
   if (!h(t) || !h(t.columnKey)) return null;
-  const r = Vu(t, n, e);
+  const r = Lu(t, n, e);
   return r === null ? null : { anchorValue: r, groupValue: $o(t.columnKey) };
-}, Vu = (e, t, n) => e.rowValue !== void 0 ? e.rowValue : t === null || !h(e.rowIndex) || !n.hasVariable(t) ? null : n.getValues(t)[e.rowIndex] ?? null, ku = [
+}, Lu = (e, t, n) => e.rowValue !== void 0 ? e.rowValue : t === null || !h(e.rowIndex) || !n.hasVariable(t) ? null : n.getValues(t)[e.rowIndex] ?? null, Vu = [
   "lilac",
   "neon_pink",
   "blackberry",
@@ -4054,7 +4054,7 @@ function _u(e) {
   }).config;
 }
 function Du(e, t) {
-  const n = Nu(e?.border), r = e?.hasRoundedCorners === !1 ? 0 : void 0, o = Ru(e, t), a = {};
+  const n = Pu(e?.border), r = e?.hasRoundedCorners === !1 ? 0 : void 0, o = Ru(e, t), a = {};
   return e?.textScale !== void 0 && (a.textScale = e.textScale), n !== void 0 && (a.border = n), r !== void 0 && (a.cornerRadius = r), o !== void 0 && (a.background = o), e?.highlightStyle !== void 0 && (a.highlightStyle = e.highlightStyle === "grey" ? "desaturate" : "dim"), Object.keys(a).length > 0 ? a : void 0;
 }
 function Ru(e, t) {
@@ -4064,15 +4064,15 @@ function Ru(e, t) {
   if (typeof n == "string")
     return { type: "solid", color: n };
 }
-const Pu = (e) => ku.includes(e);
-function Nu(e) {
+const Nu = (e) => Vu.includes(e);
+function Pu(e) {
   if (!e?.style) return;
   if (e.style === "none") return { type: "none" };
   const t = e.width ?? 0;
   if (e.style === "grey")
     return { type: "solid", color: Iu, width: t };
   if (e.style === "preset")
-    return e.color === void 0 || !Pu(e.color) ? void 0 : { type: "preset", preset: e.color, width: t };
+    return e.color === void 0 || !Nu(e.color) ? void 0 : { type: "preset", preset: e.color, width: t };
   if (e.color !== void 0)
     return e.style === "custom" ? { type: "solid", color: e.color, width: t } : { type: e.style, color: e.color, width: t };
 }
@@ -4131,10 +4131,11 @@ function Yu(e) {
 }
 const O = {
   /**
-   * Standard cartesian (x-y) coordinate system. This is the default if no coord is specified.
+   * Standard cartesian (x→horizontal, y→vertical) coordinate system. This is the default
+   * when no coord is piped onto the spec; declare it explicitly only to set axis limits.
    *
    * @example coord.cartesian() // auto-scaled axes
-   * @example coord.cartesian({ yLimits: [0, 100] }) // fixed y-axis
+   * @example coord.cartesian({ yLimits: [0, 100] }) // fixed y-axis range
    */
   cartesian: (e = {}) => ({
     type: "coord",
@@ -4142,10 +4143,11 @@ const O = {
     params: e
   }),
   /**
-   * Flipped cartesian coordinates — swaps x and y axes.
-   * Useful for horizontal bar charts or when category labels are long.
+   * Flipped cartesian coordinates — swaps the x and y axes so the x aesthetic runs
+   * vertically and y runs horizontally. The idiom for horizontal bar charts and for
+   * long category labels. The mapping stays the same; only the on-screen orientation flips.
    *
-   * @example coord.flip() // horizontal bars
+   * @example coord.flip() // horizontal bars from a vertical-bar spec
    */
   flip: (e = {}) => ({
     type: "coord",
@@ -4153,11 +4155,18 @@ const O = {
     params: e
   }),
   /**
-   * Polar coordinate system — maps data to angle (theta) and radius.
-   * Used for pie charts, donut charts, and radar/radial visualizations.
+   * Polar coordinate system — wraps the scaled positions around a centre, mapping one
+   * aesthetic to the angle (theta) and the other to the radius (scaled into
+   * `[innerRadius, 1]`). `theta` defaults to `'x'`.
+   *
+   * - Pie / donut: `geom.bar({ position: 'fill' })` with `theta: 'y'` (stacked value → angle);
+   *   set `innerRadius > 0` for a donut.
+   * - Radar / spider: `geom.line` or `geom.point` with `theta: 'x'` over a discrete x axis
+   *   (one evenly-spaced spoke per category).
    *
-   * @example coord.polar() // pie chart
-   * @example coord.polar({ innerRadius: 0.5 }) // donut chart
+   * @example coord.polar({ theta: 'y' }) // pie: stacked value → angle
+   * @example coord.polar({ theta: 'y', innerRadius: 0.5, startAngle: 90 }) // donut rotated 90°
+   * @example coord.polar({ theta: 'x' }) // radar: category → spoke angle
    */
   polar: (e = {}) => ({
     type: "coord",
@@ -4203,7 +4212,7 @@ const O = {
     lineType: "dashed",
     labelPosition: "start"
   }
-}, Le = "primary";
+}, ke = "primary";
 function Ku(e, t) {
   const n = { ...Hu };
   return e === "bar" && t === "polar" && (n.format = "percentage"), n;
@@ -4652,9 +4661,9 @@ function id(e, t, n) {
       id: e
     };
   if (e?.startsWith("preset:pastel"))
-    return { type: "pastel", variant: Pt(t) };
+    return { type: "pastel", variant: Nt(t) };
   if (e?.startsWith("preset:graphy"))
-    return { type: "graphy", variant: Pt(t) };
+    return { type: "graphy", variant: Nt(t) };
   const i = "preset:mono:";
   if (e?.startsWith(i)) {
     const l = e.slice(i.length);
@@ -4663,13 +4672,13 @@ function id(e, t, n) {
   const c = "preset:neon:";
   if (e?.startsWith(c)) {
     const l = e.slice(c.length);
-    if (ld(l)) return { type: "neon", base: l, variant: Pt(t) };
+    if (ld(l)) return { type: "neon", base: l, variant: Nt(t) };
   }
   return {
     type: "default"
   };
 }
-function Pt(e) {
+function Nt(e) {
   if (e === "waterfall")
     return "waterfall";
 }
@@ -4828,7 +4837,7 @@ function vd(e) {
   const t = {};
   return e.showDataLabels !== void 0 && (t.showDataLabels = e.showDataLabels), e.dataLabelFormat !== void 0 && (t.format = e.dataLabelFormat), e.showStackTotals !== void 0 && (t.showStackTotals = e.showStackTotals), e.showCategoryLabels !== void 0 && (t.showCategoryLabels = e.showCategoryLabels), Object.keys(t).length === 0 ? void 0 : t;
 }
-const Nt = {
+const Pt = {
   color: null,
   size: "small",
   labelCrossPosition: 0.5
@@ -4851,12 +4860,12 @@ const Nt = {
   hasStickerStyle: !1
 }, xd = (e, t) => ({
   differenceArrows: (e?.differenceArrows ?? []).map((n) => Td(n, t)),
-  shapes: (e?.shapes ?? []).map(kd),
+  shapes: (e?.shapes ?? []).map(Vd),
   freeformArrows: (e?.freeformArrows ?? []).map(Ed),
   textAnnotations: (e?.textAnnotations ?? []).map(Ad),
   stickers: (e?.stickers ?? []).map((n) => Md(n, t)),
-  pinnedNumbers: (e?.pinnedNumbers ?? []).map((n) => Ld(n, t)),
-  comments: (e?.comments ?? []).map((n) => Vd(n, t)),
+  pinnedNumbers: (e?.pinnedNumbers ?? []).map((n) => kd(n, t)),
+  comments: (e?.comments ?? []).map((n) => Ld(n, t)),
   custom: (e?.custom ?? []).map((n) => Sd(n, t))
 }), Sd = (e, t) => ({
   id: e.id ?? crypto.randomUUID(),
@@ -4877,9 +4886,9 @@ const Nt = {
   start: we(e.start, t),
   end: we(e.end, t),
   label: e.label,
-  color: e.color ?? Nt.color,
-  size: e.size ?? Nt.size,
-  labelCrossPosition: e.labelCrossPosition ?? Nt.labelCrossPosition
+  color: e.color ?? Pt.color,
+  size: e.size ?? Pt.size,
+  labelCrossPosition: e.labelCrossPosition ?? Pt.labelCrossPosition
 }), we = (e, t) => {
   if (e.layerIndex === void 0)
     return { anchorValue: e.anchorValue, groupValue: e.groupValue };
@@ -4893,14 +4902,14 @@ const Nt = {
   id: e.id ?? crypto.randomUUID(),
   anchor: we(e.anchor, t),
   sticker: e.sticker
-}), Ld = (e, t) => ({
+}), kd = (e, t) => ({
   id: e.id ?? crypto.randomUUID(),
   anchor: we(e.anchor, t)
-}), Vd = (e, t) => ({
+}), Ld = (e, t) => ({
   id: e.id ?? crypto.randomUUID(),
   anchor: we(e.anchor, t),
   content: e.content
-}), kd = (e) => ({
+}), Vd = (e) => ({
   id: e.id ?? crypto.randomUUID(),
   kind: e.kind ?? ye.kind,
   zOrder: e.zOrder ?? ye.zOrder,
@@ -5020,16 +5029,16 @@ function Dd(e, t) {
     };
   });
 }
-const Rd = "linear", Pd = 3, Nd = 0.3;
-function Ve(e, t) {
+const Rd = "linear", Nd = 3, Pd = 0.3;
+function Le(e, t) {
   const n = e ?? t, r = typeof n == "string" ? n : n.type;
   if (r === "smooth") {
     const o = typeof n == "string" ? void 0 : n;
     return {
       type: "smooth",
       method: o?.method ?? Rd,
-      order: o?.order ?? Pd,
-      bandwidth: o?.bandwidth ?? Nd
+      order: o?.order ?? Nd,
+      bandwidth: o?.bandwidth ?? Pd
     };
   }
   return { type: r };
@@ -5054,7 +5063,7 @@ function Bd(e, t, n) {
   const r = n.map((o) => Od(e, t, o));
   return Xd(r);
 }
-const $d = (e, t, n) => n.label !== void 0 ? n.label : jd(e, t, n), Gd = (e) => Vc(e.geom);
+const $d = (e, t, n) => n.label !== void 0 ? n.label : jd(e, t, n), Gd = (e) => Lc(e.geom);
 function Ud(e, t, n) {
   const r = n.position ?? "identity";
   return {
@@ -5062,16 +5071,16 @@ function Ud(e, t, n) {
     type: n.type,
     geom: n.geom,
     mapping: n.mapping ?? {},
-    stat: Ve(n.stat, "identity"),
+    stat: Le(n.stat, "identity"),
     position: r,
-    yScaleType: n.yScaleType ?? Le,
+    yScaleType: n.yScaleType ?? ke,
     params: n.params ?? {},
     transforms: n.transforms ?? [],
     interactive: n.interactive ?? !0,
-    dataLabels: ke(e, n, r, t)
+    dataLabels: Ve(e, n, r, t)
   };
 }
-const ke = (e, t, n, r) => {
+const Ve = (e, t, n, r) => {
   const o = { ...e, ...t.mapping }, a = $d(t.geom, n, o);
   return {
     ...Ku(t.geom, r),
@@ -5086,13 +5095,13 @@ function Wd(e, t, n) {
     type: n.type,
     geom: n.geom,
     mapping: n.mapping ?? {},
-    stat: Ve(n.stat, ut.stat.type),
+    stat: Le(n.stat, ut.stat.type),
     position: r,
-    yScaleType: n.yScaleType ?? Le,
+    yScaleType: n.yScaleType ?? ke,
     params: Ae({}, ut.params, n.params),
     transforms: n.transforms ?? [],
     interactive: n.interactive ?? !0,
-    dataLabels: ke(e, n, r, t)
+    dataLabels: Ve(e, n, r, t)
   };
 }
 function Yd(e, t, n) {
@@ -5102,13 +5111,13 @@ function Yd(e, t, n) {
     type: n.type,
     geom: n.geom,
     mapping: n.mapping ?? {},
-    stat: Ve(n.stat, Ft.stat.type),
+    stat: Le(n.stat, Ft.stat.type),
     position: r,
-    yScaleType: n.yScaleType ?? Le,
+    yScaleType: n.yScaleType ?? ke,
     params: Ae({}, Ft.params, n.params),
     transforms: n.transforms ?? [],
     interactive: n.interactive ?? !0,
-    dataLabels: ke(e, n, r, t)
+    dataLabels: Ve(e, n, r, t)
   };
 }
 function Hd(e, t, n) {
@@ -5120,13 +5129,13 @@ function Hd(e, t, n) {
     type: n.type,
     geom: n.geom,
     mapping: n.mapping ?? {},
-    stat: Ve(n.stat, _t.stat.type),
+    stat: Le(n.stat, _t.stat.type),
     position: o,
-    yScaleType: n.yScaleType ?? Le,
+    yScaleType: n.yScaleType ?? ke,
     params: r,
     transforms: n.transforms ?? [],
     interactive: n.interactive ?? !0,
-    dataLabels: ke(e, n, o, t)
+    dataLabels: Ve(e, n, o, t)
   };
 }
 function Kd(e, t, n) {
@@ -5136,13 +5145,13 @@ function Kd(e, t, n) {
     type: n.type,
     geom: n.geom,
     mapping: n.mapping ?? {},
-    stat: Ve(n.stat, Dt.stat.type),
+    stat: Le(n.stat, Dt.stat.type),
     position: r,
-    yScaleType: n.yScaleType ?? Le,
+    yScaleType: n.yScaleType ?? ke,
     params: { ...Dt.params, ...n.params },
     transforms: n.transforms ?? [],
     interactive: n.interactive ?? !0,
-    dataLabels: ke(e, n, r, t)
+    dataLabels: Ve(e, n, r, t)
   };
 }
 function zd(e, t, n) {
@@ -5152,13 +5161,13 @@ function zd(e, t, n) {
     type: n.type,
     geom: n.geom,
     mapping: n.mapping ?? {},
-    stat: Ve(n.stat, Ie.stat.type),
+    stat: Le(n.stat, Ie.stat.type),
     position: n.position ?? Ie.position,
-    yScaleType: n.yScaleType ?? Le,
+    yScaleType: n.yScaleType ?? ke,
     params: Ae({}, Ie.params, n.params),
     transforms: n.transforms ?? [],
     interactive: n.interactive ?? Ie.interactive,
-    dataLabels: ke(e, n, r, t)
+    dataLabels: Ve(e, n, r, t)
   };
 }
 const Xd = (e) => {
@@ -5168,7 +5177,7 @@ const Xd = (e) => {
   return t.size === 0 ? e : e.map((n) => {
     if (n.geom !== "rule" || !t.has(n.yScaleType)) return n;
     const r = te(n.mapping.y);
-    if (!k(r)) return n;
+    if (!V(r)) return n;
     const o = Math.min(1, Math.max(0, r));
     return { ...n, mapping: { ...n.mapping, y: { value: o } } };
   });
@@ -5363,12 +5372,12 @@ class im {
     });
   }
 }
-class Vt {
+class Lt {
   compute(t) {
     return t.data.size() === 0 ? { data: t.data, mapping: {} } : this.computeStat(t);
   }
 }
-class cm extends Vt {
+class cm extends Lt {
   constructor() {
     super(...arguments), this.type = "count", this.computedVariables = /* @__PURE__ */ new Set(["y"]);
   }
@@ -5385,7 +5394,7 @@ class cm extends Vt {
     };
   }
 }
-class lm extends Vt {
+class lm extends Lt {
   constructor() {
     super(...arguments), this.type = "identity", this.computedVariables = /* @__PURE__ */ new Set();
   }
@@ -5393,7 +5402,7 @@ class lm extends Vt {
     return { data: t, mapping: {} };
   }
 }
-class um extends Vt {
+class um extends Lt {
   constructor() {
     super(...arguments), this.type = "mean", this.computedVariables = /* @__PURE__ */ new Set(["y"]);
   }
@@ -5408,7 +5417,7 @@ class um extends Vt {
   }
 }
 const dm = 2, Xo = 1440 * 60 * 1e3;
-class mm extends Vt {
+class mm extends Lt {
   constructor() {
     super(...arguments), this.type = "smooth", this.computedVariables = /* @__PURE__ */ new Set();
   }
@@ -5468,7 +5477,7 @@ const vr = ({
 }, fm = (e) => {
   let t = null;
   for (const n of e) {
-    if (!P(n)) continue;
+    if (!N(n)) continue;
     const r = n.getTime();
     (t === null || r < t) && (t = r);
   }
@@ -5481,9 +5490,9 @@ const vr = ({
 }) => {
   switch (t) {
     case "numeric":
-      return !k(e) || !Number.isFinite(e) ? null : e;
+      return !V(e) || !Number.isFinite(e) ? null : e;
     case "temporal": {
-      if (!P(e)) return null;
+      if (!N(e)) return null;
       const o = e.getTime();
       return r === null ? o : (o - r) / Xo + 1;
     }
@@ -5600,7 +5609,7 @@ const wm = ({ layer: e }) => {
   let n = 0, r = 0;
   for (const o of e.data) {
     const a = o[t];
-    k(a) && (n += a, r += Math.abs(a));
+    V(a) && (n += a, r += Math.abs(a));
   }
   return { grandTotal: n, absoluteGrandTotal: r };
 }, Am = ({ layer: e }) => {
@@ -5679,7 +5688,7 @@ class Mm extends re {
     return t.transforms.reduce((n, r) => this.registry.get(r.transformType).apply(n, r), t.data);
   }
 }
-class Lm {
+class km {
   constructor() {
     this.transformType = "aggregate";
   }
@@ -5693,7 +5702,7 @@ class Lm {
     return t.groupBy(...r.groupby).rollup(o);
   }
 }
-class Vm {
+class Lm {
   constructor() {
     this.transformType = "constant";
   }
@@ -5702,7 +5711,7 @@ class Vm {
     return t.addConstantVariable(r.variableName, r.type, r.value);
   }
 }
-class km {
+class Vm {
   constructor() {
     this.transformType = "filter";
   }
@@ -5736,7 +5745,7 @@ class Im {
 }
 class Cm extends Me {
   constructor() {
-    super("transform"), this.register("aggregate", new Lm()), this.register("constant", new Vm()), this.register("filter", new km()), this.register("reshape", new Em()), this.register("sort", new Im());
+    super("transform"), this.register("aggregate", new km()), this.register("constant", new Lm()), this.register("filter", new Vm()), this.register("reshape", new Em()), this.register("sort", new Im());
   }
 }
 const xr = {
@@ -5780,7 +5789,7 @@ const Dm = (e, t, n) => {
     return () => r;
   }
   return (r) => h(r[t]) ? n.map(r[t]) : null;
-}, _y = [
+}, Ry = [
   "data",
   "transform",
   "constantMapping",
@@ -5829,7 +5838,7 @@ class Rm {
    */
   recompile({ spec: t, data: n }) {
     return this.trackCompile(() => n === void 0 ? this.runPipeline({ spec: t }) : (this.lastData = n, this.runPipeline({
-      spec: kt(t, { data: this.dataCompiler.compile(n) })
+      spec: Vt(t, { data: this.dataCompiler.compile(n) })
     })));
   }
   /**
@@ -5865,12 +5874,12 @@ class Rm {
   }
   runPipeline({ spec: t }) {
     return xt({ spec: t }).pipe(({ spec: r }) => ({
-      spec: kt(r, {
+      spec: Vt(r, {
         data: this.transformCompiler.compile({ data: r.data, transforms: r.transforms })
       })
     })).pipe(({ spec: r }) => {
       const o = this.constantMappingCompiler.compile({ data: r.data, mapping: r.mapping });
-      return { spec: kt(r, { data: o.data, mapping: o.mapping }) };
+      return { spec: Vt(r, { data: o.data, mapping: o.mapping }) };
     }).pipe(({ spec: r }) => {
       const o = {
         data: r.data,
@@ -5916,24 +5925,24 @@ class Rm {
     })).result();
   }
 }
-const Dy = (e) => {
-  const t = new Ni({ geoms: e?.geoms }), n = new Ei(t), r = new Sm(), o = new ou(), a = new Mm(new Cm());
+const Ny = (e) => {
+  const t = new Pi({ geoms: e?.geoms }), n = new Ei(t), r = new Sm(), o = new ou(), a = new Mm(new Cm());
   return new Rm(
     new Ti(),
     new sm(),
     a,
-    new Ls(),
+    new ks(),
     new xl(a, new Sl(t, r)),
     new vl(
       a,
       new im(r),
       new Oi(),
       n,
-      new Al(new kl())
+      new Al(new Vl())
     ),
     new Ol(o),
     new Is(new Ws(t)),
-    new Nl(t),
+    new Pl(t),
     new Fm(n),
     new Qc(n),
     new Tm(n),
@@ -5942,18 +5951,18 @@ const Dy = (e) => {
     new ys(n)
   );
 };
-function Ry(e, t) {
+function Py(e, t) {
   return e.geom === t;
 }
 const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
-  if (!P(t))
+  if (!N(t))
     return gn;
   try {
     return e(t);
   } catch {
     return Qo;
   }
-}, oe = (e) => (t) => k(t) ? e(t) : gn, bn = (e) => (t) => He(t) ? t : gn, Pm = 2, Nm = 3, Om = 2, Bm = 0, $m = 1, Gm = 2, Um = rs.humanizer({
+}, oe = (e) => (t) => V(t) ? e(t) : gn, bn = (e) => (t) => He(t) ? t : gn, Nm = 2, Pm = 3, Om = 2, Bm = 0, $m = 1, Gm = 2, Um = rs.humanizer({
   language: "en",
   spacer: "",
   delimiter: " ",
@@ -5975,7 +5984,7 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
   numberFormat: n,
   intlOptions: r
 }) => oe((o) => {
-  const a = typeof n.decimals == "number" ? n.decimals : Pm, s = wn(o, a), { base: i, suffix: c } = Sn(o, n.abbreviation), l = {
+  const a = typeof n.decimals == "number" ? n.decimals : Nm, s = wn(o, a), { base: i, suffix: c } = Sn(o, n.abbreviation), l = {
     ...s,
     ...ao(e) ? { style: "currency", currencyDisplay: "narrowSymbol", currency: e.iso } : {},
     ...r
@@ -6006,19 +6015,19 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
       return Sn(e, n);
     }
     default:
-      return { base: e / Ne[t], suffix: t };
+      return { base: e / Pe[t], suffix: t };
   }
 }, wn = (e, t) => {
   if (typeof t == "number")
     return { minimumFractionDigits: t, maximumFractionDigits: t };
-  const n = Math.ceil(Math.log10(Math.abs(e))), r = n >= Nm ? Bm : n === Om ? $m : Gm;
+  const n = Math.ceil(Math.log10(Math.abs(e))), r = n >= Pm ? Bm : n === Om ? $m : Gm;
   return {
     minimumFractionDigits: t === "auto" ? 0 : r,
     maximumFractionDigits: r
   };
 }, Wm = (e) => {
   const t = Math.abs(e);
-  return t >= Ne.b ? "b" : t >= Ne.m ? "m" : t >= Ne.k ? "k" : "none";
+  return t >= Pe.b ? "b" : t >= Pe.m ? "m" : t >= Pe.k ? "k" : "none";
 }, Ym = ({ locale: e, intlOptions: t }) => _(
   (n) => Intl.DateTimeFormat(e, { dateStyle: "medium", ...R, ...t }).format(n)
 ), Hm = ({ locale: e, intlOptions: t }) => _((n) => {
@@ -6079,36 +6088,36 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
   intlOptions: r
 }) => oe((o) => {
   const s = {
-    ...Vn(o, n),
+    ...Ln(o, n),
     notation: "compact",
     ...ao(e) ? { style: "currency", currencyDisplay: "narrowSymbol", currency: e.iso } : {},
     ...r
   };
-  return Ln(o, t, s);
+  return kn(o, t, s);
 }), Zm = ({
   locale: e,
   tickValues: t,
   intlOptions: n
 }) => oe((r) => {
-  const a = { ...Vn(r, t), notation: "compact", ...n };
-  return Ln(r, e, a);
+  const a = { ...Ln(r, t), notation: "compact", ...n };
+  return kn(r, e, a);
 }), Jm = ({
   locale: e,
   tickValues: t,
   intlOptions: n
 }) => oe((r) => {
   const a = {
-    ...Vn(r, t),
+    ...Ln(r, t),
     notation: "compact",
     ...n,
     style: "percent"
   };
-  return Ln(r, e, a);
-}), Ln = (e, t, n) => Intl.NumberFormat(t, n).formatToParts(e).map((o) => o.type === "compact" ? o.value.toLowerCase() : o.value).join(""), sa = (e) => Math.abs(e) > Sr ? sa(e / Sr) : Number.isInteger(e), ep = (e) => {
+  return kn(r, e, a);
+}), kn = (e, t, n) => Intl.NumberFormat(t, n).formatToParts(e).map((o) => o.type === "compact" ? o.value.toLowerCase() : o.value).join(""), sa = (e) => Math.abs(e) > Sr ? sa(e / Sr) : Number.isInteger(e), ep = (e) => {
   if (e.length < 2) return !1;
   const [t, n] = e;
   return typeof t != "number" || typeof n != "number" ? !1 : Math.abs(n - t) < Xm;
-}, Vn = (e, t) => sa(e) ? { minimumFractionDigits: 0, maximumFractionDigits: 0 } : ep(t) ? { minimumFractionDigits: 0, maximumFractionDigits: jm } : { minimumFractionDigits: 0, maximumFractionDigits: qm }, tp = ({
+}, Ln = (e, t) => sa(e) ? { minimumFractionDigits: 0, maximumFractionDigits: 0 } : ep(t) ? { minimumFractionDigits: 0, maximumFractionDigits: jm } : { minimumFractionDigits: 0, maximumFractionDigits: qm }, tp = ({
   locale: e,
   intlOptions: t
 }) => _(
@@ -6138,7 +6147,7 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
   intlOptions: t
 }) => _(
   (n) => Intl.DateTimeFormat(e, { timeStyle: "short", ...R, ...t }).format(n)
-), kn = (e) => {
+), Vn = (e) => {
   const { valueFormat: t } = e;
   switch (t.type) {
     case "currency":
@@ -6170,7 +6179,7 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
     case "year":
       return Mn(e);
     case "lookup":
-      return kn({ ...e, valueFormat: t.fallback });
+      return Vn({ ...e, valueFormat: t.fallback });
     default: {
       const n = t;
       throw new Error(`Unhandled value format: ${n.type}`);
@@ -6322,7 +6331,7 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
   return (o, a) => {
     if (a === void 0 || a[r] === void 0)
       return t(o);
-    const s = L(a[r]), i = n[s];
+    const s = k(a[r]), i = n[s];
     return i !== void 0 ? i(o, a) : t(o);
   };
 }, F = (e) => {
@@ -6409,7 +6418,7 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
 }, vp = (e) => {
   const t = Tr(e.rows, e.height), n = Tr(e.cols, e.width), r = Mr(t), o = Mr(n), a = /* @__PURE__ */ new Map();
   for (const s of e.placements) {
-    const i = s.rowSpan ?? 1, c = s.colSpan ?? 1, l = o[s.col] ?? 0, u = r[s.row] ?? 0, d = Lr(n, s.col, c), m = Lr(t, s.row, i);
+    const i = s.rowSpan ?? 1, c = s.colSpan ?? 1, l = o[s.col] ?? 0, u = r[s.row] ?? 0, d = kr(n, s.col, c), m = kr(t, s.row, i);
     a.set(s.name, { x: l, y: u, width: Math.max(0, d), height: Math.max(0, m) });
   }
   return a;
@@ -6459,7 +6468,7 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
   for (let r = 0; r < e.length; r++)
     t[r] = n, n += e[r] ?? 0;
   return t;
-}, Lr = (e, t, n) => {
+}, kr = (e, t, n) => {
   let r = 0;
   const o = Math.min(t + n, e.length);
   for (let a = t; a < o; a++)
@@ -6517,8 +6526,8 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
       },
       { name: "panel", row: "panel", col: "panel" },
       ...Mp(n.axes),
-      ...Lp(n.axesLabels, n.axes),
-      ...Vp(n.legends)
+      ...kp(n.axesLabels, n.axes),
+      ...Lp(n.legends)
     ],
     containerSize: e,
     padding: Ap
@@ -6526,13 +6535,13 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
 }, Mp = (e) => {
   const t = [];
   return e.top > 0 && t.push({ name: "topAxis", row: "topAxis", col: "panel" }), e.bottom > 0 && t.push({ name: "bottomAxis", row: "bottomAxis", col: "panel" }), e.left > 0 && t.push({ name: "leftAxis", row: "panel", col: "leftAxis" }), e.right > 0 && t.push({ name: "rightAxis", row: "panel", col: "rightAxis" }), t;
-}, Lp = (e, t) => {
+}, kp = (e, t) => {
   const n = [];
   return e.top > 0 || t.top > 0 ? (e.top > 0 && n.push({ name: "topAxisLabel", row: "topAxisLabel", col: "panel" }), e.left > 0 && n.push({ name: "leftAxisLabel", row: "topAxis", col: "leftAxis" }), e.right > 0 && n.push({ name: "rightAxisLabel", row: "topAxis", col: "rightAxis" })) : (e.left > 0 && n.push({ name: "leftAxisLabel", row: "topAxisLabel", col: "leftAxis" }), e.right > 0 && n.push({ name: "rightAxisLabel", row: "topAxisLabel", col: "rightAxis" })), e.bottom > 0 && n.push({ name: "bottomAxisLabel", row: "bottomAxisLabel", col: "panel" }), n;
-}, Vp = (e) => {
+}, Lp = (e) => {
   const t = [];
   return e.top > 0 && t.push({ name: "topLegend", row: "topLegend", col: "leftAxis", colEnd: "rightAxis" }), e.bottom > 0 && t.push({ name: "bottomLegend", row: "bottomLegend", col: "leftAxis", colEnd: "rightAxis" }), e.left > 0 && t.push({ name: "leftLegend", row: "panel", col: "leftLegend" }), e.right > 0 && t.push({ name: "rightLegend", row: "panel", col: "rightLegend" }), t;
-}, kp = ({
+}, Vp = ({
   annotations: e,
   mainAxis: t,
   panelRect: n,
@@ -6546,23 +6555,23 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
   let u = 0, d = 0;
   for (const m of e.differenceArrows) {
     const { start: p, end: f, size: y, label: b } = m;
-    if (!Vr(p.x, p.y) || !Vr(f.x, f.y)) continue;
+    if (!Lr(p.x, p.y) || !Lr(f.x, f.y)) continue;
     const S = ca(y, r), x = S.offsetFromHigherObservation + S.arrowheadSize + S.arrowEndGap, w = la({
       locale: o,
       kind: b,
       startValue: p.measurementValue,
       endValue: f.measurementValue
-    }), V = a(w, y);
+    }), L = a(w, y);
     if (i) {
-      const E = Math.max(p.x, f.x), W = x + V.width / 2 + S.labelPaddingX;
-      d = Math.max(d, kr(W, E, l));
+      const E = Math.max(p.x, f.x), W = x + L.width / 2 + S.labelPaddingX;
+      d = Math.max(d, Vr(W, E, l));
     } else {
       const E = Math.max(p.y, f.y), W = x + S.labelLineHeight / 2 + S.labelPaddingY;
-      u = Math.max(u, kr(W, E, c));
+      u = Math.max(u, Vr(W, E, c));
     }
   }
   return { top: Math.ceil(u), right: Math.ceil(d), bottom: 0, left: 0 };
-}, Vr = (e, t) => e >= 0 && e <= 1 && t >= 0 && t <= 1, kr = (e, t, n) => {
+}, Lr = (e, t) => e >= 0 && e <= 1 && t >= 0 && t <= 1, Vr = (e, t, n) => {
   if (t <= 0) return 0;
   const r = (e - (1 - t) * n) / t;
   return Math.max(0, r);
@@ -6611,7 +6620,7 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
   if (da(e)) return 0;
   const r = ma(e, t.width, n);
   return n.measureHeadline(e.formatted, r).height;
-}, Py = ({
+}, Oy = ({
   headline: e,
   layout: t,
   containerSize: n,
@@ -6638,7 +6647,7 @@ const gn = "–", Qo = "n/a", R = { timeZone: "UTC" }, _ = (e) => (t) => {
   const n = Math.min(e.width, e.height) / 2, r = t * n * Math.SQRT2, o = e.x + e.width / 2, a = e.y + e.height / 2;
   return { x: o - r / 2, y: a - r / 2, width: r, height: r };
 }, ma = (e, t, n) => Ip({ size: e.size, availableWidth: t, measureStripWidth: pa(e, n) }), pa = (e, t) => (n) => t.measureHeadline(e.formatted, n).width, Fe = { x: 0, y: 0, width: 0, height: 0 }, Rp = "0000";
-class Ny {
+class By {
   constructor(t) {
     this.measurer = t;
   }
@@ -6653,7 +6662,7 @@ class Ny {
       headline: t.headline,
       locale: t.formattingLocale ?? t.parsingLocale
     }).pipe(({ axes: r, numberFormat: o, locale: a }) => {
-      const s = r.filter((i) => i.geometry !== "linear").map((i) => Np(i, Cr(i, a, o)));
+      const s = r.filter((i) => i.geometry !== "linear").map((i) => Pp(i, Cr(i, a, o)));
       return {
         cartesianAxes: r.filter((i) => i.geometry === "linear"),
         formattedPolarAxes: s,
@@ -6771,7 +6780,7 @@ class Ny {
    */
   measureAnnotationOverflow(t, n, r, o) {
     if (!t.annotations || t.annotations.differenceArrows.length === 0 || t.coordSystem?.type !== "cartesian") return o;
-    const a = kp({
+    const a = Vp({
       annotations: t.annotations,
       mainAxis: t.coordSystem.mainAxis,
       panelRect: n,
@@ -6861,15 +6870,15 @@ class Ny {
     return t === void 0 ? 0 : _p({ headline: t, containerSize: n, measurer: this.measurer });
   }
 }
-const Er = 5, ot = 8, Ir = (e) => e === "left" || e === "right", Pp = (e) => {
+const Er = 5, ot = 8, Ir = (e) => e === "left" || e === "right", Np = (e) => {
   const [t, ...n] = e.tickCandidates;
   if (t)
     return e.geometry === "circular" ? t : n.reduce(
       (r, o) => Math.abs(o.ticks.length - Er) < Math.abs(r.ticks.length - Er) ? o : r,
       t
     );
-}, Np = (e, t) => {
-  const { tickCandidates: n, ...r } = e, o = Pp(e);
+}, Pp = (e, t) => {
+  const { tickCandidates: n, ...r } = e, o = Np(e);
   if (!o) return { ...r, ticks: [], labelRotation: 0, labelMaxWidthPx: null };
   const a = t(o), s = o.ticks.map((i) => ({ ...i, formattedLabel: a(i.value) }));
   return { ...r, ticks: s, labelRotation: 0, labelMaxWidthPx: null };
@@ -6892,7 +6901,7 @@ const Er = 5, ot = 8, Ir = (e) => e === "left" || e === "right", Pp = (e) => {
   return (a) => {
     const s = o.get(a);
     if (s) return s;
-    const i = kn({
+    const i = Vn({
       valueFormat: a.valueFormat ?? e.valueFormat,
       locale: t,
       numberFormat: n,
@@ -6901,7 +6910,7 @@ const Er = 5, ot = 8, Ir = (e) => e === "left" || e === "right", Pp = (e) => {
     return o.set(a, i), i;
   };
 };
-function Oy(e, t, n, r) {
+function $y(e, t, n, r) {
   const o = /* @__PURE__ */ new Map();
   if (!n || n.kind !== "visual" || n.domain.length <= 1) return o;
   const a = new Map(t.map((s) => [s.id, s.swatchShape]));
@@ -6946,7 +6955,7 @@ function $p(e, t) {
     cross: In(e, t)
   };
 }
-function By(e) {
+function Gy(e) {
   return e.type === "cartesian";
 }
 const Cn = 12, Gp = 4, Up = (e) => {
@@ -7046,7 +7055,7 @@ const Cn = 12, Gp = 4, Up = (e) => {
     if (m === "") continue;
     const { width: p, height: f } = r("dataLabel", m), y = fa(d, n);
     p > y.width && (c = !0);
-    const b = l === null ? null : u[l], S = k(b) && b < 0;
+    const b = l === null ? null : u[l], S = V(b) && b < 0;
     i.push({ key: s(u), isNegative: S, text: m, labelWidth: p, labelHeight: f, bounds: y });
   }
   return { entries: i, shouldRotate: !a && c };
@@ -7113,9 +7122,9 @@ const Cn = 12, Gp = 4, Up = (e) => {
   if (d + zt < p) {
     if (m > f) return null;
     if (o) return { x: c, y: l, isRotated: !0, position: "inside" };
-    const V = b - S * (y + zt);
+    const L = b - S * (y + zt);
     return {
-      ...i ? { x: c, y: V } : { x: V, y: l },
+      ...i ? { x: c, y: L } : { x: L, y: l },
       isRotated: !1,
       position: "inside"
     };
@@ -7230,8 +7239,8 @@ const cf = " · ", lf = (e) => typeof e == "string" ? e : e instanceof Date ? e.
     if (i === null || c === null || l === null) continue;
     const u = e.formatLabel(s);
     if (u === "") continue;
-    const d = n === null ? null : n(s), m = d === null ? u : `${lf(d)}${cf}${u}`, { width: p, height: f } = e.measureDataLabel("dataLabel", m), y = (i + c) / 2, b = Math.abs(Math.sin(y)) * (p / 2) + Math.abs(Math.cos(y)) * (f / 2), S = l * a + Gp + b, x = r + Math.sin(y) * S, w = o - Math.cos(y) * S, V = p / 2, E = f / 2;
-    x - V < 0 || x + V > e.panelRect.width || w - E < 0 || w + E > e.panelRect.height || t.push({
+    const d = n === null ? null : n(s), m = d === null ? u : `${lf(d)}${cf}${u}`, { width: p, height: f } = e.measureDataLabel("dataLabel", m), y = (i + c) / 2, b = Math.abs(Math.sin(y)) * (p / 2) + Math.abs(Math.cos(y)) * (f / 2), S = l * a + Gp + b, x = r + Math.sin(y) * S, w = o - Math.cos(y) * S, L = p / 2, E = f / 2;
+    x - L < 0 || x + L > e.panelRect.width || w - E < 0 || w + E > e.panelRect.height || t.push({
       layerId: e.layer.id,
       key: e.getObservationKey(s),
       x,
@@ -7319,11 +7328,11 @@ const hf = ({
   const t = _o(e);
   return (n) => {
     const r = Se(n), o = J(n);
-    if (!k(r) || !k(o)) return null;
+    if (!V(r) || !V(o)) return null;
     const a = Math.abs(o - r);
     if (a === 0) return null;
     const s = t(n);
-    return k(s) ? s / a : null;
+    return V(s) ? s / a : null;
   };
 }, xf = ({
   layer: e,
@@ -7341,7 +7350,7 @@ const hf = ({
   return (d) => {
     const m = s(d);
     if (m === null) return "";
-    if (!u || !k(m)) return c(m, d);
+    if (!u || !V(m)) return c(m, d);
     const p = i(d);
     return p === null || p === 0 ? c(m, d) : l(m / p);
   };
@@ -7386,7 +7395,7 @@ const hf = ({
   line: { cartesian: nf },
   point: { cartesian: of },
   area: { cartesian: Wp }
-}, $y = ({
+}, Uy = ({
   layers: e,
   coordSystem: t,
   axes: n,
@@ -7417,7 +7426,7 @@ const hf = ({
 }, Mf = (e, t, n, r) => {
   const o = r.offsetFromHigherObservation + r.arrowheadSize + r.arrowEndGap;
   return e ? Math.max(t.x, n.x) + o : Math.min(t.y, n.y) - o;
-}, Lf = (e, t, n, { arrowStartGap: r, arrowEndGap: o, curveRadius: a }) => {
+}, kf = (e, t, n, { arrowStartGap: r, arrowEndGap: o, curveRadius: a }) => {
   const s = { x: e.x, y: e.y - r }, i = { x: e.x, y: n }, c = { x: t.x, y: n }, l = { x: t.x, y: t.y - o }, u = t.x > e.x ? 1 : -1;
   return `
     M ${s.x} ${s.y}
@@ -7427,7 +7436,7 @@ const hf = ({
     Q ${c.x} ${c.y} ${c.x} ${c.y + a}
     L ${l.x} ${l.y}
   `;
-}, Vf = (e, t, n, { arrowStartGap: r, arrowEndGap: o, curveRadius: a }) => {
+}, Lf = (e, t, n, { arrowStartGap: r, arrowEndGap: o, curveRadius: a }) => {
   const s = { x: e.x + r, y: e.y }, i = { x: n, y: e.y }, c = { x: n, y: t.y }, l = { x: t.x + o, y: t.y }, u = t.y > e.y ? 1 : -1;
   return `
     M ${s.x} ${s.y}
@@ -7437,7 +7446,7 @@ const hf = ({
     Q ${c.x} ${c.y} ${c.x - a} ${c.y}
     L ${l.x} ${l.y}
   `;
-}, kf = (e, t, { arrowEndGap: n, arrowheadSize: r }) => e ? `
+}, Vf = (e, t, { arrowEndGap: n, arrowheadSize: r }) => e ? `
       M ${t.x + n + r} ${t.y - r}
       L ${t.x + n} ${t.y}
       L ${t.x + n + r} ${t.y + r}
@@ -7451,7 +7460,7 @@ const hf = ({
     return { x: r, y: i + a * o };
   }
   return { x: Math.min(t.x, n.x) + a * o, y: r };
-}, If = (e, t, n) => Math.abs(e ? t.y - n.y : t.x - n.x), Gy = ({
+}, If = (e, t, n) => Math.abs(e ? t.y - n.y : t.x - n.x), Wy = ({
   arrow: e,
   mainAxis: t,
   panelWidth: n,
@@ -7459,12 +7468,12 @@ const hf = ({
   textScale: o,
   locale: a
 }) => {
-  const s = t === "y", i = { x: e.start.x * n, y: (1 - e.start.y) * r }, c = { x: e.end.x * n, y: (1 - e.end.y) * r }, l = ca(e.size, o), u = Mf(s, i, c, l), d = (s ? Vf : Lf)(
+  const s = t === "y", i = { x: e.start.x * n, y: (1 - e.start.y) * r }, c = { x: e.end.x * n, y: (1 - e.end.y) * r }, l = ca(e.size, o), u = Mf(s, i, c, l), d = (s ? Lf : kf)(
     i,
     c,
     u,
     l
-  ), m = kf(s, c, l), p = If(s, i, c), f = Ef(
+  ), m = Vf(s, c, l), p = If(s, i, c), f = Ef(
     s,
     i,
     c,
@@ -7491,7 +7500,7 @@ const hf = ({
     labelStrokeWidth: l.labelStrokeWidth,
     labelFontWeight: l.labelFontWeight
   };
-}, Cf = 100, Uy = ({
+}, Cf = 100, Yy = ({
   items: e,
   containerHeight: t,
   labelHeight: n
@@ -7517,7 +7526,7 @@ const hf = ({
       break;
   }
   return { placements: r.filter((l) => l.y >= 0 && l.y <= t).map((l) => ({ y: l.y, anchorY: l.anchorY, payload: l.payload })), hasOverlap: a };
-}, Wy = ({
+}, Hy = ({
   headline: e,
   show: t,
   numberFormat: n,
@@ -7528,9 +7537,9 @@ const hf = ({
   const a = o ?? r;
   return e.kind === "grandTotal" ? Ff(e, a, n) : _f(e, t, a, n);
 }, Ff = (e, t, n) => ({ kind: "grandTotal", value: F({ valueFormat: e.valueFormat, locale: t, numberFormat: n })(e.value) }), _f = (e, t, n, r) => {
-  const o = F({ valueFormat: { type: "percentage" }, locale: n, numberFormat: r }), a = Nf(t, e.items.length > 1);
+  const o = F({ valueFormat: { type: "percentage" }, locale: n, numberFormat: r }), a = Pf(t, e.items.length > 1);
   return { kind: "perGroup", items: e.items.map((i) => {
-    const c = F({ valueFormat: i.valueFormat, locale: n, numberFormat: r }), l = F({ valueFormat: i.groupLabelFormat, locale: n, numberFormat: r }), u = kn({
+    const c = F({ valueFormat: i.valueFormat, locale: n, numberFormat: r }), l = F({ valueFormat: i.groupLabelFormat, locale: n, numberFormat: r }), u = Vn({
       valueFormat: i.mainValueFormat,
       locale: n,
       numberFormat: r,
@@ -7540,7 +7549,7 @@ const hf = ({
       swatch: i.swatch,
       label: `${a}${d}`,
       value: i.aggregate === null ? null : c(i.aggregate),
-      observationLabel: Pf(i.observationLabel, u),
+      observationLabel: Nf(i.observationLabel, u),
       comparison: Df(i.comparison, u, o)
     };
   }) };
@@ -7548,7 +7557,7 @@ const hf = ({
   direction: Rf(e.variation),
   percentage: n(Math.abs(e.variation)),
   reference: `from ${t(e.against)}`
-}, Rf = (e) => e > 0 ? "up" : e < 0 ? "down" : "flat", Pf = (e, t) => e === null ? null : e.kind === "point" ? t(e.value) : `${t(e.from)} – ${t(e.to)}`, Nf = (e, t) => {
+}, Rf = (e) => e > 0 ? "up" : e < 0 ? "down" : "flat", Nf = (e, t) => e === null ? null : e.kind === "point" ? t(e.value) : `${t(e.from)} – ${t(e.to)}`, Pf = (e, t) => {
   switch (e) {
     case "total":
       return "Total ";
@@ -7557,7 +7566,7 @@ const hf = ({
     default:
       return "";
   }
-}, Yy = ({
+}, Ky = ({
   legends: e,
   numberFormat: t,
   parsingLocale: n,
@@ -7575,10 +7584,10 @@ const hf = ({
 function Fn(e, t) {
   return e.axes.find((n) => n.scaleAestheticKey === t) ?? null;
 }
-function Hy(e, t) {
+function zy(e, t) {
   return e.legends.find((n) => n.aesthetics.includes(t)) ?? null;
 }
-const Ky = ({ guides: e, numberFormat: t, layer: n, locale: r }) => {
+const Xy = ({ guides: e, numberFormat: t, layer: n, locale: r }) => {
   const o = n.data.getFirst();
   if (!o) return null;
   const a = n.mapping.y !== void 0, i = (a ? el : Fo)(n.data, n.mapping)(o);
@@ -7599,7 +7608,7 @@ const Ky = ({ guides: e, numberFormat: t, layer: n, locale: r }) => {
   if (n <= 0) return "";
   const { startX: r, startY: o, endX: a, endY: s } = t, i = e === "start" ? r : a, c = e === "start" ? o : s, l = e === "start" ? Math.atan2(o - s, r - a) : Math.atan2(s - o, a - r), u = i - n * Math.cos(l - st), d = c - n * Math.sin(l - st), m = i - n * Math.cos(l + st), p = c - n * Math.sin(l + st);
   return `M ${i} ${c} L ${u} ${d} M ${i} ${c} L ${m} ${p}`;
-}, Yf = (e, t) => e === "solid" ? null : `${t * en} ${t * en * 2}`, Hf = (e, t) => t ? e * en : 0, Kf = 64, zy = ({
+}, Yf = (e, t) => e === "solid" ? null : `${t * en} ${t * en * 2}`, Hf = (e, t) => t ? e * en : 0, Kf = 64, jy = ({
   arrow: e,
   panelWidth: t,
   panelHeight: n
@@ -7870,7 +7879,7 @@ function lh(e, t) {
       b += 1;
       continue;
     }
-    const V = f?.[b] ?? null, E = c ? w : x;
+    const L = f?.[b] ?? null, E = c ? w : x;
     if (d) {
       const W = m?.[b], Ee = p?.[b];
       if (!h(W) || !h(Ee)) {
@@ -7887,14 +7896,14 @@ function lh(e, t) {
           y: q,
           stackMin: W,
           stackMax: Ee,
-          groupKey: V,
+          groupKey: L,
           observation: S
         }
       });
     } else
       y.push({
         main: E,
-        entry: { isStacked: d, pointIndex: b, x, y: w, groupKey: V, observation: S }
+        entry: { isStacked: d, pointIndex: b, x, y: w, groupKey: L, observation: S }
       });
     b += 1;
   }
@@ -8000,10 +8009,10 @@ function gh(e, t) {
       p++;
       continue;
     }
-    const w = c ? (S + x) / 2 : (y + b) / 2, V = u?.[p] ?? w;
+    const w = c ? (S + x) / 2 : (y + b) / 2, L = u?.[p] ?? w;
     m.push({
       mainMid: w,
-      bandCenter: V,
+      bandCenter: L,
       entry: {
         pointIndex: p,
         xMin: y,
@@ -8029,14 +8038,14 @@ function bh(e) {
     byKey: t
   };
 }
-function Pr(e, t, n) {
+function Nr(e, t, n) {
   switch (e.spatialMap.kind) {
     case "points":
       return dh(e, n);
     case "buckets":
-      return ch(e, Nr(t));
+      return ch(e, Pr(t));
     case "rects":
-      return yh(e, Nr(t));
+      return yh(e, Pr(t));
     case "arcs":
       return ah(e);
     case "polar-points":
@@ -8051,7 +8060,7 @@ function Pr(e, t, n) {
     }
   }
 }
-function Nr(e) {
+function Pr(e) {
   if (e.type !== "cartesian")
     throw new Error("buildLayerIndex: a bucket or rect hit-test requires a cartesian coord system");
   return e.mainAxis;
@@ -8143,11 +8152,11 @@ function Mh(e, t, n) {
     distance: Dn(i.x - t.x, i.y - t.y, n)
   };
 }
-function Lh(e, t, n) {
+function kh(e, t, n) {
   if (e.columns.length === 0) return null;
   const r = bt(e.mainAxis, t), o = jf(e, r), a = o?.rects ?? [];
   if (!o || !Hr(a)) return null;
-  const s = X(e.position) ? Vh(a, t, e.mainAxis) : kh(a, t, n);
+  const s = X(e.position) ? Lh(a, t, e.mainAxis) : Vh(a, t, n);
   return {
     hit: {
       layerId: e.layerId,
@@ -8164,17 +8173,17 @@ function Lh(e, t, n) {
     distance: xa(s, t, n)
   };
 }
-function Vh(e, t, n) {
+function Lh(e, t, n) {
   const r = In(n, t);
-  return Pn(e, (a) => Ih(a, n, r), { shortCircuitOnZero: !0 });
+  return Nn(e, (a) => Ih(a, n, r), { shortCircuitOnZero: !0 });
 }
-function kh(e, t, n) {
-  return Pn(e, (o) => xa(o, t, n));
+function Vh(e, t, n) {
+  return Nn(e, (o) => xa(o, t, n));
 }
 function Eh(e, t, n) {
-  return Pn(e, (o) => Math.abs(In(n, o) - t));
+  return Nn(e, (o) => Math.abs(In(n, o) - t));
 }
-function Pn(e, t, { shortCircuitOnZero: n = !1 } = {}) {
+function Nn(e, t, { shortCircuitOnZero: n = !1 } = {}) {
   let r = e[0], o = t(r);
   if (n && o === 0) return r;
   for (let a = 1; a < e.length; a += 1) {
@@ -8245,7 +8254,7 @@ function Rh({ layer: e, cursor: t, aspectRatio: n, warmStarts: r }) {
       return o ? { kind: "buckets", match: o } : null;
     }
     case "rects": {
-      const o = Lh(e, t, n);
+      const o = kh(e, t, n);
       return o ? { kind: "rects", match: o } : null;
     }
     case "points": {
@@ -8256,10 +8265,10 @@ function Rh({ layer: e, cursor: t, aspectRatio: n, warmStarts: r }) {
       return null;
   }
 }
-const be = { primary: null, group: [], related: /* @__PURE__ */ new Map() }, Ph = 1;
-class Xy {
+const be = { primary: null, group: [], related: /* @__PURE__ */ new Map() }, Nh = 1;
+class qy {
   constructor({ layers: t, coordSystem: n }) {
-    this.layerIndexes = [], this.layerRefs = [], this.aspectRatio = Ph, this.warmStarts = /* @__PURE__ */ new Map(), this.cachedState = be, this.cachedKey = null, this.nonInteractiveLayerIds = /* @__PURE__ */ new Set(), this.hitTesters = /* @__PURE__ */ new Map(), this.layerIndexes = t.map((r) => Pr(r, n, this.aspectRatio)), this.layerRefs = t.map((r) => Or(r, n)), this.nonInteractiveLayerIds = Br(t);
+    this.layerIndexes = [], this.layerRefs = [], this.aspectRatio = Nh, this.warmStarts = /* @__PURE__ */ new Map(), this.cachedState = be, this.cachedKey = null, this.nonInteractiveLayerIds = /* @__PURE__ */ new Set(), this.hitTesters = /* @__PURE__ */ new Map(), this.layerIndexes = t.map((r) => Nr(r, n, this.aspectRatio)), this.layerRefs = t.map((r) => Or(r, n)), this.nonInteractiveLayerIds = Br(t);
   }
   /**
    * Diff-aware re-index. Layers whose `data`, `geom`, `position` or the graph's coord-system
@@ -8280,11 +8289,11 @@ class Xy {
     const o = [], a = [];
     for (const s of t) {
       const i = r.get(s.id), c = Or(s, n);
-      if (i !== void 0 && Nh(i.ref, c)) {
+      if (i !== void 0 && Ph(i.ref, c)) {
         o.push(i.index), a.push(i.ref);
         continue;
       }
-      this.warmStarts.delete(s.id), o.push(Pr(s, n, this.aspectRatio)), a.push(c);
+      this.warmStarts.delete(s.id), o.push(Nr(s, n, this.aspectRatio)), a.push(c);
     }
     for (const s of this.warmStarts.keys())
       t.some((i) => i.id === s) || this.warmStarts.delete(s);
@@ -8369,7 +8378,7 @@ function Br(e) {
     n.interactive || t.add(n.id);
   return t;
 }
-function Nh(e, t) {
+function Ph(e, t) {
   return e.data === t.data && e.geom === t.geom && e.position === t.position && e.coord === t.coord;
 }
 const Oh = ({
@@ -8442,7 +8451,7 @@ const Oh = ({
       throw new Error(`Unhandled value format: ${n.type}`);
     }
   }
-}, $h = { type: "decimal" }, jy = ({
+}, $h = { type: "decimal" }, Qy = ({
   layers: e,
   coordSystem: t,
   scales: n,
@@ -8544,9 +8553,9 @@ function Hh(e, t, n, r) {
   if (n === null || t.mapping.color === void 0) return e;
   const o = /* @__PURE__ */ new Map();
   return n.domain.forEach((a, s) => {
-    o.set(L(a), s);
+    o.set(k(a), s);
   }), e.map((a, s) => {
-    const i = r(a.observation), c = i === null ? null : L(i), l = c === null ? Number.POSITIVE_INFINITY : o.get(c) ?? Number.POSITIVE_INFINITY;
+    const i = r(a.observation), c = i === null ? null : k(i), l = c === null ? Number.POSITIVE_INFINITY : o.get(c) ?? Number.POSITIVE_INFINITY;
     return { hit: a, originalIndex: s, rank: l };
   }).sort(
     (a, s) => a.rank === s.rank ? a.originalIndex - s.originalIndex : a.rank - s.rank
@@ -8555,7 +8564,7 @@ function Hh(e, t, n, r) {
 function Kh({ guides: e, locale: t, numberFormat: n }) {
   const r = new Map(
     e.colorGroups.map((a) => [
-      L(a.value),
+      k(a.value),
       {
         label: a.label,
         format: vt({ valueFormat: a.valueFormat, locale: t, numberFormat: n })
@@ -8563,7 +8572,7 @@ function Kh({ guides: e, locale: t, numberFormat: n }) {
     ])
   ), o = vt({ valueFormat: { type: "text" }, locale: t, numberFormat: n });
   return (a) => {
-    const s = r.get(L(a));
+    const s = r.get(k(a));
     return s === void 0 ? o(a) : s.label ?? s.format(a);
   };
 }
@@ -8577,7 +8586,36 @@ function Xh(e) {
 function jh(e, t) {
   return e(t.observation).encodings.find((r) => r.aesthetic === "y")?.value ?? null;
 }
-const qy = {
+const qh = {
+  /** A labelled delta between two data observations — the only built-in kind that snaps to data. */
+  differenceArrow(e) {
+    return { type: "annotation", kind: "differenceArrow", annotation: e };
+  },
+  /** A shaded box positioned in panel fractions (`[0,1]`); does not snap to a data value. */
+  shape(e) {
+    return { type: "annotation", kind: "shape", annotation: e };
+  },
+  /** A free-standing arrow with endpoints in panel fractions (`[0,1]`); does not snap to a data value. */
+  freeformArrow(e) {
+    return { type: "annotation", kind: "freeformArrow", annotation: e };
+  },
+  /** A free-standing rich-text label positioned in panel fractions (`[0,1]`); does not snap to a data value. */
+  text(e) {
+    return { type: "annotation", kind: "text", annotation: e };
+  },
+  /** Editor-only: compiles but has NO painter in `@graphysdk/react-renderer`. */
+  sticker(e) {
+    return { type: "annotation", kind: "sticker", annotation: e };
+  },
+  /** Editor-only: compiles but has NO painter in `@graphysdk/react-renderer`. */
+  pinnedNumber(e) {
+    return { type: "annotation", kind: "pinnedNumber", annotation: e };
+  },
+  /** Editor-only: compiles but has NO painter in `@graphysdk/react-renderer`. */
+  comment(e) {
+    return { type: "annotation", kind: "comment", annotation: e };
+  }
+}, Zy = {
   lilac: "linear-gradient(94deg, #C9C0F7 -2.94%, #F6E6FD 92.51%)",
   neon_pink: "linear-gradient(93deg, #E04A95 2.61%, #FD7F92 97.51%)",
   blackberry: "linear-gradient(132deg, #9F9FED 2.98%, #B9E6FF 97.65%)",
@@ -8591,10 +8629,10 @@ const qy = {
   cool: "linear-gradient(93.55deg, #3F8EEB -6.07%, #58C8D8 113.6%)",
   fresh: "linear-gradient(114.37deg, #A4A4EE 4.32%, #58C8D8 87.71%)"
 };
-function qh(...e) {
+function Qh(...e) {
   let t = {}, n;
   const [r, ...o] = e;
-  h(r) && !Qh(r) ? (t = r, n = o) : n = e;
+  h(r) && !Zh(r) ? (t = r, n = o) : n = e;
   const a = {
     mapping: t,
     layers: [],
@@ -8605,10 +8643,10 @@ function qh(...e) {
   };
   return n.reduce((s, i) => Sa(s, i), a);
 }
-function Qy(e, ...t) {
+function Jy(e, ...t) {
   return t.reduce((n, r) => Sa(n, r), e);
 }
-function Qh(e) {
+function Zh(e) {
   return typeof e == "object" && e !== null && "type" in e;
 }
 function Sa(e, t) {
@@ -8628,20 +8666,48 @@ function Sa(e, t) {
     case "highlight":
       return { ...e, highlights: [...e.highlights, t] };
     case "annotation":
-      return {
-        ...e,
-        annotations: {
-          ...e.annotations,
-          custom: [...e.annotations?.custom ?? [], t.annotation]
-        }
-      };
+      return Jh(e, t);
     default: {
       const n = t;
       throw new Error(`Unknown spec item type: ${n.type}`);
     }
   }
 }
-function Zy(e) {
+function Jh(e, t) {
+  const n = { ...e.annotations };
+  switch (t.kind) {
+    case "differenceArrow":
+      n.differenceArrows = [...n.differenceArrows ?? [], t.annotation];
+      break;
+    case "shape":
+      n.shapes = [...n.shapes ?? [], t.annotation];
+      break;
+    case "freeformArrow":
+      n.freeformArrows = [...n.freeformArrows ?? [], t.annotation];
+      break;
+    case "text":
+      n.textAnnotations = [...n.textAnnotations ?? [], t.annotation];
+      break;
+    case "sticker":
+      n.stickers = [...n.stickers ?? [], t.annotation];
+      break;
+    case "pinnedNumber":
+      n.pinnedNumbers = [...n.pinnedNumbers ?? [], t.annotation];
+      break;
+    case "comment":
+      n.comments = [...n.comments ?? [], t.annotation];
+      break;
+    case "custom":
+      n.custom = [...n.custom ?? [], t.annotation];
+      break;
+    default: {
+      const r = t;
+      throw new Error(`Unknown annotation kind: ${r.kind}`);
+    }
+  }
+  return { ...e, annotations: n };
+}
+function eg(e) {
   const t = {};
   for (const r of e.geoms ?? []) {
     const o = r;
@@ -8661,8 +8727,9 @@ function Zy(e) {
   const n = {};
   for (const r of e.annotations ?? []) {
     const o = r;
-    n[o.type] = (a) => (Zh(o, a.coordinates), {
+    n[o.type] = (a) => (ey(o, a.coordinates), {
       type: "annotation",
+      kind: "custom",
       annotation: {
         id: a.id,
         type: o.type,
@@ -8674,11 +8741,11 @@ function Zy(e) {
   }
   return {
     geom: { ...C, ...t },
-    annotation: n,
-    createSpec: qh
+    annotation: { ...qh, ...n },
+    createSpec: Qh
   };
 }
-function Zh(e, t) {
+function ey(e, t) {
   const n = e.coordinates;
   if (n !== void 0) {
     if (n.min !== void 0 && t.length < n.min)
@@ -8689,7 +8756,7 @@ function Zh(e, t) {
       throw new Error(`Annotation '${e.type}' accepts at most ${n.max} coordinate(s), got ${t.length}.`);
   }
 }
-function Jy(e, t = {}) {
+function tg(e, t = {}) {
   return {
     type: "highlight",
     id: t.id,
@@ -8698,18 +8765,18 @@ function Jy(e, t = {}) {
     layerIndex: t.layerIndex
   };
 }
-function eg(e) {
+function ng(e) {
   return {
     mapping: e.mapping,
     layers: e.layers,
-    scales: e.scales.map(ey),
+    scales: e.scales.map(ny),
     transforms: e.transforms,
-    highlights: e.highlights.map((t) => Jh(t, e.layers)),
+    highlights: e.highlights.map((t) => ty(t, e.layers)),
     coords: e.coords,
     config: e.config
   };
 }
-function Jh(e, t) {
+function ty(e, t) {
   const n = e.layerId ? t.findIndex((r) => r.id === e.layerId) : -1;
   return {
     type: "highlight",
@@ -8719,19 +8786,19 @@ function Jh(e, t) {
     layerIndex: n >= 0 ? n : void 0
   };
 }
-function ey(e) {
-  return e.scaleType === "palette" ? ty(e) : e;
+function ny(e) {
+  return e.scaleType === "palette" ? ry(e) : e;
 }
-function ty(e) {
+function ry(e) {
   return {
     ...e,
-    palette: ny(e.palette)
+    palette: oy(e.palette)
   };
 }
-function ny(e) {
+function oy(e) {
   return e.type === "custom" ? { type: "custom", id: e.id } : e;
 }
-class tg {
+class rg {
   constructor(t = {}) {
     this.undoStack = [], this.redoStack = [], this.listeners = /* @__PURE__ */ new Set(), this.isEmitting = !1, this.cachedSnapshot = null, this.maxHistorySize = t.maxHistorySize ?? 100;
   }
@@ -8890,7 +8957,7 @@ class Ma {
     return { spec: r, revert: o };
   }
 }
-class La {
+class ka {
   constructor(t, n = {}) {
     this.type = "set-headline-show", this.params = t, this.metadata = me({
       ...n,
@@ -8900,11 +8967,11 @@ class La {
   apply(t) {
     const n = t.config.headline.show, r = We(t, {
       config: { headline: { show: this.params.show } }
-    }), o = new La({ show: n }, this.metadata);
+    }), o = new ka({ show: n }, this.metadata);
     return { spec: r, revert: o };
   }
 }
-class Va {
+class La {
   constructor(t, n = {}) {
     this.type = "set-line-width", this.params = t, this.metadata = me({
       ...n,
@@ -8918,30 +8985,30 @@ class Va {
     const r = n.params.lineWidth, o = Zd(t, n.id, {
       ...n,
       params: { ...n.params, lineWidth: this.params.lineWidth }
-    }), a = new Va({ layerId: n.id, lineWidth: r }, this.metadata);
+    }), a = new La({ layerId: n.id, lineWidth: r }, this.metadata);
     return { spec: o, revert: a };
   }
 }
-function ry(e, t) {
+function ay(e, t) {
   return e.scales.find((n) => n.scaledAesthetic === t);
 }
-function oy(e, t, n) {
+function sy(e, t, n) {
   const r = e.scales.map((o) => o.scaledAesthetic === t ? n : o);
   return { ...e, scales: r };
 }
-function ay(e) {
+function iy(e) {
   const t = e.replace(/([A-Z])/g, " $1").toLowerCase();
   return t.charAt(0).toUpperCase() + t.slice(1);
 }
-class ka {
+class Va {
   constructor(t, n = {}) {
     this.type = "set-scale-domain", this.params = t, this.metadata = me({
       ...n,
-      description: `Set ${ay(t.scaledAesthetic)} scale domain`
+      description: `Set ${iy(t.scaledAesthetic)} scale domain`
     });
   }
   apply(t) {
-    const n = ry(t, this.params.scaledAesthetic);
+    const n = ay(t, this.params.scaledAesthetic);
     if (!n || n.scaleType !== "continuous" && n.scaleType !== "datetime")
       return null;
     const r = {
@@ -8951,9 +9018,9 @@ class ka {
       ...n,
       ...this.params.domainMin !== void 0 && { domainMin: this.params.domainMin },
       ...this.params.domainMax !== void 0 && { domainMax: this.params.domainMax }
-    }, a = oy(t, this.params.scaledAesthetic, o), s = { scaledAesthetic: this.params.scaledAesthetic };
+    }, a = sy(t, this.params.scaledAesthetic, o), s = { scaledAesthetic: this.params.scaledAesthetic };
     this.params.domainMin !== void 0 && (s.domainMin = r.min), this.params.domainMax !== void 0 && (s.domainMax = r.max);
-    const i = new ka(s, this.metadata);
+    const i = new Va(s, this.metadata);
     return { spec: a, revert: i };
   }
 }
@@ -8975,11 +9042,11 @@ const Ea = 500, Ia = "normal", Ca = {
   heavy: 900,
   extraBlack: 950,
   ultraBlack: 950
-}, ng = (e) => {
+}, og = (e) => {
   const t = e.style ?? Ia, n = e.weight ?? Ea, r = e.family.includes(",") ? e.family : `'${e.family}'`;
   return `${t} ${n} ${e.size}px ${r}`;
-}, rg = (e) => typeof e == "string" ? e : Fa(e), Fa = (e) => e.text !== void 0 ? e.text : e.content ? e.content.map(Fa).join("") : "", _a = (e) => typeof e != "string" ? e ?? Ea : Ca[e], sy = "\0";
-class og {
+}, ag = (e) => typeof e == "string" ? e : Fa(e), Fa = (e) => e.text !== void 0 ? e.text : e.content ? e.content.map(Fa).join("") : "", _a = (e) => typeof e != "string" ? e ?? Ea : Ca[e], cy = "\0";
+class sg {
   constructor(t) {
     this.inner = t, this.cache = /* @__PURE__ */ new Map();
   }
@@ -8991,10 +9058,10 @@ class og {
     return this.cache.set(r, a), a;
   }
   getCacheKey(t, n) {
-    return [n.family, n.size, _a(n.weight), n.style ?? Ia, t].join(sy);
+    return [n.family, n.size, _a(n.weight), n.style ?? Ia, t].join(cy);
   }
 }
-const iy = {
+const ly = {
   " ": 0.25,
   "!": 0.27,
   '"': 0.36,
@@ -9090,14 +9157,14 @@ const iy = {
   "|": 0.26,
   "}": 0.33,
   "~": 0.56
-}, cy = 0.55, ly = 1.05, uy = 0.84, dy = 0.21;
-class ag {
+}, uy = 0.55, dy = 1.05, my = 0.84, py = 0.21;
+class ig {
   measureText(t, n) {
     let r = 0;
     for (const i of t)
-      r += (iy[i] ?? cy) * n.size;
-    _a(n.weight) >= Ca.semiBold && (r *= ly);
-    const a = uy * n.size, s = dy * n.size;
+      r += (ly[i] ?? uy) * n.size;
+    _a(n.weight) >= Ca.semiBold && (r *= dy);
+    const a = my * n.size, s = py * n.size;
     return {
       width: r,
       height: a + s,
@@ -9106,15 +9173,15 @@ class ag {
     };
   }
 }
-function sg(e, t, n) {
+function cg(e, t, n) {
   const r = e[t];
   return typeof r == "number" ? r : n ?? null;
 }
-function ig(e, t, n) {
+function lg(e, t, n) {
   const r = e[t];
   return typeof r == "string" ? r : n ?? null;
 }
-class my {
+class fy {
   constructor() {
     this.columnTypes = /* @__PURE__ */ new Map(), this.kindColumns = /* @__PURE__ */ new Map(), this.rows = [];
   }
@@ -9162,27 +9229,27 @@ class my {
     return new M(r);
   }
 }
-function cg() {
-  return new my();
+function ug() {
+  return new fy();
 }
-function lg(e) {
+function dg(e) {
   return {
     type: e.type,
     defaultParams: e.defaultParams ?? {},
     coordinates: e.coordinates
   };
 }
-function ug(e, t, n, r, o) {
+function mg(e, t, n, r, o) {
   const a = n - t;
   return a === 0 ? r : r + (e - t) / a * (o - r);
 }
 export {
-  ku as BORDER_PRESETS,
-  qy as BORDER_PRESET_GRADIENTS,
-  Lc as BUILTIN_GEOM_NAMES,
-  _y as COMPILER_STAGE_KEYS,
-  og as CachedTextMeasurer,
-  tg as CommandStackManager,
+  Vu as BORDER_PRESETS,
+  Zy as BORDER_PRESET_GRADIENTS,
+  kc as BUILTIN_GEOM_NAMES,
+  Ry as COMPILER_STAGE_KEYS,
+  sg as CachedTextMeasurer,
+  rg as CommandStackManager,
   Rm as Compiler,
   Oo as DEFAULT_COLOR_PALETTE,
   Ia as DEFAULT_FONT_STYLE,
@@ -9192,10 +9259,10 @@ export {
   Mc as GEOM_NAMES,
   D as GROUP_VARIABLES,
   Xe as Geom,
-  ag as HeuristicTextMeasurer,
-  Xy as HoverEngine,
+  ig as HeuristicTextMeasurer,
+  qy as HoverEngine,
   Ap as LAYOUT_PADDING,
-  Ny as LayoutCompiler,
+  By as LayoutCompiler,
   Kl as MONO_BASES,
   zl as NEON_BASES,
   g as POSITION_VARIABLES,
@@ -9204,49 +9271,50 @@ export {
   Aa as SetContentCaptionCommand,
   Ta as SetContentSubtitleCommand,
   Ma as SetContentTitleCommand,
-  La as SetHeadlineShowCommand,
-  Va as SetLineWidthCommand,
-  ka as SetScaleDomainCommand,
+  ka as SetHeadlineShowCommand,
+  La as SetLineWidthCommand,
+  Va as SetScaleDomainCommand,
   sm as SpecResolver,
   de as VISUAL_VARIABLES,
-  Oy as buildAverageLineSymbols,
-  $y as buildDataLabelsContent,
-  ng as buildFontString,
+  qh as annotation,
+  $y as buildAverageLineSymbols,
+  Uy as buildDataLabelsContent,
+  og as buildFontString,
   ff as buildLayerYValueFormatter,
-  jy as buildTooltipContent,
-  Gy as computeDifferenceArrow,
-  Uy as computeDirectLabelsLayout,
-  zy as computeFreeformArrow,
+  Qy as buildTooltipContent,
+  Wy as computeDifferenceArrow,
+  Yy as computeDirectLabelsLayout,
+  jy as computeFreeformArrow,
   Eu as config,
-  eg as convertSpecToInput,
+  ng as convertSpecToInput,
   O as coord,
-  Iy as createAlphaValueReader,
+  Fy as createAlphaValueReader,
   tl as createColorValueReader,
-  Dy as createCompiler,
+  Ny as createCompiler,
   al as createEmptyHighlight,
-  Zy as createGraphyBuilder,
-  Cy as createGroupValueReader,
-  ky as createLabelValueReader,
-  cg as createMarkTable,
+  eg as createGraphyBuilder,
+  _y as createGroupValueReader,
+  Iy as createLabelValueReader,
+  ug as createMarkTable,
   j as createRawValueReader,
   _o as createSegmentYReader,
-  Ey as createSizeValueReader,
-  qh as createSpec,
-  Fy as createStrokeWidthValueReader,
+  Cy as createSizeValueReader,
+  Qh as createSpec,
+  Dy as createStrokeWidthValueReader,
   F as createValueFormatter,
   Fo as createXValueReader,
   el as createYValueReader,
-  lg as defineAnnotation,
+  dg as defineAnnotation,
   te as extractConstantValue,
-  rg as extractPlainText,
+  ag as extractPlainText,
   v as extractVariableName,
   Fn as findAxisGuide,
-  Hy as findLegendForAesthetic,
-  Wy as formatHeadline,
-  Yy as formatLegends,
-  Ky as formatRuleValue,
+  zy as findLegendForAesthetic,
+  Hy as formatHeadline,
+  Ky as formatLegends,
+  Xy as formatRuleValue,
   C as geom,
-  Ly as getAlpha,
+  Vy as getAlpha,
   af as getAngleExtent,
   Zr as getColor,
   In as getCrossAxisCoordinate,
@@ -9257,7 +9325,7 @@ export {
   bt as getMainAxisCoordinate,
   sf as getRadiusExtent,
   fs as getSize,
-  Vy as getStrokeWidth,
+  Ey as getStrokeWidth,
   je as getX,
   Oe as getXMax,
   ft as getXMin,
@@ -9265,26 +9333,26 @@ export {
   J as getYMax,
   Se as getYMin,
   Fi as getYRaw,
-  Jy as highlight,
-  ug as interpolateInScaledInterval,
-  Vc as isBuiltinGeomName,
-  By as isCartesian,
-  Ty as isCompilerCachingEnabled,
+  tg as highlight,
+  mg as interpolateInScaledInterval,
+  Lc as isBuiltinGeomName,
+  Gy as isCartesian,
+  ky as isCompilerCachingEnabled,
   h as isDefined,
   au as isGraphConfig,
-  Ry as isLayerOf,
+  Py as isLayerOf,
   X as isStackedPosition,
-  My as mapping,
-  Qy as pipe,
+  Ly as mapping,
+  Jy as pipe,
   A as prefixInternalVariable,
   jr as readAesthetic,
-  sg as readNumber,
-  ig as readString,
-  Py as resolveHeadlinePlacement,
+  cg as readNumber,
+  lg as readString,
+  Oy as resolveHeadlinePlacement,
   Mt as resolveSegmentYSource,
   Tt as resolveYScaleAesthetic,
   xe as scale,
-  Ay as setCompilerCachingEnabled,
+  My as setCompilerCachingEnabled,
   sn as sortByXIfContinuous,
   Bo as stat,
   ve as transform,