@matteoaliano/forest-ui 0.2.8 → 0.2.10

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Theme } from '@mui/material/styles';
-export { D as DesignTokens, P as PresetVariantConfig, T as ThemePreset, a as alkemyPlusPreset, b as alpha, c as avatarColors, d as bg, e as border, f as breadcrumbColors, g as buildTheme, h as buildThemeOptions, i as buttonColors, j as chartColors, k as colors, l as container, m as display, n as fg, o as focusRings, p as fontFamily, q as fontSize, r as fontWeight, s as forestPreset, t as forestTheme, u as forestThemeOptions, v as getAvailablePresets, w as getPreset, x as iconColors, y as lineHeight, z as navColors, A as radius, B as registerPreset, C as sliderColors, E as spacing, F as text, G as toggleColors, H as tokenShadows, I as widths } from './index-C7JP9vAZ.mjs';
+export { D as DesignTokens, P as PresetVariantConfig, T as ThemePreset, a as alkemyPlusPreset, b as alpha, c as avatarColors, d as bg, e as border, f as breadcrumbColors, g as buildTheme, h as buildThemeOptions, i as buttonColors, j as chartColors, k as colors, l as container, m as display, n as fg, o as focusRings, p as fontFamily, q as fontSize, r as fontWeight, s as forestPreset, t as forestTheme, u as forestThemeOptions, v as getAvailablePresets, w as getPreset, x as iconColors, y as lineHeight, z as navColors, A as radius, B as registerPreset, C as sliderColors, E as spacing, F as text, G as toggleColors, H as tokenShadows, I as widths } from './index-DiI9xbOM.mjs';
 import { AutocompleteProps } from '@mui/material/Autocomplete';
 export { AutocompleteProps } from '@mui/material/Autocomplete';
 import { ButtonProps as ButtonProps$1 } from '@mui/material/Button';
@@ -112,6 +112,13 @@ import { SkeletonProps } from '@mui/material/Skeleton';
 export { SkeletonProps } from '@mui/material/Skeleton';
 import { SnackbarProps } from '@mui/material/Snackbar';
 export { SnackbarProps } from '@mui/material/Snackbar';
