@oliasoft-open-source/charts-library 6.0.0 → 7.0.0-beta-1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oliasoft-open-source/charts-library",
-  "version": "6.0.0",
+  "version": "7.0.0-beta-1",
   "description": "React Chart Library (based on Chart.js and react-chart-js-2)",
   "homepage": "https://gitlab.com/oliasoft-open-source/charts-library",
   "bugs": {
@@ -41,17 +41,18 @@
   },
   "devDependencies": {
     "@dnd-kit/sortable": "^10.0.0",
+    "@microsoft/api-extractor": "^7.59.0",
     "@oliasoft-open-source/react-ui-library": "^7.2.0",
     "@oliasoft-open-source/units": "^5.6.0",
-    "@storybook/addon-docs": "^10.4.0",
-    "@storybook/addon-themes": "^10.4.0",
-    "@storybook/react-vite": "^10.4.0",
+    "@storybook/addon-docs": "^10.5.10",
+    "@storybook/addon-themes": "^10.5.10",
+    "@storybook/react-vite": "^10.5.10",
     "@types/node": "^22.15.17",
     "@types/object-hash": "^3.0.6",
-    "@types/react": "^18.2.24",
-    "@types/react-dom": "^18.3.7",
-    "@vitejs/plugin-react": "^6.0.2",
-    "@vitest/coverage-v8": "4.1.7",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
+    "@vitejs/plugin-react": "^6.1.0",
+    "@vitest/coverage-v8": "^4.1.11",
     "classnames": "^2.5.1",
     "es-toolkit": "^1.44.0",
     "http-server": "^14.1.1",
@@ -61,17 +62,17 @@
     "less": "^4.3.0",
     "lint-staged": "^15.5.2",
     "normalize.css": "^8.0.1",
-    "oxfmt": "^0.61.0",
-    "oxlint": "^1.17.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "storybook": "^10.4.0",
+    "oxfmt": "^0.64.0",
+    "oxlint": "^1.79.0",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "storybook": "^10.5.10",
     "typescript": "^6.0.3",
-    "vite": "8.0.14",
-    "vite-plugin-css-injected-by-js": "^5.0.1",
-    "vite-plugin-dts": "^5.0.1",
+    "vite": "^8.2.2",
+    "vite-plugin-css-injected-by-js": "^5.0.2",
+    "vite-plugin-dts": "^5.0.3",
     "vite-plugin-svgr": "^5.2.0",
-    "vitest": "^4.1.7",
+    "vitest": "^4.1.11",
     "node": "runtime:26.6.0"
   },
   "peerDependencies": {
@@ -80,12 +81,12 @@
     "classnames": "^2.5.1",
     "es-toolkit": "^1",
     "immer": "^9 || ^10",
-    "react": "^18",
-    "react-dom": "^18"
+    "react": "^19",
+    "react-dom": "^19"
   },
   "lint-staged": {
     "*": [
-      "oxlint -c .oxlintrc.json --fix",
+      "oxlint --fix --no-error-on-unmatched-pattern",
       "oxfmt --no-error-on-unmatched-pattern"
     ]
   },

package/dist/src/components/bar-chart/bar-chart-const.d.ts

@@ -1,2 +0,0 @@
-export declare const DISPLAY_SCIENTIFIC_LOWER_BOUND = 0.0001;
-export declare const DISPLAY_SCIENTIFIC_UPPER_BOUND = 10000000;

package/dist/src/components/bar-chart/bar-chart-default-props.d.ts

@@ -1,3 +0,0 @@
-import { IBarChartProps, IBarDefaultProps, IBarOptionsInput } from './bar-chart.interface';
-export declare const normalizeBarOptions: (options?: IBarOptionsInput) => IBarDefaultProps["options"];
-export declare const getDefaultProps: (props: IBarChartProps) => IBarDefaultProps;

package/dist/src/components/bar-chart/bar-chart.d.ts

@@ -1,3 +0,0 @@
-import { IBarChartProps } from './bar-chart.interface';
-declare const BarChartWithLegend: (props: IBarChartProps) => import("react/jsx-runtime").JSX.Element;
-export { BarChartWithLegend as BarChart };

