minerva-design 1.2.0 → 1.4.0

package/dist/web-components/components/chart/shape-chart.d.ts

@@ -0,0 +1,199 @@
+import { FunnelChartOptions, GaugeBand, GaugeChartOptions, PieChartOptions, RadarChartOptions, RadarIndicator, RadarSeries, ShapeChartCommonOptions, ShapeChartInstance, ShapeChartOptions, ShapeDatum, TreemapChartOptions, TreemapNode } from '../../../charts/core.js';
+import { MinervaEngineElement } from './engine-element.js';
+/** Engine options shared by every shape chart (palette, legend, tooltip, format, hidden, animation...) */
+export type ShapeChartBaseOptions = ShapeChartCommonOptions;
+/**
+ * Base of the shape chart elements (engine `createShapeChart`): forwards
+ * the engine events as `minerva-*` events.
+ *
+ * @fires minerva-hover - The hovered (or keyboard-focused) mark changed; detail: { index, name, value, share }, `null` when nothing is hovered
+ * @fires minerva-click - A mark was clicked, tapped or activated with Enter; detail: { index, name, value, share }
+ * @fires minerva-toggle - A legend item was clicked (or `toggle()` called); detail: { index, hidden, hiddenIndexes }
+ */
+export declare abstract class MinervaShapeChartElement extends MinervaEngineElement<ShapeChartOptions, ShapeChartInstance> {
+    protected createEngine(container: HTMLElement, options: ShapeChartOptions): ShapeChartInstance;
+    protected bindEngine(chart: ShapeChartInstance): Array<() => void>;
+    /** Hides / shows a slice, stage, radar series or top-level treemap node by index */
+    toggle(index: number): void;
+}
+/**
+ * Pie, donut, radar, gauge, funnel, treemap, sankey, sunburst... chart of
+ * `minerva-design/charts/core`, chosen by the `type` of its engine options
+ * (`ShapeChartOptions`), set as the `options` property; replace the object
+ * to update the chart (it animates from the previous values).
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Any shape chart of the engine, configured by its options.
+ * @tag minerva-shape-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaShapeChart extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Engine options (`ShapeChartOptions` of minerva-design/charts/core, `type` included); property only */
+    options?: ShapeChartOptions;
+    protected get defaultHeight(): string | number;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+/**
+ * Pie chart of `minerva-design/charts/core` (the `<PieChart>` of React):
+ * slices with gaps, outside labels with leader lines, legend toggles; a
+ * donut with `inner-radius`, a Nightingale rose with `rose`.
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Pie chart (or donut, or rose) with labels and legend toggles.
+ * @tag minerva-pie-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaPieChart extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Slices `{ name, value, color }`; property only */
+    data?: readonly ShapeDatum[];
+    /** Inner radius as a fraction of the outer radius: 0 = pie, 0.6 = donut */
+    innerRadius: number;
+    /** Nightingale rose: the radius (instead of the angle) shows the value */
+    rose: boolean;
+    /** Slice labels: outside with leader lines, inside the slices, or none */
+    labels?: "outside" | "inside" | "none";
+    /** Big text in the hole of a donut (e.g. the total) */
+    centerValue?: string;
+    /** Small text under `center-value` */
+    centerLabel?: string;
+    /** Other engine options (`PieChartOptions`: palette, legend, startAngle, labelContent, format...); property only */
+    options?: Partial<Omit<PieChartOptions, "type">>;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+/**
+ * Donut chart of `minerva-design/charts/core` (the `<DonutChart>` of
+ * React): a pie chart with a hole (`inner-radius` 0.62 by default) and
+ * optional center texts.
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Donut chart with center texts and legend toggles.
+ * @tag minerva-donut-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaDonutChart extends MinervaPieChart {
+    static tagName: string;
+    /** Inner radius as a fraction of the outer radius */
+    innerRadius: number;
+}
+/**
+ * Radar (spider) chart of `minerva-design/charts/core` comparing series
+ * over several indicators (the `<RadarChart>` of React).
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Radar chart comparing series over several indicators.
+ * @tag minerva-radar-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaRadarChart extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Axes `{ name, max }`, clockwise from 12 o'clock; property only */
+    indicators?: readonly RadarIndicator[];
+    /** Polygons `{ name, values }`: one value per indicator; property only */
+    series?: readonly RadarSeries[];
+    /** Grid shape */
+    shape: "polygon" | "circle";
+    /** Number of grid rings */
+    levels: number;
+    /** Other engine options (`RadarChartOptions`: palette, legend, dots, format...); property only */
+    options?: Partial<Omit<RadarChartOptions, "type">>;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+/**
+ * Gauge (speedometer) of `minerva-design/charts/core` showing one value on
+ * an arc with colored bands (the `<GaugeChart>` of React).
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Gauge showing one value on an arc, with colored bands.
+ * @tag minerva-gauge-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaGaugeChart extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Value shown by the arc (clamped to min - max for the drawing) */
+    value: number;
+    /** Value at the start of the arc */
+    min: number;
+    /** Value at the end of the arc */
+    max: number;
+    /** Caption under the value */
+    label?: string;
+    /** Draws a needle in addition to the value arc */
+    needle: boolean;
+    /** Colored ranges `{ to, color, label }` of the track; property only */
+    bands?: readonly GaugeBand[];
+    /** Other engine options (`GaugeChartOptions`: sweep, thickness, color, ticks, format...); property only */
+    options?: Partial<Omit<GaugeChartOptions, "type">>;
+    protected get defaultHeight(): string | number;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+/**
+ * Funnel chart of `minerva-design/charts/core`: the stages of a process
+ * with conversion rates (the `<FunnelChart>` of React).
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Funnel of the stages of a process, with conversion rates.
+ * @tag minerva-funnel-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaFunnelChart extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Stages `{ name, value, color }`; property only */
+    data?: readonly ShapeDatum[];
+    /** Order of the stages (`none`: the data order) */
+    sort: "descending" | "ascending" | "none";
+    /** Shape of the stages: trapezoids narrowing to the next stage, or centered bars */
+    shape: "trapezoid" | "bar";
+    /** Hides the conversion rates from the previous stage */
+    hideConversion: boolean;
+    /** Other engine options (`FunnelChartOptions`: gap, palette, legend, format...); property only */
+    options?: Partial<Omit<FunnelChartOptions, "type">>;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+/**
+ * Treemap of `minerva-design/charts/core`: nested rectangles of areas
+ * proportional to the values (the `<TreemapChart>` of React).
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Treemap of nested rectangles sized by value.
+ * @tag minerva-treemap-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaTreemapChart extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Nodes `{ name, value, children }`: leaves carry a value, parents sum their children; property only */
+    data?: readonly TreemapNode[];
+    /** Gap between the cells, in pixels */
+    gap: number;
+    /** Hides the names of the parents above their children */
+    hideHeaders: boolean;
+    /** Other engine options (`TreemapChartOptions`: palette, tooltip, format...); property only */
+    options?: Partial<Omit<TreemapChartOptions, "type">>;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "minerva-shape-chart": MinervaShapeChart;
+        "minerva-pie-chart": MinervaPieChart;
+        "minerva-donut-chart": MinervaDonutChart;
+        "minerva-radar-chart": MinervaRadarChart;
+        "minerva-gauge-chart": MinervaGaugeChart;
+        "minerva-funnel-chart": MinervaFunnelChart;
+        "minerva-treemap-chart": MinervaTreemapChart;
+    }
+}

