minerva-design 1.2.0 → 1.4.0

package/dist/web-components/components/chart/shapes-extended.js

@@ -0,0 +1,156 @@
+import e from "../../_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/decorate.js";
+import { MinervaShapeChartElement as t } from "./shape-chart.js";
+import { property as n } from "lit/decorators.js";
+//#region src/components/chart/shapes-extended.ts
+var r = class extends t {
+	constructor(...e) {
+		super(...e), this.align = "justify", this.linkColor = "gradient", this.hideLabels = !1;
+	}
+	static {
+		this.tagName = "minerva-sankey-chart";
+	}
+	get defaultHeight() {
+		return 360;
+	}
+	engineOptions() {
+		let e = this.links ?? this.options?.links;
+		return e ? {
+			...this.options,
+			type: "sankey",
+			nodes: this.nodes ?? this.options?.nodes,
+			links: e,
+			align: this.align,
+			linkColor: this.linkColor,
+			labels: !this.hideLabels && this.options?.labels
+		} : null;
+	}
+};
+e([n({ attribute: !1 })], r.prototype, "nodes", void 0), e([n({ attribute: !1 })], r.prototype, "links", void 0), e([n()], r.prototype, "align", void 0), e([n({ attribute: "link-color" })], r.prototype, "linkColor", void 0), e([n({
+	type: Boolean,
+	attribute: "hide-labels"
+})], r.prototype, "hideLabels", void 0), e([n({ attribute: !1 })], r.prototype, "options", void 0);
+var i = class extends t {
+	constructor(...e) {
+		super(...e), this.innerRadius = .26, this.labels = "auto", this.noDrill = !1;
+	}
+	static {
+		this.tagName = "minerva-sunburst-chart";
+	}
+	get defaultHeight() {
+		return 360;
+	}
+	bindEngine(e) {
+		return [...super.bindEngine(e), e.on("drill", (e) => this.emit("minerva-drill", e))];
+	}
+	drill(e) {
+		this.instance?.drill(e);
+	}
+	engineOptions() {
+		let e = this.data ?? this.options?.data;
+		return e ? {
+			...this.options,
+			type: "sunburst",
+			data: e,
+			innerRadius: this.innerRadius,
+			labels: this.labels,
+			drill: !this.noDrill && this.options?.drill,
+			drillPath: this.drillPath ?? this.options?.drillPath
+		} : null;
+	}
+};
+e([n({ attribute: !1 })], i.prototype, "data", void 0), e([n({
+	type: Number,
+	attribute: "inner-radius"
+})], i.prototype, "innerRadius", void 0), e([n()], i.prototype, "labels", void 0), e([n({
+	type: Boolean,
+	attribute: "no-drill"
+})], i.prototype, "noDrill", void 0), e([n({ attribute: !1 })], i.prototype, "drillPath", void 0), e([n({ attribute: !1 })], i.prototype, "options", void 0);
+var a = class extends t {
+	constructor(...e) {
+		super(...e), this.innerRadius = .3, this.sweep = 270;
+	}
+	static {
+		this.tagName = "minerva-radial-bar-chart";
+	}
+	get defaultHeight() {
+		return 300;
+	}
+	engineOptions() {
+		let e = this.data ?? this.options?.data;
+		return e ? {
+			...this.options,
+			type: "radialBar",
+			data: e,
+			max: this.max ?? this.options?.max,
+			innerRadius: this.innerRadius,
+			sweep: this.sweep,
+			centerValue: this.centerValue ?? this.options?.centerValue,
+			centerLabel: this.centerLabel ?? this.options?.centerLabel
+		} : null;
+	}
+};
+e([n({ attribute: !1 })], a.prototype, "data", void 0), e([n({ type: Number })], a.prototype, "max", void 0), e([n({
+	type: Number,
+	attribute: "inner-radius"
+})], a.prototype, "innerRadius", void 0), e([n({ type: Number })], a.prototype, "sweep", void 0), e([n({ attribute: "center-value" })], a.prototype, "centerValue", void 0), e([n({ attribute: "center-label" })], a.prototype, "centerLabel", void 0), e([n({ attribute: !1 })], a.prototype, "options", void 0);
+var o = (e) => (e instanceof Date ? e : new Date(e)).getFullYear(), s = (e) => (e instanceof Date ? e : new Date(e)).getTime(), c = (e) => {
+	if (!Array.isArray(e)) return 1;
+	let [t, n] = e, r = o(t), i = o(n), a = (s(n) - s(t)) / 864e5 + 1;
+	return i > r && a > 371 ? i - r + 1 : 1;
+}, l = class extends t {
+	constructor(...e) {
+		super(...e), this.layout = "weeks", this.levels = 4;
+	}
+	static {
+		this.tagName = "minerva-calendar-heatmap";
+	}
+	get defaultHeight() {
+		if (this.layout === "months") return 560;
+		let e = this.options?.legend === !1 ? 0 : 34;
+		return c(this.range ?? this.options?.range) * 120 + e + 16;
+	}
+	engineOptions() {
+		let e = this.data ?? this.options?.data;
+		return e ? {
+			...this.options,
+			type: "calendarHeatmap",
+			data: e,
+			range: this.range ?? this.options?.range,
+			layout: this.layout,
+			locale: this.locale ?? this.options?.locale,
+			color: this.color ?? this.options?.color,
+			levels: this.levels
+		} : null;
+	}
+};
+e([n({ attribute: !1 })], l.prototype, "data", void 0), e([n({ attribute: !1 })], l.prototype, "range", void 0), e([n()], l.prototype, "layout", void 0), e([n()], l.prototype, "locale", void 0), e([n()], l.prototype, "color", void 0), e([n({ type: Number })], l.prototype, "levels", void 0), e([n({ attribute: !1 })], l.prototype, "options", void 0);
+var u = class extends t {
+	constructor(...e) {
+		super(...e), this.orientation = "horizontal";
+	}
+	static {
+		this.tagName = "minerva-bullet-chart";
+	}
+	get defaultHeight() {
+		if (this.orientation === "vertical") return 320;
+		let e = (this.data ?? this.options?.data ?? []).length;
+		return Math.max(96, e * 64 + 16) + (this.options?.legend ? 34 : 0);
+	}
+	engineOptions() {
+		let e = this.data ?? this.options?.data;
+		return e ? {
+			...this.options,
+			type: "bullet",
+			data: e,
+			orientation: this.orientation,
+			ranges: this.ranges ?? this.options?.ranges,
+			rangeLabels: this.rangeLabels ?? this.options?.rangeLabels,
+			targetColor: this.targetColor ?? this.options?.targetColor
+		} : null;
+	}
+};
+e([n({ attribute: !1 })], u.prototype, "data", void 0), e([n()], u.prototype, "orientation", void 0), e([n({ attribute: !1 })], u.prototype, "ranges", void 0), e([n({ attribute: !1 })], u.prototype, "rangeLabels", void 0), e([n({ attribute: "target-color" })], u.prototype, "targetColor", void 0), e([n({ attribute: !1 })], u.prototype, "options", void 0);
+//#endregion
+export { u as MinervaBulletChart, l as MinervaCalendarHeatmap, a as MinervaRadialBarChart, r as MinervaSankeyChart, i as MinervaSunburstChart };
+
+//# sourceMappingURL=shapes-extended.js.map

