@bicharts/chart-host 0.6.10 → 0.6.12

package/README.md

@@ -178,12 +178,17 @@ basemap — load or provide geometry first.
 ## D3 plugins
 
 Some charts call `d3.sankey()`, `d3.hexbin()` or the voronoi family. Those are separate packages
-that **attach onto the d3 object** — install them and augment the *same* d3 you pass in:
+that **attach onto the d3 object** — install them and pass the host *one* d3 that carries them.
+`import * as d3` is a module namespace, which is frozen, so assigning a plugin onto it throws;
+`assembleD3` builds a plain copy instead:
 
 ```js
-import * as d3 from "d3";
+import * as d3base from "d3";
 import { sankey, sankeyLinkHorizontal } from "d3-sankey";
-Object.assign(d3, { sankey, sankeyLinkHorizontal });
+import { assembleD3 } from "@bicharts/chart-host";
+
+const d3 = assembleD3(d3base, { sankey, sankeyLinkHorizontal });
+createChartHost(el, { code, data, d3 });
 ```
 
 The integration contract returned by `generate_chart` names exactly which ones *your* chart

package/dist/{chunk-M7KJHGZS.mjs → chunk-5IE7AWZY.mjs}

@@ -3334,7 +3334,7 @@ var parseRowIdxs = (s) => (s || "").split(",").map((x2) => parseInt(x2, 10)).fil
 function assembleD3(base, ...plugins) {
   return Object.assign({}, base, ...plugins);
 }
