@krizaka/charts 0.0.0-stage → 0.2.0

package/dist/chunk-3CJHBJXA.js

@@ -0,0 +1,186 @@
+"use client";
+
+// src/core/labels.ts
+var DEFAULT_LABELS = {
+  showData: "Show data",
+  hideData: "Hide data",
+  tableCaption: "{title} \u2014 data",
+  exportPng: "PNG",
+  exportSvg: "SVG",
+  exportCsv: "CSV",
+  loading: "Loading chart\u2026",
+  empty: "No data for this period yet.",
+  error: "The chart could not be loaded.",
+  keyboardHint: "Use the arrow keys to move between points, Home and End to jump to the ends.",
+  roleDescription: "chart",
+  summaryIntro: "{kind}, {count}.",
+  summarySeries: "{label}: from {first} to {last}",
+  summaryRange: "lowest {min} ({minAt}), highest {max} ({maxAt})",
+  summaryTrendUp: "up {change}",
+  summaryTrendDown: "down {change}",
+  summaryTrendFlat: "stable",
+  summaryTotal: "total {total}",
+  summaryThreshold: "{label} at {value}",
+  summaryShare: "{label} {value} ({share})",
+  summaryCorrelation: "correlation {r}",
+  summaryConversion: "{from} \u2192 {to} {rate}",
+  summaryOverall: "overall {rate}",
+  summaryPeak: "peak {value} ({at})",
+  summaryActive: "{count} with a value",
+  summaryOhlc: "opened at {open}, closed at {close}, low {low}, high {high}",
+  kinds: {
+    line: "Line chart",
+    area: "Area chart",
+    bar: "Bar chart",
+    pie: "Pie chart",
+    donut: "Donut chart",
+    gauge: "Gauge",
+    sparkline: "Sparkline",
+    radar: "Radar chart",
+    heatmap: "Heatmap",
+    calendar: "Calendar heatmap",
+    sankey: "Flow diagram",
+    funnel: "Funnel",
+    candlestick: "Candlestick chart",
+    treemap: "Treemap",
+    scatter: "Scatter chart",
+    map: "Map",
+    globe: "Globe",
+    chart: "Chart"
+  },
+  category: "Category",
+  value: "Value",
+  total: "Total",
+  noValue: "\u2014"
+};
+function mergeLabels(...layers) {
+  let out = DEFAULT_LABELS;
+  for (const layer of layers) {
+    if (!layer) continue;
+    out = { ...out, ...layer, kinds: { ...out.kinds, ...layer.kinds } };
+  }
+  return out;
+}
+function capitalize(text) {
+  return text.charAt(0).toLocaleUpperCase() + text.slice(1);
+}
+function fill(template, values) {
+  return template.replace(/\{(\w+)\}/g, (match, name) => name in values ? String(values[name]) : match);
+}
+
+// src/web/context.tsx
+import { createContext, useContext, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+var DEFAULTS = { locale: "en-US", labels: mergeLabels() };
+var Context = createContext(DEFAULTS);
+function ChartsProvider({ locale, brand, labels, children }) {
+  const parent = useContext(Context);
+  const value = useMemo(() => {
+    const raw = labels ? { ...parent.raw, ...labels, kinds: { ...parent.raw?.kinds, ...labels.kinds } } : parent.raw;
+    return { locale: locale ?? parent.locale, brand: brand ?? parent.brand, labels: mergeLabels(raw), raw };
+  }, [locale, brand, labels, parent]);
+  return /* @__PURE__ */ jsx(Context.Provider, { value, children });
+}
+function useChartSettings(own) {
+  const shared = useContext(Context);
+  return useMemo(
+    () => ({ locale: own.locale ?? shared.locale, brand: own.brand ?? shared.brand, labels: own.labels ? mergeLabels(shared.raw, own.labels) : shared.labels }),
+    [own.locale, own.brand, own.labels, shared]
+  );
+}
+
+// src/core/palette.ts
+var HUES = {
+  blue: { light: "#2a78d6", dark: "#3987e5" },
+  orange: { light: "#eb6834", dark: "#d95926" },
+  aqua: { light: "#1baf7a", dark: "#199e70" },
+  yellow: { light: "#eda100", dark: "#c98500" },
+  magenta: { light: "#e87ba4", dark: "#d55181" },
+  green: { light: "#008300", dark: "#008300" },
+  violet: { light: "#6250d6", dark: "#9085e9" },
+  red: { light: "#e34948", dark: "#e66767" }
+};
+var ORDERS = {
+  krizaka: ["blue", "green", "magenta", "yellow", "aqua", "orange", "violet", "red"],
+  orazaka: ["orange", "aqua", "blue", "yellow", "magenta", "green", "violet", "red"],
+  orochia: ["violet", "magenta", "yellow", "aqua", "orange", "blue", "green", "red"]
+};
+function palette(brand, mode) {
+  return ORDERS[brand].map((hue) => HUES[hue][mode]);
+}
+var DIVERGING = {
+  light: { low: HUES.blue.light, high: HUES.red.light },
+  dark: { low: HUES.blue.dark, high: HUES.red.dark }
+};
+function parseColor(color) {
+  const hex2 = color.trim().match(/^#([\da-f]{3}|[\da-f]{6})$/i);
+  if (hex2) {
+    const h = hex2[1].length === 3 ? [...hex2[1]].map((c) => c + c).join("") : hex2[1];
+    return [0, 2, 4].map((i) => Number.parseInt(h.slice(i, i + 2), 16));
+  }
+  const rgb = color.trim().match(/^rgba?\(\s*([\d.]+)[\s,]+([\d.]+)[\s,]+([\d.]+)/i);
+  if (rgb) return [Number(rgb[1]), Number(rgb[2]), Number(rgb[3])];
+  return null;
+}
+var toLinear = (c) => {
+  const v = c / 255;
+  return v <= 0.04045 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4;
+};
+var fromLinear = (v) => {
+  const c = v <= 31308e-7 ? v * 12.92 : 1.055 * v ** (1 / 2.4) - 0.055;
+  return Math.round(Math.min(1, Math.max(0, c)) * 255);
+};
+function toOklab([r8, g8, b8]) {
+  const [r, g, b] = [toLinear(r8), toLinear(g8), toLinear(b8)];
+  const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);
+  const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);
+  const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);
+  return [0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s, 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s, 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s];
+}
+function fromOklab([L, a, b]) {
+  const l = (L + 0.3963377774 * a + 0.2158037573 * b) ** 3;
+  const m = (L - 0.1055613458 * a - 0.0638541728 * b) ** 3;
+  const s = (L - 0.0894841775 * a - 1.291485548 * b) ** 3;
+  return [
+    fromLinear(4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s),
+    fromLinear(-1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s),
+    fromLinear(-0.0041960863 * l - 0.7034186147 * m + 1.707614031 * s)
+  ];
+}
+var hex = ([r, g, b]) => `#${[r, g, b].map((c) => c.toString(16).padStart(2, "0")).join("")}`;
+function mix(a, b, t) {
+  const ca = parseColor(a);
+  const cb = parseColor(b);
+  if (!ca || !cb) return b;
+  const la = toOklab(ca);
+  const lb = toOklab(cb);
+  return hex(fromOklab([0, 1, 2].map((i) => la[i] + (lb[i] - la[i]) * t)));
+}
+function sequential(hue, surface, steps = 5) {
+  return Array.from({ length: steps }, (_, i) => mix(surface, hue, 0.22 + 0.78 * i / Math.max(1, steps - 1)));
+}
+function contrast(a, b) {
+  const lum = (c) => {
+    const rgb = parseColor(c);
+    if (!rgb) return 0;
+    const [r, g, bl] = rgb.map(toLinear);
+    return 0.2126 * r + 0.7152 * g + 0.0722 * bl;
+  };
+  const [hi, lo] = [lum(a), lum(b)].sort((x, y) => y - x);
+  return (hi + 0.05) / (lo + 0.05);
+}
+
+export {
+  DEFAULT_LABELS,
+  capitalize,
+  fill,
+  ChartsProvider,
+  useChartSettings,
+  HUES,
+  ORDERS,
+  palette,
+  DIVERGING,
+  sequential,
+  contrast
+};
+//# sourceMappingURL=chunk-3CJHBJXA.js.map