package/dist/src/components/bar-chart/bar-chart.interface.d.ts

@@ -1,146 +0,0 @@
-import { ChartDataset } from 'chart.js';
-import { DeepPartial, ICommonAdditionalAxesOptions, ICommonAnnotations, ICommonAnnotationsData, ICommonAxis, ICommonChartOptions, ICommonCustomLegend, ICommonData, ICommonDataset, ICommonDataValue, ICommonDragData, ICommonGraph, ICommonInteractions, ICommonLegend, ICommonOptions, ICommonScales, ICommonStyling, ICommonTooltip } from '../common/common.interface';
-import { IChartGraph } from '../common/helpers/chart-utils';
-import { ChartType } from '../common/enums';
-export interface IBarStyling extends ICommonStyling {
-    squareAspectRatio?: boolean;
-    layoutPadding?: string | number | {
-        top: number;
-        bottom: number;
-        left: number;
-        right: number;
-    };
-}
-export interface IBarLegend extends ICommonLegend {
-    customLegend?: ICommonCustomLegend<any>;
-}
-export interface IBarAxes {
-    x: ICommonAxis<'top' | 'bottom'>[];
-    y: ICommonAxis<'left' | 'right'>[];
-    [key: string]: ICommonAxis[];
-}
-export interface IBarAdditionalAxesOptions extends ICommonAdditionalAxesOptions {
-    stackedX?: boolean;
-    stackedY?: boolean;
-}
-export interface IBarOptions extends ICommonOptions {
-    direction?: 'vertical' | 'horizontal';
-    axes: IBarAxes;
-    scales?: ICommonScales;
-    additionalAxesOptions?: IBarAdditionalAxesOptions;
-    chartStyling: IBarStyling;
-    graph?: ICommonGraph;
-    annotations?: ICommonAnnotations;
-    legend?: IBarLegend;
-    dragData?: ICommonDragData;
-}
-export interface IBarChartDataset extends ICommonDataset {
-    isAnnotation?: boolean;
-    annotationIndex?: number;
-    borderSkipped?: boolean;
-    borderRadius?: number;
-    xAxisID?: string;
-    yAxisID?: string;
-    hidden?: boolean;
-    displayGroup?: string | number;
-    type?: ChartType.BAR;
-}
-export interface IBarChartBaseData {
-    labels: string[];
-    datasets: IBarChartDataset[];
-}
-export interface IBarChartData extends ICommonData {
-    testId?: string;
-    controlsPortalId?: string;
-    data: IBarChartBaseData;
-    options: IBarOptions;
-}
-type ILooseBarAxis = Omit<DeepPartial<ICommonAxis<string>>, 'gridLines'> & {
-    [key: string]: unknown;
-    gridLines?: unknown;
-};
-type ILooseBarAnnotation = Omit<DeepPartial<ICommonAnnotationsData>, 'annotationAxis'> & {
-    [key: string]: unknown;
-    annotationAxis?: string;
-    type?: string;
-    value?: number | string | null;
-};
-export type IBarOptionsInput = Omit<DeepPartial<IBarOptions>, 'title' | 'direction' | 'axes' | 'legend' | 'chartStyling' | 'interactions' | 'annotations' | 'additionalAxesOptions' | 'scales'> & {
-    [key: string]: unknown;
-    title?: unknown;
-    direction?: string;
-    axes?: {
-        x?: ILooseBarAxis[];
-        y?: ILooseBarAxis[];
-        [key: string]: ILooseBarAxis[] | undefined;
-    };
-    legend?: Omit<DeepPartial<IBarLegend>, 'position' | 'align'> & {
-        position?: string;
-        align?: string;
-        [key: string]: unknown;
-    };
-    chartStyling?: DeepPartial<IBarStyling> & {
-        hideControls?: boolean;
-        minHeight?: number | string;
-        [key: string]: unknown;
-    };
-    additionalAxesOptions?: Omit<DeepPartial<IBarAdditionalAxesOptions>, 'chartScaleType'> & {
-        chartScaleType?: string;
-        [key: string]: unknown;
-    };
-    scales?: Record<string, unknown>;
-    interactions?: DeepPartial<ICommonInteractions> & {
-        enableZoom?: boolean;
-        enablePan?: boolean;
-        [key: string]: unknown;
-    };
-    annotations?: (Omit<DeepPartial<ICommonAnnotations>, 'annotationsData'> & {
-        annotationsData?: ILooseBarAnnotation[];
-    }) | null;
-};
-export interface IBarChartDataInput extends Omit<IBarChartData, 'options' | 'data'> {
-    data?: Omit<DeepPartial<IBarChartData['data']>, 'datasets'> & {
-        datasets?: Array<DeepPartial<IBarChartDataset> | object | null>;
-    };
-    options?: IBarOptionsInput;
-}
-export interface IBarChartProps {
-    chart: IBarChartDataInput;
-}
-export interface IBarDefaultProps {
-    testId: string;
-    controlsPortalId: string;
-    data: IBarChartBaseData;
-    options: {
-        title?: string | string[];
-        direction: 'vertical' | 'horizontal';
-        axes: IBarAxes;
-        additionalAxesOptions: IBarAdditionalAxesOptions;
-        chartStyling: IBarStyling;
-        tooltip: ICommonTooltip;
-        graph: IChartGraph;
-        scales?: ICommonScales;
-        annotations: {
-            showAnnotations: boolean;
-            controlAnnotation: boolean;
-            annotationsData: ICommonAnnotationsData[];
-        };
-        legend: IBarLegend;
-        chartOptions: ICommonChartOptions;
-        interactions: ICommonInteractions;
-        dragData: ICommonDragData;
-    };
-}
-export interface IGenerateBarChartDataset extends ChartDataset<'bar', ICommonDataValue[]> {
-    borderColor: string;
-    backgroundColor: string | string[];
-    borderDash?: number[];
-    borderWidth?: number;
-    annotationType?: string;
-    hideLegend?: boolean;
-    displayGroup?: string | number;
-    isAnnotation?: boolean;
-    annotationIndex?: number;
-}
-export type TGenerateBarChartDatasets = IGenerateBarChartDataset[];
-export {};

