@telicent-oss/ds 4.3.0 → 4.4.0

package/dist/export.d.ts

@@ -6,6 +6,7 @@ import { AccordionProps } from '@mui/material/Accordion';
 import { AccordionSummaryClasses } from '@mui/material';
 import { AccordionSummaryProps } from '@mui/material/AccordionSummary';
 import { AccordionSummaryProps as AccordionSummaryProps_2 } from '@mui/material';
+import { AdapterDayjs } from '@mui/x-date-pickers/AdapterDayjs';
 import { default as Alert } from '@mui/material/Alert';
 import { AlertClasses } from '@mui/material';
 import { AlertColor } from '@mui/material/Alert';
@@ -67,11 +68,13 @@ import { closeSnackbar } from 'notistack';
 import { CollapseClasses } from '@mui/material';
 import { CollapseProps } from '@mui/material';
 import { CommonProps } from '@mui/material/OverridableComponent';
+import { ComponentProps } from 'react';
 import { ComponentsProps } from '@mui/material';
 import { ContainerClasses } from '@mui/material';
 import { ContainerProps } from '@mui/material';
 import { Context } from 'react';
 import { Coordinate } from 'ol/coordinate';
+import { DataGrid as DataGrid_2 } from '@mui/x-data-grid';
 import { DatePickerProps as DatePickerProps_2 } from '@mui/x-date-pickers/DatePicker';
 import { DateTimePickerProps as DateTimePickerProps_2 } from '@mui/x-date-pickers/DateTimePicker';
 import { Dayjs } from 'dayjs';
@@ -130,8 +133,13 @@ import { ForwardRefExoticComponent } from 'react';
 import type * as GeoJSON_2 from 'geojson';
 import { Grid2Props } from '@mui/material';
 import { GridClasses } from '@mui/material';
+import { GridClasses as GridClasses_2 } from '@mui/x-data-grid';
+import { GridColDef } from '@mui/x-data-grid';
 import { GridProps } from '@mui/material';
 import { GridProps as GridProps_2 } from '@mui/material/Grid';
+import { GridRenderCellParams } from '@mui/x-data-grid';
+import { GridRowParams } from '@mui/x-data-grid';
+import { GridSortModel } from '@mui/x-data-grid';
 import { HTMLAttributes } from 'react';
 import { IconButtonProps } from '@mui/material/IconButton';
 import { IconButtonTypeMap } from '@mui/material';
@@ -184,6 +192,7 @@ import { ListProps } from '@mui/material';
 import { ListProps as ListProps_2 } from '@mui/material/List';
 import { ListSubheaderClasses } from '@mui/material';
 import { ListSubheaderProps } from '@mui/material';
+import { LocalizationProvider as LocalizationProvider_2 } from '@mui/x-date-pickers/LocalizationProvider';
 import { LocationOn as LocationOnIcon } from '@telicent-oss/mui-icons-material';
 import { Map as Map_2 } from 'ol';
 import { MenuClasses } from '@mui/material';
@@ -224,8 +233,10 @@ import { PropsWithChildren } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { QueryKey } from '@tanstack/react-query';
 import { RadioClasses } from '@mui/material';
-import { RadioGroupProps } from '@mui/material';
-import { RadioProps } from '@mui/material';
+import { RadioGroupProps } from '@mui/material/RadioGroup';
+import { RadioGroupProps as RadioGroupProps_2 } from '@mui/material';
+import { RadioProps as RadioProps_2 } from '@mui/material';
+import { RadioProps as RadioProps_3 } from '@mui/material/Radio';
 import { RatingClasses } from '@mui/material';
 import { RatingProps } from '@mui/material';
 import * as React_2 from 'react';
@@ -283,7 +294,6 @@ import { SwitchProps } from '@mui/material';
 import { SwitchProps as SwitchProps_3 } from '@mui/material/Switch';
 import { SxProps } from '@mui/material';
 import { SxProps as SxProps_2 } from '@mui/material/styles';
-import { TabClasses } from '@mui/material';
 import { TableBodyProps } from '@mui/material/TableBody';
 import { TableBodyProps as TableBodyProps_2 } from '@mui/material';
 import { TableCellClasses } from '@mui/material';
@@ -303,8 +313,8 @@ import { TableRowProps } from '@mui/material/TableRow';
 import { TableRowProps as TableRowProps_2 } from '@mui/material';
 import { TableSortLabelClasses } from '@mui/material';
 import { TableSortLabelProps } from '@mui/material';