package/dist/web-components/components/chart/shapes-extended.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes-extended.js","names":["_decorate","__decorate","MinervaSankeyChart","MinervaShapeChartElement","_args","links","property","MinervaSunburstChart","_args2","chart","event","path","data","MinervaRadialBarChart","_args3","yearOf","date","timeOf","calendarStrips","range","start","end","y0","y1","days","MinervaCalendarHeatmap","_args4","legend","MinervaBulletChart","_args5","rows"],"sources":["../../../../../web-components/src/components/chart/shapes-extended.ts"],"sourcesContent":["import { property } from \"lit/decorators.js\";\nimport type {\n  BulletChartOptions,\n  BulletDatum,\n  CalendarDate,\n  CalendarDatum,\n  CalendarHeatmapOptions,\n  RadialBarChartOptions,\n  RadialBarDatum,\n  SankeyChartOptions,\n  SankeyLink,\n  SankeyNode,\n  ShapeChartInstance,\n  ShapeChartOptions,\n  SunburstChartOptions,\n  TreemapNode,\n} from \"minerva-design/charts/core\";\nimport { MinervaShapeChartElement } from \"./shape-chart\";\n\n/**\n * Sankey diagram of `minerva-design/charts/core` (the `<SankeyChart>` of\n * React): flows between nodes in columns, link thickness proportional to\n * the flow; hovering a node or a link highlights its flows.\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Sankey diagram of flows between nodes.\n * @tag minerva-sankey-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaSankeyChart extends MinervaShapeChartElement {\n  static override tagName = \"minerva-sankey-chart\";\n\n  /** Nodes `{ name, color, column }` in their initial order (nodes only named by a link are appended); property only */\n  @property({ attribute: false })\n  nodes?: readonly SankeyNode[];\n\n  /** Flows `{ source, target, value }` between the nodes (by name or index); property only */\n  @property({ attribute: false })\n  links?: readonly SankeyLink[];\n\n  /** Column of the nodes without a `column` */\n  @property()\n  align: \"justify\" | \"left\" | \"right\" | \"center\" = \"justify\";\n\n  /** Color of the links without `color` */\n  @property({ attribute: \"link-color\" })\n  linkColor: \"gradient\" | \"source\" | \"target\" | \"neutral\" = \"gradient\";\n\n  /** Hides the node labels */\n  @property({ type: Boolean, attribute: \"hide-labels\" })\n  hideLabels = false;\n\n  /** Other engine options (`SankeyChartOptions`: nodeWidth, nodePadding, iterations, palette, format...); property only */\n  @property({ attribute: false })\n  options?: Partial<Omit<SankeyChartOptions, \"type\">>;\n\n  protected override get defaultHeight(): string | number {\n    return 360;\n  }\n\n  protected engineOptions(): ShapeChartOptions | null {\n    const links = this.links ?? this.options?.links;\n    if (!links) return null;\n    return {\n      ...this.options,\n      type: \"sankey\",\n      nodes: this.nodes ?? this.options?.nodes,\n      links,\n      align: this.align,\n      linkColor: this.linkColor,\n      labels: this.hideLabels ? false : this.options?.labels,\n    };\n  }\n}\n\n/**\n * Sunburst chart of `minerva-design/charts/core` (the `<SunburstChart>` of\n * React): a hierarchy as concentric rings; clicking a parent zooms into\n * it, clicking the center goes back up.\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Sunburst of a hierarchy, with drill-down.\n * @tag minerva-sunburst-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n * @fires minerva-drill - A parent or the center was clicked (or `drill()` called); detail: { path }\n */\nexport class MinervaSunburstChart extends MinervaShapeChartElement {\n  static override tagName = \"minerva-sunburst-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  /** Radius of the center circle as a fraction of the outer radius */\n  @property({ type: Number, attribute: \"inner-radius\" })\n  innerRadius = 0.26;\n\n  /** Sector labels along the arc or the radius, whichever fits best (`auto`), or none */\n  @property()\n  labels: \"auto\" | \"tangential\" | \"radial\" | \"none\" = \"auto\";\n\n  /** Disables the drill-down (clicking a parent zooms into it by default) */\n  @property({ type: Boolean, attribute: \"no-drill\" })\n  noDrill = false;\n\n  /** Names from the root to the focused node (`[]`: the root); makes the drill-down controlled; property only */\n  @property({ attribute: false })\n  drillPath?: readonly string[];\n\n  /** Other engine options (`SunburstChartOptions`: levels, startAngle, padAngle, palette, format...); property only */\n  @property({ attribute: false })\n  options?: Partial<Omit<SunburstChartOptions, \"type\">>;\n\n  protected override get defaultHeight(): string | number {\n    return 360;\n  }\n\n  protected override bindEngine(chart: ShapeChartInstance): Array<() => void> {\n    return [\n      ...super.bindEngine(chart),\n      chart.on(\"drill\", (event) => this.emit(\"minerva-drill\", event)),\n    ];\n  }\n\n  /** Zooms into the node at `path` (names from the root, `[]`: the root) */\n  drill(path: readonly string[]): void {\n    this.instance?.drill(path);\n  }\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: \"sunburst\",\n      data,\n      innerRadius: this.innerRadius,\n      labels: this.labels,\n      drill: this.noDrill ? false : this.options?.drill,\n      drillPath: this.drillPath ?? this.options?.drillPath,\n    };\n  }\n}\n\n/**\n * Radial bar chart of `minerva-design/charts/core` (the `<RadialBarChart>`\n * of React): concentric progress rings (activity rings, KPI completion).\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Concentric progress rings with center texts.\n * @tag minerva-radial-bar-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaRadialBarChart extends MinervaShapeChartElement {\n  static override tagName = \"minerva-radial-bar-chart\";\n\n  /** Bars `{ name, value, max, color }`, from the outermost ring inward; property only */\n  @property({ attribute: false })\n  data?: readonly RadialBarDatum[];\n\n  /** Value of a full bar for the data without `max` (the largest value by default) */\n  @property({ type: Number })\n  max?: number;\n\n  /** Radius of the innermost ring's inner edge, as a fraction of the outer radius */\n  @property({ type: Number, attribute: \"inner-radius\" })\n  innerRadius = 0.3;\n\n  /** Angle of a full bar, degrees (360: full rings) */\n  @property({ type: Number })\n  sweep = 270;\n\n  /** Big text in the center (e.g. the overall completion) */\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 (`RadialBarChartOptions`: startAngle, gap, track, rounded, labels, palette...); property only */\n  @property({ attribute: false })\n  options?: Partial<Omit<RadialBarChartOptions, \"type\">>;\n\n  protected override get defaultHeight(): string | number {\n    return 300;\n  }\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: \"radialBar\",\n      data,\n      max: this.max ?? this.options?.max,\n      innerRadius: this.innerRadius,\n      sweep: this.sweep,\n      centerValue: this.centerValue ?? this.options?.centerValue,\n      centerLabel: this.centerLabel ?? this.options?.centerLabel,\n    };\n  }\n}\n\nconst yearOf = (date: CalendarDate) =>\n  (date instanceof Date ? date : new Date(date)).getFullYear();\nconst timeOf = (date: CalendarDate) =>\n  (date instanceof Date ? date : new Date(date)).getTime();\n\n/** Strips of a calendar heatmap: one per year when the range spans several years */\nconst calendarStrips = (range: CalendarHeatmapOptions[\"range\"]) => {\n  if (!Array.isArray(range)) return 1;\n  const [start, end] = range as readonly [CalendarDate, CalendarDate];\n  const y0 = yearOf(start);\n  const y1 = yearOf(end);\n  const days = (timeOf(end) - timeOf(start)) / 86_400_000 + 1;\n  return y1 > y0 && days > 371 ? y1 - y0 + 1 : 1;\n};\n\n/**\n * Calendar heatmap of `minerva-design/charts/core` (the `<CalendarHeatmap>`\n * of React): daily values on a calendar, contributions-style, as weeks or\n * as small monthly calendars.\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary Daily values on a calendar, contributions-style.\n * @tag minerva-calendar-heatmap\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaCalendarHeatmap extends MinervaShapeChartElement {\n  static override tagName = \"minerva-calendar-heatmap\";\n\n  /** Daily values `{ date, value }` (several entries of the same day add up); property only */\n  @property({ attribute: false })\n  data?: readonly CalendarDatum[];\n\n  /** 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 */\n  @property({ attribute: false })\n  range?: number | readonly [CalendarDate, CalendarDate];\n\n  /** `weeks`: a column per week and a row per weekday; `months`: a small calendar per month */\n  @property()\n  layout: \"weeks\" | \"months\" = \"weeks\";\n\n  /** BCP 47 locale of the month and weekday names, of the tooltip dates and of the first day of the week */\n  @property()\n  locale?: string;\n\n  /** Color of the highest level (lower levels are lighter); the first palette color by default */\n  @property()\n  color?: string;\n\n  /** Number of color levels above the empty days */\n  @property({ type: Number })\n  levels = 4;\n\n  /** Other engine options (`CalendarHeatmapOptions`: weekStart, colors, thresholds, gap, radius...); property only */\n  @property({ attribute: false })\n  options?: Partial<Omit<CalendarHeatmapOptions, \"type\">>;\n\n  protected override get defaultHeight(): string | number {\n    if (this.layout === \"months\") return 560;\n    const legend = this.options?.legend === false ? 0 : 34;\n    return (\n      calendarStrips(this.range ?? this.options?.range) * 120 + legend + 16\n    );\n  }\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: \"calendarHeatmap\",\n      data,\n      range: this.range ?? this.options?.range,\n      layout: this.layout,\n      locale: this.locale ?? this.options?.locale,\n      color: this.color ?? this.options?.color,\n      levels: this.levels,\n    };\n  }\n}\n\n/**\n * Bullet chart of `minerva-design/charts/core` (the `<BulletChart>` of\n * React): KPI bars against qualitative ranges and a target marker.\n *\n * Published as the optional entry `minerva-design/web-components/chart`.\n *\n * @summary KPI bars against qualitative ranges and a target.\n * @tag minerva-bullet-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaBulletChart extends MinervaShapeChartElement {\n  static override tagName = \"minerva-bullet-chart\";\n\n  /** Rows `{ name, value, target, ranges, max }` (columns when vertical); property only */\n  @property({ attribute: false })\n  data?: readonly BulletDatum[];\n\n  /** Horizontal rows or vertical columns */\n  @property()\n  orientation: \"horizontal\" | \"vertical\" = \"horizontal\";\n\n  /** Qualitative ranges of the rows without `ranges`: upper bounds, ascending; property only */\n  @property({ attribute: false })\n  ranges?: readonly number[];\n\n  /** Names of the qualitative ranges, lowest first (tooltip); property only */\n  @property({ attribute: false })\n  rangeLabels?: readonly string[];\n\n  /** Color of the target markers (the text color by default) */\n  @property({ attribute: \"target-color\" })\n  targetColor?: string;\n\n  /** Other engine options (`BulletChartOptions`: rangeColors, barSize, ticks, palette, format...); property only */\n  @property({ attribute: false })\n  options?: Partial<Omit<BulletChartOptions, \"type\">>;\n\n  protected override get defaultHeight(): string | number {\n    if (this.orientation === \"vertical\") return 320;\n    const rows = (this.data ?? this.options?.data ?? []).length;\n    return Math.max(96, rows * 64 + 16) + (this.options?.legend ? 34 : 0);\n  }\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: \"bullet\",\n      data,\n      orientation: this.orientation,\n      ranges: this.ranges ?? this.options?.ranges,\n      rangeLabels: this.rangeLabels ?? this.options?.rangeLabels,\n      targetColor: this.targetColor ?? this.options?.targetColor,\n    };\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"minerva-sankey-chart\": MinervaSankeyChart;\n    \"minerva-sunburst-chart\": MinervaSunburstChart;\n    \"minerva-radial-bar-chart\": MinervaRadialBarChart;\n    \"minerva-calendar-heatmap\": MinervaCalendarHeatmap;\n    \"minerva-bullet-chart\": MinervaBulletChart;\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,111 @@
+import { Bar3DSeries, Chart3DCameraState, Chart3DInstance, Chart3DOptions, Chart3DSeries, ChartRendererKind, Line3DSeries, Scatter3DSeries, Surface3DContourOptions, Surface3DSeries, Surface3DWireframeOptions } from '../../../charts/core.js';
+import { MinervaEngineElement } from '../chart/engine-element.js';
+/** Engine options other than the series (axes, camera, color scale, legend, tooltip...) */
+export type Chart3DBaseOptions = Partial<Omit<Chart3DOptions, "series">>;
+/**
+ * Base of the 3D chart elements (engine `createChart3D` of
+ * `minerva-design/charts/core`): forwards the engine events as `minerva-*`
+ * events and exposes the camera.
+ *
+ * @fires minerva-hover - The hovered point, cell or bar changed; detail: { seriesIndex, seriesName, type, index, x, y, z, value, color, label }, `null` when nothing is hovered
+ * @fires minerva-point-click - A point, cell or bar was clicked; detail: { seriesIndex, seriesName, type, index, x, y, z, value, color, label }
+ * @fires minerva-camera-change - The user rotated, zoomed, panned or reset the camera; detail: { azimuth, elevation, zoom, pan, projection }
+ * @fires minerva-renderer-change - The backend is ready (or fell back after a GPU loss); detail: { renderer }
+ */
+export declare abstract class MinervaChart3DElement<S extends Chart3DSeries> extends MinervaEngineElement<Chart3DOptions, Chart3DInstance> {
+    /** Height of the chart, the legend included: pixels or any CSS length */
+    height?: string | number;
+    /** Data series; replace the array (or a data array) to update the chart; property only */
+    series?: readonly S[];
+    /** Other engine options (`Chart3DOptions`: xAxis, yAxis, zAxis, camera, autoRotate, colorScale, colorBar, legend, tooltip, locale...); property only */
+    options?: Chart3DBaseOptions;
+    protected abstract typed(series: readonly S[]): Chart3DSeries[];
+    protected createEngine(container: HTMLElement, options: Chart3DOptions): Chart3DInstance;
+    protected engineOptions(): Chart3DOptions | null;
+    protected bindEngine(chart: Chart3DInstance): Array<() => void>;
+    /** Restores the camera of the options */
+    resetCamera(): void;
+    /** Current camera, `null` before the engine is created */
+    getCamera(): Chart3DCameraState | null;
+    /** Moves the camera */
+    setCamera(camera: Partial<Chart3DCameraState>): void;
+    /** Backend in use (`webgpu`, `webgl2`, `webgl`, `canvas2d`), `null` until ready */
+    getRenderer(): ChartRendererKind | null;
+}
+/**
+ * 3D scatter plot of `minerva-design/charts/core` (the `<Scatter3DChart>`
+ * of React): point clouds of up to millions of points on the GPU, colored
+ * per series, per point or through a color scale; orbit camera, hover
+ * picking and color bar.
+ *
+ * Published as the optional entry `minerva-design/web-components/chart-3d`.
+ *
+ * @summary GPU 3D point clouds with an orbit camera.
+ * @tag minerva-scatter-3d-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaScatter3DChart extends MinervaChart3DElement<Scatter3DSeries> {
+    static tagName: string;
+    protected typed(series: readonly Scatter3DSeries[]): Chart3DSeries[];
+}
+/**
+ * 3D polylines of `minerva-design/charts/core` (the `<Line3DChart>` of
+ * React): trajectories and paths, optionally colored along the line.
+ *
+ * Published as the optional entry `minerva-design/web-components/chart-3d`.
+ *
+ * @summary GPU 3D polylines (trajectories, paths).
+ * @tag minerva-line-3d-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaLine3DChart extends MinervaChart3DElement<Line3DSeries> {
+    static tagName: string;
+    protected typed(series: readonly Line3DSeries[]): Chart3DSeries[];
+}
+/**
+ * 3D surface `z = f(x, y)` of `minerva-design/charts/core` (the
+ * `<Surface3DChart>` of React) over a regular grid: lit, colored by a
+ * color map, with an optional wireframe, contour lines and transparency.
+ *
+ * Published as the optional entry `minerva-design/web-components/chart-3d`.
+ *
+ * @summary GPU 3D surface with wireframe and contour lines.
+ * @tag minerva-surface-3d-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaSurface3DChart extends MinervaChart3DElement<Surface3DSeries> {
+    static tagName: string;
+    /** Wireframe of the series that do not set one; property only */
+    wireframe?: boolean | Surface3DWireframeOptions;
+    /** Contour lines of the series that do not set them; property only */
+    contours?: boolean | Surface3DContourOptions;
+    protected typed(series: readonly Surface3DSeries[]): Chart3DSeries[];
+}
+/**
+ * 3D bars of `minerva-design/charts/core` (the `<Bar3DChart>` of React)
+ * over an x × y category grid, lit, stacked across series.
+ *
+ * Published as the optional entry `minerva-design/web-components/chart-3d`.
+ *
+ * @summary GPU 3D bars over a category grid.
+ * @tag minerva-bar-3d-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ */
+export declare class MinervaBar3DChart extends MinervaChart3DElement<Bar3DSeries> {
+    static tagName: string;
+    /** Width of the bars of the series that do not set one, as a fraction of a cell */
+    barWidth: number;
+    protected typed(series: readonly Bar3DSeries[]): Chart3DSeries[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "minerva-scatter-3d-chart": MinervaScatter3DChart;
+        "minerva-line-3d-chart": MinervaLine3DChart;
+        "minerva-surface-3d-chart": MinervaSurface3DChart;
+        "minerva-bar-3d-chart": MinervaBar3DChart;
+    }
+}