package/dist/chunk-3CJHBJXA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/labels.ts","../src/web/context.tsx","../src/core/palette.ts"],"sourcesContent":["// The words a chart says on its own: its controls, its states and its written summary. English by default; an app\n// passes its own (translated through its catalogue) once, to `ChartsProvider labels`, or to one chart's `labels`.\n// Placeholders are written `{name}`.\n\nexport interface ChartLabels {\n  /** The button that shows the data table. */\n  showData: string;\n  /** The button that hides it. */\n  hideData: string;\n  /** The caption of the data table: `{title}`. */\n  tableCaption: string;\n  /** The export buttons. */\n  exportPng: string;\n  exportSvg: string;\n  exportCsv: string;\n  /** Announced while the data loads. */\n  loading: string;\n  /** Shown when there is nothing to draw. */\n  empty: string;\n  /** Shown when the data could not be loaded. */\n  error: string;\n  /** The keyboard hint, read once when the plot takes the focus. */\n  keyboardHint: string;\n  /** The role description of the plot (`chart`). */\n  roleDescription: string;\n  /** Summary pieces. `{kind}` is the chart's name (`Line chart`), `{count}` a number of points or series. */\n  summaryIntro: string;\n  summarySeries: string;\n  summaryRange: string;\n  summaryTrendUp: string;\n  summaryTrendDown: string;\n  summaryTrendFlat: string;\n  summaryTotal: string;\n  summaryThreshold: string;\n  summaryShare: string;\n  /** Scatter: the correlation of x and y (Pearson's r). */\n  summaryCorrelation: string;\n  /** Funnel: from one stage to the next, and from the first to the last. */\n  summaryConversion: string;\n  summaryOverall: string;\n  /** Heatmap, calendar: the largest cell and the number of cells with a value. */\n  summaryPeak: string;\n  summaryActive: string;\n  /** Candlestick: the period's range. */\n  summaryOhlc: string;\n  /** The names of the charts, read first in the summary. */\n  kinds: Record<ChartKind, string>;\n  /** The column of the values, when the chart has no value label. */\n  value: string;\n  /** The column of the categories in the data table, when the chart has no x label. */\n  category: string;\n  /** The total row of a stacked chart, a pie, a funnel. */\n  total: string;\n  /** What a missing value reads as. */\n  noValue: string;\n}\n\nexport type ChartKind =\n  | \"line\"\n  | \"area\"\n  | \"bar\"\n  | \"pie\"\n  | \"donut\"\n  | \"gauge\"\n  | \"sparkline\"\n  | \"radar\"\n  | \"heatmap\"\n  | \"calendar\"\n  | \"sankey\"\n  | \"funnel\"\n  | \"candlestick\"\n  | \"treemap\"\n  | \"scatter\"\n  | \"map\"\n  | \"globe\"\n  | \"chart\";\n\nexport const DEFAULT_LABELS: ChartLabels = {\n  showData: \"Show data\",\n  hideData: \"Hide data\",\n  tableCaption: \"{title} — data\",\n  exportPng: \"PNG\",\n  exportSvg: \"SVG\",\n  exportCsv: \"CSV\",\n  loading: \"Loading chart…\",\n  empty: \"No data for this period yet.\",\n  error: \"The chart could not be loaded.\",\n  keyboardHint: \"Use the arrow keys to move between points, Home and End to jump to the ends.\",\n  roleDescription: \"chart\",\n  summaryIntro: \"{kind}, {count}.\",\n  summarySeries: \"{label}: from {first} to {last}\",\n  summaryRange: \"lowest {min} ({minAt}), highest {max} ({maxAt})\",\n  summaryTrendUp: \"up {change}\",\n  summaryTrendDown: \"down {change}\",\n  summaryTrendFlat: \"stable\",\n  summaryTotal: \"total {total}\",\n  summaryThreshold: \"{label} at {value}\",\n  summaryShare: \"{label} {value} ({share})\",\n  summaryCorrelation: \"correlation {r}\",\n  summaryConversion: \"{from} → {to} {rate}\",\n  summaryOverall: \"overall {rate}\",\n  summaryPeak: \"peak {value} ({at})\",\n  summaryActive: \"{count} with a value\",\n  summaryOhlc: \"opened at {open}, closed at {close}, low {low}, high {high}\",\n  kinds: {\n    line: \"Line chart\",\n    area: \"Area chart\",\n    bar: \"Bar chart\",\n    pie: \"Pie chart\",\n    donut: \"Donut chart\",\n    gauge: \"Gauge\",\n    sparkline: \"Sparkline\",\n    radar: \"Radar chart\",\n    heatmap: \"Heatmap\",\n    calendar: \"Calendar heatmap\",\n    sankey: \"Flow diagram\",\n    funnel: \"Funnel\",\n    candlestick: \"Candlestick chart\",\n    treemap: \"Treemap\",\n    scatter: \"Scatter chart\",\n    map: \"Map\",\n    globe: \"Globe\",\n    chart: \"Chart\",\n  },\n  category: \"Category\",\n  value: \"Value\",\n  total: \"Total\",\n  noValue: \"—\",\n};\n\n/** The words an app or a chart passes: any of them, and any of the chart names. */\nexport type ChartLabelsInput = Partial<Omit<ChartLabels, \"kinds\">> & { kinds?: Partial<Record<ChartKind, string>> };\n\n/** The default labels with an app's and a chart's on top (`kinds` merged too). */\nexport function mergeLabels(...layers: (ChartLabelsInput | undefined)[]): ChartLabels {\n  let out = DEFAULT_LABELS;\n  for (const layer of layers) {\n    if (!layer) continue;\n    out = { ...out, ...layer, kinds: { ...out.kinds, ...layer.kinds } };\n  }\n  return out;\n}\n\n/** A sentence's first letter in upper case (a template that may open a sentence: `total {total}`). */\nexport function capitalize(text: string): string {\n  return text.charAt(0).toLocaleUpperCase() + text.slice(1);\n}\n\n/** `{name}` → its value; an unknown placeholder stays as written. */\nexport function fill(template: string, values: Record<string, string | number>): string {\n  return template.replace(/\\{(\\w+)\\}/g, (match, name: string) => (name in values ? String(values[name]) : match));\n}\n","\"use client\";\n// One place for what every chart of an app shares: the locale its figures are written in, the brand its palette\n// leads with, and the words it says (translated once, from the app's catalogue). Each chart may still override them.\nimport { createContext, type ReactNode, useContext, useMemo } from \"react\";\n\nimport { type ChartLabels, type ChartLabelsInput, mergeLabels } from \"../core/labels\";\nimport type { BrandId, Locale } from \"../core/types\";\n\nexport interface ChartsSettings {\n  /** The locale of every figure and date (`\"fr-FR\"`). Default `\"en-US\"`. */\n  locale?: Locale;\n  /**\n   * The brand whose palette the charts use. Without it, a chart follows a `.brand-<id>` ancestor, else Krizaka. Set it\n   * when the app loads a brand stylesheet on `:root` (`@krizaka/tokens/brands/orazaka.css`).\n   */\n  brand?: BrandId;\n  /** The words, translated: the buttons, the states, the written summary. */\n  labels?: ChartLabelsInput;\n}\n\ninterface ResolvedSettings {\n  readonly locale: Locale;\n  readonly brand?: BrandId;\n  readonly labels: ChartLabels;\n  readonly raw?: ChartLabelsInput;\n}\n\nconst DEFAULTS: ResolvedSettings = { locale: \"en-US\", labels: mergeLabels() };\nconst Context = createContext<ResolvedSettings>(DEFAULTS);\n\nexport interface ChartsProviderProps extends ChartsSettings {\n  children: ReactNode;\n}\n\n/** Sets the locale, the brand and the words of every chart below it. */\nexport function ChartsProvider({ locale, brand, labels, children }: ChartsProviderProps) {\n  const parent = useContext(Context);\n  const value = useMemo<ResolvedSettings>(() => {\n    const raw: ChartLabelsInput | undefined = labels ? { ...parent.raw, ...labels, kinds: { ...parent.raw?.kinds, ...labels.kinds } } : parent.raw;\n    return { locale: locale ?? parent.locale, brand: brand ?? parent.brand, labels: mergeLabels(raw), raw };\n  }, [locale, brand, labels, parent]);\n  return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\n/** The settings of a chart: its own props over the provider's over the defaults. */\nexport function useChartSettings(own: ChartsSettings): { locale: Locale; brand?: BrandId; labels: ChartLabels } {\n  const shared = useContext(Context);\n  return useMemo(\n    () => ({ locale: own.locale ?? shared.locale, brand: own.brand ?? shared.brand, labels: own.labels ? mergeLabels(shared.raw, own.labels) : shared.labels }),\n    [own.locale, own.brand, own.labels, shared],\n  );\n}\n","// The data palettes. One categorical set of eight hues, stepped for each theme (the dark steps are chosen for the\n// dark surface, not flipped), ordered per brand so that the first series wears the brand's own hue — Krizaka blue,\n// Orazaka orange, Orochia violet then magenta, its gradient. Every order was chosen among the ones that pass the\n// colour-vision checks (scripts/palette.test: lightness band, chroma floor, adjacent ΔE under protan/deutan ≥ 8 —\n// Orochia light 7.2, inside the 6–8 band that requires the secondary encoding every chart carries: legend, direct\n// labels, data table —, normal-vision ΔE ≥ 15, ≥ 3:1 on the surface, the first three slots distinct all-pairs).\n// A 9th series never gets a generated hue: it folds into “Other” or a second chart.\nimport type { BrandId } from \"./types\";\n\nexport type Mode = \"dark\" | \"light\";\n\n/** The eight hues, light and dark steps. */\nexport const HUES = {\n  blue: { light: \"#2a78d6\", dark: \"#3987e5\" },\n  orange: { light: \"#eb6834\", dark: \"#d95926\" },\n  aqua: { light: \"#1baf7a\", dark: \"#199e70\" },\n  yellow: { light: \"#eda100\", dark: \"#c98500\" },\n  magenta: { light: \"#e87ba4\", dark: \"#d55181\" },\n  green: { light: \"#008300\", dark: \"#008300\" },\n  violet: { light: \"#6250d6\", dark: \"#9085e9\" },\n  red: { light: \"#e34948\", dark: \"#e66767\" },\n} as const;\n\nexport type Hue = keyof typeof HUES;\n\n/** The order of the hues for each brand: slot 1 is the brand. */\nexport const ORDERS: Record<BrandId, readonly Hue[]> = {\n  krizaka: [\"blue\", \"green\", \"magenta\", \"yellow\", \"aqua\", \"orange\", \"violet\", \"red\"],\n  orazaka: [\"orange\", \"aqua\", \"blue\", \"yellow\", \"magenta\", \"green\", \"violet\", \"red\"],\n  orochia: [\"violet\", \"magenta\", \"yellow\", \"aqua\", \"orange\", \"blue\", \"green\", \"red\"],\n};\n\n/** The categorical palette of a brand in a theme: eight hex colours, slot 1 first. */\nexport function palette(brand: BrandId, mode: Mode): string[] {\n  return ORDERS[brand].map((hue) => HUES[hue][mode]);\n}\n\n/** The diverging poles (below / above the midpoint): blue ↔ red, a neutral grey between them. */\nexport const DIVERGING = {\n  light: { low: HUES.blue.light, high: HUES.red.light },\n  dark: { low: HUES.blue.dark, high: HUES.red.dark },\n} as const;\n\n// --- Colour arithmetic (OKLab), for the sequential ramps the canvas engine needs as plain colours. ---------------\n\ntype Rgb = [number, number, number];\n\n/** `#rrggbb`, `#rgb`, `rgb(r, g, b)` / `rgba(…)` or `rgb(r g b / a)` → [r, g, b] in 0–255; null otherwise. */\nexport function parseColor(color: string): Rgb | null {\n  const hex = color.trim().match(/^#([\\da-f]{3}|[\\da-f]{6})$/i);\n  if (hex) {\n    const h = hex[1]!.length === 3 ? [...hex[1]!].map((c) => c + c).join(\"\") : hex[1]!;\n    return [0, 2, 4].map((i) => Number.parseInt(h.slice(i, i + 2), 16)) as Rgb;\n  }\n  const rgb = color.trim().match(/^rgba?\\(\\s*([\\d.]+)[\\s,]+([\\d.]+)[\\s,]+([\\d.]+)/i);\n  if (rgb) return [Number(rgb[1]), Number(rgb[2]), Number(rgb[3])];\n  return null;\n}\n\nconst toLinear = (c: number) => {\n  const v = c / 255;\n  return v <= 0.04045 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4;\n};\nconst fromLinear = (v: number) => {\n  const c = v <= 0.0031308 ? v * 12.92 : 1.055 * v ** (1 / 2.4) - 0.055;\n  return Math.round(Math.min(1, Math.max(0, c)) * 255);\n};\n\nfunction toOklab([r8, g8, b8]: Rgb): Rgb {\n  const [r, g, b] = [toLinear(r8), toLinear(g8), toLinear(b8)];\n  const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);\n  const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);\n  const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);\n  return [0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s, 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s, 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s];\n}\n\nfunction fromOklab([L, a, b]: Rgb): Rgb {\n  const l = (L + 0.3963377774 * a + 0.2158037573 * b) ** 3;\n  const m = (L - 0.1055613458 * a - 0.0638541728 * b) ** 3;\n  const s = (L - 0.0894841775 * a - 1.291485548 * b) ** 3;\n  return [\n    fromLinear(4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s),\n    fromLinear(-1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s),\n    fromLinear(-0.0041960863 * l - 0.7034186147 * m + 1.707614031 * s),\n  ];\n}\n\nconst hex = ([r, g, b]: Rgb) => `#${[r, g, b].map((c) => c.toString(16).padStart(2, \"0\")).join(\"\")}`;\n\n/** `a` → `b` at `t` (0–1), interpolated in OKLab (even steps to the eye). Unparseable colours return `b`. */\nexport function mix(a: string, b: string, t: number): string {\n  const ca = parseColor(a);\n  const cb = parseColor(b);\n  if (!ca || !cb) return b;\n  const la = toOklab(ca);\n  const lb = toOklab(cb);\n  return hex(fromOklab([0, 1, 2].map((i) => la[i]! + (lb[i]! - la[i]!) * t) as Rgb));\n}\n\n/**\n * A sequential ramp of `steps` colours, one hue from near the surface (`0`, “almost nothing”) to the full hue: the\n * magnitude of a heatmap, a calendar or a choropleth. The first step is still distinct from the surface.\n */\nexport function sequential(hue: string, surface: string, steps = 5): string[] {\n  return Array.from({ length: steps }, (_, i) => mix(surface, hue, 0.22 + (0.78 * i) / Math.max(1, steps - 1)));\n}\n\n/** WCAG contrast ratio between two colours (for the tests and the labels drawn inside a mark). */\nexport function contrast(a: string, b: string): number {\n  const lum = (c: string) => {\n    const rgb = parseColor(c);\n    if (!rgb) return 0;\n    const [r, g, bl] = rgb.map(toLinear) as Rgb;\n    return 0.2126 * r + 0.7152 * g + 0.0722 * bl;\n  };\n  const [hi, lo] = [lum(a), lum(b)].sort((x, y) => y - x) as [number, number];\n  return (hi + 0.05) / (lo + 0.05);\n}\n"],"mappings":"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","names":["hex"]}

