@bicharts/chart-host 0.1.5 → 0.1.6

package/dist/{chunk-UNH36TGD.mjs → chunk-2WOMFNMG.mjs}

@@ -260,6 +260,9 @@ function buildGeoPointColumns(rows) {
   }
   return { lat, lon, precision: coarsest, unmatched, ambiguousRows, matchedRows, totalRows: rows.length };
 }
+function isKnownCity(normalizedName) {
+  return !!normalizedName && cityIndex().has(normalizedName);
+}
 
 // ../shape-core/dist/chunk-2NJREYQG.mjs
 /*! @bicharts/shape-core — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; US Census/TIGER (public domain). Full text: NOTICE in this package. */
@@ -682,6 +685,158 @@ function buildGeoIsoColumn(values, geoKind) {
 
 // ../shape-core/dist/index.mjs
 /*! @bicharts/shape-core — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; US Census/TIGER (public domain). Full text: NOTICE in this package. */
+var THRESHOLD_PCT = 85;
+var MIN_DISTINCT_BACKFILL = 2;
+var ZIP_THRESHOLD_PCT = 100;
+var MAX_DISTINCT_SCAN = 400;
+var COUNTRY_IDS = /* @__PURE__ */ new Set([
+  "us",
+  "usa",
+  "u s",
+  "u s a",
+  "united states",
+  "united states of america",
+  "america",
+  "ca",
+  "can",
+  "canada",
+  "mx",
+  "mex",
+  "mexico",
+  "estados unidos mexicanos"
+]);
+function distinctNormalized(values) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const v of values) {
+    if (v === null || v === void 0) continue;
+    const k = normalizePlaceName(String(v));
+    if (!k) continue;
+    if (!seen.has(k)) {
+      seen.add(k);
+      if (seen.size >= MAX_DISTINCT_SCAN) break;
+    }
+  }
+  return Array.from(seen);
+}
+function looksLikeCountryColumn(values) {
+  const d = distinctNormalized(values);
+  if (d.length === 0) return false;
+  return d.every((v) => COUNTRY_IDS.has(v));
+}
+function admin1MatchPct(values) {
+  const d = distinctNormalized(values);
+  if (d.length === 0) return 0;
+  let n = 0;
+  for (const v of d) if (resolveAdmin1(v)) n++;
+  return Math.round(n / d.length * 1e3) / 10;
+}
+function distinctRaw(values) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const v of values) {
+    if (v === null || v === void 0) continue;
+    const s = String(v).trim();
+    if (!s) continue;
+    if (!seen.has(s)) {
+      seen.add(s);
+      if (seen.size >= MAX_DISTINCT_SCAN) break;
+    }
+  }
+  return Array.from(seen);
+}
+function zipMatchPct(values) {
+  const d = distinctRaw(values);
+  if (d.length === 0) return 0;
+  let n = 0;
+  for (const v of d) if (zipPrefixCandidates(v).length > 0) n++;
+  return Math.round(n / d.length * 1e3) / 10;
+}
+function cityPct(values) {
+  const d = distinctNormalized(values);
+  if (d.length === 0) return 0;
+  let n = 0;
+  for (const v of d) if (isKnownCity(v)) n++;
+  return Math.round(n / d.length * 1e3) / 10;
+}
+function distinctMatches(values, pred) {
+  let n = 0;
+  for (const v of distinctNormalized(values)) if (pred(v)) n++;
+  return n;
+}
+function distinctRawMatches(values, pred) {
+  let n = 0;
+  for (const v of distinctRaw(values)) if (pred(v)) n++;
+  return n;
+}
+function resolvePointRoles(columns, rows, hint) {
+  const backfilled = [];
+  const refused = [];
+  const out = {};
+  const colSet = new Set(columns);
+  const valuesOf = (name) => rows.map((r) => r[name]);
+  for (const role of ["city", "zip", "lat", "lon"]) {
+    const name = hint?.[role];
+    if (name && colSet.has(name)) out[role] = name;
+  }
+  const hintedState = hint?.state;
+  if (hintedState && colSet.has(hintedState)) {
+    const vals = valuesOf(hintedState);
+    if (looksLikeCountryColumn(vals)) {
+      refused.push(`state=${hintedState} (every value is a country, not a state)`);
+    } else if (admin1MatchPct(vals) < THRESHOLD_PCT) {
+      refused.push(`state=${hintedState} (only ${admin1MatchPct(vals)}% of values are states/provinces)`);
+    } else {
+      out.state = hintedState;
+    }
+  }
+  const taken = new Set(Object.values(out).filter(Boolean));
+  const candidates = columns.filter((c) => !taken.has(c) && !c.startsWith("__"));
+  if (!out.state) {
+    let best = null;
+    for (const c of candidates) {
+      const vals = valuesOf(c);
+      if (looksLikeCountryColumn(vals)) continue;
+      const pct = admin1MatchPct(vals);
+      if (pct < THRESHOLD_PCT) continue;
+      if (distinctMatches(vals, (v) => !!resolveAdmin1(v)) < MIN_DISTINCT_BACKFILL) continue;
+      if (!best || pct > best.pct) best = { name: c, pct };
+    }
+    if (best) {
+      out.state = best.name;
+      taken.add(best.name);
+      backfilled.push(`state=${best.name} (${best.pct}% states/provinces)`);
+    }
+  }
+  if (!out.zip) {
+    for (const c of candidates) {
+      if (taken.has(c)) continue;
+      const vals = valuesOf(c);
+      const pct = zipMatchPct(vals);
+      if (pct < ZIP_THRESHOLD_PCT) continue;
+      if (distinctRawMatches(vals, (v) => zipPrefixCandidates(v).length > 0) < MIN_DISTINCT_BACKFILL) continue;
+      out.zip = c;
+      taken.add(c);
+      backfilled.push(`zip=${c} (${pct}% ZIP codes)`);
+      break;
+    }
+  }
+  if (!out.city) {
+    let best = null;
+    for (const c of candidates) {
+      if (taken.has(c)) continue;
+      const vals = valuesOf(c);
+      const pct = cityPct(vals);
+      if (pct < THRESHOLD_PCT) continue;
+      if (distinctMatches(vals, (v) => isKnownCity(v)) < MIN_DISTINCT_BACKFILL) continue;
+      if (!best || pct > best.pct) best = { name: c, pct };
+    }
+    if (best) {
+      out.city = best.name;
+      backfilled.push(`city=${best.name} (${best.pct}% known cities)`);
+    }
+  }
+  const any = !!(out.city || out.state || out.zip || out.lat && out.lon);
+  return { bind: any ? out : null, backfilled, refused };
+}
 
 // src/payload.ts
 function buildRenderPayload(cols, rowObjs, geo, point) {
@@ -689,9 +844,19 @@ function buildRenderPayload(cols, rowObjs, geo, point) {
   let pLat = null;
   let pLon = null;
   let geoPoint;
-  const hasPointBind = !!point && !!(point.city || point.state || point.zip || point.lat && point.lon);
+  let bind = point ?? null;
+  let rolesBackfilled = [];
+  let rolesRefused = [];
+  if (bind) {
+    const dims = cols.filter((c) => !c.isMeasure).map((c) => c.name);
+    const res = resolvePointRoles(dims, rowObjs, bind);
+    bind = res.bind;
+    rolesBackfilled = res.backfilled;
+    rolesRefused = res.refused;
+  }
+  const hasPointBind = !!bind && !!(bind.city || bind.state || bind.zip || bind.lat && bind.lon);
   if (hasPointBind) {
-    const p = point;
+    const p = bind;
     const built = buildGeoPointColumns(rowObjs.map((r) => ({
       lat: p.lat ? r[p.lat] : null,
       lon: p.lon ? r[p.lon] : null,
@@ -705,7 +870,12 @@ function buildRenderPayload(cols, rowObjs, geo, point) {
       precision: built.precision,
       unplaced: built.totalRows - built.matchedRows,
       unplacedExamples: built.unmatched.slice(0, 8),
-      ambiguousRows: built.ambiguousRows
+      ambiguousRows: built.ambiguousRows,
+      // Omitted entirely when nothing was adjusted, so the common case adds no bytes
+      // and a chart can treat presence as "something about this binding is worth
+      // saying".
+      ...rolesBackfilled.length ? { rolesBackfilled } : {},
+      ...rolesRefused.length ? { rolesRefused } : {}
     };
   }
   let geoIso = null;
@@ -1182,4 +1352,4 @@ export {
   compileRenderFn,
   createChartHost
 };
-//# sourceMappingURL=chunk-UNH36TGD.mjs.map
+//# sourceMappingURL=chunk-2WOMFNMG.mjs.map