-import { TabProps as TabProps_2 } from '@mui/material';
-import { TabProps as TabProps_3 } from '@mui/material/Tab';
+import { TabOwnProps } from '@mui/material';
+import { TabProps as TabProps_2 } from '@mui/material/Tab';
 import { TabsOwnProps } from '@mui/material';
 import { TabsProps as TabsProps_2 } from '@mui/material/Tabs';
 import { TextFieldProps } from '@mui/material';
@@ -312,8 +322,8 @@ import { Theme } from '@mui/material';
 import { Theme as Theme_2 } from '@mui/material/styles';
 import { Theme as Theme_3 } from '@emotion/react';
 import { ToggleButtonClasses } from '@mui/material';
-import { ToggleButtonGroupClasses } from '@mui/material';
-import { ToggleButtonGroupProps } from '@mui/material';
+import { ToggleButtonGroupProps as ToggleButtonGroupProps_2 } from '@mui/material';
+import { ToggleButtonGroupProps as ToggleButtonGroupProps_3 } from '@mui/material/ToggleButtonGroup';
 import { ToggleButtonProps } from '@mui/material/ToggleButton';
 import { ToggleButtonProps as ToggleButtonProps_2 } from '@mui/material';
 import { ToolbarClasses } from '@mui/material';
@@ -341,6 +351,14 @@ declare type AccessibleName = {
     "aria-label"?: never;
 };
 
+declare type AccessibleName_2 = {
+    "aria-label": string;
+    "aria-labelledby"?: never;
+} | {
+    "aria-labelledby": string;
+    "aria-label"?: never;
+};
+
 export declare const Accordion: default_3.FC<AccordionProps>;
 
 export declare const AccordionDetails: default_3.FC<AccordionDetailsProps>;
@@ -353,6 +371,8 @@ export declare const AccordionSummary: default_3.FC<AccordionSummaryProps>;
 
 export { AccordionSummaryProps }
 
+export { AdapterDayjs }
+
 export { Alert }
 
 export { AlertColor }
@@ -800,6 +820,27 @@ declare interface CustomCheckboxProps extends CheckboxProps {
     required?: boolean;
 }
 
+/**
+ * Telicent-themed `DataGrid` — a MUI `x-data-grid` wrapped in a nested
+ * `ThemeProvider` that extends the outer DS theme with Telicent's grid
+ * styling. Palette-token-driven, so light/dark theme switching Just Works.
+ *
+ * Telicent defaults baked in: `autoHeight`, `disableColumnResize`,
+ * `disableRowSelectionOnClick`, `disableColumnMenu`, `pagination: true`,
+ * `pageSizeOptions: [10, 25, 50]`, initial page size 10.
+ *
+ * When `onRowClick` is set, DS opts row hover (`palette.action.hover`) and
+ * the pointer cursor back in — the baked theme suppresses row hover by
+ * default so non-interactive grids don't flicker, so interactive grids need
+ * the opt-in. Callsite `sx` wins (spread last) if a consumer wants a
+ * different hover colour or no hover.
+ */
+export declare const DataGrid: FC<DataGridProps>;
+
+export declare type DataGridProps = {
+    initialSort?: GridSortModel;
+} & ComponentProps<typeof DataGrid_2>;
+
 export declare const DataServiceIcon: default_3.FC<SvgIconProps_2>;
 
 export declare const DataSetIcon: default_3.FC<SvgIconProps_2>;