package/dist/src/components/bar-chart/utils/get-bar-chart-data-labels.d.ts

@@ -1,10 +0,0 @@
-import { IBarOptions } from '../bar-chart.interface.ts';
-type ExtendedDisplayOptions = 'auto' | boolean;
-export interface IExtendedDataLabelsOptions {
-    display: ExtendedDisplayOptions;
-}
-/**
- * Returns the data labels configuration for a bar chart.
- */
-declare const getBarChartDataLabels: (options: IBarOptions) => IExtendedDataLabelsOptions;
-export default getBarChartDataLabels;

package/dist/src/components/bar-chart/utils/get-bar-chart-scales.d.ts

@@ -1,4 +0,0 @@
-import { IBarDefaultProps } from '../bar-chart.interface';
-import { ICommonScaleOptions } from '../../common/common.interface';
-declare const getBarChartScales: (chart: IBarDefaultProps) => Record<string, ICommonScaleOptions>;
-export default getBarChartScales;

package/dist/src/components/bar-chart/utils/get-bar-chart-tooltips.d.ts

@@ -1,6 +0,0 @@
-import { IBarOptions } from '../bar-chart.interface';
-/**
- * @param {IBarOptions} options - bar chart options object
- */
-declare const getBarChartToolTips: (options: IBarOptions) => Record<string, any>;
-export default getBarChartToolTips;

package/dist/src/components/bar-chart/utils/use-bar-chart-config.d.ts

@@ -1,13 +0,0 @@
-import { RefObject } from 'react';
-import { ActiveElement, Chart, ChartEvent } from 'chart.js';
-import { IBarDefaultProps, IBarOptions, TGenerateBarChartDatasets } from '../bar-chart.interface';
-import { ICommonHoveredItems } from '../../common/common.interface';
-export interface IGenerateBarChartDatasetsProps {
-    datasets: TGenerateBarChartDatasets;
-    options: IBarOptions;
-}
-export declare const useBarChartConfig: (_chartRef: RefObject<Chart>, chart: IBarDefaultProps) => {
-    generatedDatasets: TGenerateBarChartDatasets;
-    onClick: (_evt: ChartEvent, _elements: ActiveElement[], chartInstance: Chart) => void;
-    onHover: (evt: ChartEvent, hoveredItems: ICommonHoveredItems[]) => void;
-};

