@bicharts/chart-host 0.5.88 → 0.5.89

package/dist/index.mjs

@@ -1960,14 +1960,27 @@ 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 buildPalette(seedFor, count, minDistance = MIN_DELTA_E) {
   const out = [];
-  if (!seedHex || !(count > 0)) return out;
+  if (!(count > 0)) return out;
   const issued = /* @__PURE__ */ new Set();
   const issuedCs = [];
   const distance = (hex) => issuedCs.length === 0 ? Number.POSITIVE_INFINITY : Math.min(...issuedCs.map((c2) => Mt(hex).deltaE(c2, "CIE2000")));
   let sweep = null;
   let sweepAt = 0;
+  let lastSeed = "";
   for (let i2 = 0; i2 < count; i2++) {
+    let seedHex = "";
+    try {
+      seedHex = normalise(seedFor(i2));
+    } catch {
+      seedHex = "";
+    }
+    if (!seedHex) seedHex = lastSeed;
+    if (!seedHex) break;
+    lastSeed = seedHex;
     const { hex, registerHex } = pickDistinctColorFromSeed(seedHex, issued, minDistance);
     let chosen = hex;
     let register = registerHex;
@@ -1997,6 +2010,9 @@ function buildPaletteFromSeed(seedHex, count, minDistance = MIN_DELTA_E) {
   }
   return out;
 }
+function normalise(seed) {
+  return typeof seed === "string" ? seed.trim() : "";
+}
 function sweepCandidates(seedHex) {
   const [h2, s2, l2] = Mt(seedHex).hsl();
   const baseHue = Number.isFinite(h2) ? h2 : 210;
@@ -2087,6 +2103,7 @@ export {
   backingHoldsGlyph,
   bareBase64,
   blankRenderFlag,
+  buildPalette,
   buildPaletteFromSeed,
   buildRenderPayload,
   buildReviewWire,

package/dist/types/index.d.ts

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

package/dist/types/palette.d.ts

@@ -50,3 +50,29 @@ export declare function pickDistinctColorFromSeed(seedHex: string, existing: Rea
  * 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[];
+/**
+ * WHERE EACH SLOT'S BASE COLOUR COMES FROM. Called with the slot index, 0-based.
+ *
+ * Returning a blank or nothing means "no base colour for this slot" - the builder then falls
+ * back to the last one that WAS supplied, so a host whose colour source runs dry degrades into
+ * spreading rather than into a gap.
+ */
+export type SeedForSlot = (slot: number) => string | null | undefined;
+/**
+ * The general form: a palette whose BASE COLOURS the host decides, slot by slot.
+ *
+ * THIS IS THE RICH FORM AND `buildPaletteFromSeed` IS THE DEGENERATE ONE. Read that sentence
+ * before "simplifying" a host onto the single-seed call, because the difference is a real loss
+ * and it is invisible in the output - both return a plausible list of distinct colours.
+ *
+ * Power BI hands a visual a DIFFERENT theme colour per slot (`colorPalette.getColor("1")`,
+ * `getColor("2")`, ...). Every one of those is a deliberate choice by whoever built the report
+ * theme, and feeding them in per slot means the walk usually settles at step 1 and RETURNS THEM
+ * UNCHANGED - the chart is coloured by the theme, not by our arithmetic. Collapse that host onto
+ * one seed and twenty authored colours become one authored colour plus nineteen derived ones:
+ * still distinct, still pretty, and no longer the report's.
+ *
+ * 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[];

package/package.json

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