minerva-design 1.0.2 → 1.2.0

package/dist/charts/engine/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","names":["DEFAULT_PALETTE","readVar","style","name","readTheme","element","buildTheme","domColorResolver","palette","createTheme","variables","input","staticColorResolver","resolveStaticColor","value","fallback","fallbackGray","resolveColor","resolve","color","names","readVariable","background","text","textMuted","border","colors","c","custom","i","fontFamily","inheritedFont","mix","watchTheme","cleanups","observer","onChange","node","query","fn"],"sources":["../../../../charts/src/engine/theme.ts"],"sourcesContent":["// Chart colors and fonts read from the Minerva CSS variables.\n\nimport {\n  domColorResolver,\n  mix,\n  resolveStaticColor,\n  type ColorResolver,\n  type Rgba,\n} from \"./color\";\n\nexport interface ChartTheme {\n  palette: Rgba[];\n  text: Rgba;\n  textMuted: Rgba;\n  grid: Rgba;\n  axis: Rgba;\n  background: Rgba;\n  surface: Rgba;\n  primary: Rgba;\n  fontFamily: string;\n  /** Tick label font size in CSS pixels */\n  fontSize: number;\n  /** Resolves the colors of the options (`var(--x)` included); static colors only when omitted */\n  resolve?: ColorResolver;\n}\n\n/** Used when no CSS variable is defined (e.g. without the Minerva stylesheet) */\nconst DEFAULT_PALETTE = [\n  \"#4f46e5\",\n  \"#10b981\",\n  \"#f59e0b\",\n  \"#ef4444\",\n  \"#0ea5e9\",\n  \"#8b5cf6\",\n  \"#14b8a6\",\n  \"#f97316\",\n];\n\nconst readVar = (style: CSSStyleDeclaration | null, name: string) =>\n  style?.getPropertyValue(name).trim() ?? \"\";\n\n/** Reads the theme from the computed style of `element` */\nexport const readTheme = (\n  element: Element | null,\n  palette?: readonly string[],\n): ChartTheme => {\n  const style =\n    element && typeof getComputedStyle === \"function\"\n      ? getComputedStyle(element)\n      : null;\n  return buildTheme(\n    (name) => readVar(style, name),\n    domColorResolver(element),\n    palette,\n    style?.fontFamily ?? \"\",\n  );\n};\n\n/** Theme of the charts drawn without a DOM (mini-programs, React Native) */\nexport interface ChartThemeInput {\n  /**\n   * Values of the Minerva CSS variables (`--primary-color`, `--text-color`,\n   * `--chart-series-1`, ...) used for the theme colors and to resolve\n   * `var(--name)` colors of the options\n   */\n  variables?: Readonly<Record<string, string>>;\n  /** Series colors (hex / rgb) */\n  palette?: readonly string[];\n  /** Font family of the labels */\n  fontFamily?: string;\n  /**\n   * Font size of the tick labels, in pixels\n   * @default 11\n   */\n  fontSize?: number;\n}\n\n/** Builds a theme from plain values (no DOM) */\nexport const createTheme = (\n  input: ChartThemeInput = {},\n  palette?: readonly string[],\n): ChartTheme => {\n  const variables = input.variables ?? {};\n  const theme = buildTheme(\n    (name) => variables[name]?.trim() ?? \"\",\n    staticColorResolver(variables),\n    palette?.length ? palette : input.palette,\n    \"\",\n  );\n  return {\n    ...theme,\n    ...(input.fontFamily ? { fontFamily: input.fontFamily } : {}),\n    ...(input.fontSize ? { fontSize: input.fontSize } : {}),\n  };\n};\n\n/** Resolver of `var(--name, fallback)` colors against plain variables */\nexport const staticColorResolver =\n  (variables: Readonly<Record<string, string>>): ColorResolver =>\n  (value, fallback) =>\n    resolveStaticColor(value, variables, fallback);\n\nconst buildTheme = (\n  readVariable: (name: string) => string,\n  resolve: ColorResolver,\n  palette: readonly string[] | undefined,\n  inheritedFont: string,\n): ChartTheme => {\n  const fallbackGray: Rgba = [0.4, 0.4, 0.4, 1];\n  const resolveColor = (value: string) => resolve(value, fallbackGray);\n  const color = (names: string[], fallback: string): Rgba => {\n    for (const name of names) {\n      if (readVariable(name)) return resolveColor(`var(${name})`);\n    }\n    return resolveColor(fallback);\n  };\n\n  const background = color(\n    [\"--surface-color\", \"--background-color\"],\n    \"#ffffff\",\n  );\n  const text = color([\"--text-color\"], \"#1f2937\");\n  const textMuted = color(\n    [\"--text-secondary-color\", \"--text-muted-color\"],\n    \"#6b7280\",\n  );\n  const border = color([\"--border-color\"], \"#e5e7eb\");\n\n  let colors: Rgba[];\n  if (palette && palette.length) {\n    colors = palette.map((c) => resolveColor(c));\n  } else {\n    const custom: Rgba[] = [];\n    for (let i = 1; i <= 8; i++) {\n      const name = `--chart-series-${i}`;\n      if (readVariable(name)) custom.push(resolveColor(`var(${name})`));\n    }\n    if (custom.length) {\n      colors = custom;\n    } else {\n      const themed = [\n        \"--primary-color\",\n        \"--success-color\",\n        \"--warning-color\",\n        \"--danger-color\",\n        \"--info-color\",\n      ].map((name, i) =>\n        readVariable(name)\n          ? resolveColor(`var(${name})`)\n          : resolveColor(DEFAULT_PALETTE[i]),\n      );\n      colors = [\n        ...themed,\n        ...DEFAULT_PALETTE.slice(5).map((c) => resolveColor(c)),\n      ];\n    }\n  }\n\n  const fontFamily =\n    readVariable(\"--font-family-sans\") ||\n    inheritedFont ||\n    \"system-ui, -apple-system, 'Segoe UI', sans-serif\";\n\n  return {\n    palette: colors,\n    text,\n    textMuted,\n    grid: mix(background, border, 0.75),\n    axis: border,\n    background,\n    surface: background,\n    primary: colors[0],\n    fontFamily,\n    fontSize: 11,\n    resolve,\n  };\n};\n\n/**\n * Calls `onChange` when the theme may have changed: attributes of `<html>` /\n * `<body>` (class, style, data-theme) and the color scheme.\n */\nexport const watchTheme = (onChange: () => void): (() => void) => {\n  if (typeof document === \"undefined\") return () => {};\n  const cleanups: (() => void)[] = [];\n  if (typeof MutationObserver === \"function\") {\n    const observer = new MutationObserver(onChange);\n    for (const node of [document.documentElement, document.body]) {\n      if (node) {\n        observer.observe(node, {\n          attributes: true,\n          attributeFilter: [\"class\", \"style\", \"data-theme\", \"data-mode\"],\n        });\n      }\n    }\n    cleanups.push(() => observer.disconnect());\n  }\n  if (typeof matchMedia === \"function\") {\n    const query = matchMedia(\"(prefers-color-scheme: dark)\");\n    query.addEventListener?.(\"change\", onChange);\n    cleanups.push(() => query.removeEventListener?.(\"change\", onChange));\n  }\n  return () => cleanups.forEach((fn) => fn());\n};\n"],"mappings":"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"}

