@epam/ai-dial-ui-kit 0.13.0-dev.57 → 0.13.0-dev.60

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 (130) hide show
  1. package/README.md +5 -0
  2. package/dist/CHANGELOG.md +10 -0
  3. package/dist/{JsonEditor-BCvdqbcv.js → JsonEditor-B5vfpxzh.js} +1 -1
  4. package/dist/{JsonEditor-Yy3JFyR4.cjs → JsonEditor-CjemqUZ2.cjs} +1 -1
  5. package/dist/{MarkdownEditor-BUC6u9en.cjs → MarkdownEditor-BrUvRwsB.cjs} +1 -1
  6. package/dist/{MarkdownEditor-_RQIObYV.js → MarkdownEditor-DKG9YlGS.js} +1 -1
  7. package/dist/{MarkdownEditor-L5wQ88mr.js → MarkdownEditor-DWcVxbdX.js} +15 -15
  8. package/dist/{MarkdownEditor-DdvzJy9k.cjs → MarkdownEditor-xg-rmepY.cjs} +1 -1
  9. package/dist/components-manifest.json +562 -164
  10. package/dist/dial-ui-kit.cjs.js +1 -1
  11. package/dist/dial-ui-kit.es.js +106 -101
  12. package/dist/{index-DcwG5QhT.js → index-B4fgly61.js} +16215 -15620
  13. package/dist/{index-ARMvZo4h.cjs → index-CY5qji3j.cjs} +34 -34
  14. package/dist/index.css +2 -2
  15. package/dist/migration-guides/0.13.0/field-label-props-unification.md +94 -0
  16. package/dist/migration-guides/0.13.0/progress-bar-2-0-rewrite.md +103 -0
  17. package/dist/migration-guides/README.md +2 -0
  18. package/dist/src/components/Accordion/Accordion.d.ts +1 -0
  19. package/dist/src/components/Analytics/Bar/Bar.d.ts +1 -0
  20. package/dist/src/components/Analytics/BarGroup/BarGroup.d.ts +1 -0
  21. package/dist/src/components/Analytics/Card/Card.d.ts +1 -0
  22. package/dist/src/components/Analytics/ErrorTag/ErrorTag.d.ts +1 -0
  23. package/dist/src/components/Analytics/Histogram/Histogram.d.ts +1 -0
  24. package/dist/src/components/AutocompleteInput/AutocompleteInputValue.d.ts +1 -0
  25. package/dist/src/components/Breadcrumb/Breadcrumb.d.ts +1 -0
  26. package/dist/src/components/Breadcrumb/BreadcrumbItem.d.ts +3 -0
  27. package/dist/src/components/Button/Button.d.ts +1 -0
  28. package/dist/src/components/Button/ButtonWrappers.d.ts +1 -0
  29. package/dist/src/components/ButtonDropdown/ButtonDropdown.d.ts +1 -0
  30. package/dist/src/components/CaptionText/CaptionText.d.ts +1 -0
  31. package/dist/src/components/Checkbox/Checkbox.d.ts +1 -0
  32. package/dist/src/components/CloseButton/CloseButton.d.ts +1 -0
  33. package/dist/src/components/CollapsibleSidebar/CollapsibleSidebar.d.ts +1 -0
  34. package/dist/src/components/ConfirmationPopup/ConfirmationPopup.d.ts +1 -0
  35. package/dist/src/components/DraggableItem/DraggableItem.d.ts +1 -0
  36. package/dist/src/components/DropdownIcon/DropdownIcon.d.ts +1 -0
  37. package/dist/src/components/EllipsisTooltip/EllipsisTooltip.d.ts +1 -0
  38. package/dist/src/components/FabButton/FabButton.d.ts +1 -0
  39. package/dist/src/components/FileIcon/FileIcon.d.ts +1 -0
  40. package/dist/src/components/FileManager/FileManager.d.ts +1 -0
  41. package/dist/src/components/FileManager/components/DestinationFolderPopup/DestinationFolderPopup.d.ts +1 -0
  42. package/dist/src/components/FileManager/components/FoldersTree/FoldersTree.d.ts +1 -0
  43. package/dist/src/components/FileName/FileName.d.ts +1 -0
  44. package/dist/src/components/FolderName/FolderName.d.ts +1 -0
  45. package/dist/src/components/FormItem/FormItem.d.ts +1 -0
  46. package/dist/src/components/FormPopup/FormPopup.d.ts +1 -0
  47. package/dist/src/components/Grid/Grid.d.ts +1 -0
  48. package/dist/src/components/Grid/renderers/DateCellRenderer.d.ts +1 -0
  49. package/dist/src/components/Icon/Icon.d.ts +1 -0
  50. package/dist/src/components/IconButton/IconButton.d.ts +1 -0
  51. package/dist/src/components/IconButton/IconButtonWrappers.d.ts +1 -0
  52. package/dist/src/components/Input/Input.d.ts +1 -0
  53. package/dist/src/components/InputPopup/InputPopup.d.ts +1 -0
  54. package/dist/src/components/JsonEditor/JsonEditor.d.ts +1 -0
  55. package/dist/src/components/Label/Label.d.ts +1 -0
  56. package/dist/src/components/LabelledText/LabelledText.d.ts +1 -0
  57. package/dist/src/components/LoadFileArea/LoadFileArea.d.ts +1 -0
  58. package/dist/src/components/LoadFileArea/LoadFileAreaField.d.ts +1 -0
  59. package/dist/src/components/Loader/Loader.d.ts +1 -0
  60. package/dist/src/components/MarkdownEditor/MarkdownEditor.d.ts +1 -0
  61. package/dist/src/components/New/Accordion/Accordion.d.ts +1 -0
  62. package/dist/src/components/New/Button/Button.d.ts +1 -0
  63. package/dist/src/components/New/Button/ButtonWrappers.d.ts +1 -0
  64. package/dist/src/components/New/ButtonDropdown/ButtonDropdown.d.ts +1 -0
  65. package/dist/src/components/New/Calendar/Calendar.d.ts +5 -2
  66. package/dist/src/components/New/CaptionText/CaptionText.d.ts +1 -0
  67. package/dist/src/components/New/CardShell/CardShell.d.ts +1 -0
  68. package/dist/src/components/New/CloseButton/CloseButton.d.ts +1 -0
  69. package/dist/src/components/New/ConfirmationPopup/ConfirmationPopup.d.ts +1 -0
  70. package/dist/src/components/New/Dropdown/Dropdown.d.ts +1 -0
  71. package/dist/src/components/New/FileDropzone/FileDropzone.d.ts +81 -0
  72. package/dist/src/components/New/FolderPath/FolderPath.d.ts +1 -0
  73. package/dist/src/components/New/Highlight/Highlight.d.ts +4 -1
  74. package/dist/src/components/New/IconButton/IconButton.d.ts +1 -0
  75. package/dist/src/components/New/IconButton/IconButtonWrappers.d.ts +1 -0
  76. package/dist/src/components/New/InfoButton/InfoButton.d.ts +1 -0
  77. package/dist/src/components/New/InlineSelect/InlineSelect.d.ts +1 -0
  78. package/dist/src/components/New/Input/Input.d.ts +7 -0
  79. package/dist/src/components/New/Label/Label.d.ts +1 -0
  80. package/dist/src/components/New/MarkdownEditor/MarkdownEditor.d.ts +1 -0
  81. package/dist/src/components/New/MarkdownEditor/constants.d.ts +6 -1
  82. package/dist/src/components/New/Notification/Notification.d.ts +1 -0
  83. package/dist/src/components/New/NumberInput/NumberInput.d.ts +1 -0
  84. package/dist/src/components/New/PasswordInput/PasswordInput.d.ts +1 -0
  85. package/dist/src/components/New/Popup/Popup.d.ts +2 -1
  86. package/dist/src/components/New/Select/MultiSelectTags.d.ts +1 -0
  87. package/dist/src/components/New/Select/Select.d.ts +1 -0
  88. package/dist/src/components/New/Switch/Switch.d.ts +38 -0
  89. package/dist/src/components/New/Tabs/Tabs.d.ts +59 -0
  90. package/dist/src/components/New/Tag/Tag.d.ts +45 -0
  91. package/dist/src/components/New/TagInput/TagInput.d.ts +72 -0
  92. package/dist/src/components/New/TagInput/utils.d.ts +21 -0
  93. package/dist/src/components/New/TagInput/utils.spec.d.ts +1 -0
  94. package/dist/src/components/New/Textarea/Textarea.d.ts +1 -0
  95. package/dist/src/components/NoDataContent/NoDataContent.d.ts +1 -0
  96. package/dist/src/components/Notification/Notification.d.ts +1 -0
  97. package/dist/src/components/NumberInput/NumberInput.d.ts +1 -0
  98. package/dist/src/components/Pagination/Pagination.d.ts +3 -0
  99. package/dist/src/components/PasswordInput/PasswordInput.d.ts +1 -0
  100. package/dist/src/components/Popup/Popup.d.ts +2 -1
  101. package/dist/src/components/ProgressBar/ProgressBar.d.ts +51 -10
  102. package/dist/src/components/RadioButton/RadioButton.d.ts +1 -0
  103. package/dist/src/components/RadioGroup/RadioGroup.d.ts +1 -0
  104. package/dist/src/components/RadioGroupPopupField/RadioGroupPopupField.d.ts +1 -0
  105. package/dist/src/components/RemoveButton/RemoveButton.d.ts +1 -0
  106. package/dist/src/components/ResizableContainer/ConditionalResizableContainer.d.ts +1 -0
  107. package/dist/src/components/ResizableContainer/ResizableContainer.d.ts +1 -0
  108. package/dist/src/components/SchemaRenderer/SchemaRenderer.d.ts +1 -0
  109. package/dist/src/components/Search/Search.d.ts +1 -0
  110. package/dist/src/components/SegmentedControl/SegmentedControl.d.ts +1 -0
  111. package/dist/src/components/Select/Select.d.ts +1 -0
  112. package/dist/src/components/SelectField/SelectField.d.ts +1 -0
  113. package/dist/src/components/SharedEntityIndicator/SharedEntityIndicator.d.ts +1 -0
  114. package/dist/src/components/Skeleton/Skeleton.d.ts +1 -0
  115. package/dist/src/components/Slider/Slider.d.ts +1 -0
  116. package/dist/src/components/Spinner/Spinner.d.ts +3 -0
  117. package/dist/src/components/Steps/Steps.d.ts +1 -0
  118. package/dist/src/components/Switch/Switch.d.ts +1 -0
  119. package/dist/src/components/Tabs/Tabs.d.ts +1 -0
  120. package/dist/src/components/Tag/Tag.d.ts +1 -0
  121. package/dist/src/components/TagInput/TagInput.d.ts +1 -0
  122. package/dist/src/components/Textarea/Textarea.d.ts +1 -0
  123. package/dist/src/components/Tooltip/Tooltip.d.ts +1 -0
  124. package/dist/src/components/Tooltip/TooltipContainer.d.ts +1 -0
  125. package/dist/src/components/Tooltip/TooltipContent.d.ts +1 -0
  126. package/dist/src/components/Tooltip/TooltipTrigger.d.ts +1 -0
  127. package/dist/src/index.d.ts +13 -2
  128. package/dist/src/utils/__tests__/file-accept.spec.d.ts +1 -0
  129. package/dist/src/utils/file-accept.d.ts +16 -0
  130. package/package.json +1 -1
