@commerce7/admin-ui 2.0.56 → 2.0.58

package/lib/types/barChart/BarChart.d.ts

@@ -0,0 +1,87 @@
+import { FC, ReactElement } from 'react';
+export interface BarChartSeries {
+    /** The data key in each data object for this bar */
+    key: string;
+    /** Display label for the bar (used in tooltip/legend) */
+    label: string;
+    /** Fill color for the bar */
+    color: string;
+}
+export interface BarChartProps {
+    /**
+     * The source data array to render the bar chart.
+     * Each object should have a category key (see xAxisDataKey) and numeric keys matching each series key.
+     */
+    data: Record<string, any>[];
+    /**
+     * The series definitions that describe each bar to render.
+     */
+    series: BarChartSeries[];
+    /**
+     * The data key used for the category axis. Defaults to 'period'.
+     */
+    xAxisDataKey?: string;
+    /**
+     * The layout of the bar chart.
+     */
+    layout?: 'horizontal' | 'vertical';
+    /**
+     * The percentage value of the chart's width or a fixed width.
+     */
+    width?: string | number;
+    /**
+     * The percentage value of the chart's height or a fixed height.
+     */
+    height?: string | number;
+    /**
+     * The prop to add positioning to BarChart. Refer: https://recharts.org/en-US/api/BarChart#margin
+     */
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /**
+     * The gap between bar categories as a percentage or fixed value.
+     */
+    barCategoryGap?: string | number;
+    /**
+     * The gap between bars within the same category.
+     */
+    barGap?: number;
+    /**
+     * The fixed width/height of each bar.
+     */
+    barSize?: number;
+    /**
+     * The border radius for each bar. Defaults to [3, 3, 0, 0] for horizontal, [0, 3, 3, 0] for vertical.
+     */
+    barRadius?: [number, number, number, number];
+    /**
+     * A component to render custom tooltip. Refer: https://recharts.org/en-US/api/Tooltip#content
+     */
+    tooltip?: ReactElement;
+    /**
+     * Indicates whether the tooltip is hidden.
+     */
+    hideTooltip?: boolean;
+    /**
+     * Indicates whether the X axis is hidden.
+     */
+    hideXAxis?: boolean;
+    /**
+     * Indicates whether the Y axis is hidden (only applies to vertical layout).
+     */
+    hideYAxis?: boolean;
+    /**
+     * The stroke color for axis tick labels.
+     */
+    axisColor?: string;
+    /**
+     * The minimum point size for bars to ensure visibility of zero or near-zero values.
+     */
+    minPointSize?: number;
+}
+declare const BarChart: FC<BarChartProps>;
+export default BarChart;

package/lib/types/barChart/Tooltip.d.ts

@@ -0,0 +1,26 @@
+import { FC } from 'react';
+interface PayloadItem {
+    name: string;
+    value: string | number;
+    payload?: Record<string, any>;
+    dataKey?: string;
+    fill?: string;
+    [key: string]: any;
+}
+interface ToolTipProps {
+    /**
+     * Whether the tooltip is currently active (visible)
+     */
+    active?: boolean;
+    /**
+     * The data payload of the tooltip
+     */
+    payload?: PayloadItem[];
+}
+/**
+ * Custom tooltip component for bar charts
+ * Displays the series name and value of the hovered bar
+ */
+declare const ToolTip: FC<ToolTipProps>;
+export type { ToolTipProps, PayloadItem };
+export default ToolTip;

package/lib/types/barChart/index.d.ts

@@ -0,0 +1,3 @@
+import BarChart, { BarChartProps, BarChartSeries } from './BarChart';
+export type { BarChartProps, BarChartSeries };
+export default BarChart;

package/lib/types/index.d.ts

@@ -1,5 +1,6 @@
 import Alert from './alert';
 import Avatar from './avatar';
+import BarChart from './barChart';
 import Breadcrumbs from './breadcrumbs';
 import Button from './button';
 import ButtonMenu from './buttonMenu';
@@ -42,9 +43,10 @@ import Textarea from './textarea';
 import Commerce7AdminUI from './ui';
 import { c7Colors } from './ui/theme';
 import VividIcon from './vividIcon';
-export { Avatar, Alert, Breadcrumbs, Button, ButtonMenu, c7Colors, Commerce7AdminUI, Checkbox, CheckboxGroup, Columns, ContextMenu, DataDisplay, DatePicker, Heading, Icon, InfoCard, DisplayIcon, VividIcon, Input, LineBreak, Nav, NoRecords, ProgressBar, Picture, PieChart, Legend, LinkButton, Modal, Radio, RadioGroup, Region, Select, SelectButton, Spinner, Stepper, SubMenu, Switch, Table, Tag, Textarea, Card, CardLink, Text, Tabs };
+export { Avatar, Alert, BarChart, Breadcrumbs, Button, ButtonMenu, c7Colors, Commerce7AdminUI, Checkbox, CheckboxGroup, Columns, ContextMenu, DataDisplay, DatePicker, Heading, Icon, InfoCard, DisplayIcon, VividIcon, Input, LineBreak, Nav, NoRecords, ProgressBar, Picture, PieChart, Legend, LinkButton, Modal, Radio, RadioGroup, Region, Select, SelectButton, Spinner, Stepper, SubMenu, Switch, Table, Tag, Textarea, Card, CardLink, Text, Tabs };
 export type { AlertProps, AlertVariant } from './alert';
 export type { AvatarProps } from './avatar';
+export type { BarChartProps, BarChartSeries } from './barChart';
 export type { BreadcrumbProps, BreadcrumbsProps } from './breadcrumbs';
 export type { ButtonProps, ButtonSize, ButtonVariant } from './button';
 export type { ButtonMenuProps, ButtonMenuItemProps, ButtonSize as ButtonMenuSize, ButtonVariant as ButtonMenuVariant } from './buttonMenu';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commerce7/admin-ui",
-  "version": "2.0.56",
+  "version": "2.0.58",
   "description": "Commerce7 Admin UI Component Library",
   "keywords": [
     "Commerce7"