package/dist/charts/engine/time.cjs

@@ -0,0 +1,2 @@
+const e=require("./scale.cjs");var t=1e3,n=60*t,r=60*n,i=24*r,a=30*i,o=365*i,s=[{unit:`second`,step:1,ms:t},{unit:`second`,step:5,ms:5*t},{unit:`second`,step:15,ms:15*t},{unit:`second`,step:30,ms:30*t},{unit:`minute`,step:1,ms:n},{unit:`minute`,step:5,ms:5*n},{unit:`minute`,step:15,ms:15*n},{unit:`minute`,step:30,ms:30*n},{unit:`hour`,step:1,ms:r},{unit:`hour`,step:3,ms:3*r},{unit:`hour`,step:6,ms:6*r},{unit:`hour`,step:12,ms:12*r},{unit:`day`,step:1,ms:i},{unit:`day`,step:2,ms:2*i},{unit:`day`,step:7,ms:7*i},{unit:`month`,step:1,ms:a},{unit:`month`,step:3,ms:3*a},{unit:`month`,step:6,ms:6*a}],c=(e,t=2)=>String(e).padStart(t,`0`),l=(n,r)=>{let i=n/Math.max(1,r);if(i<t*.75)return{unit:`millisecond`,step:e.tickStep(0,n,r),ms:1};for(let e of s)if(e.ms>=i*.75)return e;let a=Math.max(1,e.tickStep(0,n/o,r));return{unit:`year`,step:Math.round(a),ms:Math.round(a)*o}},u=(e,{unit:t,step:n})=>{let r=new Date(e);switch(t){case`second`:r.setMilliseconds(0),r.setSeconds(r.getSeconds()-r.getSeconds()%n);break;case`minute`:r.setSeconds(0,0),r.setMinutes(r.getMinutes()-r.getMinutes()%n);break;case`hour`:r.setMinutes(0,0,0),r.setHours(r.getHours()-r.getHours()%n);break;case`day`:r.setHours(0,0,0,0),n===7&&r.setDate(r.getDate()-(r.getDay()+6)%7);break;case`month`:r.setHours(0,0,0,0),r.setDate(1),r.setMonth(r.getMonth()-r.getMonth()%n);break;case`year`:r.setHours(0,0,0,0),r.setMonth(0,1),r.setFullYear(r.getFullYear()-r.getFullYear()%n)}return r},d=(e,{unit:t,step:n})=>{switch(t){case`second`:e.setSeconds(e.getSeconds()+n);break;case`minute`:e.setMinutes(e.getMinutes()+n);break;case`hour`:e.setHours(e.getHours()+n);break;case`day`:e.setDate(e.getDate()+n);break;case`month`:e.setMonth(e.getMonth()+n);break;case`year`:e.setFullYear(e.getFullYear()+n)}},f=(t,n,r)=>{t>n&&([t,n]=[n,t]);let i=l(n-t,r);if(i.unit===`millisecond`)return{values:e.linearTicks(t,n,r),unit:`millisecond`,format:e=>g(e,`millisecond`)};let a=[],o=u(t,i);for(;o.getTime()<t;)d(o,i);for(;o.getTime()<=n&&a.length<500;)a.push(o.getTime()),d(o,i);let{unit:s}=i;return{values:a,unit:s,format:e=>h(e,s)}},p=e=>`${e.getFullYear()}-${c(e.getMonth()+1)}-${c(e.getDate())}`,m=e=>`${c(e.getHours())}:${c(e.getMinutes())}`,h=(e,t)=>{let n=new Date(e),r=n.getHours()===0&&n.getMinutes()===0&&n.getSeconds()===0;switch(t){case`second`:return`${m(n)}:${c(n.getSeconds())}`;case`minute`:case`hour`:return r?`${c(n.getMonth()+1)}-${c(n.getDate())}`:m(n);case`day`:return n.getMonth()===0&&n.getDate()===1?String(n.getFullYear()):`${c(n.getMonth()+1)}-${c(n.getDate())}`;case`month`:return n.getMonth()===0?String(n.getFullYear()):`${n.getFullYear()}-${c(n.getMonth()+1)}`;default:return String(n.getFullYear())}},g=(e,t=`minute`)=>{let n=new Date(e);if(Number.isNaN(n.getTime()))return`–`;switch(t){case`millisecond`:return`${p(n)} ${m(n)}:${c(n.getSeconds())}.${c(n.getMilliseconds(),3)}`;case`second`:return`${p(n)} ${m(n)}:${c(n.getSeconds())}`;case`minute`:case`hour`:return`${p(n)} ${m(n)}`;default:return p(n)}};exports.formatTime=g,exports.timeTicks=f;
+//# sourceMappingURL=time.cjs.map

