minerva-design 1.2.0 → 1.4.0

package/dist/uni/shape-chart-types.d.ts

@@ -0,0 +1,381 @@
+import type { PropType } from "vue";
+import type { BulletDatum, CalendarDate, CalendarDatum, CanvasShapeChartInstance, ChartPadding, GaugeBand, RadarIndicator, RadarSeries, RadialBarDatum, SankeyLink, SankeyNode, ShapeChartOptions, ShapeDatum, ShapeLegendOptions, ShapeTooltipOptions, TreemapNode } from "./charts-canvas.js";
+export type { BulletDatum, CalendarDate, CalendarDatum, CanvasShapeChartInstance, GaugeBand, RadarIndicator, RadarSeries, RadialBarDatum, SankeyLink, SankeyNode, ShapeChartOptions, ShapeChartType, ShapeDatum, ShapeDrillEvent, ShapeHoverEvent, ShapeLegendOptions, ShapeToggleEvent, ShapeTooltipOptions, TreemapNode, } from "./charts-canvas.js";
+/** Imperative handle of the shape chart components (template `ref`) */
+export interface ShapeChartHandle {
+    /** The underlying canvas chart (`toggle`, `getHidden`, `clearHover`...), `null` until the canvas is ready */
+    getInstance(): CanvasShapeChartInstance | null;
+    /** Measures the canvas again (after a layout change the chart cannot see) */
+    resize(): void;
+}
+/** Size and scrolling of every shape chart */
+export declare const shapeFrameProps: {
+    /** Height of the chart (the legend included); numbers are pixels, strings any CSS length (rpx included) */
+    height: {
+        type: PropType<number | string>;
+        default: number;
+    };
+    /** Width of the chart; numbers are pixels */
+    width: {
+        type: PropType<number | string>;
+        default: string;
+    };
+    /** Keeps the page from scrolling while a finger moves on the chart */
+    disableScroll: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+};
+/** Props shared by PieChart, DonutChart, RadarChart, GaugeChart, FunnelChart and TreemapChart */
+export declare const shapeCommonProps: {
+    /** Colors of the marks without `color` (defaults to the `--chart-series-1..8` tokens) */
+    palette: PropType<readonly string[]>;
+    /** Legend; tapping an item hides / shows its slice, stage or series */
+    legend: {
+        type: PropType<boolean | ShapeLegendOptions>;
+        default: undefined;
+    };
+    /** Tooltip drawn on the canvas; `false` disables it (`render` may return a string) */
+    tooltip: {
+        type: PropType<boolean | ShapeTooltipOptions>;
+        default: undefined;
+    };
+    /** Formats the values of the labels and the tooltip (compact numbers by default) */
+    format: PropType<(value: number) => string>;
+    /** Formats the shares (0-1) of the labels and the tooltip (one decimal by default) */
+    percentFormat: PropType<(share: number) => string>;
+    /** Hidden entries by index (controlled: legend taps then only emit `toggle`) */
+    hidden: PropType<readonly number[]>;
+    /** Entry and update animations (default `true`) */
+    animation: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    /** Space around the drawing, in pixels (default 8 on every side) */
+    padding: PropType<ChartPadding>;
+    /** Accessible name of the chart (default: the chart type, e.g. "Donut chart") */
+    ariaLabel: StringConstructor;
+    /** Height of the chart (the legend included); numbers are pixels, strings any CSS length (rpx included) */
+    height: {
+        type: PropType<number | string>;
+        default: number;
+    };
+    /** Width of the chart; numbers are pixels */
+    width: {
+        type: PropType<number | string>;
+        default: string;
+    };
+    /** Keeps the page from scrolling while a finger moves on the chart */
+    disableScroll: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+};
+/** Props of PieChart / DonutChart (besides the common ones) */
+export declare const pieChartProps: {
+    /** Slices: a name, a value and an optional color */
+    readonly data: {
+        readonly type: PropType<readonly ShapeDatum[]>;
+        readonly required: true;
+    };
+    /** Inner radius as a fraction of the outer radius: 0 = pie (DonutChart: 0.62) */
+    readonly innerRadius: NumberConstructor;
+    /** Angle of the first slice, degrees clockwise from 12 o'clock */
+    readonly startAngle: NumberConstructor;
+    /** Gap between the slices, in pixels */
+    readonly padAngle: NumberConstructor;
+    /** Corner radius of the slices, in pixels */
+    readonly cornerRadius: NumberConstructor;
+    /** Nightingale rose: the radius shows the value */
+    readonly rose: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /** Slice labels: outside with leader lines, inside the slices, or none */
+    readonly labels: PropType<"outside" | "inside" | "none">;
+    /** What a label shows: name, value, percent */
+    readonly labelContent: PropType<readonly ("name" | "value" | "percent")[]>;
+    /** Big text in the hole of a donut */
+    readonly centerValue: StringConstructor;
+    /** Small text under `centerValue` */
+    readonly centerLabel: StringConstructor;
+};
+/** Props of RadarChart (besides the common ones) */
+export declare const radarChartProps: {
+    /** Axes of the chart, clockwise from 12 o'clock */
+    readonly indicators: {
+        readonly type: PropType<readonly RadarIndicator[]>;
+        readonly required: true;
+    };
+    /** Polygons: one value per indicator */
+    readonly series: {
+        readonly type: PropType<readonly RadarSeries[]>;
+        readonly required: true;
+    };
+    /** Grid shape (default "polygon") */
+    readonly shape: PropType<"polygon" | "circle">;
+    /** Number of grid rings (default 4) */
+    readonly levels: NumberConstructor;
+    /** Dots on the vertices (default `true`) */
+    readonly dots: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+};
+/** Props of GaugeChart (besides the common ones) */
+export declare const gaugeChartProps: {
+    /** Value shown by the arc */
+    readonly value: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Value at the start of the arc (default 0) */
+    readonly min: NumberConstructor;
+    /** Value at the end of the arc (default 100) */
+    readonly max: NumberConstructor;
+    /** Caption under the value */
+    readonly label: StringConstructor;
+    /** Total angle of the arc, degrees (default 240) */
+    readonly sweep: NumberConstructor;
+    /** Thickness of the arc as a fraction of the radius (default 0.16) */
+    readonly thickness: NumberConstructor;
+    /** Colored ranges of the track */
+    readonly bands: PropType<readonly GaugeBand[]>;
+    /** Color of the value arc (when there are no bands) */
+    readonly color: StringConstructor;
+    /** Draws a needle (default `false`) */
+    readonly needle: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /** Tick labels at the ends and at the band bounds (default `true`) */
+    readonly ticks: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+};
+/** Props of FunnelChart (besides the common ones) */
+export declare const funnelChartProps: {
+    /** Stages: a name, a value and an optional color */
+    readonly data: {
+        readonly type: PropType<readonly ShapeDatum[]>;
+        readonly required: true;
+    };
+    /** Order of the stages (default "none": data order) */
+    readonly sort: PropType<"descending" | "ascending" | "none">;
+    /** Vertical gap between the stages, in pixels (default 4) */
+    readonly gap: NumberConstructor;
+    /** Shows the conversion rate from the previous stage (default `true`) */
+    readonly conversion: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /** Trapezoids that narrow to the next stage, or centered bars */
+    readonly shape: PropType<"trapezoid" | "bar">;
+};
+/** Props of TreemapChart (besides the common ones) */
+export declare const treemapChartProps: {
+    /** Nodes: leaves carry a value, parents sum their children */
+    readonly data: {
+        readonly type: PropType<readonly TreemapNode[]>;
+        readonly required: true;
+    };
+    /** Gap between the cells, in pixels (default 2) */
+    readonly gap: NumberConstructor;
+    /** Draws the names of the parents above their children (default `true`) */
+    readonly headers: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+};
+/** Props of SankeyChart (besides the common ones) */
+export declare const sankeyChartProps: {
+    /** Nodes, in their initial order; nodes only named by a link are appended */
+    readonly nodes: PropType<readonly SankeyNode[]>;
+    /** Flows between the nodes (by name or index); links closing a cycle are ignored */
+    readonly links: {
+        readonly type: PropType<readonly SankeyLink[]>;
+        readonly required: true;
+    };
+    /** Width of the node bars, in pixels (default 12) */
+    readonly nodeWidth: NumberConstructor;
+    /** Vertical gap between the nodes of a column, in pixels (default 12) */
+    readonly nodePadding: NumberConstructor;
+    /** Column of the nodes without a `column` (default "justify") */
+    readonly align: PropType<"justify" | "left" | "right" | "center">;
+    /** Relaxation passes that straighten the flows (default 32) */
+    readonly iterations: NumberConstructor;
+    /** Color of the links without `color` (default "gradient") */
+    readonly linkColor: PropType<"gradient" | "source" | "target" | "neutral">;
+    /** Opacity of the links, 0-1 (default 0.4) */
+    readonly linkOpacity: NumberConstructor;
+    /** Node labels (default `true`) */
+    readonly labels: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /** Shows the value after the name in the labels (default `true`) */
+    readonly labelValues: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+};
+/** Props of SunburstChart (besides the common ones) */
+export declare const sunburstChartProps: {
+    /** Nodes: leaves carry a value, parents sum their children */
+    readonly data: {
+        readonly type: PropType<readonly TreemapNode[]>;
+        readonly required: true;
+    };
+    /** Radius of the center circle as a fraction of the outer radius (default 0.26) */
+    readonly innerRadius: NumberConstructor;
+    /** Rings shown at once below the focused node (default every level) */
+    readonly levels: NumberConstructor;
+    /** Angle of the first node, degrees clockwise from 12 o'clock (default 0) */
+    readonly startAngle: NumberConstructor;
+    /** Gap between the sectors, in pixels (default 1) */
+    readonly padAngle: NumberConstructor;
+    /** Corner radius of the sectors, in pixels (default 2) */
+    readonly cornerRadius: NumberConstructor;
+    /** Sector labels (default "auto") */
+    readonly labels: PropType<"auto" | "tangential" | "radial" | "none">;
+    /** Tapping a parent zooms into it, the center goes back up (default `true`) */
+    readonly drill: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /** Names from the root to the focused node; makes the drill-down controlled (listen to `drill`) */
+    readonly drillPath: PropType<readonly string[]>;
+};
+/** Props of RadialBarChart (besides the common ones) */
+export declare const radialBarChartProps: {
+    /** Bars, from the outermost ring inward: a name, a value, an optional `max` and color */
+    readonly data: {
+        readonly type: PropType<readonly RadialBarDatum[]>;
+        readonly required: true;
+    };
+    /** Value of a full bar for the data without `max` (default the largest value) */
+    readonly max: NumberConstructor;
+    /** Radius of the innermost ring's inner edge, as a fraction of the outer radius (default 0.3) */
+    readonly innerRadius: NumberConstructor;
+    /** Angle where the bars start, degrees clockwise from 12 o'clock (default 0) */
+    readonly startAngle: NumberConstructor;
+    /** Angle of a full bar, degrees (default 270) */
+    readonly sweep: NumberConstructor;
+    /** Gap between the rings, as a fraction of a ring's slot (default 0.28) */
+    readonly gap: NumberConstructor;
+    /** Background tracks behind the bars (default `true`) */
+    readonly track: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /** Rounded bar ends (default `true`) */
+    readonly rounded: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /** Labels before the start of the bars */
+    readonly labels: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /** What a label shows: name, value, percent (default ["name", "value"]) */
+    readonly labelContent: PropType<readonly ("name" | "value" | "percent")[]>;
+    /** Big text in the center */
+    readonly centerValue: StringConstructor;
+    /** Small text under `centerValue` */
+    readonly centerLabel: StringConstructor;
+};
+/** Props of CalendarHeatmap (besides the common ones) */
+export declare const calendarHeatmapProps: {
+    /** Daily values (several entries of the same day add up) */
+    readonly data: {
+        readonly type: PropType<readonly CalendarDatum[]>;
+        readonly required: true;
+    };
+    /** Days shown: a year (`2026`) or an inclusive `[start, end]` range */
+    readonly range: PropType<number | readonly [CalendarDate, CalendarDate]>;
+    /** `weeks` (default) or `months` */
+    readonly layout: PropType<"weeks" | "months">;
+    /** First day of the week, 0 = Sunday … 6 = Saturday (default from `locale`) */
+    readonly weekStart: NumberConstructor;
+    /** BCP 47 locale of the month and weekday names and of the tooltip dates */
+    readonly locale: StringConstructor;
+    /** Color of the highest level (default the first palette color) */
+    readonly color: StringConstructor;
+    /** Colors of the levels, lowest first */
+    readonly colors: PropType<readonly string[]>;
+    /** Number of color levels above the empty days (default 4) */
+    readonly levels: NumberConstructor;
+    /** Upper bounds of the levels but the last, ascending */
+    readonly thresholds: PropType<readonly number[]>;
+    /** Gap between the cells, in pixels (default 3) */
+    readonly gap: NumberConstructor;
+    /** Corner radius of the cells, in pixels (default 2) */
+    readonly radius: NumberConstructor;
+    /** Largest cell size, in pixels (default 16 weeks, 28 months) */
+    readonly maxCellSize: NumberConstructor;
+    /** Month names around the cells (default `true`) */
+    readonly monthLabels: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /** Weekday names beside or above the cells (default `true`) */
+    readonly weekdayLabels: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+};
+/** Props of BulletChart (besides the common ones) */
+export declare const bulletChartProps: {
+    /** Rows (columns when vertical): name, value, target, ranges and scale */
+    readonly data: {
+        readonly type: PropType<readonly BulletDatum[]>;
+        readonly required: true;
+    };
+    /** Horizontal rows (default) or vertical columns */
+    readonly orientation: PropType<"horizontal" | "vertical">;
+    /** Qualitative ranges of the rows without `ranges`: upper bounds, ascending */
+    readonly ranges: PropType<readonly number[]>;
+    /** Names of the qualitative ranges, lowest first (tooltip) */
+    readonly rangeLabels: PropType<readonly string[]>;
+    /** Colors of the qualitative ranges, lowest first */
+    readonly rangeColors: PropType<readonly string[]>;
+    /** Thickness of the value bar as a fraction of the ranges' thickness (default 0.4) */
+    readonly barSize: NumberConstructor;
+    /** Color of the target markers (default the text color) */
+    readonly targetColor: StringConstructor;
+    /** Tick labels of the scales (default `true`) */
+    readonly ticks: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+};
+/** Height computed from the type and the data when the `height` prop is omitted */
+export declare const autoHeightProp: {
+    /** Height of the chart; numbers are pixels, strings any CSS length (rpx included); computed from the type / data by default */
+    readonly height: {
+        readonly type: PropType<number | string>;
+        readonly default: undefined;
+    };
+};
+/** Props of ShapeChart (any shape type of the engine) */
+export declare const shapeChartProps: {
+    /** Options of the chart, by `type` (pie, radar, gauge, funnel, treemap...) */
+    readonly options: {
+        readonly type: PropType<ShapeChartOptions>;
+        readonly required: true;
+    };
+    readonly height: {
+        type: PropType<number | string>;
+        default: number;
+    };
+    readonly width: {
+        type: PropType<number | string>;
+        default: string;
+    };
+    readonly disableScroll: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+};

package/dist/uni/shape-chart-types.js

@@ -0,0 +1,261 @@
+// Booleans default to `undefined` (not Vue's `false`) so the engine
+// defaults apply when they are omitted.
+/** Size and scrolling of every shape chart */
+export const shapeFrameProps = {
+    /** Height of the chart (the legend included); numbers are pixels, strings any CSS length (rpx included) */
+    height: { type: [Number, String], default: 320 },
+    /** Width of the chart; numbers are pixels */
+    width: {
+        type: [Number, String],
+        default: "100%",
+    },
+    /** Keeps the page from scrolling while a finger moves on the chart */
+    disableScroll: { type: Boolean, default: undefined },
+};
+/** Props shared by PieChart, DonutChart, RadarChart, GaugeChart, FunnelChart and TreemapChart */
+export const shapeCommonProps = {
+    ...shapeFrameProps,
+    /** Colors of the marks without `color` (defaults to the `--chart-series-1..8` tokens) */
+    palette: Array,
+    /** Legend; tapping an item hides / shows its slice, stage or series */
+    legend: {
+        type: [Boolean, Object],
+        default: undefined,
+    },
+    /** Tooltip drawn on the canvas; `false` disables it (`render` may return a string) */
+    tooltip: {
+        type: [Boolean, Object],
+        default: undefined,
+    },
+    /** Formats the values of the labels and the tooltip (compact numbers by default) */
+    format: Function,
+    /** Formats the shares (0-1) of the labels and the tooltip (one decimal by default) */
+    percentFormat: Function,
+    /** Hidden entries by index (controlled: legend taps then only emit `toggle`) */
+    hidden: Array,
+    /** Entry and update animations (default `true`) */
+    animation: { type: Boolean, default: undefined },
+    /** Space around the drawing, in pixels (default 8 on every side) */
+    padding: Object,
+    /** Accessible name of the chart (default: the chart type, e.g. "Donut chart") */
+    ariaLabel: String,
+};
+/** Props of PieChart / DonutChart (besides the common ones) */
+export const pieChartProps = {
+    /** Slices: a name, a value and an optional color */
+    data: { type: Array, required: true },
+    /** Inner radius as a fraction of the outer radius: 0 = pie (DonutChart: 0.62) */
+    innerRadius: Number,
+    /** Angle of the first slice, degrees clockwise from 12 o'clock */
+    startAngle: Number,
+    /** Gap between the slices, in pixels */
+    padAngle: Number,
+    /** Corner radius of the slices, in pixels */
+    cornerRadius: Number,
+    /** Nightingale rose: the radius shows the value */
+    rose: { type: Boolean, default: undefined },
+    /** Slice labels: outside with leader lines, inside the slices, or none */
+    labels: String,
+    /** What a label shows: name, value, percent */
+    labelContent: Array,
+    /** Big text in the hole of a donut */
+    centerValue: String,
+    /** Small text under `centerValue` */
+    centerLabel: String,
+};
+/** Props of RadarChart (besides the common ones) */
+export const radarChartProps = {
+    /** Axes of the chart, clockwise from 12 o'clock */
+    indicators: {
+        type: Array,
+        required: true,
+    },
+    /** Polygons: one value per indicator */
+    series: { type: Array, required: true },
+    /** Grid shape (default "polygon") */
+    shape: String,
+    /** Number of grid rings (default 4) */
+    levels: Number,
+    /** Dots on the vertices (default `true`) */
+    dots: { type: Boolean, default: undefined },
+};
+/** Props of GaugeChart (besides the common ones) */
+export const gaugeChartProps = {
+    /** Value shown by the arc */
+    value: { type: Number, required: true },
+    /** Value at the start of the arc (default 0) */
+    min: Number,
+    /** Value at the end of the arc (default 100) */
+    max: Number,
+    /** Caption under the value */
+    label: String,
+    /** Total angle of the arc, degrees (default 240) */
+    sweep: Number,
+    /** Thickness of the arc as a fraction of the radius (default 0.16) */
+    thickness: Number,
+    /** Colored ranges of the track */
+    bands: Array,
+    /** Color of the value arc (when there are no bands) */
+    color: String,
+    /** Draws a needle (default `false`) */
+    needle: { type: Boolean, default: undefined },
+    /** Tick labels at the ends and at the band bounds (default `true`) */
+    ticks: { type: Boolean, default: undefined },
+};
+/** Props of FunnelChart (besides the common ones) */
+export const funnelChartProps = {
+    /** Stages: a name, a value and an optional color */
+    data: { type: Array, required: true },
+    /** Order of the stages (default "none": data order) */
+    sort: String,
+    /** Vertical gap between the stages, in pixels (default 4) */
+    gap: Number,
+    /** Shows the conversion rate from the previous stage (default `true`) */
+    conversion: { type: Boolean, default: undefined },
+    /** Trapezoids that narrow to the next stage, or centered bars */
+    shape: String,
+};
+/** Props of TreemapChart (besides the common ones) */
+export const treemapChartProps = {
+    /** Nodes: leaves carry a value, parents sum their children */
+    data: { type: Array, required: true },
+    /** Gap between the cells, in pixels (default 2) */
+    gap: Number,
+    /** Draws the names of the parents above their children (default `true`) */
+    headers: { type: Boolean, default: undefined },
+};
+/** Props of SankeyChart (besides the common ones) */
+export const sankeyChartProps = {
+    /** Nodes, in their initial order; nodes only named by a link are appended */
+    nodes: Array,
+    /** Flows between the nodes (by name or index); links closing a cycle are ignored */
+    links: { type: Array, required: true },
+    /** Width of the node bars, in pixels (default 12) */
+    nodeWidth: Number,
+    /** Vertical gap between the nodes of a column, in pixels (default 12) */
+    nodePadding: Number,
+    /** Column of the nodes without a `column` (default "justify") */
+    align: String,
+    /** Relaxation passes that straighten the flows (default 32) */
+    iterations: Number,
+    /** Color of the links without `color` (default "gradient") */
+    linkColor: String,
+    /** Opacity of the links, 0-1 (default 0.4) */
+    linkOpacity: Number,
+    /** Node labels (default `true`) */
+    labels: { type: Boolean, default: undefined },
+    /** Shows the value after the name in the labels (default `true`) */
+    labelValues: { type: Boolean, default: undefined },
+};
+/** Props of SunburstChart (besides the common ones) */
+export const sunburstChartProps = {
+    /** Nodes: leaves carry a value, parents sum their children */
+    data: { type: Array, required: true },
+    /** Radius of the center circle as a fraction of the outer radius (default 0.26) */
+    innerRadius: Number,
+    /** Rings shown at once below the focused node (default every level) */
+    levels: Number,
+    /** Angle of the first node, degrees clockwise from 12 o'clock (default 0) */
+    startAngle: Number,
+    /** Gap between the sectors, in pixels (default 1) */
+    padAngle: Number,
+    /** Corner radius of the sectors, in pixels (default 2) */
+    cornerRadius: Number,
+    /** Sector labels (default "auto") */
+    labels: String,
+    /** Tapping a parent zooms into it, the center goes back up (default `true`) */
+    drill: { type: Boolean, default: undefined },
+    /** Names from the root to the focused node; makes the drill-down controlled (listen to `drill`) */
+    drillPath: Array,
+};
+/** Props of RadialBarChart (besides the common ones) */
+export const radialBarChartProps = {
+    /** Bars, from the outermost ring inward: a name, a value, an optional `max` and color */
+    data: { type: Array, required: true },
+    /** Value of a full bar for the data without `max` (default the largest value) */
+    max: Number,
+    /** Radius of the innermost ring's inner edge, as a fraction of the outer radius (default 0.3) */
+    innerRadius: Number,
+    /** Angle where the bars start, degrees clockwise from 12 o'clock (default 0) */
+    startAngle: Number,
+    /** Angle of a full bar, degrees (default 270) */
+    sweep: Number,
+    /** Gap between the rings, as a fraction of a ring's slot (default 0.28) */
+    gap: Number,
+    /** Background tracks behind the bars (default `true`) */
+    track: { type: Boolean, default: undefined },
+    /** Rounded bar ends (default `true`) */
+    rounded: { type: Boolean, default: undefined },
+    /** Labels before the start of the bars */
+    labels: { type: Boolean, default: undefined },
+    /** What a label shows: name, value, percent (default ["name", "value"]) */
+    labelContent: Array,
+    /** Big text in the center */
+    centerValue: String,
+    /** Small text under `centerValue` */
+    centerLabel: String,
+};
+/** Props of CalendarHeatmap (besides the common ones) */
+export const calendarHeatmapProps = {
+    /** Daily values (several entries of the same day add up) */
+    data: { type: Array, required: true },
+    /** Days shown: a year (`2026`) or an inclusive `[start, end]` range */
+    range: [Number, Array],
+    /** `weeks` (default) or `months` */
+    layout: String,
+    /** First day of the week, 0 = Sunday … 6 = Saturday (default from `locale`) */
+    weekStart: Number,
+    /** BCP 47 locale of the month and weekday names and of the tooltip dates */
+    locale: String,
+    /** Color of the highest level (default the first palette color) */
+    color: String,
+    /** Colors of the levels, lowest first */
+    colors: Array,
+    /** Number of color levels above the empty days (default 4) */
+    levels: Number,
+    /** Upper bounds of the levels but the last, ascending */
+    thresholds: Array,
+    /** Gap between the cells, in pixels (default 3) */
+    gap: Number,
+    /** Corner radius of the cells, in pixels (default 2) */
+    radius: Number,
+    /** Largest cell size, in pixels (default 16 weeks, 28 months) */
+    maxCellSize: Number,
+    /** Month names around the cells (default `true`) */
+    monthLabels: { type: Boolean, default: undefined },
+    /** Weekday names beside or above the cells (default `true`) */
+    weekdayLabels: { type: Boolean, default: undefined },
+};
+/** Props of BulletChart (besides the common ones) */
+export const bulletChartProps = {
+    /** Rows (columns when vertical): name, value, target, ranges and scale */
+    data: { type: Array, required: true },
+    /** Horizontal rows (default) or vertical columns */
+    orientation: String,
+    /** Qualitative ranges of the rows without `ranges`: upper bounds, ascending */
+    ranges: Array,
+    /** Names of the qualitative ranges, lowest first (tooltip) */
+    rangeLabels: Array,
+    /** Colors of the qualitative ranges, lowest first */
+    rangeColors: Array,
+    /** Thickness of the value bar as a fraction of the ranges' thickness (default 0.4) */
+    barSize: Number,
+    /** Color of the target markers (default the text color) */
+    targetColor: String,
+    /** Tick labels of the scales (default `true`) */
+    ticks: { type: Boolean, default: undefined },
+};
+/** Height computed from the type and the data when the `height` prop is omitted */
+export const autoHeightProp = {
+    /** Height of the chart; numbers are pixels, strings any CSS length (rpx included); computed from the type / data by default */
+    height: {
+        type: [Number, String],
+        default: undefined,
+    },
+};
+/** Props of ShapeChart (any shape type of the engine) */
+export const shapeChartProps = {
+    ...shapeFrameProps,
+    /** Options of the chart, by `type` (pie, radar, gauge, funnel, treemap...) */
+    options: { type: Object, required: true },
+};