@bicharts/chart-host 0.5.94 → 0.5.96

package/dist/{chunk-IIBDCQJM.mjs → chunk-RM26QUBN.mjs}

@@ -474,6 +474,7 @@ var FLIP_MODE_DEFAULT = "both";
 var APPROXIMATE_POSITIONS_DEFAULT = "mark";
 var VALUE_AXIS_BASELINE_DEFAULT = "fit";
 var SEASONAL_MARKERS_DEFAULT = "auto";
+var MAX_MAP_POINTS_DEFAULT = 2e3;
 
 // src/defaults.ts
 var clamp = (n, lo, hi) => Math.max(lo, Math.min(hi, n));
@@ -498,7 +499,15 @@ function resolveOptions(p2) {
     // tests/defaults.test.ts now compares the two lists, because four instances of one
     // omission is a missing check, not four mistakes.
     geoPointDest: p2.geoPointDest,
-    maxMapPoints: p2.maxMapPoints,
+    // NO LONGER A PASS-THROUGH. A host without a Max Map Points setting used to leave this
+    // undefined, and every map chart then fell back to whatever number its own code carried -
+    // 1000 in every archetype written so far - while the offer gate used the server's. One
+    // default here makes the chart and the gate agree in every host. A positive value from
+    // the host wins; absent, blank, zero or junk means the shared default.
+    maxMapPoints: (() => {
+      const n = numberOr(p2.maxMapPoints, 0);
+      return n > 0 ? Math.round(n) : MAX_MAP_POINTS_DEFAULT;
+    })(),
     // FIFTH AND SIXTH OCCURRENCES, and the two that argue hardest for the guard test: both
     // were passed by the visual AND read by the charts, and neither was ever declared here or
     // in the contract - so the contract-vs-whitelist check could not see them either. What
@@ -3204,6 +3213,7 @@ export {
   APPROXIMATE_POSITIONS_DEFAULT,
   VALUE_AXIS_BASELINE_DEFAULT,
   SEASONAL_MARKERS_DEFAULT,
+  MAX_MAP_POINTS_DEFAULT,
   resolveOptions,
   geoAssetFor,
   loadGeo,

package/dist/index.mjs

@@ -44,6 +44,7 @@ import {
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   MAX_FRAME_GROW_FACTOR,
+  MAX_MAP_POINTS_DEFAULT,
   MIN_CONTRAST,
   MIN_HIT_BAND_PX,
   MIN_RAMP_FILLS,
@@ -117,7 +118,7 @@ import {
   toRGBA,
   u,
   unpinScrolledAxis
-} from "./chunk-IIBDCQJM.mjs";
+} from "./chunk-RM26QUBN.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
@@ -1941,9 +1942,16 @@ Mt.config = function(t2) {
 
 // src/palette.ts
 var MIN_DELTA_E = 10;
-function pickDistinctColorFromSeed(seedHex, existing, minDistance = MIN_DELTA_E) {
+var LEGIBLE_LIGHTNESS = [15, 85];
+function pickDistinctColorFromSeed(seedHex, existing, minDistance = MIN_DELTA_E, options = {}) {
   const existingCs = [...existing].map((c2) => Mt(c2));
   const seed = Mt(seedHex);
+  const band = options.lightnessBand === void 0 ? LEGIBLE_LIGHTNESS : options.lightnessBand;
+  const legible = (c2) => {
+    if (!band) return true;
+    const l2 = c2.hsl()[2];
+    return l2 > band[0] && l2 < band[1];
+  };
   const minDeltaE = (c2) => existingCs.length === 0 ? Number.POSITIVE_INFINITY : Math.min(...existingCs.map((c22) => c2.deltaE(c22, "CIE2000")));
   if (minDeltaE(seed) >= minDistance) {
     const hex = seed.hex();
@@ -1952,6 +1960,7 @@ function pickDistinctColorFromSeed(seedHex, existing, minDistance = MIN_DELTA_E)
   let bestCandidate = seed;
   let bestMinDist = minDeltaE(seed);
   const tryVariant = (c2) => {
+    if (!legible(c2)) return null;
     const d2 = minDeltaE(c2);
     if (d2 >= minDistance) {
       const hex = c2.hex();
@@ -1977,10 +1986,10 @@ function pickDistinctColorFromSeed(seedHex, existing, minDistance = MIN_DELTA_E)
   }
   return { hex: seed.hex(), registerHex: bestCandidate.hex() };
 }
-function buildPaletteFromSeed(seedHex, count, minDistance = MIN_DELTA_E) {
-  return buildPalette(() => seedHex, count, minDistance);
+function buildPaletteFromSeed(seedHex, count, minDistance = MIN_DELTA_E, options = {}) {
+  return buildPalette(() => seedHex, count, minDistance, options);
 }
-function buildPalette(seedFor, count, minDistance = MIN_DELTA_E) {
+function buildPalette(seedFor, count, minDistance = MIN_DELTA_E, options = {}) {
   const out = [];
   if (!(count > 0)) return out;
   const issued = /* @__PURE__ */ new Set();
@@ -1999,7 +2008,7 @@ function buildPalette(seedFor, count, minDistance = MIN_DELTA_E) {
     if (!seedHex) seedHex = lastSeed;
     if (!seedHex) break;
     lastSeed = seedHex;
-    const { hex, registerHex } = pickDistinctColorFromSeed(seedHex, issued, minDistance);
+    const { hex, registerHex } = pickDistinctColorFromSeed(seedHex, issued, minDistance, options);
     let chosen = hex;
     let register = registerHex;
     if (distance(chosen) < minDistance) {
@@ -2120,11 +2129,13 @@ export {
   LABEL_CONTRAST_CAP,
   LABEL_CONTRAST_DONE_ATTR,
   LEGEND_MARK_CLASS,
+  LEGIBLE_LIGHTNESS,
   LIFT_SELECTED_CLASS,
   LIGHT_TEXT,
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   MAX_FRAME_GROW_FACTOR,
+  MAX_MAP_POINTS_DEFAULT,
   MIN_CONTRAST,
   MIN_DELTA_E,
   MIN_HIT_BAND_PX,

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-IIBDCQJM.mjs";
+} from "./chunk-RM26QUBN.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/types/contract.d.ts

@@ -71,6 +71,7 @@ export type ValueAxisBaseline = "zero" | "fit" | "auto";
 export declare const VALUE_AXIS_BASELINE_DEFAULT: ValueAxisBaseline;
 export type SeasonalMarkers = "auto" | "always" | "never";
 export declare const SEASONAL_MARKERS_DEFAULT: SeasonalMarkers;
+export declare const MAX_MAP_POINTS_DEFAULT = 2000;
 export type ColorScaleScope = "" | "frame" | "self";
 export interface RenderOptions {
     width: number;

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, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, 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, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, } from "./contract";
+export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, 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, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, 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, } from "./contract";
 export { resolveOptions, type ResolveOptionsInput } from "./defaults";
 export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clearGeoCache, type GeoAssetName, } from "./geoLazy";
 /** REPLACE the bundled city gazetteer with another packed table. Rarely needed — see the
@@ -27,5 +27,5 @@ export { SCROLL_SLACK_PX, MAX_FRAME_GROW_FACTOR, PHANTOM_FRACTION, FIT_CONTENT_S
 export { fitRenderedChart, fitReadingFor, measureContainerBoxes, svgInkReach, ctmScaleOf, type FitReading, type InkReach, type FitRenderedChartOptions, type FitRenderedChartResult, } from "./fitDom";
 export { AXIS_PIN_MIN_LABELS, AXIS_PIN_BAND_PAD_PX, AXIS_PIN_MAX_BAND_FRACTION, AXIS_PIN_TRACK_REACH_PX, isHorizontalLabelRow, labelBand, planAxisPin, axisPinPlacement, type LabelRowBox, type AxisBand, type AxisPinCandidate, type AxisPinPlan, type AxisPinEdge, } from "./fit";
 export { pinScrolledAxis, unpinScrolledAxis, type AxisPinReport } from "./fitDom";
-export { MIN_DELTA_E, pickDistinctColorFromSeed, buildPalette, buildPaletteFromSeed, orderMostDistinct, type PaletteResult, type SeedForSlot, } from "./palette";
+export { MIN_DELTA_E, pickDistinctColorFromSeed, buildPalette, buildPaletteFromSeed, orderMostDistinct, LEGIBLE_LIGHTNESS, type PaletteResult, type SeedForSlot, type PaletteOptions, } from "./palette";
 export { deltaEHex } from "./deltaE";

package/dist/types/palette.d.ts

@@ -4,6 +4,30 @@
  * swatches; JND (just-noticeable-difference) at this scale is ≈5.
  */
 export declare const MIN_DELTA_E = 10;
+/**
+ * THE LIGHTNESS A COLOUR THE WALK INVENTS MUST FALL INSIDE (HSL lightness, 0-100, exclusive).
+ *
+ * The walk's lightness step moves the seed up to 45 points, so from a light seed it could land on
+ * a near-white - and a categorical mark that is near-white on a white page, or near-black on a dark
+ * one, is not a colour a reader can find. Measured before this band existed: a green seed's
+ * twenty-slot palette put `#ebf4e5` (lightness 93) in slot 7, and a pool of Office theme colours led
+ * by a red put `#d5e5f4` (90) in slot 17.
+ *
+ * INVENTED COLOURS ONLY. A seed the host supplied comes back as supplied, however light or dark -
+ * that is a report author's decision - and the spare-colour sweep keeps its own, narrower band.
+ */
+export declare const LEGIBLE_LIGHTNESS: readonly [number, number];
+export interface PaletteOptions {
+    /**
+     * The lightness band invented colours must sit in. Defaults to `LEGIBLE_LIGHTNESS`.
+     *
+     * `null` walks as the package did before the band existed, colour for colour. It exists for a
+     * host that STORED palettes the older walk produced and has to recognise one again by
+     * re-deriving it: change the walk under such a host and every stored palette silently stops
+     * matching. Nothing should draw with it.
+     */
+    lightnessBand?: readonly [number, number] | null;
+}
 /**
  * Pick a hex color for a palette slot.
  *
@@ -30,7 +54,7 @@ export interface PaletteResult {
     /** Hex color to register in the palette-issued set (may differ from `hex` on the give-up fallback). */
     readonly registerHex: string;
 }
-export declare function pickDistinctColorFromSeed(seedHex: string, existing: ReadonlySet<string>, minDistance?: number): PaletteResult;
+export declare function pickDistinctColorFromSeed(seedHex: string, existing: ReadonlySet<string>, minDistance?: number, options?: PaletteOptions): PaletteResult;
 /**
  * A whole categorical palette from ONE seed colour.
  *
@@ -49,7 +73,7 @@ export declare function pickDistinctColorFromSeed(seedHex: string, existing: Rea
  * Deterministic: same seed and count in, same array out, which is what lets a host PERSIST the
  * result and re-derive it later without the colours shifting under a saved chart.
  */
-export declare function buildPaletteFromSeed(seedHex: string, count: number, minDistance?: number): string[];
+export declare function buildPaletteFromSeed(seedHex: string, count: number, minDistance?: number, options?: PaletteOptions): string[];
 /**
  * WHERE EACH SLOT'S BASE COLOUR COMES FROM. Called with the slot index, 0-based.
  *
@@ -75,7 +99,7 @@ export type SeedForSlot = (slot: number) => string | null | undefined;
  * A host with no such API - an Excel workbook offers exactly one resolvable accent - passes a
  * constant provider and the walk does the spreading. That is a fallback, not the design.
  */
-export declare function buildPalette(seedFor: SeedForSlot, count: number, minDistance?: number): string[];
+export declare function buildPalette(seedFor: SeedForSlot, count: number, minDistance?: number, options?: PaletteOptions): string[];
 /**
  * A POOL OF ACCEPTABLE COLOURS, ORDERED SO THE MOST DISTINCT COME FIRST.
  *

package/package.json

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