package/dist/web-components/components/chart/shape-chart.js

@@ -0,0 +1,161 @@
+import e from "../../_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/decorate.js";
+import { MinervaEngineElement as t } from "./engine-element.js";
+import { property as n } from "lit/decorators.js";
+import { createShapeChart as r } from "../../../charts/core.js";
+//#region src/components/chart/shape-chart.ts
+var i = class extends t {
+	createEngine(e, t) {
+		return r(e, t);
+	}
+	bindEngine(e) {
+		return [
+			e.on("hover", (e) => this.emit("minerva-hover", e)),
+			e.on("click", (e) => this.emit("minerva-click", e)),
+			e.on("toggle", (e) => this.emit("minerva-toggle", e))
+		];
+	}
+	toggle(e) {
+		this.instance?.toggle(e);
+	}
+}, a = class extends i {
+	static {
+		this.tagName = "minerva-shape-chart";
+	}
+	get defaultHeight() {
+		return this.options?.type === "gauge" ? 240 : 320;
+	}
+	engineOptions() {
+		return this.options ?? null;
+	}
+};
+e([n({ attribute: !1 })], a.prototype, "options", void 0);
+var o = class extends i {
+	constructor(...e) {
+		super(...e), this.innerRadius = 0, this.rose = !1;
+	}
+	static {
+		this.tagName = "minerva-pie-chart";
+	}
+	engineOptions() {
+		let e = this.data ?? this.options?.data;
+		return e ? {
+			...this.options,
+			type: "pie",
+			data: e,
+			innerRadius: this.innerRadius,
+			rose: this.rose || this.options?.rose,
+			labels: this.labels ?? this.options?.labels,
+			centerValue: this.centerValue ?? this.options?.centerValue,
+			centerLabel: this.centerLabel ?? this.options?.centerLabel
+		} : null;
+	}
+};
+e([n({ attribute: !1 })], o.prototype, "data", void 0), e([n({
+	type: Number,
+	attribute: "inner-radius"
+})], o.prototype, "innerRadius", void 0), e([n({ type: Boolean })], o.prototype, "rose", void 0), e([n()], o.prototype, "labels", void 0), e([n({ attribute: "center-value" })], o.prototype, "centerValue", void 0), e([n({ attribute: "center-label" })], o.prototype, "centerLabel", void 0), e([n({ attribute: !1 })], o.prototype, "options", void 0);
+var s = class extends o {
+	constructor(...e) {
+		super(...e), this.innerRadius = .62;
+	}
+	static {
+		this.tagName = "minerva-donut-chart";
+	}
+};
+e([n({
+	type: Number,
+	attribute: "inner-radius"
+})], s.prototype, "innerRadius", void 0);
+var c = class extends i {
+	constructor(...e) {
+		super(...e), this.shape = "polygon", this.levels = 4;
+	}
+	static {
+		this.tagName = "minerva-radar-chart";
+	}
+	engineOptions() {
+		let e = this.indicators ?? this.options?.indicators, t = this.series ?? this.options?.series;
+		return !e || !t ? null : {
+			...this.options,
+			type: "radar",
+			indicators: e,
+			series: t,
+			shape: this.shape,
+			levels: this.levels
+		};
+	}
+};
+e([n({ attribute: !1 })], c.prototype, "indicators", void 0), e([n({ attribute: !1 })], c.prototype, "series", void 0), e([n()], c.prototype, "shape", void 0), e([n({ type: Number })], c.prototype, "levels", void 0), e([n({ attribute: !1 })], c.prototype, "options", void 0);
+var l = class extends i {
+	constructor(...e) {
+		super(...e), this.value = 0, this.min = 0, this.max = 100, this.needle = !1;
+	}
+	static {
+		this.tagName = "minerva-gauge-chart";
+	}
+	get defaultHeight() {
+		return 240;
+	}
+	engineOptions() {
+		return {
+			...this.options,
+			type: "gauge",
+			value: this.value,
+			min: this.min,
+			max: this.max,
+			label: this.label ?? this.options?.label,
+			needle: this.needle || this.options?.needle,
+			bands: this.bands ?? this.options?.bands
+		};
+	}
+};
+e([n({ type: Number })], l.prototype, "value", void 0), e([n({ type: Number })], l.prototype, "min", void 0), e([n({ type: Number })], l.prototype, "max", void 0), e([n()], l.prototype, "label", void 0), e([n({ type: Boolean })], l.prototype, "needle", void 0), e([n({ attribute: !1 })], l.prototype, "bands", void 0), e([n({ attribute: !1 })], l.prototype, "options", void 0);
+var u = class extends i {
+	constructor(...e) {
+		super(...e), this.sort = "none", this.shape = "trapezoid", this.hideConversion = !1;
+	}
+	static {
+		this.tagName = "minerva-funnel-chart";
+	}
+	engineOptions() {
+		let e = this.data ?? this.options?.data;
+		return e ? {
+			...this.options,
+			type: "funnel",
+			data: e,
+			sort: this.sort,
+			shape: this.shape,
+			conversion: !this.hideConversion && this.options?.conversion
+		} : null;
+	}
+};
+e([n({ attribute: !1 })], u.prototype, "data", void 0), e([n()], u.prototype, "sort", void 0), e([n()], u.prototype, "shape", void 0), e([n({
+	type: Boolean,
+	attribute: "hide-conversion"
+})], u.prototype, "hideConversion", void 0), e([n({ attribute: !1 })], u.prototype, "options", void 0);
+var d = class extends i {
+	constructor(...e) {
+		super(...e), this.gap = 2, this.hideHeaders = !1;
+	}
+	static {
+		this.tagName = "minerva-treemap-chart";
+	}
+	engineOptions() {
+		let e = this.data ?? this.options?.data;
+		return e ? {
+			...this.options,
+			type: "treemap",
+			data: e,
+			gap: this.gap,
+			headers: !this.hideHeaders && this.options?.headers
+		} : null;
+	}
+};
+e([n({ attribute: !1 })], d.prototype, "data", void 0), e([n({ type: Number })], d.prototype, "gap", void 0), e([n({
+	type: Boolean,
+	attribute: "hide-headers"
+})], d.prototype, "hideHeaders", void 0), e([n({ attribute: !1 })], d.prototype, "options", void 0);
+//#endregion
+export { s as MinervaDonutChart, u as MinervaFunnelChart, l as MinervaGaugeChart, o as MinervaPieChart, c as MinervaRadarChart, a as MinervaShapeChart, i as MinervaShapeChartElement, d as MinervaTreemapChart };
+
+//# sourceMappingURL=shape-chart.js.map

