@omni-design/components 0.7.0

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.
Files changed (223) hide show
  1. package/.claude/commands/ScanComponents.md +26 -0
  2. package/.claude/commands/ShareComponent.md +128 -0
  3. package/.cursorrules +21 -0
  4. package/CLAUDE.md +1046 -0
  5. package/README.md +70 -0
  6. package/dist/OmniDesignProvider.esm.js +2 -0
  7. package/dist/OmniDesignProvider.esm.js.map +1 -0
  8. package/dist/OmniDesignProvider.js +2 -0
  9. package/dist/OmniDesignProvider.js.map +1 -0
  10. package/dist/index.esm.js +42 -0
  11. package/dist/index.esm.js.map +1 -0
  12. package/dist/index.js +42 -0
  13. package/dist/index.js.map +1 -0
  14. package/dist/types/OmniDesignProvider.d.ts +158 -0
  15. package/dist/types/components/Accordion/Accordion.d.ts +42 -0
  16. package/dist/types/components/Accordion/AccordionShowcase.d.ts +2 -0
  17. package/dist/types/components/Accordion/index.d.ts +2 -0
  18. package/dist/types/components/Alert/Alert.d.ts +14 -0
  19. package/dist/types/components/Alert/AlertShowcase.d.ts +2 -0
  20. package/dist/types/components/Alert/index.d.ts +2 -0
  21. package/dist/types/components/AppBar/AppBar.d.ts +43 -0
  22. package/dist/types/components/AppBar/AppBarShowcase.d.ts +2 -0
  23. package/dist/types/components/AppBar/index.d.ts +2 -0
  24. package/dist/types/components/Autocomplete/Autocomplete.d.ts +26 -0
  25. package/dist/types/components/Autocomplete/AutocompleteShowcase.d.ts +2 -0
  26. package/dist/types/components/Autocomplete/index.d.ts +2 -0
  27. package/dist/types/components/Avatar/Avatar.d.ts +29 -0
  28. package/dist/types/components/Avatar/AvatarShowcase.d.ts +2 -0
  29. package/dist/types/components/Avatar/defaultAvatar.d.ts +2 -0
  30. package/dist/types/components/Avatar/index.d.ts +3 -0
  31. package/dist/types/components/BackgroundPicker.d.ts +12 -0
  32. package/dist/types/components/Badge/Badge.d.ts +43 -0
  33. package/dist/types/components/Badge/BadgeShowcase.d.ts +1 -0
  34. package/dist/types/components/Badge/index.d.ts +2 -0
  35. package/dist/types/components/BevelText/BevelText.d.ts +15 -0
  36. package/dist/types/components/BevelText/BevelTextShowcase.d.ts +2 -0
  37. package/dist/types/components/BevelText/index.d.ts +2 -0
  38. package/dist/types/components/BottomNavigation/BottomNavigation.d.ts +15 -0
  39. package/dist/types/components/BottomNavigation/BottomNavigationShowcase.d.ts +2 -0
  40. package/dist/types/components/BottomNavigation/index.d.ts +2 -0
  41. package/dist/types/components/Box/Box.d.ts +36 -0
  42. package/dist/types/components/Box/BoxShowcase.d.ts +2 -0
  43. package/dist/types/components/Box/index.d.ts +2 -0
  44. package/dist/types/components/Breadcrumbs/Breadcrumbs.d.ts +22 -0
  45. package/dist/types/components/Breadcrumbs/BreadcrumbsShowcase.d.ts +2 -0
  46. package/dist/types/components/Breadcrumbs/index.d.ts +2 -0
  47. package/dist/types/components/Button/Button.d.ts +66 -0
  48. package/dist/types/components/Button/index.d.ts +2 -0
  49. package/dist/types/components/ButtonGroup/ButtonGroup.d.ts +41 -0
  50. package/dist/types/components/ButtonGroup/index.d.ts +2 -0
  51. package/dist/types/components/Card/Card.d.ts +54 -0
  52. package/dist/types/components/Card/CardShowcase.d.ts +2 -0
  53. package/dist/types/components/Card/index.d.ts +2 -0
  54. package/dist/types/components/Checkbox/Checkbox.d.ts +51 -0
  55. package/dist/types/components/Checkbox/index.d.ts +2 -0
  56. package/dist/types/components/Chip/Chip.d.ts +42 -0
  57. package/dist/types/components/Chip/ChipShowcase.d.ts +2 -0
  58. package/dist/types/components/Chip/index.d.ts +2 -0
  59. package/dist/types/components/CircularProgress/CircularProgress.d.ts +12 -0
  60. package/dist/types/components/CircularProgress/CircularProgressShowcase.d.ts +2 -0
  61. package/dist/types/components/CircularProgress/index.d.ts +2 -0
  62. package/dist/types/components/CodeBlock/CodeBlock.d.ts +35 -0
  63. package/dist/types/components/Colors/Colors.d.ts +7 -0
  64. package/dist/types/components/Colors/index.d.ts +1 -0
  65. package/dist/types/components/Container/Container.d.ts +70 -0
  66. package/dist/types/components/Container/index.d.ts +1 -0
  67. package/dist/types/components/Copyright/Copyright.d.ts +11 -0
  68. package/dist/types/components/Copyright/CopyrightShowcase.d.ts +2 -0
  69. package/dist/types/components/Copyright/index.d.ts +2 -0
  70. package/dist/types/components/CurvedText/CurvedText.d.ts +23 -0
  71. package/dist/types/components/CurvedText/CurvedTextShowcase.d.ts +2 -0
  72. package/dist/types/components/CurvedText/index.d.ts +2 -0
  73. package/dist/types/components/Dialog/Dialog.d.ts +82 -0
  74. package/dist/types/components/Dialog/DialogShowcase.d.ts +2 -0
  75. package/dist/types/components/Dialog/index.d.ts +2 -0
  76. package/dist/types/components/Divider/Divider.d.ts +22 -0
  77. package/dist/types/components/Divider/DividerShowcase.d.ts +2 -0
  78. package/dist/types/components/Divider/index.d.ts +2 -0
  79. package/dist/types/components/Drawer/Drawer.d.ts +30 -0
  80. package/dist/types/components/Drawer/DrawerShowcase.d.ts +2 -0
  81. package/dist/types/components/Drawer/index.d.ts +2 -0
  82. package/dist/types/components/DropZone/DropZone.d.ts +15 -0
  83. package/dist/types/components/DropZone/index.d.ts +2 -0
  84. package/dist/types/components/Fab/Fab.d.ts +17 -0
  85. package/dist/types/components/Fab/FabShowcase.d.ts +2 -0
  86. package/dist/types/components/Fab/index.d.ts +2 -0
  87. package/dist/types/components/Footer/Footer.d.ts +14 -0
  88. package/dist/types/components/Footer/FooterShowcase.d.ts +2 -0
  89. package/dist/types/components/Footer/index.d.ts +2 -0
  90. package/dist/types/components/Gradient/Gradient.d.ts +38 -0
  91. package/dist/types/components/Gradient/GradientShowcase.d.ts +2 -0
  92. package/dist/types/components/Gradient/gradientUtils.d.ts +185 -0
  93. package/dist/types/components/Gradient/index.d.ts +3 -0
  94. package/dist/types/components/Grid/Grid.d.ts +112 -0
  95. package/dist/types/components/Grid/index.d.ts +1 -0
  96. package/dist/types/components/Header/Header.d.ts +53 -0
  97. package/dist/types/components/Header/index.d.ts +1 -0
  98. package/dist/types/components/Icon/Icon.d.ts +19 -0
  99. package/dist/types/components/Icon/IconShowcase.d.ts +2 -0
  100. package/dist/types/components/Icon/index.d.ts +2 -0
  101. package/dist/types/components/IconBadge/IconBadge.d.ts +10 -0
  102. package/dist/types/components/IconBadge/IconBadgeShowcase.d.ts +2 -0
  103. package/dist/types/components/IconBadge/index.d.ts +2 -0
  104. package/dist/types/components/Input/Input.d.ts +47 -0
  105. package/dist/types/components/Input/index.d.ts +2 -0
  106. package/dist/types/components/LinearProgress/LinearProgress.d.ts +9 -0
  107. package/dist/types/components/LinearProgress/LinearProgressShowcase.d.ts +2 -0
  108. package/dist/types/components/LinearProgress/index.d.ts +2 -0
  109. package/dist/types/components/Link/Link.d.ts +16 -0
  110. package/dist/types/components/Link/LinkShowcase.d.ts +2 -0
  111. package/dist/types/components/Link/index.d.ts +2 -0
  112. package/dist/types/components/List/List.d.ts +55 -0
  113. package/dist/types/components/List/ListShowcase.d.ts +2 -0
  114. package/dist/types/components/List/index.d.ts +2 -0
  115. package/dist/types/components/MainLayout/MainLayout.d.ts +28 -0
  116. package/dist/types/components/MainLayout/index.d.ts +1 -0
  117. package/dist/types/components/Menu/Menu.d.ts +37 -0
  118. package/dist/types/components/Menu/MenuShowcase.d.ts +2 -0
  119. package/dist/types/components/Menu/index.d.ts +2 -0
  120. package/dist/types/components/Modal/Modal.d.ts +18 -0
  121. package/dist/types/components/Modal/ModalShowcase.d.ts +2 -0
  122. package/dist/types/components/Modal/index.d.ts +2 -0
  123. package/dist/types/components/NumberField/NumberField.d.ts +22 -0
  124. package/dist/types/components/NumberField/NumberFieldShowcase.d.ts +2 -0
  125. package/dist/types/components/NumberField/index.d.ts +2 -0
  126. package/dist/types/components/Pagination/Pagination.d.ts +17 -0
  127. package/dist/types/components/Pagination/PaginationShowcase.d.ts +2 -0
  128. package/dist/types/components/Pagination/index.d.ts +2 -0
  129. package/dist/types/components/Paper/Paper.d.ts +111 -0
  130. package/dist/types/components/Paper/index.d.ts +1 -0
  131. package/dist/types/components/Popover/Popover.d.ts +31 -0
  132. package/dist/types/components/Popover/index.d.ts +1 -0
  133. package/dist/types/components/PreviewSurface.d.ts +18 -0
  134. package/dist/types/components/Radio/Radio.d.ts +55 -0
  135. package/dist/types/components/Radio/RadioShowcase.d.ts +2 -0
  136. package/dist/types/components/Radio/index.d.ts +2 -0
  137. package/dist/types/components/Rail/Rail.d.ts +15 -0
  138. package/dist/types/components/Rail/RailShowcase.d.ts +2 -0
  139. package/dist/types/components/Rail/index.d.ts +2 -0
  140. package/dist/types/components/Rating/Rating.d.ts +16 -0
  141. package/dist/types/components/Rating/RatingShowcase.d.ts +2 -0
  142. package/dist/types/components/Rating/index.d.ts +2 -0
  143. package/dist/types/components/Ratio/Ratio.d.ts +20 -0
  144. package/dist/types/components/Ratio/RatioShowcase.d.ts +2 -0
  145. package/dist/types/components/Ratio/index.d.ts +2 -0
  146. package/dist/types/components/SearchField/SearchField.d.ts +19 -0
  147. package/dist/types/components/SearchField/SearchFieldShowcase.d.ts +2 -0
  148. package/dist/types/components/SearchField/index.d.ts +2 -0
  149. package/dist/types/components/Section/Section.d.ts +44 -0
  150. package/dist/types/components/Section/SectionShowcase.d.ts +2 -0
  151. package/dist/types/components/Section/index.d.ts +2 -0
  152. package/dist/types/components/Select/Select.d.ts +23 -0
  153. package/dist/types/components/Select/SelectShowcase.d.ts +2 -0
  154. package/dist/types/components/Select/index.d.ts +2 -0
  155. package/dist/types/components/SettingsPanel.d.ts +2 -0
  156. package/dist/types/components/Sidebar/Sidebar.d.ts +53 -0
  157. package/dist/types/components/Sidebar/index.d.ts +1 -0
  158. package/dist/types/components/Slider/Slider.d.ts +79 -0
  159. package/dist/types/components/Slider/SliderShowcase.d.ts +2 -0
  160. package/dist/types/components/Slider/index.d.ts +2 -0
  161. package/dist/types/components/Snackbar/Snackbar.d.ts +17 -0
  162. package/dist/types/components/Snackbar/SnackbarShowcase.d.ts +2 -0
  163. package/dist/types/components/Snackbar/index.d.ts +2 -0
  164. package/dist/types/components/Spacing/Spacing.d.ts +16 -0
  165. package/dist/types/components/Spacing/index.d.ts +1 -0
  166. package/dist/types/components/SpeedDial/SpeedDial.d.ts +17 -0
  167. package/dist/types/components/SpeedDial/SpeedDialShowcase.d.ts +2 -0
  168. package/dist/types/components/SpeedDial/index.d.ts +2 -0
  169. package/dist/types/components/Stack/Stack.d.ts +52 -0
  170. package/dist/types/components/Stack/StackShowcase.d.ts +2 -0
  171. package/dist/types/components/Stack/index.d.ts +2 -0
  172. package/dist/types/components/Stepper/Stepper.d.ts +33 -0
  173. package/dist/types/components/Stepper/StepperShowcase.d.ts +2 -0
  174. package/dist/types/components/Stepper/index.d.ts +2 -0
  175. package/dist/types/components/Switch/Switch.d.ts +65 -0
  176. package/dist/types/components/Switch/SwitchShowcase.d.ts +2 -0
  177. package/dist/types/components/Switch/index.d.ts +2 -0
  178. package/dist/types/components/Table/Table.d.ts +20 -0
  179. package/dist/types/components/Table/TableShowcase.d.ts +2 -0
  180. package/dist/types/components/Table/index.d.ts +2 -0
  181. package/dist/types/components/Tabs/Tabs.d.ts +51 -0
  182. package/dist/types/components/Tabs/TabsShowcase.d.ts +2 -0
  183. package/dist/types/components/Tabs/index.d.ts +2 -0
  184. package/dist/types/components/Tag/Tag.d.ts +57 -0
  185. package/dist/types/components/Tag/TagShowcase.d.ts +2 -0
  186. package/dist/types/components/Tag/index.d.ts +2 -0
  187. package/dist/types/components/TextField/TextField.d.ts +105 -0
  188. package/dist/types/components/TextField/index.d.ts +1 -0
  189. package/dist/types/components/ToggleButton/ToggleButton.d.ts +94 -0
  190. package/dist/types/components/ToggleButton/index.d.ts +1 -0
  191. package/dist/types/components/ToggleButtonGroup/ToggleButtonGroup.d.ts +48 -0
  192. package/dist/types/components/Toolbar/Toolbar.d.ts +14 -0
  193. package/dist/types/components/Toolbar/ToolbarShowcase.d.ts +2 -0
  194. package/dist/types/components/Toolbar/index.d.ts +2 -0
  195. package/dist/types/components/Tooltip/Tooltip.d.ts +20 -0
  196. package/dist/types/components/Tooltip/TooltipShowcase.d.ts +2 -0
  197. package/dist/types/components/Tooltip/index.d.ts +2 -0
  198. package/dist/types/components/TreeView/TreeBranch.d.ts +14 -0
  199. package/dist/types/components/TreeView/TreeView.d.ts +82 -0
  200. package/dist/types/components/TreeView/TreeViewShowcase.d.ts +2 -0
  201. package/dist/types/components/TreeView/index.d.ts +3 -0
  202. package/dist/types/components/Typography/Typography.d.ts +492 -0
  203. package/dist/types/components/Typography/TypographyShowcase.d.ts +2 -0
  204. package/dist/types/components/Typography/index.d.ts +2 -0
  205. package/dist/types/components/_a11y/ContrastCheck.d.ts +15 -0
  206. package/dist/types/components/_bevelPresets.d.ts +92 -0
  207. package/dist/types/components/_shadows.d.ts +32 -0
  208. package/dist/types/components/index.d.ts +74 -0
  209. package/dist/types/theme/useThemeMode.d.ts +4 -0
  210. package/docs/components.md +797 -0
  211. package/docs/getting-started.md +409 -0
  212. package/docs/token-system.md +468 -0
  213. package/package.json +126 -0
  214. package/public/styles/Dark-Mode.css +13867 -0
  215. package/public/styles/Light-Mode.css +14091 -0
  216. package/public/styles/README.md +93 -0
  217. package/public/styles/base.css +261 -0
  218. package/public/styles/core.css +378 -0
  219. package/public/styles/foundation.css +72 -0
  220. package/public/styles/styles.css +6 -0
  221. package/public/styles/theme.js +234 -0
  222. package/public/styles/theme.json +12 -0
  223. package/public/styles/typography-tokens.css +720 -0
