@acronis-platform/ui-react 4.0.0 → 4.1.0

package/dist/components/ui/chart/chart-palette.js

@@ -1,113 +1,69 @@
-const s = (e) => `var(--ui-dataviz-${e})`, f = Object.freeze(
-  Array.from({ length: 16 }, (e, t) => s(`categorical-${t + 1}`))
-), h = Object.freeze({
-  blue: Object.freeze(
-    Array.from({ length: 8 }, (e, t) => s(`sequential-blue-${t + 1}`))
-  ),
-  teal: Object.freeze(
-    Array.from({ length: 8 }, (e, t) => s(`sequential-teal-${t + 1}`))
-  ),
-  orange: Object.freeze(
-    Array.from({ length: 8 }, (e, t) => s(`sequential-orange-${t + 1}`))
-  ),
-  violet: Object.freeze(
-    Array.from({ length: 8 }, (e, t) => s(`sequential-violet-${t + 1}`))
-  )
-}), g = (e) => Object.freeze([
-  s(`diverging-${e}-a3`),
-  s(`diverging-${e}-a2`),
-  s(`diverging-${e}-a1`),
-  s(`diverging-${e}-b1`),
-  s(`diverging-${e}-b2`),
-  s(`diverging-${e}-b3`)
-]), b = Object.freeze({
-  "blue-orange": g("blue-orange"),
-  "teal-violet": g("teal-violet")
-}), u = Object.freeze({
-  danger: s("meaningful-status-danger"),
-  critical: s("meaningful-status-critical"),
-  warning: s("meaningful-status-warning"),
-  success: s("meaningful-status-success"),
-  info: s("meaningful-status-info"),
-  neutral: s("meaningful-status-neutral")
-}), p = Object.freeze({
-  type: "categorical"
-});
-function d(e) {
-  switch (e.type) {
-    case "categorical":
-      return f;
-    case "sequential":
-      return h[e.ramp];
-    case "diverging":
-      return b[e.pair];
-    case "status":
-      return [];
-  }
+//#region src/components/ui/chart/chart-palette.ts
+var e = (e) => `var(--ui-dataviz-${e})`, t = Object.freeze(Array.from({ length: 16 }, (t, n) => e(`categorical-${n + 1}`))), n = Object.freeze({
+	blue: Object.freeze(Array.from({ length: 8 }, (t, n) => e(`sequential-blue-${n + 1}`))),
+	teal: Object.freeze(Array.from({ length: 8 }, (t, n) => e(`sequential-teal-${n + 1}`))),
+	orange: Object.freeze(Array.from({ length: 8 }, (t, n) => e(`sequential-orange-${n + 1}`))),
+	violet: Object.freeze(Array.from({ length: 8 }, (t, n) => e(`sequential-violet-${n + 1}`)))
+}), r = (t) => Object.freeze([
+	e(`diverging-${t}-a3`),
+	e(`diverging-${t}-a2`),
+	e(`diverging-${t}-a1`),
+	e(`diverging-${t}-b1`),
+	e(`diverging-${t}-b2`),
+	e(`diverging-${t}-b3`)
+]), i = Object.freeze({
+	"blue-orange": r("blue-orange"),
+	"teal-violet": r("teal-violet")
+}), a = Object.freeze({
+	danger: e("meaningful-status-danger"),
+	critical: e("meaningful-status-critical"),
+	warning: e("meaningful-status-warning"),
+	success: e("meaningful-status-success"),
+	info: e("meaningful-status-info"),
+	neutral: e("meaningful-status-neutral")
+}), o = Object.freeze({ type: "categorical" });
+function s(e) {
+	switch (e.type) {
+		case "categorical": return t;
+		case "sequential": return n[e.ramp];
+		case "diverging": return i[e.pair];
+		case "status": return [];
+	}
 }
-function A(e) {
-  switch (e.type) {
-    case "status":
-      return Object.keys(u).map(
-        (t) => ({ status: t })
-      );
-    case "categorical":
-      return f.map((t, r) => ({ slot: r + 1 }));
-    default:
-      return [];
-  }
+function c(e) {
+	switch (e.type) {
+		case "status": return Object.keys(a).map((e) => ({ status: e }));
+		case "categorical": return t.map((e, t) => ({ slot: t + 1 }));
+		default: return [];
+	}
 }
-function i(e) {
-  process.env.NODE_ENV !== "production" && console.warn(`[ui-react] ${e}`);
+function l(e) {
+	process.env.NODE_ENV !== "production" && console.warn(`[ui-react] ${e}`);
 }
-function m(e, t, r) {
-  const a = Math.round(e);
-  return !Number.isFinite(e) || a < 1 || a > t ? (i(
-    `Chart series slot ${e} is outside the "${r.type}" palette (1–${t}). Clamping.`
-  ), Math.min(
-    Math.max(Number.isFinite(a) ? a : 1, 1),
-    t
-  )) : a;
+function u(e, t, n) {
+	let r = Math.round(e);
+	return !Number.isFinite(e) || r < 1 || r > t ? (l(`Chart series slot ${e} is outside the "${n.type}" palette (1–${t}). Clamping.`), Math.min(Math.max(Number.isFinite(r) ? r : 1, 1), t)) : r;
 }
-function $(e, { index: t, tone: r }) {
-  if (e.type === "status")
-    return r != null && r.status ? u[r.status] : (i(
-      'A chart series has no `status` under the "status" palette. Falling back to neutral.'
-    ), u.neutral);
-  const a = d(e);
-  if (r != null && r.status)
-    i(
-      `A chart series names a status ("${r.status}") under the "${e.type}" palette, which has no status tones. Ignoring.`
-    );
-  else if (typeof (r == null ? void 0 : r.slot) == "number") {
-    if (e.type === "categorical")
-      return a[m(r.slot, a.length, e) - 1];
-    i(
-      `A chart series pins slot ${r.slot} under the "${e.type}" palette, whose stops are a ramp and are not individually selectable. Ignoring.`
-    );
-  }
-  return a[t % a.length];
+function d(e, { index: t, tone: n }) {
+	if (e.type === "status") return n?.status ? a[n.status] : (l("A chart series has no `status` under the \"status\" palette. Falling back to neutral."), a.neutral);
+	let r = s(e);
+	if (n?.status) l(`A chart series names a status ("${n.status}") under the "${e.type}" palette, which has no status tones. Ignoring.`);
+	else if (typeof n?.slot == "number") {
+		if (e.type === "categorical") return r[u(n.slot, r.length, e) - 1];
+		l(`A chart series pins slot ${n.slot} under the "${e.type}" palette, whose stops are a ramp and are not individually selectable. Ignoring.`);
+	}
+	return r[t % r.length];
 }
-function v(e, t) {
-  var a, c;
-  const r = /* @__PURE__ */ new Map();
-  for (const [n, l] of Object.entries(e)) {
-    if ((c = (a = t == null ? void 0 : t[n]) == null ? void 0 : a.tone) != null && c.sameAs)
-      continue;
-    const o = r.get(l);
-    o ? o.push(n) : r.set(l, [n]);
-  }
-  return [...r.values()].filter((n) => n.length > 1);
+function f(e, t) {
+	let n = /* @__PURE__ */ new Map();
+	for (let [r, i] of Object.entries(e)) {
+		if (t?.[r]?.tone?.sameAs) continue;
+		let e = n.get(i);
+		e ? e.push(r) : n.set(i, [r]);
+	}
+	return [...n.values()].filter((e) => e.length > 1);
 }
-export {
-  f as CHART_CATEGORICAL_TOKENS,
-  p as CHART_DEFAULT_PALETTE,
-  b as CHART_DIVERGING_TOKENS,
-  h as CHART_SEQUENTIAL_TOKENS,
-  u as CHART_STATUS_TOKENS,
-  v as findDuplicateTones,
-  A as listPaletteChoices,
-  d as listPaletteStops,
-  $ as resolveSeriesColor
-};
-//# sourceMappingURL=chart-palette.js.map
+//#endregion
+export { t as CHART_CATEGORICAL_TOKENS, o as CHART_DEFAULT_PALETTE, i as CHART_DIVERGING_TOKENS, n as CHART_SEQUENTIAL_TOKENS, a as CHART_STATUS_TOKENS, f as findDuplicateTones, c as listPaletteChoices, s as listPaletteStops, d as resolveSeriesColor };
+
+//# sourceMappingURL=chart-palette.js.map

package/dist/components/ui/chart/chart-palette.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart-palette.js","sources":["../../../../src/components/ui/chart/chart-palette.ts"],"sourcesContent":["// The dataviz palettes a chart paints its series from.\n//\n// Every color here resolves to a `--ui-dataviz-*` token from\n// `@acronis-platform/tokens-pd`'s semantic tier (already imported by\n// `styles/index.css`), so light/dark and brand overrides come for free — the\n// tokens are `light-dark()` pairs. There is deliberately no `--ui-chart-*`\n// component tier: these tokens are already semantic and shared across every\n// chart type, and a 1:1 alias layer would be pure indirection (see\n// `context/conventions.md`, \"bridge what's reused\").\n//\n// The four palettes mirror the product's widget editor, which offers exactly\n// this choice — Categorical / Sequential / Diverging / Status — and then, for\n// Categorical and Status only, a per-series color picker. Sequential and\n// Diverging expose the ramp/pair and nothing else, so how N series spread\n// across a ramp's stops is this module's decision, not the user's.\n\n/** A sequential ramp: one hue, eight stops from lightest to darkest. */\nexport type ChartSequentialRamp = 'blue' | 'teal' | 'orange' | 'violet';\n\n/** A diverging pair: two hues meeting at a pale midpoint. */\nexport type ChartDivergingPair = 'blue-orange' | 'teal-violet';\n\n/**\n * A semantic status tone. Ordered by severity in the product's picker:\n * danger (red) · critical (orange) · warning (yellow) · success (green) ·\n * info (blue) · neutral (gray). Note that `critical` is orange and ranks\n * *below* `danger` — that is what the tokens say, across the whole semantic\n * tier, not a typo here.\n */\nexport type ChartStatusTone =\n  | 'danger'\n  | 'critical'\n  | 'warning'\n  | 'success'\n  | 'info'\n  | 'neutral';\n\n/** Which palette a chart's series are painted from. */\nexport type ChartPalette =\n  | { type: 'categorical' }\n  | { type: 'sequential'; ramp: ChartSequentialRamp }\n  | { type: 'diverging'; pair: ChartDivergingPair }\n  | { type: 'status' };\n\n/**\n * How one series picks its color out of the active palette.\n *\n * Only the two palettes whose colors are independent of each other accept an\n * override:\n *\n * - `categorical` — `{ slot }` picks one of the 16 hues.\n * - `status` — `{ status }` names a tone.\n *\n * `sequential` and `diverging` accept none. Their stops are a *ramp*: the\n * colors mean something only in relation to each other, so letting one series\n * jump to an arbitrary stop would break the reading order the ramp exists to\n * convey. The product's widget editor agrees — it offers a ramp/pair picker\n * and no per-series control. An override passed under those palettes is\n * ignored, with a dev warning.\n *\n * Neither form can express a color from outside the palette — that is the point.\n */\nexport type ChartSeriesTone =\n  | { slot: number; status?: never; sameAs?: never }\n  | { slot?: never; status: ChartStatusTone; sameAs?: never }\n  /**\n   * Paint whatever the series under this key paints, under any palette. For a\n   * twin series that is the *same* metric drawn differently — a forecast tail\n   * continuing its actuals, a projection band behind its bars — where two hues\n   * would read as two metrics. Resolved by `resolveChartColors`, which is the\n   * only place the whole config is in view.\n   */\n  | { slot?: never; status?: never; sameAs: string };\n\nconst token = (name: string) => `var(--ui-dataviz-${name})`;\n\n/** The 16 categorical hues, in the order the product's picker lists them. */\nexport const CHART_CATEGORICAL_TOKENS = Object.freeze(\n  Array.from({ length: 16 }, (_, i) => token(`categorical-${i + 1}`))\n);\n\n/** Each sequential ramp's eight stops, lightest (1) to darkest (8). */\nexport const CHART_SEQUENTIAL_TOKENS: Readonly<\n  Record<ChartSequentialRamp, readonly string[]>\n> = Object.freeze({\n  blue: Object.freeze(\n    Array.from({ length: 8 }, (_, i) => token(`sequential-blue-${i + 1}`))\n  ),\n  teal: Object.freeze(\n    Array.from({ length: 8 }, (_, i) => token(`sequential-teal-${i + 1}`))\n  ),\n  orange: Object.freeze(\n    Array.from({ length: 8 }, (_, i) => token(`sequential-orange-${i + 1}`))\n  ),\n  violet: Object.freeze(\n    Array.from({ length: 8 }, (_, i) => token(`sequential-violet-${i + 1}`))\n  ),\n});\n\n// Ordered `a3 → a1` then `b1 → b3`: strongest of the first hue, through the two\n// pale midpoints, out to the strongest of the second. That is the order the\n// ChartTreeMap mockup paints its tiles in (Figma node 8999:72012), and it is\n// what makes a diverging palette read as a single gradient rather than two\n// unrelated ramps.\nconst divergingStops = (pair: string) =>\n  Object.freeze([\n    token(`diverging-${pair}-a3`),\n    token(`diverging-${pair}-a2`),\n    token(`diverging-${pair}-a1`),\n    token(`diverging-${pair}-b1`),\n    token(`diverging-${pair}-b2`),\n    token(`diverging-${pair}-b3`),\n  ]);\n\n/** Each diverging pair's six stops, one hue's strongest through to the other's. */\nexport const CHART_DIVERGING_TOKENS: Readonly<\n  Record<ChartDivergingPair, readonly string[]>\n> = Object.freeze({\n  'blue-orange': divergingStops('blue-orange'),\n  'teal-violet': divergingStops('teal-violet'),\n});\n\n/** The six semantic status tones. */\nexport const CHART_STATUS_TOKENS: Readonly<Record<ChartStatusTone, string>> =\n  Object.freeze({\n    danger: token('meaningful-status-danger'),\n    critical: token('meaningful-status-critical'),\n    warning: token('meaningful-status-warning'),\n    success: token('meaningful-status-success'),\n    info: token('meaningful-status-info'),\n    neutral: token('meaningful-status-neutral'),\n  });\n\n/** The default palette — what a chart paints with when none is chosen. */\nexport const CHART_DEFAULT_PALETTE: ChartPalette = Object.freeze({\n  type: 'categorical',\n});\n\n/**\n * The stops a palette offers, in picker order. `status` has named tones rather\n * than positional stops, so it returns an empty list — use\n * `CHART_STATUS_TOKENS` for those.\n */\nexport function listPaletteStops(palette: ChartPalette): readonly string[] {\n  switch (palette.type) {\n    case 'categorical':\n      return CHART_CATEGORICAL_TOKENS;\n    case 'sequential':\n      return CHART_SEQUENTIAL_TOKENS[palette.ramp];\n    case 'diverging':\n      return CHART_DIVERGING_TOKENS[palette.pair];\n    case 'status':\n      return [];\n  }\n}\n\n/**\n * Every choice a per-series picker may offer for this palette — what the\n * product's widget editor renders in its dropdown. Pure, so the form can build\n * its UI without re-deriving the palette.\n *\n * Empty for `sequential` and `diverging`: those have no per-series control, so\n * a form driven by this function renders no picker for them, which is exactly\n * the design.\n */\nexport function listPaletteChoices(\n  palette: ChartPalette\n): readonly ChartSeriesTone[] {\n  switch (palette.type) {\n    case 'status':\n      return (Object.keys(CHART_STATUS_TOKENS) as ChartStatusTone[]).map(\n        (status) => ({ status })\n      );\n    case 'categorical':\n      return CHART_CATEGORICAL_TOKENS.map((_, i) => ({ slot: i + 1 }));\n    default:\n      return [];\n  }\n}\n\nfunction warn(message: string) {\n  if (process.env.NODE_ENV !== 'production') {\n    console.warn(`[ui-react] ${message}`);\n  }\n}\n\nfunction clampSlot(slot: number, length: number, palette: ChartPalette) {\n  const rounded = Math.round(slot);\n\n  if (!Number.isFinite(slot) || rounded < 1 || rounded > length) {\n    warn(\n      `Chart series slot ${slot} is outside the \"${palette.type}\" palette (1–${length}). Clamping.`\n    );\n    return Math.min(\n      Math.max(Number.isFinite(rounded) ? rounded : 1, 1),\n      length\n    );\n  }\n\n  return rounded;\n}\n\nexport interface ResolveSeriesColorOptions {\n  /** This series' position among the chart's series. */\n  index: number;\n  /** This series' explicit choice within the palette, if it may make one. */\n  tone?: ChartSeriesTone;\n}\n\n/**\n * The color one series paints with.\n *\n * Series walk the palette **in its defined order** — series 1 takes stop 1,\n * series 2 takes stop 2, and so on, wrapping once the stops run out. The order\n * is the design's, not something derived here: no re-ordering, no spreading\n * across a ramp, no skipping stops.\n *\n * On top of that, `categorical` and `status` honour a per-series override\n * (see `ChartSeriesTone`); `sequential` and `diverging` do not.\n *\n * Always returns a token from the active palette. A `slot` out of range is\n * clamped (with a dev warning) rather than passed through, so switching\n * palettes can never leave a series painting off-palette.\n */\nexport function resolveSeriesColor(\n  palette: ChartPalette,\n  { index, tone }: ResolveSeriesColorOptions\n): string {\n  if (palette.type === 'status') {\n    if (tone?.status) {\n      return CHART_STATUS_TOKENS[tone.status];\n    }\n\n    // Unlike the ordered palettes there is no meaningful \"next\" tone to fall\n    // back to — status colors carry meaning, and inventing one would be worse\n    // than reading gray.\n    warn(\n      'A chart series has no `status` under the \"status\" palette. Falling back to neutral.'\n    );\n    return CHART_STATUS_TOKENS.neutral;\n  }\n\n  const stops = listPaletteStops(palette);\n\n  if (tone?.status) {\n    warn(\n      `A chart series names a status (\"${tone.status}\") under the \"${palette.type}\" palette, which has no status tones. Ignoring.`\n    );\n  } else if (typeof tone?.slot === 'number') {\n    if (palette.type === 'categorical') {\n      return stops[clampSlot(tone.slot, stops.length, palette) - 1];\n    }\n\n    warn(\n      `A chart series pins slot ${tone.slot} under the \"${palette.type}\" palette, whose stops are a ramp and are not individually selectable. Ignoring.`\n    );\n  }\n\n  // Wraps rather than clamps once the stops run out: a chart with more series\n  // than the palette has colors is unreadable either way, but wrapping keeps\n  // each series distinguishable from its immediate neighbours.\n  return stops[index % stops.length];\n}\n\n/**\n * Series that would paint the same color — what the widget editor's \"duplicate\n * color\" warning is keyed to. Returns one group per collision, each holding the\n * colliding series' keys in input order.\n *\n * Only series that named a `tone` can collide: automatic assignment is\n * injective by construction (up to `categorical`'s 16-series wrap).\n *\n * Pass the chart's `config` to exclude intentional aliases: a series with\n * `tone: { sameAs }` shares its target's colour on purpose, so it is not a\n * collision. Without the config every alias reads as a duplicate.\n */\nexport function findDuplicateTones(\n  colors: Readonly<Record<string, string>>,\n  config?: Readonly<Record<string, { tone?: { sameAs?: string } }>>\n): string[][] {\n  const byColor = new Map<string, string[]>();\n\n  for (const [key, color] of Object.entries(colors)) {\n    if (config?.[key]?.tone?.sameAs) {\n      continue;\n    }\n    const group = byColor.get(color);\n    if (group) {\n      group.push(key);\n    } else {\n      byColor.set(color, [key]);\n    }\n  }\n\n  return [...byColor.values()].filter((group) => group.length > 1);\n}\n"],"names":["token","name","CHART_CATEGORICAL_TOKENS","_","i","CHART_SEQUENTIAL_TOKENS","divergingStops","pair","CHART_DIVERGING_TOKENS","CHART_STATUS_TOKENS","CHART_DEFAULT_PALETTE","listPaletteStops","palette","listPaletteChoices","status","warn","message","clampSlot","slot","length","rounded","resolveSeriesColor","index","tone","stops","findDuplicateTones","colors","config","_a","_b","byColor","key","color","group"],"mappings":"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"}
+{"version":3,"file":"chart-palette.js","names":[],"sources":["../../../../src/components/ui/chart/chart-palette.ts"],"sourcesContent":["// The dataviz palettes a chart paints its series from.\n//\n// Every color here resolves to a `--ui-dataviz-*` token from\n// `@acronis-platform/tokens-pd`'s semantic tier (already imported by\n// `styles/index.css`), so light/dark and brand overrides come for free — the\n// tokens are `light-dark()` pairs. There is deliberately no `--ui-chart-*`\n// component tier: these tokens are already semantic and shared across every\n// chart type, and a 1:1 alias layer would be pure indirection (see\n// `context/conventions.md`, \"bridge what's reused\").\n//\n// The four palettes mirror the product's widget editor, which offers exactly\n// this choice — Categorical / Sequential / Diverging / Status — and then, for\n// Categorical and Status only, a per-series color picker. Sequential and\n// Diverging expose the ramp/pair and nothing else, so how N series spread\n// across a ramp's stops is this module's decision, not the user's.\n\n/** A sequential ramp: one hue, eight stops from lightest to darkest. */\nexport type ChartSequentialRamp = 'blue' | 'teal' | 'orange' | 'violet';\n\n/** A diverging pair: two hues meeting at a pale midpoint. */\nexport type ChartDivergingPair = 'blue-orange' | 'teal-violet';\n\n/**\n * A semantic status tone. Ordered by severity in the product's picker:\n * danger (red) · critical (orange) · warning (yellow) · success (green) ·\n * info (blue) · neutral (gray). Note that `critical` is orange and ranks\n * *below* `danger` — that is what the tokens say, across the whole semantic\n * tier, not a typo here.\n */\nexport type ChartStatusTone =\n  | 'danger'\n  | 'critical'\n  | 'warning'\n  | 'success'\n  | 'info'\n  | 'neutral';\n\n/** Which palette a chart's series are painted from. */\nexport type ChartPalette =\n  | { type: 'categorical' }\n  | { type: 'sequential'; ramp: ChartSequentialRamp }\n  | { type: 'diverging'; pair: ChartDivergingPair }\n  | { type: 'status' };\n\n/**\n * How one series picks its color out of the active palette.\n *\n * Only the two palettes whose colors are independent of each other accept an\n * override:\n *\n * - `categorical` — `{ slot }` picks one of the 16 hues.\n * - `status` — `{ status }` names a tone.\n *\n * `sequential` and `diverging` accept none. Their stops are a *ramp*: the\n * colors mean something only in relation to each other, so letting one series\n * jump to an arbitrary stop would break the reading order the ramp exists to\n * convey. The product's widget editor agrees — it offers a ramp/pair picker\n * and no per-series control. An override passed under those palettes is\n * ignored, with a dev warning.\n *\n * Neither form can express a color from outside the palette — that is the point.\n */\nexport type ChartSeriesTone =\n  | { slot: number; status?: never; sameAs?: never }\n  | { slot?: never; status: ChartStatusTone; sameAs?: never }\n  /**\n   * Paint whatever the series under this key paints, under any palette. For a\n   * twin series that is the *same* metric drawn differently — a forecast tail\n   * continuing its actuals, a projection band behind its bars — where two hues\n   * would read as two metrics. Resolved by `resolveChartColors`, which is the\n   * only place the whole config is in view.\n   */\n  | { slot?: never; status?: never; sameAs: string };\n\nconst token = (name: string) => `var(--ui-dataviz-${name})`;\n\n/** The 16 categorical hues, in the order the product's picker lists them. */\nexport const CHART_CATEGORICAL_TOKENS = Object.freeze(\n  Array.from({ length: 16 }, (_, i) => token(`categorical-${i + 1}`))\n);\n\n/** Each sequential ramp's eight stops, lightest (1) to darkest (8). */\nexport const CHART_SEQUENTIAL_TOKENS: Readonly<\n  Record<ChartSequentialRamp, readonly string[]>\n> = Object.freeze({\n  blue: Object.freeze(\n    Array.from({ length: 8 }, (_, i) => token(`sequential-blue-${i + 1}`))\n  ),\n  teal: Object.freeze(\n    Array.from({ length: 8 }, (_, i) => token(`sequential-teal-${i + 1}`))\n  ),\n  orange: Object.freeze(\n    Array.from({ length: 8 }, (_, i) => token(`sequential-orange-${i + 1}`))\n  ),\n  violet: Object.freeze(\n    Array.from({ length: 8 }, (_, i) => token(`sequential-violet-${i + 1}`))\n  ),\n});\n\n// Ordered `a3 → a1` then `b1 → b3`: strongest of the first hue, through the two\n// pale midpoints, out to the strongest of the second. That is the order the\n// ChartTreeMap mockup paints its tiles in (Figma node 8999:72012), and it is\n// what makes a diverging palette read as a single gradient rather than two\n// unrelated ramps.\nconst divergingStops = (pair: string) =>\n  Object.freeze([\n    token(`diverging-${pair}-a3`),\n    token(`diverging-${pair}-a2`),\n    token(`diverging-${pair}-a1`),\n    token(`diverging-${pair}-b1`),\n    token(`diverging-${pair}-b2`),\n    token(`diverging-${pair}-b3`),\n  ]);\n\n/** Each diverging pair's six stops, one hue's strongest through to the other's. */\nexport const CHART_DIVERGING_TOKENS: Readonly<\n  Record<ChartDivergingPair, readonly string[]>\n> = Object.freeze({\n  'blue-orange': divergingStops('blue-orange'),\n  'teal-violet': divergingStops('teal-violet'),\n});\n\n/** The six semantic status tones. */\nexport const CHART_STATUS_TOKENS: Readonly<Record<ChartStatusTone, string>> =\n  Object.freeze({\n    danger: token('meaningful-status-danger'),\n    critical: token('meaningful-status-critical'),\n    warning: token('meaningful-status-warning'),\n    success: token('meaningful-status-success'),\n    info: token('meaningful-status-info'),\n    neutral: token('meaningful-status-neutral'),\n  });\n\n/** The default palette — what a chart paints with when none is chosen. */\nexport const CHART_DEFAULT_PALETTE: ChartPalette = Object.freeze({\n  type: 'categorical',\n});\n\n/**\n * The stops a palette offers, in picker order. `status` has named tones rather\n * than positional stops, so it returns an empty list — use\n * `CHART_STATUS_TOKENS` for those.\n */\nexport function listPaletteStops(palette: ChartPalette): readonly string[] {\n  switch (palette.type) {\n    case 'categorical':\n      return CHART_CATEGORICAL_TOKENS;\n    case 'sequential':\n      return CHART_SEQUENTIAL_TOKENS[palette.ramp];\n    case 'diverging':\n      return CHART_DIVERGING_TOKENS[palette.pair];\n    case 'status':\n      return [];\n  }\n}\n\n/**\n * Every choice a per-series picker may offer for this palette — what the\n * product's widget editor renders in its dropdown. Pure, so the form can build\n * its UI without re-deriving the palette.\n *\n * Empty for `sequential` and `diverging`: those have no per-series control, so\n * a form driven by this function renders no picker for them, which is exactly\n * the design.\n */\nexport function listPaletteChoices(\n  palette: ChartPalette\n): readonly ChartSeriesTone[] {\n  switch (palette.type) {\n    case 'status':\n      return (Object.keys(CHART_STATUS_TOKENS) as ChartStatusTone[]).map(\n        (status) => ({ status })\n      );\n    case 'categorical':\n      return CHART_CATEGORICAL_TOKENS.map((_, i) => ({ slot: i + 1 }));\n    default:\n      return [];\n  }\n}\n\nfunction warn(message: string) {\n  if (process.env.NODE_ENV !== 'production') {\n    console.warn(`[ui-react] ${message}`);\n  }\n}\n\nfunction clampSlot(slot: number, length: number, palette: ChartPalette) {\n  const rounded = Math.round(slot);\n\n  if (!Number.isFinite(slot) || rounded < 1 || rounded > length) {\n    warn(\n      `Chart series slot ${slot} is outside the \"${palette.type}\" palette (1–${length}). Clamping.`\n    );\n    return Math.min(\n      Math.max(Number.isFinite(rounded) ? rounded : 1, 1),\n      length\n    );\n  }\n\n  return rounded;\n}\n\nexport interface ResolveSeriesColorOptions {\n  /** This series' position among the chart's series. */\n  index: number;\n  /** This series' explicit choice within the palette, if it may make one. */\n  tone?: ChartSeriesTone;\n}\n\n/**\n * The color one series paints with.\n *\n * Series walk the palette **in its defined order** — series 1 takes stop 1,\n * series 2 takes stop 2, and so on, wrapping once the stops run out. The order\n * is the design's, not something derived here: no re-ordering, no spreading\n * across a ramp, no skipping stops.\n *\n * On top of that, `categorical` and `status` honour a per-series override\n * (see `ChartSeriesTone`); `sequential` and `diverging` do not.\n *\n * Always returns a token from the active palette. A `slot` out of range is\n * clamped (with a dev warning) rather than passed through, so switching\n * palettes can never leave a series painting off-palette.\n */\nexport function resolveSeriesColor(\n  palette: ChartPalette,\n  { index, tone }: ResolveSeriesColorOptions\n): string {\n  if (palette.type === 'status') {\n    if (tone?.status) {\n      return CHART_STATUS_TOKENS[tone.status];\n    }\n\n    // Unlike the ordered palettes there is no meaningful \"next\" tone to fall\n    // back to — status colors carry meaning, and inventing one would be worse\n    // than reading gray.\n    warn(\n      'A chart series has no `status` under the \"status\" palette. Falling back to neutral.'\n    );\n    return CHART_STATUS_TOKENS.neutral;\n  }\n\n  const stops = listPaletteStops(palette);\n\n  if (tone?.status) {\n    warn(\n      `A chart series names a status (\"${tone.status}\") under the \"${palette.type}\" palette, which has no status tones. Ignoring.`\n    );\n  } else if (typeof tone?.slot === 'number') {\n    if (palette.type === 'categorical') {\n      return stops[clampSlot(tone.slot, stops.length, palette) - 1];\n    }\n\n    warn(\n      `A chart series pins slot ${tone.slot} under the \"${palette.type}\" palette, whose stops are a ramp and are not individually selectable. Ignoring.`\n    );\n  }\n\n  // Wraps rather than clamps once the stops run out: a chart with more series\n  // than the palette has colors is unreadable either way, but wrapping keeps\n  // each series distinguishable from its immediate neighbours.\n  return stops[index % stops.length];\n}\n\n/**\n * Series that would paint the same color — what the widget editor's \"duplicate\n * color\" warning is keyed to. Returns one group per collision, each holding the\n * colliding series' keys in input order.\n *\n * Only series that named a `tone` can collide: automatic assignment is\n * injective by construction (up to `categorical`'s 16-series wrap).\n *\n * Pass the chart's `config` to exclude intentional aliases: a series with\n * `tone: { sameAs }` shares its target's colour on purpose, so it is not a\n * collision. Without the config every alias reads as a duplicate.\n */\nexport function findDuplicateTones(\n  colors: Readonly<Record<string, string>>,\n  config?: Readonly<Record<string, { tone?: { sameAs?: string } }>>\n): string[][] {\n  const byColor = new Map<string, string[]>();\n\n  for (const [key, color] of Object.entries(colors)) {\n    if (config?.[key]?.tone?.sameAs) {\n      continue;\n    }\n    const group = byColor.get(color);\n    if (group) {\n      group.push(key);\n    } else {\n      byColor.set(color, [key]);\n    }\n  }\n\n  return [...byColor.values()].filter((group) => group.length > 1);\n}\n"],"mappings":";AA0EA,IAAM,KAAS,MAAiB,oBAAoB,EAAK,IAG5C,IAA2B,OAAO,OAC7C,MAAM,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,MAAM,EAAM,eAAe,IAAI,GAAG,CAAC,CACpE,GAGa,IAET,OAAO,OAAO;CAChB,MAAM,OAAO,OACX,MAAM,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,EAAM,mBAAmB,IAAI,GAAG,CAAC,CACvE;CACA,MAAM,OAAO,OACX,MAAM,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,EAAM,mBAAmB,IAAI,GAAG,CAAC,CACvE;CACA,QAAQ,OAAO,OACb,MAAM,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,EAAM,qBAAqB,IAAI,GAAG,CAAC,CACzE;CACA,QAAQ,OAAO,OACb,MAAM,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,EAAM,qBAAqB,IAAI,GAAG,CAAC,CACzE;AACF,CAAC,GAOK,KAAkB,MACtB,OAAO,OAAO;CACZ,EAAM,aAAa,EAAK,IAAI;CAC5B,EAAM,aAAa,EAAK,IAAI;CAC5B,EAAM,aAAa,EAAK,IAAI;CAC5B,EAAM,aAAa,EAAK,IAAI;CAC5B,EAAM,aAAa,EAAK,IAAI;CAC5B,EAAM,aAAa,EAAK,IAAI;AAC9B,CAAC,GAGU,IAET,OAAO,OAAO;CAChB,eAAe,EAAe,aAAa;CAC3C,eAAe,EAAe,aAAa;AAC7C,CAAC,GAGY,IACX,OAAO,OAAO;CACZ,QAAQ,EAAM,0BAA0B;CACxC,UAAU,EAAM,4BAA4B;CAC5C,SAAS,EAAM,2BAA2B;CAC1C,SAAS,EAAM,2BAA2B;CAC1C,MAAM,EAAM,wBAAwB;CACpC,SAAS,EAAM,2BAA2B;AAC5C,CAAC,GAGU,IAAsC,OAAO,OAAO,EAC/D,MAAM,cACR,CAAC;AAOD,SAAgB,EAAiB,GAA0C;CACzE,QAAQ,EAAQ,MAAhB;EACE,KAAK,eACH,OAAO;EACT,KAAK,cACH,OAAO,EAAwB,EAAQ;EACzC,KAAK,aACH,OAAO,EAAuB,EAAQ;EACxC,KAAK,UACH,OAAO,CAAC;CACZ;AACF;AAWA,SAAgB,EACd,GAC4B;CAC5B,QAAQ,EAAQ,MAAhB;EACE,KAAK,UACH,OAAQ,OAAO,KAAK,CAAmB,CAAC,CAAuB,KAC5D,OAAY,EAAE,UAAO,EACxB;EACF,KAAK,eACH,OAAO,EAAyB,KAAK,GAAG,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE;EACjE,SACE,OAAO,CAAC;CACZ;AACF;AAEA,SAAS,EAAK,GAAiB;CAC7B,AAAA,QAAA,IAAA,aAA6B,gBAC3B,QAAQ,KAAK,cAAc,GAAS;AAExC;AAEA,SAAS,EAAU,GAAc,GAAgB,GAAuB;CACtE,IAAM,IAAU,KAAK,MAAM,CAAI;CAY/B,OAVI,CAAC,OAAO,SAAS,CAAI,KAAK,IAAU,KAAK,IAAU,KACrD,EACE,qBAAqB,EAAK,mBAAmB,EAAQ,KAAK,eAAe,EAAO,aAClF,GACO,KAAK,IACV,KAAK,IAAI,OAAO,SAAS,CAAO,IAAI,IAAU,GAAG,CAAC,GAClD,CACF,KAGK;AACT;AAwBA,SAAgB,EACd,GACA,EAAE,UAAO,WACD;CACR,IAAI,EAAQ,SAAS,UAWnB,OAVI,GAAM,SACD,EAAoB,EAAK,WAMlC,EACE,uFACF,GACO,EAAoB;CAG7B,IAAM,IAAQ,EAAiB,CAAO;CAEtC,IAAI,GAAM,QACR,EACE,mCAAmC,EAAK,OAAO,gBAAgB,EAAQ,KAAK,gDAC9E;MACK,IAAI,OAAO,GAAM,QAAS,UAAU;EACzC,IAAI,EAAQ,SAAS,eACnB,OAAO,EAAM,EAAU,EAAK,MAAM,EAAM,QAAQ,CAAO,IAAI;EAG7D,EACE,4BAA4B,EAAK,KAAK,cAAc,EAAQ,KAAK,iFACnE;CACF;CAKA,OAAO,EAAM,IAAQ,EAAM;AAC7B;AAcA,SAAgB,EACd,GACA,GACY;CACZ,IAAM,oBAAU,IAAI,IAAsB;CAE1C,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAM,GAAG;EACjD,IAAI,IAAS,EAAI,EAAE,MAAM,QACvB;EAEF,IAAM,IAAQ,EAAQ,IAAI,CAAK;EAC/B,AAAI,IACF,EAAM,KAAK,CAAG,IAEd,EAAQ,IAAI,GAAO,CAAC,CAAG,CAAC;CAE5B;CAEA,OAAO,CAAC,GAAG,EAAQ,OAAO,CAAC,CAAC,CAAC,QAAQ,MAAU,EAAM,SAAS,CAAC;AACjE"}