@cere/cere-design-system 0.0.37 → 0.0.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1,8 +1,8 @@
1
- import { Theme } from '@mui/material/styles';
1
+ import { Theme, SxProps } from '@mui/material/styles';
2
2
  import * as react_jsx_runtime from 'react/jsx-runtime';
3
3
  import { LottieComponentProps } from 'lottie-react';
4
4
  import * as React$1 from 'react';
5
- import React__default, { ReactNode, Ref, PropsWithChildren, ReactElement, AriaAttributes } from 'react';
5
+ import React__default, { RefObject, ReactNode, Ref, PropsWithChildren, ReactElement, Key, AriaAttributes } from 'react';
6
6
  import { ButtonProps as ButtonProps$1 } from '@mui/material/Button';
7
7
  import { IconButtonProps as IconButtonProps$1 } from '@mui/material/IconButton';
8
8
  import { LoadingButtonProps as LoadingButtonProps$1 } from '@mui/lab';
@@ -25,6 +25,7 @@ import { CardProps as CardProps$1 } from '@mui/material/Card';
25
25
  import { CardContentProps } from '@mui/material/CardContent';
26
26
  import { CardHeaderProps } from '@mui/material/CardHeader';
27
27
  import { CardActionsProps } from '@mui/material/CardActions';
28
+ import { CardMediaProps as CardMediaProps$1 } from '@mui/material/CardMedia';
28
29
  import { AvatarProps as AvatarProps$1 } from '@mui/material/Avatar';
29
30
  import { BreadcrumbsProps as BreadcrumbsProps$1 } from '@mui/material/Breadcrumbs';
30
31
  import { PaperProps as PaperProps$1 } from '@mui/material/Paper';
@@ -454,12 +455,35 @@ interface TextFieldProps extends Omit<TextFieldProps$1, 'size'> {
454
455
  }
455
456
  declare const TextField: React__default.FC<TextFieldProps>;
456
457
 
