@bicharts/chart-host 0.5.93 → 0.5.94

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

@@ -1868,6 +1868,10 @@ function deltaE2000(c1, c2) {
   const tL = dLp / SL, tC = dCp / SC, tH = dHp / SH;
   return Math.sqrt(tL * tL + tC * tC + tH * tH + RT * tC * tH);
 }
+function deltaEHex(a4, b2) {
+  const la = hexToLab(a4), lb = hexToLab(b2);
+  return la && lb ? deltaE2000(la, lb) : NaN;
+}
 
 // src/colourSpread.ts
 var SAME_SHADE_DELTA_E = 5;
@@ -3223,6 +3227,7 @@ export {
   MIN_HIT_BAND_PX,
   censusHitBands,
   hitBandFlag,
+  deltaEHex,
   SAME_SHADE_DELTA_E,
   MIN_RAMP_FILLS,
   censusColourSpread,

package/dist/index.mjs

@@ -81,6 +81,7 @@ import {
   createMarkResolver,
   ctmScaleOf,
   decideLabelColor,
+  deltaEHex,
   ensureCrossfilterHitTargets,
   explainRenderFailure,
   fitReadingFor,
@@ -116,7 +117,7 @@ import {
   toRGBA,
   u,
   unpinScrolledAxis
-} from "./chunk-BWOY6GDX.mjs";
+} from "./chunk-IIBDCQJM.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
@@ -2027,6 +2028,33 @@ function buildPalette(seedFor, count, minDistance = MIN_DELTA_E) {
   }
   return out;
 }
+function orderMostDistinct(lead, pool) {
+  const seen = /* @__PURE__ */ new Set();
+  const valid = [];
+  const take = (c2) => {
+    const s2 = typeof c2 === "string" ? c2.trim() : "";
+    if (!s2 || !Number.isFinite(deltaEHex(s2, s2))) return;
+    const key = s2.toLowerCase();
+    if (seen.has(key)) return;
+    seen.add(key);
+    valid.push(s2);
+  };
+  take(lead);
+  for (const c2 of pool ?? []) take(c2);
+  if (!valid.length) return [];
+  const out = [valid[0]];
+  const rest = valid.slice(1);
+  const nearest = rest.map((c2) => deltaEHex(c2, out[0]));
+  while (rest.length) {
+    let best = 0;
+    for (let i2 = 1; i2 < rest.length; i2++) if (nearest[i2] > nearest[best]) best = i2;
+    const picked = rest.splice(best, 1)[0];
+    nearest.splice(best, 1);
+    out.push(picked);
+    for (let i2 = 0; i2 < rest.length; i2++) nearest[i2] = Math.min(nearest[i2], deltaEHex(rest[i2], picked));
+  }
+  return out;
+}
 function normalise(seed) {
   return typeof seed === "string" ? seed.trim() : "";
 }
@@ -2149,6 +2177,7 @@ export {
   createMarkResolver,
   ctmScaleOf,
   decideLabelColor,
+  deltaEHex,
   ensureCrossfilterHitTargets,
   explainRenderFailure,
   filterFitsChooser,
@@ -2179,6 +2208,7 @@ export {
   noopViewStateProvider,
   normaliseAggregation,
   normalizeFilterTerm,
+  orderMostDistinct,
   orderRefusalsForDisplay,
   periodTickSuppressesFeedback,
   pickDistinctColorFromSeed,

package/dist/react.mjs

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

package/dist/types/index.d.ts

@@ -27,4 +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, type PaletteResult, type SeedForSlot, } from "./palette";
+export { MIN_DELTA_E, pickDistinctColorFromSeed, buildPalette, buildPaletteFromSeed, orderMostDistinct, type PaletteResult, type SeedForSlot, } from "./palette";
+export { deltaEHex } from "./deltaE";

package/dist/types/palette.d.ts

@@ -76,3 +76,31 @@ export type SeedForSlot = (slot: number) => string | null | undefined;
  * 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[];
+/**
+ * A POOL OF ACCEPTABLE COLOURS, ORDERED SO THE MOST DISTINCT COME FIRST.
+ *
+ * For a host that knows WHICH colours belong to the surface but not in what ORDER to use them.
+ * Excel is the case that needed it: a workbook's theme offers a grid of accents and their tints,
+ * none of which is ranked, and the order a host invents decides what a two- or five-series chart
+ * looks like. The order Office itself lists its accents in puts two blues four slots apart, so a
+ * five-series chart following that list gives two of its series nearly the same colour - which
+ * reads as one series.
+ *
+ * NEVER USE THIS ON AN AUTHORED ORDER. A report theme's slot order is somebody's decision, and
+ * `buildPalette` exists to honour it verbatim; re-sorting it here would override the author with
+ * arithmetic. This is only for a pool a host assembled itself.
+ *
+ * The method is greedy max-min (the farthest-point walk used for categorical colour sets): keep
+ * the lead, then repeatedly take the pool colour whose NEAREST already-chosen colour is farthest
+ * away, by CIEDE2000. Two properties follow and the tests pin both. The distance each pick adds is
+ * never larger than the one before it, so the early slots, which every chart uses, are the best
+ * separated. And every input colour is returned unchanged, so the palette is still the surface's
+ * own colours, only re-ordered.
+ *
+ * Deterministic: ties go to the colour listed earlier in the pool. Duplicates (case-insensitive)
+ * and anything that is not `#rgb` / `#rrggbb` are dropped, because a colour that cannot be
+ * measured cannot be placed. A blank or unmeasurable lead means "start from the pool's first
+ * colour". Feed the result to `buildPalette`, which still guarantees the minimum separation when
+ * two pool colours are too close to share a legend.
+ */
+export declare function orderMostDistinct(lead: string | null | undefined, pool: readonly string[]): string[];

package/package.json

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