@bicharts/chart-host 0.5.18 → 0.5.20

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-S4W2GTPM.mjs → chunk-TBRWWGJW.mjs}

@@ -24,6 +24,8 @@ var DIM_OPACITY_DEFAULT = 0.25;
 var ANIM_PLAY_SPEED_DEFAULT = 1e3;
 var ANIM_PLAY_SPEED_MIN = 250;
 var ANIM_PLAY_SPEED_MAX = 5e3;
+var ANIM_LOOP_DELAY_DEFAULT = 3;
+var ANIM_LOOP_DELAY_MIN = 0;
 var ANIM_MAX_IDEAL_FRAMES_DEFAULT = 60;
 var ANIM_MAX_IDEAL_FRAMES_MIN = 3;
 var ANIM_MAX_IDEAL_FRAMES_MAX = 500;
@@ -33,6 +35,10 @@ var COLOR_SCALE_SELF_CLAMP_PCT_MAX = 100;
 
 // src/defaults.ts
 var clamp = (n, lo, hi) => Math.max(lo, Math.min(hi, n));
+var numberOr = (raw, dflt) => {
+  const n = raw == null || raw === "" ? NaN : Number(raw);
+  return Number.isFinite(n) ? n : dflt;
+};
 function resolveOptions(p2) {
   return {
     // ---- host fields: pass through exactly as supplied ----
@@ -71,11 +77,36 @@ function resolveOptions(p2) {
     animAutoPlay: !!p2.animAutoPlay,
     // Math.max(250, Math.min(5000, Number(raw) || 1000))
     animPlaySpeedMs: clamp(Number(p2.animPlaySpeedMs) || ANIM_PLAY_SPEED_DEFAULT, ANIM_PLAY_SPEED_MIN, ANIM_PLAY_SPEED_MAX),
+    // Loop-restart delay (seconds on the overview between auto-play passes).
+    // Floored at 0, deliberately NO upper clamp (huge = play once per viewing),
+    // and 0 must survive as 0 — hence numberOr, not `|| DEFAULT`. This field was
+    // MISSING from the resolve list when the assembly moved here, so callers
+    // that passed it saw it dropped: the scrubber read undefined -> 0 -> every
+    // pass restarted instantly and resumed-state auto-play lost its pacing.
+    animLoopDelaySec: Math.max(ANIM_LOOP_DELAY_MIN, numberOr(p2.animLoopDelaySec, ANIM_LOOP_DELAY_DEFAULT)),
     // Math.max(3, Math.min(500, Number(raw) || 60))
     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,
+    // 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))
   };
 }
 
@@ -1209,6 +1240,8 @@ export {
   ANIM_PLAY_SPEED_DEFAULT,
   ANIM_PLAY_SPEED_MIN,
   ANIM_PLAY_SPEED_MAX,
+  ANIM_LOOP_DELAY_DEFAULT,
+  ANIM_LOOP_DELAY_MIN,
   ANIM_MAX_IDEAL_FRAMES_DEFAULT,
   ANIM_MAX_IDEAL_FRAMES_MIN,
   ANIM_MAX_IDEAL_FRAMES_MAX,

package/dist/index.mjs

@@ -1,5 +1,7 @@
 /*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
 import {
+  ANIM_LOOP_DELAY_DEFAULT,
+  ANIM_LOOP_DELAY_MIN,
   ANIM_MAX_IDEAL_FRAMES_DEFAULT,
   ANIM_MAX_IDEAL_FRAMES_MAX,
   ANIM_MAX_IDEAL_FRAMES_MIN,
@@ -39,7 +41,7 @@ import {
   requiredD3Plugins,
   resolveOptions,
   stripEsmExports
-} from "./chunk-S4W2GTPM.mjs";
+} from "./chunk-TBRWWGJW.mjs";
 import "./chunk-A2GMXZP7.mjs";
 
 // src/trivial.ts
@@ -319,6 +321,8 @@ function registerCityTable(packed) {
   L3(packed);
 }
 export {
+  ANIM_LOOP_DELAY_DEFAULT,
+  ANIM_LOOP_DELAY_MIN,
   ANIM_MAX_IDEAL_FRAMES_DEFAULT,
   ANIM_MAX_IDEAL_FRAMES_MAX,
   ANIM_MAX_IDEAL_FRAMES_MIN,

package/dist/react.mjs

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

package/dist/types/contract.d.ts

@@ -23,6 +23,8 @@ export declare const DIM_OPACITY_DEFAULT = 0.25;
 export declare const ANIM_PLAY_SPEED_DEFAULT = 1000;
 export declare const ANIM_PLAY_SPEED_MIN = 250;
 export declare const ANIM_PLAY_SPEED_MAX = 5000;
+export declare const ANIM_LOOP_DELAY_DEFAULT = 3;
+export declare const ANIM_LOOP_DELAY_MIN = 0;
 export declare const ANIM_MAX_IDEAL_FRAMES_DEFAULT = 60;
 export declare const ANIM_MAX_IDEAL_FRAMES_MIN = 3;
 export declare const ANIM_MAX_IDEAL_FRAMES_MAX = 500;
@@ -70,9 +72,12 @@ export interface RenderOptions {
     noDataText?: string;
     animAutoPlay?: boolean;
     animPlaySpeedMs?: number;
+    animLoopDelaySec?: number;
     animMaxIdealFrames?: number;
     animStopAtEnd?: boolean;
     filtersDuringPlay?: boolean;
     animTimelineStyle?: TimelineStyle;
+    flipSync?: boolean;
+    flipIntervalMs?: number;
     onSelect?: (rowIdxs: number[]) => void;
 }

package/package.json

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