@bicharts/chart-host 0.5.86 → 0.5.87

package/dist/index.mjs

@@ -15,7 +15,6 @@ import {
   AXIS_PIN_MAX_BAND_FRACTION,
   AXIS_PIN_MIN_LABELS,
   AXIS_PIN_TRACK_REACH_PX,
-  Ae,
   BACKING_MAJORITY,
   COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT,
   COLOR_SCALE_SELF_CLAMP_PCT_MAX,
@@ -24,7 +23,6 @@ import {
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
-  Ce,
   DARK_TEXT,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
@@ -34,6 +32,7 @@ import {
   GLYPH_SAMPLE_N,
   HOST_CONTAINER_CLASS,
   HOST_CONTRACT_VERSION,
+  It,
   L3,
   LABEL_CONTRAST_CAP,
   LABEL_CONTRAST_DONE_ATTR,
@@ -45,16 +44,17 @@ import {
   MAX_FRAME_GROW_FACTOR,
   MIN_CONTRAST,
   MIN_HIT_BAND_PX,
+  Me,
   PAGE_MATCH_TOLERANCE,
   PHANTOM_FRACTION,
   PILL_MIN_ALPHA,
   PILL_MIN_COVERAGE,
   PILL_OPAQUE_ALPHA,
   ROW_IDX_ATTR,
-  Rt,
   SCROLL_SLACK_PX,
   SEASONAL_MARKERS_DEFAULT,
   SELECTION_ACTIVE_CLASS,
+  Te,
   VALUE_AXIS_BASELINE_DEFAULT,
   WHITE_TEXT_BG_LUM,
   XFILTER_REFRESH_EVENT,
@@ -93,6 +93,7 @@ import {
   measureContainerBoxes,
   needsScroll,
   noopViewStateProvider,
+  p,
   periodTickSuppressesFeedback,
   pillBacksGlyph,
   pinScrolledAxis,
@@ -108,9 +109,10 @@ import {
   stripEsmExports,
   svgInkReach,
   toRGBA,
+  u,
   unpinScrolledAxis,
   vt
-} from "./chunk-R4STRHXO.mjs";
+} from "./chunk-NWMMNXH2.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
@@ -148,7 +150,7 @@ function planTrivialChart(data) {
   }
   if (dataCols.length !== 1) return null;
   const idx = dataCols[0];
-  const name = columnName(allCols[idx]) || "Value";
+  const name2 = columnName(allCols[idx]) || "Value";
   const finish = (kind, reason, source) => ({
     kind,
     reason,
@@ -160,7 +162,7 @@ function planTrivialChart(data) {
     return finish(
       "card",
       "One row of one column holds a single value, so this is a card. No generation was needed and none was used.",
-      cardSource(idx, name)
+      cardSource(idx, name2)
     );
   }
   if (isNumericColumn(rows, idx)) {
@@ -168,7 +170,7 @@ function planTrivialChart(data) {
     return finish(
       "histogram",
       "A single numeric column has one defensible chart: the distribution of its values. No generation was needed and none was used.",
-      histogramSource(idx, name)
+      histogramSource(idx, name2)
     );
   }
   const distinct = /* @__PURE__ */ new Set();
@@ -181,7 +183,7 @@ function planTrivialChart(data) {
   return finish(
     "frequency-bar",
     "A single categorical column has one defensible chart: how often each value occurs. No generation was needed and none was used.",
-    frequencySource(idx, name)
+    frequencySource(idx, name2)
   );
 }
 function compileTrivialSource(source) {
@@ -222,7 +224,7 @@ var PRELUDE = `
   }
   container.replaceChildren();
 `;
-function cardSource(idx, name) {
+function cardSource(idx, name2) {
   return `function render(container, data, options) {${PRELUDE}
   var raw = rows[0] ? rows[0][${idx}] : null;
   var blank = (raw === null || raw === undefined || raw === '');
@@ -254,13 +256,13 @@ function cardSource(idx, name) {
   label.style.marginTop = '6px'; label.style.textAlign = 'center';
   label.style.maxWidth = '100%'; label.style.overflow = 'hidden';
   label.style.textOverflow = 'ellipsis'; label.style.whiteSpace = 'nowrap';
-  label.textContent = ${lit(name)};
+  label.textContent = ${lit(name2)};
 
   root.appendChild(value); root.appendChild(label);
   container.appendChild(root);
 }`;
 }
-function frequencySource(idx, name) {
+function frequencySource(idx, name2) {
   return `function render(container, data, options) {${PRELUDE}
   var counts = new Map();
   for (var r = 0; r < rows.length; r++) {
@@ -280,7 +282,7 @@ function frequencySource(idx, name) {
   var barH = Math.min(bandH - 3, 26);
 
   var title = svgEl('text', { x: 8, y: CF + 2, 'font-size': CF, 'font-weight': '700', fill: FG });
-  title.textContent = ${lit(name)} + ' \\u2014 count of ' + fmt(rows.length) + ' rows';
+  title.textContent = ${lit(name2)} + ' \\u2014 count of ' + fmt(rows.length) + ' rows';
   svg.appendChild(title);
 
   entries.forEach(function (e, i) {
@@ -319,7 +321,7 @@ function frequencySource(idx, name) {
   container.appendChild(svg);
 }`;
 }
-function histogramSource(idx, name) {
+function histogramSource(idx, name2) {
   return `function render(container, data, options) {${PRELUDE}
   var vals = [];
   for (var r = 0; r < rows.length; r++) {
@@ -355,7 +357,7 @@ function histogramSource(idx, name) {
   var bw = plotW / binCount;
 
   var title = svgEl('text', { x: padL, y: CF + 2, 'font-size': CF, 'font-weight': '700', fill: FG });
-  title.textContent = ${lit(name)} + ' \\u2014 distribution of ' + fmt(vals.length) + ' values';
+  title.textContent = ${lit(name2)} + ' \\u2014 distribution of ' + fmt(vals.length) + ' values';
   svg.appendChild(title);
 
   bins.forEach(function (idxs, i) {
@@ -709,10 +711,10 @@ function normalizeFilterTerm(raw) {
   return raw.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/\s+/g, " ").trim();
 }
 var FILTER_MIN_TERM_CHARS = 2;
-function startsAWord(name, t) {
-  for (let i = name.indexOf(t); i >= 0; i = name.indexOf(t, i + 1)) {
+function startsAWord(name2, t) {
+  for (let i = name2.indexOf(t); i >= 0; i = name2.indexOf(t, i + 1)) {
     if (i === 0) return true;
-    const prev = name.charCodeAt(i - 1);
+    const prev = name2.charCodeAt(i - 1);
     const alnum = prev >= 97 && prev <= 122 || prev >= 48 && prev <= 57;
     if (!alnum) return true;
   }
@@ -727,10 +729,10 @@ function filterQualifyRows(rows, term, read) {
   const byDesc = [];
   for (const row of all) {
     const f = read(row);
-    const name = normalizeFilterTerm(f.name);
-    if (name === "") continue;
-    if (name.indexOf(t) >= 0) {
-      (startsAWord(name, t) ? atWordStart : midWord).push(row);
+    const name2 = normalizeFilterTerm(f.name);
+    if (name2 === "") continue;
+    if (name2.indexOf(t) >= 0) {
+      (startsAWord(name2, t) ? atWordStart : midWord).push(row);
       continue;
     }
     if (normalizeFilterTerm(f.description).indexOf(t) >= 0) byDesc.push(row);
@@ -820,6 +822,357 @@ function inlineFilterGate(rowCount) {
 }
 var INLINE_FILTER_MIN_ROWS = 8;
 
+// src/sourceDateFormat.ts
+function formatSourceDate(raw, opts = {}) {
+  const d = toDate(raw);
+  if (!d) return null;
+  const dayFrame = u(d);
+  const frame = dayFrame ?? (opts.dialect === "dotnet" ? "local" : "utc");
+  const p3 = partsIn(d, frame);
+  const format = cleanFormat(opts.format, opts.dialect);
+  if (format && opts.dialect) {
+    const rendered = renderFormat(format, p3, opts.dialect, opts.culture);
+    if (rendered) return rendered;
+  }
+  return localeDate(p3, !!dayFrame, opts.culture);
+}
+function formatSourceDateFor(raw, columnName2, formats, culture) {
+  return formatSourceDate(raw, {
+    format: formats?.byColumn?.[columnName2] ?? null,
+    dialect: formats?.dialect,
+    culture
+  });
+}
+var ISO_LIKE_RE = /^\s*\d{4}-\d{2}-\d{2}(?:[T ]\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?)?\s*$/;
+function toDate(raw) {
+  if (raw instanceof Date) return isNaN(raw.getTime()) ? null : raw;
+  if (typeof raw !== "string" || !ISO_LIKE_RE.test(raw)) return null;
+  const d = p(raw.trim());
+  return d && !isNaN(d.getTime()) ? d : null;
+}
+function partsIn(d, frame) {
+  return frame === "utc" ? {
+    year: d.getUTCFullYear(),
+    month: d.getUTCMonth() + 1,
+    day: d.getUTCDate(),
+    hours: d.getUTCHours(),
+    minutes: d.getUTCMinutes(),
+    seconds: d.getUTCSeconds(),
+    ms: d.getUTCMilliseconds(),
+    weekday: d.getUTCDay()
+  } : {
+    year: d.getFullYear(),
+    month: d.getMonth() + 1,
+    day: d.getDate(),
+    hours: d.getHours(),
+    minutes: d.getMinutes(),
+    seconds: d.getSeconds(),
+    ms: d.getMilliseconds(),
+    weekday: d.getDay()
+  };
+}
+function utcAnchor(p3) {
+  const d = new Date(Date.UTC(p3.year, p3.month - 1, p3.day, p3.hours, p3.minutes, p3.seconds, p3.ms));
+  if (p3.year >= 0 && p3.year < 100) d.setUTCFullYear(p3.year);
+  return d;
+}
+function localeDate(p3, wholeDay, culture) {
+  const anchor = utcAnchor(p3);
+  try {
+    const o = { dateStyle: "medium", timeZone: "UTC" };
+    if (!wholeDay) o.timeStyle = p3.seconds || p3.ms ? "medium" : "short";
+    return new Intl.DateTimeFormat(culture || void 0, o).format(anchor);
+  } catch {
+    const iso = anchor.toISOString();
+    return wholeDay ? iso.slice(0, 10) : `${iso.slice(0, 10)} ${iso.slice(11, 19)}`;
+  }
+}
+function cleanFormat(raw, dialect) {
+  if (!raw || !dialect) return null;
+  let s = firstSection(String(raw), dialect);
+  if (dialect === "excel") {
+    s = s.replace(/\[(h{1,2}|m{1,2}|s{1,2})\]/gi, "$1").replace(/\[[^\]]*\]/g, "");
+  }
+  if (!s.trim() || /^general$/i.test(s.trim())) return null;
+  return hasDateToken(s, dialect) ? s : null;
+}
+function firstSection(s, dialect) {
+  let out = "";
+  let quote = "";
+  for (let i = 0; i < s.length; i++) {
+    const ch = s[i];
+    if (quote) {
+      out += ch;
+      if (ch === quote) quote = "";
+      continue;
+    }
+    if (ch === '"' || dialect === "dotnet" && ch === "'") {
+      quote = ch;
+      out += ch;
+      continue;
+    }
+    if (ch === "\\") {
+      out += ch + (s[i + 1] ?? "");
+      i++;
+      continue;
+    }
+    if (ch === ";") break;
+    out += ch;
+  }
+  return out;
+}
+function hasDateToken(s, dialect) {
+  const stripped = stripLiterals(s, dialect);
+  return dialect === "excel" ? /[ymdhs]/i.test(stripped) : /[yMdHhmsft]/.test(stripped);
+}
+function stripLiterals(s, dialect) {
+  let out = "";
+  for (let i = 0; i < s.length; i++) {
+    const ch = s[i];
+    if (ch === "\\" || dialect === "dotnet" && ch === "%") {
+      i++;
+      continue;
+    }
+    if (ch === '"' || dialect === "dotnet" && ch === "'") {
+      const end = s.indexOf(ch, i + 1);
+      i = end < 0 ? s.length : end;
+      continue;
+    }
+    out += ch;
+  }
+  return out;
+}
+var EXCEL_TOKENS = [
+  [/^am\/pm/i, "meridiemLong"],
+  [/^a\/p/i, "meridiemShort"],
+  [/^y{3,}/i, "year4"],
+  [/^y{1,2}/i, "year2"],
+  [/^m{5,}/i, "monthNarrow"],
+  [/^m{4}/i, "monthLong"],
+  [/^m{3}/i, "monthShort"],
+  [/^m{2}/i, "mAmbiguous2"],
+  [/^m/i, "mAmbiguous1"],
+  [/^d{4,}/i, "weekdayLong"],
+  [/^d{3}/i, "weekdayShort"],
+  [/^d{2}/i, "day2"],
+  [/^d/i, "day1"],
+  [/^h{2,}/i, "hour2"],
+  [/^h/i, "hour1"],
+  [/^s{2,}/i, "second2"],
+  [/^s/i, "second1"]
+];
+var DOTNET_TOKENS = [
+  [/^y{3,}/, "year4"],
+  [/^y{1,2}/, "year2"],
+  [/^M{4,}/, "monthLong"],
+  [/^M{3}/, "monthShort"],
+  [/^M{2}/, "month2"],
+  [/^M/, "month1"],
+  [/^d{4,}/, "weekdayLong"],
+  [/^d{3}/, "weekdayShort"],
+  [/^d{2}/, "day2"],
+  [/^d/, "day1"],
+  [/^H{2,}/, "hour2"],
+  [/^H/, "hour1"],
+  [/^h{2,}/, "hour2"],
+  [/^h/, "hour1"],
+  [/^m{2,}/, "minute2"],
+  [/^m/, "minute1"],
+  [/^s{2,}/, "second2"],
+  [/^s/, "second1"],
+  [/^f+/, "fraction"],
+  [/^tt/, "meridiemLong"],
+  [/^t/, "meridiemShort"]
+];
+function tokenize(s, dialect) {
+  const table = dialect === "excel" ? EXCEL_TOKENS : DOTNET_TOKENS;
+  const out = [];
+  let i = 0;
+  while (i < s.length) {
+    const ch = s[i];
+    if (ch === "\\" || dialect === "dotnet" && ch === "%") {
+      if (i + 1 < s.length) out.push({ kind: "literal", text: s[i + 1] });
+      i += 2;
+      continue;
+    }
+    if (ch === '"' || dialect === "dotnet" && ch === "'") {
+      const end = s.indexOf(ch, i + 1);
+      out.push({ kind: "literal", text: end < 0 ? s.slice(i + 1) : s.slice(i + 1, end) });
+      i = end < 0 ? s.length : end + 1;
+      continue;
+    }
+    const rest = s.slice(i);
+    let matched = false;
+    for (const [re, kind] of table) {
+      const m = re.exec(rest);
+      if (m) {
+        out.push({ kind });
+        i += m[0].length;
+        matched = true;
+        break;
+      }
+    }
+    if (!matched) {
+      out.push({ kind: "literal", text: ch });
+      i++;
+    }
+  }
+  return out;
+}
+function resolveAmbiguousM(tokens) {
+  const isHour = (t) => t.kind === "hour1" || t.kind === "hour2";
+  const isSecond = (t) => t.kind === "second1" || t.kind === "second2";
+  for (let i = 0; i < tokens.length; i++) {
+    const t = tokens[i];
+    if (t.kind !== "mAmbiguous1" && t.kind !== "mAmbiguous2") continue;
+    const two = t.kind === "mAmbiguous2";
+    let minute = false;
+    for (let j = i - 1; j >= 0; j--) {
+      if (tokens[j].kind === "literal") continue;
+      minute = isHour(tokens[j]);
+      break;
+    }
+    if (!minute) {
+      for (let j = i + 1; j < tokens.length; j++) {
+        if (tokens[j].kind === "literal") continue;
+        minute = isSecond(tokens[j]);
+        break;
+      }
+    }
+    t.kind = minute ? two ? "minute2" : "minute1" : two ? "month2" : "month1";
+  }
+}
+var EN_MONTHS_LONG = [
+  "January",
+  "February",
+  "March",
+  "April",
+  "May",
+  "June",
+  "July",
+  "August",
+  "September",
+  "October",
+  "November",
+  "December"
+];
+var EN_MONTHS_SHORT = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+var EN_DAYS_LONG = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+var EN_DAYS_SHORT = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+function name(p3, kind, width, culture) {
+  try {
+    const opts = kind === "month" ? { month: width, timeZone: "UTC" } : { weekday: width === "narrow" ? "short" : width, timeZone: "UTC" };
+    return new Intl.DateTimeFormat(culture || void 0, opts).format(utcAnchor(p3));
+  } catch {
+    if (kind === "month") {
+      const long = EN_MONTHS_LONG[p3.month - 1] ?? "";
+      if (width === "long") return long;
+      return width === "narrow" ? long.slice(0, 1) : EN_MONTHS_SHORT[p3.month - 1] ?? "";
+    }
+    return (width === "long" ? EN_DAYS_LONG[p3.weekday] : EN_DAYS_SHORT[p3.weekday]) ?? "";
+  }
+}
+var p2 = (n) => (n < 10 ? "0" : "") + n;
+function renderFormat(format, p3, dialect, culture) {
+  const tokens = tokenize(format, dialect);
+  if (dialect === "excel") resolveAmbiguousM(tokens);
+  const twelve = tokens.some((t) => t.kind === "meridiemLong" || t.kind === "meridiemShort");
+  const hour12 = () => {
+    const h = p3.hours % 12;
+    return h === 0 ? 12 : h;
+  };
+  let out = "";
+  let sawField = false;
+  for (const t of tokens) {
+    switch (t.kind) {
+      case "literal":
+        out += t.text ?? "";
+        break;
+      case "year4":
+        out += String(p3.year);
+        sawField = true;
+        break;
+      case "year2":
+        out += p2((p3.year % 100 + 100) % 100);
+        sawField = true;
+        break;
+      case "monthLong":
+        out += name(p3, "month", "long", culture);
+        sawField = true;
+        break;
+      case "monthShort":
+        out += name(p3, "month", "short", culture);
+        sawField = true;
+        break;
+      case "monthNarrow":
+        out += name(p3, "month", "long", culture).slice(0, 1);
+        sawField = true;
+        break;
+      case "month2":
+        out += p2(p3.month);
+        sawField = true;
+        break;
+      case "month1":
+        out += String(p3.month);
+        sawField = true;
+        break;
+      case "weekdayLong":
+        out += name(p3, "weekday", "long", culture);
+        sawField = true;
+        break;
+      case "weekdayShort":
+        out += name(p3, "weekday", "short", culture);
+        sawField = true;
+        break;
+      case "day2":
+        out += p2(p3.day);
+        sawField = true;
+        break;
+      case "day1":
+        out += String(p3.day);
+        sawField = true;
+        break;
+      case "hour2":
+        out += p2(twelve ? hour12() : p3.hours);
+        sawField = true;
+        break;
+      case "hour1":
+        out += String(twelve ? hour12() : p3.hours);
+        sawField = true;
+        break;
+      case "minute2":
+        out += p2(p3.minutes);
+        sawField = true;
+        break;
+      case "minute1":
+        out += String(p3.minutes);
+        sawField = true;
+        break;
+      case "second2":
+        out += p2(p3.seconds);
+        sawField = true;
+        break;
+      case "second1":
+        out += String(p3.seconds);
+        sawField = true;
+        break;
+      case "fraction":
+        out += String(p3.ms).padStart(3, "0");
+        sawField = true;
+        break;
+      case "meridiemLong":
+        out += p3.hours < 12 ? "AM" : "PM";
+        sawField = true;
+        break;
+      case "meridiemShort":
+        out += p3.hours < 12 ? "A" : "P";
+        sawField = true;
+        break;
+    }
+  }
+  return sawField && out.trim() ? out : null;
+}
+
 // src/selectionCard.ts
 var SYNTHETIC_PREFIX = "__";
 var NUMERIC_DATATYPE = /int|double|decimal|single|float|number|currency|money/i;
@@ -852,8 +1205,8 @@ function aggLabel(agg) {
       return "Sum";
   }
 }
-function isSynthetic(name) {
-  return String(name ?? "").startsWith(SYNTHETIC_PREFIX);
+function isSynthetic(name2) {
+  return String(name2 ?? "").startsWith(SYNTHETIC_PREFIX);
 }
 function isMeasureColumn(col) {
   if (!col || isSynthetic(col.name)) return false;
@@ -863,16 +1216,31 @@ function isMeasureColumn(col) {
 function isRealColumn(col) {
   return !!col && !isSynthetic(col.name);
 }
+function isSerialisedDateColumn(col) {
+  return /^datetime/i.test(String(col?.dataType ?? ""));
+}
+function displayText(col, raw, opts) {
+  if (raw == null || raw === "") return "(blank)";
+  if (isSerialisedDateColumn(col)) {
+    const shown = formatSourceDate(raw, {
+      format: opts.sourceFormats?.byColumn?.[String(col?.name ?? "")] ?? null,
+      dialect: opts.sourceFormats?.dialect,
+      culture: opts.cultureCode
+    });
+    if (shown) return shown;
+  }
+  return String(raw);
+}
 function isSuppressed(col) {
-  return Rt(col).suppressed;
+  return vt(col).suppressed;
 }
 function resolveAgg(col, requested, auto) {
   const fallback = () => {
-    const d = Ce(col);
+    const d = Me(col);
     return d === "first" ? "count" : d;
   };
   if (auto) return fallback();
-  return vt(col).indexOf(requested) >= 0 ? requested : fallback();
+  return It(col).indexOf(requested) >= 0 ? requested : fallback();
 }
 function toNumber(v) {
   if (v == null || v === "") return null;
@@ -939,9 +1307,8 @@ function computeSelectionCard(payload, selectedRowIdxs, opts = {}) {
   if (dimIdx >= 0) {
     const seen = [];
     const set = /* @__PURE__ */ new Set();
-    for (const p of positions) {
-      const raw = rows[p]?.[dimIdx];
-      const s = raw == null || raw === "" ? "(blank)" : String(raw);
+    for (const p3 of positions) {
+      const s = displayText(columns[dimIdx], rows[p3]?.[dimIdx], opts);
       if (!set.has(s)) {
         set.add(s);
         seen.push(s);
@@ -969,14 +1336,14 @@ function computeSelectionCard(payload, selectedRowIdxs, opts = {}) {
     const colAgg = resolveAgg(col, agg, auto);
     const selVals = [];
     const selRaw = [];
-    for (const p of positions) {
-      const n = toNumber(rows[p]?.[c]);
-      selRaw.push(rows[p]?.[c]);
+    for (const p3 of positions) {
+      const n = toNumber(rows[p3]?.[c]);
+      selRaw.push(rows[p3]?.[c]);
       if (n != null) selVals.push(n);
     }
     const value = reduce(selVals, colAgg, selRaw);
     let sharePct = null;
-    if (Ae(col, colAgg) && value != null) {
+    if (Te(col, colAgg) && value != null) {
       const allVals = [];
       const allRaw = [];
       for (let r = 0; r < rows.length; r++) {
@@ -1001,20 +1368,20 @@ function computeSelectionCard(payload, selectedRowIdxs, opts = {}) {
   for (let c = 0; c < columns.length && dimensionLines.length < maxDimensions; c++) {
     if (c === dimIdx) continue;
     if (!isRealColumn(columns[c]) || isMeasureColumn(columns[c])) continue;
-    const name = String(columns[c]?.name ?? "");
+    const name2 = String(columns[c]?.name ?? "");
     const distinct = /* @__PURE__ */ new Set();
     let firstText = "";
-    for (const p of positions) {
-      const raw = rows[p]?.[c];
-      const s = raw == null || raw === "" ? "(blank)" : String(raw);
-      if (!distinct.size) firstText = s;
-      distinct.add(s);
+    for (const p3 of positions) {
+      const raw = rows[p3]?.[c];
+      const key = raw == null || raw === "" ? "(blank)" : String(raw);
+      if (!distinct.size) firstText = displayText(columns[c], raw, opts);
+      distinct.add(key);
     }
     if (!distinct.size) continue;
     const single = distinct.size === 1;
     dimensionLines.push({
-      column: name,
-      label: single ? name : `Distinct ${name}`,
+      column: name2,
+      label: single ? name2 : `Distinct ${name2}`,
       value: single ? null : distinct.size,
       valueText: single ? firstText : fmtNumber(distinct.size, opts.cultureCode),
       sharePct: null,
@@ -1137,6 +1504,8 @@ export {
   filterQualifyRows,
   fitReadingFor,
   fitRenderedChart,
+  formatSourceDate,
+  formatSourceDateFor,
   geoAssetFor,
   geoFromCache,
   glyphSampleGrid,

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-R4STRHXO.mjs";
+} from "./chunk-NWMMNXH2.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/types/index.d.ts

@@ -15,6 +15,7 @@ export { qualifyGroupHeadingFor, newQualifyGroupState, type QualifyGroupRow, typ
 export { qualifyPick, qualifyAuto, qualifyCancel, launchGenerates, launchFavorStyle, chooserFitsViewport, shouldOpenChooserOnGenerate, shouldOpenInlineChooserOnGenerate, canConfirmLaunch, confirmLaunch, qualifyFailureFallsOpen, CHOOSER_MIN_WIDTH_PX, CHOOSER_MIN_HEIGHT_PX, type QualifyLaunchOutcome, type ChooserGateInput, } from "./qualifyLaunch";
 export { normalizeFilterTerm, filterQualifyRows, readQualifyChartRow, readQualifyRefusalRow, filterFitsChooser, listNeedsFilter, qualifyFilterGate, inlineFilterGate, FILTER_MIN_TERM_CHARS, FILTER_ROW_PX, FILTER_MIN_WIDTH_PX, FILTER_MIN_HEIGHT_PX, INLINE_FILTER_MIN_ROWS, computeQualifyFilterView, qualifyFilterCountText, type QualifyFilterTier, type QualifyFilterResult, type QualifyFilterRead, type QualifyFilterGateReason, type QualifyFilterGateInput, type QualifyFilterRow, type QualifyFilterGroup, type QualifyFilterView, type QualifyFilterNoteKind, } from "./qualifyFilter";
 export { computeSelectionCard, normaliseAggregation, type SelectionCardModel, type SelectionCardLine, type SelectionCardOptions, } from "./selectionCard";
+export { formatSourceDate, formatSourceDateFor, type SourceFormats, type SourceFormatDialect, type SourceDateOptions, } from "./sourceDateFormat";
 export { ensureCrossfilterHitTargets, type HitTargetReport } from "./hitTargets";
 export { applyLabelContrast, LABEL_CONTRAST_DONE_ATTR, LABEL_CONTRAST_CAP, type LabelContrastOptions, type LabelContrastReport, } from "./labelContrastDom";
 export { decideLabelColor, toRGBA, compositeOver, relativeLuminance, contrastRatio, isPillBackdropAlpha, pillBacksGlyph, backingHoldsGlyph, cellSuppressesNormalize, glyphSampleGrid, DARK_TEXT, LIGHT_TEXT, MIN_CONTRAST, WHITE_TEXT_BG_LUM, PILL_MIN_ALPHA, PILL_OPAQUE_ALPHA, PILL_MIN_COVERAGE, PAGE_MATCH_TOLERANCE, BACKING_MAJORITY, GLYPH_SAMPLE_N, type LabelDecision, } from "./labelContrast";

package/dist/types/selectionCard.d.ts

@@ -1,4 +1,5 @@
 import type { RenderPayload } from "./payload";
+import { type SourceFormats } from "./sourceDateFormat";
 export interface SelectionCardOptions {
     /** The chart's own aggregation, so the card AGREES with the picture it sits on. A card
      *  reading "Sum" beside a chart drawn from averages is two answers to one question.
@@ -24,6 +25,16 @@ export interface SelectionCardOptions {
      *  cap already had (on the sample table the two coordinate columns took two of the four
      *  measure slots and pushed the real measures under "+2 more"). Default 2. */
     maxDimensions?: number;
+    /** THE SOURCE'S OWN DATE FORMATS, keyed by column name, plus the dialect they are written in
+     *  — Excel's `range.numberFormat` for the add-in, a `.NET` format string for the visual.
+     *
+     *  Optional, and the fallback is deliberately good rather than minimal: a host that supplies
+     *  nothing still gets a locale date instead of the ISO instant this replaced, so the MCP and
+     *  React hosts (a CSV has no cell formatting to read) and every chart cached before today
+     *  improve without anyone plumbing anything. What the map buys is AGREEMENT with the cells
+     *  the card is floating over — a sheet that shows `31-Aug-25` gets a card that says
+     *  `31-Aug-25`. */
+    sourceFormats?: SourceFormats | null;
 }
 export interface SelectionCardLine {
     column: string;