@bicharts/chart-host 0.5.19 → 0.5.21

package/README.md

@@ -1,5 +1,10 @@
 # @bicharts/chart-host
 
+> **Make Generative AI for Charts *Better*.**
+
+That is what **RegiaBI** is for; this package is the part that runs the result in your page,
+so a generated chart behaves the same wherever it lands.
+
 Run a D3 chart generated by
 [Business Intelligence Champions](https://bizintelligencechampions.com) (BIC) in any web page.
 

package/dist/{chunk-P2NWAYI7.mjs → chunk-QIF3TAVP.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));
@@ -88,7 +89,48 @@ function resolveOptions(p2) {
     animMaxIdealFrames: clamp(Number(p2.animMaxIdealFrames) || ANIM_MAX_IDEAL_FRAMES_DEFAULT, ANIM_MAX_IDEAL_FRAMES_MIN, ANIM_MAX_IDEAL_FRAMES_MAX),
     animStopAtEnd: !!p2.animStopAtEnd,
     filtersDuringPlay: !!p2.filtersDuringPlay,
-    animTimelineStyle: (p2.animTimelineStyle || "").toString()
+    animTimelineStyle: (p2.animTimelineStyle || "").toString(),
+    // ---- card deck ----
+    // SECOND OCCURRENCE OF THE animLoopDelaySec BUG, six lines above (2026-08-13). The
+    // visual passed both of these, the generated code read both correctly, and this
+    // function — a whitelist that returns a NEW object — dropped them in between. Symptoms
+    // were exactly what the two defaults produce: flipSync undefined -> `!== false` -> true
+    // -> always synced, so "Flip Cards Together = Off" did nothing and the deck kept its
+    // shared strip; flipIntervalMs undefined -> `+(undefined || 0)` -> 0 -> the timer branch
+    // never ran, so a 1000 ms interval produced no flips. Two dead knobs, one omission.
+    //
+    // flipSync DEFAULTS TRUE, so it cannot use `!!p.flipSync` — that would read a missing
+    // 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)),
+    // `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
   };
 }
 
@@ -1230,6 +1272,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-P2NWAYI7.mjs";
+} from "./chunk-QIF3TAVP.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-P2NWAYI7.mjs";
+} from "./chunk-QIF3TAVP.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;
@@ -77,5 +79,9 @@ export interface RenderOptions {
     animStopAtEnd?: boolean;
     filtersDuringPlay?: boolean;
     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.19",
+  "version": "0.5.21",
   "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",