@esperanca-ui/componentes 2.13.6 → 2.14.0

package/dist/components/BarChart/BarChart.d.ts

@@ -0,0 +1,7 @@
+import { ChartBaseProps } from '../Charts/chartTypes';
+
+export interface BarChartProps extends ChartBaseProps {
+    /** @deprecated Use `showValueLabels` instead. */
+    showValues?: boolean;
+}
+export declare const BarChart: import('react').ForwardRefExoticComponent<BarChartProps & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/Charts/ChartPreferencesMenu.d.ts

@@ -0,0 +1,20 @@
+import { ChartDisplayPreferences } from './chartTypes';
+
+type ChartPreferenceAvailability = {
+    showTitle?: boolean;
+    showDescription?: boolean;
+    showLegend?: boolean;
+    showXAxisLabel?: boolean;
+    showYAxisLabel?: boolean;
+    showValueLabels?: boolean;
+    xTickRotation?: boolean;
+};
+type ChartPreferencesMenuProps = {
+    preferences: ChartDisplayPreferences;
+    availability: ChartPreferenceAvailability;
+    valueLabelsLabel: string;
+    onChange: (patch: Partial<ChartDisplayPreferences>) => void;
+    onReset: () => void;
+};
+export declare function ChartPreferencesMenu({ preferences, availability, valueLabelsLabel, onChange, onReset, }: ChartPreferencesMenuProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/Charts/ChartShell.d.ts

@@ -0,0 +1,53 @@
+import { default as React } from 'react';
+import { Card } from '../Card/Card';
+import { ChartLegendPosition, ChartTickRotation } from './chartTypes';
+
+type ChartShellLegendItem = {
+    label: React.ReactNode;
+    color: string;
+};
+type ChartShellTooltipData = {
+    xPercent: number;
+    yPercent: number;
+    label: React.ReactNode;
+    items: Array<{
+        key: string;
+        label: React.ReactNode;
+        value: React.ReactNode;
+        color: string;
+    }>;
+};
+type ChartShellYAxisTick = {
+    key: string;
+    label: React.ReactNode;
+    topPercent: number;
+};
+type ChartShellXAxisTick = {
+    key: string;
+    label: React.ReactNode;
+    leftPercent: number;
+    align?: 'start' | 'center' | 'end';
+};
+export interface ChartShellProps extends Omit<React.ComponentProps<typeof Card>, 'children' | 'title'> {
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    headerActions?: React.ReactNode;
+    legend?: ChartShellLegendItem[];
+    legendPosition?: ChartLegendPosition;
+    footer?: React.ReactNode;
+    empty?: boolean;
+    emptyMessage?: React.ReactNode;
+    ariaLabel?: string;
+    tooltip?: ChartShellTooltipData | null;
+    stageProps?: React.HTMLAttributes<HTMLDivElement>;
+    xAxisLabel?: React.ReactNode;
+    xAxisTicks?: ChartShellXAxisTick[];
+    xAxisTickRotation?: ChartTickRotation;
+    xAxisTickHeight?: number | string;
+    yAxisLabel?: React.ReactNode;
+    yAxisTicks?: ChartShellYAxisTick[];
+    yAxisTickWidth?: number | string;
+    children: React.ReactNode;
+}
+export declare const ChartShell: React.ForwardRefExoticComponent<Omit<ChartShellProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export {};

package/dist/components/Charts/chartTypes.d.ts

@@ -0,0 +1,53 @@
+import { ReactNode } from 'react';
+import { CardProps } from '../Card/Card';
+
+export type ChartTone = 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'neutral';
+export type ChartCurve = 'linear' | 'smooth';
+export type ChartLegendPosition = 'top' | 'bottom' | 'left' | 'right';
+export type ChartTickRotation = 0 | -30 | -45 | -60 | -90;
+export type ChartDatum = {
+    label: string;
+    [key: string]: string | number | null | undefined;
+};
+export interface ChartSeries {
+    key: string;
+    label: string;
+    color?: string;
+    tone?: ChartTone;
+}
+export interface ChartDisplayPreferences {
+    showTitle: boolean;
+    showDescription: boolean;
+    showLegend: boolean;
+    showXAxisLabel: boolean;
+    showYAxisLabel: boolean;
+    showValueLabels: boolean;
+    xTickRotation: ChartTickRotation;
+}
+export interface ChartBaseProps extends Omit<CardProps, 'children' | 'title'> {
+    data: ChartDatum[];
+    series: ChartSeries[];
+    title?: ReactNode;
+    description?: ReactNode;
+    footer?: ReactNode;
+    ariaLabel?: string;
+    height?: number;
+    showLegend?: boolean;
+    legendPosition?: ChartLegendPosition;
+    showGrid?: boolean;
+    showXAxis?: boolean;
+    showYAxis?: boolean;
+    xAxisLabel?: ReactNode;
+    yAxisLabel?: ReactNode;
+    yAxisTickWidth?: number | string;
+    showValueLabels?: boolean;
+    xTickRotation?: ChartTickRotation;
+    enableUserPreferences?: boolean;
+    preferencesStorageKey?: string;
+    onPreferencesChange?: (preferences: ChartDisplayPreferences) => void;
+    yTickCount?: number;
+    formatValue?: (value: number) => string;
+    formatTickValue?: (value: number) => string;
+    formatLabel?: (label: string) => string;
+    emptyMessage?: ReactNode;
+}

package/dist/components/Charts/chartUtils.d.ts

@@ -0,0 +1,38 @@
+import { ChartCurve, ChartDatum, ChartSeries, ChartTickRotation } from './chartTypes';
+
+type ChartPoint = {
+    x: number;
+    y: number;
+};
+export declare function resolveSeriesColor(series: ChartSeries, index: number): string;
+export declare function getNumericValue(datum: ChartDatum, key: string): number;
+export declare function formatChartValue(value: number, formatter?: (value: number) => string): string;
+export declare function formatChartTickValue(value: number, formatter?: (value: number) => string): string;
+export declare function formatChartLabel(label: string, formatter?: (label: string) => string): string;
+export declare function getLineRange(data: ChartDatum[], series: ChartSeries[]): {
+    min: number;
+    max: number;
+};
+export declare function getBarRange(data: ChartDatum[], series: ChartSeries[]): {
+    min: number;
+    max: number;
+};
+export declare function getNiceTickScale(min: number, max: number, count: number): {
+    min: number;
+    max: number;
+    ticks: number[];
+};
+export declare function scaleY(value: number, min: number, max: number, top: number, height: number): number;
+export declare function getXPosition(index: number, count: number, left: number, width: number): number;
+export declare function getBandCenterPosition(index: number, count: number, left: number, width: number): number;
+export declare function getSlotBounds(index: number, positions: number[], minX: number, maxX: number): {
+    x: number;
+    width: number;
+};
+export declare function getAxisLabelStep(length: number): 1 | 2 | 4;
+export declare function isChartTickRotation(value: number): value is ChartTickRotation;
+export declare function getXAxisTickBlockHeight(showXAxis: boolean, rotation: ChartTickRotation): 0 | 24 | 44 | 58 | 72 | 110;
+export declare function getYAxisTickColumnWidth(labels: string[]): number;
+export declare function createLinePath(points: ChartPoint[], curve: ChartCurve): string;
+export declare function createAreaPath(points: ChartPoint[], baselineY: number, curve: ChartCurve): string;
+export {};

package/dist/components/Charts/useChartPreferences.d.ts

@@ -0,0 +1,14 @@
+import { ChartDisplayPreferences } from './chartTypes';
+
+type UseChartPreferencesOptions = {
+    enabled: boolean;
+    defaults: ChartDisplayPreferences;
+    storageKey?: string;
+    onChange?: (preferences: ChartDisplayPreferences) => void;
+};
+export declare function useChartPreferences({ enabled, defaults, storageKey, onChange, }: UseChartPreferencesOptions): {
+    preferences: ChartDisplayPreferences;
+    updatePreferences: (patch: Partial<ChartDisplayPreferences>) => void;
+    resetPreferences: () => void;
+};
+export {};

package/dist/components/LineChart/LineChart.d.ts

@@ -0,0 +1,8 @@
+import { ChartBaseProps, ChartCurve } from '../Charts/chartTypes';
+
+export interface LineChartProps extends ChartBaseProps {
+    curve?: ChartCurve;
+    showArea?: boolean;
+    showDots?: boolean;
+}
+export declare const LineChart: import('react').ForwardRefExoticComponent<LineChartProps & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/Sidebar/Sidebar.d.ts

@@ -19,6 +19,7 @@ export type SidebarItem = {
     iconName?: SidebarIconName;
     icon?: React.ReactNode;
     onClick?: () => void;
+    children?: SidebarItem[];
 };
 export type SidebarSection = {
     heading?: string;

package/dist/index.d.ts

@@ -12,6 +12,8 @@ export { PageHeader } from './components/PageHeader/PageHeader';
 export { Tabs } from './components/Tabs/Tabs';
 export { Card, CardHeader, CardTitle, CardDescription, CardBody, CardFooter } from './components/Card/Card';
 export { MetricCard } from './components/MetricCard/MetricCard';
+export { LineChart } from './components/LineChart/LineChart';
+export { BarChart } from './components/BarChart/BarChart';
 export { TaskStatusBadge } from './components/TaskStatusBadge/TaskStatusBadge';
 export { TaskPriorityBadge } from './components/TaskPriorityBadge/TaskPriorityBadge';
 export { TaskCard } from './components/TaskCard/TaskCard';
@@ -42,6 +44,9 @@ export type { PageHeaderProps } from './components/PageHeader/PageHeader';
 export type { TabsProps, TabsItem, TabsVariant, TabsSize } from './components/Tabs/Tabs';
 export type { CardProps } from './components/Card/Card';
 export type { MetricCardProps } from './components/MetricCard/MetricCard';
+export type { LineChartProps } from './components/LineChart/LineChart';
+export type { BarChartProps } from './components/BarChart/BarChart';
+export type { ChartBaseProps, ChartCurve, ChartDatum, ChartDisplayPreferences, ChartLegendPosition, ChartSeries, ChartTickRotation, ChartTone, } from './components/Charts/chartTypes';
 export type { TaskStatusBadgeProps, TaskStatus } from './components/TaskStatusBadge/TaskStatusBadge';
 export type { TaskPriorityBadgeProps, TaskPriority } from './components/TaskPriorityBadge/TaskPriorityBadge';
 export type { TaskCardProps } from './components/TaskCard/TaskCard';