@@ -0,0 +1,28 @@
1
+ /**
2
+ * MainLayout Component
3
+ * Flexible layout with multiple navigation options
4
+ * Supports: SideNav, RailNav, TopNav, or combinations
5
+ * Fully responsive - adapts to mobile/tablet/desktop
6
+ *
7
+ * @param {string} layout - Layout type: 'side' | 'rail' | 'top' | 'side-rail'
8
+ * @param {Array} navItems - Navigation items
9
+ * @param {string} title - App title
10
+ * @param {ReactNode} children - Page content
11
+ * @param {function} onLayoutChange - Layout change handler
12
+ * @param {object} props - Additional props
13
+ */
14
+ export function MainLayout({ layout, navItems, title, children, onLayoutChange, onNavigate, sx, ...props }: string): JSX.Element;
15
+ /**
16
+ * DefaultMainLayout Component
17
+ * MainLayout with default demo content
18
+ * Shows design system documentation
19
+ */
20
+ export function DefaultMainLayout({ layout, mode, onModeChange, onLayoutChange, sx, ...props }: {
21
+ [x: string]: any;
22
+ layout?: string;
23
+ mode?: string;
24
+ onModeChange: any;
25
+ onLayoutChange: any;
26
+ sx?: {};
27
+ }): JSX.Element;
28
+ export default MainLayout;
@@ -0,0 +1 @@
1
+ export { MainLayout, DefaultMainLayout, default } from "./MainLayout";
@@ -0,0 +1,37 @@
1
+ export function Dropdown({ children, variant, color, size, open: controlledOpen, onOpenChange, ...props }: {
2
+ [x: string]: any;
3
+ children: any;
4
+ variant?: string;
5
+ color?: string;
6
+ size?: string;
7
+ open: any;
8
+ onOpenChange: any;
9
+ }): JSX.Element;
10
+ export function MenuButton({ children, className, sx, ...props }: {
11
+ [x: string]: any;
12
+ children: any;
13
+ className?: string;
14
+ sx?: {};
15
+ }): JSX.Element;
16
+ export function Menu({ children, className, placement, sx, ...props }: {
17
+ [x: string]: any;
18
+ children: any;
19
+ className?: string;
20
+ placement?: string;
21
+ sx?: {};
22
+ }): JSX.Element;
23
+ export function MenuItem({ children, onClick, selected, disabled, className, sx, ...props }: {
24
+ [x: string]: any;
25
+ children: any;
26
+ onClick: any;
27
+ selected?: boolean;
28
+ disabled?: boolean;
29
+ className?: string;
30
+ sx?: {};
31
+ }): JSX.Element;
32
+ export function MenuDivider({ className, sx, ...props }: {
33
+ [x: string]: any;
34
+ className?: string;
35
+ sx?: {};
36
+ }): JSX.Element;
37
+ export default Menu;
@@ -0,0 +1,2 @@
1
+ export function MenuShowcase(): JSX.Element;
2
+ export default MenuShowcase;
@@ -0,0 +1,2 @@
1
+ export { MenuShowcase } from "./MenuShowcase";
2
+ export { Dropdown, MenuButton, Menu, MenuItem, MenuDivider, default } from "./Menu";
@@ -0,0 +1,18 @@
1
+ export function Modal({ open, onClose, children, title, variant, color, size, layout, transition, transitionSpeed, closeOnBackdrop, showCloseButton, className, sx, ...props }: {
2
+ [x: string]: any;
3
+ open: any;
4
+ onClose: any;
5
+ children: any;
6
+ title: any;
7
+ variant?: string;
8
+ color?: string;
9
+ size?: string;
10
+ layout?: string;
11
+ transition?: string;
12
+ transitionSpeed?: number;
13
+ closeOnBackdrop?: boolean;
14
+ showCloseButton?: boolean;
15
+ className?: string;
16
+ sx?: {};
17
+ }): JSX.Element;
18
+ export default Modal;
@@ -0,0 +1,2 @@
1
+ export function ModalShowcase(): JSX.Element;
2
+ export default ModalShowcase;
@@ -0,0 +1,2 @@
1
+ export { ModalShowcase } from "./ModalShowcase";
2
+ export { Modal, default } from "./Modal";
@@ -0,0 +1,22 @@
1
+ export function NumberField({ value: controlledValue, defaultValue, onChange, min, max, step, variant, style: styleVariant, color, size, label, labelPosition, placeholder, helperText, disabled, fullWidth, className, sx, ...props }: {
2
+ [x: string]: any;
3
+ value: any;
4
+ defaultValue?: number;
5
+ onChange: any;
6
+ min: any;
7
+ max: any;
8
+ step?: number;
9
+ variant?: string;
10
+ style?: string;
11
+ color?: string;
12
+ size?: string;
13
+ label: any;
14
+ labelPosition?: string;
15
+ placeholder: any;
16
+ helperText: any;
17
+ disabled?: boolean;
18
+ fullWidth?: boolean;
19
+ className?: string;
20
+ sx?: {};
21
+ }): JSX.Element;
22
+ export default NumberField;
@@ -0,0 +1,2 @@
1
+ export function NumberFieldShowcase(): JSX.Element;
2
+ export default NumberFieldShowcase;
@@ -0,0 +1,2 @@
1
+ export { NumberFieldShowcase } from "./NumberFieldShowcase";
2
+ export { NumberField, default } from "./NumberField";
@@ -0,0 +1,17 @@
1
+ export function Pagination({ count, page: controlledPage, defaultPage, onChange, color, size, siblingCount, boundaryCount, disabled, showFirstButton, showLastButton, className, sx, ...props }: {
2
+ [x: string]: any;
3
+ count?: number;
4
+ page: any;
5
+ defaultPage?: number;
6
+ onChange: any;
7
+ color?: string;
8
+ size?: string;
9
+ siblingCount?: number;
10
+ boundaryCount?: number;
11
+ disabled?: boolean;
12
+ showFirstButton?: boolean;
13
+ showLastButton?: boolean;
14
+ className?: string;
15
+ sx?: {};
16
+ }): JSX.Element;
17
+ export default Pagination;
@@ -0,0 +1,2 @@
1
+ export function PaginationShowcase(): JSX.Element;
2
+ export default PaginationShowcase;
@@ -0,0 +1,2 @@
1
+ export { PaginationShowcase } from "./PaginationShowcase";
2
+ export { Pagination, default } from "./Pagination";
@@ -0,0 +1,111 @@
1
+ /**
2
+ * usePaperSurface Hook
3
+ * Manages data-surface attribute and elevation mapping
4
+ *
5
+ * Surface Elevations:
6
+ * - Container-Lowest: Lowest elevation (0dp)
7
+ * - Container-Low: Low elevation (1dp)
8
+ * - Container: Medium elevation (4dp) - default
9
+ * - Container-High: High elevation (8dp)
10
+ * - Container-Highest: Highest elevation (12dp)
11
+ *
12
+ * @param {string} surface - Surface elevation level
13
+ * @returns {object} - Data-surface object and elevation level
14
+ */
15
+ export function usePaperSurface(surface?: string): object;
16
+ /**
17
+ * Paper Component
18
+ * Base paper component with elevation levels
19
+ * Styling applied via data-surface CSS variables
20
+ *
21
+ * Surface Levels:
22
+ * - Container-Lowest: Flat, no shadow
23
+ * - Container-Low: Subtle shadow
24
+ * - Container: Standard elevation
25
+ * - Container-High: Elevated appearance
26
+ * - Container-Highest: Most elevated
27
+ *
28
+ * @param {string} surface - Elevation surface level (Container-Lowest to Container-Highest)
29
+ * @param {ReactNode} children - Paper content
30
+ * @param {boolean} outlined - Use outline variant instead of elevation
31
+ * @param {object} props - Additional MUI Paper props
32
+ */
33
+ export function Paper({ children, surface, outlined, variant, sx, ...props }: string): JSX.Element;
34
+ /**
35
+ * InteractivePaper Component
36
+ * Paper that responds to hover and focus
37
+ *
38
+ * @param {string} surface - Elevation surface level
39
+ * @param {ReactNode} children - Paper content
40
+ * @param {function} onClick - Click handler
41
+ * @param {boolean} hoverable - Enable hover elevation
42
+ * @param {object} props - Additional props
43
+ */
44
+ export function InteractivePaper({ children, surface, onClick, hoverable, sx, ...props }: string): JSX.Element;
45
+ /**
46
+ * ElevatedPaper Component
47
+ * Paper with explicit elevation control
48
+ *
49
+ * @param {string} surface - Elevation surface level
50
+ * @param {ReactNode} children - Paper content
51
+ * @param {object} props - Additional props
52
+ */
53
+ export function ElevatedPaper({ children, surface, sx, ...props }: string): JSX.Element;
54
+ /**
55
+ * OutlinedPaper Component
56
+ * Paper with outlined variant (no elevation/shadow)
57
+ *
58
+ * @param {string} surface - Surface level for styling
59
+ * @param {ReactNode} children - Paper content
60
+ * @param {object} props - Additional props
61
+ */
62
+ export function OutlinedPaper({ children, surface, sx, ...props }: string): JSX.Element;
63
+ /**
64
+ * CardPaper Component
65
+ * Card-style paper with padding options
66
+ *
67
+ * @param {string} surface - Elevation surface level
68
+ * @param {ReactNode} children - Paper content
69
+ * @param {string} padding - Padding size: 'none' | 'small' | 'medium' | 'large'
70
+ * @param {object} props - Additional props
71
+ */
72
+ export function CardPaper({ children, surface, padding, sx, ...props }: string): JSX.Element;
73
+ /**
74
+ * NestedPaper Component
75
+ * Paper with nested/layered effect
76
+ *
77
+ * @param {string} outerSurface - Outer paper elevation
78
+ * @param {string} innerSurface - Inner paper elevation
79
+ * @param {ReactNode} children - Paper content
80
+ * @param {object} props - Additional props
81
+ */
82
+ export function NestedPaper({ children, outerSurface, innerSurface, sx, ...props }: string): JSX.Element;
83
+ /**
84
+ * TieredPaper Component
85
+ * Paper showing all elevation levels
86
+ * Useful for documentation and testing
87
+ *
88
+ * @param {ReactNode} children - Paper content
89
+ * @param {object} props - Additional props
90
+ */
91
+ export function TieredPaper({ children, label, sx, ...props }: ReactNode): JSX.Element;
92
+ /**
93
+ * ResponsivePaper Component
94
+ * Paper that adapts elevation based on screen size
95
+ *
96
+ * @param {string} mobileSurface - Surface on mobile
97
+ * @param {string} tabletSurface - Surface on tablet
98
+ * @param {string} desktopSurface - Surface on desktop
99
+ * @param {ReactNode} children - Paper content
100
+ * @param {object} props - Additional props
101
+ */
102
+ export function ResponsivePaper({ children, mobileSurface, tabletSurface, desktopSurface, sx, ...props }: string): JSX.Element;
103
+ /**
104
+ * FloatingPaper Component
105
+ * Paper that appears to float above the page
106
+ *
107
+ * @param {ReactNode} children - Paper content
108
+ * @param {object} props - Additional props
109
+ */
110
+ export function FloatingPaper({ children, sx, ...props }: ReactNode): JSX.Element;
111
+ export default Paper;
@@ -0,0 +1 @@
1
+ export { Paper, usePaperSurface, InteractivePaper, ElevatedPaper, OutlinedPaper, CardPaper, NestedPaper, TieredPaper, ResponsivePaper, FloatingPaper, default } from "./Paper";
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Popover Component
3
+ *
4
+ * A positioned overlay that renders via portal to escape parent overflow.
5
+ * Accepts any children — use for notifications, rich tooltips, pickers, etc.
6
+ *
7
+ * Props:
8
+ * open boolean — controlled visibility
9
+ * onClose fn() — called on outside click or Escape
10
+ * anchorRef React.ref — element to position against
11
+ * placement string — 'bottom-start' | 'bottom-end' (default: 'bottom-end')
12
+ * theme string — data-theme value (default: 'Default')
13
+ * surface string — data-surface value (default: 'Surface-Bright')
14
+ * width number|string — popover width (default: 320)
15
+ * maxHeight number|string — max height before scroll (default: 400)
16
+ * children ReactNode
17
+ * sx object
18
+ */
19
+ export function Popover({ open, onClose, anchorRef, placement, theme, surface, width, maxHeight, children, sx, }: {
20
+ open?: boolean;
21
+ onClose: any;
22
+ anchorRef: any;
23
+ placement?: string;
24
+ theme?: string;
25
+ surface?: string;
26
+ width?: number;
27
+ maxHeight?: number;
28
+ children: any;
29
+ sx?: {};
30
+ }): any;
31
+ export default Popover;
@@ -0,0 +1 @@
1
+ export { Popover, default } from "./Popover";
@@ -0,0 +1,18 @@
1
+ /**
2
+ * PreviewSurface (controlled)
3
+ *
4
+ * Wraps the component preview area with data-theme and data-surface
5
+ * so all tokens resolve correctly for the chosen background environment.
6
+ *
7
+ * Props:
8
+ * theme — data-theme value (null = Default)
9
+ * surface — data-surface value (default: 'Surface')
10
+ * children — the component being previewed
11
+ * minHeight — minimum height of the preview area (default: 160)
12
+ * sx — additional MUI sx overrides
13
+ *
14
+ * Use BackgroundPicker in the playground tab to let the user choose
15
+ * both the theme and surface.
16
+ */
17
+ export const PreviewSurface: any;
18
+ export default PreviewSurface;
@@ -0,0 +1,55 @@
1
+ export function Radio({ color, size, label, labelPlacement, checked, disabled, onChange, name, value, className, sx, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, inputProps: inputPropsProp, ...props }: {
2
+ [x: string]: any;
3
+ color?: string;
4
+ size?: string;
5
+ label: any;
6
+ labelPlacement?: string;
7
+ checked: any;
8
+ disabled?: boolean;
9
+ onChange: any;
10
+ name: any;
11
+ value: any;
12
+ className?: string;
13
+ sx?: {};
14
+ "aria-label": any;
15
+ "aria-labelledby": any;
16
+ "aria-describedby": any;
17
+ inputProps?: {};
18
+ }): JSX.Element;
19
+ export function RadioGroup({ color, size, label, options, value, onChange, orientation, labelPlacement, disabled, spacing, name, className, sx, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ...props }: {
20
+ [x: string]: any;
21
+ color?: string;
22
+ size?: string;
23
+ label: any;
24
+ options?: any[];
25
+ value: any;
26
+ onChange: any;
27
+ orientation?: string;
28
+ labelPlacement?: string;
29
+ disabled?: boolean;
30
+ spacing?: number;
31
+ name: any;
32
+ className?: string;
33
+ sx?: {};
34
+ "aria-label": any;
35
+ "aria-labelledby": any;
36
+ }): JSX.Element;
37
+ export function RadioInput({ color, size, label, labelPlacement, checked, disabled, onChange, name, value, className, sx, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, inputProps: inputPropsProp, ...props }: {
38
+ [x: string]: any;
39
+ color?: string;
40
+ size?: string;
41
+ label: any;
42
+ labelPlacement?: string;
43
+ checked: any;
44
+ disabled?: boolean;
45
+ onChange: any;
46
+ name: any;
47
+ value: any;
48
+ className?: string;
49
+ sx?: {};
50
+ "aria-label": any;
51
+ "aria-labelledby": any;
52
+ "aria-describedby": any;
53
+ inputProps?: {};
54
+ }): JSX.Element;
55
+ export default Radio;
@@ -0,0 +1,2 @@
1
+ export function RadioShowcase(): JSX.Element;
2
+ export default RadioShowcase;
@@ -0,0 +1,2 @@
1
+ export { RadioShowcase } from "./RadioShowcase";
2
+ export { Radio, RadioGroup, RadioInput, default } from "./Radio";
@@ -0,0 +1,15 @@
1
+ export function Rail({ items, sections, value: controlledValue, defaultValue, onChange, expandable, expandedWidth, defaultExpanded, fabAction, className, sx, ...props }: {
2
+ [x: string]: any;
3
+ items?: any[];
4
+ sections: any;
5
+ value: any;
6
+ defaultValue?: number;
7
+ onChange: any;
8
+ expandable?: boolean;
9
+ expandedWidth?: string;
10
+ defaultExpanded?: boolean;
11
+ fabAction: any;
12
+ className?: string;
13
+ sx?: {};
14
+ }): JSX.Element;
15
+ export default Rail;
@@ -0,0 +1,2 @@
1
+ export function RailShowcase(): JSX.Element;
2
+ export default RailShowcase;
@@ -0,0 +1,2 @@
1
+ export { RailShowcase } from "./RailShowcase";
2
+ export { Rail, default } from "./Rail";
@@ -0,0 +1,16 @@
1
+ export function Rating({ value: controlledValue, defaultValue, onChange, max, precision, color, size, readOnly, disabled, emptyLabel, className, sx, ...props }: {
2
+ [x: string]: any;
3
+ value: any;
4
+ defaultValue: any;
5
+ onChange: any;
6
+ max?: number;
7
+ precision?: number;
8
+ color?: string;
9
+ size?: string;
10
+ readOnly?: boolean;
11
+ disabled?: boolean;
12
+ emptyLabel?: string;
13
+ className?: string;
14
+ sx?: {};
15
+ }): JSX.Element;
16
+ export default Rating;
@@ -0,0 +1,2 @@
1
+ export function RatingShowcase(): JSX.Element;
2
+ export default RatingShowcase;
@@ -0,0 +1,2 @@
1
+ export { RatingShowcase } from "./RatingShowcase";
2
+ export { Rating, Rating as RatingInput, default } from "./Rating";
@@ -0,0 +1,20 @@
1
+ export function Ratio({ ratio, children, variant, color, padding, fit, placeholder, elevated, clickable, onClick, maxWidth, maxHeight, component, className, sx, ...props }: {
2
+ [x: string]: any;
3
+ ratio?: string;
4
+ children: any;
5
+ variant?: string;
6
+ color?: string;
7
+ padding?: string;
8
+ fit?: string;
9
+ placeholder?: boolean;
10
+ elevated?: boolean;
11
+ clickable?: boolean;
12
+ onClick: any;
13
+ maxWidth: any;
14
+ maxHeight: any;
15
+ component?: string;
16
+ className?: string;
17
+ sx?: {};
18
+ }): JSX.Element;
19
+ export const RATIO_NAMES: string[];
20
+ export default Ratio;
@@ -0,0 +1,2 @@
1
+ export function RatioShowcase(): JSX.Element;
2
+ export default RatioShowcase;
@@ -0,0 +1,2 @@
1
+ export { RatioShowcase } from "./RatioShowcase";
2
+ export { Ratio, RATIO_NAMES, default } from "./Ratio";
@@ -0,0 +1,19 @@
1
+ export function SearchField({ value: controlledValue, defaultValue, onChange, onFocus, onBlur, onClear, onSubmit, placeholder, size, color, showClearButton, disabled, ariaLabel, className, sx, ...props }: {
2
+ [x: string]: any;
3
+ value: any;
4
+ defaultValue?: string;
5
+ onChange: any;
6
+ onFocus: any;
7
+ onBlur: any;
8
+ onClear: any;
9
+ onSubmit: any;
10
+ placeholder?: string;
11
+ size?: string;
12
+ color?: string;
13
+ showClearButton?: boolean;
14
+ disabled?: boolean;
15
+ ariaLabel?: string;
16
+ className?: string;
17
+ sx?: {};
18
+ }): JSX.Element;
19
+ export default SearchField;
@@ -0,0 +1,2 @@
1
+ export function SearchFieldShowcase(): JSX.Element;
2
+ export default SearchFieldShowcase;
@@ -0,0 +1,2 @@
1
+ export { SearchFieldShowcase } from "./SearchFieldShowcase";
2
+ export { SearchField, default } from "./SearchField";
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Section Component
3
+ *
4
+ * The one-liner for painting a region with the design system. Sets
5
+ * `data-theme` + `data-surface` and paints `--Background` / `--Text` so all
6
+ * nested components (text, buttons, cards) automatically pick up the
7
+ * correct tone — no inline `background: var(--Surface)` or hex needed.
8
+ *
9
+ * Use this anywhere you'd otherwise reach for:
10
+ * <section data-theme=".." data-surface=".."
11
+ * style={{ background: 'var(--Background)', color: 'var(--Text)' }}>
12
+ *
13
+ * Props:
14
+ * theme — OmniDesign theme name (e.g. "Primary-Light", "Neutral-Dark").
15
+ * Optional: omit to inherit from the parent theme zone.
16
+ * surface — "Surface" (default) | "Surface-Dim" | "Surface-Dimmest" |
17
+ * "Surface-Bright" | "Surface-Brightest" |
18
+ * "Container" | "Container-Low" | "Container-Lowest" |
19
+ * "Container-High" | "Container-Highest"
20
+ *
21
+ * Five surface levels, darkest to lightest. Surface-Brightest is
22
+ * the level that replaced the <Palette>-Light themes: it lands on
23
+ * the same tone their Surface used, so `theme="Primary"
24
+ * surface="Surface-Brightest"` is what `theme="Primary-Light"`
25
+ * used to be. Passed through unvalidated — an unknown value
26
+ * simply matches no rule and inherits the parent's paint.
27
+ * as — element tag, defaults to "section"
28
+ * padding — CSS padding value (string or number). Optional.
29
+ * className, style, children, ...rest — forwarded.
30
+ *
31
+ * For wrapping without painting (e.g. AppBar's themed zone), use ThemedZone
32
+ * instead.
33
+ */
34
+ export function Section({ theme, surface, as: Tag, padding, className, style, children, ...rest }: {
35
+ [x: string]: any;
36
+ theme: any;
37
+ surface?: string;
38
+ as?: string;
39
+ padding: any;
40
+ className: any;
41
+ style: any;
42
+ children: any;
43
+ }): JSX.Element;
44
+ export default Section;
@@ -0,0 +1,2 @@
1
+ export function SectionShowcase(): JSX.Element;
2
+ export default SectionShowcase;
@@ -0,0 +1,2 @@
1
+ export { SectionShowcase } from "./SectionShowcase";
2
+ export { Section, default } from "./Section";
@@ -0,0 +1,23 @@
1
+ export function Select({ options, value: controlledValue, defaultValue, onChange, label, labelPosition, size, variant, color, selectionStyle, mode, placeholder, showDividers, showColorLabels, startDecoration, disabled, fullWidth, className, sx, ...props }: {
2
+ [x: string]: any;
3
+ options?: any[];
4
+ value: any;
5
+ defaultValue?: string;
6
+ onChange: any;
7
+ label: any;
8
+ labelPosition?: string;
9
+ size?: string;
10
+ variant?: string;
11
+ color?: string;
12
+ selectionStyle?: string;
13
+ mode?: string;
14
+ placeholder?: string;
15
+ showDividers?: boolean;
16
+ showColorLabels?: boolean;
17
+ startDecoration: any;
18
+ disabled?: boolean;
19
+ fullWidth?: boolean;
20
+ className?: string;
21
+ sx?: {};
22
+ }): JSX.Element;
23
+ export default Select;
@@ -0,0 +1,2 @@
1
+ export function SelectShowcase(): JSX.Element;
2
+ export default SelectShowcase;
@@ -0,0 +1,2 @@
1
+ export { SelectShowcase } from "./SelectShowcase";
2
+ export { Select, default } from "./Select";
@@ -0,0 +1,2 @@
1
+ export function SettingsPanel(): JSX.Element;
2
+ export default SettingsPanel;
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Sidebar Component
3
+ * Expandable drawer sidebar with menu items
4
+ *
5
+ * Design System Integration:
6
+ * - Background: var(--Container)
7
+ * - Text: var(--Text)
8
+ * - Selected: var(--Buttons-Primary-Button) bg, var(--Buttons-Primary-Text) text
9
+ * - Border: var(--Border-Variant)
10
+ *
11
+ * WCAG 2.1 Accessibility:
12
+ * - Proper semantic structure
13
+ * - Keyboard navigation
14
+ * - ARIA labels
15
+ * - Focus management
16
+ *
17
+ * @param {boolean} open - Sidebar open state
18
+ * @param {function} onClose - Close handler
19
+ * @param {Array} items - Array of menu items {label, icon, onClick, badge}
20
+ * @param {function} onItemClick - Item click handler
21
+ * @param {number} width - Sidebar width
22
+ * @param {string} variant - Sidebar variant: 'standard' | 'permanent' | 'temporary'
23
+ * @param {object} props - Additional props
24
+ */
25
+ export function Sidebar({ open, onClose, items, onItemClick, width, variant, header, footer, sx, ...props }: boolean): JSX.Element;
26
+ /**
27
+ * CollapsibleSidebar Component
28
+ * Sidebar that collapses to icon-only mode
29
+ *
30
+ * @param {boolean} collapsed - Collapsed state
31
+ * @param {function} onToggle - Toggle collapse handler
32
+ * @param {Array} items - Menu items
33
+ * @param {object} props - Additional props
34
+ */
35
+ export function CollapsibleSidebar({ collapsed, onToggle, items, onItemClick, header, sx, ...props }: boolean): JSX.Element;
36
+ /**
37
+ * UserProfileSidebar Component
38
+ * Sidebar with user profile section
39
+ *
40
+ * @param {object} user - User object {name, avatar, email}
41
+ * @param {Array} items - Menu items
42
+ * @param {object} props - Additional props
43
+ */
44
+ export function UserProfileSidebar({ open, onClose, user, items, onItemClick, onUserClick, sx, ...props }: object): JSX.Element;
45
+ /**
46
+ * MinimalSidebar Component
47
+ * Minimal icon-only sidebar
48
+ *
49
+ * @param {Array} items - Menu items (icon only)
50
+ * @param {object} props - Additional props
51
+ */
52
+ export function MinimalSidebar({ items, onItemClick, sx, ...props }: any[]): JSX.Element;
53
+ export default Sidebar;
@@ -0,0 +1 @@
1
+ export { Sidebar, CollapsibleSidebar, UserProfileSidebar, MinimalSidebar, default } from "./Sidebar";