package/dist/web-components/components/chart/shape-chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-chart.js","names":["_decorate","__decorate","MinervaShapeChartElement","MinervaEngineElement","createShapeChart","container","options","chart","event","index","MinervaShapeChart","property","MinervaPieChart","_args","data","MinervaDonutChart","_args2","MinervaRadarChart","_args3","indicators","series","MinervaGaugeChart","_args4","MinervaFunnelChart","_args5","MinervaTreemapChart","_args6"],"sources":["../../../../../web-components/src/components/chart/shape-chart.ts"],"sourcesContent":["import { property } from \"lit/decorators.js\";\nimport {\n  createShapeChart,\n  type FunnelChartOptions,\n  type GaugeBand,\n  type GaugeChartOptions,\n  type PieChartOptions,\n  type RadarChartOptions,\n  type RadarIndicator,\n  type RadarSeries,\n  type ShapeChartCommonOptions,\n  type ShapeChartInstance,\n  type ShapeChartOptions,\n  type ShapeDatum,\n  type TreemapChartOptions,\n  type TreemapNode,\n} from \"minerva-design/charts/core\";\nimport { MinervaEngineElement } from \"./engine-element\";\n\n/** Engine options shared by every shape chart (palette, legend, tooltip, format, hidden, animation...) */\nexport type ShapeChartBaseOptions = ShapeChartCommonOptions;\n\n/**\n * Base of the shape chart elements (engine `createShapeChart`): forwards\n * the engine events as `minerva-*` events.\n *\n * @fires minerva-hover - The hovered (or keyboard-focused) mark changed; detail: { index, name, value, share }, `null` when nothing is hovered\n * @fires minerva-click - A mark was clicked, tapped or activated with Enter; detail: { index, name, value, share }\n * @fires minerva-toggle - A legend item was clicked (or `toggle()` called); detail: { index, hidden, hiddenIndexes }\n */\nexport abstract class MinervaShapeChartElement extends MinervaEngineElement<\n  ShapeChartOptions,\n  ShapeChartInstance\n> {\n  protected createEngine(\n    container: HTMLElement,\n    options: ShapeChartOptions,\n  ): ShapeChartInstance {\n    return createShapeChart(container, options);\n  }\n\n  protected override bindEngine(chart: ShapeChartInstance): Array<() => void> {\n    return [\n      chart.on(\"hover\", (event) => this.emit(\"minerva-hover\", event)),\n      chart.on(\"click\", (event) => this.emit(\"minerva-click\", event)),\n      chart.on(\"toggle\", (event) => this.emit(\"minerva-toggle\", event)),\n    ];\n  }\n\n  /** Hides / shows a slice, stage, radar series or top-level treemap node by index */\n  toggle(index: number): void {\n    this.instance?.toggle(index);\n  }\n}\n\n/**\n * Pie, donut, radar, gauge, funnel, treemap, sankey, sunburst... chart of\n * `minerva-design/charts/core`, chosen by the `type` of its engine options\n * (`ShapeChartOptions`), set as the `options` property; replace the object\n * to update the chart (it animates from the previous values).\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Any shape chart of the engine, configured by its options.\n * @tag minerva-shape-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaShapeChart extends MinervaShapeChartElement {\n  static override tagName = \"minerva-shape-chart\";\n\n  /** Engine options (`ShapeChartOptions` of minerva-design/charts/core, `type` included); property only */\n  @property({ attribute: false })\n  options?: ShapeChartOptions;\n\n  protected override get defaultHeight(): string | number {\n    return this.options?.type === \"gauge\" ? 240 : 320;\n  }\n\n  protected engineOptions(): ShapeChartOptions | null {\n    return this.options ?? null;\n  }\n}\n\n/**\n * Pie chart of `minerva-design/charts/core` (the `<PieChart>` of React):\n * slices with gaps, outside labels with leader lines, legend toggles; a\n * donut with `inner-radius`, a Nightingale rose with `rose`.\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Pie chart (or donut, or rose) with labels and legend toggles.\n * @tag minerva-pie-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaPieChart extends MinervaShapeChartElement {\n  static override tagName = \"minerva-pie-chart\";\n\n  /** Slices `{ name, value, color }`; property only */\n  @property({ attribute: false })\n  data?: readonly ShapeDatum[];\n\n  /** Inner radius as a fraction of the outer radius: 0 = pie, 0.6 = donut */\n  @property({ type: Number, attribute: \"inner-radius\" })\n  innerRadius = 0;\n\n  /** Nightingale rose: the radius (instead of the angle) shows the value */\n  @property({ type: Boolean })\n  rose = false;\n\n  /** Slice labels: outside with leader lines, inside the slices, or none */\n  @property()\n  labels?: \"outside\" | \"inside\" | \"none\";\n\n  /** Big text in the hole of a donut (e.g. the total) */\n  @property({ attribute: \"center-value\" })\n  centerValue?: string;\n\n  /** Small text under `center-value` */\n  @property({ attribute: \"center-label\" })\n  centerLabel?: string;\n\n  /** Other engine options (`PieChartOptions`: palette, legend, startAngle, labelContent, format...); property only */\n  @property({ attribute: false })\n  options?: Partial<Omit<PieChartOptions, \"type\">>;\n\n  protected engineOptions(): ShapeChartOptions | null {\n    const data = this.data ?? this.options?.data;\n    if (!data) return null;\n    return {\n      ...this.options,\n      type: \"pie\",\n      data,\n      innerRadius: this.innerRadius,\n      rose: this.rose || this.options?.rose,\n      labels: this.labels ?? this.options?.labels,\n      centerValue: this.centerValue ?? this.options?.centerValue,\n      centerLabel: this.centerLabel ?? this.options?.centerLabel,\n    };\n  }\n}\n\n/**\n * Donut chart of `minerva-design/charts/core` (the `<DonutChart>` of\n * React): a pie chart with a hole (`inner-radius` 0.62 by default) and\n * optional center texts.\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Donut chart with center texts and legend toggles.\n * @tag minerva-donut-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaDonutChart extends MinervaPieChart {\n  static override tagName = \"minerva-donut-chart\";\n\n  /** Inner radius as a fraction of the outer radius */\n  @property({ type: Number, attribute: \"inner-radius\" })\n  override innerRadius = 0.62;\n}\n\n/**\n * Radar (spider) chart of `minerva-design/charts/core` comparing series\n * over several indicators (the `<RadarChart>` of React).\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Radar chart comparing series over several indicators.\n * @tag minerva-radar-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaRadarChart extends MinervaShapeChartElement {\n  static override tagName = \"minerva-radar-chart\";\n\n  /** Axes `{ name, max }`, clockwise from 12 o'clock; property only */\n  @property({ attribute: false })\n  indicators?: readonly RadarIndicator[];\n\n  /** Polygons `{ name, values }`: one value per indicator; property only */\n  @property({ attribute: false })\n  series?: readonly RadarSeries[];\n\n  /** Grid shape */\n  @property()\n  shape: \"polygon\" | \"circle\" = \"polygon\";\n\n  /** Number of grid rings */\n  @property({ type: Number })\n  levels = 4;\n\n  /** Other engine options (`RadarChartOptions`: palette, legend, dots, format...); property only */\n  @property({ attribute: false })\n  options?: Partial<Omit<RadarChartOptions, \"type\">>;\n\n  protected engineOptions(): ShapeChartOptions | null {\n    const indicators = this.indicators ?? this.options?.indicators;\n    const series = this.series ?? this.options?.series;\n    if (!indicators || !series) return null;\n    return {\n      ...this.options,\n      type: \"radar\",\n      indicators,\n      series,\n      shape: this.shape,\n      levels: this.levels,\n    };\n  }\n}\n\n/**\n * Gauge (speedometer) of `minerva-design/charts/core` showing one value on\n * an arc with colored bands (the `<GaugeChart>` of React).\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Gauge showing one value on an arc, with colored bands.\n * @tag minerva-gauge-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaGaugeChart extends MinervaShapeChartElement {\n  static override tagName = \"minerva-gauge-chart\";\n\n  /** Value shown by the arc (clamped to min - max for the drawing) */\n  @property({ type: Number })\n  value = 0;\n\n  /** Value at the start of the arc */\n  @property({ type: Number })\n  min = 0;\n\n  /** Value at the end of the arc */\n  @property({ type: Number })\n  max = 100;\n\n  /** Caption under the value */\n  @property()\n  label?: string;\n\n  /** Draws a needle in addition to the value arc */\n  @property({ type: Boolean })\n  needle = false;\n\n  /** Colored ranges `{ to, color, label }` of the track; property only */\n  @property({ attribute: false })\n  bands?: readonly GaugeBand[];\n\n  /** Other engine options (`GaugeChartOptions`: sweep, thickness, color, ticks, format...); property only */\n  @property({ attribute: false })\n  options?: Partial<Omit<GaugeChartOptions, \"type\">>;\n\n  protected override get defaultHeight(): string | number {\n    return 240;\n  }\n\n  protected engineOptions(): ShapeChartOptions | null {\n    return {\n      ...this.options,\n      type: \"gauge\",\n      value: this.value,\n      min: this.min,\n      max: this.max,\n      label: this.label ?? this.options?.label,\n      needle: this.needle || this.options?.needle,\n      bands: this.bands ?? this.options?.bands,\n    };\n  }\n}\n\n/**\n * Funnel chart of `minerva-design/charts/core`: the stages of a process\n * with conversion rates (the `<FunnelChart>` of React).\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Funnel of the stages of a process, with conversion rates.\n * @tag minerva-funnel-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaFunnelChart extends MinervaShapeChartElement {\n  static override tagName = \"minerva-funnel-chart\";\n\n  /** Stages `{ name, value, color }`; property only */\n  @property({ attribute: false })\n  data?: readonly ShapeDatum[];\n\n  /** Order of the stages (`none`: the data order) */\n  @property()\n  sort: \"descending\" | \"ascending\" | \"none\" = \"none\";\n\n  /** Shape of the stages: trapezoids narrowing to the next stage, or centered bars */\n  @property()\n  shape: \"trapezoid\" | \"bar\" = \"trapezoid\";\n\n  /** Hides the conversion rates from the previous stage */\n  @property({ type: Boolean, attribute: \"hide-conversion\" })\n  hideConversion = false;\n\n  /** Other engine options (`FunnelChartOptions`: gap, palette, legend, format...); property only */\n  @property({ attribute: false })\n  options?: Partial<Omit<FunnelChartOptions, \"type\">>;\n\n  protected engineOptions(): ShapeChartOptions | null {\n    const data = this.data ?? this.options?.data;\n    if (!data) return null;\n    return {\n      ...this.options,\n      type: \"funnel\",\n      data,\n      sort: this.sort,\n      shape: this.shape,\n      conversion: this.hideConversion ? false : this.options?.conversion,\n    };\n  }\n}\n\n/**\n * Treemap of `minerva-design/charts/core`: nested rectangles of areas\n * proportional to the values (the `<TreemapChart>` of React).\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Treemap of nested rectangles sized by value.\n * @tag minerva-treemap-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaTreemapChart extends MinervaShapeChartElement {\n  static override tagName = \"minerva-treemap-chart\";\n\n  /** Nodes `{ name, value, children }`: leaves carry a value, parents sum their children; property only */\n  @property({ attribute: false })\n  data?: readonly TreemapNode[];\n\n  /** Gap between the cells, in pixels */\n  @property({ type: Number })\n  gap = 2;\n\n  /** Hides the names of the parents above their children */\n  @property({ type: Boolean, attribute: \"hide-headers\" })\n  hideHeaders = false;\n\n  /** Other engine options (`TreemapChartOptions`: palette, tooltip, format...); property only */\n  @property({ attribute: false })\n  options?: Partial<Omit<TreemapChartOptions, \"type\">>;\n\n  protected engineOptions(): ShapeChartOptions | null {\n    const data = this.data ?? this.options?.data;\n    if (!data) return null;\n    return {\n      ...this.options,\n      type: \"treemap\",\n      data,\n      gap: this.gap,\n      headers: this.hideHeaders ? false : this.options?.headers,\n    };\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"minerva-shape-chart\": MinervaShapeChart;\n    \"minerva-pie-chart\": MinervaPieChart;\n    \"minerva-donut-chart\": MinervaDonutChart;\n    \"minerva-radar-chart\": MinervaRadarChart;\n    \"minerva-gauge-chart\": MinervaGaugeChart;\n    \"minerva-funnel-chart\": MinervaFunnelChart;\n    \"minerva-treemap-chart\": MinervaTreemapChart;\n  }\n}\n"],"mappings":"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"}