package/dist/src/components/bar-chart/utils/use-bar-chart-options.d.ts

@@ -1,54 +0,0 @@
-import { MutableRefObject } from 'react';
-import { AnimationSpec, Chart } from 'chart.js';
-import { AxisType, ChartHoverMode } from '../../common/enums';
-import { IBarDefaultProps } from '../bar-chart.interface';
-export interface IUseBarChartOptionsProps {
-    chart: IBarDefaultProps;
-    chartRef: MutableRefObject<Chart | null>;
-}
-export declare const getBarChartAnimation: (performanceMode?: boolean) => false | Partial<AnimationSpec<"bar">>;
-export declare const useBarChartOptions: ({ chart, chartRef }: IUseBarChartOptionsProps) => {
-    onClick: (_evt: import('chart.js').ChartEvent, _elements: import('chart.js').ActiveElement[], chartInstance: Chart) => void;
-    onHover: (evt: import('chart.js').ChartEvent, hoveredItems: import('../../common/common.interface').ICommonHoveredItems[]) => void;
-    indexAxis: AxisType;
-    maintainAspectRatio: boolean | undefined;
-    animation: false | Partial<AnimationSpec<"bar">>;
-    hover: {
-        mode: ChartHoverMode;
-        intersect: boolean;
-    };
-    scales: Record<string, import('../../common/common.interface').ICommonScaleOptions>;
-    plugins: {
-        title: {
-            display: boolean;
-            text: string | string[];
-        } | {
-            display?: undefined;
-            text?: undefined;
-        };
-        datalabels: import('./get-bar-chart-data-labels').IExtendedDataLabelsOptions;
-        annotation: {
-            annotations: {};
-        };
-        tooltip: Record<string, any>;
-        legend: {
-            display: boolean;
-            events: never[];
-            position: any;
-            align: "center" | "start" | "end";
-            labels: {
-                boxHeight: number;
-                boxWidth: number | undefined;
-                usePointStyle: boolean | undefined;
-            };
-            onClick: (_: import('../../common/common.interface').UnusedParameter, legendItem: import('chart.js').LegendItem) => void;
-        };
-        customLegendPlugin: {
-            htmlLegend: any;
-        };
-        chartAreaBorder: {
-            borderColor: string;
-        };
-        dragData: false | object | import('../../common/helpers/get-draggableData').IDraggableData | undefined;
-    };
-};

package/dist/src/components/common/common.interface.d.ts