-var D3_PLUGIN_PACKAGES = {
+var D3_PLUGIN_PACKAGES = Object.freeze({
   sankey: "d3-sankey",
   sankeyLinkHorizontal: "d3-sankey",
   sankeyJustify: "d3-sankey",
@@ -3360,7 +3360,7 @@ var D3_PLUGIN_PACKAGES = {
   // host INSTALL for this code to run" and not "which package exports this symbol". For
   // code that calls the helper, the answer is the library the helper reaches for.
   llmMermaid: "mermaid"
-};
+});
 function requiredD3Plugins(code) {
   const out = /* @__PURE__ */ new Set();
   const body = stripJsComments(String(code || ""));
@@ -3384,7 +3384,7 @@ function explainRenderFailure(err, d3) {
   }
   if (typeof d3?.mermaid?.render !== "function" && /\bmermaid\b/i.test(msg)) {
     return new Error(
-      "[@bicharts/chart-host] this chart draws its diagram with Mermaid, which it reaches as d3.mermaid.render(...), and the d3 you passed has no mermaid on it \u2014 this host did not load the library. A host supplies it exactly the way the other plugins are supplied: attach it onto the SAME d3 instance you hand to createChartHost \u2014  npm install mermaid  then  import mermaid from 'mermaid'; Object.assign(d3, { mermaid });  Original error: " + msg
+      "[@bicharts/chart-host] this chart draws its diagram with Mermaid, which it reaches as d3.mermaid.render(...), and the d3 you passed has no mermaid on it \u2014 this host did not load the library. A host supplies it exactly the way the other plugins are supplied: hand createChartHost ONE d3 that carries it, the SAME d3 every chart gets \u2014  npm install mermaid  then  import * as d3base from 'd3'; import mermaid from 'mermaid'; import { assembleD3 } from '@bicharts/chart-host'; const d3 = assembleD3(d3base, { mermaid });  (an ES-module d3 namespace is frozen, so assigning onto it throws)  Original error: " + msg
     );
   }
   const m = /d3\.(\w+) is not a function|(\w+) is not a function/.exec(msg);
@@ -3392,7 +3392,7 @@ function explainRenderFailure(err, d3) {
   const pkg = D3_PLUGIN_PACKAGES[name];
   if (pkg) {
     return new Error(
-      `[@bicharts/chart-host] this chart calls d3.${name}(), which comes from the separate "${pkg}" package and is not attached to the d3 you passed. Install it and augment the SAME d3 instance:  npm install ${pkg}  then  import { ${name} } from "${pkg}"; Object.assign(d3, { ${name} });  Original error: ` + msg
+      `[@bicharts/chart-host] this chart calls d3.${name}(), which comes from the separate "${pkg}" package and is not attached to the d3 you passed. Install it and hand the host ONE d3 that carries it, the SAME d3 every chart gets:  npm install ${pkg}  then  import * as d3base from "d3"; import { ${name} } from "${pkg}"; import { assembleD3 } from "@bicharts/chart-host"; const d3 = assembleD3(d3base, { ${name} });  (an ES-module d3 namespace is frozen, so assigning onto it throws)  Original error: ` + msg
     );
   }
   return err;
@@ -4108,6 +4108,7 @@ export {
   sessionViewStateProvider,
   noopViewStateProvider,
   assembleD3,
+  D3_PLUGIN_PACKAGES,
   requiredD3Plugins,
   explainRenderFailure,
   stripEsmExports,

package/dist/index.mjs

@@ -28,6 +28,7 @@ import {
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
   CONTROL_CLASS,
+  D3_PLUGIN_PACKAGES,
   DARK_TEXT,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
@@ -139,7 +140,7 @@ import {
   unpinScrolledAxis,
   valuePlacementFlag,
   withoutViewOnlyKeys
-} from "./chunk-M7KJHGZS.mjs";
+} from "./chunk-5IE7AWZY.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
@@ -2445,6 +2446,7 @@ export {
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
   CONTROL_CLASS,
+  D3_PLUGIN_PACKAGES,
   DARK_TEXT,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,

package/dist/react.mjs

@@ -7,7 +7,7 @@ import {
   loadGeo,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-M7KJHGZS.mjs";
+} from "./chunk-5IE7AWZY.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/types/host.d.ts

@@ -245,6 +245,7 @@ export interface ChartHost {
  * `requiredD3Plugins(code)` names the plugin packages a given chart needs.
  */
 export declare function assembleD3(base: object, ...plugins: object[]): Record<string, any>;
+export declare const D3_PLUGIN_PACKAGES: Readonly<Record<string, string>>;
 export declare function requiredD3Plugins(code: string): string[];
 export declare function explainRenderFailure(err: unknown, d3: any): unknown;
 export declare function stripEsmExports(code: string): string;

package/dist/types/index.d.ts

@@ -6,7 +6,7 @@ export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clea
 export declare function registerCityTable(packed: string): void;
 export { buildRenderPayload, type RenderPayload, type GeoPointBinding } from "./payload";
 export { codeReadsDatesInLocalTime, vegaSpecReadsDatesInLocalTime } from "./dateCells";
-export { createChartHost, compileRenderFn, stripEsmExports, requiredD3Plugins, explainRenderFailure, sessionViewStateProvider, noopViewStateProvider, assembleD3, type ChartHost, type ChartHostConfig, type RenderFn } from "./host";
+export { createChartHost, compileRenderFn, stripEsmExports, requiredD3Plugins, explainRenderFailure, sessionViewStateProvider, noopViewStateProvider, assembleD3, D3_PLUGIN_PACKAGES, type ChartHost, type ChartHostConfig, type RenderFn } from "./host";
 export { createChartGroup, toSourceRows, syncMemberSelection, type ChartGroup, type ChartGroupMember, type ChartGroupSelection, type ChartGroupChange, type ChartGroupMemberOptions, type ChartGroupSourceOptions, type ChartGroupPayload } from "./group";
 export { createMarkResolver, isInsideControl, type MarkResolver, type MarkResolverEnv } from "./selection";
 export { planTrivialChart, compileTrivialSource, type TrivialPlan, type TrivialShapeKind } from "./trivial";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-host",
-  "version": "0.6.10",
+  "version": "0.6.12",
   "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",