@@ -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
@@ -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
  *
@@ -8,6 +8,7 @@ export interface FabButtonProps extends DetailedHTMLProps<ButtonHTMLAttributes<H
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
@@ -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,7 @@ 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
210
211
  *
211
212
  * @deprecated Import `DialFileManager` from `@epam/ai-dial-react-file-manager` instead.
212
213
  *
@@ -25,6 +25,7 @@ export interface DestinationFolderPopupProps extends DialFileManagerProps {
25
25
  /**
26
26
  * DestinationFolderPopup
27
27
  * aliases: FolderSelector|PathChooser
28
+ * Design system 1.0
28
29
  *
29
30
  * @deprecated Import `DialDestinationFolderPopup` from `@epam/ai-dial-react-file-manager` instead.
30
31
  *
@@ -31,6 +31,7 @@ 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
  *
36
37
  * @deprecated Import `DialFoldersTree` from `@epam/ai-dial-react-file-manager` instead.
@@ -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
@@ -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
@@ -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
@@ -34,6 +34,7 @@ export interface AccordionProps {
34
34
  /**
35
35
  * A collapsible panel that toggles its content when the header is clicked.
36
36
  * aliases: Collapse|Disclosure|ExpandablePanel
37
+ * Design system 2.0
37
38
  *
38
39
  * Works as a controlled component when `expanded` is provided, otherwise it manages
39
40
  * its own state from `defaultExpanded`. The header shows a caret that rotates when
@@ -19,6 +19,7 @@ export interface ButtonProps extends DetailedHTMLProps<ButtonHTMLAttributes<HTML
19
19
  /**
20
20
  * A Button component with flexible icon and text positioning
21
21
  * aliases: ActionButton|CallToAction
22
+ * Design system 2.0
22
23
  *
23
24
  * @example
24
25
  * ```tsx
@@ -4,6 +4,7 @@ type ButtonVariantProps = Omit<ButtonProps, 'variant'>;
4
4
  type ButtonAppearanceProps = Omit<ButtonProps, 'appearance'>;
5
5
  /**
6
6
  * A Primary Button component with predefined primary variant
7
+ * Design system 2.0
7
8
  * @example
8
9
  * ```tsx
9
10
  * <PrimaryButton
@@ -7,6 +7,7 @@ export interface ButtonDropdownProps extends Omit<ButtonProps, 'iconAfter'> {
7
7
  /**
8
8
  * A Button dropdown component based on the Dropdown component
9
9
  * aliases: SplitButton|MenuButton
10
+ * Design system 2.0
10
11
  *
11
12
  * @example
12
13
  * ```tsx
@@ -1,11 +1,12 @@
1
1
  import { FC } from 'react';
2
+ import { LabelProps } from '../Label/Label';
2
3
  import { CalendarMode } from '../../../types/calendar';
3
4
  export type CalendarValue = Date | string | null;
4
5
  export interface CalendarProps {
5
6
  mode?: CalendarMode;
6
7
  value?: CalendarValue;
7
8
  onChange?: (value: CalendarValue) => void;
8
- label?: string;
9
+ labelProps?: LabelProps;
9
10
  placeholder?: string;
10
11
  disabled?: boolean;
11
12
  invalid?: boolean;
@@ -20,6 +21,7 @@ export interface CalendarProps {
20
21
  /**
21
22
  * A date/time picker supporting four selection modes.
22
23
  * aliases: DatePicker|DateTimePicker
24
+ * Design system 2.0
23
25
  *
24
26
  * Renders a text-field trigger that opens a rounded month-grid popover for
25
27
  * the `date`/`datetime` modes, a masked `"HH:mm"` text field for `time`, and
@@ -33,12 +35,13 @@ export interface CalendarProps {
33
35
  * <Calendar mode={CalendarMode.Time} value={time} onChange={setTime} />
34
36
  * <Calendar mode={CalendarMode.Weekday} value={weekday} onChange={setWeekday} />
35
37
  * <Calendar mode={CalendarMode.Date} value={date} onChange={setDate} locale="de-DE" />
38
+ * <Calendar labelProps={{ label: 'Start date', required: true }} value={date} onChange={setDate} />
36
39
  * ```
37
40
  *
38
41
  * @param [mode=CalendarMode.Date] - Selection mode: date, datetime, time or weekday
39
42
  * @param [value] - Controlled value: a `Date` for date/datetime, an `"HH:mm"` string for time, an ISO weekday number (`"1"`=Monday…`"7"`=Sunday) for weekday
40
43
  * @param [onChange] - Callback fired with the next value when the selection changes
41
- * @param [label] - Optional label rendered above the control
44
+ * @param [labelProps] - Props of the {@link Label} rendered above the control, including `label`, `required` and `caption`
42
45
  * @param [placeholder] - Placeholder shown when there is no value; defaults to a mode-appropriate string ("Select date", "Select date and time", "--:--" or "Select day")
43
46
  * @param [disabled=false] - Disables the control
44
47
  * @param [invalid=false] - Applies error styling
@@ -7,6 +7,7 @@ export interface CaptionTextProps extends HTMLAttributes<HTMLSpanElement> {
7
7
  /**
8
8
  * A component for displaying caption text with consistent styling
9
9
  * aliases: HelperText|ValidationText
10
+ * Design system 2.0
10
11
  *
11
12
  * @example
12
13
  * ```tsx
@@ -2,6 +2,7 @@ import { FC, HTMLAttributes } from 'react';
2
2
  export type CardShellProps = HTMLAttributes<HTMLElement>;
3
3
  /**
4
4
  * A shared elevated card shell used as the base wrapper for browse-grid cards.
5
+ * Design system 2.0
5
6
  *
6
7
  * Renders an `<article>` with rounded corners, padding, a resting shadow, and
7
8
  * a hover lift with a stronger shadow. Respects `prefers-reduced-motion` by
@@ -10,6 +10,7 @@ export interface CloseButtonProps {
10
10
  /**
11
11
  * A close button: a ghost {@link IconButton} carrying an X icon.
12
12
  * aliases: DismissButton|ExitButton
13
+ * Design system 2.0
13
14
  *
14
15
  * Sized through {@link ElementSize} like every other 2.0 control. It defaults to
15
16
  * the small 24px box that headers and toasts want; pass `ElementSize.Standard`
@@ -17,6 +17,7 @@ export interface ConfirmationPopupProps extends PopupProps {
17
17
  /**
18
18
  * A confirmation dialog built from {@link Popup} and the 2.0 {@link Button}.
19
19
  * aliases: ConfirmDialog|WarningDialog
20
+ * Design system 2.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.
@@ -35,6 +35,7 @@ export interface DropdownProps {
35
35
  *
36
36
  * Renders the given trigger (`children`) and a floating contextual menu overlay.
37
37
  * aliases: ContextMenu|PopupMenu
38
+ * Design system 2.0
38
39
  *
39
40
  * Supports click/hover/contextMenu triggers, controlled/uncontrolled open, and an optional
40
41
  * close button inside the overlay. Placement is taken directly from Floating UI; when
@@ -0,0 +1,81 @@
1
+ import { FC, ReactNode } from 'react';
2
+ import { LabelProps } from '../Label/Label';
3
+ export interface FileDropzoneProps {
4
+ /**
5
+ * Props of the {@link Label} rendered above the area — the name of the field
6
+ * this dropzone fills, e.g. `{ label: 'Attachments', required: true }`. The
7
+ * copy inside the area is `label`, which says how to use the control rather
8
+ * than what it is for.
9
+ */
10
+ labelProps?: LabelProps;
11
+ /** Primary line of copy, e.g. `'Drag and drop it or click here to upload'`. */
12
+ label: ReactNode;
13
+ /** Secondary line of copy, e.g. `'File formats .md, .zip and .skill'`. */
14
+ description?: ReactNode;
15
+ /** Fired with the accepted files when files are picked or dropped. */
16
+ onChange: (files: File[]) => void;
17
+ /**
18
+ * Fired with files that a drop offered but `accept` excluded. The file picker
19
+ * filters by `accept` itself, so this only ever comes from a drop.
20
+ */
21
+ onReject?: (files: File[]) => void;
22
+ /** Comma-separated `accept` tokens, e.g. `'.md,.zip,.skill'` or `'image/*'`. */
23
+ accept?: string;
24
+ /** Whether more than one file can be selected at a time. */
25
+ multiple?: boolean;
26
+ /** Disables picking and dropping. */
27
+ disabled?: boolean;
28
+ /** Error message rendered below the area, which also turns its border red. */
29
+ errorText?: string;
30
+ /** Icon rendered above the copy. Defaults to an upload arrow. */
31
+ icon?: ReactNode;
32
+ /** `id` of the underlying file input. Generated when omitted. */
33
+ id?: string;
34
+ /**
35
+ * Accessible name for the control. Only needed when `label` is a node that
36
+ * carries no text of its own — a string label already names the input.
37
+ */
38
+ ariaLabel?: string;
39
+ /** Additional CSS classes for the drop area. */
40
+ className?: string;
41
+ }
42
+ /**
43
+ * A dashed drop area that takes files by drag-and-drop or through the file picker.
44
+ * aliases: LoadFileArea|FileUpload|DragDropUpload|UploadArea
45
+ * Design system 2.0
46
+ *
47
+ * The area is a label over a visually hidden file input, so the picker opens on
48
+ * click and the control stays operable by keyboard and announced as a file input
49
+ * without any extra wiring. The border highlights while a drag hovers it.
50
+ *
51
+ * `accept` is enforced on drops as well as in the picker — the browser only
52
+ * filters the latter — so `onChange` never receives a file the caller excluded.
53
+ * Rejected files go to `onReject`; all copy stays with the caller, which keeps
54
+ * validation messages in the consumer's own wording and language.
55
+ *
56
+ * @example
57
+ * ```tsx
58
+ * <FileDropzone
59
+ * label="Drag and drop it or click here to upload"
60
+ * description="File formats .md, .zip and .skill"
61
+ * accept=".md,.zip,.skill"
62
+ * onChange={(files) => upload(files)}
63
+ * onReject={() => setError('Unsupported file format')}
64
+ * />
65
+ * ```
66
+ *
67
+ * @param [labelProps] - Props of the {@link Label} naming the field, rendered above the area.
68
+ * @param label - Primary line of copy.
69
+ * @param [description] - Secondary line of copy.
70
+ * @param onChange - Fired with the accepted files.
71
+ * @param [onReject] - Fired with dropped files that `accept` excluded.
72
+ * @param [accept] - Comma-separated `accept` tokens.
73
+ * @param [multiple=false] - Whether more than one file can be selected.
74
+ * @param [disabled=false] - Disables picking and dropping.
75
+ * @param [errorText] - Error message rendered below the area.
76
+ * @param [icon] - Icon rendered above the copy.
77
+ * @param [id] - `id` of the underlying file input.
78
+ * @param [ariaLabel] - Accessible name; needed when `label` carries no text.
79
+ * @param [className] - Additional CSS classes for the drop area.
80
+ */
81
+ export declare const FileDropzone: FC<FileDropzoneProps>;
@@ -9,6 +9,7 @@ export interface FolderPathProps {
9
9
  /**
10
10
  * A read-only, non-clickable folder/location path built on top of `DialBreadcrumb`.
11
11
  * aliases: FolderBreadcrumb|LocationPath
12
+ * Design system 2.0
12
13
  *
13
14
  * Every segment is disabled (no navigation); the first segment gets a leading
14
15
  * folder icon and the last segment is styled as the current/leaf item.
@@ -12,5 +12,8 @@ export interface HighlightProps {
12
12
  /** Maximum number of lines to display before truncating. Use `1` for single-line ellipsis truncation (e.g. list rows). Defaults to `2`. */
13
13
  maxLines?: number;
14
14
  }