package/dist/chunk-4LBXEAGC.js

@@ -0,0 +1,133 @@
+"use client";
+import {
+  EChartHost,
+  baseOption,
+  tooltipHtml,
+  valueAxis
+} from "./chunk-PWMMXRMC.js";
+import {
+  read
+} from "./chunk-W5FX4TU3.js";
+import {
+  valueFormatter
+} from "./chunk-XLLYNNC6.js";
+import {
+  Legend,
+  useSettings
+} from "./chunk-JTKR7ZWP.js";
+import {
+  fill
+} from "./chunk-3CJHBJXA.js";
+
+// src/scatter/scatter-chart.tsx
+import { formatNumber } from "@krizaka/intl";
+import { useCallback, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+var engine = () => import("./scatter-XSNG4OKD.js");
+function correlation(points) {
+  const n = points.length;
+  if (n < 3) return null;
+  const mx = points.reduce((s, p) => s + p.x, 0) / n;
+  const my = points.reduce((s, p) => s + p.y, 0) / n;
+  let sxy = 0;
+  let sxx = 0;
+  let syy = 0;
+  for (const p of points) {
+    sxy += (p.x - mx) * (p.y - my);
+    sxx += (p.x - mx) ** 2;
+    syy += (p.y - my) ** 2;
+  }
+  return sxx && syy ? sxy / Math.sqrt(sxx * syy) : null;
+}
+function ScatterChart(props) {
+  const { data, x, y, size, group, name, xFormat, yFormat, sizeFormat, xLabel, yLabel, sizeLabel, thresholds = [] } = props;
+  const { locale, labels } = useSettings(props);
+  const fmt = useMemo(
+    () => ({
+      x: valueFormatter(xFormat, locale, labels.noValue),
+      xAxis: valueFormatter(xFormat, locale, labels.noValue, true),
+      y: valueFormatter(yFormat, locale, labels.noValue),
+      yAxis: valueFormatter(yFormat, locale, labels.noValue, true),
+      size: valueFormatter(sizeFormat, locale, labels.noValue)
+    }),
+    [xFormat, yFormat, sizeFormat, locale, labels.noValue]
+  );
+  const points = useMemo(
+    () => data.map((d, i) => ({ x: Number(read(x, d, i)), y: Number(read(y, d, i)), s: size ? Number(read(size, d, i)) : null, g: group ? String(read(group, d, i)) : "", n: name ? String(read(name, d, i)) : "" })).filter((p) => Number.isFinite(p.x) && Number.isFinite(p.y)),
+    [data, x, y, size, group, name]
+  );
+  const groups = useMemo(() => [...new Set(points.map((p) => p.g))], [points]);
+  const isEmpty = points.length === 0;
+  const r = correlation(points);
+  const range = (values, write) => `${write(Math.min(...values))} \u2013 ${write(Math.max(...values))}`;
+  const summary = isEmpty ? labels.empty : [
+    fill(labels.summaryIntro, { kind: labels.kinds.scatter, count: points.length }),
+    `${xLabel}: ${range(points.map((p) => p.x), fmt.x)}; ${yLabel}: ${range(points.map((p) => p.y), fmt.y)}${r === null ? "" : `; ${fill(labels.summaryCorrelation, { r: formatNumber(r, { locale, maximumFractionDigits: 2, minimumFractionDigits: 2 }) })}`}.`
+  ].join(" ");
+  const bySeries = useMemo(() => groups.map((g) => points.filter((p) => p.g === g)), [groups, points]);
+  const items = bySeries.flatMap(
+    (list, s) => list.map((p, i) => ({ seriesIndex: s, dataIndex: i, text: `${p.n || p.g}${p.n || p.g ? ": " : ""}${xLabel} ${fmt.x(p.x)}, ${yLabel} ${fmt.y(p.y)}${p.s != null && sizeLabel ? `, ${sizeLabel} ${fmt.size(p.s)}` : ""}` }))
+  );
+  const maxSize = Math.max(0, ...points.map((p) => p.s ?? 0));
+  const build = useCallback(
+    (theme) => {
+      const base = baseOption(theme, true);
+      return {
+        ...base,
+        tooltip: {
+          ...base.tooltip,
+          trigger: "item",
+          formatter: (p) => {
+            const point = bySeries[p.seriesIndex][p.dataIndex];
+            return tooltipHtml(point.n || point.g || void 0, [
+              { label: xLabel, value: fmt.x(point.x), color: theme.palette[p.seriesIndex % 8] },
+              { label: yLabel, value: fmt.y(point.y) },
+              ...point.s != null && sizeLabel ? [{ label: sizeLabel, value: fmt.size(point.s) }] : []
+            ]);
+          }
+        },
+        grid: { left: 8, right: 16, top: 16, bottom: 28, containLabel: true },
+        xAxis: { ...valueAxis(theme, (v) => fmt.xAxis(v)), scale: true, name: xLabel, nameLocation: "middle", nameGap: 26, nameTextStyle: { color: theme.text2 } },
+        yAxis: { ...valueAxis(theme, (v) => fmt.yAxis(v)), scale: true },
+        series: bySeries.map((list, s) => ({
+          type: "scatter",
+          name: groups[s],
+          data: list.map((p) => [p.x, p.y, p.s ?? 0]),
+          symbolSize: (value) => size && maxSize ? 6 + Math.sqrt((value[2] ?? 0) / maxSize) * 30 : 9,
+          itemStyle: { color: theme.palette[s % 8], opacity: size ? 0.7 : 0.9, borderColor: theme.surface, borderWidth: 1.5 },
+          emphasis: { itemStyle: { opacity: 1, borderColor: theme.text, borderWidth: 2 } },
+          markLine: s === 0 && thresholds.length ? {
+            symbol: "none",
+            silent: true,
+            data: thresholds.map((t) => ({ yAxis: t.value, label: { formatter: fill(labels.summaryThreshold, { label: t.label, value: fmt.y(t.value) }), color: theme.text, position: "insideEndTop", fontWeight: 600 }, lineStyle: { color: theme.text2, type: [6, 4], width: 1.5 } }))
+          } : void 0
+        }))
+      };
+    },
+    [bySeries, groups, fmt, xLabel, yLabel, sizeLabel, size, maxSize, thresholds, labels.summaryThreshold]
+  );
+  return /* @__PURE__ */ jsx(
+    EChartHost,
+    {
+      kind: "scatter",
+      frame: props,
+      defaultHeight: 320,
+      table: {
+        columns: [labels.category, xLabel, yLabel, ...size ? [sizeLabel ?? labels.value] : []],
+        rows: points.map((p, i) => [p.n || p.g || String(i + 1), fmt.x(p.x), fmt.y(p.y), ...size ? [fmt.size(p.s)] : []])
+      },
+      summary,
+      isEmpty,
+      legend: group ? /* @__PURE__ */ jsx(Legend, { items: groups.map((g, i) => ({ label: g, color: `var(--kzc-${i % 8 + 1})` })) }) : null,
+      engine,
+      build,
+      items
+    }
+  );
+}
+
+export {
+  correlation,
+  ScatterChart
+};
+//# sourceMappingURL=chunk-4LBXEAGC.js.map

package/dist/chunk-4LBXEAGC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scatter/scatter-chart.tsx"],"sourcesContent":["\"use client\";\n// The relation between two measures — a video's length against its watch time, a job's input size against its\n// duration — a bubble's area for a third, a colour per group. The summary says what the eye looks for: the ranges and\n// the correlation (Pearson's r). The canvas renderer takes tens of thousands of points. ECharts, loaded when the chart\n// nears the screen.\nimport { formatNumber } from \"@krizaka/intl\";\nimport { useCallback, useMemo } from \"react\";\n\nimport { read } from \"../core/data\";\nimport { valueFormatter } from \"../core/format\";\nimport { fill } from \"../core/labels\";\nimport type { Accessor, Datum, Threshold, ValueFormat } from \"../core/types\";\nimport { EChartHost, type EngineProps, type WalkItem } from \"../echarts/host\";\nimport { baseOption, type ResolvedTheme, tooltipHtml, valueAxis } from \"../echarts/theme\";\nimport type { ChartFrameProps } from \"../web/frame\";\nimport { useSettings } from \"../web/frame\";\nimport { Legend } from \"../web/parts\";\n\nconst engine = () => import(\"../echarts/engines/scatter\");\n\nexport interface ScatterChartProps<T extends Datum> extends ChartFrameProps, EngineProps {\n  /** One row per point. */\n  data: readonly T[];\n  /** The fields of the two measures. */\n  x: Accessor<T, number>;\n/** The field of the vertical measure. */\n  y: Accessor<T, number>;\n  /** A third measure, drawn as the bubble's area. */\n  size?: Accessor<T, number>;\n  /** The field of a point's group: one colour per group (three at most read apart for everyone). */\n  group?: Accessor<T, string>;\n  /** The field naming a point (the tooltip's title). */\n  name?: Accessor<T, string>;\n  /** How each measure is written. */\n  xFormat?: ValueFormat;\n/** How the vertical measure is written. */\n  yFormat?: ValueFormat;\n/** How the third measure (the bubbles) is written. */\n  sizeFormat?: ValueFormat;\n  /** The names of the measures: the axes, the tooltip, the table. */\n  xLabel: string;\n/** The name of the vertical measure. */\n  yLabel: string;\n/** The name of the third measure. */\n  sizeLabel?: string;\n  /** Horizontal lines at a y value. */\n  thresholds?: readonly Threshold[];\n}\n\n/** Pearson's correlation coefficient, or null under three points or without variance. */\nexport function correlation(points: readonly { x: number; y: number }[]): number | null {\n  const n = points.length;\n  if (n < 3) return null;\n  const mx = points.reduce((s, p) => s + p.x, 0) / n;\n  const my = points.reduce((s, p) => s + p.y, 0) / n;\n  let sxy = 0;\n  let sxx = 0;\n  let syy = 0;\n  for (const p of points) {\n    sxy += (p.x - mx) * (p.y - my);\n    sxx += (p.x - mx) ** 2;\n    syy += (p.y - my) ** 2;\n  }\n  return sxx && syy ? sxy / Math.sqrt(sxx * syy) : null;\n}\n\nexport function ScatterChart<T extends Datum>(props: ScatterChartProps<T>) {\n  const { data, x, y, size, group, name, xFormat, yFormat, sizeFormat, xLabel, yLabel, sizeLabel, thresholds = [] } = props;\n  const { locale, labels } = useSettings(props);\n  const fmt = useMemo(\n    () => ({\n      x: valueFormatter(xFormat, locale, labels.noValue),\n      xAxis: valueFormatter(xFormat, locale, labels.noValue, true),\n      y: valueFormatter(yFormat, locale, labels.noValue),\n      yAxis: valueFormatter(yFormat, locale, labels.noValue, true),\n      size: valueFormatter(sizeFormat, locale, labels.noValue),\n    }),\n    [xFormat, yFormat, sizeFormat, locale, labels.noValue],\n  );\n  const points = useMemo(\n    () =>\n      data\n        .map((d, i) => ({ x: Number(read(x, d, i)), y: Number(read(y, d, i)), s: size ? Number(read(size, d, i)) : null, g: group ? String(read(group, d, i)) : \"\", n: name ? String(read(name, d, i)) : \"\" }))\n        .filter((p) => Number.isFinite(p.x) && Number.isFinite(p.y)),\n    [data, x, y, size, group, name],\n  );\n  const groups = useMemo(() => [...new Set(points.map((p) => p.g))], [points]);\n  const isEmpty = points.length === 0;\n  const r = correlation(points);\n  const range = (values: number[], write: (v: number) => string) => `${write(Math.min(...values))} – ${write(Math.max(...values))}`;\n  const summary = isEmpty\n    ? labels.empty\n    : [\n        fill(labels.summaryIntro, { kind: labels.kinds.scatter, count: points.length }),\n        `${xLabel}: ${range(points.map((p) => p.x), fmt.x)}; ${yLabel}: ${range(points.map((p) => p.y), fmt.y)}${r === null ? \"\" : `; ${fill(labels.summaryCorrelation, { r: formatNumber(r, { locale, maximumFractionDigits: 2, minimumFractionDigits: 2 }) })}`}.`,\n      ].join(\" \");\n  const bySeries = useMemo(() => groups.map((g) => points.filter((p) => p.g === g)), [groups, points]);\n  const items: WalkItem[] = bySeries.flatMap((list, s) =>\n    list.map((p, i) => ({ seriesIndex: s, dataIndex: i, text: `${p.n || p.g}${p.n || p.g ? \": \" : \"\"}${xLabel} ${fmt.x(p.x)}, ${yLabel} ${fmt.y(p.y)}${p.s != null && sizeLabel ? `, ${sizeLabel} ${fmt.size(p.s)}` : \"\"}` })),\n  );\n  const maxSize = Math.max(0, ...points.map((p) => p.s ?? 0));\n\n  const build = useCallback(\n    (theme: ResolvedTheme) => {\n      const base = baseOption(theme, true);\n      return {\n        ...base,\n        tooltip: {\n          ...(base.tooltip as object),\n          trigger: \"item\",\n          formatter: (p: { seriesIndex: number; dataIndex: number }) => {\n            const point = bySeries[p.seriesIndex]![p.dataIndex]!;\n            return tooltipHtml(point.n || point.g || undefined, [\n              { label: xLabel, value: fmt.x(point.x), color: theme.palette[p.seriesIndex % 8] },\n              { label: yLabel, value: fmt.y(point.y) },\n              ...(point.s != null && sizeLabel ? [{ label: sizeLabel, value: fmt.size(point.s) }] : []),\n            ]);\n          },\n        },\n        grid: { left: 8, right: 16, top: 16, bottom: 28, containLabel: true },\n        xAxis: { ...valueAxis(theme, (v: number) => fmt.xAxis(v)), scale: true, name: xLabel, nameLocation: \"middle\", nameGap: 26, nameTextStyle: { color: theme.text2 } },\n        yAxis: { ...valueAxis(theme, (v: number) => fmt.yAxis(v)), scale: true },\n        series: bySeries.map((list, s) => ({\n          type: \"scatter\",\n          name: groups[s],\n          data: list.map((p) => [p.x, p.y, p.s ?? 0]),\n          symbolSize: (value: number[]) => (size && maxSize ? 6 + Math.sqrt((value[2] ?? 0) / maxSize) * 30 : 9),\n          itemStyle: { color: theme.palette[s % 8], opacity: size ? 0.7 : 0.9, borderColor: theme.surface, borderWidth: 1.5 },\n          emphasis: { itemStyle: { opacity: 1, borderColor: theme.text, borderWidth: 2 } },\n          markLine:\n            s === 0 && thresholds.length\n              ? {\n                  symbol: \"none\",\n                  silent: true,\n                  data: thresholds.map((t) => ({ yAxis: t.value, label: { formatter: fill(labels.summaryThreshold, { label: t.label, value: fmt.y(t.value) }), color: theme.text, position: \"insideEndTop\", fontWeight: 600 }, lineStyle: { color: theme.text2, type: [6, 4], width: 1.5 } })),\n                }\n              : undefined,\n        })),\n      };\n    },\n    [bySeries, groups, fmt, xLabel, yLabel, sizeLabel, size, maxSize, thresholds, labels.summaryThreshold],\n  );\n\n  return (\n    <EChartHost\n      kind=\"scatter\"\n      frame={props}\n      defaultHeight={320}\n      table={{\n        columns: [labels.category, xLabel, yLabel, ...(size ? [sizeLabel ?? labels.value] : [])],\n        rows: points.map((p, i) => [p.n || p.g || String(i + 1), fmt.x(p.x), fmt.y(p.y), ...(size ? [fmt.size(p.s)] : [])]),\n      }}\n      summary={summary}\n      isEmpty={isEmpty}\n      legend={group ? <Legend items={groups.map((g, i) => ({ label: g, color: `var(--kzc-${(i % 8) + 1})` }))} /> : null}\n      engine={engine}\n      build={build}\n      items={items}\n    />\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-6FINSUOS.js

@@ -0,0 +1,49 @@
+"use client";
+
+// src/geo/world.ts
+import { useEffect, useState } from "react";
+import { feature } from "topojson-client";
+var world = null;
+function loadWorld() {
+  world ??= import("./world-110m-DVFWXS42.js").then((module) => {
+    const topology = module.default ?? module;
+    return feature(topology, topology.objects.countries);
+  });
+  return world;
+}
+function useWorld(enabled) {
+  const [state, setState] = useState({ world: null, failed: false });
+  useEffect(() => {
+    if (!enabled) return void 0;
+    let alive = true;
+    loadWorld().then(
+      (w) => alive && setState({ world: w, failed: false }),
+      () => alive && setState({ world: null, failed: true })
+    );
+    return () => {
+      alive = false;
+    };
+  }, [enabled]);
+  return state;
+}
+var displayNames = /* @__PURE__ */ new Map();
+function regionName(code, fallback, locale) {
+  if (!code) return fallback;
+  try {
+    const key = String(locale);
+    let names = displayNames.get(key);
+    if (!names) {
+      names = new Intl.DisplayNames(locale, { type: "region" });
+      displayNames.set(key, names);
+    }
+    return names.of(code) ?? fallback;
+  } catch {
+    return fallback;
+  }
+}
+
+export {
+  useWorld,
+  regionName
+};
+//# sourceMappingURL=chunk-6FINSUOS.js.map

package/dist/chunk-6FINSUOS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/geo/world.ts"],"sourcesContent":["\"use client\";\n// The world the maps draw: Natural Earth 1:110m countries (public domain) through world-atlas, keyed by ISO 3166-1\n// alpha-2 (scripts/world.mjs). ~38 kB gzipped, loaded on demand — only by GeoMap and Globe3D, once per page.\nimport type { Feature, FeatureCollection, Geometry } from \"geojson\";\nimport { useEffect, useState } from \"react\";\nimport { feature } from \"topojson-client\";\nimport type { GeometryCollection, Topology } from \"topojson-specification\";\n\nexport type Country = Omit<Feature<Geometry, { name: string }>, \"id\"> & { id?: string };\nexport type World = Omit<FeatureCollection<Geometry, { name: string }>, \"features\"> & { features: Country[] };\n\nlet world: Promise<World> | null = null;\n\n/** The countries, decoded once (a lazy chunk of the package). */\nexport function loadWorld(): Promise<World> {\n  world ??= import(\"./world-110m.json\").then((module) => {\n    const topology = (module.default ?? module) as unknown as Topology<{ countries: GeometryCollection<{ name: string }> }>;\n    return feature(topology, topology.objects.countries) as unknown as World;\n  });\n  return world;\n}\n\n/** The world once loaded (null before, or when `enabled` is false); an error leaves it null and says so. */\nexport function useWorld(enabled: boolean): { world: World | null; failed: boolean } {\n  const [state, setState] = useState<{ world: World | null; failed: boolean }>({ world: null, failed: false });\n  useEffect(() => {\n    if (!enabled) return undefined;\n    let alive = true;\n    loadWorld().then(\n      (w) => alive && setState({ world: w, failed: false }),\n      () => alive && setState({ world: null, failed: true }),\n    );\n    return () => {\n      alive = false;\n    };\n  }, [enabled]);\n  return state;\n}\n\nconst displayNames = new Map<string, Intl.DisplayNames>();\n\n/** A region's name in the reader's language (`Intl.DisplayNames`), else Natural Earth's English one. */\nexport function regionName(code: string | undefined, fallback: string, locale: string | readonly string[]): string {\n  if (!code) return fallback;\n  try {\n    const key = String(locale);\n    let names = displayNames.get(key);\n    if (!names) {\n      names = new Intl.DisplayNames(locale as string[], { type: \"region\" });\n      displayNames.set(key, names);\n    }\n    return names.of(code) ?? fallback;\n  } catch {\n    return fallback;\n  }\n}\n"],"mappings":";;;AAIA,SAAS,WAAW,gBAAgB;AACpC,SAAS,eAAe;AAMxB,IAAI,QAA+B;AAG5B,SAAS,YAA4B;AAC1C,YAAU,OAAO,0BAAmB,EAAE,KAAK,CAAC,WAAW;AACrD,UAAM,WAAY,OAAO,WAAW;AACpC,WAAO,QAAQ,UAAU,SAAS,QAAQ,SAAS;AAAA,EACrD,CAAC;AACD,SAAO;AACT;AAGO,SAAS,SAAS,SAA4D;AACnF,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAmD,EAAE,OAAO,MAAM,QAAQ,MAAM,CAAC;AAC3G,YAAU,MAAM;AACd,QAAI,CAAC,QAAS,QAAO;AACrB,QAAI,QAAQ;AACZ,cAAU,EAAE;AAAA,MACV,CAAC,MAAM,SAAS,SAAS,EAAE,OAAO,GAAG,QAAQ,MAAM,CAAC;AAAA,MACpD,MAAM,SAAS,SAAS,EAAE,OAAO,MAAM,QAAQ,KAAK,CAAC;AAAA,IACvD;AACA,WAAO,MAAM;AACX,cAAQ;AAAA,IACV;AAAA,EACF,GAAG,CAAC,OAAO,CAAC;AACZ,SAAO;AACT;AAEA,IAAM,eAAe,oBAAI,IAA+B;AAGjD,SAAS,WAAW,MAA0B,UAAkB,QAA4C;AACjH,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI;AACF,UAAM,MAAM,OAAO,MAAM;AACzB,QAAI,QAAQ,aAAa,IAAI,GAAG;AAChC,QAAI,CAAC,OAAO;AACV,cAAQ,IAAI,KAAK,aAAa,QAAoB,EAAE,MAAM,SAAS,CAAC;AACpE,mBAAa,IAAI,KAAK,KAAK;AAAA,IAC7B;AACA,WAAO,MAAM,GAAG,IAAI,KAAK;AAAA,EAC3B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/chunk-AA5EWWYV.js