+import React$1 from 'react';
+import { DrawerProps } from '@mui/material/Drawer';
+import { LineChartProps as LineChartProps$1 } from '@mui/x-charts/LineChart';
+import { BarChartProps as BarChartProps$1 } from '@mui/x-charts/BarChart';
+import { MakeOptional } from '@mui/x-charts/models/helpers';
+import { BarSeriesType } from '@mui/x-charts/models/seriesType/bar';
+import { PieChartProps as PieChartProps$1 } from '@mui/x-charts/PieChart';
 import '@mui/material';
 
 interface ForestProviderProps {
@@ -140,6 +147,19 @@ declare function Radio(props: RadioProps): react_jsx_runtime.JSX.Element;
 declare function Select<Value = unknown>(props: SelectProps<Value>): react_jsx_runtime.JSX.Element;
 declare function MenuItem(props: MenuItemProps): react_jsx_runtime.JSX.Element;
 
+interface MultiSelectOption {
+    label: string;
+    value: string;
+}
+interface MultiSelectProps extends Omit<SelectProps<string[]>, "multiple" | "value" | "onChange" | "renderValue"> {
+    options: MultiSelectOption[];
+    value: string[];
+    onChange: (values: string[]) => void;
+    selectAll?: boolean;
+    selectAllLabel?: string;
+}
+declare function MultiSelect({ options, value, onChange, selectAll, selectAllLabel, label, ...rest }: MultiSelectProps): react_jsx_runtime.JSX.Element;
+
 declare function Switch(props: SwitchProps): react_jsx_runtime.JSX.Element;
 
 declare function TextField(props: TextFieldProps): react_jsx_runtime.JSX.Element;
@@ -208,4 +228,71 @@ declare function Skeleton(props: SkeletonProps): react_jsx_runtime.JSX.Element;
 
 declare function Snackbar(props: SnackbarProps): react_jsx_runtime.JSX.Element;
 
-export { Accordion, AccordionActions, AccordionDetails, AccordionSummary, Alert, AlertTitle, AppBar, Autocomplete, Backdrop, Badge, Button, ButtonGroup, type ButtonProps, Card, CardActions, CardContent, CardHeader, CardMedia, Checkbox, Chip, CircularProgress, DataGrid, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, Divider, Fab, ForestProvider, type ForestProviderProps, LinearProgress, List, ListItem, ListItemAvatar, ListItemButton, ListItemIcon, ListItemText, ListSubheader, MenuItem, Paper, Radio, RadioGroup, Select, Skeleton, Snackbar, Switch, Table, TableBody, TableCell, TableContainer, TableHead, TableRow, TextField, ToggleButton, ToggleButtonGroup, Toolbar, Tooltip, Typography };
+interface SidebarContextValue {
+    open: boolean;
+    collapsedWidth: number;
+    expandedWidth: number;
+}
+declare function useSidebar(): SidebarContextValue;
+interface SidebarNavProps extends Omit<DrawerProps, "open" | "variant" | "onClose"> {
+    /** Whether the sidebar is expanded */
+    open: boolean;
+    /** Callback when open state changes */
+    onOpenChange: (open: boolean) => void;
+    /** Width when expanded (default: 240) */
+    expandedWidth?: number;
+    /** Width when collapsed — icon-only (default: 64) */
+    collapsedWidth?: number;
+    /** Expand behavior:
+     *  - "permanent": click to toggle, stays open/closed
+     *  - "hover": collapsed by default, expands on mouse enter, collapses on mouse leave
+     */
+    behavior?: "permanent" | "hover";
+    /** Whether to show the edge toggle button (default: true for "permanent", false for "hover") */
+    showToggle?: boolean;
+    /** Content rendered inside the sidebar */
+    children: React$1.ReactNode;
+    /** Optional header slot — rendered above children */
+    header?: React$1.ReactNode;
+    /** Optional footer slot — rendered at bottom */
+    footer?: React$1.ReactNode;
+}
+declare function SidebarNav({ open, onOpenChange, expandedWidth, collapsedWidth, behavior, showToggle, children, header, footer, sx, ...rest }: SidebarNavProps): react_jsx_runtime.JSX.Element;
+interface SidebarItemProps extends Omit<ListItemButtonProps, "children"> {
+    /** Icon element (required — visible in both expanded and collapsed states) */
+    icon: React$1.ReactNode;
+    /** Label text */
+    label: string;
+    /** Optional content rendered on the right side when expanded (badge, count, etc.) */
+    endAdornment?: React$1.ReactNode;
+}
+declare function SidebarItem({ icon, label, endAdornment, sx, ...rest }: SidebarItemProps): react_jsx_runtime.JSX.Element;
+
+interface LineChartProps extends Omit<LineChartProps$1, "series"> {
+    series?: LineChartProps$1["series"];
+    /** Which color palette variant to use (categorical=12 pastel, vibrant=5 bright) */
+    palette?: "categorical" | "vibrant";
+}
+declare function LineChart({ series, colors, palette, ...props }: LineChartProps): react_jsx_runtime.JSX.Element;
+
+type ForestBarSeriesType = MakeOptional<BarSeriesType, "type"> & {
+    /** Enables diagonal striped fill for comparative data representation */
+    variant?: "solid" | "striped";
+};
+interface BarChartProps extends Omit<BarChartProps$1, "series"> {
+    series?: ForestBarSeriesType[];
+    /** Which color palette variant to use (categorical=12 pastel, vibrant=5 bright) */
+    palette?: "categorical" | "vibrant";
+}
+declare function BarChart({ series, colors, palette, ...props }: BarChartProps): react_jsx_runtime.JSX.Element;
+
+interface PieChartProps extends Omit<PieChartProps$1, "series"> {
+    series?: PieChartProps$1["series"];
+    /** Which color palette variant to use (categorical=12 pastel, vibrant=5 bright) */
+    palette?: "categorical" | "vibrant";
+}
+declare function PieChart({ series, colors, palette, ...props }: PieChartProps): react_jsx_runtime.JSX.Element;
+
+declare function useChartColors(count: number, palette?: "categorical" | "vibrant"): string[];
+
+export { Accordion, AccordionActions, AccordionDetails, AccordionSummary, Alert, AlertTitle, AppBar, Autocomplete, Backdrop, Badge, BarChart, type BarChartProps, Button, ButtonGroup, type ButtonProps, Card, CardActions, CardContent, CardHeader, CardMedia, Checkbox, Chip, CircularProgress, DataGrid, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, Divider, Fab, ForestProvider, type ForestProviderProps, LineChart, type LineChartProps, LinearProgress, List, ListItem, ListItemAvatar, ListItemButton, ListItemIcon, ListItemText, ListSubheader, MenuItem, MultiSelect, type MultiSelectOption, type MultiSelectProps, Paper, PieChart, type PieChartProps, Radio, RadioGroup, Select, SidebarItem, type SidebarItemProps, SidebarNav, type SidebarNavProps, Skeleton, Snackbar, Switch, Table, TableBody, TableCell, TableContainer, TableHead, TableRow, TextField, ToggleButton, ToggleButtonGroup, Toolbar, Tooltip, Typography, useChartColors, useSidebar };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Theme } from '@mui/material/styles';
-export { D as DesignTokens, P as PresetVariantConfig, T as ThemePreset, a as alkemyPlusPreset, b as alpha, c as avatarColors, d as bg, e as border, f as breadcrumbColors, g as buildTheme, h as buildThemeOptions, i as buttonColors, j as chartColors, k as colors, l as container, m as display, n as fg, o as focusRings, p as fontFamily, q as fontSize, r as fontWeight, s as forestPreset, t as forestTheme, u as forestThemeOptions, v as getAvailablePresets, w as getPreset, x as iconColors, y as lineHeight, z as navColors, A as radius, B as registerPreset, C as sliderColors, E as spacing, F as text, G as toggleColors, H as tokenShadows, I as widths } from './index-C7JP9vAZ.js';
+export { D as DesignTokens, P as PresetVariantConfig, T as ThemePreset, a as alkemyPlusPreset, b as alpha, c as avatarColors, d as bg, e as border, f as breadcrumbColors, g as buildTheme, h as buildThemeOptions, i as buttonColors, j as chartColors, k as colors, l as container, m as display, n as fg, o as focusRings, p as fontFamily, q as fontSize, r as fontWeight, s as forestPreset, t as forestTheme, u as forestThemeOptions, v as getAvailablePresets, w as getPreset, x as iconColors, y as lineHeight, z as navColors, A as radius, B as registerPreset, C as sliderColors, E as spacing, F as text, G as toggleColors, H as tokenShadows, I as widths } from './index-DiI9xbOM.js';
 import { AutocompleteProps } from '@mui/material/Autocomplete';
 export { AutocompleteProps } from '@mui/material/Autocomplete';
 import { ButtonProps as ButtonProps$1 } from '@mui/material/Button';