15
- /** Renders text with the first occurrence of `query` wrapped in a highlight mark, with ellipsis truncation and a tooltip when overflowing. */
15
+ /**
16
+ * Renders text with the first occurrence of `query` wrapped in a highlight mark, with ellipsis truncation and a tooltip when overflowing.
17
+ * Design system 2.0
18
+ */
16
19
  export declare const Highlight: FC<HighlightProps>;
@@ -13,6 +13,7 @@ export interface IconButtonProps extends DetailedHTMLProps<ButtonHTMLAttributes<
13
13
  /**
14
14
  * A Icon Button component with flexible icon and text positioning
15
15
  * aliases: IconicButton|SymbolButton
16
+ * Design system 2.0
16
17
  *
17
18
  * @example
18
19
  * ```tsx
@@ -4,6 +4,7 @@ type ButtonVariantProps = Omit<IconButtonProps, 'variant'>;
4
4
  type ButtonAppearanceProps = Omit<IconButtonProps, 'appearance'>;
5
5
  /**
6
6
  * A Primary Icon Button component with predefined primary variant
7
+ * Design system 2.0
7
8
  * @example
8
9
  * ```tsx
9
10
  * <PrimaryIconButton
@@ -6,6 +6,7 @@ export interface InfoButtonProps {
6
6
  }
7
7
  /**
8
8
  * An Info button component with a customizable icon and accessible label.
9
+ * Design system 2.0
9
10
  *
10
11
  * @example
11
12
  * ```tsx
@@ -38,6 +38,7 @@ export interface InlineSelectProps {
38
38
  }
39
39
  /**
40
40
  * An inline select control combining `InlineSelectTrigger` with `Dropdown`.
41
+ * Design system 2.0
41
42
  *
42
43
  * @example
43
44
  * ```tsx
@@ -23,6 +23,12 @@ export interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>,
23
23
  prefix?: string;
24
24
  postfix?: string;
25
25
  inputRef?: Ref<HTMLInputElement>;
26
+ /**
27
+ * Ref to the field wrapper — the bordered box holding the icons, the content
28
+ * slot and the input. Use it to measure the space `children` has to fit into;
29
+ * the input itself only ever reports its own share of the row.
30
+ */
31
+ wrapperRef?: Ref<HTMLDivElement>;
26
32
  onChange?: (value?: string) => void;
