@epam/ai-dial-ui-kit 0.13.0-dev.9 → 0.14.0-dev.1

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 (173) hide show
  1. package/README.md +45 -0
  2. package/dist/CHANGELOG.md +48 -1
  3. package/dist/{JsonEditor-CRSkEnWP.cjs → JsonEditor-pyqbLZZf.cjs} +1 -1
  4. package/dist/{JsonEditor-Djt1V27V.js → JsonEditor-v9m_npfK.js} +1 -1
  5. package/dist/MarkdownEditor-5UpxUtXf.js +75 -0
  6. package/dist/{MarkdownEditor-BbGX2uA9.cjs → MarkdownEditor-9aPIyyuu.cjs} +1 -1
  7. package/dist/MarkdownEditor-BjqdSHPU.cjs +1 -0
  8. package/dist/{MarkdownEditor-DtKScLM2.js → MarkdownEditor-CWZVSR--.js} +1 -1
  9. package/dist/components-manifest.json +3420 -391
  10. package/dist/dial-ui-kit.cjs.js +1 -1
  11. package/dist/dial-ui-kit.es.js +201 -148
  12. package/dist/{index-JVDPW40K.js → index-DKDaSZqV.js} +24490 -21241
  13. package/dist/index-xlqMH2Q1.cjs +71 -0
  14. package/dist/index.css +6 -2
  15. package/dist/mcp-server.cjs +29 -9
  16. package/dist/migration-guides/0.13.0/caption-semi-text-lead-rename.md +82 -0
  17. package/dist/migration-guides/0.13.0/field-label-props-unification.md +94 -0
  18. package/dist/migration-guides/0.13.0/focus-border-token-rename.md +106 -0
  19. package/dist/migration-guides/0.13.0/progress-bar-2-0-rewrite.md +103 -0
  20. package/dist/migration-guides/0.13.0/spinner-dial-prefix-removal.md +69 -0
  21. package/dist/migration-guides/0.13.0/typography-heading-scale-shift.md +93 -0
  22. package/dist/migration-guides/README.md +6 -0
  23. package/dist/src/components/Accordion/Accordion.d.ts +1 -0
  24. package/dist/src/components/Analytics/Bar/Bar.d.ts +12 -7
  25. package/dist/src/components/Analytics/BarGroup/BarGroup.d.ts +23 -16
  26. package/dist/src/components/Analytics/Card/Card.d.ts +14 -3
  27. package/dist/src/components/Analytics/ErrorTag/ErrorTag.d.ts +1 -0
  28. package/dist/src/components/Analytics/Histogram/Histogram.d.ts +9 -6
  29. package/dist/src/components/Analytics/Histogram/utils.d.ts +10 -0
  30. package/dist/src/components/AutocompleteInput/AutocompleteInputValue.d.ts +1 -0
  31. package/dist/src/components/Breadcrumb/Breadcrumb.d.ts +1 -0
  32. package/dist/src/components/Breadcrumb/BreadcrumbItem.d.ts +3 -0
  33. package/dist/src/components/Button/Button.d.ts +1 -0
  34. package/dist/src/components/Button/ButtonWrappers.d.ts +1 -15
  35. package/dist/src/components/ButtonDropdown/ButtonDropdown.d.ts +1 -0
  36. package/dist/src/components/CaptionText/CaptionText.d.ts +1 -0
  37. package/dist/src/components/Checkbox/Checkbox.d.ts +1 -0
  38. package/dist/src/components/CloseButton/CloseButton.d.ts +1 -0
  39. package/dist/src/components/CollapsibleSidebar/CollapsibleSidebar.d.ts +1 -0
  40. package/dist/src/components/ConfirmationPopup/ConfirmationPopup.d.ts +1 -0
  41. package/dist/src/components/DraggableItem/DraggableItem.d.ts +1 -0
  42. package/dist/src/components/DropdownIcon/DropdownIcon.d.ts +1 -0
  43. package/dist/src/components/EllipsisTooltip/EllipsisTooltip.d.ts +1 -0
  44. package/dist/src/components/FabButton/FabButton.d.ts +8 -3
  45. package/dist/src/components/FileIcon/FileIcon.d.ts +1 -0
  46. package/dist/src/components/FileManager/FileManager.d.ts +3 -0
  47. package/dist/src/components/FileManager/FileManagerProvider.d.ts +1 -0
  48. package/dist/src/components/FileManager/components/DestinationFolderPopup/DestinationFolderPopup.d.ts +3 -0
  49. package/dist/src/components/FileManager/components/FoldersTree/FoldersTree.d.ts +3 -0
  50. package/dist/src/components/FileManager/hooks/use-file-manager-context.d.ts +2 -0
  51. package/dist/src/components/FileManager/hooks/use-file-manager-tabs.d.ts +3 -0
  52. package/dist/src/components/FileName/FileName.d.ts +1 -0
  53. package/dist/src/components/FolderName/FolderName.d.ts +1 -0
  54. package/dist/src/components/FormItem/FormItem.d.ts +1 -0
  55. package/dist/src/components/FormPopup/FormPopup.d.ts +1 -0
  56. package/dist/src/components/Grid/Grid.d.ts +1 -0
  57. package/dist/src/components/Grid/comparators/base-column-comparator.d.ts +1 -0
  58. package/dist/src/components/Grid/renderers/DateCellRenderer.d.ts +1 -0
  59. package/dist/src/components/Icon/Icon.d.ts +1 -0
  60. package/dist/src/components/IconButton/IconButton.d.ts +5 -0
  61. package/dist/src/components/IconButton/IconButtonWrappers.d.ts +1 -0
  62. package/dist/src/components/Input/Input.d.ts +1 -0
  63. package/dist/src/components/InputPopup/InputPopup.d.ts +1 -0
  64. package/dist/src/components/JsonEditor/JsonEditor.d.ts +1 -0
  65. package/dist/src/components/Label/Label.d.ts +1 -0
  66. package/dist/src/components/LabelledText/LabelledText.d.ts +1 -0
  67. package/dist/src/components/LoadFileArea/LoadFileArea.d.ts +1 -0
  68. package/dist/src/components/LoadFileArea/LoadFileAreaField.d.ts +1 -0
  69. package/dist/src/components/Loader/Loader.d.ts +1 -0
  70. package/dist/src/components/MarkdownEditor/MarkdownEditor.d.ts +1 -0
  71. package/dist/src/components/New/Accordion/Accordion.d.ts +71 -0
  72. package/dist/src/components/New/Button/Button.d.ts +66 -0
  73. package/dist/src/components/New/Button/ButtonWrappers.d.ts +94 -0
  74. package/dist/src/components/New/Button/__tests__/utils.spec.d.ts +1 -0
  75. package/dist/src/components/New/Button/constants.d.ts +2 -0
  76. package/dist/src/components/New/Button/utils.d.ts +2 -0
  77. package/dist/src/components/New/ButtonDropdown/ButtonDropdown.d.ts +24 -0
  78. package/dist/src/components/New/ButtonDropdown/constants.d.ts +1 -0
  79. package/dist/src/components/New/Calendar/Calendar.d.ts +55 -0
  80. package/dist/src/components/New/Calendar/constants.d.ts +17 -0
  81. package/dist/src/components/New/Calendar/utils.d.ts +25 -0
  82. package/dist/src/components/New/Calendar/utils.spec.d.ts +1 -0
  83. package/dist/src/components/New/CaptionText/CaptionText.d.ts +21 -0
  84. package/dist/src/components/New/CardShell/CardShell.d.ts +14 -0
  85. package/dist/src/components/New/CloseButton/CloseButton.d.ts +33 -0
  86. package/dist/src/components/New/ConfirmationPopup/ConfirmationPopup.d.ts +55 -0
  87. package/dist/src/components/New/ConfirmationPopup/constants.d.ts +14 -0
  88. package/dist/src/components/New/Dropdown/Dropdown.d.ts +87 -0
  89. package/dist/src/components/New/Dropdown/DropdownSubMenuItem.d.ts +8 -0
  90. package/dist/src/components/New/Dropdown/constants.d.ts +9 -0
  91. package/dist/src/components/New/FileDropzone/FileDropzone.d.ts +81 -0
  92. package/dist/src/components/New/FolderPath/FolderPath.d.ts +32 -0
  93. package/dist/src/components/New/Highlight/Highlight.d.ts +19 -0
  94. package/dist/src/components/New/IconButton/IconButton.d.ts +48 -0
  95. package/dist/src/components/New/IconButton/IconButtonWrappers.d.ts +71 -0
  96. package/dist/src/components/New/InfoButton/InfoButton.d.ts +26 -0
  97. package/dist/src/components/New/InfoButton/InfoButton.stories.d.ts +6 -0
  98. package/dist/src/components/New/InlineSelect/InlineSelect.d.ts +51 -0
  99. package/dist/src/components/New/Input/Button/InputButton.d.ts +25 -0
  100. package/dist/src/components/New/Input/Button/constants.d.ts +1 -0
  101. package/dist/src/components/New/Input/Input.d.ts +67 -0
  102. package/dist/src/components/New/Input/utils.d.ts +2 -0
  103. package/dist/src/components/New/Label/Label.d.ts +33 -0
  104. package/dist/src/components/New/MarkdownEditor/MarkdownEditor.d.ts +33 -0
  105. package/dist/src/components/New/MarkdownEditor/constants.d.ts +20 -0
  106. package/dist/src/components/New/Notification/Notification.d.ts +7 -0
  107. package/dist/src/components/New/Notification/constants.d.ts +12 -1
  108. package/dist/src/components/New/NumberInput/NumberInput.d.ts +36 -0
  109. package/dist/src/components/New/PasswordInput/PasswordInput.d.ts +33 -0
  110. package/dist/src/components/New/Popup/Popup.d.ts +72 -0
  111. package/dist/src/components/New/Popup/constants.d.ts +10 -0
  112. package/dist/src/components/New/Search/Search.d.ts +42 -0
  113. package/dist/src/components/New/Select/MultiSelectTags.d.ts +17 -0
  114. package/dist/src/components/New/Select/Select.d.ts +110 -0
  115. package/dist/src/components/New/Select/SelectSubMenuItem.d.ts +8 -0
  116. package/dist/src/components/New/Select/constants.d.ts +32 -0
  117. package/dist/src/components/New/Switch/Switch.d.ts +38 -0
  118. package/dist/src/components/New/Tabs/Tabs.d.ts +63 -0
  119. package/dist/src/components/New/Tag/Tag.d.ts +45 -0
  120. package/dist/src/components/New/TagInput/TagInput.d.ts +72 -0
  121. package/dist/src/components/New/TagInput/utils.d.ts +21 -0
  122. package/dist/src/components/New/TagInput/utils.spec.d.ts +1 -0
  123. package/dist/src/components/New/Textarea/Textarea.d.ts +39 -0
  124. package/dist/src/components/New/constants/overlay.d.ts +24 -0
  125. package/dist/src/components/NoDataContent/NoDataContent.d.ts +1 -0
  126. package/dist/src/components/Notification/Notification.d.ts +1 -0
  127. package/dist/src/components/NumberInput/NumberInput.d.ts +1 -0
  128. package/dist/src/components/Pagination/Pagination.d.ts +3 -0
  129. package/dist/src/components/PasswordInput/PasswordInput.d.ts +1 -0
  130. package/dist/src/components/Popup/Popup.d.ts +2 -1
  131. package/dist/src/components/ProgressBar/ProgressBar.d.ts +51 -10
  132. package/dist/src/components/RadioButton/RadioButton.d.ts +1 -0
  133. package/dist/src/components/RadioGroup/RadioGroup.d.ts +1 -0
  134. package/dist/src/components/RadioGroupPopupField/RadioGroupPopupField.d.ts +1 -0
  135. package/dist/src/components/RemoveButton/RemoveButton.d.ts +1 -0
  136. package/dist/src/components/ResizableContainer/ConditionalResizableContainer.d.ts +1 -0
  137. package/dist/src/components/ResizableContainer/ResizableContainer.d.ts +1 -0
  138. package/dist/src/components/SchemaRenderer/SchemaRenderer.d.ts +1 -0
  139. package/dist/src/components/SchemaRenderer/components/SchemaKeyValueEditor.d.ts +9 -1
  140. package/dist/src/components/SchemaRenderer/types.d.ts +6 -1
  141. package/dist/src/components/SchemaRenderer/utils.d.ts +1 -0
  142. package/dist/src/components/Search/Search.d.ts +1 -0
  143. package/dist/src/components/SegmentedControl/SegmentedControl.d.ts +1 -0
  144. package/dist/src/components/Select/Select.d.ts +1 -0
  145. package/dist/src/components/SelectField/SelectField.d.ts +1 -0
  146. package/dist/src/components/SharedEntityIndicator/SharedEntityIndicator.d.ts +1 -0
  147. package/dist/src/components/Skeleton/Skeleton.d.ts +19 -18
  148. package/dist/src/components/Skeleton/utils.d.ts +2 -2
  149. package/dist/src/components/Slider/Slider.d.ts +1 -0
  150. package/dist/src/components/Spinner/Spinner.d.ts +5 -2
  151. package/dist/src/components/Steps/Steps.d.ts +1 -0
  152. package/dist/src/components/Switch/Switch.d.ts +1 -0
  153. package/dist/src/components/Tabs/Tabs.d.ts +1 -0
  154. package/dist/src/components/Tag/Tag.d.ts +1 -0
  155. package/dist/src/components/TagInput/TagInput.d.ts +1 -0
  156. package/dist/src/components/Textarea/Textarea.d.ts +1 -0
  157. package/dist/src/components/Tooltip/Tooltip.d.ts +1 -0
  158. package/dist/src/components/Tooltip/TooltipContainer.d.ts +1 -0
  159. package/dist/src/components/Tooltip/TooltipContent.d.ts +1 -0
  160. package/dist/src/components/Tooltip/TooltipTrigger.d.ts +1 -0
  161. package/dist/src/index.d.ts +89 -13
  162. package/dist/src/mcp/types.d.ts +12 -0
  163. package/dist/src/models/dropdown.d.ts +27 -0
  164. package/dist/src/types/button.d.ts +1 -0
  165. package/dist/src/types/calendar.d.ts +6 -0
  166. package/dist/src/types/skeleton.d.ts +3 -3
  167. package/dist/src/utils/__tests__/accessible-name.spec.d.ts +1 -0
  168. package/dist/src/utils/__tests__/file-accept.spec.d.ts +1 -0
  169. package/dist/src/utils/accessible-name.d.ts +19 -0
  170. package/dist/src/utils/file-accept.d.ts +16 -0
  171. package/dist/src/utils/sub-menu-floating.d.ts +15 -2
  172. package/package.json +4 -2
  173. package/dist/index-CmA_N28F.cjs +0 -71