package/dist/web-components/components/chart-3d/chart-3d.js

@@ -0,0 +1,97 @@
+import e from "../../_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/decorate.js";
+import { MinervaEngineElement as t } from "../chart/engine-element.js";
+import { property as n } from "lit/decorators.js";
+import { createChart3D as r } from "../../../charts/core.js";
+//#region src/components/chart-3d/chart-3d.ts
+var i = class extends t {
+	constructor(...e) {
+		super(...e), this.height = 400;
+	}
+	createEngine(e, t) {
+		return r(e, t);
+	}
+	engineOptions() {
+		return this.series ? {
+			...this.options,
+			series: this.typed(this.series)
+		} : null;
+	}
+	bindEngine(e) {
+		return [
+			e.on("hover", (e) => this.emit("minerva-hover", e)),
+			e.on("click", (e) => this.emit("minerva-point-click", e)),
+			e.on("camera", (e) => this.emit("minerva-camera-change", e)),
+			e.on("renderer", (e) => this.emit("minerva-renderer-change", { renderer: e }))
+		];
+	}
+	resetCamera() {
+		this.instance?.resetCamera();
+	}
+	getCamera() {
+		return this.instance?.getCamera() ?? null;
+	}
+	setCamera(e) {
+		this.instance?.setCamera(e);
+	}
+	getRenderer() {
+		return this.instance?.getRenderer() ?? null;
+	}
+};
+e([n()], i.prototype, "height", void 0), e([n({ attribute: !1 })], i.prototype, "series", void 0), e([n({ attribute: !1 })], i.prototype, "options", void 0);
+var a = class extends i {
+	static {
+		this.tagName = "minerva-scatter-3d-chart";
+	}
+	typed(e) {
+		return e.map((e) => ({
+			...e,
+			type: "scatter"
+		}));
+	}
+}, o = class extends i {
+	static {
+		this.tagName = "minerva-line-3d-chart";
+	}
+	typed(e) {
+		return e.map((e) => ({
+			...e,
+			type: "line"
+		}));
+	}
+}, s = class extends i {
+	static {
+		this.tagName = "minerva-surface-3d-chart";
+	}
+	typed(e) {
+		return e.map((e) => ({
+			...e,
+			type: "surface",
+			wireframe: e.wireframe ?? this.wireframe,
+			contours: e.contours ?? this.contours
+		}));
+	}
+};
+e([n({ attribute: !1 })], s.prototype, "wireframe", void 0), e([n({ attribute: !1 })], s.prototype, "contours", void 0);
+var c = class extends i {
+	constructor(...e) {
+		super(...e), this.barWidth = .7;
+	}
+	static {
+		this.tagName = "minerva-bar-3d-chart";
+	}
+	typed(e) {
+		return e.map((e) => ({
+			...e,
+			type: "bar",
+			barWidth: e.barWidth ?? this.barWidth
+		}));
+	}
+};
+e([n({
+	type: Number,
+	attribute: "bar-width"
+})], c.prototype, "barWidth", void 0);
+//#endregion
+export { c as MinervaBar3DChart, i as MinervaChart3DElement, o as MinervaLine3DChart, a as MinervaScatter3DChart, s as MinervaSurface3DChart };
+
+//# sourceMappingURL=chart-3d.js.map

