@opendata-ai/openchart-engine 6.5.1 → 6.6.0

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/compile.ts
 import {
-  adaptTheme as adaptTheme2,
+  adaptTheme as adaptTheme3,
   BRAND_RESERVE_WIDTH as BRAND_RESERVE_WIDTH2,
   computeLabelBounds,
   generateAltText,
@@ -8,7 +8,7 @@ import {
   getBreakpoint,
   getHeightClass,
   getLayoutStrategy,
-  resolveTheme as resolveTheme2
+  resolveTheme as resolveTheme3
 } from "@opendata-ai/openchart-core";
 
 // src/annotations/compute.ts
@@ -44,23 +44,23 @@ function interpolateInDomain(numValue, domain, positionOf) {
   const t = (numValue - sorted[lower].n) / (sorted[upper].n - sorted[lower].n);
   return lowerPos + t * (upperPos - lowerPos);
 }
-function resolvePosition(value, scale) {
+function resolvePosition(value2, scale) {
   if (!scale) return null;
   const s = scale.scale;
   const type = scale.type;
   if (type === "time") {
-    const date2 = new Date(String(value));
+    const date2 = new Date(String(value2));
     if (Number.isNaN(date2.getTime())) return null;
     return s(date2);
   }
   if (type === "linear" || type === "log") {
-    const num = typeof value === "number" ? value : Number(value);
+    const num = typeof value2 === "number" ? value2 : Number(value2);
     if (!Number.isFinite(num)) return null;
     return s(num);
   }
   if (type === "band") {
     const bandScale = s;
-    const strValue2 = String(value);
+    const strValue2 = String(value2);
     const pos = bandScale(strValue2);
     if (pos !== void 0) return pos + (bandScale.bandwidth?.() ?? 0) / 2;
     const bw = bandScale.bandwidth?.() ?? 0;
@@ -70,7 +70,7 @@ function resolvePosition(value, scale) {
       (entry) => (bandScale(entry) ?? 0) + bw / 2
     );
   }
-  const strValue = String(value);
+  const strValue = String(value2);
   const directResult = s(strValue);
   if (directResult !== void 0) return directResult;
   if (type === "point" || type === "ordinal") {
@@ -393,12 +393,6 @@ function nudgeAnnotationFromObstacles(annotation, originalAnnotation, scales, ch
     const labelCenterY = candidateBounds.y + candidateBounds.height / 2;
     const inBounds = labelCenterX >= chartArea.x && labelCenterX <= chartArea.x + chartArea.width + 10 && labelCenterY >= chartArea.y - fontSize && labelCenterY <= chartArea.y + chartArea.height + fontSize * 3;
     if (inBounds) {
-      if (candidateLabel.connector && dx === 0 && dy !== 0) {
-        candidateLabel.connector = {
-          ...candidateLabel.connector,
-          style: "caret"
-        };
-      }
       annotation.label = candidateLabel;
       return true;
     }
@@ -561,15 +555,15 @@ function isFieldPredicate(pred) {
   return "field" in pred;
 }
 function evaluateFieldPredicate(datum, pred) {
-  const value = datum[pred.field];
+  const value2 = datum[pred.field];
   if (pred.valid !== void 0) {
-    const isValid = value !== null && value !== void 0 && !Number.isNaN(value);
+    const isValid = value2 !== null && value2 !== void 0 && !Number.isNaN(value2);
     return pred.valid ? isValid : !isValid;
   }
   if (pred.equal !== void 0) {
-    return value === pred.equal;
+    return value2 === pred.equal;
   }
-  const numValue = Number(value);
+  const numValue = Number(value2);
   if (pred.lt !== void 0) {
     return numValue < pred.lt;
   }
@@ -583,11 +577,11 @@ function evaluateFieldPredicate(datum, pred) {
     return numValue >= pred.gte;
   }
   if (pred.range !== void 0) {
-    const [min3, max3] = pred.range;
-    return numValue >= min3 && numValue <= max3;
+    const [min4, max4] = pred.range;
+    return numValue >= min4 && numValue <= max4;
   }
   if (pred.oneOf !== void 0) {
-    return pred.oneOf.includes(value);
+    return pred.oneOf.includes(value2);
   }
   return true;
 }
@@ -626,18 +620,18 @@ function isConditionalValueDef(def) {
 
 // src/charts/utils.ts
 var DEFAULT_COLOR = "#1b7fa3";
-function scaleValue(scale, scaleType, value) {
-  if (value == null) return null;
+function scaleValue(scale, scaleType, value2) {
+  if (value2 == null) return null;
   if (scaleType === "time" || scaleType === "utc") {
-    const date2 = value instanceof Date ? value : new Date(String(value));
+    const date2 = value2 instanceof Date ? value2 : new Date(String(value2));
     if (Number.isNaN(date2.getTime())) return null;
     return scale(date2);
   }
   if (scaleType === "point" || scaleType === "band" || scaleType === "ordinal") {
-    const result = scale(String(value));
+    const result = scale(String(value2));
     return result ?? null;
   }
-  const num = typeof value === "number" ? value : Number(value);
+  const num = typeof value2 === "number" ? value2 : Number(value2);
   if (!Number.isFinite(num)) return null;
   return scale(num);
 }
@@ -689,19 +683,19 @@ function getColor(scales, key, _index, fallback = DEFAULT_COLOR) {
   }
   return scales.defaultColor ?? fallback;
 }
-function getSequentialColor(scales, value, fallback = DEFAULT_COLOR) {
+function getSequentialColor(scales, value2, fallback = DEFAULT_COLOR) {
   if (scales.color?.type === "sequential") {
     const colorScale = scales.color.scale;
-    return colorScale(value);
+    return colorScale(value2);
   }
   return scales.defaultColor ?? fallback;
 }
 
 // src/charts/bar/compute.ts
 var MIN_BAR_WIDTH = 1;
-function formatBarValue(value) {
-  if (Math.abs(value) >= 1e3) return abbreviateNumber(value);
-  return formatNumber(value);
+function formatBarValue(value2) {
+  if (Math.abs(value2) >= 1e3) return abbreviateNumber(value2);
+  return formatNumber(value2);
 }
 function computeBarMarks(spec, scales, _chartArea, _strategy) {
   const encoding = spec.encoding;
@@ -756,14 +750,14 @@ function computeStackedBars(data, valueField, categoryField, colorField, xScale,
     let cumulativeValue = 0;
     for (const row of rows) {
       const groupKey = String(row[colorField] ?? "");
-      const value = Number(row[valueField] ?? 0);
-      if (!Number.isFinite(value) || value <= 0) continue;
+      const value2 = Number(row[valueField] ?? 0);
+      if (!Number.isFinite(value2) || value2 <= 0) continue;
       const color2 = getColor(scales, groupKey);
       const xLeft = xScale(cumulativeValue);
-      const xRight = xScale(cumulativeValue + value);
+      const xRight = xScale(cumulativeValue + value2);
       const barWidth = Math.max(Math.abs(xRight - xLeft), MIN_BAR_WIDTH);
       const aria = {
-        label: `${category}, ${groupKey}: ${formatBarValue(value)}`
+        label: `${category}, ${groupKey}: ${formatBarValue(value2)}`
       };
       marks.push({
         type: "rect",
@@ -778,7 +772,7 @@ function computeStackedBars(data, valueField, categoryField, colorField, xScale,
         orient: "horizontal",
         stackGroup: category
       });
-      cumulativeValue += value;
+      cumulativeValue += value2;
     }
   }
   return marks;
@@ -787,8 +781,8 @@ function computeSimpleBars(data, valueField, categoryField, xScale, yScale, band
   const marks = [];
   for (const row of data) {
     const category = String(row[categoryField] ?? "");
-    const value = Number(row[valueField] ?? 0);
-    if (!Number.isFinite(value)) continue;
+    const value2 = Number(row[valueField] ?? 0);
+    if (!Number.isFinite(value2)) continue;
     const bandY = yScale(category);
     if (bandY === void 0) continue;
     let color2;
@@ -797,14 +791,14 @@ function computeSimpleBars(data, valueField, categoryField, xScale, yScale, band
         resolveConditionalValue(row, conditionalColor) ?? getColor(scales, "__default__")
       );
     } else if (sequentialColor) {
-      color2 = getSequentialColor(scales, value);
+      color2 = getSequentialColor(scales, value2);
     } else {
       color2 = getColor(scales, "__default__");
     }
-    const xPos = value >= 0 ? baseline : xScale(value);
-    const barWidth = Math.max(Math.abs(xScale(value) - baseline), MIN_BAR_WIDTH);
+    const xPos = value2 >= 0 ? baseline : xScale(value2);
+    const barWidth = Math.max(Math.abs(xScale(value2) - baseline), MIN_BAR_WIDTH);
     const aria = {
-      label: `${category}: ${formatBarValue(value)}`
+      label: `${category}: ${formatBarValue(value2)}`
     };
     marks.push({
       type: "rect",
@@ -958,9 +952,9 @@ var barRenderer = (spec, scales, chartArea, strategy, _theme) => {
 // src/charts/column/compute.ts
 import { abbreviateNumber as abbreviateNumber2, formatNumber as formatNumber2 } from "@opendata-ai/openchart-core";
 var MIN_COLUMN_HEIGHT = 1;
-function formatColumnValue(value) {
-  if (Math.abs(value) >= 1e3) return abbreviateNumber2(value);
-  return formatNumber2(value);
+function formatColumnValue(value2) {
+  if (Math.abs(value2) >= 1e3) return abbreviateNumber2(value2);
+  return formatNumber2(value2);
 }
 function computeColumnMarks(spec, scales, _chartArea, _strategy) {
   const encoding = spec.encoding;
@@ -1025,8 +1019,8 @@ function computeSimpleColumns(data, categoryField, valueField, xScale, yScale, b
   const marks = [];
   for (const row of data) {
     const category = String(row[categoryField] ?? "");
-    const value = Number(row[valueField] ?? 0);
-    if (!Number.isFinite(value)) continue;
+    const value2 = Number(row[valueField] ?? 0);
+    if (!Number.isFinite(value2)) continue;
     const bandX = xScale(category);
     if (bandX === void 0) continue;
     let color2;
@@ -1035,15 +1029,15 @@ function computeSimpleColumns(data, categoryField, valueField, xScale, yScale, b
         resolveConditionalValue(row, conditionalColor) ?? getColor(scales, "__default__")
       );
     } else if (sequentialColor) {
-      color2 = getSequentialColor(scales, value);
+      color2 = getSequentialColor(scales, value2);
     } else {
       color2 = getColor(scales, "__default__");
     }
-    const yPos = yScale(value);
+    const yPos = yScale(value2);
     const columnHeight = Math.max(Math.abs(baseline - yPos), MIN_COLUMN_HEIGHT);
-    const y2 = value >= 0 ? yPos : baseline;
+    const y2 = value2 >= 0 ? yPos : baseline;
     const aria = {
-      label: `${category}: ${formatColumnValue(value)}`
+      label: `${category}: ${formatColumnValue(value2)}`
     };
     marks.push({
       type: "rect",
@@ -1064,17 +1058,17 @@ function computeColoredColumns(data, categoryField, valueField, colorField, xSca
   const marks = [];
   for (const row of data) {
     const category = String(row[categoryField] ?? "");
-    const value = Number(row[valueField] ?? 0);
-    if (!Number.isFinite(value)) continue;
+    const value2 = Number(row[valueField] ?? 0);
+    if (!Number.isFinite(value2)) continue;
     const bandX = xScale(category);
     if (bandX === void 0) continue;
     const groupKey = String(row[colorField] ?? "");
     const color2 = getColor(scales, groupKey);
-    const yPos = yScale(value);
+    const yPos = yScale(value2);
     const columnHeight = Math.max(Math.abs(baseline - yPos), MIN_COLUMN_HEIGHT);
-    const y2 = value >= 0 ? yPos : baseline;
+    const y2 = value2 >= 0 ? yPos : baseline;
     const aria = {
-      label: `${category}, ${groupKey}: ${formatColumnValue(value)}`
+      label: `${category}, ${groupKey}: ${formatColumnValue(value2)}`
     };
     marks.push({
       type: "rect",
@@ -1100,14 +1094,14 @@ function computeStackedColumns(data, categoryField, valueField, colorField, xSca
     let cumulativeValue = 0;
     for (const row of rows) {
       const groupKey = String(row[colorField] ?? "");
-      const value = Number(row[valueField] ?? 0);
-      if (!Number.isFinite(value) || value <= 0) continue;
+      const value2 = Number(row[valueField] ?? 0);
+      if (!Number.isFinite(value2) || value2 <= 0) continue;
       const color2 = getColor(scales, groupKey);
-      const yTop = yScale(cumulativeValue + value);
+      const yTop = yScale(cumulativeValue + value2);
       const yBottom = yScale(cumulativeValue);
       const columnHeight = Math.max(Math.abs(yBottom - yTop), MIN_COLUMN_HEIGHT);
       const aria = {
-        label: `${category}, ${groupKey}: ${formatColumnValue(value)}`
+        label: `${category}, ${groupKey}: ${formatColumnValue(value2)}`
       };
       marks.push({
         type: "rect",
@@ -1122,7 +1116,7 @@ function computeStackedColumns(data, categoryField, valueField, colorField, xSca
         orient: "vertical",
         stackGroup: category
       });
-      cumulativeValue += value;
+      cumulativeValue += value2;
     }
   }
   return marks;
@@ -1253,8 +1247,8 @@ function computeDumbbellMarks(data, valueField, categoryField, colorField, xScal
     const cy = bandY + bandwidth / 2;
     const xValues = [];
     for (const row of rows) {
-      const value = Number(row[valueField] ?? 0);
-      if (Number.isFinite(value)) xValues.push(value);
+      const value2 = Number(row[valueField] ?? 0);
+      if (Number.isFinite(value2)) xValues.push(value2);
     }
     if (xValues.length === 0) continue;
     const minVal = Math.min(...xValues);
@@ -1278,13 +1272,13 @@ function computeDumbbellMarks(data, valueField, categoryField, colorField, xScal
       });
     }
     for (const row of rows) {
-      const value = Number(row[valueField] ?? 0);
-      if (!Number.isFinite(value)) continue;
-      const cx = xScale(value);
+      const value2 = Number(row[valueField] ?? 0);
+      if (!Number.isFinite(value2)) continue;
+      const cx = xScale(value2);
       const colorCategory = String(row[colorField] ?? "");
       const color2 = getColor(scales, colorCategory);
       const dotAria = {
-        label: `${category}, ${colorCategory}: ${value}`
+        label: `${category}, ${colorCategory}: ${value2}`
       };
       marks.push({
         type: "point",
@@ -1305,13 +1299,13 @@ function computeLollipopMarks(data, valueField, categoryField, xScale, yScale, b
   const marks = [];
   for (const row of data) {
     const category = String(row[categoryField] ?? "");
-    const value = Number(row[valueField] ?? 0);
-    if (!Number.isFinite(value)) continue;
+    const value2 = Number(row[valueField] ?? 0);
+    if (!Number.isFinite(value2)) continue;
     const bandY = yScale(category);
     if (bandY === void 0) continue;
-    const cx = xScale(value);
+    const cx = xScale(value2);
     const cy = bandY + bandwidth / 2;
-    const color2 = isSequentialColor ? getSequentialColor(scales, value) : getColor(scales, "__default__");
+    const color2 = isSequentialColor ? getSequentialColor(scales, value2) : getColor(scales, "__default__");
     const stemX = Math.min(baseline, cx);
     const stemWidth = Math.abs(cx - baseline);
     if (stemWidth > 0) {
@@ -1330,7 +1324,7 @@ function computeLollipopMarks(data, valueField, categoryField, xScale, yScale, b
       });
     }
     const dotAria = {
-      label: `${category}: ${value}`
+      label: `${category}: ${value2}`
     };
     marks.push({
       type: "point",
@@ -1411,7 +1405,7 @@ var dotRenderer = (spec, scales, chartArea, strategy, _theme) => {
 
 // ../../node_modules/.bun/d3-shape@3.2.0/node_modules/d3-shape/src/constant.js
 function constant_default(x2) {
-  return function constant() {
+  return function constant2() {
     return x2;
   };
 }
@@ -1848,12 +1842,12 @@ function identity_default(d) {
 
 // ../../node_modules/.bun/d3-shape@3.2.0/node_modules/d3-shape/src/pie.js
 function pie_default() {
-  var value = identity_default, sortValues = descending_default, sort = null, startAngle = constant_default(0), endAngle = constant_default(tau), padAngle = constant_default(0);
+  var value2 = identity_default, sortValues = descending_default, sort = null, startAngle = constant_default(0), endAngle = constant_default(tau), padAngle = constant_default(0);
   function pie(data) {
-    var i, n = (data = array_default(data)).length, j, k, sum = 0, index = new Array(n), arcs = new Array(n), a0 = +startAngle.apply(this, arguments), da = Math.min(tau, Math.max(-tau, endAngle.apply(this, arguments) - a0)), a1, p = Math.min(Math.abs(da) / n, padAngle.apply(this, arguments)), pa = p * (da < 0 ? -1 : 1), v;
+    var i, n = (data = array_default(data)).length, j, k, sum2 = 0, index = new Array(n), arcs = new Array(n), a0 = +startAngle.apply(this, arguments), da = Math.min(tau, Math.max(-tau, endAngle.apply(this, arguments) - a0)), a1, p = Math.min(Math.abs(da) / n, padAngle.apply(this, arguments)), pa = p * (da < 0 ? -1 : 1), v;
     for (i = 0; i < n; ++i) {
-      if ((v = arcs[index[i] = i] = +value(data[i], i, data)) > 0) {
-        sum += v;
+      if ((v = arcs[index[i] = i] = +value2(data[i], i, data)) > 0) {
+        sum2 += v;
       }
     }
     if (sortValues != null) index.sort(function(i2, j2) {
@@ -1862,7 +1856,7 @@ function pie_default() {
     else if (sort != null) index.sort(function(i2, j2) {
       return sort(data[i2], data[j2]);
     });
-    for (i = 0, k = sum ? (da - n * pa) / sum : 0; i < n; ++i, a0 = a1) {
+    for (i = 0, k = sum2 ? (da - n * pa) / sum2 : 0; i < n; ++i, a0 = a1) {
       j = index[i], v = arcs[j], a1 = a0 + (v > 0 ? v * k : 0) + pa, arcs[j] = {
         data: data[j],
         index: i,
@@ -1875,7 +1869,7 @@ function pie_default() {
     return arcs;
   }
   pie.value = function(_) {
-    return arguments.length ? (value = typeof _ === "function" ? _ : constant_default(+_), pie) : value;
+    return arguments.length ? (value2 = typeof _ === "function" ? _ : constant_default(+_), pie) : value2;
   };
   pie.sortValues = function(_) {
     return arguments.length ? (sortValues = _, sort = null, pie) : sortValues;
@@ -2259,12 +2253,12 @@ function stackSeries(key) {
   return series;
 }
 function stack_default() {
-  var keys = constant_default([]), order = none_default2, offset = none_default, value = stackValue;
+  var keys = constant_default([]), order = none_default2, offset = none_default, value2 = stackValue;
   function stack(data) {
     var sz = Array.from(keys.apply(this, arguments), stackSeries), i, n = sz.length, j = -1, oz;
     for (const d of data) {
       for (i = 0, ++j; i < n; ++i) {
-        (sz[i][j] = [0, +value(d, sz[i].key, j, data)]).data = d;
+        (sz[i][j] = [0, +value2(d, sz[i].key, j, data)]).data = d;
       }
     }
     for (i = 0, oz = array_default(order(sz)); i < n; ++i) {
@@ -2277,7 +2271,7 @@ function stack_default() {
     return arguments.length ? (keys = typeof _ === "function" ? _ : constant_default(Array.from(_)), stack) : keys;
   };
   stack.value = function(_) {
-    return arguments.length ? (value = typeof _ === "function" ? _ : constant_default(+_), stack) : value;
+    return arguments.length ? (value2 = typeof _ === "function" ? _ : constant_default(+_), stack) : value2;
   };
   stack.order = function(_) {
     return arguments.length ? (order = _ == null ? none_default2 : typeof _ === "function" ? _ : constant_default(Array.from(_)), stack) : order;
@@ -2701,7 +2695,7 @@ var DEFAULT_PALETTE = [
   "#858078"
 ];
 function groupSmallSlices(slices, threshold2) {
-  const total = slices.reduce((sum, s) => sum + s.value, 0);
+  const total = slices.reduce((sum2, s) => sum2 + s.value, 0);
   if (total === 0) return slices;
   const big = [];
   let otherValue = 0;
@@ -2739,13 +2733,13 @@ function computePieMarks(spec, scales, chartArea, _strategy, isDonut = false) {
         categoryRows.set(cat, row);
       }
     }
-    for (const [label, value] of categoryTotals) {
+    for (const [label, value2] of categoryTotals) {
       slices.push({
         label,
-        value,
+        value: value2,
         originalRow: categoryRows.get(label) ?? {
           [categoryField]: label,
-          [valueChannel.field]: value
+          [valueChannel.field]: value2
         }
       });
     }
@@ -2769,8 +2763,8 @@ function computePieMarks(spec, scales, chartArea, _strategy, isDonut = false) {
   const innerRadius = isDonut ? outerRadius * 0.6 : 0;
   const arcGenerator = arc_default().innerRadius(innerRadius).outerRadius(outerRadius);
   const marks = [];
-  const center = { x: centerX, y: centerY };
-  const total = slices.reduce((sum, s) => sum + s.value, 0);
+  const center2 = { x: centerX, y: centerY };
+  const total = slices.reduce((sum2, s) => sum2 + s.value, 0);
   for (let i = 0; i < arcs.length; i++) {
     const arcDatum = arcs[i];
     const slice2 = arcDatum.data;
@@ -2794,7 +2788,7 @@ function computePieMarks(spec, scales, chartArea, _strategy, isDonut = false) {
         x: centroidResult[0] + centerX,
         y: centroidResult[1] + centerY
       },
-      center,
+      center: center2,
       innerRadius,
       outerRadius,
       startAngle: arcDatum.startAngle,
@@ -3003,7 +2997,7 @@ function bisector(f) {
     compare2 = f;
     delta = f;
   }
-  function left(a, x2, lo = 0, hi = a.length) {
+  function left2(a, x2, lo = 0, hi = a.length) {
     if (lo < hi) {
       if (compare1(x2, x2) !== 0) return hi;
       do {
@@ -3014,7 +3008,7 @@ function bisector(f) {
     }
     return lo;
   }
-  function right(a, x2, lo = 0, hi = a.length) {
+  function right2(a, x2, lo = 0, hi = a.length) {
     if (lo < hi) {
       if (compare1(x2, x2) !== 0) return hi;
       do {
@@ -3025,11 +3019,11 @@ function bisector(f) {
     }
     return lo;
   }
-  function center(a, x2, lo = 0, hi = a.length) {
-    const i = left(a, x2, lo, hi - 1);
+  function center2(a, x2, lo = 0, hi = a.length) {
+    const i = left2(a, x2, lo, hi - 1);
     return i > lo && delta(a[i - 1], x2) > -delta(a[i], x2) ? i - 1 : i;
   }
-  return { left, center, right };
+  return { left: left2, center: center2, right: right2 };
 }
 function zero() {
   return 0;
@@ -3049,33 +3043,33 @@ var bisect_default = bisectRight;
 
 // ../../node_modules/.bun/d3-array@3.2.4/node_modules/d3-array/src/extent.js
 function extent(values, valueof) {
-  let min3;
-  let max3;
+  let min4;
+  let max4;
   if (valueof === void 0) {
-    for (const value of values) {
-      if (value != null) {
-        if (min3 === void 0) {
-          if (value >= value) min3 = max3 = value;
+    for (const value2 of values) {
+      if (value2 != null) {
+        if (min4 === void 0) {
+          if (value2 >= value2) min4 = max4 = value2;
         } else {
-          if (min3 > value) min3 = value;
-          if (max3 < value) max3 = value;
+          if (min4 > value2) min4 = value2;
+          if (max4 < value2) max4 = value2;
         }
       }
     }
   } else {
     let index = -1;
-    for (let value of values) {
-      if ((value = valueof(value, ++index, values)) != null) {
-        if (min3 === void 0) {
-          if (value >= value) min3 = max3 = value;
+    for (let value2 of values) {
+      if ((value2 = valueof(value2, ++index, values)) != null) {
+        if (min4 === void 0) {
+          if (value2 >= value2) min4 = max4 = value2;
         } else {
-          if (min3 > value) min3 = value;
-          if (max3 < value) max3 = value;
+          if (min4 > value2) min4 = value2;
+          if (max4 < value2) max4 = value2;
         }
       }
     }
   }
-  return [min3, max3];
+  return [min4, max4];
 }
 
 // ../../node_modules/.bun/internmap@2.0.3/node_modules/internmap/src/index.js
@@ -3083,7 +3077,7 @@ var InternMap = class extends Map {
   constructor(entries, key = keyof) {
     super();
     Object.defineProperties(this, { _intern: { value: /* @__PURE__ */ new Map() }, _key: { value: key } });
-    if (entries != null) for (const [key2, value] of entries) this.set(key2, value);
+    if (entries != null) for (const [key2, value2] of entries) this.set(key2, value2);
   }
   get(key) {
     return super.get(intern_get(this, key));
@@ -3091,33 +3085,33 @@ var InternMap = class extends Map {
   has(key) {
     return super.has(intern_get(this, key));
   }
-  set(key, value) {
-    return super.set(intern_set(this, key), value);
+  set(key, value2) {
+    return super.set(intern_set(this, key), value2);
   }
   delete(key) {
     return super.delete(intern_delete(this, key));
   }
 };
-function intern_get({ _intern, _key }, value) {
-  const key = _key(value);
-  return _intern.has(key) ? _intern.get(key) : value;
+function intern_get({ _intern, _key }, value2) {
+  const key = _key(value2);
+  return _intern.has(key) ? _intern.get(key) : value2;
 }
-function intern_set({ _intern, _key }, value) {
-  const key = _key(value);
+function intern_set({ _intern, _key }, value2) {
+  const key = _key(value2);
   if (_intern.has(key)) return _intern.get(key);
-  _intern.set(key, value);
-  return value;
+  _intern.set(key, value2);
+  return value2;
 }
-function intern_delete({ _intern, _key }, value) {
-  const key = _key(value);
+function intern_delete({ _intern, _key }, value2) {
+  const key = _key(value2);
   if (_intern.has(key)) {
-    value = _intern.get(key);
+    value2 = _intern.get(key);
     _intern.delete(key);
   }
-  return value;
+  return value2;
 }
-function keyof(value) {
-  return value !== null && typeof value === "object" ? value.valueOf() : value;
+function keyof(value2) {
+  return value2 !== null && typeof value2 === "object" ? value2.valueOf() : value2;
 }
 
 // ../../node_modules/.bun/d3-array@3.2.4/node_modules/d3-array/src/ticks.js
@@ -3172,42 +3166,42 @@ function tickStep(start, stop, count) {
 
 // ../../node_modules/.bun/d3-array@3.2.4/node_modules/d3-array/src/max.js
 function max2(values, valueof) {
-  let max3;
+  let max4;
   if (valueof === void 0) {
-    for (const value of values) {
-      if (value != null && (max3 < value || max3 === void 0 && value >= value)) {
-        max3 = value;
+    for (const value2 of values) {
+      if (value2 != null && (max4 < value2 || max4 === void 0 && value2 >= value2)) {
+        max4 = value2;
       }
     }
   } else {
     let index = -1;
-    for (let value of values) {
-      if ((value = valueof(value, ++index, values)) != null && (max3 < value || max3 === void 0 && value >= value)) {
-        max3 = value;
+    for (let value2 of values) {
+      if ((value2 = valueof(value2, ++index, values)) != null && (max4 < value2 || max4 === void 0 && value2 >= value2)) {
+        max4 = value2;
       }
     }
   }
-  return max3;
+  return max4;
 }
 
 // ../../node_modules/.bun/d3-array@3.2.4/node_modules/d3-array/src/min.js
 function min2(values, valueof) {
-  let min3;
+  let min4;
   if (valueof === void 0) {
-    for (const value of values) {
-      if (value != null && (min3 > value || min3 === void 0 && value >= value)) {
-        min3 = value;
+    for (const value2 of values) {
+      if (value2 != null && (min4 > value2 || min4 === void 0 && value2 >= value2)) {
+        min4 = value2;
       }
     }
   } else {
     let index = -1;
-    for (let value of values) {
-      if ((value = valueof(value, ++index, values)) != null && (min3 > value || min3 === void 0 && value >= value)) {
-        min3 = value;
+    for (let value2 of values) {
+      if ((value2 = valueof(value2, ++index, values)) != null && (min4 > value2 || min4 === void 0 && value2 >= value2)) {
+        min4 = value2;
       }
     }
   }
-  return min3;
+  return min4;
 }
 
 // ../../node_modules/.bun/d3-array@3.2.4/node_modules/d3-array/src/quantile.js
@@ -3277,9 +3271,9 @@ function ordinal() {
   scale.domain = function(_) {
     if (!arguments.length) return domain.slice();
     domain = [], index = new InternMap();
-    for (const value of _) {
-      if (index.has(value)) continue;
-      index.set(value, domain.push(value) - 1);
+    for (const value2 of _) {
+      if (index.has(value2)) continue;
+      index.set(value2, domain.push(value2) - 1);
     }
     return scale;
   };
@@ -3629,12 +3623,12 @@ function rgb_formatRgb() {
 function clampa(opacity) {
   return isNaN(opacity) ? 1 : Math.max(0, Math.min(1, opacity));
 }
-function clampi(value) {
-  return Math.max(0, Math.min(255, Math.round(value) || 0));
+function clampi(value2) {
+  return Math.max(0, Math.min(255, Math.round(value2) || 0));
 }
-function hex(value) {
-  value = clampi(value);
-  return (value < 16 ? "0" : "") + value.toString(16);
+function hex(value2) {
+  value2 = clampi(value2);
+  return (value2 < 16 ? "0" : "") + value2.toString(16);
 }
 function hsla(h, s, l, a) {
   if (a <= 0) h = s = l = NaN;
@@ -3648,12 +3642,12 @@ function hslConvert(o) {
   if (!o) return new Hsl();
   if (o instanceof Hsl) return o;
   o = o.rgb();
-  var r = o.r / 255, g = o.g / 255, b = o.b / 255, min3 = Math.min(r, g, b), max3 = Math.max(r, g, b), h = NaN, s = max3 - min3, l = (max3 + min3) / 2;
+  var r = o.r / 255, g = o.g / 255, b = o.b / 255, min4 = Math.min(r, g, b), max4 = Math.max(r, g, b), h = NaN, s = max4 - min4, l = (max4 + min4) / 2;
   if (s) {
-    if (r === max3) h = (g - b) / s + (g < b) * 6;
-    else if (g === max3) h = (b - r) / s + 2;
+    if (r === max4) h = (g - b) / s + (g < b) * 6;
+    else if (g === max4) h = (b - r) / s + 2;
     else h = (r - g) / s + 4;
-    s /= l < 0.5 ? max3 + min3 : 2 - max3 - min3;
+    s /= l < 0.5 ? max4 + min4 : 2 - max4 - min4;
     h *= 60;
   } else {
     s = l > 0 && l < 1 ? 0 : h;
@@ -3698,12 +3692,12 @@ define_default(Hsl, hsl, extend(Color, {
     return `${a === 1 ? "hsl(" : "hsla("}${clamph(this.h)}, ${clampt(this.s) * 100}%, ${clampt(this.l) * 100}%${a === 1 ? ")" : `, ${a})`}`;
   }
 }));
-function clamph(value) {
-  value = (value || 0) % 360;
-  return value < 0 ? value + 360 : value;
+function clamph(value2) {
+  value2 = (value2 || 0) % 360;
+  return value2 < 0 ? value2 + 360 : value2;
 }
-function clampt(value) {
-  return Math.max(0, Math.min(1, value || 0));
+function clampt(value2) {
+  return Math.max(0, Math.min(1, value2 || 0));
 }
 function hsl2rgb(h, m1, m2) {
   return (h < 60 ? m1 + (m2 - m1) * h / 60 : h < 180 ? m2 : h < 240 ? m1 + (m2 - m1) * (240 - h) / 60 : m1) * 255;
@@ -4024,11 +4018,11 @@ function exponent_default(x2) {
 
 // ../../node_modules/.bun/d3-format@3.1.2/node_modules/d3-format/src/formatGroup.js
 function formatGroup_default(grouping, thousands) {
-  return function(value, width) {
-    var i = value.length, t = [], j = 0, g = grouping[0], length = 0;
+  return function(value2, width) {
+    var i = value2.length, t = [], j = 0, g = grouping[0], length = 0;
     while (i > 0 && g > 0) {
       if (length + g + 1 > width) g = Math.max(1, width - length);
-      t.push(value.substring(i -= g, i + g));
+      t.push(value2.substring(i -= g, i + g));
       if ((length += g + 1) > width) break;
       g = grouping[j = (j + 1) % grouping.length];
     }
@@ -4038,8 +4032,8 @@ function formatGroup_default(grouping, thousands) {
 
 // ../../node_modules/.bun/d3-format@3.1.2/node_modules/d3-format/src/formatNumerals.js
 function formatNumerals_default(numerals) {
-  return function(value) {
-    return value.replace(/[0-9]/g, function(i) {
+  return function(value2) {
+    return value2.replace(/[0-9]/g, function(i) {
       return numerals[+i];
     });
   };
@@ -4153,58 +4147,58 @@ function locale_default(locale3) {
     var prefix = (options && options.prefix !== void 0 ? options.prefix : "") + (symbol === "$" ? currencyPrefix : symbol === "#" && /[boxX]/.test(type) ? "0" + type.toLowerCase() : ""), suffix = (symbol === "$" ? currencySuffix : /[%p]/.test(type) ? percent : "") + (options && options.suffix !== void 0 ? options.suffix : "");
     var formatType = formatTypes_default[type], maybeSuffix = /[defgprs%]/.test(type);
     precision = precision === void 0 ? 6 : /[gprs]/.test(type) ? Math.max(1, Math.min(21, precision)) : Math.max(0, Math.min(20, precision));
-    function format2(value) {
+    function format2(value2) {
       var valuePrefix = prefix, valueSuffix = suffix, i, n, c;
       if (type === "c") {
-        valueSuffix = formatType(value) + valueSuffix;
-        value = "";
+        valueSuffix = formatType(value2) + valueSuffix;
+        value2 = "";
       } else {
-        value = +value;
-        var valueNegative = value < 0 || 1 / value < 0;
-        value = isNaN(value) ? nan : formatType(Math.abs(value), precision);
-        if (trim) value = formatTrim_default(value);
-        if (valueNegative && +value === 0 && sign2 !== "+") valueNegative = false;
+        value2 = +value2;
+        var valueNegative = value2 < 0 || 1 / value2 < 0;
+        value2 = isNaN(value2) ? nan : formatType(Math.abs(value2), precision);
+        if (trim) value2 = formatTrim_default(value2);
+        if (valueNegative && +value2 === 0 && sign2 !== "+") valueNegative = false;
         valuePrefix = (valueNegative ? sign2 === "(" ? sign2 : minus : sign2 === "-" || sign2 === "(" ? "" : sign2) + valuePrefix;
-        valueSuffix = (type === "s" && !isNaN(value) && prefixExponent !== void 0 ? prefixes[8 + prefixExponent / 3] : "") + valueSuffix + (valueNegative && sign2 === "(" ? ")" : "");
+        valueSuffix = (type === "s" && !isNaN(value2) && prefixExponent !== void 0 ? prefixes[8 + prefixExponent / 3] : "") + valueSuffix + (valueNegative && sign2 === "(" ? ")" : "");
         if (maybeSuffix) {
-          i = -1, n = value.length;
+          i = -1, n = value2.length;
           while (++i < n) {
-            if (c = value.charCodeAt(i), 48 > c || c > 57) {
-              valueSuffix = (c === 46 ? decimal + value.slice(i + 1) : value.slice(i)) + valueSuffix;
-              value = value.slice(0, i);
+            if (c = value2.charCodeAt(i), 48 > c || c > 57) {
+              valueSuffix = (c === 46 ? decimal + value2.slice(i + 1) : value2.slice(i)) + valueSuffix;
+              value2 = value2.slice(0, i);
               break;
             }
           }
         }
       }
-      if (comma && !zero3) value = group(value, Infinity);
-      var length = valuePrefix.length + value.length + valueSuffix.length, padding = length < width ? new Array(width - length + 1).join(fill) : "";
-      if (comma && zero3) value = group(padding + value, padding.length ? width - valueSuffix.length : Infinity), padding = "";
+      if (comma && !zero3) value2 = group(value2, Infinity);
+      var length = valuePrefix.length + value2.length + valueSuffix.length, padding = length < width ? new Array(width - length + 1).join(fill) : "";
+      if (comma && zero3) value2 = group(padding + value2, padding.length ? width - valueSuffix.length : Infinity), padding = "";
       switch (align) {
         case "<":
-          value = valuePrefix + value + valueSuffix + padding;
+          value2 = valuePrefix + value2 + valueSuffix + padding;
           break;
         case "=":
-          value = valuePrefix + padding + value + valueSuffix;
+          value2 = valuePrefix + padding + value2 + valueSuffix;
           break;
         case "^":
-          value = padding.slice(0, length = padding.length >> 1) + valuePrefix + value + valueSuffix + padding.slice(length);
+          value2 = padding.slice(0, length = padding.length >> 1) + valuePrefix + value2 + valueSuffix + padding.slice(length);
           break;
         default:
-          value = padding + valuePrefix + value + valueSuffix;
+          value2 = padding + valuePrefix + value2 + valueSuffix;
           break;
       }
-      return numerals(value);
+      return numerals(value2);
     }
     format2.toString = function() {
       return specifier + "";
     };
     return format2;
   }
-  function formatPrefix2(specifier, value) {
-    var e = Math.max(-8, Math.min(8, Math.floor(exponent_default(value) / 3))) * 3, k = Math.pow(10, -e), f = newFormat((specifier = formatSpecifier(specifier), specifier.type = "f", specifier), { suffix: prefixes[8 + e / 3] });
-    return function(value2) {
-      return f(k * value2);
+  function formatPrefix2(specifier, value2) {
+    var e = Math.max(-8, Math.min(8, Math.floor(exponent_default(value2) / 3))) * 3, k = Math.pow(10, -e), f = newFormat((specifier = formatSpecifier(specifier), specifier.type = "f", specifier), { suffix: prefixes[8 + e / 3] });
+    return function(value3) {
+      return f(k * value3);
     };
   }
   return {
@@ -4235,14 +4229,14 @@ function precisionFixed_default(step) {
 }
 
 // ../../node_modules/.bun/d3-format@3.1.2/node_modules/d3-format/src/precisionPrefix.js
-function precisionPrefix_default(step, value) {
-  return Math.max(0, Math.max(-8, Math.min(8, Math.floor(exponent_default(value) / 3))) * 3 - exponent_default(Math.abs(step)));
+function precisionPrefix_default(step, value2) {
+  return Math.max(0, Math.max(-8, Math.min(8, Math.floor(exponent_default(value2) / 3))) * 3 - exponent_default(Math.abs(step)));
 }
 
 // ../../node_modules/.bun/d3-format@3.1.2/node_modules/d3-format/src/precisionRound.js
-function precisionRound_default(step, max3) {
-  step = Math.abs(step), max3 = Math.abs(max3) - step;
-  return Math.max(0, exponent_default(max3) - exponent_default(step)) + 1;
+function precisionRound_default(step, max4) {
+  step = Math.abs(step), max4 = Math.abs(max4) - step;
+  return Math.max(0, exponent_default(max4) - exponent_default(step)) + 1;
 }
 
 // ../../node_modules/.bun/d3-scale@4.0.2/node_modules/d3-scale/src/tickFormat.js
@@ -4251,9 +4245,9 @@ function tickFormat(start, stop, count, specifier) {
   specifier = formatSpecifier(specifier == null ? ",f" : specifier);
   switch (specifier.type) {
     case "s": {
-      var value = Math.max(Math.abs(start), Math.abs(stop));
-      if (specifier.precision == null && !isNaN(precision = precisionPrefix_default(step, value))) specifier.precision = precision;
-      return formatPrefix(specifier, value);
+      var value2 = Math.max(Math.abs(start), Math.abs(stop));
+      if (specifier.precision == null && !isNaN(precision = precisionPrefix_default(step, value2))) specifier.precision = precision;
+      return formatPrefix(specifier, value2);
     }
     case "":
     case "e":
@@ -5252,8 +5246,8 @@ var pads = { "-": "", "_": " ", "0": "0" };
 var numberRe = /^\s*\d+/;
 var percentRe = /^%/;
 var requoteRe = /[\\^$*+?|[\]().{}]/g;
-function pad(value, fill, width) {
-  var sign2 = value < 0 ? "-" : "", string = (sign2 ? -value : value) + "", length = string.length;
+function pad(value2, fill, width) {
+  var sign2 = value2 < 0 ? "-" : "", string = (sign2 ? -value2 : value2) + "", length = string.length;
   return sign2 + (length < width ? new Array(width - length + 1).join(fill) + string : string);
 }
 function requote(s) {
@@ -5604,11 +5598,11 @@ function sequential() {
 var DEFAULT_POINT_RADIUS2 = 5;
 var MIN_BUBBLE_RADIUS = 3;
 var MAX_BUBBLE_RADIUS = 30;
-function resolvePosition2(value, channelType, scale) {
+function resolvePosition2(value2, channelType, scale) {
   switch (channelType) {
     case "nominal":
     case "ordinal": {
-      const s = String(value);
+      const s = String(value2);
       if ("bandwidth" in scale && typeof scale.bandwidth === "function") {
         const bw = scale.bandwidth();
         const pos = scale(s);
@@ -5618,11 +5612,11 @@ function resolvePosition2(value, channelType, scale) {
       return scale(s);
     }
     case "temporal": {
-      const px = scale(new Date(value));
+      const px = scale(new Date(value2));
       return Number.isNaN(px) ? void 0 : px;
     }
     default: {
-      const num = Number(value);
+      const num = Number(value2);
       if (!Number.isFinite(num)) return void 0;
       return scale(num);
     }
@@ -5855,14 +5849,15 @@ import {
   isChartSpec,
   isGraphSpec,
   isLayerSpec,
+  isSankeySpec,
   isTableSpec,
   resolveMarkDef,
   resolveMarkType
 } from "@opendata-ai/openchart-core";
-function normalizeChromeField(value) {
-  if (value === void 0) return void 0;
-  if (typeof value === "string") return { text: value };
-  return value;
+function normalizeChromeField(value2) {
+  if (value2 === void 0) return void 0;
+  if (typeof value2 === "string") return { text: value2 };
+  return value2;
 }
 function normalizeChrome(chrome) {
   if (!chrome) return {};
@@ -5880,26 +5875,26 @@ function inferFieldType(data, field) {
   let dateCount = 0;
   let totalNonNull = 0;
   for (let i = 0; i < sampleSize; i++) {
-    const value = data[i][field];
-    if (value == null) continue;
+    const value2 = data[i][field];
+    if (value2 == null) continue;
     totalNonNull++;
-    if (typeof value === "number" && Number.isFinite(value)) {
+    if (typeof value2 === "number" && Number.isFinite(value2)) {
       numericCount++;
       continue;
     }
-    if (typeof value === "string") {
-      const num = Number(value);
-      if (!Number.isNaN(num) && Number.isFinite(num) && value.trim() !== "") {
+    if (typeof value2 === "string") {
+      const num = Number(value2);
+      if (!Number.isNaN(num) && Number.isFinite(num) && value2.trim() !== "") {
         numericCount++;
         continue;
       }
-      const date2 = new Date(value);
+      const date2 = new Date(value2);
       if (!Number.isNaN(date2.getTime())) {
         dateCount++;
         continue;
       }
     }
-    if (value instanceof Date && !Number.isNaN(value.getTime())) {
+    if (value2 instanceof Date && !Number.isNaN(value2.getTime())) {
       dateCount++;
     }
   }
@@ -6003,6 +5998,23 @@ function normalizeTableSpec(spec, _warnings) {
     animation: spec.animation
   };
 }
+function normalizeSankeySpec(spec, _warnings) {
+  return {
+    type: "sankey",
+    data: spec.data,
+    encoding: spec.encoding,
+    nodeWidth: spec.nodeWidth ?? 12,
+    nodePadding: spec.nodePadding ?? 16,
+    nodeAlign: spec.nodeAlign ?? "justify",
+    iterations: spec.iterations ?? 6,
+    linkStyle: spec.linkStyle ?? "gradient",
+    chrome: normalizeChrome(spec.chrome),
+    legend: spec.legend,
+    theme: spec.theme ?? {},
+    darkMode: spec.darkMode ?? "off",
+    animation: spec.animation
+  };
+}
 function normalizeGraphSpec(spec, _warnings) {
   const defaultLayout = {
     type: "force",
@@ -6043,8 +6055,11 @@ function normalizeSpec(spec, warnings = []) {
   if (isGraphSpec(spec)) {
     return normalizeGraphSpec(spec, warnings);
   }
+  if (isSankeySpec(spec)) {
+    return normalizeSankeySpec(spec, warnings);
+  }
   throw new Error(
-    `Unknown spec shape. Expected mark (chart), layer, type: 'table', or type: 'graph'.`
+    `Unknown spec shape. Expected mark (chart), layer, type: 'table', type: 'graph', or type: 'sankey'.`
   );
 }
 function flattenLayers(spec, parentData, parentEncoding, parentTransforms) {
@@ -6077,19 +6092,19 @@ import {
 } from "@opendata-ai/openchart-core";
 var VALID_FIELD_TYPES = /* @__PURE__ */ new Set(["quantitative", "temporal", "nominal", "ordinal"]);
 var VALID_DARK_MODES = /* @__PURE__ */ new Set(["auto", "force", "off"]);
-function isParseableDate(value) {
-  if (value instanceof Date) return !Number.isNaN(value.getTime());
-  if (typeof value === "string") {
-    const d = new Date(value);
+function isParseableDate(value2) {
+  if (value2 instanceof Date) return !Number.isNaN(value2.getTime());
+  if (typeof value2 === "string") {
+    const d = new Date(value2);
     return !Number.isNaN(d.getTime());
   }
-  if (typeof value === "number") return true;
+  if (typeof value2 === "number") return true;
   return false;
 }
-function isNumeric(value) {
-  if (typeof value === "number") return Number.isFinite(value);
-  if (typeof value === "string") {
-    const n = Number(value);
+function isNumeric(value2) {
+  if (typeof value2 === "number") return Number.isFinite(value2);
+  if (typeof value2 === "string") {
+    const n = Number(value2);
     return !Number.isNaN(n) && Number.isFinite(n);
   }
   return false;
@@ -6504,6 +6519,85 @@ function validateGraphSpec(spec, errors) {
     }
   }
 }
+function validateSankeySpec(spec, errors) {
+  if (!Array.isArray(spec.data)) {
+    errors.push({
+      message: 'Spec error: sankey spec requires a "data" array',
+      path: "data",
+      code: "INVALID_TYPE",
+      suggestion: 'Provide data as an array of objects, e.g. data: [{ source: "A", target: "B", value: 10 }]'
+    });
+    return;
+  }
+  if (spec.data.length === 0) {
+    errors.push({
+      message: 'Spec error: "data" must be a non-empty array',
+      path: "data",
+      code: "EMPTY_DATA",
+      suggestion: 'Add at least one data row, e.g. data: [{ source: "A", target: "B", value: 10 }]'
+    });
+    return;
+  }
+  const firstRow = spec.data[0];
+  if (typeof firstRow !== "object" || firstRow === null || Array.isArray(firstRow)) {
+    errors.push({
+      message: 'Spec error: each item in "data" must be a plain object',
+      path: "data[0]",
+      code: "INVALID_TYPE",
+      suggestion: 'Each data item should be an object, e.g. { source: "A", target: "B", value: 10 }'
+    });
+    return;
+  }
+  if (!spec.encoding || typeof spec.encoding !== "object") {
+    errors.push({
+      message: 'Spec error: sankey spec requires an "encoding" object with source, target, and value channels',
+      path: "encoding",
+      code: "MISSING_FIELD",
+      suggestion: 'Add an encoding object, e.g. encoding: { source: { field: "source", type: "nominal" }, target: { field: "target", type: "nominal" }, value: { field: "value", type: "quantitative" } }'
+    });
+    return;
+  }
+  const encoding = spec.encoding;
+  const dataColumns = new Set(Object.keys(firstRow));
+  const availableColumns = [...dataColumns].join(", ");
+  for (const channel of ["source", "target", "value"]) {
+    const ch = encoding[channel];
+    if (!ch || typeof ch !== "object") {
+      errors.push({
+        message: `Spec error: sankey encoding requires "${channel}" channel`,
+        path: `encoding.${channel}`,
+        code: "MISSING_FIELD",
+        suggestion: `Add encoding.${channel} with a field from your data (${availableColumns}). Example: ${channel}: { field: "${[...dataColumns][0] ?? "myField"}", type: "${channel === "value" ? "quantitative" : "nominal"}" }`
+      });
+      continue;
+    }
+    if (!ch.field || typeof ch.field !== "string") {
+      errors.push({
+        message: `Spec error: encoding.${channel} must have a "field" string`,
+        path: `encoding.${channel}.field`,
+        code: "MISSING_FIELD",
+        suggestion: `Add a field name from your data columns: ${availableColumns}`
+      });
+      continue;
+    }
+    if (!dataColumns.has(ch.field)) {
+      errors.push({
+        message: `Spec error: encoding.${channel}.field "${ch.field}" does not exist in data. Available columns: ${availableColumns}`,
+        path: `encoding.${channel}.field`,
+        code: "DATA_FIELD_MISSING",
+        suggestion: `Use one of the available data columns: ${availableColumns}`
+      });
+    }
+  }
+  if (spec.darkMode !== void 0 && !VALID_DARK_MODES.has(spec.darkMode)) {
+    errors.push({
+      message: 'Spec error: darkMode must be "auto", "force", or "off"',
+      path: "darkMode",
+      code: "INVALID_VALUE",
+      suggestion: 'Use one of: "auto" (system preference), "force" (always dark), or "off" (always light)'
+    });
+  }
+}
 function validateLayerSpec(spec, errors) {
   const layer = spec.layer;
   if (layer.length === 0) {
@@ -6597,17 +6691,18 @@ function validateSpec(spec) {
   const hasMark = "mark" in obj;
   const isTable = obj.type === "table";
   const isGraph = obj.type === "graph";
-  const isLayer = hasLayer && !isTable && !isGraph;
-  const isChart = hasMark && !hasLayer && !isTable && !isGraph;
-  if (!isChart && !isTable && !isGraph && !isLayer) {
+  const isSankey = obj.type === "sankey";
+  const isLayer = hasLayer && !isTable && !isGraph && !isSankey;
+  const isChart = hasMark && !hasLayer && !isTable && !isGraph && !isSankey;
+  if (!isChart && !isTable && !isGraph && !isSankey && !isLayer) {
     return {
       valid: false,
       errors: [
         {
-          message: 'Spec error: spec must have a "mark" field for charts, a "layer" array for layered charts, or a "type" field for tables/graphs',
+          message: 'Spec error: spec must have a "mark" field for charts, a "layer" array for layered charts, or a "type" field for tables/graphs/sankey',
           path: "mark",
           code: "MISSING_FIELD",
-          suggestion: `Add a "mark" field for charts (e.g. mark: "bar"), a "layer" array for layered charts, or a "type" field for tables/graphs (type: "table" or type: "graph"). Valid mark types: ${[...MARK_TYPES].join(", ")}`
+          suggestion: `Add a "mark" field for charts (e.g. mark: "bar"), a "layer" array for layered charts, or a "type" field for tables/graphs/sankey (type: "table", type: "graph", or type: "sankey"). Valid mark types: ${[...MARK_TYPES].join(", ")}`
         }
       ],
       normalized: null
@@ -6643,6 +6738,8 @@ function validateSpec(spec) {
     validateTableSpec(obj, errors);
   } else if (isGraph) {
     validateGraphSpec(obj, errors);
+  } else if (isSankey) {
+    validateSankeySpec(obj, errors);
   }
   if (errors.length > 0) {
     return { valid: false, errors, normalized: null };
@@ -6929,8 +7026,8 @@ function resolveEdgeVisuals(edges, encoding, theme) {
 function assignCommunities(nodes, clusteringField) {
   if (!clusteringField) return;
   for (const node of nodes) {
-    const value = node.data[clusteringField];
-    node.community = value != null ? String(value) : void 0;
+    const value2 = node.data[clusteringField];
+    node.community = value2 != null ? String(value2) : void 0;
   }
 }
 function buildCommunityColorMap(nodes, theme) {
@@ -7017,12 +7114,12 @@ function buildGraphTooltips(nodes) {
         color: node.fill
       });
     }
-    for (const [key, value] of Object.entries(node.data)) {
+    for (const [key, value2] of Object.entries(node.data)) {
       if (key === "id") continue;
-      if (value == null) continue;
+      if (value2 == null) continue;
       fields.push({
         label: key,
-        value: typeof value === "number" ? value.toLocaleString() : String(value)
+        value: typeof value2 === "number" ? value2.toLocaleString() : String(value2)
       });
     }
     descriptors.set(node.id, {
@@ -7191,19 +7288,19 @@ function continuousTicks(resolvedScale, density) {
   const scale = resolvedScale.scale;
   if (!("ticks" in scale) || typeof scale.ticks !== "function") {
     const domain = scale.domain();
-    return domain.map((value) => ({
-      value,
-      position: scale(value),
-      label: formatTickLabel(value, resolvedScale)
+    return domain.map((value2) => ({
+      value: value2,
+      position: scale(value2),
+      label: formatTickLabel(value2, resolvedScale)
     }));
   }
   const explicitCount = resolvedScale.channel.axis?.tickCount;
   const count = explicitCount ?? TICK_COUNTS[density];
   const rawTicks = scale.ticks(count);
-  const ticks2 = rawTicks.map((value) => ({
-    value,
-    position: scale(value),
-    label: formatTickLabel(value, resolvedScale)
+  const ticks2 = rawTicks.map((value2) => ({
+    value: value2,
+    position: scale(value2),
+    label: formatTickLabel(value2, resolvedScale)
   }));
   return ticks2;
 }
@@ -7217,13 +7314,13 @@ function categoricalTicks(resolvedScale, density) {
     const step = Math.ceil(domain.length / maxTicks);
     selectedValues = domain.filter((_, i) => i % step === 0);
   }
-  const ticks2 = selectedValues.map((value) => {
+  const ticks2 = selectedValues.map((value2) => {
     const bandScale = resolvedScale.type === "band" ? scale : null;
-    const pos = bandScale ? (bandScale(value) ?? 0) + bandScale.bandwidth() / 2 : scale(value) ?? 0;
+    const pos = bandScale ? (bandScale(value2) ?? 0) + bandScale.bandwidth() / 2 : scale(value2) ?? 0;
     return {
-      value,
+      value: value2,
       position: pos,
-      label: value
+      label: value2
     };
   });
   return ticks2;
@@ -7239,16 +7336,16 @@ var NUMERIC_SCALE_TYPES = /* @__PURE__ */ new Set([
   "threshold"
 ]);
 var TEMPORAL_SCALE_TYPES = /* @__PURE__ */ new Set(["time", "utc"]);
-function formatTickLabel(value, resolvedScale) {
+function formatTickLabel(value2, resolvedScale) {
   const formatStr = resolvedScale.channel.axis?.format;
   if (TEMPORAL_SCALE_TYPES.has(resolvedScale.type)) {
     const temporalFmt = buildTemporalFormatter(formatStr);
-    if (temporalFmt) return temporalFmt(value);
+    if (temporalFmt) return temporalFmt(value2);
     const useUtc = resolvedScale.type === "utc";
-    return formatDate(value, void 0, void 0, useUtc);
+    return formatDate(value2, void 0, void 0, useUtc);
   }
   if (NUMERIC_SCALE_TYPES.has(resolvedScale.type)) {
-    const num = value;
+    const num = value2;
     if (formatStr) {
       const fmt = buildD3Formatter3(formatStr);
       if (fmt) return fmt(num);
@@ -7256,26 +7353,26 @@ function formatTickLabel(value, resolvedScale) {
     if (Math.abs(num) >= 1e3) return abbreviateNumber3(num);
     return formatNumber3(num);
   }
-  return String(value);
+  return String(value2);
 }
 function resolveExplicitTicks(values, resolvedScale) {
   const scale = resolvedScale.scale;
-  return values.map((value) => {
+  return values.map((value2) => {
     let position;
     if (TEMPORAL_SCALE_TYPES.has(resolvedScale.type)) {
-      const d = value instanceof Date ? value : new Date(String(value));
+      const d = value2 instanceof Date ? value2 : new Date(String(value2));
       position = scale(d);
     } else if (resolvedScale.type === "band" || resolvedScale.type === "point" || resolvedScale.type === "ordinal") {
-      const s = String(value);
+      const s = String(value2);
       const bandScale = resolvedScale.type === "band" ? scale : null;
       position = bandScale ? (bandScale(s) ?? 0) + bandScale.bandwidth() / 2 : scale(s) ?? 0;
     } else {
-      position = scale(value);
+      position = scale(value2);
     }
     return {
-      value,
+      value: value2,
       position,
-      label: formatTickLabel(value, resolvedScale)
+      label: formatTickLabel(value2, resolvedScale)
     };
   });
 }
@@ -7486,7 +7583,7 @@ function computeDimensions(spec, options, legendLayout, theme, strategy) {
       }
     }
   }
-  if (spec.annotations.length > 0 && encoding.x) {
+  if (strategy?.annotationPosition !== "tooltip-only" && spec.annotations.length > 0 && encoding.x) {
     const xField = encoding.x.field;
     let maxX;
     for (const row of spec.data) {
@@ -8033,8 +8130,8 @@ function extractColorEntries(spec, theme) {
   const uniqueValues = [...new Set(spec.data.map((d) => String(d[colorEnc.field])))];
   const palette = theme.colors.categorical;
   const shape = swatchShapeForType(spec.markType);
-  return uniqueValues.map((value, i) => ({
-    label: value,
+  return uniqueValues.map((value2, i) => ({
+    label: value2,
     color: palette[i % palette.length],
     shape,
     active: true
@@ -8162,9 +8259,9 @@ function computeLegend(spec, strategy, theme, chartArea) {
   if (maxFit < entries.length) {
     entries = truncateEntries(entries, maxFit);
   }
-  const totalWidth = entries.reduce((sum, entry) => {
+  const totalWidth = entries.reduce((sum2, entry) => {
     const labelWidth = estimateTextWidth9(entry.label, labelStyle.fontSize, labelStyle.fontWeight);
-    return sum + SWATCH_SIZE2 + SWATCH_GAP2 + labelWidth + ENTRY_GAP2;
+    return sum2 + SWATCH_SIZE2 + SWATCH_GAP2 + labelWidth + ENTRY_GAP2;
   }, 0);
   let rowCount = 1;
   let rowWidth = 0;
@@ -8198,15 +8295,879 @@ function computeLegend(spec, strategy, theme, chartArea) {
   };
 }
 
+// src/sankey/compile-sankey.ts
+import {
+  adaptTheme as adaptTheme2,
+  computeChrome as computeChrome3,
+  estimateTextWidth as estimateTextWidth10,
+  formatNumber as formatNumber4,
+  resolveTheme as resolveTheme2
+} from "@opendata-ai/openchart-core";
+
+// ../../node_modules/.bun/d3-array@2.12.1/node_modules/d3-array/src/max.js
+function max3(values, valueof) {
+  let max4;
+  if (valueof === void 0) {
+    for (const value2 of values) {
+      if (value2 != null && (max4 < value2 || max4 === void 0 && value2 >= value2)) {
+        max4 = value2;
+      }
+    }
+  } else {
+    let index = -1;
+    for (let value2 of values) {
+      if ((value2 = valueof(value2, ++index, values)) != null && (max4 < value2 || max4 === void 0 && value2 >= value2)) {
+        max4 = value2;
+      }
+    }
+  }
+  return max4;
+}
+
+// ../../node_modules/.bun/d3-array@2.12.1/node_modules/d3-array/src/min.js
+function min3(values, valueof) {
+  let min4;
+  if (valueof === void 0) {
+    for (const value2 of values) {
+      if (value2 != null && (min4 > value2 || min4 === void 0 && value2 >= value2)) {
+        min4 = value2;
+      }
+    }
+  } else {
+    let index = -1;
+    for (let value2 of values) {
+      if ((value2 = valueof(value2, ++index, values)) != null && (min4 > value2 || min4 === void 0 && value2 >= value2)) {
+        min4 = value2;
+      }
+    }
+  }
+  return min4;
+}
+
+// ../../node_modules/.bun/d3-array@2.12.1/node_modules/d3-array/src/sum.js
+function sum(values, valueof) {
+  let sum2 = 0;
+  if (valueof === void 0) {
+    for (let value2 of values) {
+      if (value2 = +value2) {
+        sum2 += value2;
+      }
+    }
+  } else {
+    let index = -1;
+    for (let value2 of values) {
+      if (value2 = +valueof(value2, ++index, values)) {
+        sum2 += value2;
+      }
+    }
+  }
+  return sum2;
+}
+
+// ../../node_modules/.bun/d3-sankey@0.12.3/node_modules/d3-sankey/src/align.js
+function targetDepth(d) {
+  return d.target.depth;
+}
+function left(node) {
+  return node.depth;
+}
+function right(node, n) {
+  return n - 1 - node.height;
+}
+function justify(node, n) {
+  return node.sourceLinks.length ? node.depth : n - 1;
+}
+function center(node) {
+  return node.targetLinks.length ? node.depth : node.sourceLinks.length ? min3(node.sourceLinks, targetDepth) - 1 : 0;
+}
+
+// ../../node_modules/.bun/d3-sankey@0.12.3/node_modules/d3-sankey/src/constant.js
+function constant(x2) {
+  return function() {
+    return x2;
+  };
+}
+
+// ../../node_modules/.bun/d3-sankey@0.12.3/node_modules/d3-sankey/src/sankey.js
+function ascendingSourceBreadth(a, b) {
+  return ascendingBreadth(a.source, b.source) || a.index - b.index;
+}
+function ascendingTargetBreadth(a, b) {
+  return ascendingBreadth(a.target, b.target) || a.index - b.index;
+}
+function ascendingBreadth(a, b) {
+  return a.y0 - b.y0;
+}
+function value(d) {
+  return d.value;
+}
+function defaultId(d) {
+  return d.index;
+}
+function defaultNodes(graph) {
+  return graph.nodes;
+}
+function defaultLinks(graph) {
+  return graph.links;
+}
+function find(nodeById, id) {
+  const node = nodeById.get(id);
+  if (!node) throw new Error("missing: " + id);
+  return node;
+}
+function computeLinkBreadths({ nodes }) {
+  for (const node of nodes) {
+    let y0 = node.y0;
+    let y1 = y0;
+    for (const link of node.sourceLinks) {
+      link.y0 = y0 + link.width / 2;
+      y0 += link.width;
+    }
+    for (const link of node.targetLinks) {
+      link.y1 = y1 + link.width / 2;
+      y1 += link.width;
+    }
+  }
+}
+function Sankey() {
+  let x0 = 0, y0 = 0, x1 = 1, y1 = 1;
+  let dx = 24;
+  let dy = 8, py;
+  let id = defaultId;
+  let align = justify;
+  let sort;
+  let linkSort;
+  let nodes = defaultNodes;
+  let links = defaultLinks;
+  let iterations = 6;
+  function sankey() {
+    const graph = { nodes: nodes.apply(null, arguments), links: links.apply(null, arguments) };
+    computeNodeLinks(graph);
+    computeNodeValues(graph);
+    computeNodeDepths(graph);
+    computeNodeHeights(graph);
+    computeNodeBreadths(graph);
+    computeLinkBreadths(graph);
+    return graph;
+  }
+  sankey.update = function(graph) {
+    computeLinkBreadths(graph);
+    return graph;
+  };
+  sankey.nodeId = function(_) {
+    return arguments.length ? (id = typeof _ === "function" ? _ : constant(_), sankey) : id;
+  };
+  sankey.nodeAlign = function(_) {
+    return arguments.length ? (align = typeof _ === "function" ? _ : constant(_), sankey) : align;
+  };
+  sankey.nodeSort = function(_) {
+    return arguments.length ? (sort = _, sankey) : sort;
+  };
+  sankey.nodeWidth = function(_) {
+    return arguments.length ? (dx = +_, sankey) : dx;
+  };
+  sankey.nodePadding = function(_) {
+    return arguments.length ? (dy = py = +_, sankey) : dy;
+  };
+  sankey.nodes = function(_) {
+    return arguments.length ? (nodes = typeof _ === "function" ? _ : constant(_), sankey) : nodes;
+  };
+  sankey.links = function(_) {
+    return arguments.length ? (links = typeof _ === "function" ? _ : constant(_), sankey) : links;
+  };
+  sankey.linkSort = function(_) {
+    return arguments.length ? (linkSort = _, sankey) : linkSort;
+  };
+  sankey.size = function(_) {
+    return arguments.length ? (x0 = y0 = 0, x1 = +_[0], y1 = +_[1], sankey) : [x1 - x0, y1 - y0];
+  };
+  sankey.extent = function(_) {
+    return arguments.length ? (x0 = +_[0][0], x1 = +_[1][0], y0 = +_[0][1], y1 = +_[1][1], sankey) : [[x0, y0], [x1, y1]];
+  };
+  sankey.iterations = function(_) {
+    return arguments.length ? (iterations = +_, sankey) : iterations;
+  };
+  function computeNodeLinks({ nodes: nodes2, links: links2 }) {
+    for (const [i, node] of nodes2.entries()) {
+      node.index = i;
+      node.sourceLinks = [];
+      node.targetLinks = [];
+    }
+    const nodeById = new Map(nodes2.map((d, i) => [id(d, i, nodes2), d]));
+    for (const [i, link] of links2.entries()) {
+      link.index = i;
+      let { source, target } = link;
+      if (typeof source !== "object") source = link.source = find(nodeById, source);
+      if (typeof target !== "object") target = link.target = find(nodeById, target);
+      source.sourceLinks.push(link);
+      target.targetLinks.push(link);
+    }
+    if (linkSort != null) {
+      for (const { sourceLinks, targetLinks } of nodes2) {
+        sourceLinks.sort(linkSort);
+        targetLinks.sort(linkSort);
+      }
+    }
+  }
+  function computeNodeValues({ nodes: nodes2 }) {
+    for (const node of nodes2) {
+      node.value = node.fixedValue === void 0 ? Math.max(sum(node.sourceLinks, value), sum(node.targetLinks, value)) : node.fixedValue;
+    }
+  }
+  function computeNodeDepths({ nodes: nodes2 }) {
+    const n = nodes2.length;
+    let current = new Set(nodes2);
+    let next = /* @__PURE__ */ new Set();
+    let x2 = 0;
+    while (current.size) {
+      for (const node of current) {
+        node.depth = x2;
+        for (const { target } of node.sourceLinks) {
+          next.add(target);
+        }
+      }
+      if (++x2 > n) throw new Error("circular link");
+      current = next;
+      next = /* @__PURE__ */ new Set();
+    }
+  }
+  function computeNodeHeights({ nodes: nodes2 }) {
+    const n = nodes2.length;
+    let current = new Set(nodes2);
+    let next = /* @__PURE__ */ new Set();
+    let x2 = 0;
+    while (current.size) {
+      for (const node of current) {
+        node.height = x2;
+        for (const { source } of node.targetLinks) {
+          next.add(source);
+        }
+      }
+      if (++x2 > n) throw new Error("circular link");
+      current = next;
+      next = /* @__PURE__ */ new Set();
+    }
+  }
+  function computeNodeLayers({ nodes: nodes2 }) {
+    const x2 = max3(nodes2, (d) => d.depth) + 1;
+    const kx = (x1 - x0 - dx) / (x2 - 1);
+    const columns = new Array(x2);
+    for (const node of nodes2) {
+      const i = Math.max(0, Math.min(x2 - 1, Math.floor(align.call(null, node, x2))));
+      node.layer = i;
+      node.x0 = x0 + i * kx;
+      node.x1 = node.x0 + dx;
+      if (columns[i]) columns[i].push(node);
+      else columns[i] = [node];
+    }
+    if (sort) for (const column of columns) {
+      column.sort(sort);
+    }
+    return columns;
+  }
+  function initializeNodeBreadths(columns) {
+    const ky = min3(columns, (c) => (y1 - y0 - (c.length - 1) * py) / sum(c, value));
+    for (const nodes2 of columns) {
+      let y2 = y0;
+      for (const node of nodes2) {
+        node.y0 = y2;
+        node.y1 = y2 + node.value * ky;
+        y2 = node.y1 + py;
+        for (const link of node.sourceLinks) {
+          link.width = link.value * ky;
+        }
+      }
+      y2 = (y1 - y2 + py) / (nodes2.length + 1);
+      for (let i = 0; i < nodes2.length; ++i) {
+        const node = nodes2[i];
+        node.y0 += y2 * (i + 1);
+        node.y1 += y2 * (i + 1);
+      }
+      reorderLinks(nodes2);
+    }
+  }
+  function computeNodeBreadths(graph) {
+    const columns = computeNodeLayers(graph);
+    py = Math.min(dy, (y1 - y0) / (max3(columns, (c) => c.length) - 1));
+    initializeNodeBreadths(columns);
+    for (let i = 0; i < iterations; ++i) {
+      const alpha = Math.pow(0.99, i);
+      const beta = Math.max(1 - alpha, (i + 1) / iterations);
+      relaxRightToLeft(columns, alpha, beta);
+      relaxLeftToRight(columns, alpha, beta);
+    }
+  }
+  function relaxLeftToRight(columns, alpha, beta) {
+    for (let i = 1, n = columns.length; i < n; ++i) {
+      const column = columns[i];
+      for (const target of column) {
+        let y2 = 0;
+        let w = 0;
+        for (const { source, value: value2 } of target.targetLinks) {
+          let v = value2 * (target.layer - source.layer);
+          y2 += targetTop(source, target) * v;
+          w += v;
+        }
+        if (!(w > 0)) continue;
+        let dy2 = (y2 / w - target.y0) * alpha;
+        target.y0 += dy2;
+        target.y1 += dy2;
+        reorderNodeLinks(target);
+      }
+      if (sort === void 0) column.sort(ascendingBreadth);
+      resolveCollisions6(column, beta);
+    }
+  }
+  function relaxRightToLeft(columns, alpha, beta) {
+    for (let n = columns.length, i = n - 2; i >= 0; --i) {
+      const column = columns[i];
+      for (const source of column) {
+        let y2 = 0;
+        let w = 0;
+        for (const { target, value: value2 } of source.sourceLinks) {
+          let v = value2 * (target.layer - source.layer);
+          y2 += sourceTop(source, target) * v;
+          w += v;
+        }
+        if (!(w > 0)) continue;
+        let dy2 = (y2 / w - source.y0) * alpha;
+        source.y0 += dy2;
+        source.y1 += dy2;
+        reorderNodeLinks(source);
+      }
+      if (sort === void 0) column.sort(ascendingBreadth);
+      resolveCollisions6(column, beta);
+    }
+  }
+  function resolveCollisions6(nodes2, alpha) {
+    const i = nodes2.length >> 1;
+    const subject = nodes2[i];
+    resolveCollisionsBottomToTop(nodes2, subject.y0 - py, i - 1, alpha);
+    resolveCollisionsTopToBottom(nodes2, subject.y1 + py, i + 1, alpha);
+    resolveCollisionsBottomToTop(nodes2, y1, nodes2.length - 1, alpha);
+    resolveCollisionsTopToBottom(nodes2, y0, 0, alpha);
+  }
+  function resolveCollisionsTopToBottom(nodes2, y2, i, alpha) {
+    for (; i < nodes2.length; ++i) {
+      const node = nodes2[i];
+      const dy2 = (y2 - node.y0) * alpha;
+      if (dy2 > 1e-6) node.y0 += dy2, node.y1 += dy2;
+      y2 = node.y1 + py;
+    }
+  }
+  function resolveCollisionsBottomToTop(nodes2, y2, i, alpha) {
+    for (; i >= 0; --i) {
+      const node = nodes2[i];
+      const dy2 = (node.y1 - y2) * alpha;
+      if (dy2 > 1e-6) node.y0 -= dy2, node.y1 -= dy2;
+      y2 = node.y0 - py;
+    }
+  }
+  function reorderNodeLinks({ sourceLinks, targetLinks }) {
+    if (linkSort === void 0) {
+      for (const { source: { sourceLinks: sourceLinks2 } } of targetLinks) {
+        sourceLinks2.sort(ascendingTargetBreadth);
+      }
+      for (const { target: { targetLinks: targetLinks2 } } of sourceLinks) {
+        targetLinks2.sort(ascendingSourceBreadth);
+      }
+    }
+  }
+  function reorderLinks(nodes2) {
+    if (linkSort === void 0) {
+      for (const { sourceLinks, targetLinks } of nodes2) {
+        sourceLinks.sort(ascendingTargetBreadth);
+        targetLinks.sort(ascendingSourceBreadth);
+      }
+    }
+  }
+  function targetTop(source, target) {
+    let y2 = source.y0 - (source.sourceLinks.length - 1) * py / 2;
+    for (const { target: node, width } of source.sourceLinks) {
+      if (node === target) break;
+      y2 += width + py;
+    }
+    for (const { source: node, width } of target.targetLinks) {
+      if (node === source) break;
+      y2 -= width;
+    }
+    return y2;
+  }
+  function sourceTop(source, target) {
+    let y2 = target.y0 - (target.targetLinks.length - 1) * py / 2;
+    for (const { source: node, width } of target.targetLinks) {
+      if (node === source) break;
+      y2 += width + py;
+    }
+    for (const { target: node, width } of source.sourceLinks) {
+      if (node === target) break;
+      y2 -= width;
+    }
+    return y2;
+  }
+  return sankey;
+}
+
+// src/sankey/layout.ts
+var ALIGN_MAP = {
+  justify,
+  left,
+  right,
+  center
+};
+function computeSankeyLayout(data, sourceField, targetField, valueField, area, nodeWidth, nodePadding, nodeAlign, iterations) {
+  const nodeSet = /* @__PURE__ */ new Set();
+  for (const row of data) {
+    nodeSet.add(String(row[sourceField]));
+    nodeSet.add(String(row[targetField]));
+  }
+  const nodes = [...nodeSet].map((id) => ({
+    id,
+    label: id
+  }));
+  const links = data.map((row) => ({
+    source: String(row[sourceField]),
+    target: String(row[targetField]),
+    value: Number(row[valueField]) || 0,
+    data: { ...row }
+  }));
+  const alignFn = ALIGN_MAP[nodeAlign] ?? justify;
+  const generator = Sankey().nodeId((d) => d.id).nodeAlign(alignFn).nodeWidth(nodeWidth).nodePadding(nodePadding).extent([
+    [area.x, area.y],
+    [area.x + area.width, area.y + area.height]
+  ]).iterations(iterations);
+  const graph = generator({
+    nodes,
+    links
+  });
+  return {
+    nodes: graph.nodes,
+    links: graph.links
+  };
+}
+function generateLinkPath(link) {
+  const source = link.source;
+  const target = link.target;
+  const x0 = source.x1 ?? 0;
+  const x1 = target.x0 ?? 0;
+  const y0 = link.y0 ?? 0;
+  const y1 = link.y1 ?? 0;
+  const halfWidth0 = (link.width ?? 0) / 2;
+  const halfWidth1 = halfWidth0;
+  const mx = (x0 + x1) / 2;
+  const topY0 = y0 - halfWidth0;
+  const topY1 = y1 - halfWidth1;
+  const botY0 = y0 + halfWidth0;
+  const botY1 = y1 + halfWidth1;
+  return [
+    `M${x0},${topY0}`,
+    `C${mx},${topY0} ${mx},${topY1} ${x1},${topY1}`,
+    `L${x1},${botY1}`,
+    `C${mx},${botY1} ${mx},${botY0} ${x0},${botY0}`,
+    "Z"
+  ].join(" ");
+}
+
+// src/sankey/compile-sankey.ts
+var SWATCH_SIZE3 = 12;
+var SWATCH_GAP3 = 6;
+var ENTRY_GAP3 = 16;
+var LABEL_GAP = 6;
+var LINK_OPACITY = 0.35;
+var NODE_CORNER_RADIUS = 2;
+function pickColor(palette, index) {
+  return palette[index % palette.length];
+}
+function buildNodeColorMap(nodes, palette, colorField, data, sourceField, targetField) {
+  const colorMap = /* @__PURE__ */ new Map();
+  if (colorField) {
+    const nodeCategoryMap = /* @__PURE__ */ new Map();
+    for (const row of data) {
+      const src = String(row[sourceField]);
+      const tgt = String(row[targetField]);
+      const cat = String(row[colorField]);
+      if (!nodeCategoryMap.has(src)) nodeCategoryMap.set(src, cat);
+      if (!nodeCategoryMap.has(tgt)) nodeCategoryMap.set(tgt, cat);
+    }
+    const categoryIndex = /* @__PURE__ */ new Map();
+    let nextIdx = 0;
+    for (const node of nodes) {
+      const category = nodeCategoryMap.get(node.id) ?? node.id;
+      if (!categoryIndex.has(category)) {
+        categoryIndex.set(category, nextIdx++);
+      }
+      colorMap.set(node.id, pickColor(palette, categoryIndex.get(category)));
+    }
+  } else {
+    for (let i = 0; i < nodes.length; i++) {
+      colorMap.set(nodes[i].id, pickColor(palette, i));
+    }
+  }
+  return colorMap;
+}
+function getLinkColors(linkStyle, sourceColor, targetColor, neutralColor) {
+  switch (linkStyle) {
+    case "source":
+      return { sourceColor, targetColor: sourceColor };
+    case "target":
+      return { sourceColor: targetColor, targetColor };
+    case "neutral":
+      return { sourceColor: neutralColor, targetColor: neutralColor };
+    default:
+      return { sourceColor, targetColor };
+  }
+}
+function computeNodeLabel(node, maxDepth, theme, nodeWidth) {
+  const depth = node.depth ?? 0;
+  const isRightmost = depth === maxDepth;
+  const style = {
+    fontFamily: theme.fonts.family,
+    fontSize: theme.fonts.sizes.small,
+    fontWeight: theme.fonts.weights.normal,
+    fill: theme.colors.text,
+    lineHeight: 1.3
+  };
+  const x0 = node.x0 ?? 0;
+  const x1 = node.x1 ?? nodeWidth;
+  const y0 = node.y0 ?? 0;
+  const y1 = node.y1 ?? 0;
+  const midY = (y0 + y1) / 2;
+  if (isRightmost) {
+    return {
+      text: node.label ?? node.id,
+      x: x0 - LABEL_GAP,
+      y: midY,
+      style: { ...style, textAnchor: "end", dominantBaseline: "central" },
+      visible: true
+    };
+  }
+  return {
+    text: node.label ?? node.id,
+    x: x1 + LABEL_GAP,
+    y: midY,
+    style: { ...style, textAnchor: "start", dominantBaseline: "central" },
+    visible: true
+  };
+}
+function compileSankey(spec, options) {
+  const { spec: normalized } = compile(spec);
+  if (!("type" in normalized) || normalized.type !== "sankey") {
+    throw new Error(
+      "compileSankey received a non-sankey spec. Use compileChart, compileTable, or compileGraph instead."
+    );
+  }
+  const sankeySpec = normalized;
+  const mergedThemeConfig = options.theme ? { ...sankeySpec.theme, ...options.theme } : sankeySpec.theme;
+  let theme = resolveTheme2(mergedThemeConfig);
+  if (options.darkMode) {
+    theme = adaptTheme2(theme);
+  }
+  const chrome = computeChrome3(
+    {
+      title: sankeySpec.chrome.title,
+      subtitle: sankeySpec.chrome.subtitle,
+      source: sankeySpec.chrome.source,
+      byline: sankeySpec.chrome.byline,
+      footer: sankeySpec.chrome.footer
+    },
+    theme,
+    options.width,
+    options.measureText
+  );
+  const padding = theme.spacing.padding;
+  const fullArea = {
+    x: padding,
+    y: padding + chrome.topHeight,
+    width: options.width - padding * 2,
+    height: options.height - chrome.topHeight - chrome.bottomHeight - padding * 2
+  };
+  if (fullArea.width <= 0 || fullArea.height <= 0) {
+    return emptyLayout(fullArea, chrome, theme, options);
+  }
+  const sourceField = sankeySpec.encoding.source.field;
+  const targetField = sankeySpec.encoding.target.field;
+  const valueField = sankeySpec.encoding.value.field;
+  const colorField = sankeySpec.encoding.color?.field;
+  const tempNodeIds = /* @__PURE__ */ new Set();
+  for (const row of sankeySpec.data) {
+    tempNodeIds.add(String(row[sourceField]));
+    tempNodeIds.add(String(row[targetField]));
+  }
+  const tempColorMap = buildNodeColorMap(
+    [...tempNodeIds].map((id) => ({ id })),
+    theme.colors.categorical,
+    colorField,
+    sankeySpec.data,
+    sourceField,
+    targetField
+  );
+  const legend = buildSankeyLegend(
+    tempColorMap,
+    colorField,
+    sankeySpec.data,
+    sourceField,
+    targetField,
+    theme,
+    fullArea
+  );
+  const legendGap = legend.entries.length > 0 ? 4 : 0;
+  const area = {
+    x: fullArea.x,
+    y: fullArea.y + legend.bounds.height + legendGap,
+    width: fullArea.width,
+    height: fullArea.height - legend.bounds.height - legendGap
+  };
+  if (area.height <= 0) {
+    return emptyLayout(area, chrome, theme, options);
+  }
+  const { nodes, links } = computeSankeyLayout(
+    sankeySpec.data,
+    sourceField,
+    targetField,
+    valueField,
+    area,
+    sankeySpec.nodeWidth,
+    sankeySpec.nodePadding,
+    sankeySpec.nodeAlign,
+    sankeySpec.iterations
+  );
+  const nodeColorMap = buildNodeColorMap(
+    nodes,
+    theme.colors.categorical,
+    colorField,
+    sankeySpec.data,
+    sourceField,
+    targetField
+  );
+  const maxDepth = nodes.reduce((max4, n) => Math.max(max4, n.depth ?? 0), 0);
+  const nodeMarks = nodes.map((node) => {
+    const fill = nodeColorMap.get(node.id) ?? theme.colors.categorical[0];
+    const depth = node.depth ?? 0;
+    return {
+      type: "sankeyNode",
+      x: node.x0 ?? 0,
+      y: node.y0 ?? 0,
+      width: (node.x1 ?? 0) - (node.x0 ?? 0),
+      height: (node.y1 ?? 0) - (node.y0 ?? 0),
+      fill,
+      cornerRadius: NODE_CORNER_RADIUS,
+      label: computeNodeLabel(node, maxDepth, theme, sankeySpec.nodeWidth),
+      nodeId: node.id,
+      value: node.value ?? 0,
+      depth,
+      data: { id: node.id, label: node.label },
+      aria: {
+        role: "img",
+        label: `${node.label}: ${formatNumber4(node.value ?? 0)}`
+      },
+      animationIndex: 0
+      // Reassigned below after sorting by depth
+    };
+  });
+  nodeMarks.sort((a, b) => a.depth - b.depth || a.y - b.y);
+  for (let i = 0; i < nodeMarks.length; i++) {
+    nodeMarks[i].animationIndex = i;
+  }
+  const neutralColor = theme.colors.gridline;
+  const linkMarks = links.map((link, i) => {
+    const sourceNode = link.source;
+    const targetNode = link.target;
+    const srcColor = nodeColorMap.get(sourceNode.id) ?? theme.colors.categorical[0];
+    const tgtColor = nodeColorMap.get(targetNode.id) ?? theme.colors.categorical[0];
+    const colors = getLinkColors(sankeySpec.linkStyle, srcColor, tgtColor, neutralColor);
+    return {
+      type: "sankeyLink",
+      path: generateLinkPath(link),
+      sourceColor: colors.sourceColor,
+      targetColor: colors.targetColor,
+      fillOpacity: LINK_OPACITY,
+      sourceId: sourceNode.id,
+      targetId: targetNode.id,
+      width: link.width ?? 0,
+      value: link.value,
+      data: link.data ?? {},
+      aria: {
+        role: "img",
+        label: `${sourceNode.label} to ${targetNode.label}: ${formatNumber4(link.value)}`
+      },
+      // Links animate after nodes
+      animationIndex: nodeMarks.length + i
+    };
+  });
+  const finalLegend = buildSankeyLegend(
+    nodeColorMap,
+    colorField,
+    sankeySpec.data,
+    sourceField,
+    targetField,
+    theme,
+    fullArea
+  );
+  const tooltipDescriptors = buildTooltipDescriptors(nodeMarks, linkMarks);
+  const a11y = {
+    altText: `Sankey diagram with ${nodeMarks.length} nodes and ${linkMarks.length} links`,
+    dataTableFallback: linkMarks.map((l) => [l.sourceId, l.targetId, String(l.value)]),
+    role: "img",
+    keyboardNavigable: nodeMarks.length > 0
+  };
+  const resolvedAnimation = resolveAnimation(sankeySpec.animation);
+  return {
+    area,
+    chrome,
+    nodes: nodeMarks,
+    links: linkMarks,
+    legend: finalLegend,
+    tooltipDescriptors,
+    a11y,
+    theme,
+    dimensions: {
+      width: options.width,
+      height: options.height
+    },
+    animation: resolvedAnimation
+  };
+}
+function buildSankeyLegend(nodeColorMap, colorField, data, sourceField, targetField, theme, area) {
+  const labelStyle = {
+    fontFamily: theme.fonts.family,
+    fontSize: theme.fonts.sizes.small,
+    fontWeight: theme.fonts.weights.normal,
+    fill: theme.colors.text,
+    lineHeight: 1.3
+  };
+  let entries;
+  if (colorField) {
+    const categoryColors = /* @__PURE__ */ new Map();
+    const nodeCategoryMap = /* @__PURE__ */ new Map();
+    for (const row of data) {
+      const src = String(row[sourceField]);
+      const tgt = String(row[targetField]);
+      const cat = String(row[colorField]);
+      if (!nodeCategoryMap.has(src)) nodeCategoryMap.set(src, cat);
+      if (!nodeCategoryMap.has(tgt)) nodeCategoryMap.set(tgt, cat);
+    }
+    for (const [nodeId, category] of nodeCategoryMap) {
+      if (!categoryColors.has(category)) {
+        categoryColors.set(category, nodeColorMap.get(nodeId) ?? theme.colors.categorical[0]);
+      }
+    }
+    entries = [...categoryColors.entries()].map(([label, color2]) => ({
+      label,
+      color: color2,
+      shape: "square",
+      active: true
+    }));
+  } else {
+    entries = [];
+  }
+  let bounds = { x: 0, y: 0, width: 0, height: 0 };
+  if (entries.length > 0) {
+    const ROW_HEIGHT = SWATCH_SIZE3 + 4;
+    const availableWidth = area.width;
+    let rowCount = 1;
+    let rowX = 0;
+    for (const entry of entries) {
+      const labelWidth = estimateTextWidth10(entry.label, labelStyle.fontSize, labelStyle.fontWeight);
+      const entryWidth = SWATCH_SIZE3 + SWATCH_GAP3 + labelWidth + ENTRY_GAP3;
+      if (rowX > 0 && rowX + entryWidth > availableWidth) {
+        rowCount++;
+        rowX = entryWidth;
+      } else {
+        rowX += entryWidth;
+      }
+    }
+    rowCount = Math.min(rowCount, 2);
+    const legendHeight = rowCount * ROW_HEIGHT;
+    bounds = {
+      x: area.x,
+      y: area.y,
+      width: availableWidth,
+      height: legendHeight
+    };
+  }
+  return {
+    position: "top",
+    entries,
+    bounds,
+    labelStyle,
+    swatchSize: SWATCH_SIZE3,
+    swatchGap: SWATCH_GAP3,
+    entryGap: ENTRY_GAP3
+  };
+}
+function buildTooltipDescriptors(nodes, links) {
+  const descriptors = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const fields = [
+      {
+        label: "Total flow",
+        value: formatNumber4(node.value)
+      }
+    ];
+    descriptors.set(`node-${node.nodeId}`, {
+      title: node.label.text,
+      fields
+    });
+  }
+  for (const link of links) {
+    const fields = [
+      {
+        label: "Flow",
+        value: formatNumber4(link.value)
+      }
+    ];
+    descriptors.set(`link-${link.sourceId}-${link.targetId}`, {
+      title: `${link.sourceId} \u2192 ${link.targetId}`,
+      fields
+    });
+  }
+  return descriptors;
+}
+function emptyLayout(area, chrome, theme, options) {
+  return {
+    area,
+    chrome,
+    nodes: [],
+    links: [],
+    legend: {
+      position: "top",
+      entries: [],
+      bounds: { x: 0, y: 0, width: 0, height: 0 },
+      labelStyle: {
+        fontFamily: theme.fonts.family,
+        fontSize: theme.fonts.sizes.small,
+        fontWeight: theme.fonts.weights.normal,
+        fill: theme.colors.text,
+        lineHeight: 1.3
+      },
+      swatchSize: SWATCH_SIZE3,
+      swatchGap: SWATCH_GAP3,
+      entryGap: ENTRY_GAP3
+    },
+    tooltipDescriptors: /* @__PURE__ */ new Map(),
+    a11y: {
+      altText: "Empty sankey diagram",
+      dataTableFallback: [],
+      role: "img",
+      keyboardNavigable: false
+    },
+    theme,
+    dimensions: {
+      width: options.width,
+      height: options.height
+    }
+  };
+}
+
 // src/tables/compile-table.ts
-import { computeChrome as computeChrome3, estimateTextWidth as estimateTextWidth10 } from "@opendata-ai/openchart-core";
+import { computeChrome as computeChrome4, estimateTextWidth as estimateTextWidth11 } from "@opendata-ai/openchart-core";
 
 // src/tables/bar-column.ts
 var NEGATIVE_BAR_COLOR = "#c44e52";
-function computeBarCell(value, config, columnMax, columnMin, theme, _darkMode) {
+function computeBarCell(value2, config, columnMax, columnMin, theme, _darkMode) {
   const barColor = config.color ?? theme.colors.categorical[0];
   const hasNegatives = columnMin < 0;
-  if (!Number.isFinite(value)) {
+  if (!Number.isFinite(value2)) {
     return { barPercent: 0, barOffset: 0, barColor, isNegative: false };
   }
   if (!hasNegatives) {
@@ -8214,7 +9175,7 @@ function computeBarCell(value, config, columnMax, columnMin, theme, _darkMode) {
     if (maxValue <= 0) {
       return { barPercent: 0, barOffset: 0, barColor, isNegative: false };
     }
-    const barPercent2 = Math.max(0, Math.min(1, value / maxValue));
+    const barPercent2 = Math.max(0, Math.min(1, value2 / maxValue));
     return { barPercent: barPercent2, barOffset: 0, barColor, isNegative: false };
   }
   const maxPos = config.maxValue ?? columnMax;
@@ -8224,11 +9185,11 @@ function computeBarCell(value, config, columnMax, columnMin, theme, _darkMode) {
     return { barPercent: 0, barOffset: 0, barColor, isNegative: false };
   }
   const zeroPos = absMin / totalRange;
-  if (value >= 0) {
-    const barPercent2 = value / totalRange;
+  if (value2 >= 0) {
+    const barPercent2 = value2 / totalRange;
     return { barPercent: barPercent2, barOffset: zeroPos, barColor, isNegative: false };
   }
-  const barPercent = Math.abs(value) / totalRange;
+  const barPercent = Math.abs(value2) / totalRange;
   return {
     barPercent,
     barOffset: zeroPos - barPercent,
@@ -8237,24 +9198,24 @@ function computeBarCell(value, config, columnMax, columnMin, theme, _darkMode) {
   };
 }
 function computeColumnMax(data, key) {
-  let max3 = 0;
+  let max4 = 0;
   for (const row of data) {
     const val = row[key];
-    if (typeof val === "number" && Number.isFinite(val) && val > max3) {
-      max3 = val;
+    if (typeof val === "number" && Number.isFinite(val) && val > max4) {
+      max4 = val;
     }
   }
-  return max3;
+  return max4;
 }
 function computeColumnMin(data, key) {
-  let min3 = 0;
+  let min4 = 0;
   for (const row of data) {
     const val = row[key];
-    if (typeof val === "number" && Number.isFinite(val) && val < min3) {
-      min3 = val;
+    if (typeof val === "number" && Number.isFinite(val) && val < min4) {
+      min4 = val;
     }
   }
-  return min3;
+  return min4;
 }
 
 // src/tables/category-colors.ts
@@ -8307,67 +9268,67 @@ function computeCategoryColors(data, column, theme, darkMode) {
 }
 
 // src/tables/format-cells.ts
-import { formatDate as formatDate2, formatNumber as formatNumber4 } from "@opendata-ai/openchart-core";
-function isNumericValue(value) {
-  if (typeof value === "number") return Number.isFinite(value);
+import { formatDate as formatDate2, formatNumber as formatNumber5 } from "@opendata-ai/openchart-core";
+function isNumericValue(value2) {
+  if (typeof value2 === "number") return Number.isFinite(value2);
   return false;
 }
-function isDateValue(value) {
-  if (value instanceof Date) return !Number.isNaN(value.getTime());
+function isDateValue(value2) {
+  if (value2 instanceof Date) return !Number.isNaN(value2.getTime());
   return false;
 }
-function formatCell(value, column) {
+function formatCell(value2, column) {
   const style = {};
-  if (value == null) {
+  if (value2 == null) {
     return {
-      value,
+      value: value2,
       formattedValue: "",
       style
     };
   }
-  if (column.format && isNumericValue(value)) {
+  if (column.format && isNumericValue(value2)) {
     try {
       const formatter = format(column.format);
       return {
-        value,
-        formattedValue: formatter(value),
+        value: value2,
+        formattedValue: formatter(value2),
         style
       };
     } catch {
     }
   }
-  if (isNumericValue(value)) {
+  if (isNumericValue(value2)) {
     return {
-      value,
-      formattedValue: formatNumber4(value),
+      value: value2,
+      formattedValue: formatNumber5(value2),
       style
     };
   }
-  if (isDateValue(value)) {
+  if (isDateValue(value2)) {
     return {
-      value,
-      formattedValue: formatDate2(value),
+      value: value2,
+      formattedValue: formatDate2(value2),
       style
     };
   }
   return {
-    value,
-    formattedValue: String(value),
+    value: value2,
+    formattedValue: String(value2),
     style
   };
 }
-function formatValueForSearch(value, column) {
-  if (value == null) return "";
-  if (column.format && isNumericValue(value)) {
+function formatValueForSearch(value2, column) {
+  if (value2 == null) return "";
+  if (column.format && isNumericValue(value2)) {
     try {
-      return format(column.format)(value);
+      return format(column.format)(value2);
     } catch {
     }
   }
-  if (isNumericValue(value)) {
-    return formatNumber4(value);
+  if (isNumericValue(value2)) {
+    return formatNumber5(value2);
   }
-  return String(value);
+  return String(value2);
 }
 
 // src/tables/heatmap.ts
@@ -8412,13 +9373,13 @@ function computeHeatmapColors(data, column, theme, darkMode) {
   if (config.domain) {
     domain = config.domain;
   } else {
-    let min3 = Infinity;
-    let max3 = -Infinity;
-    for (const { value } of numericValues) {
-      if (value < min3) min3 = value;
-      if (value > max3) max3 = value;
+    let min4 = Infinity;
+    let max4 = -Infinity;
+    for (const { value: value2 } of numericValues) {
+      if (value2 < min4) min4 = value2;
+      if (value2 > max4) max4 = value2;
     }
-    domain = [min3, max3];
+    domain = [min4, max4];
   }
   let stops = resolvePalette(config.palette, theme);
   if (darkMode) {
@@ -8428,8 +9389,8 @@ function computeHeatmapColors(data, column, theme, darkMode) {
   }
   const interpolator = interpolatorFromStops(stops);
   const scale = sequential(interpolator).domain(domain).clamp(true);
-  for (const { index, value } of numericValues) {
-    const bg = scale(value);
+  for (const { index, value: value2 } of numericValues) {
+    const bg = scale(value2);
     const textColor = accessibleTextColor(bg);
     result.set(index, {
       backgroundColor: bg,
@@ -8534,14 +9495,14 @@ function computeSparkline(values, config, theme, _darkMode) {
   if (values.length === 0) return null;
   const type = config.type ?? "line";
   const color2 = config.color ?? theme.colors.categorical[0];
-  let min3 = Infinity;
-  let max3 = -Infinity;
+  let min4 = Infinity;
+  let max4 = -Infinity;
   for (const v of values) {
-    if (v < min3) min3 = v;
-    if (v > max3) max3 = v;
+    if (v < min4) min4 = v;
+    if (v > max4) max4 = v;
   }
-  const range2 = max3 - min3;
-  const normalize2 = (v) => range2 === 0 ? 0.5 : (v - min3) / range2;
+  const range2 = max4 - min4;
+  const normalize2 = (v) => range2 === 0 ? 0.5 : (v - min4) / range2;
   const startValue = values[0];
   const endValue = values[values.length - 1];
   if (type === "line") {
@@ -8606,13 +9567,13 @@ function estimateColumnWidth(col, data, fontSize) {
   if (col.image) return (col.image.width ?? 24) + PADDING;
   if (col.flag) return 60;
   const label = col.label ?? col.key;
-  const headerWidth = estimateTextWidth10(label, fontSize, 600) + PADDING;
+  const headerWidth = estimateTextWidth11(label, fontSize, 600) + PADDING;
   const sampleSize = Math.min(100, data.length);
   let maxDataWidth = 0;
   for (let i = 0; i < sampleSize; i++) {
     const val = data[i][col.key];
     const text = val == null ? "" : String(val);
-    const width = estimateTextWidth10(text, fontSize, 400) + PADDING;
+    const width = estimateTextWidth11(text, fontSize, 400) + PADDING;
     if (width > maxDataWidth) maxDataWidth = width;
   }
   return Math.max(MIN_WIDTH, headerWidth, maxDataWidth);
@@ -8632,8 +9593,8 @@ function resolveColumns(columns, data, totalWidth, theme) {
     }
     return estimateColumnWidth(col, data, fontSize);
   });
-  const fixedTotal = naturalWidths.reduce((sum, w, i) => sum + (isFixed[i] ? w : 0), 0);
-  const flexTotal = naturalWidths.reduce((sum, w, i) => sum + (isFixed[i] ? 0 : w), 0);
+  const fixedTotal = naturalWidths.reduce((sum2, w, i) => sum2 + (isFixed[i] ? w : 0), 0);
+  const flexTotal = naturalWidths.reduce((sum2, w, i) => sum2 + (isFixed[i] ? 0 : w), 0);
   const remainingWidth = totalWidth - fixedTotal;
   const flexScale = flexTotal > 0 && remainingWidth > 0 ? remainingWidth / flexTotal : 1;
   return columns.map((col, i) => ({
@@ -8645,9 +9606,9 @@ function resolveColumns(columns, data, totalWidth, theme) {
     cellType: determineCellType(col)
   }));
 }
-function buildCell(value, column, resolvedColumn, heatmapStyle, categoryStyle, barData, sparklineData) {
-  const base = formatCell(value, column);
-  if (typeof value === "number") {
+function buildCell(value2, column, resolvedColumn, heatmapStyle, categoryStyle, barData, sparklineData) {
+  const base = formatCell(value2, column);
+  if (typeof value2 === "number") {
     base.style = { ...base.style, fontVariant: "tabular-nums" };
   }
   const cellType = resolvedColumn.cellType;
@@ -8686,7 +9647,7 @@ function buildCell(value, column, resolvedColumn, heatmapStyle, categoryStyle, b
       };
     }
     case "image": {
-      const src = typeof value === "string" ? value : "";
+      const src = typeof value2 === "string" ? value2 : "";
       const imgConfig = column.image ?? {};
       return {
         ...base,
@@ -8698,7 +9659,7 @@ function buildCell(value, column, resolvedColumn, heatmapStyle, categoryStyle, b
       };
     }
     case "flag": {
-      const code = typeof value === "string" ? value : "";
+      const code = typeof value2 === "string" ? value2 : "";
       return {
         ...base,
         cellType: "flag",
@@ -8773,13 +9734,13 @@ function compileTableLayout(spec, options, theme) {
     const rowId = spec.rowKey ? String(row[spec.rowKey] ?? origIdx) : String(origIdx);
     const cells = spec.columns.map((col, c) => {
       const resolved = resolvedColumns[c];
-      const value = row[col.key];
+      const value2 = row[col.key];
       const heatmapStyle = heatmapMaps.get(col.key)?.get(origIdx);
       const categoryStyle = categoryMaps.get(col.key)?.get(origIdx);
       let barData;
-      if (resolved.cellType === "bar" && col.bar && typeof value === "number") {
+      if (resolved.cellType === "bar" && col.bar && typeof value2 === "number") {
         barData = computeBarCell(
-          value,
+          value2,
           col.bar,
           barMaxes.get(col.key) ?? 0,
           barMins.get(col.key) ?? 0,
@@ -8791,11 +9752,11 @@ function compileTableLayout(spec, options, theme) {
       if (resolved.cellType === "sparkline" && col.sparkline) {
         sparklineData = computeSparklineForRow(row, col.key, col.sparkline, theme, darkMode);
       }
-      return buildCell(value, col, resolved, heatmapStyle, categoryStyle, barData, sparklineData);
+      return buildCell(value2, col, resolved, heatmapStyle, categoryStyle, barData, sparklineData);
     });
     return { id: rowId, cells, data: row };
   });
-  const chrome = computeChrome3(
+  const chrome = computeChrome4(
     {
       title: spec.chrome.title,
       subtitle: spec.chrome.subtitle,
@@ -8832,25 +9793,25 @@ function compileTableLayout(spec, options, theme) {
 }
 
 // src/tooltips/compute.ts
-import { buildTemporalFormatter as buildTemporalFormatter2, formatDate as formatDate3, formatNumber as formatNumber5 } from "@opendata-ai/openchart-core";
-function formatValue(value, fieldType, format2) {
-  if (value == null) return "";
-  if (fieldType === "temporal" || value instanceof Date) {
+import { buildTemporalFormatter as buildTemporalFormatter2, formatDate as formatDate3, formatNumber as formatNumber6 } from "@opendata-ai/openchart-core";
+function formatValue(value2, fieldType, format2) {
+  if (value2 == null) return "";
+  if (fieldType === "temporal" || value2 instanceof Date) {
     const temporalFmt = buildTemporalFormatter2(format2);
-    if (temporalFmt) return temporalFmt(value);
-    return formatDate3(value);
+    if (temporalFmt) return temporalFmt(value2);
+    return formatDate3(value2);
   }
-  if (typeof value === "number") {
+  if (typeof value2 === "number") {
     if (format2) {
       try {
-        return format(format2)(value);
+        return format(format2)(value2);
       } catch {
-        return formatNumber5(value);
+        return formatNumber6(value2);
       }
     }
-    return formatNumber5(value);
+    return formatNumber6(value2);
   }
-  return String(value);
+  return String(value2);
 }
 function buildExplicitTooltipFields(row, channels) {
   return channels.map((ch) => ({
@@ -9015,16 +9976,16 @@ function runBin(data, transform) {
   const field = transform.field;
   let extent2 = params.extent;
   if (!extent2) {
-    let min3 = Infinity;
-    let max3 = -Infinity;
+    let min4 = Infinity;
+    let max4 = -Infinity;
     for (const row of data) {
       const v = Number(row[field]);
       if (Number.isFinite(v)) {
-        if (v < min3) min3 = v;
-        if (v > max3) max3 = v;
+        if (v < min4) min4 = v;
+        if (v > max4) max4 = v;
       }
     }
-    extent2 = [min3 === Infinity ? 0 : min3, max3 === -Infinity ? 0 : max3];
+    extent2 = [min4 === Infinity ? 0 : min4, max4 === -Infinity ? 0 : max4];
   }
   const step = params.step ?? computeStep(extent2, maxbins, nice2);
   const [startAs, endAs] = Array.isArray(transform.as) ? transform.as : [transform.as, void 0];
@@ -9131,10 +10092,10 @@ function extractTimeUnit(date2, unit2) {
       return `${String(date2.getHours()).padStart(2, "0")}:${String(date2.getMinutes()).padStart(2, "0")}`;
   }
 }
-function toDate(value) {
-  if (value instanceof Date) return value;
-  if (typeof value === "string" || typeof value === "number") {
-    const d = new Date(value);
+function toDate(value2) {
+  if (value2 instanceof Date) return value2;
+  if (typeof value2 === "string" || typeof value2 === "number") {
+    const d = new Date(value2);
     return Number.isNaN(d.getTime()) ? null : d;
   }
   return null;
@@ -9218,28 +10179,28 @@ function computeBandRowObstacles(marks, scales) {
   const rows = /* @__PURE__ */ new Map();
   for (const mark of marks) {
     let cy;
-    let left;
-    let right;
+    let left2;
+    let right2;
     if (mark.type === "point") {
       const pm = mark;
       cy = pm.cy;
-      left = pm.cx - pm.r;
-      right = pm.cx + pm.r;
+      left2 = pm.cx - pm.r;
+      right2 = pm.cx + pm.r;
     } else if (mark.type === "rect") {
       const rm = mark;
       cy = rm.y + rm.height / 2;
-      left = rm.x;
-      right = rm.x + rm.width;
+      left2 = rm.x;
+      right2 = rm.x + rm.width;
     } else {
       continue;
     }
     const key = Math.round(cy);
     const existing = rows.get(key);
     if (existing) {
-      existing.minX = Math.min(existing.minX, left);
-      existing.maxX = Math.max(existing.maxX, right);
+      existing.minX = Math.min(existing.minX, left2);
+      existing.maxX = Math.max(existing.maxX, right2);
     } else {
-      rows.set(key, { minX: left, maxX: right, bandY: cy });
+      rows.set(key, { minX: left2, maxX: right2, bandY: cy });
     }
   }
   const bandScale = scales.y.scale;
@@ -9264,6 +10225,9 @@ function compileChart(spec, options) {
   if ("type" in normalized && normalized.type === "graph") {
     throw new Error("compileChart received a graph spec. Use compileGraph instead.");
   }
+  if ("type" in normalized && normalized.type === "sankey") {
+    throw new Error("compileChart received a sankey spec. Use compileSankey instead.");
+  }
   let chartSpec = normalized;
   const rawTransforms = spec.transform;
   if (rawTransforms && rawTransforms.length > 0) {
@@ -9313,9 +10277,9 @@ function compileChart(spec, options) {
   const rawAnimationSpec = overrides?.[breakpoint]?.animation ?? rawSpec.animation;
   const resolvedAnimation = resolveAnimation(rawAnimationSpec);
   const mergedThemeConfig = options.theme ? { ...chartSpec.theme, ...options.theme } : chartSpec.theme;
-  let theme = resolveTheme2(mergedThemeConfig);
+  let theme = resolveTheme3(mergedThemeConfig);
   if (options.darkMode) {
-    theme = adaptTheme2(theme);
+    theme = adaptTheme3(theme);
   }
   const preliminaryArea = {
     x: 0,
@@ -9577,15 +10541,18 @@ function compileTable(spec, options) {
   }
   const tableSpec = normalized;
   const mergedThemeConfig = options.theme ? { ...tableSpec.theme, ...options.theme } : tableSpec.theme;
-  let theme = resolveTheme2(mergedThemeConfig);
+  let theme = resolveTheme3(mergedThemeConfig);
   if (options.darkMode) {
-    theme = adaptTheme2(theme);
+    theme = adaptTheme3(theme);
   }
   return compileTableLayout(tableSpec, options, theme);
 }
 function compileGraph2(spec, options) {
   return compileGraph(spec, options);
 }
+function compileSankey2(spec, options) {
+  return compileSankey(spec, options);
+}
 export {
   clampStaggerDelay,
   clearRenderers,
@@ -9593,6 +10560,7 @@ export {
   compileChart,
   compileGraph2 as compileGraph,
   compileLayer,
+  compileSankey2 as compileSankey,
   compileTable,
   evaluatePredicate,
   getChartRenderer,