@bicharts/chart-host 0.5.22 → 0.5.24

package/dist/index.mjs

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

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-65LTZEX6.mjs";
+} from "./chunk-PAX7FM4P.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.22",
+  "version": "0.5.24",
   "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",