package/dist/web-components/components/chart-3d/chart-3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d.js","names":["_decorate","__decorate","MinervaChart3DElement","MinervaEngineElement","_args","createChart3D","container","options","chart","camera","property","MinervaScatter3DChart","series","s","MinervaLine3DChart","MinervaSurface3DChart","MinervaBar3DChart","_args2"],"sources":["../../../../../web-components/src/components/chart-3d/chart-3d.ts"],"sourcesContent":["import { property } from \"lit/decorators.js\";\nimport {\n  createChart3D,\n  type Bar3DSeries,\n  type Chart3DCameraState,\n  type Chart3DInstance,\n  type Chart3DOptions,\n  type Chart3DSeries,\n  type ChartRendererKind,\n  type Line3DSeries,\n  type Scatter3DSeries,\n  type Surface3DContourOptions,\n  type Surface3DSeries,\n  type Surface3DWireframeOptions,\n} from \"minerva-design/charts/core\";\nimport { MinervaEngineElement } from \"../chart/engine-element\";\n\n/** Engine options other than the series (axes, camera, color scale, legend, tooltip...) */\nexport type Chart3DBaseOptions = Partial<Omit<Chart3DOptions, \"series\">>;\n\n/**\n * Base of the 3D chart elements (engine `createChart3D` of\n * `minerva-design/charts/core`): forwards the engine events as `minerva-*`\n * events and exposes the camera.\n *\n * @fires minerva-hover - The hovered point, cell or bar changed; detail: { seriesIndex, seriesName, type, index, x, y, z, value, color, label }, `null` when nothing is hovered\n * @fires minerva-point-click - A point, cell or bar was clicked; detail: { seriesIndex, seriesName, type, index, x, y, z, value, color, label }\n * @fires minerva-camera-change - The user rotated, zoomed, panned or reset the camera; detail: { azimuth, elevation, zoom, pan, projection }\n * @fires minerva-renderer-change - The backend is ready (or fell back after a GPU loss); detail: { renderer }\n */\nexport abstract class MinervaChart3DElement<\n  S extends Chart3DSeries,\n> extends MinervaEngineElement<Chart3DOptions, Chart3DInstance> {\n  /** Height of the chart, the legend included: pixels or any CSS length */\n  @property()\n  override height?: string | number = 400;\n\n  /** Data series; replace the array (or a data array) to update the chart; property only */\n  @property({ attribute: false })\n  series?: readonly S[];\n\n  /** Other engine options (`Chart3DOptions`: xAxis, yAxis, zAxis, camera, autoRotate, colorScale, colorBar, legend, tooltip, locale...); property only */\n  @property({ attribute: false })\n  options?: Chart3DBaseOptions;\n\n  protected abstract typed(series: readonly S[]): Chart3DSeries[];\n\n  protected createEngine(\n    container: HTMLElement,\n    options: Chart3DOptions,\n  ): Chart3DInstance {\n    return createChart3D(container, options);\n  }\n\n  protected engineOptions(): Chart3DOptions | null {\n    if (!this.series) return null;\n    return { ...this.options, series: this.typed(this.series) };\n  }\n\n  protected override bindEngine(chart: Chart3DInstance): Array<() => void> {\n    return [\n      chart.on(\"hover\", (e) => this.emit(\"minerva-hover\", e)),\n      chart.on(\"click\", (e) => this.emit(\"minerva-point-click\", e)),\n      chart.on(\"camera\", (camera) =>\n        this.emit(\"minerva-camera-change\", camera),\n      ),\n      chart.on(\"renderer\", (renderer) =>\n        this.emit(\"minerva-renderer-change\", { renderer }),\n      ),\n    ];\n  }\n\n  /** Restores the camera of the options */\n  resetCamera(): void {\n    this.instance?.resetCamera();\n  }\n\n  /** Current camera, `null` before the engine is created */\n  getCamera(): Chart3DCameraState | null {\n    return this.instance?.getCamera() ?? null;\n  }\n\n  /** Moves the camera */\n  setCamera(camera: Partial<Chart3DCameraState>): void {\n    this.instance?.setCamera(camera);\n  }\n\n  /** Backend in use (`webgpu`, `webgl2`, `webgl`, `canvas2d`), `null` until ready */\n  getRenderer(): ChartRendererKind | null {\n    return this.instance?.getRenderer() ?? null;\n  }\n}\n\n/**\n * 3D scatter plot of `minerva-design/charts/core` (the `<Scatter3DChart>`\n * of React): point clouds of up to millions of points on the GPU, colored\n * per series, per point or through a color scale; orbit camera, hover\n * picking and color bar.\n *\n * Published as the optional entry `minerva-design/web-components/chart-3d`.\n *\n * @summary GPU 3D point clouds with an orbit camera.\n * @tag minerva-scatter-3d-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaScatter3DChart extends MinervaChart3DElement<Scatter3DSeries> {\n  static override tagName = \"minerva-scatter-3d-chart\";\n\n  protected typed(series: readonly Scatter3DSeries[]): Chart3DSeries[] {\n    return series.map((s) => ({ ...s, type: \"scatter\" as const }));\n  }\n}\n\n/**\n * 3D polylines of `minerva-design/charts/core` (the `<Line3DChart>` of\n * React): trajectories and paths, optionally colored along the line.\n *\n * Published as the optional entry `minerva-design/web-components/chart-3d`.\n *\n * @summary GPU 3D polylines (trajectories, paths).\n * @tag minerva-line-3d-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaLine3DChart extends MinervaChart3DElement<Line3DSeries> {\n  static override tagName = \"minerva-line-3d-chart\";\n\n  protected typed(series: readonly Line3DSeries[]): Chart3DSeries[] {\n    return series.map((s) => ({ ...s, type: \"line\" as const }));\n  }\n}\n\n/**\n * 3D surface `z = f(x, y)` of `minerva-design/charts/core` (the\n * `<Surface3DChart>` of React) over a regular grid: lit, colored by a\n * color map, with an optional wireframe, contour lines and transparency.\n *\n * Published as the optional entry `minerva-design/web-components/chart-3d`.\n *\n * @summary GPU 3D surface with wireframe and contour lines.\n * @tag minerva-surface-3d-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaSurface3DChart extends MinervaChart3DElement<Surface3DSeries> {\n  static override tagName = \"minerva-surface-3d-chart\";\n\n  /** Wireframe of the series that do not set one; property only */\n  @property({ attribute: false })\n  wireframe?: boolean | Surface3DWireframeOptions;\n\n  /** Contour lines of the series that do not set them; property only */\n  @property({ attribute: false })\n  contours?: boolean | Surface3DContourOptions;\n\n  protected typed(series: readonly Surface3DSeries[]): Chart3DSeries[] {\n    return series.map((s) => ({\n      ...s,\n      type: \"surface\" as const,\n      wireframe: s.wireframe ?? this.wireframe,\n      contours: s.contours ?? this.contours,\n    }));\n  }\n}\n\n/**\n * 3D bars of `minerva-design/charts/core` (the `<Bar3DChart>` of React)\n * over an x × y category grid, lit, stacked across series.\n *\n * Published as the optional entry `minerva-design/web-components/chart-3d`.\n *\n * @summary GPU 3D bars over a category grid.\n * @tag minerva-bar-3d-chart\n * @csspart root - The sized box of the chart\n * @csspart surface - The element the engine renders into\n */\nexport class MinervaBar3DChart extends MinervaChart3DElement<Bar3DSeries> {\n  static override tagName = \"minerva-bar-3d-chart\";\n\n  /** Width of the bars of the series that do not set one, as a fraction of a cell */\n  @property({ type: Number, attribute: \"bar-width\" })\n  barWidth = 0.7;\n\n  protected typed(series: readonly Bar3DSeries[]): Chart3DSeries[] {\n    return series.map((s) => ({\n      ...s,\n      type: \"bar\" as const,\n      barWidth: s.barWidth ?? this.barWidth,\n    }));\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"minerva-scatter-3d-chart\": MinervaScatter3DChart;\n    \"minerva-line-3d-chart\": MinervaLine3DChart;\n    \"minerva-surface-3d-chart\": MinervaSurface3DChart;\n    \"minerva-bar-3d-chart\": MinervaBar3DChart;\n  }\n}\n"],"mappings":";;;;;AA8BA,IAAsBE,IAAtB,cAEUC,EAAsD;;EAG1B,aAAA,KAAA,SAAA;;CAYpC,aACE,GACA,GACiB;EACjB,OAAOE,EAAcC,GAAWC,CAAO;CACzC;CAEA,gBAAiD;EAE/C,OADK,KAAK,SACH;GAAE,GAAG,KAAK;GAAS,QAAQ,KAAK,MAAM,KAAK,MAAM;EAAE,IADjC;CAE3B;CAEA,WAA8B,GAA2C;EACvE,OAAO;GACLC,EAAM,GAAG,UAAU,MAAM,KAAK,KAAK,iBAAiB,CAAC,CAAC;GACtDA,EAAM,GAAG,UAAU,MAAM,KAAK,KAAK,uBAAuB,CAAC,CAAC;GAC5DA,EAAM,GAAG,WAAW,MAClB,KAAK,KAAK,yBAAyBC,CAAM,CAC3C;GACAD,EAAM,GAAG,aAAa,MACpB,KAAK,KAAK,2BAA2B,EAAE,YAAS,CAAC,CACnD;EACF;CACF;CAGA,cAAoB;EAClB,KAAK,UAAU,YAAY;CAC7B;CAGA,YAAuC;EACrC,OAAO,KAAK,UAAU,UAAU,KAAK;CACvC;CAGA,UAAU,GAA2C;EACnD,KAAK,UAAU,UAAUC,CAAM;CACjC;CAGA,cAAwC;EACtC,OAAO,KAAK,UAAU,YAAY,KAAK;CACzC;AACF;AAzDGT,EAAA,CAAAU,EAAS,CAAA,GAAAR,EAAA,WAAA,UAAA,KAAA,CAAA,GAITF,EAAA,CAAAU,EAAS,EAAE,WAAW,GAAM,CAAC,CAAA,GAAAR,EAAA,WAAA,UAAA,KAAA,CAAA,GAI7BF,EAAA,CAAAU,EAAS,EAAE,WAAW,GAAM,CAAC,CAAA,GAAAR,EAAA,WAAA,WAAA,KAAA,CAAA;AAgEhC,IAAaS,IAAb,cAA2CT,EAAuC;;EACtD,KAAA,UAAA;;CAE1B,MAAgB,GAAqD;EACnE,OAAOU,EAAO,KAAK,OAAO;GAAE,GAAGC;GAAG,MAAM;EAAmB,EAAE;CAC/D;AACF,GAaaC,IAAb,cAAwCZ,EAAoC;;EAChD,KAAA,UAAA;;CAE1B,MAAgB,GAAkD;EAChE,OAAOU,EAAO,KAAK,OAAO;GAAE,GAAGC;GAAG,MAAM;EAAgB,EAAE;CAC5D;AACF,GAcaE,IAAb,cAA2Cb,EAAuC;;EACtD,KAAA,UAAA;;CAU1B,MAAgB,GAAqD;EACnE,OAAOU,EAAO,KAAK,OAAO;GACxB,GAAGC;GACH,MAAM;GACN,WAAWA,EAAE,aAAa,KAAK;GAC/B,UAAUA,EAAE,YAAY,KAAK;EAC/B,EAAE;CACJ;AACF;AAfGb,EAAA,CAAAU,EAAS,EAAE,WAAW,GAAM,CAAC,CAAA,GAAAK,EAAA,WAAA,aAAA,KAAA,CAAA,GAI7Bf,EAAA,CAAAU,EAAS,EAAE,WAAW,GAAM,CAAC,CAAA,GAAAK,EAAA,WAAA,YAAA,KAAA,CAAA;AAwBhC,IAAaC,IAAb,cAAuCd,EAAmC;;EAK7D,aAAA,KAAA,WAAA;;;EAJe,KAAA,UAAA;;CAM1B,MAAgB,GAAiD;EAC/D,OAAOU,EAAO,KAAK,OAAO;GACxB,GAAGC;GACH,MAAM;GACN,UAAUA,EAAE,YAAY,KAAK;EAC/B,EAAE;CACJ;AACF;AAVGb,EAAA,CAAAU,EAAS;CAAE,MAAM;CAAQ,WAAW;AAAY,CAAC,CAAA,GAAAM,EAAA,WAAA,YAAA,KAAA,CAAA"}