package/dist/charts/engine/time.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.cjs","names":["tickStep","linearTicks","require_scale","SECOND","MINUTE","HOUR","DAY","MONTH","YEAR","INTERVALS","pad","n","width","chooseInterval","target","span","count","interval","years","floorTo","d","t","unit","step","advance","timeTicks","min","max","formatTime","v","values","formatTick","ymd","hm","value","midnight"],"sources":["../../../../charts/src/engine/time.ts"],"sourcesContent":["// Ticks and labels of time axes (timestamps in ms, local time).\n\nimport { linearTicks, tickStep } from \"./scale\";\n\nconst SECOND = 1000;\nconst MINUTE = 60 * SECOND;\nconst HOUR = 60 * MINUTE;\nconst DAY = 24 * HOUR;\nconst MONTH = 30 * DAY;\nconst YEAR = 365 * DAY;\n\nexport type TimeUnit =\n  \"millisecond\" | \"second\" | \"minute\" | \"hour\" | \"day\" | \"month\" | \"year\";\n\ninterface Interval {\n  unit: TimeUnit;\n  step: number;\n  /** Approximate duration (ms) */\n  ms: number;\n}\n\nconst INTERVALS: Interval[] = [\n  { unit: \"second\", step: 1, ms: SECOND },\n  { unit: \"second\", step: 5, ms: 5 * SECOND },\n  { unit: \"second\", step: 15, ms: 15 * SECOND },\n  { unit: \"second\", step: 30, ms: 30 * SECOND },\n  { unit: \"minute\", step: 1, ms: MINUTE },\n  { unit: \"minute\", step: 5, ms: 5 * MINUTE },\n  { unit: \"minute\", step: 15, ms: 15 * MINUTE },\n  { unit: \"minute\", step: 30, ms: 30 * MINUTE },\n  { unit: \"hour\", step: 1, ms: HOUR },\n  { unit: \"hour\", step: 3, ms: 3 * HOUR },\n  { unit: \"hour\", step: 6, ms: 6 * HOUR },\n  { unit: \"hour\", step: 12, ms: 12 * HOUR },\n  { unit: \"day\", step: 1, ms: DAY },\n  { unit: \"day\", step: 2, ms: 2 * DAY },\n  { unit: \"day\", step: 7, ms: 7 * DAY },\n  { unit: \"month\", step: 1, ms: MONTH },\n  { unit: \"month\", step: 3, ms: 3 * MONTH },\n  { unit: \"month\", step: 6, ms: 6 * MONTH },\n];\n\nconst pad = (n: number, width = 2) => String(n).padStart(width, \"0\");\n\nconst chooseInterval = (span: number, count: number): Interval => {\n  const target = span / Math.max(1, count);\n  if (target < SECOND * 0.75) {\n    return { unit: \"millisecond\", step: tickStep(0, span, count), ms: 1 };\n  }\n  for (const interval of INTERVALS) {\n    if (interval.ms >= target * 0.75) return interval;\n  }\n  const years = Math.max(1, tickStep(0, span / YEAR, count));\n  return {\n    unit: \"year\",\n    step: Math.round(years),\n    ms: Math.round(years) * YEAR,\n  };\n};\n\n/** Start of the tick sequence: `t` floored to the unit, aligned on the step */\nconst floorTo = (t: number, { unit, step }: Interval): Date => {\n  const d = new Date(t);\n  switch (unit) {\n    case \"second\":\n      d.setMilliseconds(0);\n      d.setSeconds(d.getSeconds() - (d.getSeconds() % step));\n      break;\n    case \"minute\":\n      d.setSeconds(0, 0);\n      d.setMinutes(d.getMinutes() - (d.getMinutes() % step));\n      break;\n    case \"hour\":\n      d.setMinutes(0, 0, 0);\n      d.setHours(d.getHours() - (d.getHours() % step));\n      break;\n    case \"day\":\n      d.setHours(0, 0, 0, 0);\n      // weeks start on Monday\n      if (step === 7) d.setDate(d.getDate() - ((d.getDay() + 6) % 7));\n      break;\n    case \"month\":\n      d.setHours(0, 0, 0, 0);\n      d.setDate(1);\n      d.setMonth(d.getMonth() - (d.getMonth() % step));\n      break;\n    case \"year\":\n      d.setHours(0, 0, 0, 0);\n      d.setMonth(0, 1);\n      d.setFullYear(d.getFullYear() - (d.getFullYear() % step));\n      break;\n    default:\n      break;\n  }\n  return d;\n};\n\nconst advance = (d: Date, { unit, step }: Interval) => {\n  switch (unit) {\n    case \"second\":\n      d.setSeconds(d.getSeconds() + step);\n      break;\n    case \"minute\":\n      d.setMinutes(d.getMinutes() + step);\n      break;\n    case \"hour\":\n      d.setHours(d.getHours() + step);\n      break;\n    case \"day\":\n      d.setDate(d.getDate() + step);\n      break;\n    case \"month\":\n      d.setMonth(d.getMonth() + step);\n      break;\n    case \"year\":\n      d.setFullYear(d.getFullYear() + step);\n      break;\n    default:\n      break;\n  }\n};\n\nexport interface TimeTicks {\n  values: number[];\n  unit: TimeUnit;\n  format: (value: number) => string;\n}\n\n/** Calendar-aligned ticks between two timestamps */\nexport const timeTicks = (\n  min: number,\n  max: number,\n  count: number,\n): TimeTicks => {\n  if (min > max) [min, max] = [max, min];\n  const interval = chooseInterval(max - min, count);\n  if (interval.unit === \"millisecond\") {\n    return {\n      values: linearTicks(min, max, count),\n      unit: \"millisecond\",\n      format: (v) => formatTime(v, \"millisecond\"),\n    };\n  }\n  const values: number[] = [];\n  const d = floorTo(min, interval);\n  while (d.getTime() < min) advance(d, interval);\n  while (d.getTime() <= max && values.length < 500) {\n    values.push(d.getTime());\n    advance(d, interval);\n  }\n  const { unit } = interval;\n  return { values, unit, format: (v) => formatTick(v, unit) };\n};\n\nconst ymd = (d: Date) =>\n  `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;\nconst hm = (d: Date) => `${pad(d.getHours())}:${pad(d.getMinutes())}`;\n\n/** Short tick label; day boundaries show the date, year boundaries the year */\nconst formatTick = (value: number, unit: TimeUnit): string => {\n  const d = new Date(value);\n  const midnight =\n    d.getHours() === 0 && d.getMinutes() === 0 && d.getSeconds() === 0;\n  switch (unit) {\n    case \"second\":\n      return `${hm(d)}:${pad(d.getSeconds())}`;\n    case \"minute\":\n    case \"hour\":\n      return midnight ? `${pad(d.getMonth() + 1)}-${pad(d.getDate())}` : hm(d);\n    case \"day\":\n      return d.getMonth() === 0 && d.getDate() === 1\n        ? String(d.getFullYear())\n        : `${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;\n    case \"month\":\n      return d.getMonth() === 0\n        ? String(d.getFullYear())\n        : `${d.getFullYear()}-${pad(d.getMonth() + 1)}`;\n    default:\n      return String(d.getFullYear());\n  }\n};\n\n/** Full label (tooltips): precision follows the unit of the ticks */\nexport const formatTime = (\n  value: number,\n  unit: TimeUnit = \"minute\",\n): string => {\n  const d = new Date(value);\n  if (Number.isNaN(d.getTime())) return \"–\";\n  switch (unit) {\n    case \"millisecond\":\n      return `${ymd(d)} ${hm(d)}:${pad(d.getSeconds())}.${pad(d.getMilliseconds(), 3)}`;\n    case \"second\":\n      return `${ymd(d)} ${hm(d)}:${pad(d.getSeconds())}`;\n    case \"minute\":\n    case \"hour\":\n      return `${ymd(d)} ${hm(d)}`;\n    default:\n      return ymd(d);\n  }\n};\n"],"mappings":"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"}