@@ -0,0 +1,38 @@
+"use client";
+import {
+  EChartHost,
+  baseOption
+} from "./chunk-PWMMXRMC.js";
+
+// src/chart/chart.tsx
+import { useCallback } from "react";
+import { jsx } from "react/jsx-runtime";
+var fullEngine = () => import("./full-S2MBPEEP.js");
+function Chart({ option, modules = fullEngine, summaryText, table, items, onItem, ...frame }) {
+  const build = useCallback(
+    (theme, size) => {
+      const own = typeof option === "function" ? option(theme, size) : option;
+      return { ...baseOption(theme, true), ...own };
+    },
+    [option]
+  );
+  return /* @__PURE__ */ jsx(
+    EChartHost,
+    {
+      kind: "chart",
+      frame: { ...frame, summaryText },
+      table,
+      summary: summaryText,
+      isEmpty: table.rows.length === 0,
+      engine: modules,
+      build,
+      items,
+      onItem
+    }
+  );
+}
+
+export {
+  Chart
+};
+//# sourceMappingURL=chunk-AA5EWWYV.js.map

package/dist/chunk-AA5EWWYV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chart/chart.tsx"],"sourcesContent":["\"use client\";\n// The way out for what the typed charts do not cover: any ECharts option, on the same frame — the theme (palette, text,\n// tooltip surface resolved from the tokens, re-applied on a theme switch), the lazy engine, the states, the export —\n// and the same duty: a title, a summary and the data as a table, written by you since the option is opaque.\nimport type { EChartsCoreOption } from \"echarts/core\";\nimport { useCallback } from \"react\";\n\nimport { EChartHost, type EngineProps, type WalkItem } from \"../echarts/host\";\nimport { baseOption, type ResolvedTheme } from \"../echarts/theme\";\nimport type { ChartFrameProps, TableModel } from \"../web/frame\";\n\nconst fullEngine = () => import(\"../echarts/engines/full\");\n\nexport type { ResolvedTheme };\n\nexport interface ChartProps extends ChartFrameProps, EngineProps {\n  /** The ECharts option, or a function of the resolved theme (colours as plain strings, the palette, the ramp). */\n  option: EChartsCoreOption | ((theme: ResolvedTheme, size: { width: number; height: number }) => EChartsCoreOption);\n  /**\n   * Registers what the option needs, from `echarts/charts` and `echarts/components` (tree-shaken):\n   * `() => import(\"./my-echarts\")` where that module calls `use([...])`. Default: all of ECharts (~380 kB gzip).\n   */\n  modules?: () => Promise<unknown>;\n  /** The written summary: an option says nothing on its own. */\n  summaryText: string;\n  /** The data as a table: the alternative of every chart. */\n  table: TableModel;\n  /** What the arrow keys walk (series and data indexes, and what each one says). */\n  items?: readonly WalkItem[];\n  /** A click (or Enter) on a data item. */\n  onItem?: (item: { seriesIndex: number; dataIndex: number }) => void;\n}\n\n/** Any ECharts option, themed and framed like the typed charts. Memoise `option` when it is a function. */\nexport function Chart({ option, modules = fullEngine, summaryText, table, items, onItem, ...frame }: ChartProps) {\n  const build = useCallback(\n    (theme: ResolvedTheme, size: { width: number; height: number }) => {\n      const own = typeof option === \"function\" ? option(theme, size) : option;\n      return { ...baseOption(theme, true), ...own };\n    },\n    [option],\n  );\n  return (\n    <EChartHost\n      kind=\"chart\"\n      frame={{ ...frame, summaryText }}\n      table={table}\n      summary={summaryText}\n      isEmpty={table.rows.length === 0}\n      engine={modules}\n      build={build}\n      items={items}\n      onItem={onItem}\n    />\n  );\n}\n"],"mappings":";;;;;;;AAKA,SAAS,mBAAmB;AAsCxB;AAhCJ,IAAM,aAAa,MAAM,OAAO,oBAAyB;AAuBlD,SAAS,MAAM,EAAE,QAAQ,UAAU,YAAY,aAAa,OAAO,OAAO,QAAQ,GAAG,MAAM,GAAe;AAC/G,QAAM,QAAQ;AAAA,IACZ,CAAC,OAAsB,SAA4C;AACjE,YAAM,MAAM,OAAO,WAAW,aAAa,OAAO,OAAO,IAAI,IAAI;AACjE,aAAO,EAAE,GAAG,WAAW,OAAO,IAAI,GAAG,GAAG,IAAI;AAAA,IAC9C;AAAA,IACA,CAAC,MAAM;AAAA,EACT;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,OAAO,EAAE,GAAG,OAAO,YAAY;AAAA,MAC/B;AAAA,MACA,SAAS;AAAA,MACT,SAAS,MAAM,KAAK,WAAW;AAAA,MAC/B,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/chunk-ANUCSRUN.js