457
- interface SearchFieldProps extends Omit<TextFieldProps, 'InputProps'> {
458
+ type SearchFieldVariant = 'standard' | 'pill';
459
+ interface SearchFieldProps extends Omit<TextFieldProps, 'InputProps' | 'variant'> {
458
460
  placeholder?: string;
461
+ /** Fires with the next input value on every change. */
459
462
  onSearch?: (value: string) => void;
463
+ /** Visual treatment. `pill` renders a fully-rounded input. @default 'standard' */
464
+ variant?: SearchFieldVariant;
465
+ /**
466
+ * Show a keyboard-shortcut hint adornment (⌘K on Mac, Ctrl+K elsewhere) at
467
+ * the right edge. Pair with `useSearchHotkeys` to wire the key handler.
468
+ */
469
+ shortcutHint?: boolean;
460
470
  }
461
471
  declare const SearchField: React__default.FC<SearchFieldProps>;
462
472
 
473
+ interface UseSearchHotkeysOptions {
474
+ /** Cmd/Ctrl + K focuses the ref. @default true */
475
+ k?: boolean;
476
+ /** `/` (when not already typing in another field) focuses the ref. @default true */
477
+ slash?: boolean;
478
+ }
479
+ /**
480
+ * Wire global Cmd+K (Mac) / Ctrl+K (everywhere else) and `/` hotkeys to focus
481
+ * the input pointed to by `inputRef`. The `/` hotkey is suppressed while the
482
+ * user is typing in another input, textarea or contentEditable element so it
483
+ * doesn't hijack normal typing. Either hotkey can be disabled via options.
484
+ */
485
+ declare function useSearchHotkeys(inputRef: RefObject<HTMLInputElement | null>, options?: UseSearchHotkeysOptions): void;
486
+
463
487
  type ToggleButtonProps = ToggleButtonProps$1;
464
488
  declare const ToggleButton: React__default.FC<ToggleButtonProps>;
465
489
  type ToggleButtonGroupProps = ToggleButtonGroupProps$1;
@@ -1711,6 +1735,117 @@ interface ScrollableRowProps {
1711
1735
  */
1712
1736
  declare const ScrollableRow: React__default.FC<ScrollableRowProps>;
1713
1737
 
1738
+ interface CarouselProps<T> {
1739
+ /** Slide data. Each entry is passed to `renderSlide`. */
1740
+ slides: T[];
1741
+ /** Render function for an individual slide. */
1742
+ renderSlide: (item: T, index: number) => ReactNode;
1743
+ /**
1744
+ * Stable per-slide React key. Always set this when `slides` can be reordered
1745
+ * or filtered; otherwise React will reuse the wrong slide's internal state
1746
+ * across renders. Defaults to the slide's array index when omitted.
1747
+ */
1748
+ getKey?: (item: T, index: number) => Key;
1749
+ /** Slides visible in the viewport. @default 1 */
1750
+ slidesPerView?: number;
1751
+ /** Auto-advance every `autoplayDelayMs` while not hovered. @default true */
1752
+ autoplay?: boolean;
1753
+ /** Autoplay tick in milliseconds. @default 5000 */
1754
+ autoplayDelayMs?: number;
1755
+ /** Show dot indicators when more than one slide. @default true */
1756
+ showDots?: boolean;
1757
+ /** Show the `01 / 03`-style counter when more than one slide. @default true */
1758
+ showCounter?: boolean;
1759
+ /** Show prev/next chevrons when more than one slide. @default true */
1760
+ showArrows?: boolean;
1761
+ /** Pause autoplay while the pointer is over the carousel. @default true */
1762
+ pauseOnHover?: boolean;
1763
+ /** Accessible label for the surrounding region. */
1764
+ ariaLabel?: string;
1765
+ /** Fires with the new index whenever embla selects a slide. */
1766
+ onSelect?: (index: number) => void;
1767
+ /** Override the IconButton sx for the prev/next arrows. */
1768
+ arrowSx?: SxProps<Theme>;
1769
+ /** Override the dot color (inactive). Accepts any CSS color string. */
1770
+ dotColor?: string;
1771
+ /** Override the active dot color. Accepts any CSS color string. */
1772
+ dotActiveColor?: string;
1773
+ }
1774
+ /**
1775
+ * Carousel — embla-carousel-based slide deck with autoplay, dots, counter,
1776
+ * prev/next arrows and pause-on-hover. Generic over slide payload type; the
1777
+ * caller decides the slide markup via `renderSlide`.
1778
+ */
1779
+ declare function Carousel<T>({ slides, renderSlide, getKey, slidesPerView, autoplay, autoplayDelayMs, showDots, showCounter, showArrows, pauseOnHover, ariaLabel, onSelect, arrowSx, dotColor, dotActiveColor, }: CarouselProps<T>): react_jsx_runtime.JSX.Element | null;
1780
+
1781
+ interface DefinitionRowProps {
1782
+ /** Optional leading icon (e.g. a scope or category glyph). */
1783
+ icon?: ReactNode;
1784
+ /** Primary label rendered on the left side. */
1785
+ label: ReactNode;
1786
+ /** Optional secondary line under the label (e.g. type, scope path). */
1787
+ sublabel?: ReactNode;
1788
+ /** Primary right-side content (e.g. `read`, `optional`). */
1789
+ value?: ReactNode;
1790
+ /** Secondary right-side line under the value (e.g. constraint, default). */
1791
+ hint?: ReactNode;
1792
+ /** Reduce vertical padding for compact lists. */
1793
+ dense?: boolean;
1794
+ /** Draw a bottom divider. The last row in a list never draws. @default true */
1795
+ divider?: boolean;
1796
+ }
1797
+ /**
1798
+ * DefinitionRow — `icon · label / sublabel … value / hint` row primitive
1799
+ * for description-list style content (scope tables, settings, key/value
1800
+ * panels).
1801
+ */
1802
+ declare function DefinitionRow({ icon, label, sublabel, value, hint, dense, divider, }: DefinitionRowProps): react_jsx_runtime.JSX.Element;
1803
+
1804
+ type PanelDialogWidth = 'sm' | 'md' | 'lg' | 'xl';
1805
+ type PanelDialogSide = 'right' | 'center';
1806
+ type PanelDialogTransition = 'fade' | 'slide-up' | 'slide-left';
1807
+ interface PanelDialogProps {
1808
+ /** Controls visibility. */
1809
+ open: boolean;
1810
+ /** Fires when the user closes (close button, backdrop click, ESC). */
1811
+ onClose: () => void;
1812
+ /** Optional title rendered in the header. Used as the dialog accessible name when a string. */
1813
+ title?: ReactNode;
1814
+ /** Optional right-aligned slot in the header (e.g. install + share buttons). */
1815
+ headerActions?: ReactNode;
1816
+ /** Panel width. @default 'md' */
1817
+ width?: PanelDialogWidth;
1818
+ /** Where the panel docks. `right` slides in from the right edge; `center` is a regular centered panel. @default 'right' */
1819
+ side?: PanelDialogSide;
1820
+ /** Override the accessible name when `title` is not a string. */
1821
+ ariaLabel?: string;
1822
+ /**
1823
+ * Drop the header bar entirely (no title row, no border). The close button
1824
+ * still renders but floats absolute over the top-right of the body. Use when
1825
+ * the body content has its own hero / chrome.
1826
+ */
1827
+ hideHeader?: boolean;
1828
+ /** Style overrides on the dialog paper (border-radius, shadow, width tweaks). */
1829
+ paperSx?: SxProps<Theme>;
1830
+ /** Style overrides on the modal backdrop (e.g. tint, blur). */
1831
+ backdropSx?: SxProps<Theme>;
1832
+ /**
1833
+ * Entry transition. Defaults to `slide-left` for `side='right'` and `fade`
1834
+ * for `side='center'`.
1835
+ */
1836
+ transition?: PanelDialogTransition;
1837
+ /** Body content. */
1838
+ children: ReactNode;
1839
+ }
1840
+ /**
1841
+ * PanelDialog — a right-anchored (or centered) slide-in panel for detail
1842
+ * views, inspectors, and side sheets. Built on MUI Dialog; focus trap and
1843
+ * ESC-to-close come from MUI. Use Dialog for centered modal-with-Save/Cancel.
1844
+ */
1845
+ declare function PanelDialog({ open, onClose, title, headerActions, width, side, ariaLabel, hideHeader, paperSx, backdropSx, transition, children, }: PanelDialogProps): react_jsx_runtime.JSX.Element;
1846
+
1847
+ type CardMediaProps = CardMediaProps$1;
1848
+ declare const CardMedia: React__default.FC<CardMediaProps>;
1714
1849
  interface CardProps extends CardProps$1 {
1715
1850
  hoverable?: boolean;
1716
1851
  clickable?: boolean;
@@ -3136,4 +3271,4 @@ interface CodeEditorWorkspaceProps extends Pick<UseCodeEditorWorkspaceOptions, '
3136
3271
  */
3137
3272
  declare const CodeEditorWorkspace: React__default.FC<CodeEditorWorkspaceProps>;
3138
3273
 
3139
- export { Accordion, type AccordionProps, AccountSection, type AccountSectionProps, ActivityAppIcon, Alert, type AlertProps, type AlertSeverity, AppBar, type AppBarProps, AppLoading, type AppLoadingProps, Avatar, AvatarIcon, type AvatarProps, Badge, type BadgeProps, BarTrackingIcon, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, BytesSize, type BytesSizeProps, Card, CardActions, CardContent, CardHeader, type CardProps, CereIcon, ChartWidget, type ChartWidgetProps, CheckMarkAnimation, Checkbox, type CheckboxProps, Chip, type ChipProps, type ChipVariant, type ChipVariantStyles, CircularProgress, type CircularProgressProps, ClockIcon, CloudFlashIcon, CodeEditor, type CodeEditorFile, CodeEditorFileTree, type CodeEditorFileTreeProps, type CodeEditorLanguage, type CodeEditorProps, CodeEditorStatusBar, type CodeEditorStatusBarItem, type CodeEditorStatusBarProps, type CodeEditorStatusBarRenderProps, type CodeEditorTab, type CodeEditorTabRenderProps, CodeEditorTabs, type CodeEditorTabsProps, CodeEditorWelcomeScreen, type CodeEditorWelcomeScreenProps, CodeEditorWorkspace, type CodeEditorWorkspaceProps, Collapse, type CollapseProps, ConnectionStatus, type ConnectionStatusProps, type ContextMenuItem, CopyChip, type CopyChipProps, type DataPoint, type DataSeries, DateRangePicker, type DateRangePickerProps, DecentralizedServerIcon, type DeploymentCardAction, DeploymentDashboardCard, type DeploymentDashboardCardProps, DeploymentDashboardPanel, type DeploymentDashboardPanelProps, DeploymentDashboardTree, type DeploymentDashboardTreeProps, DeploymentEntityContextMenu, type DeploymentEntityContextMenuProps, type DeploymentEntityType, type DeploymentStatusIndicator, type DeploymentTreeNode, Dialog, type DialogProps, DiscordIcon, Divider, type DividerProps, DownloadIcon, Drawer, type DrawerProps, type DrawerWidth, type DrawerWidthValue, Dropdown, DropdownAnchor, type DropdownAnchorProps, type DropdownProps, EXTENSION_LANGUAGE_MAP, EmptyState, type EmptyStateProps, EntityHeader, type EntityHeaderProps, type FileTreeNode, type FileTreeNodeRenderProps, FilledFolderIcon, FlowEditor, type FlowEditorProps, FolderIcon, type GitInfo, GithubLogoIcon, IDBlock, type IDBlockProps, IconButton, type IconButtonProps, LeftArrowIcon, Link, type LinkProps, List, ListItem, type ListItemProps, type ListProps, Loading, LoadingAnimation, type LoadingAnimationProps, LoadingButton, type LoadingButtonProps, type LoadingProps, Logo, type LogoProps, Markdown, type MarkdownProps, Menu, MenuItem, type MenuItemProps, type MenuProps, MetaField, type MetaFieldProps, MetricsChart, type MetricsChartProps, type MetricsPeriod, NavigationItem, type NavigationItemProps, NavigationList, type NavigationListProps, OnboardingProvider, Pagination, type PaginationProps, Paper, type PaperProps, PeriodSelect, type PrimaryAction, Progress, type ProgressProps, QRCode, type QRCodeProps, Radio, type RadioProps, type ResponsiveDrawerWidth, RightArrowIcon, RoleBadge, type RoleBadgeColor, type RoleBadgeProps, type RoleBadgeSize, ScrollableRow, type ScrollableRowProps, SearchField, type SearchFieldProps, Selector, type SelectorOption, type SelectorProps, type Service, ServiceSelectorButton, type ServiceSelectorButtonProps, ShareIcon, SideNav, SideNavHeader, type SideNavHeaderProps, type SideNavProps, Sidebar, SidebarItem, type SidebarItemProps, type SidebarProps, Snackbar, type SnackbarProps, StatusDot, type StatusDotProps, type StatusDotStatus, Step, StepButton, type StepButtonProps, StepContent, type StepContentProps, StepLabel, type StepLabelProps, type StepProps, Stepper, type StepperProps, StorageAppIcon, type SummaryItem, SummaryStats, type SummaryStatsProps, Switch, type SwitchProps, Tab, type TabProps, Table, TableHeader, type TableHeaderProps, type TableProps, TextField, type TextFieldProps, type TimeRangeOption, TimeRangeSelect, type TimeRangeSelectProps, TimeSeriesGraph, type TimeSeriesGraphProps, ToggleButton, ToggleButtonGroup, type ToggleButtonGroupProps, type ToggleButtonProps, Tooltip, type TooltipProps, Truncate, type TruncateProps, UploadFileIcon, UploadFolderIcon, type UseCodeEditorWorkspaceOptions, type UseCodeEditorWorkspaceReturn, type UserInfo, WORKFLOW_NODE_LABELS, WORKFLOW_NODE_SHADOW, WorkflowNode, type WorkflowNodeData, WorkflowNodeHandle, type WorkflowNodeProps, type WorkflowNodeType, WorkflowSideInspector, type WorkflowSideInspectorProps, WorkflowTimeBar, type WorkflowTimeBarProps, WorkflowTopBar, type WorkflowTopBarProps, type Workspace, WorkspaceSelectorButton, type WorkspaceSelectorButtonProps, colors, contextMenuItems, detectLanguage, getChipVariantStyles, getFileName, resolveDrawerWidth, robPaletteExtended, robPrimaryPalette, theme, useCodeEditorWorkspace, useIsDesktop, useIsMobile, useIsTablet, useOnboarding, workflowConnectionColors, workflowNodeColors };
3274
+ export { Accordion, type AccordionProps, AccountSection, type AccountSectionProps, ActivityAppIcon, Alert, type AlertProps, type AlertSeverity, AppBar, type AppBarProps, AppLoading, type AppLoadingProps, Avatar, AvatarIcon, type AvatarProps, Badge, type BadgeProps, BarTrackingIcon, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, BytesSize, type BytesSizeProps, Card, CardActions, CardContent, CardHeader, CardMedia, type CardMediaProps, type CardProps, Carousel, type CarouselProps, CereIcon, ChartWidget, type ChartWidgetProps, CheckMarkAnimation, Checkbox, type CheckboxProps, Chip, type ChipProps, type ChipVariant, type ChipVariantStyles, CircularProgress, type CircularProgressProps, ClockIcon, CloudFlashIcon, CodeEditor, type CodeEditorFile, CodeEditorFileTree, type CodeEditorFileTreeProps, type CodeEditorLanguage, type CodeEditorProps, CodeEditorStatusBar, type CodeEditorStatusBarItem, type CodeEditorStatusBarProps, type CodeEditorStatusBarRenderProps, type CodeEditorTab, type CodeEditorTabRenderProps, CodeEditorTabs, type CodeEditorTabsProps, CodeEditorWelcomeScreen, type CodeEditorWelcomeScreenProps, CodeEditorWorkspace, type CodeEditorWorkspaceProps, Collapse, type CollapseProps, ConnectionStatus, type ConnectionStatusProps, type ContextMenuItem, CopyChip, type CopyChipProps, type DataPoint, type DataSeries, DateRangePicker, type DateRangePickerProps, DecentralizedServerIcon, DefinitionRow, type DefinitionRowProps, type DeploymentCardAction, DeploymentDashboardCard, type DeploymentDashboardCardProps, DeploymentDashboardPanel, type DeploymentDashboardPanelProps, DeploymentDashboardTree, type DeploymentDashboardTreeProps, DeploymentEntityContextMenu, type DeploymentEntityContextMenuProps, type DeploymentEntityType, type DeploymentStatusIndicator, type DeploymentTreeNode, Dialog, type DialogProps, DiscordIcon, Divider, type DividerProps, DownloadIcon, Drawer, type DrawerProps, type DrawerWidth, type DrawerWidthValue, Dropdown, DropdownAnchor, type DropdownAnchorProps, type DropdownProps, EXTENSION_LANGUAGE_MAP, EmptyState, type EmptyStateProps, EntityHeader, type EntityHeaderProps, type FileTreeNode, type FileTreeNodeRenderProps, FilledFolderIcon, FlowEditor, type FlowEditorProps, FolderIcon, type GitInfo, GithubLogoIcon, IDBlock, type IDBlockProps, IconButton, type IconButtonProps, LeftArrowIcon, Link, type LinkProps, List, ListItem, type ListItemProps, type ListProps, Loading, LoadingAnimation, type LoadingAnimationProps, LoadingButton, type LoadingButtonProps, type LoadingProps, Logo, type LogoProps, Markdown, type MarkdownProps, Menu, MenuItem, type MenuItemProps, type MenuProps, MetaField, type MetaFieldProps, MetricsChart, type MetricsChartProps, type MetricsPeriod, NavigationItem, type NavigationItemProps, NavigationList, type NavigationListProps, OnboardingProvider, Pagination, type PaginationProps, PanelDialog, type PanelDialogProps, type PanelDialogSide, type PanelDialogWidth, Paper, type PaperProps, PeriodSelect, type PrimaryAction, Progress, type ProgressProps, QRCode, type QRCodeProps, Radio, type RadioProps, type ResponsiveDrawerWidth, RightArrowIcon, RoleBadge, type RoleBadgeColor, type RoleBadgeProps, type RoleBadgeSize, ScrollableRow, type ScrollableRowProps, SearchField, type SearchFieldProps, type SearchFieldVariant, Selector, type SelectorOption, type SelectorProps, type Service, ServiceSelectorButton, type ServiceSelectorButtonProps, ShareIcon, SideNav, SideNavHeader, type SideNavHeaderProps, type SideNavProps, Sidebar, SidebarItem, type SidebarItemProps, type SidebarProps, Snackbar, type SnackbarProps, StatusDot, type StatusDotProps, type StatusDotStatus, Step, StepButton, type StepButtonProps, StepContent, type StepContentProps, StepLabel, type StepLabelProps, type StepProps, Stepper, type StepperProps, StorageAppIcon, type SummaryItem, SummaryStats, type SummaryStatsProps, Switch, type SwitchProps, Tab, type TabProps, Table, TableHeader, type TableHeaderProps, type TableProps, TextField, type TextFieldProps, type TimeRangeOption, TimeRangeSelect, type TimeRangeSelectProps, TimeSeriesGraph, type TimeSeriesGraphProps, ToggleButton, ToggleButtonGroup, type ToggleButtonGroupProps, type ToggleButtonProps, Tooltip, type TooltipProps, Truncate, type TruncateProps, UploadFileIcon, UploadFolderIcon, type UseCodeEditorWorkspaceOptions, type UseCodeEditorWorkspaceReturn, type UserInfo, WORKFLOW_NODE_LABELS, WORKFLOW_NODE_SHADOW, WorkflowNode, type WorkflowNodeData, WorkflowNodeHandle, type WorkflowNodeProps, type WorkflowNodeType, WorkflowSideInspector, type WorkflowSideInspectorProps, WorkflowTimeBar, type WorkflowTimeBarProps, WorkflowTopBar, type WorkflowTopBarProps, type Workspace, WorkspaceSelectorButton, type WorkspaceSelectorButtonProps, colors, contextMenuItems, detectLanguage, getChipVariantStyles, getFileName, resolveDrawerWidth, robPaletteExtended, robPrimaryPalette, theme, useCodeEditorWorkspace, useIsDesktop, useIsMobile, useIsTablet, useOnboarding, useSearchHotkeys, workflowConnectionColors, workflowNodeColors };
package/dist/index.d.ts CHANGED
@@ -1,8 +1,8 @@
1
- import { Theme } from '@mui/material/styles';
1
+ import { Theme, SxProps } from '@mui/material/styles';
2
2
  import * as react_jsx_runtime from 'react/jsx-runtime';
3
3
  import { LottieComponentProps } from 'lottie-react';
4
4
  import * as React$1 from 'react';
5
- import React__default, { ReactNode, Ref, PropsWithChildren, ReactElement, AriaAttributes } from 'react';
5
+ import React__default, { RefObject, ReactNode, Ref, PropsWithChildren, ReactElement, Key, AriaAttributes } from 'react';
6
6
  import { ButtonProps as ButtonProps$1 } from '@mui/material/Button';
7
7
  import { IconButtonProps as IconButtonProps$1 } from '@mui/material/IconButton';
8
8
  import { LoadingButtonProps as LoadingButtonProps$1 } from '@mui/lab';
@@ -25,6 +25,7 @@ import { CardProps as CardProps$1 } from '@mui/material/Card';
25
25
  import { CardContentProps } from '@mui/material/CardContent';
26
26
  import { CardHeaderProps } from '@mui/material/CardHeader';
27
27
  import { CardActionsProps } from '@mui/material/CardActions';
28
+ import { CardMediaProps as CardMediaProps$1 } from '@mui/material/CardMedia';
28
29
  import { AvatarProps as AvatarProps$1 } from '@mui/material/Avatar';
29
30
  import { BreadcrumbsProps as BreadcrumbsProps$1 } from '@mui/material/Breadcrumbs';
30
31
  import { PaperProps as PaperProps$1 } from '@mui/material/Paper';
@@ -454,12 +455,35 @@ interface TextFieldProps extends Omit<TextFieldProps$1, 'size'> {
454
455
  }
455
456
  declare const TextField: React__default.FC<TextFieldProps>;
456
457
 
457
- interface SearchFieldProps extends Omit<TextFieldProps, 'InputProps'> {
458
+ type SearchFieldVariant = 'standard' | 'pill';
459
+ interface SearchFieldProps extends Omit<TextFieldProps, 'InputProps' | 'variant'> {
458
460
  placeholder?: string;
461
+ /** Fires with the next input value on every change. */
459
462
  onSearch?: (value: string) => void;
463
+ /** Visual treatment. `pill` renders a fully-rounded input. @default 'standard' */
464
+ variant?: SearchFieldVariant;
465
+ /**
466
+ * Show a keyboard-shortcut hint adornment (⌘K on Mac, Ctrl+K elsewhere) at
467
+ * the right edge. Pair with `useSearchHotkeys` to wire the key handler.
468
+ */
469
+ shortcutHint?: boolean;
460
470
  }
461
471
  declare const SearchField: React__default.FC<SearchFieldProps>;
462
472
 
473
+ interface UseSearchHotkeysOptions {
474
+ /** Cmd/Ctrl + K focuses the ref. @default true */
475
+ k?: boolean;
476
+ /** `/` (when not already typing in another field) focuses the ref. @default true */
477
+ slash?: boolean;
478
+ }
479
+ /**
480
+ * Wire global Cmd+K (Mac) / Ctrl+K (everywhere else) and `/` hotkeys to focus
481
+ * the input pointed to by `inputRef`. The `/` hotkey is suppressed while the
482
+ * user is typing in another input, textarea or contentEditable element so it
483
+ * doesn't hijack normal typing. Either hotkey can be disabled via options.
484
+ */
485
+ declare function useSearchHotkeys(inputRef: RefObject<HTMLInputElement | null>, options?: UseSearchHotkeysOptions): void;
486
+
463
487
  type ToggleButtonProps = ToggleButtonProps$1;
464
488
  declare const ToggleButton: React__default.FC<ToggleButtonProps>;
465
489
  type ToggleButtonGroupProps = ToggleButtonGroupProps$1;
@@ -1711,6 +1735,117 @@ interface ScrollableRowProps {
1711
1735
  */
1712
1736
  declare const ScrollableRow: React__default.FC<ScrollableRowProps>;
1713
1737
 
1738
+ interface CarouselProps<T> {
1739
+ /** Slide data. Each entry is passed to `renderSlide`. */
1740
+ slides: T[];
1741
+ /** Render function for an individual slide. */
1742
+ renderSlide: (item: T, index: number) => ReactNode;
1743
+ /**
1744
+ * Stable per-slide React key. Always set this when `slides` can be reordered
1745
+ * or filtered; otherwise React will reuse the wrong slide's internal state
1746
+ * across renders. Defaults to the slide's array index when omitted.
1747
+ */
1748
+ getKey?: (item: T, index: number) => Key;
1749
+ /** Slides visible in the viewport. @default 1 */
1750
+ slidesPerView?: number;
1751
+ /** Auto-advance every `autoplayDelayMs` while not hovered. @default true */
1752
+ autoplay?: boolean;
1753
+ /** Autoplay tick in milliseconds. @default 5000 */
1754
+ autoplayDelayMs?: number;
1755
+ /** Show dot indicators when more than one slide. @default true */
1756
+ showDots?: boolean;
1757
+ /** Show the `01 / 03`-style counter when more than one slide. @default true */
1758
+ showCounter?: boolean;
1759
+ /** Show prev/next chevrons when more than one slide. @default true */
1760
+ showArrows?: boolean;
1761
+ /** Pause autoplay while the pointer is over the carousel. @default true */
1762
+ pauseOnHover?: boolean;
1763
+ /** Accessible label for the surrounding region. */
1764
+ ariaLabel?: string;
1765
+ /** Fires with the new index whenever embla selects a slide. */
1766
+ onSelect?: (index: number) => void;
1767
+ /** Override the IconButton sx for the prev/next arrows. */
1768
+ arrowSx?: SxProps<Theme>;
1769
+ /** Override the dot color (inactive). Accepts any CSS color string. */
1770
+ dotColor?: string;
1771
+ /** Override the active dot color. Accepts any CSS color string. */
1772
+ dotActiveColor?: string;
1773
+ }
1774
+ /**
1775
+ * Carousel — embla-carousel-based slide deck with autoplay, dots, counter,
1776
+ * prev/next arrows and pause-on-hover. Generic over slide payload type; the
1777
+ * caller decides the slide markup via `renderSlide`.
1778
+ */
1779
+ declare function Carousel<T>({ slides, renderSlide, getKey, slidesPerView, autoplay, autoplayDelayMs, showDots, showCounter, showArrows, pauseOnHover, ariaLabel, onSelect, arrowSx, dotColor, dotActiveColor, }: CarouselProps<T>): react_jsx_runtime.JSX.Element | null;
1780
+
1781
+ interface DefinitionRowProps {
1782
+ /** Optional leading icon (e.g. a scope or category glyph). */
1783
+ icon?: ReactNode;
1784
+ /** Primary label rendered on the left side. */
1785
+ label: ReactNode;
1786
+ /** Optional secondary line under the label (e.g. type, scope path). */
1787
+ sublabel?: ReactNode;
1788
+ /** Primary right-side content (e.g. `read`, `optional`). */
1789
+ value?: ReactNode;
1790
+ /** Secondary right-side line under the value (e.g. constraint, default). */
1791
+ hint?: ReactNode;
1792
+ /** Reduce vertical padding for compact lists. */
1793
+ dense?: boolean;
1794
+ /** Draw a bottom divider. The last row in a list never draws. @default true */
1795
+ divider?: boolean;
1796
+ }
1797
+ /**
1798
+ * DefinitionRow — `icon · label / sublabel … value / hint` row primitive
1799
+ * for description-list style content (scope tables, settings, key/value
1800
+ * panels).
1801
+ */
1802
+ declare function DefinitionRow({ icon, label, sublabel, value, hint, dense, divider, }: DefinitionRowProps): react_jsx_runtime.JSX.Element;
1803
+
1804
+ type PanelDialogWidth = 'sm' | 'md' | 'lg' | 'xl';
1805
+ type PanelDialogSide = 'right' | 'center';
1806
+ type PanelDialogTransition = 'fade' | 'slide-up' | 'slide-left';
1807
+ interface PanelDialogProps {
1808
+ /** Controls visibility. */
1809
+ open: boolean;
1810
+ /** Fires when the user closes (close button, backdrop click, ESC). */
1811
+ onClose: () => void;
1812
+ /** Optional title rendered in the header. Used as the dialog accessible name when a string. */
1813
+ title?: ReactNode;
1814
+ /** Optional right-aligned slot in the header (e.g. install + share buttons). */
1815
+ headerActions?: ReactNode;
1816
+ /** Panel width. @default 'md' */
1817
+ width?: PanelDialogWidth;
1818
+ /** Where the panel docks. `right` slides in from the right edge; `center` is a regular centered panel. @default 'right' */
1819
+ side?: PanelDialogSide;
1820
+ /** Override the accessible name when `title` is not a string. */
1821
+ ariaLabel?: string;
1822
+ /**
1823
+ * Drop the header bar entirely (no title row, no border). The close button
1824
+ * still renders but floats absolute over the top-right of the body. Use when
1825
+ * the body content has its own hero / chrome.
1826
+ */
1827
+ hideHeader?: boolean;
1828
+ /** Style overrides on the dialog paper (border-radius, shadow, width tweaks). */
1829
+ paperSx?: SxProps<Theme>;
1830
+ /** Style overrides on the modal backdrop (e.g. tint, blur). */
1831
+ backdropSx?: SxProps<Theme>;
1832
+ /**
1833
+ * Entry transition. Defaults to `slide-left` for `side='right'` and `fade`
1834
+ * for `side='center'`.
1835
+ */
1836
+ transition?: PanelDialogTransition;
1837
+ /** Body content. */
1838
+ children: ReactNode;
1839
+ }
1840
+ /**
1841
+ * PanelDialog — a right-anchored (or centered) slide-in panel for detail
1842
+ * views, inspectors, and side sheets. Built on MUI Dialog; focus trap and
1843
+ * ESC-to-close come from MUI. Use Dialog for centered modal-with-Save/Cancel.
1844
+ */
1845
+ declare function PanelDialog({ open, onClose, title, headerActions, width, side, ariaLabel, hideHeader, paperSx, backdropSx, transition, children, }: PanelDialogProps): react_jsx_runtime.JSX.Element;
1846
+
1847
+ type CardMediaProps = CardMediaProps$1;
1848
+ declare const CardMedia: React__default.FC<CardMediaProps>;
1714
1849
  interface CardProps extends CardProps$1 {
1715
1850
  hoverable?: boolean;
1716
1851
  clickable?: boolean;
@@ -3136,4 +3271,4 @@ interface CodeEditorWorkspaceProps extends Pick<UseCodeEditorWorkspaceOptions, '
3136
3271
  */
3137
3272
  declare const CodeEditorWorkspace: React__default.FC<CodeEditorWorkspaceProps>;
3138
3273
 
3139
- export { Accordion, type AccordionProps, AccountSection, type AccountSectionProps, ActivityAppIcon, Alert, type AlertProps, type AlertSeverity, AppBar, type AppBarProps, AppLoading, type AppLoadingProps, Avatar, AvatarIcon, type AvatarProps, Badge, type BadgeProps, BarTrackingIcon, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, BytesSize, type BytesSizeProps, Card, CardActions, CardContent, CardHeader, type CardProps, CereIcon, ChartWidget, type ChartWidgetProps, CheckMarkAnimation, Checkbox, type CheckboxProps, Chip, type ChipProps, type ChipVariant, type ChipVariantStyles, CircularProgress, type CircularProgressProps, ClockIcon, CloudFlashIcon, CodeEditor, type CodeEditorFile, CodeEditorFileTree, type CodeEditorFileTreeProps, type CodeEditorLanguage, type CodeEditorProps, CodeEditorStatusBar, type CodeEditorStatusBarItem, type CodeEditorStatusBarProps, type CodeEditorStatusBarRenderProps, type CodeEditorTab, type CodeEditorTabRenderProps, CodeEditorTabs, type CodeEditorTabsProps, CodeEditorWelcomeScreen, type CodeEditorWelcomeScreenProps, CodeEditorWorkspace, type CodeEditorWorkspaceProps, Collapse, type CollapseProps, ConnectionStatus, type ConnectionStatusProps, type ContextMenuItem, CopyChip, type CopyChipProps, type DataPoint, type DataSeries, DateRangePicker, type DateRangePickerProps, DecentralizedServerIcon, type DeploymentCardAction, DeploymentDashboardCard, type DeploymentDashboardCardProps, DeploymentDashboardPanel, type DeploymentDashboardPanelProps, DeploymentDashboardTree, type DeploymentDashboardTreeProps, DeploymentEntityContextMenu, type DeploymentEntityContextMenuProps, type DeploymentEntityType, type DeploymentStatusIndicator, type DeploymentTreeNode, Dialog, type DialogProps, DiscordIcon, Divider, type DividerProps, DownloadIcon, Drawer, type DrawerProps, type DrawerWidth, type DrawerWidthValue, Dropdown, DropdownAnchor, type DropdownAnchorProps, type DropdownProps, EXTENSION_LANGUAGE_MAP, EmptyState, type EmptyStateProps, EntityHeader, type EntityHeaderProps, type FileTreeNode, type FileTreeNodeRenderProps, FilledFolderIcon, FlowEditor, type FlowEditorProps, FolderIcon, type GitInfo, GithubLogoIcon, IDBlock, type IDBlockProps, IconButton, type IconButtonProps, LeftArrowIcon, Link, type LinkProps, List, ListItem, type ListItemProps, type ListProps, Loading, LoadingAnimation, type LoadingAnimationProps, LoadingButton, type LoadingButtonProps, type LoadingProps, Logo, type LogoProps, Markdown, type MarkdownProps, Menu, MenuItem, type MenuItemProps, type MenuProps, MetaField, type MetaFieldProps, MetricsChart, type MetricsChartProps, type MetricsPeriod, NavigationItem, type NavigationItemProps, NavigationList, type NavigationListProps, OnboardingProvider, Pagination, type PaginationProps, Paper, type PaperProps, PeriodSelect, type PrimaryAction, Progress, type ProgressProps, QRCode, type QRCodeProps, Radio, type RadioProps, type ResponsiveDrawerWidth, RightArrowIcon, RoleBadge, type RoleBadgeColor, type RoleBadgeProps, type RoleBadgeSize, ScrollableRow, type ScrollableRowProps, SearchField, type SearchFieldProps, Selector, type SelectorOption, type SelectorProps, type Service, ServiceSelectorButton, type ServiceSelectorButtonProps, ShareIcon, SideNav, SideNavHeader, type SideNavHeaderProps, type SideNavProps, Sidebar, SidebarItem, type SidebarItemProps, type SidebarProps, Snackbar, type SnackbarProps, StatusDot, type StatusDotProps, type StatusDotStatus, Step, StepButton, type StepButtonProps, StepContent, type StepContentProps, StepLabel, type StepLabelProps, type StepProps, Stepper, type StepperProps, StorageAppIcon, type SummaryItem, SummaryStats, type SummaryStatsProps, Switch, type SwitchProps, Tab, type TabProps, Table, TableHeader, type TableHeaderProps, type TableProps, TextField, type TextFieldProps, type TimeRangeOption, TimeRangeSelect, type TimeRangeSelectProps, TimeSeriesGraph, type TimeSeriesGraphProps, ToggleButton, ToggleButtonGroup, type ToggleButtonGroupProps, type ToggleButtonProps, Tooltip, type TooltipProps, Truncate, type TruncateProps, UploadFileIcon, UploadFolderIcon, type UseCodeEditorWorkspaceOptions, type UseCodeEditorWorkspaceReturn, type UserInfo, WORKFLOW_NODE_LABELS, WORKFLOW_NODE_SHADOW, WorkflowNode, type WorkflowNodeData, WorkflowNodeHandle, type WorkflowNodeProps, type WorkflowNodeType, WorkflowSideInspector, type WorkflowSideInspectorProps, WorkflowTimeBar, type WorkflowTimeBarProps, WorkflowTopBar, type WorkflowTopBarProps, type Workspace, WorkspaceSelectorButton, type WorkspaceSelectorButtonProps, colors, contextMenuItems, detectLanguage, getChipVariantStyles, getFileName, resolveDrawerWidth, robPaletteExtended, robPrimaryPalette, theme, useCodeEditorWorkspace, useIsDesktop, useIsMobile, useIsTablet, useOnboarding, workflowConnectionColors, workflowNodeColors };
3274
+ export { Accordion, type AccordionProps, AccountSection, type AccountSectionProps, ActivityAppIcon, Alert, type AlertProps, type AlertSeverity, AppBar, type AppBarProps, AppLoading, type AppLoadingProps, Avatar, AvatarIcon, type AvatarProps, Badge, type BadgeProps, BarTrackingIcon, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, BytesSize, type BytesSizeProps, Card, CardActions, CardContent, CardHeader, CardMedia, type CardMediaProps, type CardProps, Carousel, type CarouselProps, CereIcon, ChartWidget, type ChartWidgetProps, CheckMarkAnimation, Checkbox, type CheckboxProps, Chip, type ChipProps, type ChipVariant, type ChipVariantStyles, CircularProgress, type CircularProgressProps, ClockIcon, CloudFlashIcon, CodeEditor, type CodeEditorFile, CodeEditorFileTree, type CodeEditorFileTreeProps, type CodeEditorLanguage, type CodeEditorProps, CodeEditorStatusBar, type CodeEditorStatusBarItem, type CodeEditorStatusBarProps, type CodeEditorStatusBarRenderProps, type CodeEditorTab, type CodeEditorTabRenderProps, CodeEditorTabs, type CodeEditorTabsProps, CodeEditorWelcomeScreen, type CodeEditorWelcomeScreenProps, CodeEditorWorkspace, type CodeEditorWorkspaceProps, Collapse, type CollapseProps, ConnectionStatus, type ConnectionStatusProps, type ContextMenuItem, CopyChip, type CopyChipProps, type DataPoint, type DataSeries, DateRangePicker, type DateRangePickerProps, DecentralizedServerIcon, DefinitionRow, type DefinitionRowProps, type DeploymentCardAction, DeploymentDashboardCard, type DeploymentDashboardCardProps, DeploymentDashboardPanel, type DeploymentDashboardPanelProps, DeploymentDashboardTree, type DeploymentDashboardTreeProps, DeploymentEntityContextMenu, type DeploymentEntityContextMenuProps, type DeploymentEntityType, type DeploymentStatusIndicator, type DeploymentTreeNode, Dialog, type DialogProps, DiscordIcon, Divider, type DividerProps, DownloadIcon, Drawer, type DrawerProps, type DrawerWidth, type DrawerWidthValue, Dropdown, DropdownAnchor, type DropdownAnchorProps, type DropdownProps, EXTENSION_LANGUAGE_MAP, EmptyState, type EmptyStateProps, EntityHeader, type EntityHeaderProps, type FileTreeNode, type FileTreeNodeRenderProps, FilledFolderIcon, FlowEditor, type FlowEditorProps, FolderIcon, type GitInfo, GithubLogoIcon, IDBlock, type IDBlockProps, IconButton, type IconButtonProps, LeftArrowIcon, Link, type LinkProps, List, ListItem, type ListItemProps, type ListProps, Loading, LoadingAnimation, type LoadingAnimationProps, LoadingButton, type LoadingButtonProps, type LoadingProps, Logo, type LogoProps, Markdown, type MarkdownProps, Menu, MenuItem, type MenuItemProps, type MenuProps, MetaField, type MetaFieldProps, MetricsChart, type MetricsChartProps, type MetricsPeriod, NavigationItem, type NavigationItemProps, NavigationList, type NavigationListProps, OnboardingProvider, Pagination, type PaginationProps, PanelDialog, type PanelDialogProps, type PanelDialogSide, type PanelDialogWidth, Paper, type PaperProps, PeriodSelect, type PrimaryAction, Progress, type ProgressProps, QRCode, type QRCodeProps, Radio, type RadioProps, type ResponsiveDrawerWidth, RightArrowIcon, RoleBadge, type RoleBadgeColor, type RoleBadgeProps, type RoleBadgeSize, ScrollableRow, type ScrollableRowProps, SearchField, type SearchFieldProps, type SearchFieldVariant, Selector, type SelectorOption, type SelectorProps, type Service, ServiceSelectorButton, type ServiceSelectorButtonProps, ShareIcon, SideNav, SideNavHeader, type SideNavHeaderProps, type SideNavProps, Sidebar, SidebarItem, type SidebarItemProps, type SidebarProps, Snackbar, type SnackbarProps, StatusDot, type StatusDotProps, type StatusDotStatus, Step, StepButton, type StepButtonProps, StepContent, type StepContentProps, StepLabel, type StepLabelProps, type StepProps, Stepper, type StepperProps, StorageAppIcon, type SummaryItem, SummaryStats, type SummaryStatsProps, Switch, type SwitchProps, Tab, type TabProps, Table, TableHeader, type TableHeaderProps, type TableProps, TextField, type TextFieldProps, type TimeRangeOption, TimeRangeSelect, type TimeRangeSelectProps, TimeSeriesGraph, type TimeSeriesGraphProps, ToggleButton, ToggleButtonGroup, type ToggleButtonGroupProps, type ToggleButtonProps, Tooltip, type TooltipProps, Truncate, type TruncateProps, UploadFileIcon, UploadFolderIcon, type UseCodeEditorWorkspaceOptions, type UseCodeEditorWorkspaceReturn, type UserInfo, WORKFLOW_NODE_LABELS, WORKFLOW_NODE_SHADOW, WorkflowNode, type WorkflowNodeData, WorkflowNodeHandle, type WorkflowNodeProps, type WorkflowNodeType, WorkflowSideInspector, type WorkflowSideInspectorProps, WorkflowTimeBar, type WorkflowTimeBarProps, WorkflowTopBar, type WorkflowTopBarProps, type Workspace, WorkspaceSelectorButton, type WorkspaceSelectorButtonProps, colors, contextMenuItems, detectLanguage, getChipVariantStyles, getFileName, resolveDrawerWidth, robPaletteExtended, robPrimaryPalette, theme, useCodeEditorWorkspace, useIsDesktop, useIsMobile, useIsTablet, useOnboarding, useSearchHotkeys, workflowConnectionColors, workflowNodeColors };