@@ -1,273 +0,0 @@
-import { ChartEvent, ChartTypeRegistry, Plugin, ScaleOptions } from 'chart.js';
-import { LabelOptions } from 'chartjs-plugin-annotation';
-import { GradientDirection } from './plugins/gradient-background-plugin/enums';
-import { AnnotationType as DraggableAnnotationType, DragAxis } from './plugins/annotation-dragger-plugin/enums';
-import { AlignOptions, Position } from './enums';
-import { ILineMarkersAnnotation } from '../line-chart/plugins/line-markers-plugin/types';
-export type TAxisPosition = 'top' | 'bottom' | 'left' | 'right';
-export type DeepPartial<T> = T extends (...args: any[]) => any ? T : T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? {
-    [K in keyof T]?: DeepPartial<T[K]>;
-} : T;
-export interface ICommonDataValue {
-    x: number | string;
-    y: number | string;
-    label?: string;
-}
-export interface ICommonDataset {
-    label?: string;
-    borderColor?: string;
-    backgroundColor?: string | string[];
-    borderWidth?: number;
-    data: ICommonDataValue[];
-    hidden?: boolean;
-}
-export type ICommonScaleOptions = ScaleOptions<'category'> | ScaleOptions<'linear'> | ScaleOptions<'logarithmic'> | ScaleOptions<'time'> | ScaleOptions<'timeseries'>;
-export type ICommonScales = Partial<Record<string, ICommonScaleOptions>>;
-export interface ICommonAnnotationElement {
-    id?: string;
-    display: boolean;
-    annotationIndex: number;
-    label: {
-        options: LabelOptions;
-        content: string;
-    };
-    options: {
-        id?: string;
-        scaleID?: string;
-        borderColor?: string;
-        borderWidth?: number;
-        radius?: number;
-        label?: {
-            content?: string;
-            position?: string;
-            enabled?: boolean;
-            xAdjust?: number;
-        };
-    };
-}
-export interface ICoordinates {
-    x: number;
-    y: number;
-}
-export interface ICalloutLabelConfig {
-    enabled?: boolean;
-    color?: string;
-    font?: string;
-    borderColor?: string;
-    strokeStyle?: string;
-    lineWidth?: number;
-    startOffset?: number;
-    endOffset?: number;
-    margin?: number;
-    xValue?: number;
-    yValue?: number;
-    xAdjust?: number;
-    yAdjust?: number;
-    onDragStart?: (coordinates: ICoordinates, annotation: ICommonAnnotationsData) => void;
-    onDrag?: (coordinates: ICoordinates, annotation: ICommonAnnotationsData) => void;
-    onDragEnd?: (coordinates: ICoordinates, annotation: ICommonAnnotationsData) => void;
-}
-export interface IAnnotationLabelConfig {
-    backgroundColor?: string;
-    display?: boolean;
-    position?: string;
-    color?: string;
-    font?: string;
-    borderColor?: string;
-    callout?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-export interface ICommonAnnotationsData {
-    display?: boolean;
-    hideLegend?: boolean;
-    labelOffsetPx?: number;
-    id?: string;
-    adjustScaleRange?: boolean;
-    annotationAxis?: 'x' | 'y';
-    rotation?: number;
-    color?: string;
-    endValue?: number;
-    borderWidth?: number;
-    backgroundColor?: string;
-    label?: string;
-    labelConfig?: IAnnotationLabelConfig;
-    type?: DraggableAnnotationType;
-    value?: number;
-    xMin?: number;
-    xMax?: number;
-    yMin?: number;
-    yMax?: number;
-    xValue?: number;
-    yValue?: number;
-    radius?: number;
-    enableDrag?: boolean;
-    onDragStart?: (coordinates: ICoordinates, annotation: ICommonAnnotationsData) => void;
-    onDrag?: (coordinates: ICoordinates, annotation: ICommonAnnotationsData) => void;
-    onDragEnd?: (coordinates: ICoordinates, annotation: ICommonAnnotationsData) => void;
-    dragAxis?: DragAxis;
-    pointStyle?: string;
-    resizable?: boolean;
-    dragRange?: {
-        x?: [number, number];
-        y?: [number, number];
-    };
-    displayDragCoordinates?: boolean;
-    xScaleID?: string;
-    yScaleID?: string;
-    opacity?: number;
-}
-export interface ICommonGradientColor {
-    offset: number;
-    color: string;
-}
-export interface ICommonGradient {
-    display: boolean;
-    gradientColors?: ICommonGradientColor[];
-    direction?: GradientDirection;
-}
-export interface ICommonStyling {
-    width?: number | string;
-    height?: number | string;
-    maintainAspectRatio?: boolean;
-    staticChartHeight?: boolean;
-    performanceMode?: boolean;
-    gradient?: ICommonGradient;
-}
-export interface ICommonLegend {
-    display: boolean;
-    position?: Position;
-    align?: AlignOptions;
-}
-export interface ICommonTooltipCallbacks {
-    title?: (...args: unknown[]) => unknown;
-    label?: (...args: unknown[]) => unknown;
-    afterLabel?: (...args: unknown[]) => unknown;
-}
-export interface ICommonTooltip {
-    tooltips?: boolean;
-    showLabelsInTooltips?: boolean;
-    scientificNotation?: boolean;
-    callbacks?: ICommonTooltipCallbacks;
-}
-export interface ICommonAdditionalAxesOptions {
-    chartScaleType?: 'linear' | 'logarithmic' | 'time' | 'timeseries';
-    reverse?: boolean;
-    beginAtZero?: boolean;
-    stepSize?: number;
-    stacked?: boolean;
-    suggestedMin?: number;
-    suggestedMax?: number;
-    min?: number | string;
-    max?: number | string;
-}
-export interface ICommonAnnotation {
-    showLabel?: boolean;
-    text?: string | string[];
-    position?: string;
-    fontSize?: number;
-    xOffset?: number;
-    yOffset?: number;
-    maxWidth?: number;
-    lineHeight?: number;
-}
-export interface ICommonAnnotations {
-    showAnnotations?: boolean;
-    controlAnnotation?: boolean;
-    enableDragAnnotation?: boolean;
-    enableCalloutAnnotation?: boolean;
-    lineMarkersAnnotation?: ILineMarkersAnnotation;
-    annotationsData?: ICommonAnnotationsData[];
-    labelAnnotation?: ICommonAnnotation;
-}
-export interface ICommonGraph {
-    lineTension?: number;
-    spanGaps?: boolean;
-    showDataLabels?: boolean;
-    showMinorGridlines?: boolean;
-}
-export interface ICommonInteractions {
-    onLegendClick?: (text: string, hidden: boolean) => void;
-    onHover?: (event: ChartEvent, datasetIndex: number, index: number, generatedDataset: any[]) => void;
-    onUnhover?: (event?: ChartEvent, datasetIndex?: number, index?: number, generatedDataset?: any[]) => void;
-}
-export interface ICommonCustomLegend<T extends keyof ChartTypeRegistry> {
-    customLegendPlugin: Plugin<T> | null;
-    customLegendContainerID: string;
-}
-export interface ICommonChartOptions {
-    enableZoom?: boolean;
-    enablePan?: boolean;
-}
-export interface ICommonDragData {
-    enableDragData?: boolean;
-    showTooltip?: boolean;
-    roundPoints?: boolean;
-    dragX?: boolean;
-    dragY?: boolean;
-    onDragStart?: (event: unknown, element: unknown) => unknown;
-    onDrag?: (event: unknown, datasetIndex: number, index: number, value: unknown) => unknown;
-    onDragEnd?: (event: unknown, datasetIndex: number, index: number, value: unknown) => unknown;
-}
-export interface ICommonOptions {
-    title?: string | string[];
-    chartStyling?: ICommonStyling;
-    tooltip?: ICommonTooltip;
-    legend?: ICommonLegend;
-    chartOptions?: ICommonChartOptions;
-    interactions?: ICommonInteractions;
-    dragData?: ICommonDragData;
-    annotations?: ICommonAnnotations;
-    plugins?: {
-        lineMarkersPlugin?: {
-            enabled?: boolean;
-        };
-    };
-}
-export interface ICommonData {
-    testId?: string;
-    data?: {
-        labels?: string[];
-        datasets?: ICommonDataset[];
-    };
-    options: ICommonOptions;
-}
-export interface ICommonHoveredItems {
-    index: number;
-    datasetIndex: number;
-}
-export interface ICommonChartPlugins {
-    legend: {
-        position: TAxisPosition;
-    };
-    title: {
-        display: boolean;
-        text: string;
-    };
-}
-export interface ICommonAxis<PositionType = string> {
-    label?: string;
-    position?: PositionType;
-    color?: string | string[];
-    unit?: string;
-    gridLines?: boolean;
-    stepSize?: number;
-}
-export interface IChartGeneratedLabel {
-    text: string;
-    fillStyle: string;
-    strokeStyle: string;
-    index: number;
-}
-export interface IChartLegendItemFilter {
-    index: number;
-    datasetIndex: number;
-    hidden: boolean;
-}
-export interface IChartDataLabelsOptions {
-    display?: 'auto' | boolean;
-    align?: 'center';
-    anchor?: 'center';
-    formatter?: (_value: unknown, context: unknown) => unknown;
-}
-export type UnusedParameter = unknown;
-export type TPrimitive = string | number | boolean | null;

package/dist/src/components/common/controls-portal.d.ts

@@ -1,7 +0,0 @@
-import { ReactElement } from 'react';
-interface ControlsPortalProps {
-    children: ReactElement;
-    controlsPortalId: string;
-}
-declare const ControlsPortal: ({ children, controlsPortalId }: ControlsPortalProps) => import("react/jsx-runtime").JSX.Element;
-export default ControlsPortal;