package/dist/charts/engine/time.d.cts

@@ -0,0 +1,10 @@
+export type TimeUnit = "millisecond" | "second" | "minute" | "hour" | "day" | "month" | "year";
+export interface TimeTicks {
+    values: number[];
+    unit: TimeUnit;
+    format: (value: number) => string;
+}
+/** Calendar-aligned ticks between two timestamps */
+export declare const timeTicks: (min: number, max: number, count: number) => TimeTicks;
+/** Full label (tooltips): precision follows the unit of the ticks */
+export declare const formatTime: (value: number, unit?: TimeUnit) => string;

package/dist/charts/engine/time.d.ts

@@ -0,0 +1,10 @@
+export type TimeUnit = "millisecond" | "second" | "minute" | "hour" | "day" | "month" | "year";
+export interface TimeTicks {
+    values: number[];
+    unit: TimeUnit;
+    format: (value: number) => string;
+}
+/** Calendar-aligned ticks between two timestamps */
+export declare const timeTicks: (min: number, max: number, count: number) => TimeTicks;
+/** Full label (tooltips): precision follows the unit of the ticks */
+export declare const formatTime: (value: number, unit?: TimeUnit) => string;

package/dist/charts/engine/time.js

@@ -0,0 +1,189 @@
+import { linearTicks as e, tickStep as t } from "./scale.js";
+//#region src/engine/time.ts
+var n = 1e3, r = 60 * n, i = 60 * r, a = 24 * i, o = 30 * a, s = 365 * a, c = [
+	{
+		unit: "second",
+		step: 1,
+		ms: n
+	},
+	{
+		unit: "second",
+		step: 5,
+		ms: 5 * n
+	},
+	{
+		unit: "second",
+		step: 15,
+		ms: 15 * n
+	},
+	{
+		unit: "second",
+		step: 30,
+		ms: 30 * n
+	},
+	{
+		unit: "minute",
+		step: 1,
+		ms: r
+	},
+	{
+		unit: "minute",
+		step: 5,
+		ms: 5 * r
+	},
+	{
+		unit: "minute",
+		step: 15,
+		ms: 15 * r
+	},
+	{
+		unit: "minute",
+		step: 30,
+		ms: 30 * r
+	},
+	{
+		unit: "hour",
+		step: 1,
+		ms: i
+	},
+	{
+		unit: "hour",
+		step: 3,
+		ms: 3 * i
+	},
+	{
+		unit: "hour",
+		step: 6,
+		ms: 6 * i
+	},
+	{
+		unit: "hour",
+		step: 12,
+		ms: 12 * i
+	},
+	{
+		unit: "day",
+		step: 1,
+		ms: a
+	},
+	{
+		unit: "day",
+		step: 2,
+		ms: 2 * a
+	},
+	{
+		unit: "day",
+		step: 7,
+		ms: 7 * a
+	},
+	{
+		unit: "month",
+		step: 1,
+		ms: o
+	},
+	{
+		unit: "month",
+		step: 3,
+		ms: 3 * o
+	},
+	{
+		unit: "month",
+		step: 6,
+		ms: 6 * o
+	}
+], l = (e, t = 2) => String(e).padStart(t, "0"), u = (e, r) => {
+	let i = e / Math.max(1, r);
+	if (i < n * .75) return {
+		unit: "millisecond",
+		step: t(0, e, r),
+		ms: 1
+	};
+	for (let e of c) if (e.ms >= i * .75) return e;
+	let a = Math.max(1, t(0, e / s, r));
+	return {
+		unit: "year",
+		step: Math.round(a),
+		ms: Math.round(a) * s
+	};
+}, d = (e, { unit: t, step: n }) => {
+	let r = new Date(e);
+	switch (t) {
+		case "second":
+			r.setMilliseconds(0), r.setSeconds(r.getSeconds() - r.getSeconds() % n);
+			break;
+		case "minute":
+			r.setSeconds(0, 0), r.setMinutes(r.getMinutes() - r.getMinutes() % n);
+			break;
+		case "hour":
+			r.setMinutes(0, 0, 0), r.setHours(r.getHours() - r.getHours() % n);
+			break;
+		case "day":
+			r.setHours(0, 0, 0, 0), n === 7 && r.setDate(r.getDate() - (r.getDay() + 6) % 7);
+			break;
+		case "month":
+			r.setHours(0, 0, 0, 0), r.setDate(1), r.setMonth(r.getMonth() - r.getMonth() % n);
+			break;
+		case "year": r.setHours(0, 0, 0, 0), r.setMonth(0, 1), r.setFullYear(r.getFullYear() - r.getFullYear() % n);
+	}
+	return r;
+}, f = (e, { unit: t, step: n }) => {
+	switch (t) {
+		case "second":
+			e.setSeconds(e.getSeconds() + n);
+			break;
+		case "minute":
+			e.setMinutes(e.getMinutes() + n);
+			break;
+		case "hour":
+			e.setHours(e.getHours() + n);
+			break;
+		case "day":
+			e.setDate(e.getDate() + n);
+			break;
+		case "month":
+			e.setMonth(e.getMonth() + n);
+			break;
+		case "year": e.setFullYear(e.getFullYear() + n);
+	}
+}, p = (t, n, r) => {
+	t > n && ([t, n] = [n, t]);
+	let i = u(n - t, r);
+	if (i.unit === "millisecond") return {
+		values: e(t, n, r),
+		unit: "millisecond",
+		format: (e) => _(e, "millisecond")
+	};
+	let a = [], o = d(t, i);
+	for (; o.getTime() < t;) f(o, i);
+	for (; o.getTime() <= n && a.length < 500;) a.push(o.getTime()), f(o, i);
+	let { unit: s } = i;
+	return {
+		values: a,
+		unit: s,
+		format: (e) => g(e, s)
+	};
+}, m = (e) => `${e.getFullYear()}-${l(e.getMonth() + 1)}-${l(e.getDate())}`, h = (e) => `${l(e.getHours())}:${l(e.getMinutes())}`, g = (e, t) => {
+	let n = new Date(e), r = n.getHours() === 0 && n.getMinutes() === 0 && n.getSeconds() === 0;
+	switch (t) {
+		case "second": return `${h(n)}:${l(n.getSeconds())}`;
+		case "minute":
+		case "hour": return r ? `${l(n.getMonth() + 1)}-${l(n.getDate())}` : h(n);
+		case "day": return n.getMonth() === 0 && n.getDate() === 1 ? String(n.getFullYear()) : `${l(n.getMonth() + 1)}-${l(n.getDate())}`;
+		case "month": return n.getMonth() === 0 ? String(n.getFullYear()) : `${n.getFullYear()}-${l(n.getMonth() + 1)}`;
+		default: return String(n.getFullYear());
+	}
+}, _ = (e, t = "minute") => {
+	let n = new Date(e);
+	if (Number.isNaN(n.getTime())) return "–";
+	switch (t) {
+		case "millisecond": return `${m(n)} ${h(n)}:${l(n.getSeconds())}.${l(n.getMilliseconds(), 3)}`;
+		case "second": return `${m(n)} ${h(n)}:${l(n.getSeconds())}`;
+		case "minute":
+		case "hour": return `${m(n)} ${h(n)}`;
+		default: return m(n);
+	}
+};
+//#endregion
+export { _ as formatTime, p as timeTicks };
+
+//# sourceMappingURL=time.js.map