package/dist/web-components/components/chart/shapes-extended.d.ts

@@ -0,0 +1,162 @@
+import { BulletChartOptions, BulletDatum, CalendarDate, CalendarDatum, CalendarHeatmapOptions, RadialBarChartOptions, RadialBarDatum, SankeyChartOptions, SankeyLink, SankeyNode, ShapeChartInstance, ShapeChartOptions, SunburstChartOptions, TreemapNode } from '../../../charts/core.js';
+import { MinervaShapeChartElement } from './shape-chart.js';
+/**
+ * Sankey diagram of `minerva-design/charts/core` (the `<SankeyChart>` of
+ * React): flows between nodes in columns, link thickness proportional to
+ * the flow; hovering a node or a link highlights its flows.
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Sankey diagram of flows between nodes.
+ * @tag minerva-sankey-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaSankeyChart extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Nodes `{ name, color, column }` in their initial order (nodes only named by a link are appended); property only */
+    nodes?: readonly SankeyNode[];
+    /** Flows `{ source, target, value }` between the nodes (by name or index); property only */
+    links?: readonly SankeyLink[];
+    /** Column of the nodes without a `column` */
+    align: "justify" | "left" | "right" | "center";
+    /** Color of the links without `color` */
+    linkColor: "gradient" | "source" | "target" | "neutral";
+    /** Hides the node labels */
+    hideLabels: boolean;
+    /** Other engine options (`SankeyChartOptions`: nodeWidth, nodePadding, iterations, palette, format...); property only */
+    options?: Partial<Omit<SankeyChartOptions, "type">>;
+    protected get defaultHeight(): string | number;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+/**
+ * Sunburst chart of `minerva-design/charts/core` (the `<SunburstChart>` of
+ * React): a hierarchy as concentric rings; clicking a parent zooms into
+ * it, clicking the center goes back up.
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Sunburst of a hierarchy, with drill-down.
+ * @tag minerva-sunburst-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ * @fires minerva-drill - A parent or the center was clicked (or `drill()` called); detail: { path }
+ */
+export declare class MinervaSunburstChart extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Nodes `{ name, value, children }`: leaves carry a value, parents sum their children; property only */
+    data?: readonly TreemapNode[];
+    /** Radius of the center circle as a fraction of the outer radius */
+    innerRadius: number;
+    /** Sector labels along the arc or the radius, whichever fits best (`auto`), or none */
+    labels: "auto" | "tangential" | "radial" | "none";
+    /** Disables the drill-down (clicking a parent zooms into it by default) */
+    noDrill: boolean;
+    /** Names from the root to the focused node (`[]`: the root); makes the drill-down controlled; property only */
+    drillPath?: readonly string[];
+    /** Other engine options (`SunburstChartOptions`: levels, startAngle, padAngle, palette, format...); property only */
+    options?: Partial<Omit<SunburstChartOptions, "type">>;
+    protected get defaultHeight(): string | number;
+    protected bindEngine(chart: ShapeChartInstance): Array<() => void>;
+    /** Zooms into the node at `path` (names from the root, `[]`: the root) */
+    drill(path: readonly string[]): void;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+/**
+ * Radial bar chart of `minerva-design/charts/core` (the `<RadialBarChart>`
+ * of React): concentric progress rings (activity rings, KPI completion).
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Concentric progress rings with center texts.
+ * @tag minerva-radial-bar-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaRadialBarChart extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Bars `{ name, value, max, color }`, from the outermost ring inward; property only */
+    data?: readonly RadialBarDatum[];
+    /** Value of a full bar for the data without `max` (the largest value by default) */
+    max?: number;
+    /** Radius of the innermost ring's inner edge, as a fraction of the outer radius */
+    innerRadius: number;
+    /** Angle of a full bar, degrees (360: full rings) */
+    sweep: number;
+    /** Big text in the center (e.g. the overall completion) */
+    centerValue?: string;
+    /** Small text under `center-value` */
+    centerLabel?: string;
+    /** Other engine options (`RadialBarChartOptions`: startAngle, gap, track, rounded, labels, palette...); property only */
+    options?: Partial<Omit<RadialBarChartOptions, "type">>;
+    protected get defaultHeight(): string | number;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+/**
+ * Calendar heatmap of `minerva-design/charts/core` (the `<CalendarHeatmap>`
+ * of React): daily values on a calendar, contributions-style, as weeks or
+ * as small monthly calendars.
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary Daily values on a calendar, contributions-style.
+ * @tag minerva-calendar-heatmap
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaCalendarHeatmap extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Daily values `{ date, value }` (several entries of the same day add up); property only */
+    data?: readonly CalendarDatum[];
+    /** Days shown: a year (`2026`) or an inclusive `[start, end]` range; the 53 weeks ending on the last day of the data by default; property only */
+    range?: number | readonly [CalendarDate, CalendarDate];
+    /** `weeks`: a column per week and a row per weekday; `months`: a small calendar per month */
+    layout: "weeks" | "months";
+    /** BCP 47 locale of the month and weekday names, of the tooltip dates and of the first day of the week */
+    locale?: string;
+    /** Color of the highest level (lower levels are lighter); the first palette color by default */
+    color?: string;
+    /** Number of color levels above the empty days */
+    levels: number;
+    /** Other engine options (`CalendarHeatmapOptions`: weekStart, colors, thresholds, gap, radius...); property only */
+    options?: Partial<Omit<CalendarHeatmapOptions, "type">>;
+    protected get defaultHeight(): string | number;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+/**
+ * Bullet chart of `minerva-design/charts/core` (the `<BulletChart>` of
+ * React): KPI bars against qualitative ranges and a target marker.
+ *
+ * Published as the optional entry `minerva-design/web-components/chart`.
+ *
+ * @summary KPI bars against qualitative ranges and a target.
+ * @tag minerva-bullet-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaBulletChart extends MinervaShapeChartElement {
+    static tagName: string;
+    /** Rows `{ name, value, target, ranges, max }` (columns when vertical); property only */
+    data?: readonly BulletDatum[];
+    /** Horizontal rows or vertical columns */
+    orientation: "horizontal" | "vertical";
+    /** Qualitative ranges of the rows without `ranges`: upper bounds, ascending; property only */
+    ranges?: readonly number[];
+    /** Names of the qualitative ranges, lowest first (tooltip); property only */
+    rangeLabels?: readonly string[];
+    /** Color of the target markers (the text color by default) */
+    targetColor?: string;
+    /** Other engine options (`BulletChartOptions`: rangeColors, barSize, ticks, palette, format...); property only */
+    options?: Partial<Omit<BulletChartOptions, "type">>;
+    protected get defaultHeight(): string | number;
+    protected engineOptions(): ShapeChartOptions | null;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "minerva-sankey-chart": MinervaSankeyChart;
+        "minerva-sunburst-chart": MinervaSunburstChart;
+        "minerva-radial-bar-chart": MinervaRadialBarChart;
+        "minerva-calendar-heatmap": MinervaCalendarHeatmap;
+        "minerva-bullet-chart": MinervaBulletChart;
+    }
+}