@matteoaliano/forest-ui 1.2.3 → 1.2.5

package/dist/index.d.mts

@@ -23,6 +23,7 @@ import { IconButtonProps as IconButtonProps$1 } from '@mui/material/IconButton';
 import * as React$1 from 'react';
 import React__default from 'react';
 import { ToggleButtonProps as ToggleButtonProps$1 } from '@mui/material/ToggleButton';
+import { ToggleButtonGroupProps as ToggleButtonGroupProps$1 } from '@mui/material/ToggleButtonGroup';
 import { DatePickerProps as DatePickerProps$1 } from '@mui/x-date-pickers/DatePicker';
 export { default as FormControl, FormControlProps } from '@mui/material/FormControl';
 export { default as FormControlLabel, FormControlLabelProps } from '@mui/material/FormControlLabel';
@@ -168,7 +169,6 @@ export { default as CardHeader, CardHeaderProps } from '@mui/material/CardHeader
 export { default as CardMedia, CardMediaProps } from '@mui/material/CardMedia';
 export { default as MenuItem, MenuItemProps } from '@mui/material/MenuItem';
 export { default as SwipeableDrawer, SwipeableDrawerProps } from '@mui/material/SwipeableDrawer';
-export { default as ToggleButtonGroup, ToggleButtonGroupProps } from '@mui/material/ToggleButtonGroup';
 export { default as Toolbar, ToolbarProps } from '@mui/material/Toolbar';
 
 interface ForestProviderProps {
@@ -298,11 +298,22 @@ interface LogoProps extends Omit<BoxProps<'svg'>, 'component' | 'children'> {
 declare const Logo: React$1.ForwardRefExoticComponent<Omit<LogoProps, "ref"> & React$1.RefAttributes<SVGSVGElement>>;
 
 type ToggleButtonVariant = "contained" | "outlined";
+type ToggleButtonGroupProps = ToggleButtonGroupProps$1 & {
+    /**
+     * Visual style for every child `<ToggleButton>`, so the whole segmented
+     * control is styled as one unit. `"outlined"` (default) is the transparent,
+     * grey-bordered face; `"contained"` is the charcoal faux-3D one. A child's
+     * own `variant` prop still wins.
+     */
+    variant?: ToggleButtonVariant;
+};
+declare function ToggleButtonGroup({ variant, ...props }: ToggleButtonGroupProps): react_jsx_runtime.JSX.Element;
 type ToggleButtonProps = ToggleButtonProps$1 & {
     /**
-     * Visual style, matching `<ButtonGroup>`'s variants. `"contained"` (default)
-     * is the charcoal faux-3D face; `"outlined"` is the transparent, grey-bordered
-     * one. Selected stays "pressed in" in both.
+     * Visual style, matching `<ButtonGroup>`'s variants. `"outlined"` (default)
+     * is the transparent, grey-bordered face; `"contained"` is the charcoal
+     * faux-3D one. Selected stays "pressed in" in both. Inside a
+     * `<ToggleButtonGroup>`, omitting this inherits the group's variant.
      */
     variant?: ToggleButtonVariant;
 };
@@ -509,8 +520,12 @@ interface SidebarNavProps extends Omit<DrawerProps, "open" | "variant" | "onClos
     header?: React__default.ReactNode;
     /** Optional footer slot — rendered at bottom */
     footer?: React__default.ReactNode;
+    /** How far to either side of the sidebar's edge the pointer counts as "on the
+     *  edge", in px. Inside this band the toggle fades in and tracks the pointer
+     *  vertically; outside it the toggle is hidden. (default: 12) */
+    toggleEdgeAllowance?: number;
 }
-declare function SidebarNav({ open, onOpenChange, expandedWidth, collapsedWidth, behavior, showToggle, children, header, footer, sx, ...rest }: SidebarNavProps): react_jsx_runtime.JSX.Element;
+declare function SidebarNav({ open, onOpenChange, expandedWidth, collapsedWidth, behavior, showToggle, children, header, footer, toggleEdgeAllowance, sx, ...rest }: SidebarNavProps): react_jsx_runtime.JSX.Element;
 interface SidebarItemProps extends ListItemButtonProps {
     /** Icon element (required — visible in both expanded and collapsed states) */
     icon: React__default.ReactNode;
@@ -558,6 +573,12 @@ interface AppShellProps {
  * sticky AppBar (brand / search / actions + the color-mode toggle) over a
  * SidebarNav and a main content area. Render a <Page> as children.
  *
+ * The AppBar and the sidebar read as one continuous L-shaped chrome — they
+ * already share `bg.primary`, so the shell drops the borders that used to cut
+ * them apart. The main region is then a lifted surface tucked into the corner
+ * they form: rounded at the top-left only, flush with the right and bottom
+ * window edges.
+ *
  * Below the "sm" breakpoint the sidebar becomes a temporary overlay drawer
  * opened by a hamburger button in the AppBar.
  */
@@ -622,4 +643,4 @@ declare function ScatterChart({ series, colors, ...props }: ScatterChartProps):
 type GaugeProps = GaugeProps$1;
 declare function Gauge(props: GaugeProps): react_jsx_runtime.JSX.Element;
 
-export { AppBarNavItem, type AppBarNavItemProps, AppShell, type AppShellNavItem, type AppShellProps, BarChart, type BarChartProps, Button, ButtonGroup, type ButtonProps, Card, type CardProps, Chip, DatePicker, type DatePickerProps, Drawer, Fab, type ForestCardColor, type ForestChipColor, type ForestChipProps, ForestProvider, type ForestProviderProps, Gauge, IconButton, type IconButtonProps, type IconButtonVariant, LineChart, type LineChartProps, Logo, type LogoProps, MultiSelect, type MultiSelectOption, type MultiSelectProps, Page, type PageBreadcrumb, type PageProps, PieChart, type PieChartProps, Popover, ScatterChart, Search, type SearchProps, Select, SidebarItem, type SidebarItemProps, SidebarNav, type SidebarNavProps, ToggleButton, type ToggleButtonProps, Tooltip, useChartColors, useSidebar };
+export { AppBarNavItem, type AppBarNavItemProps, AppShell, type AppShellNavItem, type AppShellProps, BarChart, type BarChartProps, Button, ButtonGroup, type ButtonProps, Card, type CardProps, Chip, DatePicker, type DatePickerProps, Drawer, Fab, type ForestCardColor, type ForestChipColor, type ForestChipProps, ForestProvider, type ForestProviderProps, Gauge, IconButton, type IconButtonProps, type IconButtonVariant, LineChart, type LineChartProps, Logo, type LogoProps, MultiSelect, type MultiSelectOption, type MultiSelectProps, Page, type PageBreadcrumb, type PageProps, PieChart, type PieChartProps, Popover, ScatterChart, Search, type SearchProps, Select, SidebarItem, type SidebarItemProps, SidebarNav, type SidebarNavProps, ToggleButton, ToggleButtonGroup, type ToggleButtonGroupProps, type ToggleButtonProps, type ToggleButtonVariant, Tooltip, useChartColors, useSidebar };

package/dist/index.d.ts

@@ -23,6 +23,7 @@ import { IconButtonProps as IconButtonProps$1 } from '@mui/material/IconButton';
 import * as React$1 from 'react';
 import React__default from 'react';
 import { ToggleButtonProps as ToggleButtonProps$1 } from '@mui/material/ToggleButton';
+import { ToggleButtonGroupProps as ToggleButtonGroupProps$1 } from '@mui/material/ToggleButtonGroup';
 import { DatePickerProps as DatePickerProps$1 } from '@mui/x-date-pickers/DatePicker';
 export { default as FormControl, FormControlProps } from '@mui/material/FormControl';
 export { default as FormControlLabel, FormControlLabelProps } from '@mui/material/FormControlLabel';
@@ -168,7 +169,6 @@ export { default as CardHeader, CardHeaderProps } from '@mui/material/CardHeader
 export { default as CardMedia, CardMediaProps } from '@mui/material/CardMedia';
 export { default as MenuItem, MenuItemProps } from '@mui/material/MenuItem';
 export { default as SwipeableDrawer, SwipeableDrawerProps } from '@mui/material/SwipeableDrawer';
-export { default as ToggleButtonGroup, ToggleButtonGroupProps } from '@mui/material/ToggleButtonGroup';
 export { default as Toolbar, ToolbarProps } from '@mui/material/Toolbar';
 
 interface ForestProviderProps {
@@ -298,11 +298,22 @@ interface LogoProps extends Omit<BoxProps<'svg'>, 'component' | 'children'> {
 declare const Logo: React$1.ForwardRefExoticComponent<Omit<LogoProps, "ref"> & React$1.RefAttributes<SVGSVGElement>>;
 
 type ToggleButtonVariant = "contained" | "outlined";
+type ToggleButtonGroupProps = ToggleButtonGroupProps$1 & {
+    /**
+     * Visual style for every child `<ToggleButton>`, so the whole segmented
+     * control is styled as one unit. `"outlined"` (default) is the transparent,
+     * grey-bordered face; `"contained"` is the charcoal faux-3D one. A child's
+     * own `variant` prop still wins.
+     */
+    variant?: ToggleButtonVariant;
+};
+declare function ToggleButtonGroup({ variant, ...props }: ToggleButtonGroupProps): react_jsx_runtime.JSX.Element;
 type ToggleButtonProps = ToggleButtonProps$1 & {
     /**
-     * Visual style, matching `<ButtonGroup>`'s variants. `"contained"` (default)
-     * is the charcoal faux-3D face; `"outlined"` is the transparent, grey-bordered
-     * one. Selected stays "pressed in" in both.
+     * Visual style, matching `<ButtonGroup>`'s variants. `"outlined"` (default)
+     * is the transparent, grey-bordered face; `"contained"` is the charcoal
+     * faux-3D one. Selected stays "pressed in" in both. Inside a
+     * `<ToggleButtonGroup>`, omitting this inherits the group's variant.
      */
     variant?: ToggleButtonVariant;
 };
@@ -509,8 +520,12 @@ interface SidebarNavProps extends Omit<DrawerProps, "open" | "variant" | "onClos
     header?: React__default.ReactNode;
     /** Optional footer slot — rendered at bottom */
     footer?: React__default.ReactNode;
+    /** How far to either side of the sidebar's edge the pointer counts as "on the
+     *  edge", in px. Inside this band the toggle fades in and tracks the pointer
+     *  vertically; outside it the toggle is hidden. (default: 12) */
+    toggleEdgeAllowance?: number;
 }
-declare function SidebarNav({ open, onOpenChange, expandedWidth, collapsedWidth, behavior, showToggle, children, header, footer, sx, ...rest }: SidebarNavProps): react_jsx_runtime.JSX.Element;
+declare function SidebarNav({ open, onOpenChange, expandedWidth, collapsedWidth, behavior, showToggle, children, header, footer, toggleEdgeAllowance, sx, ...rest }: SidebarNavProps): react_jsx_runtime.JSX.Element;
 interface SidebarItemProps extends ListItemButtonProps {
     /** Icon element (required — visible in both expanded and collapsed states) */
     icon: React__default.ReactNode;
@@ -558,6 +573,12 @@ interface AppShellProps {
  * sticky AppBar (brand / search / actions + the color-mode toggle) over a
  * SidebarNav and a main content area. Render a <Page> as children.
  *
+ * The AppBar and the sidebar read as one continuous L-shaped chrome — they
+ * already share `bg.primary`, so the shell drops the borders that used to cut
+ * them apart. The main region is then a lifted surface tucked into the corner
+ * they form: rounded at the top-left only, flush with the right and bottom
+ * window edges.
+ *
  * Below the "sm" breakpoint the sidebar becomes a temporary overlay drawer
  * opened by a hamburger button in the AppBar.
  */
@@ -622,4 +643,4 @@ declare function ScatterChart({ series, colors, ...props }: ScatterChartProps):
 type GaugeProps = GaugeProps$1;
 declare function Gauge(props: GaugeProps): react_jsx_runtime.JSX.Element;
 
-export { AppBarNavItem, type AppBarNavItemProps, AppShell, type AppShellNavItem, type AppShellProps, BarChart, type BarChartProps, Button, ButtonGroup, type ButtonProps, Card, type CardProps, Chip, DatePicker, type DatePickerProps, Drawer, Fab, type ForestCardColor, type ForestChipColor, type ForestChipProps, ForestProvider, type ForestProviderProps, Gauge, IconButton, type IconButtonProps, type IconButtonVariant, LineChart, type LineChartProps, Logo, type LogoProps, MultiSelect, type MultiSelectOption, type MultiSelectProps, Page, type PageBreadcrumb, type PageProps, PieChart, type PieChartProps, Popover, ScatterChart, Search, type SearchProps, Select, SidebarItem, type SidebarItemProps, SidebarNav, type SidebarNavProps, ToggleButton, type ToggleButtonProps, Tooltip, useChartColors, useSidebar };
+export { AppBarNavItem, type AppBarNavItemProps, AppShell, type AppShellNavItem, type AppShellProps, BarChart, type BarChartProps, Button, ButtonGroup, type ButtonProps, Card, type CardProps, Chip, DatePicker, type DatePickerProps, Drawer, Fab, type ForestCardColor, type ForestChipColor, type ForestChipProps, ForestProvider, type ForestProviderProps, Gauge, IconButton, type IconButtonProps, type IconButtonVariant, LineChart, type LineChartProps, Logo, type LogoProps, MultiSelect, type MultiSelectOption, type MultiSelectProps, Page, type PageBreadcrumb, type PageProps, PieChart, type PieChartProps, Popover, ScatterChart, Search, type SearchProps, Select, SidebarItem, type SidebarItemProps, SidebarNav, type SidebarNavProps, ToggleButton, ToggleButtonGroup, type ToggleButtonGroupProps, type ToggleButtonProps, type ToggleButtonVariant, Tooltip, useChartColors, useSidebar };