@bicharts/chart-host 0.6.48 → 0.6.50

package/dist/{chunk-YD3QWCEP.mjs → chunk-P4FOCNAX.mjs}

@@ -493,6 +493,7 @@ var COLOR_SCALE_SELF_CLAMP_PCT_MAX = 100;
 var FLIP_MODE_DEFAULT = "both";
 var FLIP_INTERVAL_MIN_MS = 500;
 var FLIP_INTERVAL_MAX_MS = 12e4;
+var FLIP_DIRECTION_DEFAULT = "horizontal";
 var APPROXIMATE_POSITIONS_DEFAULT = "mark";
 var VALUE_AXIS_BASELINE_DEFAULT = "fit";
 var SEASONAL_MARKERS_DEFAULT = "auto";
@@ -938,6 +939,13 @@ function resolveOptions(p4) {
       if (p4.flipSync === true) return "all";
       return FLIP_MODE_DEFAULT;
     })(),
+    // WHICH WAY A FACE TURNS. Anything unrecognised - including absent, which is every host
+    // that predates the option - is the default, side to side, which is what every chart that
+    // turns did before it existed.
+    flipDirection: (() => {
+      const d2 = (p4.flipDirection == null ? "" : String(p4.flipDirection)).toLowerCase();
+      return d2 === "horizontal" || d2 === "vertical" ? d2 : FLIP_DIRECTION_DEFAULT;
+    })(),
     // 0 is MEANINGFUL here (manual only), so numberOr — not `|| DEFAULT` — for the same
     // reason animLoopDelaySec uses it. UNSET STAYS UNSET (undefined), because the default is
     // the CHART's, not this function's: the card deck reads `+(x || 0)` and is manual, a
