@bicharts/chart-host 0.5.20 → 0.5.22

package/dist/{chunk-TBRWWGJW.mjs → chunk-65LTZEX6.mjs}

@@ -32,6 +32,7 @@ var ANIM_MAX_IDEAL_FRAMES_MAX = 500;
 var COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT = 95;
 var COLOR_SCALE_SELF_CLAMP_PCT_MIN = 50;
 var COLOR_SCALE_SELF_CLAMP_PCT_MAX = 100;
+var FLIP_MODE_DEFAULT = "both";
 
 // src/defaults.ts
 var clamp = (n, lo, hi) => Math.max(lo, Math.min(hi, n));
@@ -102,11 +103,34 @@ function resolveOptions(p2) {
     // value as "independent" and hand every deck twelve control strips. Absent means
     // synced; only an explicit false switches it.
     flipSync: p2.flipSync === void 0 || p2.flipSync === null ? true : !!p2.flipSync,
+    // WHERE the controls live, which is a different question from whether the cards move
+    // together (Joel 2026-08-13: "the ability to flip individual cards shouldn't necessarily
+    // stop being able to flip all together too"). Resolution order matters and is the whole
+    // back-compat story:
+    //   1. an explicit, recognised flipMode wins;
+    //   2. otherwise DERIVE from flipSync, so a chart generated before this option existed
+    //      behaves exactly as it did - true -> "all", false -> "single";
+    //   3. and a caller that sends neither gets the default.
+    // Deriving rather than defaulting is the point: a cached chart must not change behaviour
+    // because a newer client shipped, and "both" would have done exactly that to every deck
+    // already in a report.
+    flipMode: (() => {
+      const m2 = (p2.flipMode == null ? "" : String(p2.flipMode)).toLowerCase();
+      if (m2 === "single" || m2 === "all" || m2 === "both") return m2;
+      if (p2.flipSync === false) return "single";
+      if (p2.flipSync === true) return "all";
+      return FLIP_MODE_DEFAULT;
+    })(),
     // 0 is MEANINGFUL here (manual only) and is the default, so numberOr — not
     // `|| DEFAULT` — for the same reason animLoopDelaySec uses it. Clamping stays
     // chart-side: the archetype already clamps 500..120000 and two clamps in two
     // repositories is how they end up disagreeing.
-    flipIntervalMs: Math.max(0, numberOr(p2.flipIntervalMs, 0))
+    flipIntervalMs: Math.max(0, numberOr(p2.flipIntervalMs, 0)),
+    // `raw || undefined`, the same idiom as the colour-scale endpoints and the map fills:
+    // blank must arrive as ABSENT, not as an empty string, because the chart's fallback is
+    // `options.cardBackgroundColor || <its own choice>` and "" would satisfy a truthiness
+    // test in some hands while painting nothing in others.
+    cardBackgroundColor: p2.cardBackgroundColor || void 0
   };
 }
 
@@ -996,6 +1020,11 @@ var ESM_EXPORT_DECL = /^([ \t]*)export[ \t]+(?=(?:async[ \t]+)?function\b|const\
 function stripEsmExports(code) {
   return String(code || "").replace(ESM_EXPORT_CLAUSE, "").replace(ESM_EXPORT_DECL, "$1");
 }
+function writableD3(d3) {
+  if (d3 == null || typeof d3 !== "object") return d3;
+  if (Object.isExtensible(d3)) return d3;
+  return { ...d3 };
+}
 function compileRenderFn(code, win, doc, d3) {
   const body = stripEsmExports(code) + "\n;return (typeof render === 'function') ? render : null;";
   let factory;
@@ -1008,7 +1037,7 @@ function compileRenderFn(code, win, doc, d3) {
       "[@bicharts/chart-host] the generated code could not be COMPILED, so nothing was drawn. This path evaluates the chart as a code string, which cannot contain ES-module syntax" + (modular ? " \u2014 and this code still has `import`/`export` in it after the export clause was stripped. Either request the plain form from the generator, or `import` the module yourself and pass the render function directly." : ".") + " Original error: " + msg
     );
   }
-  const fn = factory.call(null, null, null, null, win, doc, d3);
+  const fn = factory.call(null, null, null, null, win, doc, writableD3(d3));
   if (typeof fn !== "function") throw new Error("generated code did not define render(container, data, options)");
   return fn;
 }
@@ -1248,6 +1277,7 @@ export {
   COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT,
   COLOR_SCALE_SELF_CLAMP_PCT_MIN,
   COLOR_SCALE_SELF_CLAMP_PCT_MAX,
+  FLIP_MODE_DEFAULT,
   resolveOptions,
   geoAssetFor,
   loadGeo,

package/dist/index.mjs

@@ -17,6 +17,7 @@ import {
   CONTAINER_SLOT_XF_CLEAR,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
+  FLIP_MODE_DEFAULT,
   GEO_POINT_PRECISIONS,
   HOST_CONTAINER_CLASS,
   HOST_CONTRACT_VERSION,
@@ -41,7 +42,7 @@ import {
   requiredD3Plugins,
   resolveOptions,
   stripEsmExports
-} from "./chunk-TBRWWGJW.mjs";
+} from "./chunk-65LTZEX6.mjs";
 import "./chunk-A2GMXZP7.mjs";
 
 // src/trivial.ts
@@ -338,6 +339,7 @@ export {
   CONTAINER_SLOT_XF_CLEAR,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
+  FLIP_MODE_DEFAULT,
   GEO_POINT_PRECISIONS,
   HOST_CONTAINER_CLASS,
   HOST_CONTRACT_VERSION,

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-TBRWWGJW.mjs";
+} from "./chunk-65LTZEX6.mjs";
 import "./chunk-A2GMXZP7.mjs";
 
 // src/react.tsx

package/dist/types/contract.d.ts

@@ -32,6 +32,8 @@ export declare const COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT = 95;
 export declare const COLOR_SCALE_SELF_CLAMP_PCT_MIN = 50;
 export declare const COLOR_SCALE_SELF_CLAMP_PCT_MAX = 100;
 export type TimelineStyle = "" | "line" | "boxes";
+export type FlipMode = "" | "single" | "all" | "both";
+export declare const FLIP_MODE_DEFAULT: FlipMode;
 export type ColorScaleScope = "" | "frame" | "self";
 export interface RenderOptions {
     width: number;
@@ -79,5 +81,7 @@ export interface RenderOptions {
     animTimelineStyle?: TimelineStyle;
     flipSync?: boolean;
     flipIntervalMs?: number;
+    flipMode?: FlipMode;
+    cardBackgroundColor?: string;
     onSelect?: (rowIdxs: number[]) => void;
 }

package/package.json

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