package/dist/charts/engine/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","names":["SECOND","MINUTE","HOUR","DAY","MONTH","YEAR","INTERVALS","pad","n","width","chooseInterval","target","span","count","tickStep","interval","years","floorTo","d","t","unit","step","advance","timeTicks","min","max","linearTicks","formatTime","v","values","formatTick","ymd","hm","value","midnight"],"sources":["../../../../charts/src/engine/time.ts"],"sourcesContent":["// Ticks and labels of time axes (timestamps in ms, local time).\n\nimport { linearTicks, tickStep } from \"./scale\";\n\nconst SECOND = 1000;\nconst MINUTE = 60 * SECOND;\nconst HOUR = 60 * MINUTE;\nconst DAY = 24 * HOUR;\nconst MONTH = 30 * DAY;\nconst YEAR = 365 * DAY;\n\nexport type TimeUnit =\n  \"millisecond\" | \"second\" | \"minute\" | \"hour\" | \"day\" | \"month\" | \"year\";\n\ninterface Interval {\n  unit: TimeUnit;\n  step: number;\n  /** Approximate duration (ms) */\n  ms: number;\n}\n\nconst INTERVALS: Interval[] = [\n  { unit: \"second\", step: 1, ms: SECOND },\n  { unit: \"second\", step: 5, ms: 5 * SECOND },\n  { unit: \"second\", step: 15, ms: 15 * SECOND },\n  { unit: \"second\", step: 30, ms: 30 * SECOND },\n  { unit: \"minute\", step: 1, ms: MINUTE },\n  { unit: \"minute\", step: 5, ms: 5 * MINUTE },\n  { unit: \"minute\", step: 15, ms: 15 * MINUTE },\n  { unit: \"minute\", step: 30, ms: 30 * MINUTE },\n  { unit: \"hour\", step: 1, ms: HOUR },\n  { unit: \"hour\", step: 3, ms: 3 * HOUR },\n  { unit: \"hour\", step: 6, ms: 6 * HOUR },\n  { unit: \"hour\", step: 12, ms: 12 * HOUR },\n  { unit: \"day\", step: 1, ms: DAY },\n  { unit: \"day\", step: 2, ms: 2 * DAY },\n  { unit: \"day\", step: 7, ms: 7 * DAY },\n  { unit: \"month\", step: 1, ms: MONTH },\n  { unit: \"month\", step: 3, ms: 3 * MONTH },\n  { unit: \"month\", step: 6, ms: 6 * MONTH },\n];\n\nconst pad = (n: number, width = 2) => String(n).padStart(width, \"0\");\n\nconst chooseInterval = (span: number, count: number): Interval => {\n  const target = span / Math.max(1, count);\n  if (target < SECOND * 0.75) {\n    return { unit: \"millisecond\", step: tickStep(0, span, count), ms: 1 };\n  }\n  for (const interval of INTERVALS) {\n    if (interval.ms >= target * 0.75) return interval;\n  }\n  const years = Math.max(1, tickStep(0, span / YEAR, count));\n  return {\n    unit: \"year\",\n    step: Math.round(years),\n    ms: Math.round(years) * YEAR,\n  };\n};\n\n/** Start of the tick sequence: `t` floored to the unit, aligned on the step */\nconst floorTo = (t: number, { unit, step }: Interval): Date => {\n  const d = new Date(t);\n  switch (unit) {\n    case \"second\":\n      d.setMilliseconds(0);\n      d.setSeconds(d.getSeconds() - (d.getSeconds() % step));\n      break;\n    case \"minute\":\n      d.setSeconds(0, 0);\n      d.setMinutes(d.getMinutes() - (d.getMinutes() % step));\n      break;\n    case \"hour\":\n      d.setMinutes(0, 0, 0);\n      d.setHours(d.getHours() - (d.getHours() % step));\n      break;\n    case \"day\":\n      d.setHours(0, 0, 0, 0);\n      // weeks start on Monday\n      if (step === 7) d.setDate(d.getDate() - ((d.getDay() + 6) % 7));\n      break;\n    case \"month\":\n      d.setHours(0, 0, 0, 0);\n      d.setDate(1);\n      d.setMonth(d.getMonth() - (d.getMonth() % step));\n      break;\n    case \"year\":\n      d.setHours(0, 0, 0, 0);\n      d.setMonth(0, 1);\n      d.setFullYear(d.getFullYear() - (d.getFullYear() % step));\n      break;\n    default:\n      break;\n  }\n  return d;\n};\n\nconst advance = (d: Date, { unit, step }: Interval) => {\n  switch (unit) {\n    case \"second\":\n      d.setSeconds(d.getSeconds() + step);\n      break;\n    case \"minute\":\n      d.setMinutes(d.getMinutes() + step);\n      break;\n    case \"hour\":\n      d.setHours(d.getHours() + step);\n      break;\n    case \"day\":\n      d.setDate(d.getDate() + step);\n      break;\n    case \"month\":\n      d.setMonth(d.getMonth() + step);\n      break;\n    case \"year\":\n      d.setFullYear(d.getFullYear() + step);\n      break;\n    default:\n      break;\n  }\n};\n\nexport interface TimeTicks {\n  values: number[];\n  unit: TimeUnit;\n  format: (value: number) => string;\n}\n\n/** Calendar-aligned ticks between two timestamps */\nexport const timeTicks = (\n  min: number,\n  max: number,\n  count: number,\n): TimeTicks => {\n  if (min > max) [min, max] = [max, min];\n  const interval = chooseInterval(max - min, count);\n  if (interval.unit === \"millisecond\") {\n    return {\n      values: linearTicks(min, max, count),\n      unit: \"millisecond\",\n      format: (v) => formatTime(v, \"millisecond\"),\n    };\n  }\n  const values: number[] = [];\n  const d = floorTo(min, interval);\n  while (d.getTime() < min) advance(d, interval);\n  while (d.getTime() <= max && values.length < 500) {\n    values.push(d.getTime());\n    advance(d, interval);\n  }\n  const { unit } = interval;\n  return { values, unit, format: (v) => formatTick(v, unit) };\n};\n\nconst ymd = (d: Date) =>\n  `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;\nconst hm = (d: Date) => `${pad(d.getHours())}:${pad(d.getMinutes())}`;\n\n/** Short tick label; day boundaries show the date, year boundaries the year */\nconst formatTick = (value: number, unit: TimeUnit): string => {\n  const d = new Date(value);\n  const midnight =\n    d.getHours() === 0 && d.getMinutes() === 0 && d.getSeconds() === 0;\n  switch (unit) {\n    case \"second\":\n      return `${hm(d)}:${pad(d.getSeconds())}`;\n    case \"minute\":\n    case \"hour\":\n      return midnight ? `${pad(d.getMonth() + 1)}-${pad(d.getDate())}` : hm(d);\n    case \"day\":\n      return d.getMonth() === 0 && d.getDate() === 1\n        ? String(d.getFullYear())\n        : `${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;\n    case \"month\":\n      return d.getMonth() === 0\n        ? String(d.getFullYear())\n        : `${d.getFullYear()}-${pad(d.getMonth() + 1)}`;\n    default:\n      return String(d.getFullYear());\n  }\n};\n\n/** Full label (tooltips): precision follows the unit of the ticks */\nexport const formatTime = (\n  value: number,\n  unit: TimeUnit = \"minute\",\n): string => {\n  const d = new Date(value);\n  if (Number.isNaN(d.getTime())) return \"–\";\n  switch (unit) {\n    case \"millisecond\":\n      return `${ymd(d)} ${hm(d)}:${pad(d.getSeconds())}.${pad(d.getMilliseconds(), 3)}`;\n    case \"second\":\n      return `${ymd(d)} ${hm(d)}:${pad(d.getSeconds())}`;\n    case \"minute\":\n    case \"hour\":\n      return `${ymd(d)} ${hm(d)}`;\n    default:\n      return ymd(d);\n  }\n};\n"],"mappings":"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"}