@@ -12,6 +12,7 @@ export interface DialBreadcrumbProps {
12
12
  /**
13
13
  * Breadcrumb navigation component with horizontal scroll on overflow.
14
14
  * aliases: NavigationPath|BreadcrumbTrail
15
+ * Design system 1.0
15
16
  *
16
17
  * Use either the `pathItems` prop or compose with `<DialBreadcrumbItem/>` as children.
17
18
  * The last item is treated as the current page.
@@ -12,4 +12,7 @@ export interface DialBreadcrumbItemProps extends Omit<HTMLAttributes<HTMLLIEleme
12
12
  separator?: ReactNode;
13
13
  onBeforeNavigate?: NavigationGuard;
14
14
  }
15
+ /**
16
+ * Design system 1.0
17
+ */
15
18
  export declare const DialBreadcrumbItem: FC<DialBreadcrumbItemProps>;
@@ -17,6 +17,7 @@ export interface DialButtonProps extends DetailedHTMLProps<ButtonHTMLAttributes<
17
17
  /**
18
18
  * A Button component with flexible icon and text positioning
19
19
  * aliases: ActionButton|CallToAction
20
+ * Design system 1.0
20
21
  *
21
22
  * @example
22
23
  * ```tsx
@@ -4,6 +4,7 @@ type ButtonVariantProps = Omit<DialButtonProps, 'variant'>;
4
4
  type ButtonAppearanceProps = Omit<DialButtonProps, 'appearance'>;
5
5
  /**
6
6
  * A Primary Button component with predefined primary variant
7
+ * Design system 1.0
7
8
  * @example
8
9
  * ```tsx
9
10
  * <DialPrimaryButton
@@ -68,19 +69,4 @@ export declare const DialLinkButton: FC<ButtonAppearanceProps>;
68
69
  * Inherits all properties from the `DialButtonProps`
69
70
  */
70
71
  export declare const DialGhostButton: FC<ButtonAppearanceProps>;
71
- export interface DialRoundedButtonProps extends Omit<DialButtonProps, 'variant' | 'appearance'> {
72
- selected?: boolean;
73
- }
74
- /**
75
- * A pill-shaped neutral button with an optional selected state.
76
- * @example
77
- * ```tsx
78
- * <DialRoundedButton label="Tag" selected={isActive} onClick={handleClick} />
79
- * ```
80
- *
81
- * Inherits all properties from `DialButtonProps` except `variant` and `appearance`.
82
- *
83
- * @param [selected=false] - Applies accent-primary tint and border when true
84
- */
85
- export declare const DialRoundedButton: FC<DialRoundedButtonProps>;
86
72
  export {};
@@ -7,6 +7,7 @@ export interface DialButtonDropdownProps extends Omit<DialButtonProps, 'iconAfte
7
7
  /**
8
8
  * A Button dropdown component based on DialDropdown component
9
9
  * aliases: SplitButton|MenuButton
10
+ * Design system 1.0
10
11
  *
11
12
  * @example
12
13
  * ```tsx
@@ -7,6 +7,7 @@ export interface DialCaptionTextProps extends HTMLAttributes<HTMLSpanElement> {
7
7
  /**
8
8
  * A component for displaying error messages with consistent styling
9
9
  * aliases: HelperText|ValidationText
10
+ * Design system 1.0
10
11
  *
11
12
  * @example
12
13
  * ```tsx
@@ -11,6 +11,7 @@ export interface DialCheckboxProps extends Omit<LabelHTMLAttributes<HTMLLabelEle
11
11
  /**
12
12
  * A Checkbox component with styling options
13
13
  * aliases: ToggleCheckbox|MultiSelectOption
14
+ * Design system 1.0
14
15
  *
15
16
  * @example
16
17
  * ```tsx
@@ -9,6 +9,7 @@ export interface DialCloseButtonProps {
9
9
  /**
10
10
  * A Close button component with a customizable icon and accessible label.
11
11
  * aliases: DismissButton|ExitButton
12
+ * Design system 1.0
12
13
  *
13
14
  * @example
14
15
  * ```tsx
@@ -14,6 +14,7 @@ export interface DialCollapsibleSidebarProps {
14
14
  /**
15
15
  * A collapsible horizontal bar component that allows toggling between an expanded and collapsed state.
16
16
  * aliases: ToggleSidebar|CollapsiblePanel
17
+ * Design system 1.0
17
18
  *
18
19
  * It supports customizable width, title, icons, additional buttons, and flexible styling options.
19
20
  *
@@ -17,6 +17,7 @@ export interface DialConfirmationPopupProps extends DialPopupProps {
17
17
  /**
18
18
  * A confirmation dialog built with DialPopup and DialButton.
19
19
  * aliases: ConfirmDialog|WarningDialog
20
+ * Design system 1.0
20
21
  *
21
22
  * Provides an accessible modal with a title, optional description or custom content,
22
23
  * and a footer with Cancel / Confirm actions.
@@ -10,6 +10,7 @@ export interface DialDraggableItemProps {
10
10
  /**
11
11
  * A lightweight wrapper that makes its children sortable via drag-and-drop.
12
12
  * aliases: SortableItem|DragHandle
13
+ * Design system 1.0
13
14
  *
14
15
  * Renders a row with a grab handle (left) and the provided content (right).
15
16
  * Integrates with `react-dnd` using a simple "column" drag type and delegates
@@ -14,6 +14,7 @@ export interface DialDropdownIconProps extends Omit<DialDropdownProps, 'children
14
14
  /**
15
15
  * A compact icon trigger with a dropdown menu.
16
16
  * aliases: ModelPicker|IconMenu|AvatarDropdown
17
+ * Design system 1.0
17
18
  *
18
19
  * @example
19
20
  * ```tsx
@@ -11,6 +11,7 @@ export interface DialEllipsisTooltipProps extends DialTooltipContainerOptions {
11
11
  /**
12
12
  * Single-line text with CSS ellipsis that shows a tooltip **only when actually truncated**.
13
13
  * aliases: TruncatedText|TruncationTooltip
14
+ * Design system 1.0
14
15
  *
15
16
  * If the text fits, tooltip content is empty and the popup stays hidden.
16
17
  *
@@ -1,17 +1,18 @@
1
1
  import { ButtonHTMLAttributes, DetailedHTMLProps, FC, ReactNode } from 'react';
2
2
  import { DialTooltipProps } from '../Tooltip/Tooltip';
3
3
  type TooltipProps = Omit<DialTooltipProps, 'children'>;
4
- export interface DialFabButtonProps extends DetailedHTMLProps<ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement> {
4
+ export interface FabButtonProps extends DetailedHTMLProps<ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement> {
5
5
  icon?: ReactNode;
6
6
  tooltipProps?: TooltipProps;
7
7
  }
8
8
  /**
9
9
  * A Floating Action Button (FAB) component — circular icon button for primary actions.
10
10
  * aliases: FloatingActionButton|FabButton|CircularButton
11
+ * Design system 2.0
11
12
  *
12
13
  * @example
13
14
  * ```tsx
14
- * <DialFabButton
15
+ * <FabButton
15
16
  * icon={<IconArrowNarrowDown size={24} stroke={1.5} />}
16
17
  * onClick={handleClick}
17
18
  * aria-label="Scroll to bottom"
@@ -20,8 +21,12 @@ export interface DialFabButtonProps extends DetailedHTMLProps<ButtonHTMLAttribut
20
21
  *
21
22
  * inherits all properties from `ButtonHTMLAttributes<HTMLButtonElement>`
22
23
  *
24
+ * The button is icon-only, so it needs an accessible name: pass `aria-label`,
25
+ * or a string `tooltipProps.tooltip`, which is used as the label when no
26
+ * `aria-label` is given.
27
+ *
23
28
  * @param icon - Icon to display inside the button
24
29
  * @param [tooltipProps] - Optional tooltip configuration
25
30
  */
26
- export declare const DialFabButton: FC<DialFabButtonProps>;
31
+ export declare const FabButton: FC<FabButtonProps>;
27
32
  export {};
@@ -11,6 +11,7 @@ export interface DialFileIconProps {
11
11
  /**
12
12
  * Renders a file-type icon based on a file extension.
13
13
  * aliases: ExtensionIcon|TypeIcon
14
+ * Design system 1.0
14
15
  *
15
16
  * Uses DialIcon to provide consistent icon wrapper styling.
16
17
  *
@@ -207,6 +207,9 @@ export interface DialFileManagerProps {
207
207
  /**
208
208
  * File Manager layout with a collapsible folders tree, breadcrumb/search header, and a data grid.
209
209
  * aliases: FileExplorer|FileBrowser
210
+ * Design system 1.0
211
+ *
212
+ * @deprecated Import `DialFileManager` from `@epam/ai-dial-react-file-manager` instead.
210
213
  *
211
214
  * Features:
212
215
  * - Global `path` drives both the breadcrumb trail and the visible folder in the grid.
@@ -16,5 +16,6 @@ export interface FileManagerProviderProps extends Omit<DialFileManagerProps, 'ch
16
16
  * - computed grid rows
17
17
  * - new actions
18
18
  *
19
+ * @deprecated Import `FileManagerProvider` from `@epam/ai-dial-react-file-manager` instead.
19
20
  */
20
21
  export declare const FileManagerProvider: FC<FileManagerProviderProps>;
@@ -25,6 +25,9 @@ export interface DestinationFolderPopupProps extends DialFileManagerProps {
25
25
  /**
26
26
  * DestinationFolderPopup
27
27
  * aliases: FolderSelector|PathChooser
28
+ * Design system 1.0
29
+ *
30
+ * @deprecated Import `DialDestinationFolderPopup` from `@epam/ai-dial-react-file-manager` instead.
28
31
  *
29
32
  * A popup dialog for selecting a destination folder when copying or moving files.
30
33
  * Displays a File Manager interface with a footer containing action buttons and
@@ -31,8 +31,11 @@ export interface DialFoldersTreeProps {
31
31
  }
32
32
  /**
33
33
  * DialFoldersTree — A hierarchical folder tree component with nested expand/collapse support, selection highlighting,
34
+ * Design system 1.0
34
35
  * and optional file display.
35
36
  *
37
+ * @deprecated Import `DialFoldersTree` from `@epam/ai-dial-react-file-manager` instead.
38
+ *
36
39
  * Provides a fully interactive, recursive folder structure with:
37
40
  * - Expandable and collapsible items
38
41
  * - Optional file visibility
@@ -1,5 +1,7 @@
1
1
  /**
2
2
  * Hook to read the File Manager context.
3
3
  * Throws if used outside of the provider.
4
+ *
5
+ * @deprecated Import `useFileManagerContext` from `@epam/ai-dial-react-file-manager` instead.
4
6
  */
5
7
  export declare const useFileManagerContext: () => import('../FileManagerContext').FileManagerContextValue;
@@ -1,5 +1,8 @@
1
1
  import { TabModel } from '../../../models/tab';
2
2
  import { DialFileManagerTabs } from '../../../types/file-manager';
3
+ /**
4
+ * @deprecated Import `useDialFileManagerTabs` from `@epam/ai-dial-react-file-manager` instead.
5
+ */
3
6
  export declare const useDialFileManagerTabs: (tabLabels?: Record<DialFileManagerTabs, string>, initialTab?: DialFileManagerTabs) => {
4
7
  activeTab: DialFileManagerTabs;
5
8
  handleTabChange: (tab: DialFileManagerTabs) => void;
@@ -15,6 +15,7 @@ export interface DialFileNameProps {
15
15
  /**
16
16
  * Component to display a file name with a file icon and shared indicator.
17
17
  * aliases: FileDisplay|NameDisplay
18
+ * Design system 1.0
18
19
  *
19
20
  * Handles long names with ellipsis and tooltip.
20
21
  *
@@ -14,6 +14,7 @@ export interface DialFolderNameProps {
14
14
  /**
15
15
  * Component to display a folder name with a folder icon and shared indicator.
16
16
  * aliases: FolderDisplay|DirectoryName
17
+ * Design system 1.0
17
18
  *
18
19
  * Handles long names with ellipsis and tooltip.
19
20
  *
@@ -14,6 +14,7 @@ export interface DialFormItemProps extends DialFormItemBaseProps {
14
14
  /**
15
15
  * A layout wrapper for form controls with label, helper text and error message.
16
16
  * aliases: FieldWrapper|FormControl
17
+ * Design system 1.0
17
18
  *
18
19
  * Uses `DialLabel` for the label and `DialErrorText` for consistent error styling.
19
20
  * Wires accessibility with:
@@ -13,6 +13,7 @@ export interface DialFormPopupProps extends DialPopupProps {
13
13
  /**
14
14
  * A form-oriented popup dialog.
15
15
  * aliases: FormDialog|FormModal
16
+ * Design system 1.0
16
17
  *
17
18
  * Provides an accessible popup with a title, custom body,
18
19
  * and a footer with "Cancel" and "Submit" actions.
@@ -29,6 +29,7 @@ export interface DialGridProps<T extends object = Record<string, unknown>> {
29
29
  /**
30
30
  * DialGrid — A feature-rich data grid wrapper built on ag-Grid with dark theme support.
31
31
  * aliases: DataTable|TableGrid
32
+ * Design system 1.0
32
33
  *
33
34
  * Provides a pre-configured grid with:
34
35
  * - Dark theme styling with CSS variable integration
@@ -1,3 +1,4 @@
1
1
  import { ColDef, IRowNode } from 'ag-grid-community';
2
2
  export declare const baseColumnComparator: (a: string | number | undefined, b: string | number | undefined, _nodeA?: IRowNode, _nodeB?: IRowNode, isInverted?: boolean) => number;
3
+ export declare const omitUndefined: <T extends object>(value: T | undefined) => T;
3
4
  export declare const checkColDefsChanges: (cols: ColDef[], initialCols: ColDef[]) => boolean;
@@ -11,6 +11,7 @@ export interface DialDateCellRendererProps extends Partial<ICellRendererParams<R
11
11
  }
12
12
  /**
13
13
  * Minimal date cell renderer (ag-Grid compatible).
14
+ * Design system 1.0
14
15
  *
15
16
  * Renders the value in the **"MMM dd, yyyy"** format (e.g., "Jul 20, 2025"),
16
17
  * wrapped in `DialEllipsisTooltip` (tooltip only appears if truncated).
@@ -6,6 +6,7 @@ export interface DialIconProps {
6
6
  /**
7
7
  * A wrapper component for rendering icons with consistent styling
8
8
  * aliases: IconRenderer|SVGWrapper
9
+ * Design system 1.0
9
10
  *
10
11
  * @example
11
12
  * ```tsx
@@ -13,6 +13,7 @@ export interface DialIconButtonProps extends DetailedHTMLProps<ButtonHTMLAttribu
13
13
  /**
14
14
  * A Icon Button component with flexible icon and text positioning
15
15
  * aliases: IconicButton|SymbolButton
16
+ * Design system 1.0
16
17
  *
17
18
  * @example
18
19
  * ```tsx
@@ -33,6 +34,10 @@ export interface DialIconButtonProps extends DetailedHTMLProps<ButtonHTMLAttribu
33
34
  *
34
35
  * inherits all properties from the `ButtonHTMLAttributes<HTMLButtonElement>`
35
36
  *
37
+ * The button is icon-only, so it needs an accessible name: pass `aria-label`,
38
+ * or a string `tooltipProps.tooltip`, which is used as the label when no
39
+ * `aria-label` is given.
40
+ *
36
41
  * @param [variant] - Defines the visual style of the button
37
42
  * @param [appearance=ButtonAppearance.Solid] - Defines the type of the button
38
43
  * @param [size=ElementSize.Standard] - Defines the size of the button
@@ -4,6 +4,7 @@ type ButtonVariantProps = Omit<DialIconButtonProps, 'variant'>;
4
4
  type ButtonAppearanceProps = Omit<DialIconButtonProps, 'appearance'>;
5
5
  /**
6
6
  * A Primary Icon Button component with predefined primary variant
7
+ * Design system 1.0
7
8
  * @example
8
9
  * ```tsx
9
10
  * <DialPrimaryIconButton
@@ -20,6 +20,7 @@ export interface DialInputProps extends Omit<InputHTMLAttributes<HTMLInputElemen
20
20
  /**
21
21
  * A flexible input component with icon support and various styling options
22
22
  * aliases: TextField|FormInput
23
+ * Design system 1.0
23
24
  *
24
25
  * @example
25
26
  * ```tsx
@@ -20,6 +20,7 @@ export interface DialInputPopupProps {
20
20
  /**
21
21
  * An input field that opens a popup when clicked, displaying a selected value or a list of values.
22
22
  * aliases: PopupInput|ReadonlyInput
23
+ * Design system 1.0
23
24
  *
24
25
  * It supports read-only mode, error states, and disabled state, with customizable styling.
25
26
  * The modal content is rendered using a portal for seamless integration.
@@ -12,6 +12,7 @@ export interface DialJsonEditorProps {
12
12
  }
13
13
  /**
14
14
  * A JSON editor component built on top of Monaco Editor.
15
+ * Design system 1.0
15
16
  * Provides syntax highlighting, validation, and theme support for JSON editing.
16
17
  *
17
18
  * @param currentTheme - The theme to apply to the editor
@@ -8,6 +8,7 @@ export interface DialLabelProps extends NativeLabelProps {
8
8
  /**
9
9
  * A label component
10
10
  * aliases: FormLabel|RequiredIndicator
11
+ * Design system 1.0
11
12
  *
12
13
  * @example
13
14
  * ```tsx
@@ -10,6 +10,7 @@ export interface DialLabelledTextProps {
10
10
  /**
11
11
  * A label component for form fields with optional tooltip, content, and custom elements.
12
12
  * aliases: LabelValue|DisplayText
13
+ * Design system 1.0
13
14
  *
14
15
  * @example
15
16
  * ```tsx
@@ -11,6 +11,7 @@ export interface DialLoadFileAreaProps extends DialEmptyFileAreaProps {
11
11
  /**
12
12
  * A drag-and-drop file upload area component that allows users to upload files
13
13
  * aliases: FileDropZone|DragDropUpload
14
+ * Design system 1.0
14
15
  *
15
16
  * either by dragging them into the area or by selecting them through the file picker.
16
17
  * Displays helpful text, button prompts, and validation errors for file format or count limits.
@@ -10,6 +10,7 @@ export interface DialLoadFileAreaFieldProps extends DialLoadFileAreaProps {
10
10
  /**
11
11
  * A composite file upload field that combines a label, file list management,
12
12
  * aliases: UploadField|FileListField
13
+ * Design system 1.0
13
14
  *
14
15
  * and a drag-and-drop upload area. Allows users to add, remove, and validate files
15
16
  * with customizable restrictions on file types and count.
@@ -9,6 +9,7 @@ export interface DialLoaderProps {
9
9
  /**
10
10
  * A simple loading spinner component.
11
11
  * aliases: LoadingSpinner|ProgressSpinner
12
+ * Design system 1.0
12
13
  *
13
14
  * Renders a spinning SVG with optional full-width container.
14
15
  *
@@ -12,6 +12,7 @@ export interface DialMarkdownEditorProps {
12
12
  }
13
13
  /**
14
14
  * A Markdown editor component built on top of @uiw/react-md-editor.
15
+ * Design system 1.0
15
16
  * Provides markdown editing with preview capabilities and theme support.
16
17
  *
17
18
  * @example
@@ -0,0 +1,71 @@
1
+ import { FC, ReactNode } from 'react';
2
+ export interface AccordionProps {
3
+ /** Title rendered in the header. */
4
+ title: ReactNode;
5
+ /** Optional secondary text rendered under the title. */
6
+ description?: ReactNode;
7
+ /** Content revealed when the accordion is expanded. */
8
+ children?: ReactNode;
9
+ /** Controlled expanded state. When provided, the component becomes controlled. */
10
+ expanded?: boolean;
11
+ /** Initial expanded state when uncontrolled. Defaults to `false`. */
12
+ defaultExpanded?: boolean;
13
+ /** Disables toggling. */
14
+ disabled?: boolean;
15
+ /**
16
+ * Renders the panel permanently expanded: the content is always visible, the
17
+ * caret is hidden and the header is a plain heading rather than a control.
18
+ */
19
+ nonCollapsible?: boolean;
20
+ /**
21
+ * Accessible name for the header control. Only needed when `title` is a node
22
+ * that carries no text of its own — a string title already names the header.
23
+ */
24
+ ariaLabel?: string;
25
+ /** Fired when the header is clicked. Receives the next expanded state. */
26
+ onToggle?: (expanded: boolean) => void;
27
+ /** Additional CSS classes for the outer container. */
28
+ className?: string;
29
+ /** Additional CSS classes for the header. */
30
+ headerClassName?: string;
31
+ /** Additional CSS classes for the content region. */
32
+ contentClassName?: string;
33
+ }
34
+ /**
35
+ * A collapsible panel that toggles its content when the header is clicked.
36
+ * aliases: Collapse|Disclosure|ExpandablePanel
37
+ * Design system 2.0
38
+ *
39
+ * Works as a controlled component when `expanded` is provided, otherwise it manages
40
+ * its own state from `defaultExpanded`. The header shows a caret that rotates when
41
+ * expanded, a title, and an optional description stacked beneath it.
42
+ *
43
+ * The revealed content is a labelled `region`, so assistive tech announces it by the
44
+ * header it belongs to. `nonCollapsible` renders the header as static text instead of
45
+ * a permanently disabled button, which keeps a decorative panel out of the tab order.
46
+ *
47
+ * @example
48
+ * ```tsx
49
+ * <Accordion title="Advanced settings" description="Optional configuration">
50
+ * <p>Panel content</p>
51
+ * </Accordion>
52
+ *
53
+ * <Accordion title="Always open" nonCollapsible>
54
+ * <p>Panel content</p>
55
+ * </Accordion>
56
+ * ```
57
+ *
58
+ * @param title - Title rendered in the header.
59
+ * @param [description] - Optional secondary text rendered under the title.
60
+ * @param [children] - Content revealed when expanded.
61
+ * @param [expanded] - Controlled expanded state.
62
+ * @param [defaultExpanded=false] - Initial expanded state when uncontrolled.
63
+ * @param [disabled] - Disables toggling.
64
+ * @param [nonCollapsible] - Renders the panel permanently expanded, with a static header.
65
+ * @param [ariaLabel] - Accessible name for the header; needed when `title` carries no text.
66
+ * @param [onToggle] - Fired when the header is clicked. Receives the next expanded state.
67
+ * @param [className] - Additional CSS classes for the outer container.
68
+ * @param [headerClassName] - Additional CSS classes for the header.
69
+ * @param [contentClassName] - Additional CSS classes for the content region.
70
+ */
71
+ export declare const Accordion: FC<AccordionProps>;
@@ -0,0 +1,66 @@
1
+ import { ButtonHTMLAttributes, DetailedHTMLProps, FC, HTMLAttributeAnchorTarget, ReactNode } from 'react';
2
+ import { DialTooltipProps } from '../../Tooltip/Tooltip';
3
+ import { ButtonAppearance, ButtonVariant } from '../../../types/button';
4
+ import { ElementSize } from '../../../types/size';
5
+ type TooltipProps = Omit<DialTooltipProps, 'children'>;
6
+ export interface ButtonProps extends DetailedHTMLProps<ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement> {
7
+ variant?: ButtonVariant;
8
+ size?: ElementSize;
9
+ appearance?: ButtonAppearance;
10
+ textClassName?: string;
11
+ label?: ReactNode;
12
+ iconBefore?: ReactNode;
13
+ iconAfter?: ReactNode;
14
+ tooltipProps?: TooltipProps;
15
+ href?: string;
16
+ target?: HTMLAttributeAnchorTarget;
17
+ rel?: string;
18
+ }
19
+ /**
20
+ * A Button component with flexible icon and text positioning
21
+ * aliases: ActionButton|CallToAction
22
+ * Design system 2.0
23
+ *
24
+ * @example
25
+ * ```tsx
26
+ * <Button
27
+ * label="Click me"
28
+ * onClick={handleClick}
29
+ * iconBefore={<Icon />}
30
+ * className="custom-button"
31
+ * />
32
+ * ```
33
+ *
34
+ * @example
35
+ * ```tsx
36
+ * <Button
37
+ * label={<span>Custom <strong>Label</strong></span>}
38
+ * aria-label="Custom Label"
39
+ * onClick={handleClick}
40
+ * />
41
+ * ```
42
+ *
43
+ * inherits all properties from the `ButtonHTMLAttributes<HTMLButtonElement>`
44
+ *
45
+ * The accessible name is taken from a string `label` first, then `aria-label`,
46
+ * then — only for a button with no `label` at all — a string
47
+ * `tooltipProps.tooltip`. Pass `aria-label` when `label` is a ReactNode, since
48
+ * an icon-only button is otherwise unnamed.
49
+ *
50
+ * @param [label] - The content of the button. Can be any React node.
51
+ * @param [variant] - Defines the visual style of the button
52
+ * @param [appearance=ButtonAppearance.Solid] - Defines the type of the button
53
+ * @param [size=ElementSize.Standard] - Defines the size of the button
54
+ * @param [textClassName] - Additional CSS classes to apply specifically to the button text
55
+ * @param [iconAfter] - Icon or element to display after the button text
56
+ * @param [iconBefore] - Icon or element to display before the button text
57
+ * @param [href] - Destination to navigate to. Renders an `<a>` instead of a
58
+ * `<button>`, so the control keeps the link role, middle-click, and
59
+ * "open in new tab". Pair it with `ButtonAppearance.Link` (or `LinkButton`)
60
+ * unless a button-shaped link is intended.
61
+ * @param [target] - Anchor target, only meaningful alongside `href`
62
+ * @param [rel] - Anchor `rel`. Defaults to `noopener noreferrer` when
63
+ * `target="_blank"`.
64
+ */
65
+ export declare const Button: FC<ButtonProps>;
66
+ export {};