@@ -0,0 +1,43 @@
+"use client";
+import {
+  summarize
+} from "./chunk-W5FX4TU3.js";
+import {
+  capitalize,
+  fill
+} from "./chunk-3CJHBJXA.js";
+
+// src/core/describe.ts
+function describeSeries(table, { kind, labels, value, category, share, thresholds = [] }) {
+  const points = table.categories.length;
+  const first = points ? category(table.categories[0]) : "";
+  const last = points ? category(table.categories[points - 1]) : "";
+  const count = table.series.length > 1 ? `${table.series.length} \xD7 ${points}` : String(points);
+  const intro = fill(labels.summaryIntro, { kind: labels.kinds[kind], count: points > 1 ? `${count} (${first} \u2013 ${last})` : count });
+  const sentences = table.series.map((series) => {
+    const s = summarize(series, table.categories, category);
+    if (!s.count) return `${s.label}: ${labels.noValue}.`;
+    const parts = [fill(labels.summarySeries, { label: s.label, first: value(s.first), last: value(s.last) })];
+    if (s.min && s.max && s.count > 2) parts.push(fill(labels.summaryRange, { min: value(s.min.value), minAt: s.min.category, max: value(s.max.value), maxAt: s.max.category }));
+    if (s.trend === "up" || s.trend === "down") {
+      const template = s.trend === "up" ? labels.summaryTrendUp : labels.summaryTrendDown;
+      if (s.change !== null) parts.push(fill(template, { change: share(Math.abs(s.change)) }));
+    } else if (s.trend === "flat") parts.push(labels.summaryTrendFlat);
+    return `${parts.join(", ")}.`;
+  });
+  const marks = thresholds.map((t) => fill(labels.summaryThreshold, { label: t.label, value: value(t.value) }));
+  return [intro, ...sentences, ...marks.length ? [`${marks.join(", ")}.`] : []].join(" ");
+}
+function describeParts(kind, parts, { labels, value, share }) {
+  const total = parts.reduce((sum, p) => sum + Math.max(0, p.value), 0);
+  const intro = fill(labels.summaryIntro, { kind: labels.kinds[kind], count: parts.length });
+  const sorted = [...parts].sort((a, b) => b.value - a.value);
+  const items = sorted.map((p) => fill(labels.summaryShare, { label: p.label, value: value(p.value), share: share(total ? p.value / total : 0) }));
+  return `${intro} ${items.join(", ")}. ${capitalize(fill(labels.summaryTotal, { total: value(total) }))}.`;
+}
+
+export {
+  describeSeries,
+  describeParts
+};
+//# sourceMappingURL=chunk-ANUCSRUN.js.map