package/dist/charts/engine/types.d.cts

@@ -0,0 +1,356 @@
+/** GPU / CPU backend that draws the data layer */
+export type ChartRendererKind = "webgpu" | "webgl2" | "canvas2d";
+/**
+ * Requested backend: `auto` tries WebGPU, then WebGL2, then Canvas2D, and
+ * skips GPU backends that run in software (no hardware acceleration)
+ */
+export type ChartRendererPreference = "auto" | ChartRendererKind;
+/** Scale of an axis */
+export type ChartAxisType = "linear" | "time" | "category";
+/** How a series is drawn */
+export type ChartSeriesType = "line" | "area" | "bar" | "scatter";
+/** X value of a datum: a number, a `Date` (time axis) or a category name */
+export type ChartXValue = number | Date | string;
+/** One datum written as an object */
+export interface ChartPointDatum {
+    /** X value; the datum index when omitted */
+    x?: ChartXValue;
+    /** Y value; `null` leaves a gap */
+    y: number | null;
+    /** Diameter of the dot in CSS pixels (scatter) */
+    size?: number;
+    /** Color of the dot (scatter); any CSS color */
+    color?: string;
+    /** Text drawn next to the dot (scatter with `showLabels`) and shown in the tooltip */
+    label?: string;
+}
+/** Column-oriented data: the fastest form for large data sets (typed arrays are used as is) */
+export interface ChartColumnData {
+    /** X values; the index when omitted */
+    x?: ArrayLike<number> | readonly ChartXValue[];
+    /** Y values (`NaN` / `null` leave a gap) */
+    y: ArrayLike<number> | readonly (number | null)[];
+    /** Per-point diameters in CSS pixels (scatter) */
+    size?: ArrayLike<number>;
+}
+/**
+ * Data of a series: y values only (`[3, 5, 2]`, typed arrays included),
+ * `[x, y]` tuples, objects or columns
+ */
+export type ChartSeriesData = ArrayLike<number> | readonly (number | null)[] | readonly (readonly [ChartXValue, number | null])[] | readonly ChartPointDatum[] | ChartColumnData;
+/** A data series */
+export interface ChartSeries {
+    /** Stable identifier (defaults to the index) */
+    id?: string;
+    /** Name shown in the legend and the tooltip */
+    name?: string;
+    /**
+     * How the series is drawn
+     * @default "line"
+     */
+    type?: ChartSeriesType;
+    /** Data points */
+    data: ChartSeriesData;
+    /** Series color (any CSS color, `var(--x)` included); the palette when omitted */
+    color?: string;
+    /**
+     * Line width in CSS pixels (line / area)
+     * @default 2
+     */
+    lineWidth?: number;
+    /**
+     * Dot diameter in CSS pixels (scatter)
+     * @default 8
+     */
+    pointSize?: number;
+    /** Fill opacity (area, scatter), 0-1 */
+    opacity?: number;
+    /** Bars with the same stack id are stacked */
+    stack?: string;
+    /** Hides the series (it stays in the legend) */
+    hidden?: boolean;
+    /** Draws the `label` of each point next to it (scatter) */
+    showLabels?: boolean;
+}
+/** Options of an axis */
+export interface ChartAxisOptions {
+    /**
+     * Scale of the axis: `linear` numbers, `time` timestamps / dates, `category` names
+     * @default "linear"
+     */
+    type?: ChartAxisType;
+    /** Lower bound; computed from the data when omitted */
+    min?: number;
+    /** Upper bound; computed from the data when omitted */
+    max?: number;
+    /** Axis title */
+    title?: string;
+    /** Category names (`category` axis); collected from the data when omitted */
+    categories?: readonly string[];
+    /** Formats a tick / tooltip value */
+    format?: (value: number) => string;
+    /**
+     * Approximate number of ticks
+     * @default 5 (y), computed from the width (x)
+     */
+    tickCount?: number;
+    /**
+     * Draws grid lines at the ticks
+     * @default true for y, false for x
+     */
+    grid?: boolean;
+    /**
+     * Shows the axis line, ticks and labels
+     * @default true
+     */
+    visible?: boolean;
+    /** Keeps zero inside the automatic range (always on for bars) */
+    zero?: boolean;
+    /** Reverses the direction of the axis */
+    reverse?: boolean;
+    /** Rounds the automatic range to tick values; on by default except for category axes */
+    nice?: boolean;
+}
+/** Position of an annotation label inside its area */
+export type ChartLabelPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right" | "center";
+/** Area annotation: a rectangle in data coordinates (omitted bounds extend to the plot edges) */
+export interface ChartRectAnnotation {
+    type: "rect";
+    x0?: number;
+    x1?: number;
+    y0?: number;
+    y1?: number;
+    /** Fill color (any CSS color) */
+    color?: string;
+    /** Fill opacity, 0-1 (default 0.08) */
+    opacity?: number;
+    /** Text drawn inside the area */
+    label?: string;
+    /** Where the label goes (default `top-left`) */
+    labelPosition?: ChartLabelPosition;
+    /** Label color (defaults to `color`) */
+    labelColor?: string;
+}
+/** Reference line annotation at a value of the x or y axis */
+export interface ChartLineAnnotation {
+    type: "line";
+    axis: "x" | "y";
+    value: number;
+    /** Line color (any CSS color) */
+    color?: string;
+    /** Line width in CSS pixels (default 1) */
+    width?: number;
+    /** Dash pattern, e.g. `[4, 4]` */
+    dash?: readonly number[];
+    /** Text drawn at the end of the line */
+    label?: string;
+}
+/** Text placed at a data position (omitted coordinates center it on the plot) */
+export interface ChartTextAnnotation {
+    type: "text";
+    x?: number;
+    y?: number;
+    text: string;
+    /**
+     * Side of the text that touches the position: `top` hangs the text below
+     * it, `left` starts it there, ...; the text always stays inside the plot
+     * @default "center"
+     */
+    anchor?: "center" | "top" | "bottom" | "left" | "right";
+    /** Text color (defaults to the secondary text color) */
+    color?: string;
+    /**
+     * Font weight
+     * @default 500
+     */
+    weight?: number;
+}
+/** Background area, reference line or text */
+export type ChartAnnotation = ChartRectAnnotation | ChartLineAnnotation | ChartTextAnnotation;
+/** Zoom / pan / keyboard options */
+export interface ChartInteractionOptions {
+    /**
+     * Axes that zoom and pan; `true` = x for line / area / bar charts, both for scatter charts
+     * @default true
+     */
+    zoom?: boolean | "x" | "y" | "xy";
+    /**
+     * Wheel zoom: only with Ctrl / ⌘ (and trackpad pinch) or always
+     * @default "modifier"
+     */
+    wheel?: "modifier" | "always";
+    /**
+     * Drag to pan (when zoomed)
+     * @default true
+     */
+    pan?: boolean;
+    /**
+     * Arrow keys move the highlight, +/- zoom, 0 resets, Esc clears
+     * @default true
+     */
+    keyboard?: boolean;
+    /**
+     * Scatter points can be dragged: `drag` events follow the pointer and a
+     * `drop` event ends the gesture (the data is not changed by the chart)
+     * @default false
+     */
+    dragPoints?: boolean;
+}
+/** Tooltip options */
+export interface ChartTooltipOptions {
+    /**
+     * `nearest` shows the closest point, `axis` all the series at the closest x
+     * @default "axis" ("nearest" when every series is a scatter)
+     */
+    mode?: "nearest" | "axis";
+    /** Renders the tooltip content (a string is set as text) */
+    render?: (event: ChartHoverEvent) => string | Node | null;
+}
+/** Legend options */
+export interface ChartLegendOptions {
+    /**
+     * Legend position
+     * @default "top"
+     */
+    position?: "top" | "bottom";
+    /**
+     * Clicking an item toggles its series
+     * @default true
+     */
+    toggle?: boolean;
+}
+/** Inner space around the plot area, in CSS pixels */
+export interface ChartPadding {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+/** Options of `createChart` */
+export interface ChartOptions {
+    /** Data series */
+    series: readonly ChartSeries[];
+    /** X axis */
+    xAxis?: ChartAxisOptions;
+    /** Y axis */
+    yAxis?: ChartAxisOptions;
+    /**
+     * Backend of the data layer
+     * @default "auto"
+     */
+    renderer?: ChartRendererPreference;
+    /** Legend; shown by default when there are several named series */
+    legend?: boolean | ChartLegendOptions;
+    /** Tooltip; `false` disables it */
+    tooltip?: boolean | ChartTooltipOptions;
+    /** Vertical guide line following the pointer (default on for `axis` tooltips) */
+    crosshair?: boolean;
+    /** Background areas and reference lines */
+    annotations?: readonly ChartAnnotation[];
+    /** Zoom / pan / keyboard; `false` makes the chart static */
+    interaction?: boolean | ChartInteractionOptions;
+    /** Space around the plot area */
+    padding?: ChartPadding;
+    /** Colors of the series without `color` (defaults to the `--chart-series-1..8` CSS variables, then the theme colors) */
+    palette?: readonly string[];
+    /** Accessible name of the chart */
+    ariaLabel?: string;
+}
+/** A point under the pointer */
+export interface ChartHoverItem {
+    seriesIndex: number;
+    seriesId: string;
+    seriesName: string;
+    /** Index of the point in the series data */
+    index: number;
+    x: number;
+    y: number;
+    /** Resolved color of the point */
+    color: string;
+    label?: string;
+}
+/** Hover / click payload */
+export interface ChartHoverEvent {
+    /** Points under the pointer (several in `axis` mode) */
+    items: ChartHoverItem[];
+    /** X value of the first item */
+    x: number;
+    /** Formatted x value */
+    xLabel: string;
+}
+/** Visible range of the axes */
+export interface ChartView {
+    x: [number, number];
+    y: [number, number];
+}
+/** Rectangle in CSS pixels, relative to the chart's container */
+export interface ChartRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** A dragged point (`drag` / `drop` events) */
+export interface ChartDragEvent {
+    /** The point being dragged */
+    item: ChartHoverItem;
+    /** Data coordinates under the pointer */
+    x: number;
+    y: number;
+}
+/** A click (or tap) on the plot area outside the points */
+export interface ChartPlotClickEvent {
+    /** Data coordinates of the click */
+    x: number;
+    y: number;
+}
+/** Events of a chart instance */
+export interface ChartEventMap {
+    hover: ChartHoverEvent | null;
+    click: ChartHoverEvent;
+    /** Click on the plot area where there is no point */
+    plotClick: ChartPlotClickEvent;
+    zoom: ChartView;
+    renderer: ChartRendererKind;
+    /** The plot area moved or was resized */
+    layout: ChartRect;
+    /** A point is dragged (`interaction.dragPoints`) */
+    drag: ChartDragEvent;
+    /** A dragged point was released */
+    drop: ChartDragEvent;
+}
+/** Chart created by `createChart` */
+export interface ChartInstance {
+    /** Replaces the options (unchanged data arrays are not processed again) */
+    setOptions(options: ChartOptions): void;
+    /** Measures the container again (a ResizeObserver does it automatically) */
+    resize(): void;
+    /** Shows the whole data range */
+    resetZoom(): void;
+    /** Visible range */
+    getView(): ChartView;
+    /** Sets the visible range */
+    setView(view: Partial<ChartView>): void;
+    /** Plot area in CSS pixels of the container (`null` before the first frame) */
+    getPlotRect(): ChartRect | null;
+    /** Data coordinates -> CSS pixels of the container (`null` before the first frame) */
+    toPixel(x: number, y: number): {
+        x: number;
+        y: number;
+    } | null;
+    /** CSS pixels of the container -> data coordinates (`null` before the first frame) */
+    fromPixel(x: number, y: number): {
+        x: number;
+        y: number;
+    } | null;
+    /** Backend in use, `null` until ready */
+    getRenderer(): ChartRendererKind | null;
+    /** Resolves with the backend once the first frame can be drawn (`null` when the browser has no canvas support) */
+    ready: Promise<ChartRendererKind | null>;
+    /** Reads the CSS variables again (theme changes on `<html>` / `<body>` are detected automatically) */
+    refreshTheme(): void;
+    /** Subscribes to an event; returns the unsubscribe function */
+    on<K extends keyof ChartEventMap>(type: K, listener: (event: ChartEventMap[K]) => void): () => void;
+    /** Removes the DOM and frees the GPU resources */
+    destroy(): void;
+}