@bicharts/chart-host 0.5.50 → 0.5.51

package/dist/react.mjs

@@ -49,6 +49,7 @@ function BicChart(props) {
     options,
     d3,
     geoKind,
+    viewState,
     id,
     filteredBy,
     respondsWith,
@@ -89,7 +90,7 @@ function BicChart(props) {
   useLayoutEffect(() => {
     const el = ref.current;
     if (!el || !code && !renderFn || !data) return;
-    const host = createChartHost(el, { code, renderFn, data, options, d3, geoKind });
+    const host = createChartHost(el, { code, renderFn, data, options, d3, geoKind, viewState });
     hostRef.current = host;
     const off = host.selection.onChange((payloadIdxs, source) => {
       if (source === "host") return;

package/dist/types/react.d.ts

@@ -15,6 +15,16 @@ export interface BicChartProps {
     d3: any;
     /** Attach the bundled geometry for this kind as options.geo (choropleth or basemap). */
     geoKind?: string;
+    /**
+     * WHERE THIS APP KEEPS THE CHART'S RESTING VIEW-STATE - a sort, an expanded row, a 3D
+     * camera. Omit for the session store parked on the container element, which is the right
+     * answer for most pages: the chart remembers while it is mounted and forgets on reload.
+     *
+     * Supply one to outlive the page. A React app is the host that most often has somewhere
+     * better to put it - localStorage, a URL query, a user profile on the server - and no
+     * default could pick between them, which is why this is a prop rather than a flag.
+     */
+    viewState?: ChartHostConfig["viewState"];
     /** Identity within a <BicChartGroup> — the key other charts filter by. */
     id?: string;
     /** Take this group member's selection as a filter on THIS chart's rows. */

package/package.json

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