@bicharts/chart-host 0.5.21 → 0.5.23

package/dist/{chunk-QIF3TAVP.mjs → chunk-L25G7DDO.mjs}

@@ -719,8 +719,7 @@ function It(r, n, e, s) {
 }
 
 // src/payload.ts
-function buildRenderPayload(cols, rowObjs, geo, point) {
-  const colNames = cols.map((c) => c.name);
+function resolvePointChannel(cols, rowObjs, point) {
   let pLat = null;
   let pLon = null;
   let pPrec = null;
@@ -773,6 +772,17 @@ function buildRenderPayload(cols, rowObjs, geo, point) {
       ...rolesRefused.length ? { rolesRefused } : {}
     };
   }
+  return { lat: pLat, lon: pLon, prec: pPrec, geoPoint, rolesRefused };
+}
+function buildRenderPayload(cols, rowObjs, geo, point, destination) {
+  const colNames = cols.map((c) => c.name);
+  const o = resolvePointChannel(cols, rowObjs, point);
+  const d = resolvePointChannel(cols, rowObjs, destination);
+  const pLat = o.lat, pLon = o.lon, pPrec = o.prec;
+  const dLat = d.lat, dLon = d.lon, dPrec = d.prec;
+  const geoPoint = o.geoPoint;
+  const geoPointDest = d.geoPoint;
+  const rolesRefused = [...o.rolesRefused, ...d.rolesRefused.map((s) => `destination: ${s}`)];
   let geoIso = null;
   let geoUnmatched;
   let geoUnmatchedDistinct;
@@ -782,7 +792,7 @@ function buildRenderPayload(cols, rowObjs, geo, point) {
     geoUnmatched = { count: built.totalRows - built.matchedRows, examples: built.unmatched.slice(0, 8) };
     geoUnmatchedDistinct = built.unmatched.length;
   }
-  const extra = 1 + (geoIso ? 1 : 0) + (pLat ? 3 : 0);
+  const extra = 1 + (geoIso ? 1 : 0) + (pLat ? 3 : 0) + (dLat ? 3 : 0);
   const out = new Array(rowObjs.length);
   for (let r = 0; r < rowObjs.length; r++) {
     const row = rowObjs[r];
@@ -803,6 +813,11 @@ function buildRenderPayload(cols, rowObjs, geo, point) {
       a2[k2++] = pLon[r];
       a2[k2++] = pPrec ? pPrec[r] : null;
     }
+    if (dLat && dLon) {
+      a2[k2++] = dLat[r];
+      a2[k2++] = dLon[r];
+      a2[k2++] = dPrec ? dPrec[r] : null;
+    }
     out[r] = a2;
   }
   const colsOut = [...cols, { name: "__rowIdx__", dataType: "Integer", isMeasure: false, modelDesc: "" }];
@@ -815,12 +830,20 @@ function buildRenderPayload(cols, rowObjs, geo, point) {
     // never a label, never a colour grouping.
     { name: "__geoPrecision__", dataType: "String", isMeasure: false, modelDesc: "" }
   );
+  if (dLat) colsOut.push(
+    { name: "__geoLatD__", dataType: "Double", isMeasure: false, modelDesc: "" },
+    { name: "__geoLonD__", dataType: "Double", isMeasure: false, modelDesc: "" },
+    { name: "__geoPrecisionD__", dataType: "String", isMeasure: false, modelDesc: "" }
+  );
   return {
     columns: colsOut,
     rows: out,
     geoUnmatched,
     geoUnmatchedDistinct,
     geoPoint,
+    // Omitted when there is no second endpoint, so every existing chart's options object
+    // is unchanged rather than gaining an undefined key.
+    ...geoPointDest ? { geoPointDest } : {},
     // Survives a refusal that placed nothing — see geoPointRefused. Omitted when empty so
     // the ordinary case adds no bytes.
     ...rolesRefused.length ? { geoPointRefused: rolesRefused } : {}
@@ -1020,6 +1043,11 @@ var ESM_EXPORT_DECL = /^([ \t]*)export[ \t]+(?=(?:async[ \t]+)?function\b|const\
 function stripEsmExports(code) {
   return String(code || "").replace(ESM_EXPORT_CLAUSE, "").replace(ESM_EXPORT_DECL, "$1");
 }
+function writableD3(d3) {
+  if (d3 == null || typeof d3 !== "object") return d3;
+  if (Object.isExtensible(d3)) return d3;
+  return { ...d3 };
+}
 function compileRenderFn(code, win, doc, d3) {
   const body = stripEsmExports(code) + "\n;return (typeof render === 'function') ? render : null;";
   let factory;
@@ -1032,7 +1060,7 @@ function compileRenderFn(code, win, doc, d3) {
       "[@bicharts/chart-host] the generated code could not be COMPILED, so nothing was drawn. This path evaluates the chart as a code string, which cannot contain ES-module syntax" + (modular ? " \u2014 and this code still has `import`/`export` in it after the export clause was stripped. Either request the plain form from the generator, or `import` the module yourself and pass the render function directly." : ".") + " Original error: " + msg
     );
   }
-  const fn = factory.call(null, null, null, null, win, doc, d3);
+  const fn = factory.call(null, null, null, null, win, doc, writableD3(d3));
   if (typeof fn !== "function") throw new Error("generated code did not define render(container, data, options)");
   return fn;
 }
@@ -1187,6 +1215,7 @@ function createChartHost(container, config) {
       }
       if (resolved.geoUnmatched === void 0 && data.geoUnmatched) resolved = { ...resolved, geoUnmatched: data.geoUnmatched };
       if (resolved.geoPoint === void 0 && data.geoPoint) resolved = { ...resolved, geoPoint: data.geoPoint };
+      if (resolved.geoPointDest === void 0 && data.geoPointDest) resolved = { ...resolved, geoPointDest: data.geoPointDest };
       try {
         renderFn(container, { columns: data.columns, rows: data.rows }, resolved);
       } catch (err) {

package/dist/index.mjs

@@ -42,7 +42,7 @@ import {
   requiredD3Plugins,
   resolveOptions,
   stripEsmExports
-} from "./chunk-QIF3TAVP.mjs";
+} from "./chunk-L25G7DDO.mjs";
 import "./chunk-A2GMXZP7.mjs";
 
 // src/trivial.ts

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-QIF3TAVP.mjs";
+} from "./chunk-L25G7DDO.mjs";
 import "./chunk-A2GMXZP7.mjs";
 
 // src/react.tsx

package/dist/types/contract.d.ts

@@ -54,6 +54,16 @@ export interface RenderOptions {
         rolesBackfilled?: string[];
         rolesRefused?: string[];
     } | null;
+    geoPointDest?: {
+        precision: GeoPointPrecision | null;
+        precisionCounts: Record<GeoPointPrecision, number>;
+        coarseExamples: string[];
+        unplaced: number;
+        unplacedExamples: string[];
+        ambiguousRows: number;
+        rolesBackfilled?: string[];
+        rolesRefused?: string[];
+    } | null;
     maxMapPoints?: number;
     colorScaleLow?: string;
     colorScaleHigh?: string;

package/dist/types/host.d.ts

@@ -10,6 +10,10 @@ export interface ChartHostConfig {
             examples: string[];
         };
         geoPoint?: RenderOptions["geoPoint"];
+        /** The DESTINATION endpoint's report on an origin-destination flow map — promoted
+         *  into options exactly like geoPoint, so a host that hands over the whole payload
+         *  gets both ends annotated without knowing the field exists. */
+        geoPointDest?: RenderOptions["geoPointDest"];
         /** Provenance the MCP stamps into data.sample.json. `hostContract` is checked
          *  against HOST_CONTRACT_VERSION so a major-version drift is LOUD, not silent. */
         meta?: {

package/dist/types/payload.d.ts

@@ -10,6 +10,21 @@ export interface GeoPointBinding {
     country?: string;
     mapKind?: GeoMapKind;
 }
+/** What a point binding's resolution ACHIEVED, so the chart can annotate honestly rather
+ *  than implying a precision it does not have. Named (rather than inlined on RenderPayload)
+ *  because an origin-destination map carries TWO of them, and the two must be the same
+ *  contract — see `geoPointDest`. */
+export interface GeoPointReport {
+    precision: GeoPointPrecision | null;
+    precisionCounts: Record<GeoPointPrecision, number>;
+    coarseExamples: string[];
+    unplaced: number;
+    unplacedExamples: string[];
+    ambiguousRows: number;
+    ambiguousExamples?: string[];
+    rolesBackfilled?: string[];
+    rolesRefused?: string[];
+}
 export interface RenderPayload {
     columns: any[];
     rows: any[][];
@@ -18,17 +33,7 @@ export interface RenderPayload {
         examples: string[];
     };
     geoUnmatchedDistinct?: number;
-    geoPoint?: {
-        precision: GeoPointPrecision | null;
-        precisionCounts: Record<GeoPointPrecision, number>;
-        coarseExamples: string[];
-        unplaced: number;
-        unplacedExamples: string[];
-        ambiguousRows: number;
-        ambiguousExamples?: string[];
-        rolesBackfilled?: string[];
-        rolesRefused?: string[];
-    };
+    geoPoint?: GeoPointReport;
     /**
      * WHY THERE IS NO MAP — the refusals that survive when nothing could be placed.
      *
@@ -43,10 +48,22 @@ export interface RenderPayload {
      * helps call out exceptions / decisions like this, if possible."
      */
     geoPointRefused?: string[];
+    /**
+     * The SECOND endpoint's resolution report (origin-destination flow map, 2026-08-15).
+     * Identical in shape to `geoPoint` because it is produced by the identical function —
+     * the two ends of a route must be placed by the same rules or the arc between them is a
+     * line drawn to the wrong place.
+     *
+     * Present ONLY when a destination binding was given, which keeps every other chart's
+     * options object byte-identical. A flow map annotates from BOTH: "12 of 40 origins" and
+     * "31 of 40 destinations positioned at the largest city in each country" are separate
+     * facts, and a single blended count would hide which end of the route is the coarse one.
+     */
+    geoPointDest?: GeoPointReport;
 }
 export declare function buildRenderPayload(cols: Array<{
     name: string;
 } & Record<string, any>>, rowObjs: Array<Record<string, any>>, geo?: {
     column: string;
     kind: string;
-} | null, point?: GeoPointBinding | null): RenderPayload;
+} | null, point?: GeoPointBinding | null, destination?: GeoPointBinding | null): RenderPayload;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-host",
-  "version": "0.5.21",
+  "version": "0.5.23",
   "description": "Run a BIC-generated D3 chart in any web host: compiles the generated render() function, applies the shared option defaults, resolves mark clicks (through tooltip overlays), owns the selection affordance, and translates row indices between cross-filtered charts. The same contract the BIC Power BI visual implements, minus Power BI. React bindings at @bicharts/chart-host/react.",
   "license": "Apache-2.0",
   "type": "module",