package/dist/chunk-ANUCSRUN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/describe.ts"],"sourcesContent":["// The written summary of a chart — what a sighted reader takes in at a glance, said in words for a screen reader (and\n// shown under the chart when `summary=\"visible\"`): the kind, the size, then per series its range, extremes and trend.\nimport { summarize, type Table } from \"./data\";\nimport type { CategoryFormatter, ValueFormatter } from \"./format\";\nimport { capitalize, type ChartKind, type ChartLabels, fill } from \"./labels\";\nimport type { Threshold } from \"./types\";\n\nexport interface DescribeOptions {\n  readonly kind: ChartKind;\n  readonly labels: ChartLabels;\n  readonly value: ValueFormatter;\n  readonly category: CategoryFormatter;\n  readonly share: (ratio: number) => string;\n  readonly thresholds?: readonly Threshold[];\n}\n\n/** A cartesian chart (line, area, bar, sparkline): one sentence per series. */\nexport function describeSeries(table: Table, { kind, labels, value, category, share, thresholds = [] }: DescribeOptions): string {\n  const points = table.categories.length;\n  const first = points ? category(table.categories[0]) : \"\";\n  const last = points ? category(table.categories[points - 1]) : \"\";\n  const count = table.series.length > 1 ? `${table.series.length} × ${points}` : String(points);\n  const intro = fill(labels.summaryIntro, { kind: labels.kinds[kind], count: points > 1 ? `${count} (${first} – ${last})` : count });\n  const sentences = table.series.map((series) => {\n    const s = summarize(series, table.categories, category);\n    if (!s.count) return `${s.label}: ${labels.noValue}.`;\n    const parts = [fill(labels.summarySeries, { label: s.label, first: value(s.first), last: value(s.last) })];\n    if (s.min && s.max && s.count > 2) parts.push(fill(labels.summaryRange, { min: value(s.min.value), minAt: s.min.category, max: value(s.max.value), maxAt: s.max.category }));\n    if (s.trend === \"up\" || s.trend === \"down\") {\n      const template = s.trend === \"up\" ? labels.summaryTrendUp : labels.summaryTrendDown;\n      if (s.change !== null) parts.push(fill(template, { change: share(Math.abs(s.change)) }));\n    } else if (s.trend === \"flat\") parts.push(labels.summaryTrendFlat);\n    return `${parts.join(\", \")}.`;\n  });\n  const marks = thresholds.map((t) => fill(labels.summaryThreshold, { label: t.label, value: value(t.value) }));\n  return [intro, ...sentences, ...(marks.length ? [`${marks.join(\", \")}.`] : [])].join(\" \");\n}\n\n/** A part-to-whole chart (pie, donut, funnel, treemap): the parts, largest first, with their share. */\nexport function describeParts(kind: ChartKind, parts: readonly { label: string; value: number }[], { labels, value, share }: Omit<DescribeOptions, \"kind\" | \"category\">): string {\n  const total = parts.reduce((sum, p) => sum + Math.max(0, p.value), 0);\n  const intro = fill(labels.summaryIntro, { kind: labels.kinds[kind], count: parts.length });\n  const sorted = [...parts].sort((a, b) => b.value - a.value);\n  const items = sorted.map((p) => fill(labels.summaryShare, { label: p.label, value: value(p.value), share: share(total ? p.value / total : 0) }));\n  return `${intro} ${items.join(\", \")}. ${capitalize(fill(labels.summaryTotal, { total: value(total) }))}.`;\n}\n"],"mappings":";;;;;;;;;;AAiBO,SAAS,eAAe,OAAc,EAAE,MAAM,QAAQ,OAAO,UAAU,OAAO,aAAa,CAAC,EAAE,GAA4B;AAC/H,QAAM,SAAS,MAAM,WAAW;AAChC,QAAM,QAAQ,SAAS,SAAS,MAAM,WAAW,CAAC,CAAC,IAAI;AACvD,QAAM,OAAO,SAAS,SAAS,MAAM,WAAW,SAAS,CAAC,CAAC,IAAI;AAC/D,QAAM,QAAQ,MAAM,OAAO,SAAS,IAAI,GAAG,MAAM,OAAO,MAAM,SAAM,MAAM,KAAK,OAAO,MAAM;AAC5F,QAAM,QAAQ,KAAK,OAAO,cAAc,EAAE,MAAM,OAAO,MAAM,IAAI,GAAG,OAAO,SAAS,IAAI,GAAG,KAAK,KAAK,KAAK,WAAM,IAAI,MAAM,MAAM,CAAC;AACjI,QAAM,YAAY,MAAM,OAAO,IAAI,CAAC,WAAW;AAC7C,UAAM,IAAI,UAAU,QAAQ,MAAM,YAAY,QAAQ;AACtD,QAAI,CAAC,EAAE,MAAO,QAAO,GAAG,EAAE,KAAK,KAAK,OAAO,OAAO;AAClD,UAAM,QAAQ,CAAC,KAAK,OAAO,eAAe,EAAE,OAAO,EAAE,OAAO,OAAO,MAAM,EAAE,KAAK,GAAG,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACzG,QAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAG,OAAM,KAAK,KAAK,OAAO,cAAc,EAAE,KAAK,MAAM,EAAE,IAAI,KAAK,GAAG,OAAO,EAAE,IAAI,UAAU,KAAK,MAAM,EAAE,IAAI,KAAK,GAAG,OAAO,EAAE,IAAI,SAAS,CAAC,CAAC;AAC3K,QAAI,EAAE,UAAU,QAAQ,EAAE,UAAU,QAAQ;AAC1C,YAAM,WAAW,EAAE,UAAU,OAAO,OAAO,iBAAiB,OAAO;AACnE,UAAI,EAAE,WAAW,KAAM,OAAM,KAAK,KAAK,UAAU,EAAE,QAAQ,MAAM,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAAA,IACzF,WAAW,EAAE,UAAU,OAAQ,OAAM,KAAK,OAAO,gBAAgB;AACjE,WAAO,GAAG,MAAM,KAAK,IAAI,CAAC;AAAA,EAC5B,CAAC;AACD,QAAM,QAAQ,WAAW,IAAI,CAAC,MAAM,KAAK,OAAO,kBAAkB,EAAE,OAAO,EAAE,OAAO,OAAO,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5G,SAAO,CAAC,OAAO,GAAG,WAAW,GAAI,MAAM,SAAS,CAAC,GAAG,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,CAAE,EAAE,KAAK,GAAG;AAC1F;AAGO,SAAS,cAAc,MAAiB,OAAoD,EAAE,QAAQ,OAAO,MAAM,GAAuD;AAC/K,QAAM,QAAQ,MAAM,OAAO,CAAC,KAAK,MAAM,MAAM,KAAK,IAAI,GAAG,EAAE,KAAK,GAAG,CAAC;AACpE,QAAM,QAAQ,KAAK,OAAO,cAAc,EAAE,MAAM,OAAO,MAAM,IAAI,GAAG,OAAO,MAAM,OAAO,CAAC;AACzF,QAAM,SAAS,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AAC1D,QAAM,QAAQ,OAAO,IAAI,CAAC,MAAM,KAAK,OAAO,cAAc,EAAE,OAAO,EAAE,OAAO,OAAO,MAAM,EAAE,KAAK,GAAG,OAAO,MAAM,QAAQ,EAAE,QAAQ,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC/I,SAAO,GAAG,KAAK,IAAI,MAAM,KAAK,IAAI,CAAC,KAAK,WAAW,KAAK,OAAO,cAAc,EAAE,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC;AACxG;","names":[]}

