@bicharts/chart-host 0.1.7 → 0.1.9

package/dist/{chunk-22B22PJU.mjs → chunk-X7PWWEGM.mjs}

@@ -67,4 +67,4 @@ export {
   NA_LAT_MAX,
   clipFeatureToLat
 };
-//# sourceMappingURL=chunk-22B22PJU.mjs.map
+//# sourceMappingURL=chunk-X7PWWEGM.mjs.map

package/dist/{geoNaRegions-SAINMZXG.mjs → geo-us-states.mjs}

@@ -1,12 +1,8 @@
 /*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
 import {
-  NA_ISO3,
-  NA_LAT_MAX,
-  clipFeatureToLat
-} from "./chunk-22B22PJU.mjs";
+  US_STATES
+} from "./chunk-NWID6YOP.mjs";
 export {
-  NA_ISO3,
-  NA_LAT_MAX,
-  clipFeatureToLat
+  US_STATES
 };
-//# sourceMappingURL=geoNaRegions-SAINMZXG.mjs.map
+//# sourceMappingURL=geo-us-states.mjs.map

package/dist/geo-us-zip3.mjs

@@ -0,0 +1,8 @@
+/*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
+import {
+  US_ZIP3
+} from "./chunk-MHDS4Q5G.mjs";
+export {
+  US_ZIP3
+};
+//# sourceMappingURL=geo-us-zip3.mjs.map

package/dist/geo-us-zip3.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/geo-world.mjs

@@ -0,0 +1,8 @@
+/*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
+import {
+  WORLD_110M
+} from "./chunk-23GNNTXQ.mjs";
+export {
+  WORLD_110M
+};
+//# sourceMappingURL=geo-world.mjs.map

package/dist/geo-world.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/geo.mjs

@@ -1,18 +1,18 @@
 /*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
+import {
+  NA_ISO3,
+  NA_LAT_MAX,
+  clipFeatureToLat
+} from "./chunk-X7PWWEGM.mjs";
+import {
+  WORLD_110M
+} from "./chunk-23GNNTXQ.mjs";
 import {
   US_STATES
 } from "./chunk-NWID6YOP.mjs";
 import {
   US_ZIP3
 } from "./chunk-MHDS4Q5G.mjs";
-import {
-  WORLD_110M
-} from "./chunk-23GNNTXQ.mjs";
-import {
-  NA_ISO3,
-  NA_LAT_MAX,
-  clipFeatureToLat
-} from "./chunk-22B22PJU.mjs";
 
 // src/geo.ts
 function geoForKind(geoKind) {

package/dist/index.mjs

@@ -25,14 +25,18 @@ import {
   SELECTION_ACTIVE_CLASS,
   XFILTER_REFRESH_EVENT,
   buildRenderPayload,
+  clearGeoCache,
   compileRenderFn,
   createChartHost,
   createMarkResolver,
+  geoAssetFor,
   geoFromCache,
   loadGeo,
   registerGeo,
+  registerGeoAsset,
   resolveOptions
-} from "./chunk-DF5QUB2N.mjs";
+} from "./chunk-3NDJV3DA.mjs";
+import "./chunk-X7PWWEGM.mjs";
 export {
   ANIM_MAX_IDEAL_FRAMES_DEFAULT,
   ANIM_MAX_IDEAL_FRAMES_MAX,
@@ -59,12 +63,15 @@ export {
   SELECTION_ACTIVE_CLASS,
   XFILTER_REFRESH_EVENT,
   buildRenderPayload,
+  clearGeoCache,
   compileRenderFn,
   createChartHost,
   createMarkResolver,
+  geoAssetFor,
   geoFromCache,
   loadGeo,
   registerGeo,
+  registerGeoAsset,
   resolveOptions
 };
 //# sourceMappingURL=index.mjs.map

package/dist/react.mjs

@@ -2,7 +2,8 @@
 import {
   buildRenderPayload,
   createChartHost
-} from "./chunk-DF5QUB2N.mjs";
+} from "./chunk-3NDJV3DA.mjs";
+import "./chunk-X7PWWEGM.mjs";
 
 // src/react.tsx
 import { createContext, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";

package/dist/react.mjs.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/react.tsx"],
   "sourcesContent": ["// React binding for @bicharts/chart-host \u2014 <BicChart> and <BicChartGroup>.\n//\n// This is ~150 lines that every consumer would otherwise write, and get subtly wrong in the\n// same four ways:\n//\n//   1. StrictMode double-mounts effects (React 19, dev). Without destroy() in cleanup an\n//      animated chart leaks a running timer per mount \u2014 on every hot reload.\n//   2. Prop changes must not RECOMPILE. `options` -> setOptions (live restyle), `data` ->\n//      setData; only new code/module tears down and rebuilds. A naive useEffect([deps])\n//      recompiles on every prop change and throws away animation state.\n//   3. d3 must be INJECTED. There is no global in a bundler app, so `d3` is a required prop.\n//   4. The chart OWNS its container's DOM. React must never render children into it.\n//\n// Cross-chart filtering lives in <BicChartGroup> for a reason that is not cosmetic: rowIdx\n// values are positions WITHIN THE PAYLOAD A CHART RECEIVED. Filter the rows for chart B and\n// its payload renumbers from zero, so the same integers now denote different records \u2014\n// silently. The group owns the source table, builds each chart's payload, keeps the\n// payload-row -> source-row map, and translates selections across it. Consumers never see it.\nimport { createContext, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { createChartHost, type ChartHost, type ChartHostConfig } from \"./host\";\nimport type { ResolveOptionsInput } from \"./defaults\";\nimport { buildRenderPayload, type GeoPointBinding } from \"./payload\";\n\nexport interface BicChartProps {\n    /** Generated render() source (an ES module's `code` export, or the raw string). */\n    code?: string;\n    /** Pre-compiled render function \u2014 the alternative to `code`. */\n    renderFn?: ChartHostConfig[\"renderFn\"];\n    /** The payload: { columns, rows, geoUnmatched?, geoPoint? } \u2014 MCP's data.sample.json verbatim. */\n    data?: ChartHostConfig[\"data\"];\n    /** Raw options; shared defaults/clamps are applied by resolveOptions. */\n    options?: ResolveOptionsInput;\n    /** REQUIRED: the d3 v7 namespace. There is no global in a bundled app. */\n    d3: any;\n    /** Attach the bundled geometry for this kind as options.geo (choropleth or basemap). */\n    geoKind?: string;\n    /** Identity within a <BicChartGroup> \u2014 the key other charts filter by. */\n    id?: string;\n    /** Take this group member's selection as a filter on THIS chart's rows. */\n    filteredBy?: string;\n    /** Selection callback in SOURCE row indices (group) or payload indices (standalone). */\n    onSelect?: (rowIdxs: number[]) => void;\n    className?: string;\n    style?: React.CSSProperties;\n}\n\n// \u2500\u2500 Group coordination \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// ONE active selection for the group, tagged with which chart produced it \u2014 the same\n// model every BI tool uses. Every OTHER chart filters to it; the originating chart does\n// not (it keeps showing all its marks, with the selected ones highlighted, so the user\n// can see what they picked in context and click again to change it). That single rule\n// gives mutual cross-filtering for free: click a bubble and the table filters, click a\n// table row and the map filters, with no possibility of a feedback loop.\ninterface GroupSelection { sourceId: string | null; rows: number[] }\ninterface GroupCtx {\n    /** Source rows as objects, shared by every member. */\n    rows: Record<string, any>[];\n    columns: any[];\n    geo?: { column: string; kind: string } | null;\n    point?: GeoPointBinding | null;\n    /** Publish a member's selection, already translated to SOURCE row indices. */\n    publish(id: string, sourceRowIdxs: number[]): void;\n    /** The filter `id` should APPLY (null = show everything). Never its own selection. */\n    filterFor(id: string | undefined): number[] | null;\n    /** The whole group's active selection, whoever produced it. */\n    selection: GroupSelection;\n    clear(): void;\n}\nconst Ctx = createContext<GroupCtx | null>(null);\n\n/** Read the group's selection from a page \u2014 for a \"clear\" button or a count. */\nexport function useBicSelection() {\n    const g = useContext(Ctx);\n    return {\n        rows: g?.selection.rows ?? [],\n        sourceId: g?.selection.sourceId ?? null,\n        clear: () => g?.clear(),\n    };\n}\n\nexport interface BicChartGroupProps {\n    /** The ONE source table. Every member's payload is derived from it. */\n    rows: Record<string, any>[];\n    columns: any[];\n    /** Choropleth join binding, applied when building each member's payload. */\n    geo?: { column: string; kind: string } | null;\n    /** Point-map geocoding binding (city/state/zip/lat/lon column names). */\n    point?: GeoPointBinding | null;\n    children: ReactNode;\n}\n\n/**\n * Owns the source table and the selection bus. Members declare `id` and optionally\n * `filteredBy`; the group re-derives the filtered member's payload and translates row\n * indices in both directions, so a click in one chart filters another CORRECTLY.\n */\nexport function BicChartGroup({ rows, columns, geo, point, children }: BicChartGroupProps) {\n    const [sel, setSel] = useState<GroupSelection>({ sourceId: null, rows: [] });\n    const value = useMemo<GroupCtx>(() => ({\n        rows, columns, geo, point,\n        selection: sel,\n        publish: (id, sourceRowIdxs) =>\n            setSel(sourceRowIdxs.length ? { sourceId: id, rows: sourceRowIdxs }\n                                        : { sourceId: null, rows: [] }),\n        // A chart never filters itself \u2014 that is what keeps the gesture reversible:\n        // the origin chart still shows every mark, so there is always something left\n        // to click to change or clear the selection.\n        filterFor: (id) => (sel.rows.length && sel.sourceId && sel.sourceId !== id) ? sel.rows : null,\n        clear: () => setSel({ sourceId: null, rows: [] }),\n    }), [rows, columns, geo, point, sel]);\n    return <Ctx.Provider value={value}>{children}</Ctx.Provider>;\n}\n\n/** Build a payload for a subset of source rows, keeping the payload->source index map. */\nfunction payloadFor(g: GroupCtx, sourceIdxs: number[] | null) {\n    const idxs = sourceIdxs ?? g.rows.map((_, i) => i);\n    const subset = idxs.map(i => g.rows[i]);\n    const p = buildRenderPayload(g.columns, subset, g.geo ?? undefined, g.point ?? undefined);\n    // p.rows[k] corresponds to source row idxs[k]. __rowIdx__ inside the payload was\n    // re-based to 0..n-1 by the builder \u2014 THIS map is what makes the indices comparable\n    // across charts, and it is exactly what a hand-rolled integration forgets.\n    return { payload: p, rowMap: idxs };\n}\n\nexport function BicChart(props: BicChartProps) {\n    const { code, renderFn, options, d3, geoKind, id, filteredBy, onSelect, className, style } = props;\n    const ref = useRef<HTMLDivElement | null>(null);\n    const hostRef = useRef<ChartHost | null>(null);\n    const rowMapRef = useRef<number[] | null>(null);\n    const group = useContext(Ctx);\n\n    // Resolve this chart's payload: from the group (filtered + mapped) or the raw prop.\n    // `filteredBy` narrows this to ONE partner when a page wants explicit one-way wiring;\n    // omit it and the chart responds to whichever sibling published \u2014 mutual by default.\n    const active = group ? group.selection : null;\n    const filterSel = !group ? null\n        : (filteredBy ? (active!.sourceId === filteredBy ? group.filterFor(id) : null)\n                      : group.filterFor(id));\n    const built = useMemo(() => {\n        if (!group) return null;\n        return payloadFor(group, filterSel);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [group, filterSel && filterSel.join(\",\")]);\n    const data = built ? built.payload : props.data;\n    rowMapRef.current = built ? built.rowMap : null;\n\n    // Keep the newest callback without making it a rebuild trigger.\n    const onSelectRef = useRef(onSelect);\n    onSelectRef.current = onSelect;\n\n    // BUILD/TEARDOWN \u2014 only when the code identity changes. useLayoutEffect so the chart\n    // paints before the browser does, avoiding a flash of empty container.\n    useLayoutEffect(() => {\n        const el = ref.current;\n        if (!el || (!code && !renderFn) || !data) return;\n        const host = createChartHost(el, { code, renderFn, data, options, d3, geoKind });\n        hostRef.current = host;\n        const off = host.selection.onChange((payloadIdxs, source) => {\n            // \"host\" = a programmatic clear WE issued (below) to drop a stale highlight.\n            // Publishing it would overwrite the selection another chart just made \u2014 the\n            // feedback loop that makes mutual cross-filtering fight itself.\n            if (source === \"host\") return;\n            const map = rowMapRef.current;\n            // Translate to SOURCE indices before anything leaves this chart.\n            const sourceIdxs = map ? payloadIdxs.map(i => map[i]).filter(i => i !== undefined) : payloadIdxs;\n            if (group && id) group.publish(id, sourceIdxs);\n            onSelectRef.current?.(sourceIdxs);\n        });\n        host.render();\n        return () => {\n            // StrictMode double-mount and every unmount land here: stop the timer, drop the\n            // listeners, clear the DOM. Skipping this is the animated-chart leak.\n            off();\n            host.destroy();\n            hostRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [code, renderFn, d3, geoKind]);\n\n    // LIVE RESTYLE \u2014 options change without recompiling (colour scale, aggregation,\n    // animMaxIdealFrames, maxMapPoints\u2026). This is the whole point of setOptions.\n    const optKey = useMemo(() => JSON.stringify(options ?? {}), [options]);\n    useEffect(() => {\n        if (hostRef.current && options) hostRef.current.setOptions(options);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [optKey]);\n\n    // DATA change (including a cross-filter re-derive) \u2014 repaint, never recompile.\n    useEffect(() => {\n        if (hostRef.current && data) hostRef.current.setData(data);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [data]);\n\n    // Drop a STALE highlight: once the group's selection belongs to someone else (or was\n    // cleared), this chart must stop showing its own marks as selected. Without it a\n    // \"Clear\" button empties the filter while the origin chart stays visibly dimmed.\n    useEffect(() => {\n        const host = hostRef.current;\n        if (!host || !group) return;\n        const mine = group.selection.sourceId === id && group.selection.rows.length > 0;\n        if (!mine && host.selection.current && host.selection.current.length) host.selection.clear();\n    }, [group?.selection, id, group]);\n\n    // No children: the chart owns this element's contents.\n    return <div ref={ref} className={className} style={style} />;\n}\n"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/types/geo-us-states.d.ts

@@ -0,0 +1 @@
+export { US_STATES } from "./geoUsStates.generated";

package/dist/types/geo-us-zip3.d.ts

@@ -0,0 +1 @@
+export { US_ZIP3 } from "./geoUsZip3.generated";

package/dist/types/geo-world.d.ts

@@ -0,0 +1 @@
+export { WORLD_110M } from "./geoWorld110m.generated";

package/dist/types/geoLazy.d.ts

@@ -1,3 +1,7 @@
+/** The generated assets, as distinct from the many geoKinds that route to them. */
+export type GeoAssetName = "world" | "us-states" | "us-zip3";
+/** Normalise a server geoKind to the ASSET it needs — the one place that mapping lives. */
+export declare function geoAssetFor(geoKind: string | null | undefined): GeoAssetName | null;
 /**
  * Load (and cache) the geometry for a geoKind. Per-asset dynamic import: requesting a US
  * state map never downloads the 810 KB zip3 asset. Resolves to undefined for an unknown
@@ -5,8 +9,25 @@
  */
 export declare function loadGeo(geoKind: string | null | undefined): Promise<any | undefined>;
 /** Synchronous cache read — what createChartHost uses, so render() stays sync. Returns
- *  undefined until loadGeo() has resolved for this kind (or a provider supplied it). */
+ *  undefined until the geometry has arrived by any of the three routes above. */
 export declare function geoFromCache(geoKind: string | null | undefined): any | undefined;
-/** Seed the cache from geometry the caller already holds — e.g. the MCP's data.geo.json,
- *  or the sync geoForKind from the "@bicharts/chart-host/geo" subpath. */
+/** Seed the cache for ONE EXACT geoKind from geometry the caller already holds — e.g. the
+ *  MCP's data.geo.json, or the sync geoForKind from the "@bicharts/chart-host/geo" subpath. */
 export declare function registerGeo(geoKind: string, geo: any): void;
+/**
+ * Seed the cache for an ASSET, serving every geoKind that routes to it — including the
+ * derived North America basemap once the world asset lands. This is the seam for a host that
+ * bundles some assets and fetches others: pass `WORLD_110M` from
+ * "@bicharts/chart-host/geo/world", or a JSON body parsed off your own CDN. The geometry must
+ * have the shape the generated asset has — a GeoJSON FeatureCollection whose feature.id is the
+ * join key — because generated code binds __geoIso__ against feature.id.
+ */
+export declare function registerGeoAsset(asset: GeoAssetName, geo: any): void;
+/**
+ * Drop every cached FeatureCollection, by kind and by asset. The cache is module-level and
+ * lives as long as the page, which is what a host wants while maps are on screen — this is
+ * the way back out: release ~1 MB when they are not, force a re-fetch of an asset that has
+ * been republished, or start a test from a cold cache. Bundled assets seeded via
+ * registerGeoAsset need re-seeding afterwards; loadGeo re-imports on its own.
+ */
+export declare function clearGeoCache(): void;

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./contract";
 export { resolveOptions, type ResolveOptionsInput } from "./defaults";
-export { loadGeo, geoFromCache, registerGeo } from "./geoLazy";
+export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clearGeoCache, type GeoAssetName, } from "./geoLazy";
 export { buildRenderPayload, type RenderPayload, type GeoPointBinding } from "./payload";
 export { createChartHost, compileRenderFn, type ChartHost, type ChartHostConfig, type RenderFn } from "./host";
 export { createMarkResolver, type MarkResolver, type MarkResolverEnv } from "./selection";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-host",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "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",
@@ -24,6 +24,21 @@
       "import": "./dist/geo.mjs",
       "default": "./dist/geo.mjs"
     },
+    "./geo/world": {
+      "types": "./dist/types/geo-world.d.ts",
+      "import": "./dist/geo-world.mjs",
+      "default": "./dist/geo-world.mjs"
+    },
+    "./geo/us-states": {
+      "types": "./dist/types/geo-us-states.d.ts",
+      "import": "./dist/geo-us-states.mjs",
+      "default": "./dist/geo-us-states.mjs"
+    },
+    "./geo/us-zip3": {
+      "types": "./dist/types/geo-us-zip3.d.ts",
+      "import": "./dist/geo-us-zip3.mjs",
+      "default": "./dist/geo-us-zip3.mjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [