@cloudraker/reki 2.6.1

package/dist/src/components/chart/EChart.d.ts

@@ -0,0 +1,159 @@
+import { EChartsOption, SetOptionOpts, TooltipComponentOption } from 'echarts';
+import type * as echarts from "echarts/core";
+/** Parameters passed to mouse event handlers on chart elements */
+type EChartsMouseEventParams = {
+    /** The type of component that triggered the event (e.g. "series", "markPoint") */
+    componentType: string;
+    /** Series type (e.g. "line", "bar") — present when componentType is "series" */
+    seriesType?: string;
+    /** Zero-based index of the series in the option.series array */
+    seriesIndex?: number;
+    /** Name of the series */
+    seriesName?: string;
+    /** Name of the data item */
+    name?: string;
+    /** Zero-based index of the data item within its series */
+    dataIndex?: number;
+    /** Raw data item value */
+    data?: any;
+    /** Sub-type of data (e.g. "node", "edge" for graph series) */
+    dataType?: string;
+    /** Numeric or array value of the data item */
+    value?: number | any[];
+    /** Resolved color of the series or data item */
+    color?: string;
+};
+/**
+ * Tooltip options with the `formatter` property removed and replaced with
+ * `dangerousHtmlFormatter` to make the security implications more explicit.
+ */
+export type SafeTooltipOption = Omit<TooltipComponentOption, "formatter"> & {
+    /**
+     * USE WITH CAUTION: Use this only for trusted HTML content.
+     * When building tooltip HTML with user-provided data, always sanitize
+     * the input to prevent XSS vulnerabilities. Recommended: use
+     * `encodeHTML` from `echarts/format` to escape HTML special characters.
+     */
+    dangerousHtmlFormatter?: TooltipComponentOption["formatter"];
+};
+export type RekiChartOption = {
+    [K in keyof EChartsOption]: K extends "tooltip" ? SafeTooltipOption | SafeTooltipOption[] | undefined : EChartsOption[K];
+};
+/**
+ * ECharts event handlers that can be attached to a `Chart`.
+ * Pass a subset via the `onEvents` prop; handlers are registered lazily and
+ * cleaned up automatically when removed or when the chart is unmounted.
+ */
+export interface ChartEvents {
+    click: (params: EChartsMouseEventParams) => void;
+    dblclick: (params: EChartsMouseEventParams) => void;
+    mousedown: (params: EChartsMouseEventParams) => void;
+    mousemove: (params: EChartsMouseEventParams) => void;
+    mouseup: (params: EChartsMouseEventParams) => void;
+    mouseover: (params: EChartsMouseEventParams) => void;
+    mouseout: (params: EChartsMouseEventParams) => void;
+    /** Fired when the pointer leaves the chart canvas entirely */
+    globalout: (params: any) => void;
+    contextmenu: (params: any) => void;
+    /** Map of series name → selected state for all legend items */
+    /** Fired on legend toggle (`legendToggleSelect` action or a legend UI click) */
+    legendselectchanged: (params: {
+        name: string;
+        selected: Record<string, boolean>;
+    }) => void;
+    /** Fired by the `legendSelect` action. Carries the full `selected` map. */
+    legendselected: (params: {
+        name: string;
+        selected: Record<string, boolean>;
+    }) => void;
+    /** Fired by the `legendUnSelect` action. Carries the full `selected` map. */
+    legendunselected: (params: {
+        name: string;
+        selected: Record<string, boolean>;
+    }) => void;
+    legendscroll: (params: any) => void;
+    datazoom: (params: any) => void;
+    datarangeselected: (params: any) => void;
+    timelinechanged: (params: any) => void;
+    timelineplaychanged: (params: any) => void;
+    restore: (params: any) => void;
+    dataviewchanged: (params: any) => void;
+    magictypechanged: (params: any) => void;
+    pieselectchanged: (params: any) => void;
+    pieselected: (params: any) => void;
+    pieunselected: (params: any) => void;
+    mapselectchanged: (params: any) => void;
+    mapselected: (params: any) => void;
+    mapunselected: (params: any) => void;
+    geoselectchanged: (params: any) => void;
+    geoselected: (params: any) => void;
+    geounselected: (params: any) => void;
+    axisareaselected: (params: any) => void;
+    brush: (params: any) => void;
+    brushselected: (params: any) => void;
+    /** Fired when the user finishes drawing a brush selection */
+    brushend: (params: {
+        areas: Array<{
+            /** Coordinate range covered by the brush — interpretation depends on axis type */
+            coordRange: any;
+            brushType?: string;
+            panelId?: string;
+            range?: any;
+        }>;
+    }) => void;
+}
+/** Props for the low-level `Chart` wrapper around Apache ECharts */
+export interface ChartProps {
+    /**
+     * The ECharts core instance imported by the consumer.
+     * Passed in rather than imported directly so the consumer controls which
+     * ECharts modules are bundled (tree-shaking).
+     */
+    echarts: typeof echarts;
+    /** ECharts option object — passed through to `chart.setOption()` */
+    options: RekiChartOption;
+    /**
+     * Additional options passed as the second argument to `chart.setOption()`.
+     * Defaults to `{ notMerge: false, lazyUpdate: true }`.
+     */
+    optionUpdateBehavior?: SetOptionOpts;
+    /** Additional CSS classes applied to the chart container `<div>` */
+    className?: string;
+    /**
+     * When `true`, initialises ECharts with its built-in dark theme.
+     * Changing this value after mount destroys and re-creates the chart instance.
+     */
+    isDarkMode?: boolean;
+    /** Height of the chart container in pixels. Defaults to `350`. */
+    height?: number;
+    /** Subset of ECharts events to listen for. Handlers are bound/unbound reactively. */
+    onEvents?: Partial<ChartEvents>;
+}
+/**
+ * Chart — a low-level wrapper around [Apache ECharts](https://echarts.apache.org).
+ *
+ * Manages the ECharts instance lifecycle (init, option updates, event binding,
+ * resize observation, and disposal). Exposes the raw `echarts.ECharts` instance
+ * via `ref` for imperative access when needed.
+ *
+ * Prefer `TimeseriesChart` for time-series data; use this component when you
+ * need full control over the ECharts option object.
+ *
+ * @example
+ * ```tsx
+ * import * as echarts from "echarts/core";
+ * import { BarChart } from "echarts/charts";
+ * import { GridComponent } from "echarts/components";
+ * import { CanvasRenderer } from "echarts/renderers";
+ *
+ * echarts.use([BarChart, GridComponent, CanvasRenderer]);
+ *
+ * <Chart
+ *   echarts={echarts}
+ *   options={{ xAxis: { data: ["A", "B"] }, yAxis: {}, series: [{ type: "bar", data: [1, 2] }] }}
+ * />
+ * ```
+ */
+export declare const Chart: import('react').ForwardRefExoticComponent<ChartProps & import('react').RefAttributes<echarts.ECharts>>;
+export {};
+//# sourceMappingURL=EChart.d.ts.map

package/dist/src/components/chart/EChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EChart.d.ts","sourceRoot":"","sources":["../../../../src/components/chart/EChart.tsx"],"names":[],"mappings":"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"}

package/dist/src/components/chart/Legend.d.ts

@@ -0,0 +1,51 @@
+import { MouseEventHandler, PointerEventHandler } from 'react';
+/** Shared props for both legend item variants */
+interface LegendItemProps {
+    /** Series name shown as a label */
+    name: string;
+    /** Hex color string for the series indicator dot */
+    color: string;
+    /** Formatted value string to display */
+    value: string;
+    /** Optional unit label shown after the value (e.g. `"ms"`, `"%"`) */
+    unit?: string;
+    /** When `true`, renders the item at 50% opacity to indicate a deselected state */
+    inactive?: boolean;
+    /** Fired when a pointer enters the legend item — useful for highlighting the corresponding chart series */
+    onPointerEnter?: PointerEventHandler<HTMLDivElement>;
+    /** Fired when a pointer leaves the legend item — useful for resetting chart series emphasis */
+    onPointerLeave?: PointerEventHandler<HTMLDivElement>;
+    /** Fired when the legend item is clicked — useful for toggling series visibility */
+    onClick?: MouseEventHandler<HTMLDivElement>;
+    /** Optional className to customize legend item presentation */
+    className?: string;
+}
+/**
+ * Large legend item — stacked layout with a colored dot + series name on top
+ * and a large value with an optional small unit below. Use for prominent
+ * single-metric displays such as dashboard cards.
+ */
+declare function LargeItem({ color, value, name, unit, inactive, onPointerEnter, onPointerLeave, onClick, className, }: LegendItemProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Small legend item — inline layout with a colored dot, series name, and value
+ * on a single row. Use for compact legends below or beside a chart.
+ */
+declare function SmallItem({ color, value, name, inactive, onPointerEnter, onPointerLeave, onClick, className, }: LegendItemProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * ChartLegend — pre-built legend item components for use alongside a chart.
+ *
+ * - `ChartLegend.SmallItem` — compact inline layout; suited for multi-series legends
+ * - `ChartLegend.LargeItem` — stacked layout with a large value; suited for single-metric cards
+ *
+ * @example
+ * ```tsx
+ * <ChartLegend.SmallItem name="Requests" color="#086FFF" value="1,234" />
+ * <ChartLegend.LargeItem name="Latency" color="#CF7EE9" value="42" unit="ms" inactive />
+ * ```
+ */
+export declare const ChartLegend: {
+    SmallItem: typeof SmallItem;
+    LargeItem: typeof LargeItem;
+};
+export {};
+//# sourceMappingURL=Legend.d.ts.map

package/dist/src/components/chart/Legend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Legend.d.ts","sourceRoot":"","sources":["../../../../src/components/chart/Legend.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,OAAO,CAAC;AASf,iDAAiD;AACjD,UAAU,eAAe;IACvB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2GAA2G;IAC3G,cAAc,CAAC,EAAE,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACrD,+FAA+F;IAC/F,cAAc,CAAC,EAAE,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACrD,oFAAoF;IACpF,OAAO,CAAC,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAC5C,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,iBAAS,SAAS,CAAC,EACjB,KAAK,EACL,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,cAAc,EACd,cAAc,EACd,OAAO,EACP,SAAS,GACV,EAAE,eAAe,2CA+CjB;AAED;;;GAGG;AACH,iBAAS,SAAS,CAAC,EACjB,KAAK,EACL,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,cAAc,EACd,cAAc,EACd,OAAO,EACP,SAAS,GACV,EAAE,eAAe,2CA4BjB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW;;;CAGvB,CAAC"}

package/dist/src/components/chart/SankeyChart.d.ts

@@ -0,0 +1,98 @@
+import type * as echarts from "echarts/core";
+export interface SankeyNodeData {
+    id?: string;
+    name: string;
+    color?: string;
+    /** Optional value/count to display above the node label */
+    value?: number;
+    /** Additional data to show in tooltip (e.g., { Apps: 166, Sessions: 122600 }) */
+    tooltipData?: Record<string, number | string>;
+    isDrillable?: boolean;
+    childCount?: number;
+}
+export interface SankeyLinkData {
+    id?: string;
+    source: number;
+    target: number;
+    value: number;
+    isDrillable?: boolean;
+}
+export type DrillTarget = {
+    type: "node";
+    nodeId: string;
+} | {
+    type: "link";
+    sourceId: string;
+    targetId: string;
+};
+export interface DrillSelection {
+    id: string;
+    type: "node" | "link";
+    label: string;
+    depth: number;
+}
+export interface DrillDownContext {
+    selections: DrillSelection[];
+    isMultiSelect: boolean;
+}
+export interface SankeyData {
+    nodes: SankeyNodeData[];
+    links: SankeyLinkData[];
+}
+/** Parameters passed to the tooltip formatter */
+export interface SankeyTooltipParams {
+    type: "node" | "link";
+    name: string;
+    node?: SankeyNodeData;
+    link?: {
+        source: string;
+        target: string;
+        value: number;
+    };
+    color?: string;
+}
+export interface SankeyChartProps {
+    /**
+     * The ECharts core instance imported by the consumer.
+     * Passed in rather than imported directly so the consumer controls which
+     * ECharts modules are bundled (tree-shaking).
+     */
+    echarts: typeof echarts;
+    /** Array of nodes in the Sankey diagram */
+    nodes: SankeyNodeData[];
+    /** Array of links connecting nodes by index */
+    links: SankeyLinkData[];
+    /** Height of the chart in pixels */
+    height?: number;
+    /** Show node values above labels (default: true if any node has a value) */
+    showNodeValues?: boolean;
+    /** Layout for node labels when showNodeValues is true.
+     * - 'stacked': value on top, name below (default)
+     * - 'inline': "value name" on a single line (better for small nodes)
+     */
+    nodeLabelLayout?: "stacked" | "inline";
+    /** Format function for node values (default: toLocaleString) */
+    formatValue?: (value: number) => string;
+    /** Custom tooltip formatter. Return HTML string or empty string to hide tooltip. */
+    tooltipFormatter?: (params: SankeyTooltipParams) => string;
+    nodeWidth?: number;
+    nodePadding?: number;
+    showTooltip?: boolean;
+    defaultNodeColor?: string;
+    /** Left padding of the Sankey layout within the chart container. Accepts a number (px) or percentage string. ECharts default: '5%'. */
+    left?: number | string;
+    /** Right padding of the Sankey layout within the chart container. Accepts a number (px) or percentage string. ECharts default: '5%'. */
+    right?: number | string;
+    /** Link fill style: 'gradient' blends source to target colors, 'gray' uses flat gray */
+    linkColor?: "gradient" | "gray";
+    linkOpacity?: number;
+    className?: string;
+    isDarkMode?: boolean;
+    onNodeClick?: (node: SankeyNodeData) => void;
+    onLinkClick?: (link: SankeyLinkData) => void;
+}
+export declare function SankeyChart({ echarts, nodes, links, height, nodeWidth, nodePadding, showTooltip: enableTooltip, showNodeValues, nodeLabelLayout, formatValue, tooltipFormatter, defaultNodeColor, left, right, linkColor, linkOpacity, className, isDarkMode, onNodeClick, onLinkClick, }: SankeyChartProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace SankeyChart {
+    var displayName: string;
+}
+//# sourceMappingURL=SankeyChart.d.ts.map

package/dist/src/components/chart/SankeyChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SankeyChart.d.ts","sourceRoot":"","sources":["../../../../src/components/chart/SankeyChart.tsx"],"names":[],"mappings":"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"}

package/dist/src/components/chart/TimeseriesChart.d.ts

@@ -0,0 +1,181 @@
+import { SetOptionOpts } from 'echarts';
+import type * as echarts from "echarts/core";
+/** A single data series rendered on a `TimeseriesChart` */
+export interface TimeseriesData {
+    /** Display name shown in tooltips and legends */
+    name: string;
+    /** Array of `[timestamp_ms, value]` tuples ordered by time */
+    data: [number, number][];
+    /** Hex color string used for this series' line, bars, and legend dot */
+    color: string;
+}
+/** Props for `TimeseriesChart` */
+export interface TimeseriesChartProps {
+    /**
+     * The ECharts core instance imported by the consumer.
+     * Passed in rather than imported directly so the consumer controls which
+     * ECharts modules are bundled (tree-shaking).
+     */
+    echarts: typeof echarts;
+    /** Visual style of each series. Defaults to `"line"`. */
+    type?: "line" | "bar";
+    /** Array of time series data to display on the chart */
+    data: TimeseriesData[];
+    /** Label for the x-axis (time axis) */
+    xAxisName?: string;
+    /** Number of ticks to display on the x-axis */
+    xAxisTickCount?: number;
+    /**
+     * Custom formatter for x-axis tick labels.
+     * Receives the raw timestamp in milliseconds and returns a display string,
+     * overriding ECharts' built-in time formatting.
+     */
+    xAxisTickFormat?: (value: number) => string;
+    /**
+     * Custom formatter for y-axis tick labels.
+     * Receives the raw value and returns a display string.
+     * When omitted, ECharts' built-in formatter is used.
+     */
+    yAxisTickFormat?: (value: number) => string;
+    /**
+     * @deprecated Use `tooltipValueFormat` instead. This prop formats tooltip
+     * values, not y-axis tick labels. It will be removed in a future major version.
+     */
+    yAxisTickLabelFormat?: (value: number) => string;
+    /** Label for the y-axis (value axis) */
+    yAxisName?: string;
+    /** Number of ticks to display on the y-axis */
+    yAxisTickCount?: number;
+    /**
+     * Custom formatter for tooltip values.
+     * Receives the raw y-value and returns a display string.
+     * When omitted, the raw value is shown. Takes precedence over the
+     * deprecated `yAxisTickLabelFormat` prop.
+     */
+    tooltipValueFormat?: (value: number) => string;
+    /**
+     * Controls which series are shown in the tooltip.
+     * - `"all"` — show all series at the hovered timestamp (default)
+     * - `"single"` — show only the series whose value is closest to the cursor
+     */
+    tooltipMode?: "all" | "single";
+    /**
+     * Maximum number of series rows shown in the tooltip when `tooltipMode` is `"all"`.
+     * Additional series are hidden with a `+N more` footer. Defaults to `10`.
+     */
+    tooltipMaxItems?: number;
+    /**
+     * Constrains the tooltip to stay within a specific element or region.
+     * By default the tooltip avoids overflowing any clipping ancestor
+     * (scroll containers, viewports, etc.).
+     *
+     * Pass an `Element` or array of elements to restrict the tooltip to a
+     * specific container.
+     *
+     * @default "clipping-ancestors"
+     */
+    tooltipBoundary?: "clipping-ancestors" | Element | Element[];
+    /**
+     * Which axis the tooltip follows the cursor on.
+     *
+     * - `"both"` — tooltip tracks the cursor on both axes, staying near the
+     *   pointer at all times. This is the default and matches the behaviour of
+     *   ECharts' built-in tooltip.
+     * - `"x"` — tooltip follows the cursor horizontally but is locked to a
+     *   fixed vertical position relative to the chart. This keeps the tooltip
+     *   out of the way of the data and avoids vertical jitter as series values
+     *   change — the same approach used by Recharts and many dashboard UIs.
+     *
+     * Only these two modes are offered because the x-axis is always time in a
+     * `TimeseriesChart`: y-only tracking and fully-fixed positioning don't
+     * produce useful tooltip behaviour for time-series data.
+     *
+     * Powered by Base UI Tooltip's `trackCursorAxis` under the hood.
+     *
+     * @default "both"
+     */
+    tooltipFollowCursor?: "both" | "x";
+    /** Indicates incomplete data periods with optional before/after timestamps in ms */
+    incomplete?: {
+        before?: number;
+        after?: number;
+    };
+    /**
+     * When `true`, adds a hidden ECharts legend so consumers can drive series
+     * visibility imperatively via the `legendSelect` / `legendUnSelect` /
+     * `legendToggleSelect` actions (e.g. to build a custom interactive legend).
+     * Toggled-off series are also excluded from the tooltip.
+     *
+     * Requires the consumer to register ECharts' `LegendComponent`
+     * (`echarts.use([LegendComponent])`); otherwise the legend actions no-op and,
+     * in development, ECharts logs a "component legend is used but not imported"
+     * warning.
+     *
+     * @default false
+     */
+    enableLegendSelection?: boolean;
+    /** Height of the chart in pixels. Defaults to `350`. */
+    height?: number;
+    /** Callback fired when user selects a time range via brush selection */
+    onTimeRangeChange?: (from: number, to: number) => void;
+    /** When `true`, switches the chart to ECharts' built-in dark theme */
+    isDarkMode?: boolean;
+    /**
+     * When `true`, renders a vertical gradient fill beneath each line series.
+     * The gradient fades from the series' color at the top to transparent at the bottom.
+     * Has no effect when `type` is `"bar"`.
+     */
+    gradient?: boolean;
+    /**
+     * When `true`, hides the chart and displays an animated sine-wave skeleton
+     * that oscillates back and forth to indicate that data is being fetched.
+     */
+    loading?: boolean;
+    /**
+     * Accessible description for screen readers. When provided, it is passed to
+     * ECharts' `aria.label.description` and announced when the chart receives
+     * focus. Consumers are responsible for writing a meaningful description —
+     * see the W3C guidance on complex images for recommendations.
+     *
+     * @see https://www.w3.org/WAI/tutorials/images/complex/
+     * @see https://echarts.apache.org/handbook/en/best-practices/aria/
+     */
+    ariaDescription?: string;
+    /**
+     * Additional options passed as the second argument to `chart.setOption()`.
+     * Defaults to `{ notMerge: false, lazyUpdate: true }`.
+     */
+    optionUpdateBehavior?: SetOptionOpts;
+}
+/**
+ * TimeseriesChart — a time-series line or bar chart.
+ *
+ * Built on `Chart` (Apache ECharts) with opinionated defaults for time-series data:
+ * a time-typed x-axis, dashed lines for incomplete data periods, brush-based
+ * time range selection, and automatic tooltip deduplication.
+ *
+ * @example
+ * ```tsx
+ * import * as echarts from "echarts/core";
+ * import { LineChart } from "echarts/charts";
+ * import { GridComponent, TooltipComponent, BrushComponent, ToolboxComponent } from "echarts/components";
+ * import { CanvasRenderer } from "echarts/renderers";
+ *
+ * echarts.use([LineChart, GridComponent, TooltipComponent, BrushComponent, ToolboxComponent, CanvasRenderer]);
+ *
+ * const [range, setRange] = useState<[number, number]>();
+ *
+ * <TimeseriesChart
+ *   echarts={echarts}
+ *   data={[{ name: "Requests", data: [[Date.now(), 42]], color: "#086FFF" }]}
+ *   xAxisName="Time"
+ *   xAxisTickFormat={(ts) => new Date(ts).toLocaleTimeString()}
+ *   yAxisName="Count"
+ *   yAxisTickFormat={(value) => `${value / 1000}k`}
+ *   tooltipValueFormat={(value) => `${value.toFixed(2)} req/s`}
+ *   onTimeRangeChange={(from, to) => setRange([from, to])}
+ * />
+ * ```
+ */
+export declare const TimeseriesChart: import('react').ForwardRefExoticComponent<TimeseriesChartProps & import('react').RefAttributes<echarts.ECharts | null>>;
+//# sourceMappingURL=TimeseriesChart.d.ts.map

package/dist/src/components/chart/TimeseriesChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeseriesChart.d.ts","sourceRoot":"","sources":["../../../../src/components/chart/TimeseriesChart.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAC;AAE7C,OAAO,KAAK,EAA+B,aAAa,EAAE,MAAM,SAAS,CAAC;AAa1E,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IACzB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kCAAkC;AAClC,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACtB,wDAAwD;IACxD,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C;;;OAGG;IACH,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C;;;;OAIG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC/B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,oBAAoB,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC;IAC7D;;;;;;;;;;;;;;;;;;OAkBG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACnC,oFAAoF;IACpF,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD;;;;;;;;;;;;OAYG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,aAAa,CAAC;CACtC;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,eAAe,yHAga1B,CAAC"}

package/dist/src/components/chart/index.d.ts

@@ -0,0 +1,6 @@
+export { TimeseriesChart, type TimeseriesChartProps, type TimeseriesData, } from './TimeseriesChart';
+export { Chart, type ChartEvents, type ChartProps, type RekiChartOption, } from './EChart';
+export { ChartLegend } from './Legend';
+export { SankeyChart, type SankeyChartProps, type SankeyNodeData, type SankeyLinkData, type SankeyTooltipParams, } from './SankeyChart';
+export { ChartPalette } from './Color';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/chart/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/chart/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,KAAK,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}