27
33
  containerClassName?: string;
28
34
  wrapperClassName?: string;
@@ -30,6 +36,7 @@ export interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>,
30
36
  /**
31
37
  * A flexible input component with icon support and various styling options
32
38
  * aliases: TextField|FormInput
39
+ * Design system 2.0
33
40
  *
34
41
  * @example
35
42
  * ```tsx
@@ -10,6 +10,7 @@ export interface LabelProps extends NativeLabelProps {
10
10
  /**
11
11
  * A label component
12
12
  * aliases: FormLabel|RequiredIndicator
13
+ * Design system 2.0
13
14
  *
14
15
  * @example
15
16
  * ```tsx
@@ -13,6 +13,7 @@ export interface MarkdownEditorProps {
13
13
  }
14
14
  /**
15
15
  * The 2.0 Markdown editor: a formatting toolbar (bold/italic/strikethrough,
16
+ * Design system 2.0
16
17
  * text style, lists, quote/link/code, table) plus an edit/live/preview mode
17
18
  * switcher and fullscreen, built on top of `@uiw/react-md-editor`.
18
19
  *
@@ -1,6 +1,11 @@
1
1
  import { ICommand } from '@uiw/react-md-editor';
2
2
  import { DIAL_ICON_SIZE } from '../../../constants/icon';
3
- export declare const MARKDOWN_TOOLBAR_ICON_SIZE = DIAL_ICON_SIZE.MD;
3
+ /** 16px inside the 24px round toolbar buttons, matching the other 2.0
4
+ * components that pair `ElementSize.Small` controls with `DIAL_ICON_SIZE.SM`.
5
+ * Keep this in sync with the `svg { size-[16px] }` rule in
6
+ * `src/styles/markdown-editor.scss`, which wins over these width/height
7
+ * attributes. */
8
+ export declare const MARKDOWN_TOOLBAR_ICON_SIZE = DIAL_ICON_SIZE.SM;
4
9
  /**
5
10
  * Left-hand formatting toolbar, built on top of `@uiw/react-md-editor`'s
6
11
  * built-in commands (which insert/toggle markdown syntax in the underlying