@@ -4365,6 +4373,7 @@ function createChartGroup(columns, rows, opts = {}) {
   let table = rows;
   let geo = opts.geo ?? null;
   let point = opts.point ?? null;
+  let destination = opts.destination ?? null;
   let selection = EMPTY6;
   const subs = /* @__PURE__ */ new Set();
   const members = /* @__PURE__ */ new Set();
@@ -4380,7 +4389,13 @@ function createChartGroup(columns, rows, opts = {}) {
   const payloadFor = (sourceRowIdxs) => {
     const idxs = sourceRowIdxs ? sourceRowIdxs.slice() : table.map((_4, i) => i);
     const subset = idxs.map((i) => table[i]);
-    const payload = buildRenderPayload(cols, subset, geo ?? void 0, point ?? void 0);
+    const payload = buildRenderPayload(
+      cols,
+      subset,
+      geo ?? void 0,
+      point ?? void 0,
+      destination ?? void 0
+    );
     return { payload, rowMap: idxs };
   };
   const memberPayload = (id, o4 = {}) => payloadFor(o4.respondsWith === "highlight" ? null : incomingFor(id, o4.filteredBy));
@@ -4410,6 +4425,7 @@ function createChartGroup(columns, rows, opts = {}) {
       table = nextRows;
       geo = o4.geo ?? null;
       point = o4.point ?? null;
+      destination = o4.destination ?? null;
       notify("source");
     },
     onChange(cb) {
@@ -4502,6 +4518,7 @@ export {
   FLIP_MODE_DEFAULT,
   FLIP_INTERVAL_MIN_MS,
   FLIP_INTERVAL_MAX_MS,
+  FLIP_DIRECTION_DEFAULT,
   APPROXIMATE_POSITIONS_DEFAULT,
   VALUE_AXIS_BASELINE_DEFAULT,
   SEASONAL_MARKERS_DEFAULT,

package/dist/index.mjs

@@ -33,6 +33,7 @@ import {
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
   FIT_CONTENT_SELECTOR,
+  FLIP_DIRECTION_DEFAULT,
   FLIP_INTERVAL_MAX_MS,
   FLIP_INTERVAL_MIN_MS,
   FLIP_MODE_DEFAULT,
@@ -162,7 +163,7 @@ import {
   unpinScrolledAxis,
   valuePlacementFlag,
   withoutViewOnlyKeys
-} from "./chunk-YD3QWCEP.mjs";
+} from "./chunk-P4FOCNAX.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
@@ -203,6 +204,8 @@ var OPTIONS_VOCABULARY = Object.freeze({
    * clamped chart-side to FLIP_INTERVAL_MIN_MS..FLIP_INTERVAL_MAX_MS.
    */
   flipIntervalMs: entry({ timing: "live", default: "", min: 0, max: FLIP_INTERVAL_MAX_MS }),
+  /** Which way a face turns, for any chart that turns between faces: side to side, or top to bottom. */
+  flipDirection: entry({ timing: "live", default: FLIP_DIRECTION_DEFAULT, values: ["horizontal", "vertical"] }),
   // ---- the next generated chart ----
   levelOfDetail: entry({ timing: "next-generate", default: "", values: ["", "High", "Medium", "Low"], wire: "clientHints" }),
   favorLimitTo: entry({ timing: "next-generate", default: "", values: ["", "latest", "top / greatest", "bottom / smallest", "most common", "outliers"], wire: "clientHints" }),
@@ -2818,6 +2821,7 @@ export {
   FILTER_MIN_WIDTH_PX,
   FILTER_ROW_PX,
   FIT_CONTENT_SELECTOR,
+  FLIP_DIRECTION_DEFAULT,
   FLIP_INTERVAL_MAX_MS,
   FLIP_INTERVAL_MIN_MS,
   FLIP_MODE_DEFAULT,

package/dist/react.mjs

@@ -7,7 +7,7 @@ import {
   loadGeo,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-YD3QWCEP.mjs";
+} from "./chunk-P4FOCNAX.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
@@ -23,15 +23,15 @@ function useBicSelection() {
     clear: () => g?.group.clear()
   };
 }
-function BicChartGroup({ rows, columns, geo, point, children }) {
+function BicChartGroup({ rows, columns, geo, point, destination, children }) {
   const groupRef = useRef(null);
-  if (!groupRef.current) groupRef.current = createChartGroup(columns, rows, { geo, point });
+  if (!groupRef.current) groupRef.current = createChartGroup(columns, rows, { geo, point, destination });
   const group = groupRef.current;
   const [sel, setSel] = useState(group.selection);
   const source = useMemo(() => {
-    group.setSource(columns, rows, { geo, point });
+    group.setSource(columns, rows, { geo, point, destination });
     return {};
-  }, [group, rows, columns, geo, point]);
+  }, [group, rows, columns, geo, point, destination]);
   useEffect(() => group.onChange((s, change) => {
     if (change !== "source") setSel(s);
   }), [group]);

package/dist/types/contract.d.ts

@@ -75,6 +75,8 @@ export type FlipMode = "" | "single" | "all" | "both";
 export declare const FLIP_MODE_DEFAULT: FlipMode;
 export declare const FLIP_INTERVAL_MIN_MS = 500;
 export declare const FLIP_INTERVAL_MAX_MS = 120000;
+export type FlipDirection = "horizontal" | "vertical";
+export declare const FLIP_DIRECTION_DEFAULT: FlipDirection;
 export type ApproximatePositions = "mark" | "aggregate" | "skip";
 export declare const APPROXIMATE_POSITIONS_DEFAULT: ApproximatePositions;
 export type ValueAxisBaseline = "zero" | "fit" | "auto";
@@ -148,6 +150,7 @@ export interface RenderOptions {
     flipSync?: boolean;
     flipIntervalMs?: number;
     flipMode?: FlipMode;
+    flipDirection?: FlipDirection;
     cardBackgroundColor?: string;
     onSelect?: (rowIdxs: number[]) => void;
     /**

package/dist/types/group.d.ts

@@ -14,6 +14,12 @@ export interface ChartGroupSourceOptions {
     } | null;
     /** Point-map geocoding binding (city/state/zip/lat/lon column names). */
     point?: GeoPointBinding | null;
+    /**
+     * A route's far end (an origin-destination flow map): `point` is then the origin. The same
+     * binding buildRenderPayload takes, so the group builds the destination columns too instead of
+     * leaving a hosted flow map with one end.
+     */
+    destination?: GeoPointBinding | null;
 }
 /** How one member takes part in the group. */
 export interface ChartGroupMemberOptions {

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, CONTROL_CLASS, NO_ROW_MARKS_ATTR, SNAPSHOT_SVG_ATTR, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, chartOwnsTimeline, periodTickSuppressesFeedback, 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, ANIMATION_OPTION_KEYS, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, FLIP_INTERVAL_MIN_MS, FLIP_INTERVAL_MAX_MS, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, type ChartControlChange, } from "./contract";
+export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, CONTROL_CLASS, NO_ROW_MARKS_ATTR, SNAPSHOT_SVG_ATTR, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, chartOwnsTimeline, periodTickSuppressesFeedback, 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, ANIMATION_OPTION_KEYS, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, FLIP_INTERVAL_MIN_MS, FLIP_INTERVAL_MAX_MS, FLIP_DIRECTION_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type FlipDirection, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, type ChartControlChange, } from "./contract";
 export { resolveOptions, type ResolveOptionsInput } from "./defaults";
 export { OPTIONS_VOCABULARY, LIVE_OPTION_KEYS, MAX_MAP_POINTS_MIN, MAX_MAP_POINTS_MAX, LIMIT_COUNT_MAX, wireLimitCount, type OptionVocabularyEntry, type OptionTiming, type OptionWire, type OptionKey, } from "./optionsVocabulary";
 export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clearGeoCache, type GeoAssetName, } from "./geoLazy";

package/dist/types/optionsVocabulary.d.ts

@@ -58,6 +58,8 @@ export declare const OPTIONS_VOCABULARY: Readonly<{
      * clamped chart-side to FLIP_INTERVAL_MIN_MS..FLIP_INTERVAL_MAX_MS.
      */
     flipIntervalMs: OptionVocabularyEntry;
+    /** Which way a face turns, for any chart that turns between faces: side to side, or top to bottom. */
+    flipDirection: OptionVocabularyEntry;
     levelOfDetail: OptionVocabularyEntry;
     favorLimitTo: OptionVocabularyEntry;
     /** 0 asks for no limit, and travels as absent (`wireLimitCount`): any value the server receives is a limit. */

package/dist/types/react.d.ts

@@ -81,6 +81,8 @@ export interface BicChartGroupProps {
     } | null;
     /** Point-map geocoding binding (city/state/zip/lat/lon column names). */
     point?: GeoPointBinding | null;
+    /** A route's far end (an origin-destination flow map); `point` is then the origin. */
+    destination?: GeoPointBinding | null;
     children: ReactNode;
 }
 /**
@@ -88,7 +90,7 @@ export interface BicChartGroupProps {
  * `filteredBy`; the group re-derives the filtered member's payload and translates row
  * indices in both directions, so a click in one chart filters another CORRECTLY.
  */
-export declare function BicChartGroup({ rows, columns, geo, point, children }: BicChartGroupProps): import("react").JSX.Element;
+export declare function BicChartGroup({ rows, columns, geo, point, destination, children }: BicChartGroupProps): import("react").JSX.Element;
 export declare function BicChart(props: BicChartProps): import("react").JSX.Element;
 /**
  * THE SIZE A CHART SHOULD DRAW AT: the element's measured box, kept current as it resizes.

package/package.json

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