package/dist/web-components/components/order-book/order-book.d.ts

@@ -0,0 +1,165 @@
+import { PropertyValues } from 'lit';
+import { ChartRendererKind, DepthChartInstance, DepthChartOptions, OrderBookDelta, OrderBookHeatmapInstance, OrderBookHeatmapOptions, OrderBookInstance, OrderBookOptions, OrderBookSnapshot, TimeAndSalesInstance, TimeAndSalesOptions } from '../../../charts/core.js';
+import { MinervaEngineElement, EngineInstance } from '../chart/engine-element.js';
+/** Trades of the tape and of the heatmap, oldest first */
+type Trades = Parameters<TimeAndSalesInstance["setTrades"]>[0];
+/** Engine of an order book widget: options plus a book streamed apart */
+interface BookEngine<O> extends EngineInstance<O> {
+    setBook(snapshot: OrderBookSnapshot): void;
+    applyDeltas(deltas: OrderBookDelta | readonly OrderBookDelta[]): void;
+}
+/**
+ * Base of the order book widgets: `options` go through `setOptions`, the
+ * `book` property through `setBook` (stream updates with `applyDeltas`).
+ */
+declare abstract class BookElement<O extends object, I extends BookEngine<O>> extends MinervaEngineElement<O, I> {
+    /** Book `{ bids, asks, time }` (levels `[price, size]`), applied when the object changes; stream updates through `applyDeltas`; property only */
+    book?: OrderBookSnapshot;
+    /** Engine options; property only */
+    abstract options?: O;
+    protected engineOptions(): O;
+    protected engineMounted(engine: I): void;
+    protected syncEngine(engine: I, changed: PropertyValues): void;
+    /** Replaces the book */
+    setBook(snapshot: OrderBookSnapshot): void;
+    /** Applies updates (size 0 removes a level); drawn once at the next frame */
+    applyDeltas(deltas: OrderBookDelta | readonly OrderBookDelta[]): void;
+}
+/**
+ * Cumulative depth of an order book (the `<DepthChart>` of React, engine
+ * `createDepthChart` of `minerva-design/charts/core`): stepped bid / ask
+ * areas around the mid price, mirrored hover readout, zoom around the mid,
+ * eased updates.
+ *
+ * Published as the optional entry `minerva-design/web-components/order-book`.
+ *
+ * @summary Cumulative bid / ask depth around the mid price.
+ * @tag minerva-depth-chart
+ * @csspart root - The sized box of the chart
+ * @csspart surface - The element the engine renders into
+ * @fires minerva-hover - The pointer moved over the curves; detail: { side, price, amount, total, average, distance, mirror }, `null` when it left
+ * @fires minerva-click - The curves were clicked or tapped; detail: { side, price, amount, total, average, distance, mirror }
+ * @fires minerva-range-change - The visible range changed by zooming; detail: { range } (fraction of the mid)
+ */
+export declare class MinervaDepthChart extends BookElement<DepthChartOptions, DepthChartInstance> {
+    static tagName: string;
+    /** Engine options (`DepthChartOptions`: range, curve, amount, priceLines, colorConvention, locale, labels...); property only */
+    options?: DepthChartOptions;
+    protected createEngine(container: HTMLElement, options: DepthChartOptions): DepthChartInstance;
+    protected bindEngine(chart: DepthChartInstance): Array<() => void>;
+    /** Sets the visible range (fraction of the mid); `null` fits the book */
+    setRange(range: number | null): void;
+}
+/**
+ * Order book ladder (the `<OrderBook>` of React, engine `createOrderBook`
+ * of `minerva-design/charts/core`): asks above the spread row, bids below,
+ * with depth bars, price grouping, change flashes and large order
+ * highlight.
+ *
+ * Published as the optional entry `minerva-design/web-components/order-book`.
+ *
+ * @summary Order book ladder with depth bars and flashes.
+ * @tag minerva-order-book
+ * @csspart root - The sized box of the ladder
+ * @csspart surface - The element the engine renders into
+ * @fires minerva-hover - A row is hovered; detail: { side, index, price, size, sum, notional, average }, `null` when the pointer left
+ * @fires minerva-level-click - A row was clicked, tapped or activated with Enter; detail: { side, index, price, size, sum, notional, average }
+ */
+export declare class MinervaOrderBook extends BookElement<OrderBookOptions, OrderBookInstance> {
+    static tagName: string;
+    /** Price of the spread row, colored by its last move (the mid price when unset) */
+    lastPrice?: number | null;
+    /** Engine options (`OrderBookOptions`: mode, grouping, rows, columns, depthBars, locale, labels...); property only */
+    options?: OrderBookOptions;
+    protected get defaultHeight(): string | number;
+    protected createEngine(container: HTMLElement, options: OrderBookOptions): OrderBookInstance;
+    protected bindEngine(book: OrderBookInstance): Array<() => void>;
+    protected engineMounted(engine: OrderBookInstance): void;
+    protected syncEngine(engine: OrderBookInstance, changed: PropertyValues): void;
+    /** Price of the spread row (the mid price when `null`) */
+    setLastPrice(price: number | null): void;
+}
+/**
+ * Liquidity heatmap (the `<OrderBookHeatmap>` of React, engine
+ * `createOrderBookHeatmap` of `minerva-design/charts/core`): resting size
+ * over time and price drawn by the GPU, best bid / ask lines and trades as
+ * bubbles sized by volume.
+ *
+ * Published as the optional entry `minerva-design/web-components/order-book`.
+ *
+ * @summary GPU liquidity heatmap of an order book over time.
+ * @tag minerva-order-book-heatmap
+ * @csspart root - The sized box of the heatmap
+ * @csspart surface - The element the engine renders into
+ * @fires minerva-hover - A cell is hovered; detail: { time, price, size, side, buyVolume, sellVolume }, `null` when the pointer left
+ * @fires minerva-renderer-change - The backend is ready (or fell back after a GPU loss); detail: { renderer }
+ * @fires minerva-follow-change - The view follows the market (`true`) or not after a zoom / pan (`false`); detail: { follow }
+ */
+export declare class MinervaOrderBookHeatmap extends BookElement<OrderBookHeatmapOptions, OrderBookHeatmapInstance> {
+    static tagName: string;
+    /** Trades `{ time, price, size, side }`; when the array grows, only the appended ones are added; property only */
+    trades?: Trades;
+    /** Engine options (`OrderBookHeatmapOptions`: tickSize, interval, window, colorScale, bubbles, locale, labels...); property only */
+    options?: OrderBookHeatmapOptions;
+    private feed;
+    protected get defaultHeight(): string | number;
+    protected createEngine(container: HTMLElement, options: OrderBookHeatmapOptions): OrderBookHeatmapInstance;
+    protected bindEngine(heatmap: OrderBookHeatmapInstance): Array<() => void>;
+    private feedTrades;
+    protected engineMounted(engine: OrderBookHeatmapInstance): void;
+    protected syncEngine(engine: OrderBookHeatmapInstance, changed: PropertyValues): void;
+    /** Adds trades (bubbles) */
+    addTrades(trades: Trades[number] | Trades): void;
+    /** Follows the market again (latest time, centered on the mid price) */
+    resetView(): void;
+    /** Backend in use (`webgpu`, `webgl2`, `webgl`, `canvas2d`), `null` until ready */
+    getRenderer(): ChartRendererKind | null;
+}
+/**
+ * Time and sales tape (the `<TimeAndSales>` of React, engine
+ * `createTimeAndSales` of `minerva-design/charts/core`): newest trades on
+ * top, virtualized (hundreds of thousands of rows), large trades
+ * highlighted, paused while hovered.
+ *
+ * Published as the optional entry `minerva-design/web-components/order-book`.
+ *
+ * @summary Virtualized tape of the latest trades.
+ * @tag minerva-time-and-sales
+ * @csspart root - The sized box of the tape
+ * @csspart surface - The element the engine renders into
+ * @fires minerva-hover - A row is hovered; detail: { trade, count, index }, `null` when the pointer left
+ * @fires minerva-trade-click - A row was clicked, tapped or activated with Enter; detail: { trade, count, index }
+ * @fires minerva-pause - The tape paused (pointer over it, scrolled down) or resumed; detail: { paused }
+ */
+export declare class MinervaTimeAndSales extends MinervaEngineElement<TimeAndSalesOptions, TimeAndSalesInstance> {
+    static tagName: string;
+    /** Trades `{ time, price, size, side }`, oldest first; when the array grows, only the appended ones are added (other changes replace the tape); property only */
+    trades?: Trades;
+    /** Engine options (`TimeAndSalesOptions`: columns, minSize, largeTradeThreshold, aggregate, locale, labels...); property only */
+    options?: TimeAndSalesOptions;
+    private feed;
+    protected get defaultHeight(): string | number;
+    protected createEngine(container: HTMLElement, options: TimeAndSalesOptions): TimeAndSalesInstance;
+    protected engineOptions(): TimeAndSalesOptions;
+    protected bindEngine(tape: TimeAndSalesInstance): Array<() => void>;
+    private feedTrades;
+    protected engineMounted(engine: TimeAndSalesInstance): void;
+    protected syncEngine(engine: TimeAndSalesInstance, changed: PropertyValues): void;
+    /** Appends trades (oldest first) */
+    addTrades(trades: Trades[number] | Trades): void;
+    /** Replaces every trade */
+    setTrades(trades: Trades): void;
+    /** Removes every trade */
+    clear(): void;
+    /** Scrolls back to the newest trade and resumes */
+    scrollToLatest(): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "minerva-depth-chart": MinervaDepthChart;
+        "minerva-order-book": MinervaOrderBook;
+        "minerva-order-book-heatmap": MinervaOrderBookHeatmap;
+        "minerva-time-and-sales": MinervaTimeAndSales;
+    }
+}
+export {};