@@ -112,6 +112,13 @@ import { SkeletonProps } from '@mui/material/Skeleton';
 export { SkeletonProps } from '@mui/material/Skeleton';
 import { SnackbarProps } from '@mui/material/Snackbar';
 export { SnackbarProps } from '@mui/material/Snackbar';
+import React$1 from 'react';
+import { DrawerProps } from '@mui/material/Drawer';
+import { LineChartProps as LineChartProps$1 } from '@mui/x-charts/LineChart';
+import { BarChartProps as BarChartProps$1 } from '@mui/x-charts/BarChart';
+import { MakeOptional } from '@mui/x-charts/models/helpers';
+import { BarSeriesType } from '@mui/x-charts/models/seriesType/bar';
+import { PieChartProps as PieChartProps$1 } from '@mui/x-charts/PieChart';
 import '@mui/material';
 
 interface ForestProviderProps {
@@ -140,6 +147,19 @@ declare function Radio(props: RadioProps): react_jsx_runtime.JSX.Element;
 declare function Select<Value = unknown>(props: SelectProps<Value>): react_jsx_runtime.JSX.Element;
 declare function MenuItem(props: MenuItemProps): react_jsx_runtime.JSX.Element;
 
+interface MultiSelectOption {
+    label: string;
+    value: string;
+}
+interface MultiSelectProps extends Omit<SelectProps<string[]>, "multiple" | "value" | "onChange" | "renderValue"> {
+    options: MultiSelectOption[];
+    value: string[];
+    onChange: (values: string[]) => void;
+    selectAll?: boolean;
+    selectAllLabel?: string;
+}
+declare function MultiSelect({ options, value, onChange, selectAll, selectAllLabel, label, ...rest }: MultiSelectProps): react_jsx_runtime.JSX.Element;
+
 declare function Switch(props: SwitchProps): react_jsx_runtime.JSX.Element;
 
 declare function TextField(props: TextFieldProps): react_jsx_runtime.JSX.Element;
@@ -208,4 +228,71 @@ declare function Skeleton(props: SkeletonProps): react_jsx_runtime.JSX.Element;
 
 declare function Snackbar(props: SnackbarProps): react_jsx_runtime.JSX.Element;
 
-export { Accordion, AccordionActions, AccordionDetails, AccordionSummary, Alert, AlertTitle, AppBar, Autocomplete, Backdrop, Badge, Button, ButtonGroup, type ButtonProps, Card, CardActions, CardContent, CardHeader, CardMedia, Checkbox, Chip, CircularProgress, DataGrid, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, Divider, Fab, ForestProvider, type ForestProviderProps, LinearProgress, List, ListItem, ListItemAvatar, ListItemButton, ListItemIcon, ListItemText, ListSubheader, MenuItem, Paper, Radio, RadioGroup, Select, Skeleton, Snackbar, Switch, Table, TableBody, TableCell, TableContainer, TableHead, TableRow, TextField, ToggleButton, ToggleButtonGroup, Toolbar, Tooltip, Typography };
+interface SidebarContextValue {
+    open: boolean;
+    collapsedWidth: number;
+    expandedWidth: number;
+}
+declare function useSidebar(): SidebarContextValue;
+interface SidebarNavProps extends Omit<DrawerProps, "open" | "variant" | "onClose"> {
+    /** Whether the sidebar is expanded */
+    open: boolean;
+    /** Callback when open state changes */
+    onOpenChange: (open: boolean) => void;
+    /** Width when expanded (default: 240) */
+    expandedWidth?: number;
+    /** Width when collapsed — icon-only (default: 64) */
+    collapsedWidth?: number;
+    /** Expand behavior:
+     *  - "permanent": click to toggle, stays open/closed
+     *  - "hover": collapsed by default, expands on mouse enter, collapses on mouse leave
+     */
+    behavior?: "permanent" | "hover";
+    /** Whether to show the edge toggle button (default: true for "permanent", false for "hover") */
+    showToggle?: boolean;
+    /** Content rendered inside the sidebar */
+    children: React$1.ReactNode;
+    /** Optional header slot — rendered above children */
+    header?: React$1.ReactNode;
+    /** Optional footer slot — rendered at bottom */
+    footer?: React$1.ReactNode;
+}
+declare function SidebarNav({ open, onOpenChange, expandedWidth, collapsedWidth, behavior, showToggle, children, header, footer, sx, ...rest }: SidebarNavProps): react_jsx_runtime.JSX.Element;
+interface SidebarItemProps extends Omit<ListItemButtonProps, "children"> {
+    /** Icon element (required — visible in both expanded and collapsed states) */
+    icon: React$1.ReactNode;
+    /** Label text */
+    label: string;
+    /** Optional content rendered on the right side when expanded (badge, count, etc.) */
+    endAdornment?: React$1.ReactNode;
+}
+declare function SidebarItem({ icon, label, endAdornment, sx, ...rest }: SidebarItemProps): react_jsx_runtime.JSX.Element;
+
+interface LineChartProps extends Omit<LineChartProps$1, "series"> {
+    series?: LineChartProps$1["series"];
+    /** Which color palette variant to use (categorical=12 pastel, vibrant=5 bright) */
+    palette?: "categorical" | "vibrant";
+}
+declare function LineChart({ series, colors, palette, ...props }: LineChartProps): react_jsx_runtime.JSX.Element;
+
+type ForestBarSeriesType = MakeOptional<BarSeriesType, "type"> & {
+    /** Enables diagonal striped fill for comparative data representation */
+    variant?: "solid" | "striped";
+};
+interface BarChartProps extends Omit<BarChartProps$1, "series"> {
+    series?: ForestBarSeriesType[];
+    /** Which color palette variant to use (categorical=12 pastel, vibrant=5 bright) */
+    palette?: "categorical" | "vibrant";
+}
+declare function BarChart({ series, colors, palette, ...props }: BarChartProps): react_jsx_runtime.JSX.Element;
+
+interface PieChartProps extends Omit<PieChartProps$1, "series"> {
+    series?: PieChartProps$1["series"];
+    /** Which color palette variant to use (categorical=12 pastel, vibrant=5 bright) */
+    palette?: "categorical" | "vibrant";
+}
+declare function PieChart({ series, colors, palette, ...props }: PieChartProps): react_jsx_runtime.JSX.Element;
+
+declare function useChartColors(count: number, palette?: "categorical" | "vibrant"): string[];
+
+export { Accordion, AccordionActions, AccordionDetails, AccordionSummary, Alert, AlertTitle, AppBar, Autocomplete, Backdrop, Badge, BarChart, type BarChartProps, Button, ButtonGroup, type ButtonProps, Card, CardActions, CardContent, CardHeader, CardMedia, Checkbox, Chip, CircularProgress, DataGrid, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, Divider, Fab, ForestProvider, type ForestProviderProps, LineChart, type LineChartProps, LinearProgress, List, ListItem, ListItemAvatar, ListItemButton, ListItemIcon, ListItemText, ListSubheader, MenuItem, MultiSelect, type MultiSelectOption, type MultiSelectProps, Paper, PieChart, type PieChartProps, Radio, RadioGroup, Select, SidebarItem, type SidebarItemProps, SidebarNav, type SidebarNavProps, Skeleton, Snackbar, Switch, Table, TableBody, TableCell, TableContainer, TableHead, TableRow, TextField, ToggleButton, ToggleButtonGroup, Toolbar, Tooltip, Typography, useChartColors, useSidebar };