@bicharts/chart-host 0.2.0 → 0.3.0

package/README.md

@@ -120,6 +120,19 @@ The integration contract returned by `generate_chart` names exactly which ones *
 needs. If one is missing, the host throws a message naming the package instead of a bare
 `d3.sankey is not a function`.
 
+You can also ask the code itself, *before* rendering it — which is what you want when the chart
+arrives at run time and a blank frame is not an acceptable answer:
+
+```js
+import { requiredD3Plugins } from "@bicharts/chart-host";
+
+requiredD3Plugins(code);            // -> ["d3-sankey"]  (sorted, deduped, [] for core-only d3)
+```
+
+It is a static scan, not a trial render: synchronous, side-effect free, and safe to run on
+generated code you have not executed yet. It errs toward naming a plugin the chart may not
+reach — a needless install is cheaper than a blank chart.
+
 ## Selection styling
 
 Generated code emits marks and `data-row-idx`; it never styles "selected", because only the host

package/dist/{chunk-ARQZJCD4.mjs → chunk-4DULDBNH.mjs}

@@ -742,6 +742,14 @@ var D3_PLUGIN_PACKAGES = {
   voronoiMap: "d3-voronoi-map",
   weightedVoronoi: "d3-weighted-voronoi"
 };
+function requiredD3Plugins(code) {
+  const out = /* @__PURE__ */ new Set();
+  for (const m3 of String(code || "").matchAll(/\bd3\s*\.\s*(\w+)\s*\(/g)) {
+    const pkg = D3_PLUGIN_PACKAGES[m3[1]];
+    if (pkg) out.add(pkg);
+  }
+  return [...out].sort();
+}
 function explainRenderFailure(err, d3) {
   const msg = String(err?.message ?? err ?? "");
   if (!d3) {
@@ -1013,6 +1021,8 @@ export {
   clearGeoCache,
   buildRenderPayload,
   createMarkResolver,
+  requiredD3Plugins,
+  explainRenderFailure,
   compileRenderFn,
   createChartHost
 };

package/dist/index.mjs

@@ -29,13 +29,15 @@ import {
   compileRenderFn,
   createChartHost,
   createMarkResolver,
+  explainRenderFailure,
   geoAssetFor,
   geoFromCache,
   loadGeo,
   registerGeo,
   registerGeoAsset,
+  requiredD3Plugins,
   resolveOptions
-} from "./chunk-ARQZJCD4.mjs";
+} from "./chunk-4DULDBNH.mjs";
 import "./chunk-A2GMXZP7.mjs";
 export {
   ANIM_MAX_IDEAL_FRAMES_DEFAULT,
@@ -67,10 +69,12 @@ export {
   compileRenderFn,
   createChartHost,
   createMarkResolver,
+  explainRenderFailure,
   geoAssetFor,
   geoFromCache,
   loadGeo,
   registerGeo,
   registerGeoAsset,
+  requiredD3Plugins,
   resolveOptions
 };

package/dist/react.mjs

@@ -2,7 +2,7 @@
 import {
   buildRenderPayload,
   createChartHost
-} from "./chunk-ARQZJCD4.mjs";
+} from "./chunk-4DULDBNH.mjs";
 import "./chunk-A2GMXZP7.mjs";
 
 // src/react.tsx

package/dist/types/host.d.ts

@@ -56,6 +56,7 @@ export interface ChartHost {
     initialMark(): Element | null;
     destroy(): void;
 }
+export declare function requiredD3Plugins(code: string): string[];
 export declare function explainRenderFailure(err: unknown, d3: any): unknown;
 export declare function compileRenderFn(code: string, win: any, doc: any, d3: any): RenderFn;
 export declare function createChartHost(container: HTMLElement, config: ChartHostConfig): ChartHost;

package/dist/types/index.d.ts

@@ -2,5 +2,5 @@ export * from "./contract";
 export { resolveOptions, type ResolveOptionsInput } from "./defaults";
 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 { createChartHost, compileRenderFn, requiredD3Plugins, explainRenderFailure, 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.2.0",
+  "version": "0.3.0",
   "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",