package/dist/chunk-ARARFMNE.js

@@ -0,0 +1,88 @@
+"use client";
+import {
+  niceDomain
+} from "./chunk-BISL7DYW.js";
+import {
+  describeSeries
+} from "./chunk-ANUCSRUN.js";
+import {
+  areaPath,
+  barPath,
+  linePath,
+  segments
+} from "./chunk-OB5EFDDH.js";
+import {
+  categoryFormatter,
+  shareFormatter,
+  valueFormatter
+} from "./chunk-XLLYNNC6.js";
+import {
+  ChartFrame,
+  colorOf,
+  useSettings
+} from "./chunk-JTKR7ZWP.js";
+
+// src/sparkline/sparkline.tsx
+import { useMemo } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+function Sparkline(props) {
+  const { data, categories, variant = "line", color, trendTone, threshold, format, width: fixed, height = 32 } = props;
+  const { locale, labels } = useSettings(props);
+  const table = useMemo(() => ({ categories: categories ?? data.map((_, i) => i + 1), series: [{ id: "v", label: props.title, values: data, slot: 1 }] }), [data, categories, props.title]);
+  const fmt = useMemo(() => ({ value: valueFormatter(format, locale, labels.noValue), category: categoryFormatter(void 0, locale), share: shareFormatter(locale) }), [format, locale, labels.noValue]);
+  const values = data.filter((v) => v != null);
+  const isEmpty = values.length === 0;
+  const summary = isEmpty ? labels.empty : describeSeries(table, { kind: "sparkline", labels, value: fmt.value, category: fmt.category, share: fmt.share, thresholds: threshold ? [threshold] : [] });
+  const first = values[0] ?? 0;
+  const last = values[values.length - 1] ?? 0;
+  const up = last >= first;
+  const tone = trendTone ? (trendTone === "inverse" ? !up : up) ? "success" : "danger" : void 0;
+  const stroke = colorOf(color ?? tone, 1);
+  return /* @__PURE__ */ jsx(
+    ChartFrame,
+    {
+      kind: "sparkline",
+      frame: { ...props, hideTitle: true, dataTable: false, height, style: { ...fixed ? { width: fixed, display: "inline-flex" } : {}, ...props.style } },
+      defaultHeight: 32,
+      table: { columns: [labels.category, props.title], rows: table.categories.map((c, i) => [fmt.category(c), fmt.value(data[i])]) },
+      summary,
+      isEmpty,
+      navigable: false,
+      ssrWidth: fixed,
+      compact: true,
+      children: (width, h) => {
+        let lo = Math.min(...values, threshold?.value ?? Number.POSITIVE_INFINITY);
+        let hi = Math.max(...values, threshold?.value ?? Number.NEGATIVE_INFINITY);
+        if (variant === "bar") {
+          lo = Math.min(0, lo);
+          hi = Math.max(0, hi);
+        }
+        const [d0, d1] = lo === hi ? niceDomain(lo, hi).domain : [lo, hi];
+        const pad = variant === "bar" ? 0 : 3;
+        const yOf = (v) => pad + (1 - (v - d0) / (d1 - d0 || 1)) * (h - pad * 2);
+        const n = data.length;
+        const xOf = (i) => variant === "bar" ? (i + 0.5) * (width / n) : n > 1 ? pad + i / (n - 1) * (width - pad * 2) : width / 2;
+        const pts = data.map((v, i) => v == null ? null : [xOf(i), yOf(v)]);
+        const lastPoint = [...pts].reverse().find(Boolean);
+        return /* @__PURE__ */ jsxs("svg", { className: "kzc-svg", width, height: h, viewBox: `0 0 ${width} ${h}`, "aria-hidden": true, children: [
+          threshold && /* @__PURE__ */ jsx("line", { x1: 0, x2: width, y1: yOf(threshold.value), y2: yOf(threshold.value), "data-tone": threshold.tone ?? "neutral", className: "kzc-threshold", style: { strokeWidth: 1 } }),
+          variant === "bar" ? data.map((v, i) => {
+            if (v == null || v === 0) return null;
+            const bw = Math.max(1, Math.min(8, width / n * 0.7));
+            const top = Math.min(yOf(v), yOf(0));
+            return /* @__PURE__ */ jsx("path", { d: barPath(xOf(i) - bw / 2, top, bw, Math.abs(yOf(v) - yOf(0)), 1.5, false, v < 0), style: { fill: stroke } }, i);
+          }) : segments(pts).map((seg) => /* @__PURE__ */ jsxs("g", { children: [
+            variant === "area" && /* @__PURE__ */ jsx("path", { d: areaPath(seg, h, "monotone"), className: "kzc-area", style: { fill: stroke } }),
+            /* @__PURE__ */ jsx("path", { d: linePath(seg, "monotone"), className: "kzc-line", style: { stroke, strokeWidth: 1.75 } })
+          ] }, seg[0][0])),
+          variant !== "bar" && lastPoint && /* @__PURE__ */ jsx("circle", { cx: lastPoint[0], cy: lastPoint[1], r: 2.75, style: { fill: stroke } })
+        ] });
+      }
+    }
+  );
+}
+
+export {
+  Sparkline
+};
+//# sourceMappingURL=chunk-ARARFMNE.js.map