@@ -1119,10 +1160,10 @@ declare const generateComponentOverrides: (uiTheme: UITheme) => {
     };
     MuiMenuItem: {
         styleOverrides: {
-            root: ({ theme }: MenuItemOwnProps & Omit<ButtonBaseOwnProps, "classes"> & CommonProps & Omit<DetailedHTMLProps<LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "disabled" | "className" | "style" | "classes" | "children" | "sx" | "autoFocus" | "tabIndex" | "disableGutters" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "dense" | "divider" | "selected"> & {
+            root: ({ theme }: MenuItemOwnProps & Omit<ButtonBaseOwnProps, "classes"> & CommonProps & Omit<DetailedHTMLProps<LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "disabled" | "className" | "style" | "classes" | "children" | "sx" | "autoFocus" | "tabIndex" | "disableGutters" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "selected" | "dense" | "divider"> & {
                 component?: ElementType;
             } & Record<string, unknown> & {
-                ownerState: MenuItemOwnProps & Omit<ButtonBaseOwnProps, "classes"> & CommonProps & Omit<DetailedHTMLProps<LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "disabled" | "className" | "style" | "classes" | "children" | "sx" | "autoFocus" | "tabIndex" | "disableGutters" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "dense" | "divider" | "selected"> & {
+                ownerState: MenuItemOwnProps & Omit<ButtonBaseOwnProps, "classes"> & CommonProps & Omit<DetailedHTMLProps<LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "disabled" | "className" | "style" | "classes" | "children" | "sx" | "autoFocus" | "tabIndex" | "disableGutters" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "selected" | "dense" | "divider"> & {
                     component?: ElementType;
                 } & Record<string, unknown>;
             } & {
@@ -1225,6 +1266,64 @@ declare const generateComponentOverrides: (uiTheme: UITheme) => {
     MuiCssBaseline: {
         styleOverrides: (theme: Omit<Theme, "components">) => string;
     };
+    MuiToggleButtonGroup: {
+        styleOverrides: {
+            root: ({ theme }: ToggleButtonGroupProps_2 & Record<string, unknown> & {
+                ownerState: ToggleButtonGroupProps_2 & Record<string, unknown>;
+            } & {
+                theme: Omit<Theme, "components">;
+            }) => {
+                [x: string]: {
+                    width: string;
+                    border: string;
+                    borderRadius: number;
+                    backgroundColor: string;
+                    padding: string;
+                    gap: string;
+                    margin?: undefined;
+                    minHeight?: undefined;
+                    height?: undefined;
+                    minWidth?: undefined;
+                    textTransform?: undefined;
+                    whiteSpace?: undefined;
+                    fontSize?: undefined;
+                    color?: undefined;
+                    "&.Mui-selected, &.Mui-selected:hover"?: undefined;
+                    "& .MuiTouchRipple-root"?: undefined;
+                } | {
+                    border: number;
+                    borderRadius: number;
+                    margin: number;
+                    minHeight: number;
+                    height: number;
+                    minWidth: string;
+                    padding: string;
+                    textTransform: string;
+                    whiteSpace: string;
+                    fontSize: number;
+                    color: string;
+                    "&.Mui-selected, &.Mui-selected:hover": {
+                        backgroundColor: string;
+                        color: string;
+                    };
+                    "& .MuiTouchRipple-root": {
+                        display: string;
+                    };
+                    width?: undefined;
+                    backgroundColor?: undefined;
+                    gap?: undefined;
+                };
+                "&.TelicentPillGroup": {
+                    width: string;
+                    border: string;
+                    borderRadius: number;
+                    backgroundColor: string;
+                    padding: string;
+                    gap: string;
+                };
+            };
+        };
+    };
     MuiTabs: {
         styleOverrides: {
             root: ({ theme }: TabsOwnProps & CommonProps & Omit<DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "value" | "className" | "style" | "classes" | "children" | "sx" | "variant" | "slots" | "slotProps" | "aria-label" | "aria-labelledby" | "onChange" | "action" | "centered" | "scrollButtons" | "allowScrollButtonsMobile" | "indicatorColor" | "orientation" | "ScrollButtonComponent" | "selectionFollowsFocus" | "TabIndicatorProps" | "TabScrollButtonProps" | "textColor" | "visibleScrollbar"> & {
@@ -1241,6 +1340,52 @@ declare const generateComponentOverrides: (uiTheme: UITheme) => {
                     borderBottom: string;
                     borderInlineEnd: string;
                 };
+                "&.TelicentPillGroup": {
+                    width: string;
+                    minHeight: string;
+                    border: string;
+                    borderRadius: number;
+                    backgroundColor: string;
+                    padding: string;
+                    "& .MuiTabs-indicator": {
+                        display: string;
+                    };
+                    "& .MuiTabs-flexContainer": {
+                        gap: string;
+                    };
+                };
+            };
+        };
+    };
+    MuiTab: {
+        styleOverrides: {
+            root: ({ theme }: TabOwnProps & Omit<ButtonBaseOwnProps, "classes"> & CommonProps & Omit<DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "value" | "disabled" | "className" | "style" | "classes" | "children" | "sx" | "label" | "tabIndex" | "icon" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "disableFocusRipple" | "wrapped" | "iconPosition"> & {
+                component?: ElementType;
+            } & Record<string, unknown> & {
+                ownerState: TabOwnProps & Omit<ButtonBaseOwnProps, "classes"> & CommonProps & Omit<DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "value" | "disabled" | "className" | "style" | "classes" | "children" | "sx" | "label" | "tabIndex" | "icon" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "disableFocusRipple" | "wrapped" | "iconPosition"> & {
+                    component?: ElementType;
+                } & Record<string, unknown>;
+            } & {
+                theme: Omit<Theme, "components">;
+            }) => {
+                ".TelicentPillGroup &": {
+                    minHeight: number;
+                    height: number;
+                    minWidth: string;
+                    padding: string;
+                    textTransform: string;
+                    borderRadius: number;
+                    whiteSpace: string;
+                    fontSize: number;
+                    color: string;
+                    "&.Mui-selected": {
+                        backgroundColor: string;
+                        color: string;
+                    };
+                    "& .MuiTouchRipple-root": {
+                        display: string;
+                    };
+                };
             };
         };
     };
@@ -2155,8 +2300,8 @@ declare const generateComponentOverrides: (uiTheme: UITheme) => {
         defaultProps?: ComponentsProps["MuiRadio"];
         styleOverrides?: Partial<OverridesStyleRules<keyof RadioClasses, "MuiRadio", Omit<Theme, "components">>> | undefined;
         variants?: {
-            props: Partial<RadioProps> | ((props: Partial<RadioProps> & {
-                ownerState: Partial<RadioProps>;
+            props: Partial<RadioProps_2> | ((props: Partial<RadioProps_2> & {
+                ownerState: Partial<RadioProps_2>;
             }) => boolean);
             style: Interpolation<    {
             theme: Omit<Theme, "components">;
@@ -2167,8 +2312,8 @@ declare const generateComponentOverrides: (uiTheme: UITheme) => {
         defaultProps?: ComponentsProps["MuiRadioGroup"];
         styleOverrides?: Partial<OverridesStyleRules<keyof FormGroupClasses, "MuiRadioGroup", Omit<Theme, "components">>> | undefined;
         variants?: {
-            props: Partial<RadioGroupProps> | ((props: Partial<RadioGroupProps> & {
-                ownerState: Partial<RadioGroupProps>;
+            props: Partial<RadioGroupProps_2> | ((props: Partial<RadioGroupProps_2> & {
+                ownerState: Partial<RadioGroupProps_2>;
             }) => boolean);
             style: Interpolation<    {
             theme: Omit<Theme, "components">;
@@ -2405,7 +2550,7 @@ declare const generateComponentOverrides: (uiTheme: UITheme) => {
     } | undefined;
     MuiSwipeableDrawer?: {
         defaultProps?: ComponentsProps["MuiSwipeableDrawer"];
-    };
+    } | undefined;
     MuiSwitch?: {
         defaultProps?: ComponentsProps["MuiSwitch"];
         styleOverrides?: Partial<OverridesStyleRules<keyof SwitchClasses, "MuiSwitch", Omit<Theme, "components">>> | undefined;
@@ -2418,18 +2563,6 @@ declare const generateComponentOverrides: (uiTheme: UITheme) => {
             }>;
         }[] | undefined;
     } | undefined;
-    MuiTab?: {
-        defaultProps?: ComponentsProps["MuiTab"];
-        styleOverrides?: Partial<OverridesStyleRules<keyof TabClasses, "MuiTab", Omit<Theme, "components">>> | undefined;
-        variants?: {
-            props: Partial<TabProps_2> | ((props: Partial<TabProps_2> & {
-                ownerState: Partial<TabProps_2>;
-            }) => boolean);
-            style: Interpolation<    {
-            theme: Omit<Theme, "components">;
-            }>;
-        }[] | undefined;
-    } | undefined;
     MuiTable?: {
         defaultProps?: ComponentsProps["MuiTable"];
         styleOverrides?: Partial<OverridesStyleRules<keyof TableClasses, "MuiTable", Omit<Theme, "components">>> | undefined;
@@ -2562,18 +2695,6 @@ declare const generateComponentOverrides: (uiTheme: UITheme) => {
             }>;
         }[] | undefined;
     } | undefined;
-    MuiToggleButtonGroup?: {
-        defaultProps?: ComponentsProps["MuiToggleButtonGroup"];
-        styleOverrides?: Partial<OverridesStyleRules<keyof ToggleButtonGroupClasses, "MuiToggleButtonGroup", Omit<Theme, "components">>> | undefined;
-        variants?: {
-            props: Partial<ToggleButtonGroupProps> | ((props: Partial<ToggleButtonGroupProps> & {
-                ownerState: Partial<ToggleButtonGroupProps>;
-            }) => boolean);
-            style: Interpolation<    {
-            theme: Omit<Theme, "components">;
-            }>;
-        }[] | undefined;
-    } | undefined;
     MuiToolbar?: {
         defaultProps?: ComponentsProps["MuiToolbar"];
         styleOverrides?: Partial<OverridesStyleRules<keyof ToolbarClasses, "MuiToolbar", Omit<Theme, "components">>> | undefined;
@@ -2624,7 +2745,11 @@ declare const generateComponentOverrides: (uiTheme: UITheme) => {
     } | undefined;
     MuiUseMediaQuery?: {
         defaultProps?: ComponentsProps["MuiUseMediaQuery"];
-    };
+    } | undefined;
+    MuiDataGrid?: {
+        defaultProps?: ComponentsProps["MuiDataGrid"];
+        styleOverrides?: Partial<OverridesStyleRules<keyof GridClasses_2, "MuiDataGrid", Omit<Theme, "components">>> | undefined;
+    } | undefined;
 };
 
 export declare const getCodec: (mode?: ENCODE_SEARCH_PARAMS_MODES_Type) => Codec;
@@ -2637,8 +2762,16 @@ export declare const GRAPH_APP: {
     };
 };
 
+export { GridColDef }
+
 export declare const GridIcon: default_3.FC<SvgIconProps>;
 
+export { GridRenderCellParams }
+
+export { GridRowParams }
+
+export { GridSortModel }
+
 export declare const H1: default_3.FC<HeadingProps>;
 
 export declare const H2: default_3.FC<HeadingProps>;
@@ -2771,6 +2904,12 @@ export declare const ListItemText: default_3.FC<ListItemTextProps_2>;
 declare interface ListItemTextProps_2 extends Omit<ListItemTextProps_3, "primaryTypographyProps" | "secondaryTypographyProps" | "sx"> {
 }
 
+export declare const LocalizationProvider: default_3.FC<LocalizationProviderProps>;
+
+export declare type LocalizationProviderProps = Omit<MuiProps, "dateAdapter"> & {
+    dateAdapter?: MuiProps["dateAdapter"];
+};
+
 export { LocationOnIcon }
 
 /**
@@ -3031,6 +3170,8 @@ declare type MUIAutocompleteProps<Option> = AutocompleteProps<Option, false, fal
 
 declare type MuiMultiplePassthrough = Omit<AutocompleteProps_2<Option_2, true, false, false>, "options" | "value" | "onChange" | "renderInput" | "multiple" | "disabled" | "size">;
 
+declare type MuiProps = ComponentProps<typeof LocalizationProvider_2>;
+
 declare type MuiSinglePassthrough = Omit<AutocompleteProps_2<Option_2, false, false, false>, "options" | "value" | "onChange" | "renderInput" | "multiple" | "disabled" | "size">;
 
 declare type MultipleAutoCompleteProps = MultipleProps & MuiMultiplePassthrough;
@@ -3254,6 +3395,17 @@ declare interface ProgressProps extends Omit<CircularProgressProps_2, "classes"
 
 export declare const QuestionIcon: default_3.FC<SvgIconProps>;
 
+export declare const Radio: ForwardRefExoticComponent<Omit<RadioProps, "ref"> & RefAttributes<HTMLButtonElement>>;
+
+export declare const RadioGroup: default_3.FC<RadioGroupProps>;
+
+export { RadioGroupProps }
+
+export declare type RadioProps = Omit<RadioProps_3, "color"> & {
+    label?: React.ReactNode;
+    labelPlacement?: "end" | "start" | "top" | "bottom";
+};
+
 export declare const RecentSearches: default_3.FC<RecentSearchProps>;
 
 declare type RecentSearchProps = Partial<{
@@ -3753,7 +3905,7 @@ export declare type TabPanelProps = Omit<default_3.HTMLAttributes<HTMLDivElement
     keepMounted?: boolean;
 };
 
-export declare type TabProps = Omit<TabProps_3, "value"> & {
+export declare type TabProps = Omit<TabProps_2, "value"> & {
     /**
      * Required, where MUI falls back to the child's index, and narrowed to
      * `string | number` because it becomes part of a DOM id.
@@ -3771,6 +3923,15 @@ export declare const Tabs: default_3.ForwardRefExoticComponent<(Omit<Omit<TabsPr
      * page, and repeated on this group's `TabPanel`s.
      */
     idPrefix: string;
+    /**
+     * Render as a pill group: a bordered well hugging its tabs, the
+     * selected tab filled, and no underline indicator.
+     *
+     * A boolean rather than a `variant` value — MUI's `Tabs` already owns
+     * `variant` for `standard | scrollable | fullWidth`, and MUI v5's
+     * theme `variants` support does not cover `MuiTabs`.
+     */
+    pill?: boolean;
 }, "ref"> | Omit<Omit<TabsProps_2, "aria-label" | "aria-labelledby"> & {
     "aria-labelledby": string;
     "aria-label"?: never;
@@ -3781,15 +3942,33 @@ export declare const Tabs: default_3.ForwardRefExoticComponent<(Omit<Omit<TabsPr
      * page, and repeated on this group's `TabPanel`s.
      */
     idPrefix: string;
+    /**
+     * Render as a pill group: a bordered well hugging its tabs, the
+     * selected tab filled, and no underline indicator.
+     *
+     * A boolean rather than a `variant` value — MUI's `Tabs` already owns
+     * `variant` for `standard | scrollable | fullWidth`, and MUI v5's
+     * theme `variants` support does not cover `MuiTabs`.
+     */
+    pill?: boolean;
 }, "ref">) & default_3.RefAttributes<HTMLDivElement>>;
 
-export declare type TabsProps = Omit<TabsProps_2, "aria-label" | "aria-labelledby"> & AccessibleName & {
+export declare type TabsProps = Omit<TabsProps_2, "aria-label" | "aria-labelledby"> & AccessibleName_2 & {
     /**
      * Namespace for the `id` / `aria-controls` / `aria-labelledby` triple the
      * DS wires between each `Tab` and its `TabPanel`. Unique per tab set on the
      * page, and repeated on this group's `TabPanel`s.
      */
     idPrefix: string;
+    /**
+     * Render as a pill group: a bordered well hugging its tabs, the
+     * selected tab filled, and no underline indicator.
+     *
+     * A boolean rather than a `variant` value — MUI's `Tabs` already owns
+     * `variant` for `standard | scrollable | fullWidth`, and MUI v5's
+     * theme `variants` support does not cover `MuiTabs`.
+     */
+    pill?: boolean;
 };
 
 declare type TabValue = string | number;
@@ -3858,6 +4037,37 @@ declare interface TitleAndContentProps {
 
 export declare const ToggleButton: default_3.FC<ToggleButtonProps>;
 
+export declare const ToggleButtonGroup: default_3.ForwardRefExoticComponent<(Omit<Omit<ToggleButtonGroupProps_3, "aria-label" | "aria-labelledby"> & {
+    "aria-label": string;
+    "aria-labelledby"?: never;
+} & {
+    /**
+     * Render as a pill group: a bordered well hugging its buttons, with
+     * the selected one filled. Without it the group renders MUI's
+     * default squared-off segments.
+     */
+    pill?: boolean;
+}, "ref"> | Omit<Omit<ToggleButtonGroupProps_3, "aria-label" | "aria-labelledby"> & {
+    "aria-labelledby": string;
+    "aria-label"?: never;
+} & {
+    /**
+     * Render as a pill group: a bordered well hugging its buttons, with
+     * the selected one filled. Without it the group renders MUI's
+     * default squared-off segments.
+     */
+    pill?: boolean;
+}, "ref">) & default_3.RefAttributes<HTMLDivElement>>;
+
+export declare type ToggleButtonGroupProps = Omit<ToggleButtonGroupProps_3, "aria-label" | "aria-labelledby"> & AccessibleName & {
+    /**
+     * Render as a pill group: a bordered well hugging its buttons, with
+     * the selected one filled. Without it the group renders MUI's
+     * default squared-off segments.
+     */
+    pill?: boolean;
+};
+
 export { ToggleButtonProps }
 
 export declare type ToggleFn = (id: string) => void;

package/dist/llms.txt

@@ -1,6 +1,6 @@
 # Telicent DS Component Manifest
 
-**VERSION:** This file documents @telicent-oss/ds v4.3.0. It shipped inside that package, so it matches the version installed in your project. If that package was built locally rather than installed from npm, the code may be newer than v4.3.0.
+**VERSION:** This file documents @telicent-oss/ds v4.4.0. It shipped inside that package, so it matches the version installed in your project. If that package was built locally rather than installed from npm, the code may be newer than v4.4.0.
 
 > `@telicent-oss/ds` is Telicent's MUI-based React component library. This file is the complete, self-contained reference: setup, theming, every exported component, and copy-paste recipes. An agent that fetches it has what it needs to build a Telicent app UI without reading the source.
 
@@ -310,12 +310,13 @@ Usage: https://github.com/telicent-oss/telicent-ds/blob/main/src/components/surf
 Demonstrated states:
 - Example
 
-* **`Tabs` / `Tab` / `TabPanel`**: Switch between views of the same region. Give `Tabs` an `idPrefix` and an accessible name (the type requires one of `aria-label` / `aria-labelledby`), give each `Tab` an explicit `value`, and repeat the same `idPrefix` on each `TabPanel` — the DS derives every `id`, `aria-controls`, and `aria-labelledby` from those two things, so there is no `a11yProps` helper to write. Panels unmount their children when hidden; pass `keepMounted` to preserve form state across switches. The divider under the tab bar comes from the theme — do not wrap `Tabs` in a bordered `Box`. Padding inside a panel is yours to set.
+* **`Tabs` / `Tab` / `TabPanel`**: Switch between views of the same region. Give `Tabs` an `idPrefix` and an accessible name (the type requires one of `aria-label` / `aria-labelledby`), give each `Tab` an explicit `value`, and repeat the same `idPrefix` on each `TabPanel` — the DS derives every `id`, `aria-controls`, and `aria-labelledby` from those two things, so there is no `a11yProps` helper to write. Panels unmount their children when hidden; pass `keepMounted` to preserve form state across switches. The divider under the tab bar comes from the theme — do not wrap `Tabs` in a bordered `Box`. Padding inside a panel is yours to set. Pass `pill` for the Telicent pill treatment (same shape as `ToggleButtonGroup`'s pill); the tablist role, roving tabindex and derived ids are unchanged.
 ```yaml
 Tabs:
   'aria-label': {type: 'string', required: false}
   'aria-labelledby': {type: 'string', required: false}
   idPrefix: {type: 'string', required: true}
+  pill: {type: 'boolean', required: false}
 ```
 ```yaml
 Tab:
@@ -338,6 +339,7 @@ Demonstrated states:
 - Scrollable
 - WithIcons
 - KeepMounted
+- Pill
 
 ## 3. Inputs & Forms
 *Use these instead of standard `<input>`, `<select>`, or `<textarea>` tags. Ensure accessibility labels are passed.*
@@ -514,6 +516,41 @@ Demonstrated states:
 - Required — checked=false, id="switch-required", label="Required setting", required=true
 - NoLabel — checked=true, id="switch-no-label"
 - ExampleWithOnChange — disabled=false
+* **`Radio` / `RadioGroup`**: Mutually-exclusive choice between several options (wraps MUI Radio / RadioGroup). `label` on `Radio` collapses the `FormControlLabel` wrap; `color="primary"` is baked (not overridable). Use `RadioGroup` with `value`/`onChange` to own the selection; use standalone `Radio` only when a `Switch` would be semantically wrong.
+```yaml
+Radio:
+  label: {type: 'React.ReactNode', required: false}
+  labelPlacement: {type: '"bottom" | "top" | "end" | "start"', required: false}
+```
+Live: https://telicent-oss.github.io/telicent-ds/?path=/docs/inputs-radio--docs
+Usage: https://github.com/telicent-oss/telicent-ds/blob/main/src/components/inputs/Radio/Radio.stories.tsx
+
+Demonstrated states:
+- Default — id="radio-default", value="option-a"
+- WithLabel — id="radio-with-label", value="option-a", label="Full backup", defaultChecked=true
+- Disabled — id="radio-disabled", value="option-a", label="Not available", disabled=true
+- InsideRadioGroup
+Live: https://telicent-oss.github.io/telicent-ds/?path=/docs/inputs-radiogroup--docs
+Usage: https://github.com/telicent-oss/telicent-ds/blob/main/src/components/inputs/RadioGroup/RadioGroup.stories.tsx
+
+Demonstrated states:
+- Column
+- Row
+* **`ToggleButtonGroup`**: Use for a small set of mutually exclusive views or modes where both options should stay visible. Pass `pill` for the Telicent pill treatment. Reach for `Tabs` instead when the buttons select a panel.
+```yaml
+ToggleButtonGroup:
+  'aria-label': {type: 'string', required: false}
+  'aria-labelledby': {type: 'string', required: false}
+  pill: {type: 'boolean', required: false}
+```
+Live: https://telicent-oss.github.io/telicent-ds/?path=/docs/inputs-togglebuttongroup--docs
+Usage: https://github.com/telicent-oss/telicent-ds/blob/main/src/components/inputs/ToggleButtonGroup/ToggleButtonGroup.stories.tsx
+
+Demonstrated states:
+- Pill
+- Default
+- WithLabelledBy
+- DeselectHazard
 * **`DatePicker` / `DateTimePicker`**: Use for any temporal inputs.
 ```yaml
 DatePicker:
@@ -522,10 +559,10 @@ DatePicker:
   fullWidth: {type: 'boolean', required: false}
   helperText: {type: 'string', required: false}
   label: {type: 'ReactNode & string', required: false}
-  maxDate: {type: 'PickerValidDate', required: false}
-  minDate: {type: 'PickerValidDate', required: false}
+  maxDate: {type: 'Dayjs', required: false}
+  minDate: {type: 'Dayjs', required: false}
   textFieldProps: {type: 'TextFieldProps', required: false}
-  value: {type: 'Dayjs | null', required: true}
+  value: {type: 'Dayjs', required: true}
 ```
 ```yaml
 DateTimePicker:
@@ -533,8 +570,8 @@ DateTimePicker:
   errorMsg: {type: 'string', required: false}
   fullWidth: {type: 'boolean', required: false}
   helperText: {type: 'string', required: false}
-  maxDateTime: {type: 'PickerValidDate', required: false}
-  minDateTime: {type: 'PickerValidDate', required: false}
+  maxDateTime: {type: 'Dayjs', required: false}
+  minDateTime: {type: 'Dayjs', required: false}
   textFieldProps: {type: 'TextFieldProps', required: false}
 ```
 Live: https://telicent-oss.github.io/telicent-ds/?path=/docs/inputs-datepicker--docs
@@ -551,6 +588,16 @@ Demonstrated states:
 - Default — label="Pick date & time"
 - ErrorState — label="Required field", error=true, errorMsg="Something went wrong", helperText="Date and time are required"
 - WithDateRestrictions — label="Restricted time range", helperText="Only available within the next 48 hours"
+* **`LocalizationProvider` / `AdapterDayjs`**: Root-level provider for `DatePicker` / `DateTimePicker`. Mount once at the app root — the dayjs adapter is pre-wired, so a bare `<LocalizationProvider>` is enough. `AdapterDayjs` is re-exported for apps that want to pass it explicitly or use it outside the provider.
+```yaml
+LocalizationProvider:
+  dateAdapter: {type: 'new (...args: any) => MuiPickersAdapter<unknown>', required: false}
+```
+Live: https://telicent-oss.github.io/telicent-ds/?path=/docs/inputs-localizationprovider--docs
+Usage: https://github.com/telicent-oss/telicent-ds/blob/main/src/components/inputs/LocalizationProvider/LocalizationProvider.stories.tsx
+
+Demonstrated states:
+- WrappingADatePicker
 
 ## 4. Data Display & Typography
 *Use these to render text and structured data.*
@@ -610,6 +657,21 @@ Demonstrated states:
 - Outlined — variant="outlined"
 - ClickableChips
 - DeletableChips
+* **`DataGrid`**: Tabular data with pagination, sorting, and themed styling (wraps MUI X `DataGrid`). DS bakes `autoHeight`, `disableColumnResize`, `disableRowSelectionOnClick`, `disableColumnMenu`, `pagination`, `pageSizeOptions=[10, 25, 50]`, and initial `pageSize=10`. Row hover is suppressed by default; when `onRowClick` is set, the DS auto-opts `cursor: "pointer"` + `palette.action.hover` back in so interactive grids read as interactive with zero `sx` at the callsite. A nested `ThemeProvider` scopes the palette-driven grid overrides so Paper / MenuItem / IconButton / TablePagination styling inside the grid doesn't leak globally. DS re-exports `GridColDef`, `GridRenderCellParams`, `GridRowParams`, `GridSortModel`. `initialSort` is a DS convenience prop that maps to `initialState.sorting.sortModel`.
+```yaml
+DataGrid:
+  initialSort: {type: 'GridSortModel', required: false}
+```
+Live: https://telicent-oss.github.io/telicent-ds/?path=/docs/data-display-datagrid--docs
+Usage: https://github.com/telicent-oss/telicent-ds/blob/main/src/components/data-display/DataGrid/DataGrid.stories.tsx
+
+Demonstrated states:
+- Default — columns=basicColumns
+- WithInitialSort — columns=basicColumns, initialSort=[…]
+- WithCustomCellRenderer
+- ClickableRows
+- Loading — columns=basicColumns, loading=true
+- Empty — rows=[…], columns=basicColumns
 * **`Divider`**: Use to separate content sections instead of `<hr>`.
 Live: https://telicent-oss.github.io/telicent-ds/?path=/docs/data-display-divider--docs
 Usage: https://github.com/telicent-oss/telicent-ds/blob/main/src/components/data-display/Divider/Divider.stories.tsx
@@ -944,4 +1006,4 @@ ThemeSwitchRow:
 - Live examples (Storybook): https://telicent-oss.github.io/telicent-ds/
 - Source and issues: https://github.com/telicent-oss/telicent-ds
 
-This reference documents @telicent-oss/ds v4.3.0.
+This reference documents @telicent-oss/ds v4.4.0.