@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
@@ -14,6 +14,7 @@ export interface NotificationProps extends Omit<HTMLAttributes<HTMLDivElement>,
14
14
  /**
15
15
  * A contextual feedback component for displaying important messages.
16
16
  * aliases: Notification
17
+ * Design system 2.0
17
18
  *
18
19
  * Renders a colored container with an icon, message text, and an optional
19
20
  * close button.
@@ -8,6 +8,7 @@ export interface NumberInputProps extends Omit<InputProps, 'onChange' | 'type'>
8
8
  /**
9
9
  * A number field, built on {@link Input}.
10
10
  * aliases: NumericField|NumberField
11
+ * Design system 2.0
11
12
  *
12
13
  * `type` is owned by this component; every other {@link Input} prop is passed
13
14
  * through, so it shares the 2.0 field styling, sizes, label, caption and error
@@ -9,6 +9,7 @@ export interface PasswordInputProps extends Omit<InputProps, 'type' | 'iconAfter
9
9
  /**
10
10
  * A password field with a reveal toggle, built on {@link Input}.
11
11
  * aliases: SecureInput|ToggleablePassword
12
+ * Design system 2.0
12
13
  *
13
14
  * The toggle is a real `<button>`, so it is reachable by keyboard and announces
14
15
  * both its purpose and its state. `type` and `iconAfter` are owned by this
@@ -23,6 +23,7 @@ export interface PopupProps {
23
23
  /**
24
24
  * An accessible modal dialog using Floating UI.
25
25
  * aliases: Modal|Dialog
26
+ * Design system 2.0
26
27
  *
27
28
  * Renders in a portal with a scrim overlay, focus management, a header with the
28
29
  * title and close control, a scrollable body and an optional footer. Sections
@@ -66,6 +67,6 @@ export interface PopupProps {
66
67
  * @param [hideClose=false] - Whether the close button is hidden in the header
67
68
  * @param [closeAriaLabel="Close dialog"] - Accessible name of the close button
68
69
  * @param [closeOnOutsideClick=true] - Whether the popup closes when clicking outside
69
- * @param [preventKeyboardOnOpen=false] - When true, initial focus goes to a non-input guard to avoid opening the virtual keyboard on mobile
70
+ * @param [preventKeyboardOnOpen=false] - When true, initial focus goes to a non-input guard to avoid opening the virtual keyboard on mobile. Redundant since the default focuses the dialog container, which never raises the keyboard; kept for compatibility
70
71
  */
71
72
  export declare const Popup: FC<PopupProps>;
@@ -7,6 +7,7 @@ export interface MultiSelectTagsProps {
7
7
  }
8
8
  /**
9
9
  * The selected values of a multi-select, rendered as removable tags inside the
10
+ * Design system 2.0
10
11
  * field.
11
12
  *
12
13
  * @param options - All available options, used to resolve labels and icons
@@ -44,6 +44,7 @@ export interface SelectProps {
44
44
  /**
45
45
  * A versatile select supporting single and multiple selections.
46
46
  * aliases: OptionPicker|ChoiceSelector
47
+ * Design system 2.0
47
48
  *
48
49
  * The field is an {@link Input}, so it carries the 2.0 field styling, sizes,
49
50
  * label, caption and error states, and it exposes the control as a `combobox`
@@ -0,0 +1,38 @@
1
+ import { FC, InputHTMLAttributes } from 'react';
2
+ import { LabelProps } from '../Label/Label';
3
+ type NativeInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'checked' | 'onChange' | 'size'>;
4
+ export interface SwitchProps extends NativeInputProps {
5
+ labelProps?: LabelProps;
6
+ isOn?: boolean;
7
+ disabled?: boolean;
8
+ onChange?: (value: boolean) => void;
9
+ caption?: string;
10
+ }
11
+ /**
12
+ * A switch (toggle) control from the 2.0 design system.
13
+ * aliases: ToggleSwitch|BinaryToggle|Switcher
14
+ * Design system 2.0
15
+ *
16
+ * @example
17
+ * ```tsx
18
+ * <Switch
19
+ * id="notifications"
20
+ * labelProps={{ label: 'Active' }}
21
+ * isOn={isActive}
22
+ * onChange={setIsActive}
23
+ * />
24
+ * ```
25
+ *
26
+ * The track and the label text are two sibling `<label for>` elements rather
27
+ * than one wrapper, so the {@link Label} keeps its own `required` marker and
28
+ * `caption` info button — a button nested in a label forwards its clicks to the
29
+ * labelled control. Clicking either one still toggles the switch.
30
+ *
31
+ * @param [labelProps] - Props of the {@link Label} rendered next to the control
32
+ * @param [isOn=false] - The current value of the switch
33
+ * @param [disabled=false] - Whether the switch is disabled
34
+ * @param [onChange] - Callback fired with the new value when toggled
35
+ * @param [caption] - Caption text rendered below the label, and described by the switch
36
+ */
37
+ export declare const Switch: FC<SwitchProps>;
38
+ export {};
@@ -0,0 +1,59 @@
1
+ import { FC } from 'react';
2
+ /** A single tab entry rendered by {@link Tabs}. */
3
+ export interface TabItem {
4
+ /** Unique identifier used to match against `activeTabId`. */
5
+ id: string;
6
+ /** Visible label text for the tab. */
7
+ label: string;
8
+ /** Optional numeric badge rendered after the label. */
9
+ count?: number;
10
+ }
11
+ export interface TabsProps {
12
+ /** Ordered list of tabs to render. */
13
+ tabs: TabItem[];
14
+ /** ID of the currently selected tab. */
15
+ activeTabId: string;
16
+ /** Fired with the tab's `id` when the user selects a tab. */
17
+ onTabChange: (tabId: string) => void;
18
+ /**
19
+ * Accessible name for the tab list. A row of tabs carries no name of its own,
20
+ * so screen readers announce it as an unlabelled list without this.
21
+ */
22
+ ariaLabel?: string;
23
+ /** Additional CSS classes for the tab list container. */
24
+ className?: string;
25
+ /** Additional CSS classes applied to every tab. */
26
+ tabClassName?: string;
27
+ }
28
+ /**
29
+ * A horizontal row of tabs, underlining the active one and showing optional count badges.
30
+ * aliases: TabRow|TabNavigation|TabBar
31
+ * Design system 2.0
32
+ *
33
+ * Follows the ARIA tabs pattern with automatic activation: only the active tab is
34
+ * in the tab order, and the arrow keys move both focus and selection. `Home` and
35
+ * `End` jump to the first and last tab, and the arrows wrap around the ends.
36
+ *
37
+ * The component renders the tabs only; the panels stay with the consumer.
38
+ *
39
+ * @example
40
+ * ```tsx
41
+ * <Tabs
42
+ * ariaLabel="Conversation views"
43
+ * tabs={[
44
+ * { id: 'all', label: 'All', count: 12 },
45
+ * { id: 'shared', label: 'Shared with me' },
46
+ * ]}
47
+ * activeTabId={activeTabId}
48
+ * onTabChange={setActiveTabId}
49
+ * />
50
+ * ```
51
+ *
52
+ * @param tabs - Ordered list of tabs to render.
53
+ * @param activeTabId - ID of the currently selected tab.
54
+ * @param onTabChange - Fired with the tab's `id` when the user selects a tab.
55
+ * @param [ariaLabel] - Accessible name for the tab list.
56
+ * @param [className] - Additional CSS classes for the tab list container.
57
+ * @param [tabClassName] - Additional CSS classes applied to every tab.
58
+ */
59
+ export declare const Tabs: FC<TabsProps>;
@@ -0,0 +1,45 @@
1
+ import { FC, HTMLAttributes, MouseEvent, ReactNode } from 'react';
2
+ import { ElementSize } from '../../../types/size';
3
+ type NativeTagProps = Omit<HTMLAttributes<HTMLSpanElement>, 'children'>;
4
+ export interface TagProps extends NativeTagProps {
5
+ label: string;
6
+ icon?: ReactNode;
7
+ size?: ElementSize;
8
+ selected?: boolean;
9
+ disabled?: boolean;
10
+ closable?: boolean;
11
+ removeLabel?: string;
12
+ onRemove?: (event: MouseEvent<HTMLButtonElement>) => void;
13
+ }
14
+ /**
15
+ * A compact label element used for selections, filters, or categories.
16
+ * aliases: Chip|Pill
17
+ * Design system 2.0
18
+ *
19
+ * The label truncates rather than wrapping, and carries a native `title` so the
20
+ * full text stays reachable when it does.
21
+ *
22
+ * A tag with `onClick` becomes a `role="button"` operable with Enter and Space.
23
+ * Its remove control is a real nested `<button>`, so keep the two roles apart in
24
+ * the caller: a clickable tag that is also closable gives a screen reader two
25
+ * actions with no way to tell which one it landed on.
26
+ *
27
+ * @example
28
+ * ```tsx
29
+ * <Tag label="TypeScript" />
30
+ * <Tag label="TypeScript" closable onRemove={() => remove('TypeScript')} />
31
+ * <Tag label="Drafts" selected onClick={() => toggle('Drafts')} />
32
+ * ```
33
+ *
34
+ * @param label - Text content displayed inside the tag.
35
+ * @param [icon] - Icon rendered before the label.
36
+ * @param [size=ElementSize.Standard] - Tag height: standard is 24px, small is 20px.
37
+ * @param [selected=false] - Applies the accent-tinted selected styling.
38
+ * @param [disabled=false] - Dims the tag and suppresses the remove control and click handling.
39
+ * @param [closable=false] - Renders the remove button. Needs `onRemove` to appear.
40
+ * @param [removeLabel] - Accessible name of the remove button; defaults to `Remove <label>`.
41
+ * @param [onRemove] - Called when the remove button is clicked. The click does not bubble to `onClick`.
42
+ * @param [onClick] - Called when the tag itself is activated. Makes the tag a button.
43
+ */
44
+ export declare const Tag: FC<TagProps>;
45
+ export {};
@@ -0,0 +1,72 @@
1
+ import { FC } from 'react';
2
+ import { ElementSize } from '../../../types/size';
3
+ import { LabelProps } from '../Label/Label';
4
+ export interface TagInputProps {
5
+ id?: string;
6
+ /** Controlled tag list. Pass it together with `onChange`. */
7
+ value?: string[];
8
+ /** Initial tag list when the component manages its own state. */
9
+ defaultValue?: string[];
10
+ size?: ElementSize;
11
+ labelProps?: LabelProps;
12
+ placeholder?: string;
13
+ caption?: string;
14
+ error?: string;
15
+ invalid?: boolean;
16
+ disabled?: boolean;
17
+ readOnly?: boolean;
18
+ collapseTagOverflow?: boolean;
19
+ ariaLabel?: string;
20
+ tagListLabel?: string;
21
+ className?: string;
22
+ fieldClassName?: string;
23
+ tagClassName?: string;
24
+ onChange?: (tags: string[]) => void;
25
+ }
26
+ /**
27
+ * A tag input field: type a value and commit it with Enter or comma.
28
+ * aliases: MultiTag|TagField|ChipInput
29
+ * Design system 2.0
30
+ *
31
+ * The field is an {@link Input}, so it carries the 2.0 field styling, sizes,
32
+ * label, caption and error states, and the tags render as {@link Tag}s in its
33
+ * content slot. The field grows as tags wrap, unless `collapseTagOverflow` keeps
34
+ * them on one line behind a `+N` chip.
35
+ *
36
+ * Works controlled (`value` + `onChange`) or uncontrolled (`defaultValue`).
37
+ * Duplicate tags are ignored. Backspace on an empty input removes the last tag.
38
+ *
39
+ * @example
40
+ * ```tsx
41
+ * const [tags, setTags] = useState<string[]>(['React']);
42
+ *
43
+ * <TagInput
44
+ * id="skills"
45
+ * labelProps={{ label: 'Skills' }}
46
+ * placeholder="Add a skill"
47
+ * caption="Press Enter or comma to add"
48
+ * value={tags}
49
+ * onChange={setTags}
50
+ * />
51
+ * ```
52
+ *
53
+ * @param [id] - The id of the text input, linked to the label.
54
+ * @param [value] - Controlled tag list.
55
+ * @param [defaultValue=[]] - Initial tag list when uncontrolled.
56
+ * @param [size=ElementSize.Standard] - Field height: standard is 40px, small is 24px.
57
+ * @param [labelProps] - Props of the {@link Label} rendered above the field.
58
+ * @param [placeholder] - Placeholder shown while there are no tags.
59
+ * @param [caption] - Helper text rendered below the field when there is no `error`.
60
+ * @param [error] - Error message rendered below the field (pass `invalid` too for error styling).
61
+ * @param [invalid=false] - Applies the field's error styling.
62
+ * @param [disabled=false] - Disables typing and tag removal.
63
+ * @param [readOnly=false] - Shows the tags without allowing new ones or removal.
64
+ * @param [collapseTagOverflow=false] - Keep the tags on one line, replacing the ones that do not fit with a `+N` chip.
65
+ * @param [ariaLabel] - Accessible name for the text input; use it when there is no visible label.
66
+ * @param [tagListLabel="Tags"] - Accessible name of the tag list.
67
+ * @param [className] - Additional CSS classes for the outer container.
68
+ * @param [fieldClassName] - Additional CSS classes for the field itself.
69
+ * @param [tagClassName] - Additional CSS classes applied to every tag.
70
+ * @param [onChange] - Called with the new list whenever a tag is added or removed.
71
+ */
72
+ export declare const TagInput: FC<TagInputProps>;
@@ -0,0 +1,21 @@
1
+ export interface VisibleTagCountInput {
2
+ /** Width the tags have to fit into, in px. */
3
+ availableWidth: number;
4
+ /** Rendered width of every tag, in render order. */
5
+ tagWidths: number[];
6
+ /** Rendered width of the `+N` chip shown when not every tag fits. */
7
+ overflowChipWidth: number;
8
+ /** Horizontal gap between two neighbouring tags. */
9
+ gap: number;
10
+ }
11
+ /**
12
+ * How many tags of a collapsed row fit before the `+N` chip has to take over.
13
+ *
14
+ * Kept pure and separate from the component because jsdom performs no layout:
15
+ * the widths come from the DOM, but the arithmetic they feed is the part worth
16
+ * testing.
17
+ *
18
+ * A non-positive `availableWidth` means nothing has been laid out yet, so every
19
+ * tag is reported as visible and the caller is expected to skip the update.
20
+ */
21
+ export declare const getVisibleTagCount: ({ availableWidth, tagWidths, overflowChipWidth, gap, }: VisibleTagCountInput) => number;
@@ -0,0 +1 @@
1
+ export {};
@@ -12,6 +12,7 @@ export interface TextareaProps extends DetailedHTMLProps<Omit<TextareaHTMLAttrib
12
12
  /**
13
13
  * A flexible textarea component with validation support and consistent styling
14
14
  * aliases: MultilineInput|TextBox
15
+ * Design system 2.0
15
16
  *
16
17
  * @example
17
18
  * ```tsx
@@ -10,6 +10,7 @@ export interface DialNoDataContentProps {
10
10
  /**
11
11
  * A component for displaying a message and icon when there is no data to show.
12
12
  * aliases: EmptyState|NoResults
13
+ * Design system 1.0
13
14
  *
14
15
  * @example
15
16
  * ```tsx
@@ -13,6 +13,7 @@ export interface DialNotificationProps extends Omit<HTMLAttributes<HTMLDivElemen
13
13
  /**
14
14
  * A contextual feedback component for displaying important messages.
15
15
  * aliases: Notification|StatusBanner
16
+ * Design system 1.0
16
17
  *
17
18
  * Renders a colored container with an icon, message text, and an optional
18
19
  * close button.
@@ -8,6 +8,7 @@ export interface DialNumberInputProps extends Omit<DialInputProps, 'onChange'> {
8
8
  /**
9
9
  * A number input field component
10
10
  * aliases: NumericField|NumberField
11
+ * Design system 1.0
11
12
  *
12
13
  * @example
13
14
  * ```tsx
@@ -5,4 +5,7 @@ export interface DialPaginationProps {
5
5
  onPageChange: (page: number) => void;
6
6
  className?: string;
7
7
  }
8
+ /**
9
+ * Design system 1.0
10
+ */
8
11
  export declare const DialPagination: FC<DialPaginationProps>;
@@ -3,6 +3,7 @@ import { DialInputProps } from '../Input/Input';
3
3
  /**
4
4
  * A password input component with show/hide functionality and customizable props.
5
5
  * aliases: SecureInput|ToggleablePassword
6
+ * Design system 1.0
6
7
  *
7
8
  * @example
8
9
  * ```tsx
@@ -21,6 +21,7 @@ export interface DialPopupProps {
21
21
  /**
22
22
  * An accessible modal dialog component using Floating UI.
23
23
  * aliases: Modal|Dialog
24
+ * Design system 1.0
24
25
  *
25
26
  * Renders in a portal with a scrim overlay, focus management, header with a title,
26
27
  * content area, optional footer and a close control.
@@ -58,6 +59,6 @@ export interface DialPopupProps {
58
59
  * @param [size=PopupSize.Md] - Sets the max-width of the popup
59
60
  * @param [hideClose=false] Whether the close button is hidden in the header (default: false)
60
61
  * @param [closeOnOutsideClick=true] - Whether the popup closes when clicking outside (default: true)
61
- * @param [preventKeyboardOnOpen=false] - When true, initial focus goes to a non-input guard to avoid opening the virtual keyboard on mobile
62
+ * @param [preventKeyboardOnOpen=false] - When true, initial focus goes to a non-input guard to avoid opening the virtual keyboard on mobile. Redundant since the default focuses the dialog container, which never raises the keyboard; kept for compatibility
62
63
  */
63
64
  export declare const DialPopup: FC<DialPopupProps>;
@@ -1,13 +1,54 @@
1
- import { FC } from 'react';
2
- export declare enum DialProgressBarSize {
3
- Small = "sm",
4
- Medium = "md"
5
- }
6
- export interface DialProgressBarProps {
1
+ import { FC, HTMLAttributes, ReactNode } from 'react';
2
+ import { LabelProps } from '../New/Label/Label';
3
+ import { ElementSize } from '../../types/size';
4
+ type NativeProgressBarProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'>;
5
+ export interface ProgressBarProps extends NativeProgressBarProps {
7
6
  value: number;
8
7
  max?: number;
9
- size?: DialProgressBarSize;
10
- className?: string;
11
- ariaLabel?: string;
8
+ size?: ElementSize;
9
+ labelProps?: LabelProps;
10
+ valueLabel?: ReactNode;
12
11
  }
13
- export declare const DialProgressBar: FC<DialProgressBarProps>;
12
+ /**
13
+ * A horizontal bar indicating progress toward a goal.
14
+ * aliases: Progress|LoadingBar|Meter
15
+ * Design system 2.0
16
+ *
17
+ * Names itself from `labelProps.label` through `aria-labelledby`; without one it
18
+ * falls back to `aria-label`, and finally to `Progress` so the bar is never
19
+ * anonymous. Prefer a real label — several bars all announcing "Progress" tell a
20
+ * screen reader user nothing about which is which.
21
+ *
22
+ * Screen readers derive the announced percentage from the value and `max`. When
23
+ * the raw numbers are more useful than a percentage, pass `aria-valuetext`
24
+ * (e.g. `"3 of 10 files"`); it goes straight through to the element.
25
+ *
26
+ * `valueLabel` renders a readout at the end of the label row. Formatting stays
27
+ * with the caller — the bar has no way to know how many decimals or which unit
28
+ * a given quantity deserves. It does not name the bar, so pair it with a
29
+ * matching `aria-valuetext` to have the same reading announced.
30
+ *
31
+ * @example
32
+ * ```tsx
33
+ * <ProgressBar value={40} labelProps={{ label: 'Uploading' }} />
34
+ * <ProgressBar value={3} max={10} aria-valuetext="3 of 10 files" />
35
+ * <ProgressBar value={80} size={ElementSize.Small} />
36
+ *
37
+ * <ProgressBar
38
+ * value={3.313182}
39
+ * max={500}
40
+ * labelProps={{ label: 'Cost per month', caption: 'Billed monthly' }}
41
+ * valueLabel="3.31 / 500"
42
+ * aria-valuetext="3.31 of 500"
43
+ * />
44
+ * ```
45
+ *
46
+ * @param value - Current progress. Clamped into `0…max`.
47
+ * @param [max=100] - Value that counts as complete.
48
+ * @param [size=ElementSize.Standard] - Bar height: standard is 8px, small is 4px.
49
+ * @param [labelProps] - Props of the {@link Label} rendered above the bar, which also names it.
50
+ * @param [valueLabel] - Readout rendered at the end of the label row.
51
+ * @param [className] - Additional classes on the track element.
52
+ */
53
+ export declare const ProgressBar: FC<ProgressBarProps>;
54
+ export {};
@@ -18,6 +18,7 @@ export interface DialRadioButtonProps {
18
18
  /**
19
19
  * A stylized, accessible radio input with optional description.
20
20
  * aliases: ChoiceOption|RadioInput
21
+ * Design system 1.0
21
22
  *
22
23
  * Renders a native `<input type="radio" />` paired with a label. When `checked`
23
24
  * and `description` are provided, a supporting text block appears under the control.
@@ -24,6 +24,7 @@ export interface DialRadioGroupProps {
24
24
  /**
25
25
  * Groups multiple `DialRadio` options and renders custom content for the active option.
26
26
  * aliases: SelectionGroup|OptionGroup
27
+ * Design system 1.0
27
28
  *
28
29
  * Uses `DialField` as the field label and a container with `role="radiogroup"`.
29
30
  * Content provided in `radioButtons[].content` is shown under the currently active radio.
@@ -18,6 +18,7 @@ export interface RadioGroupPopupFieldProps extends Pick<DialLabelProps, 'label'
18
18
  /**
19
19
  * A composite field that opens a popup with a radio group selector.
20
20
  * aliases: PopupRadio|ChoicePopup
21
+ * Design system 1.0
21
22
  *
22
23
  * Renders a labeled readout using `DialInputPopup`; when opened, a `DialPopup`
23
24
  * displays a `DialRadioGroup` allowing the user to pick from a list of options.
@@ -6,6 +6,7 @@ export interface DialRemoveButtonProps extends Omit<DialButtonProps, 'iconBefore
6
6
  /**
7
7
  * A specialized button component for removal or delete actions.
8
8
  * aliases: DeleteButton|TrashButton
9
+ * Design system 1.0
9
10
  *
10
11
  * Renders a `DialDangerButton` with a predefined trash icon (`IconTrashX`) as the leading icon.
11
12
  * Additional props are passed directly to the underlying `DialDangerButton`.
@@ -6,6 +6,7 @@ export interface DialConditionalResizableContainerProps extends DialResizableCon
6
6
  /**
7
7
  * DialConditionalResizableContainer — A conditional wrapper around `DialResizableContainer`.
8
8
  * aliases: OptionalResize|ConditionalPanel
9
+ * Design system 1.0
9
10
  *
10
11
  * This component renders its children inside a resizable container only when `enabled` is true.
11
12
  * When `enabled` is false, children are rendered directly without any resizable behavior.
@@ -15,6 +15,7 @@ export interface DialResizableContainerProps {
15
15
  /**
16
16
  * DialResizableContainer — A reusable resizable container
17
17
  * aliases: ResizePanel|SizableContainer
18
+ * Design system 1.0
18
19
  *
19
20
  * supporting both **controlled** and **uncontrolled** width modes.
20
21
  *
@@ -3,6 +3,7 @@ import { DialSchemaRendererProps } from './types';
3
3
  /**
4
4
  * Renders a JSON Schema as a form UI with collapsible sections, validation, and default values.
5
5
  * aliases: SchemaRenderer|JsonSchemaForm
6
+ * Design system 1.0
6
7
  *
7
8
  * @example
8
9
  * ```tsx
@@ -9,6 +9,7 @@ export interface DialSearchProps extends Omit<DialInputProps, 'type' | 'size' |
9
9
  /**
10
10
  * A search input component with a customizable placeholder, icons, flexible props, and the ability
11
11
  * aliases: SearchField|QueryInput
12
+ * Design system 1.0
12
13
  *
13
14
  * to clear the input value via a clear button. Supports multiple sizes for flexible layouts.
14
15
  *
@@ -11,6 +11,7 @@ export interface DialSegmentedControlProps<T extends string> {
11
11
  * A single-select control for switching between a small set of mutually exclusive,
12
12
  * equally-sized options (e.g. view switchers).
13
13
  * aliases: SegmentedButton|ViewSwitcher
14
+ * Design system 1.0
14
15
  *
15
16
  * Renders a horizontal group of segments where every option is always visible and
16
17
  * equally sized. Supports 2 or more segments, optional per-option icons, and
@@ -41,6 +41,7 @@ export interface DialSelectProps {
41
41
  /**
42
42
  * A versatile select supporting single and multiple selections.
43
43
  * aliases: OptionPicker|ChoiceSelector
44
+ * Design system 1.0
44
45
  *
45
46
  * Single mode mirrors the legacy visual:
46
47
  * - Trigger shows the selected option's leading icon + label.
@@ -9,6 +9,7 @@ export interface DialSelectFieldProps extends Omit<DialSelectProps, 'className'
9
9
  /**
10
10
  * A Select field wrapper that composes `DialFormItem` and `DialSelect`.
11
11
  * aliases: SelectInput|ComboField
12
+ * Design system 1.0
12
13
  *
13
14
  * Provides unified label, description, error rendering and a readonly view that shows
14
15
  * the selected option labels (comma-separated in single mode, list in multiple).
@@ -10,6 +10,7 @@ export interface DialSharedEntityIndicatorProps {
10
10
  /**
11
11
  * A compact icon-only indicator to denote a "shared" entity.
12
12
  * aliases: SharedIcon|AccessIndicator
13
+ * Design system 1.0
13
14
  *
14
15
  * Renders a small arrow-up-right icon with token-based colors.
15
16
  *
@@ -24,6 +24,7 @@ export interface SkeletonProps extends HTMLAttributes<HTMLDivElement> {
24
24
  /**
25
25
  * Skeleton
26
26
  * aliases: PlaceholderUI|ShimmerLoader
27
+ * Design system 2.0
27
28
  *
28
29
  * A placeholder component to show while content is loading.
29
30
  * Provides various skeleton shapes and configurations.
@@ -24,6 +24,7 @@ export interface DialSliderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'o
24
24
  /**
25
25
  * A range slider with a custom thumb showing the current value and optional labels.
26
26
  * aliases: RangeInput|TemperatureSlider
27
+ * Design system 1.0
27
28
  *
28
29
  * @example
29
30
  * ```tsx
@@ -5,4 +5,7 @@ export interface SpinnerProps {
5
5
  fullWidth?: boolean;
6
6
  ariaLabel?: string;
7
7
  }
8
+ /**
9
+ * Design system 2.0
10
+ */
8
11
  export declare const Spinner: FC<SpinnerProps>;
@@ -8,6 +8,7 @@ export interface DialStepsProps {
8
8
  /**
9
9
  * Props for the DialSteps component, which renders a multi-step navigation UI.
10
10
  * aliases: StepWizard|ProgressSteps
11
+ * Design system 1.0
11
12
  *
12
13
  * @example
13
14
  * ```tsx
@@ -10,6 +10,7 @@ export interface DialSwitchProps {
10
10
  /**
11
11
  * A Switch component with various styling options
12
12
  * aliases: ToggleSwitch|BinaryToggle
13
+ * Design system 1.0
13
14
  *
14
15
  * @example
15
16
  * ```tsx
@@ -19,6 +19,7 @@ export interface DialTabsProps {
19
19
  /**
20
20
  * A responsive and overflow-aware tabs component that automatically adapts its layout
21
21
  * aliases: TabNavigation|TabBar
22
+ * Design system 1.0
22
23
  *
23
24
  * between a scrollable tab bar and a dropdown menu on smaller screens.
24
25
  *
@@ -20,5 +20,6 @@ export interface DialTagProps {
20
20
  }
21
21
  /**
22
22
  * A compact label element used for selections, filters, or categories.
23
+ * Design system 1.0
23
24
  */
24
25
  export declare const DialTag: FC<DialTagProps>;
@@ -17,6 +17,7 @@ export interface DialTagInputProps extends DialLabelProps {
17
17
  /**
18
18
  * A tag input field that allows users to add multiple tags using the Enter or comma key.
19
19
  * aliases: MultiTag|TagField
20
+ * Design system 1.0
20
21
  *
21
22
  * Supports removing tags, displaying field labels, optional indicators, validation states,
22
23
  * and dynamic layout adjustment when tags wrap to multiple lines.
@@ -12,6 +12,7 @@ export interface DialTextareaProps extends DetailedHTMLProps<Omit<TextareaHTMLAt
12
12
  /**
13
13
  * A flexible textarea component with validation support and consistent styling
14
14
  * aliases: MultilineInput|TextBox
15
+ * Design system 1.0
15
16
  *
16
17
  * @example
17
18
  * ```tsx
@@ -10,6 +10,7 @@ export interface DialTooltipProps extends DialTooltipContainerOptions {
10
10
  /**
11
11
  * A Tooltip component that displays information on hover
12
12
  * aliases: HoverPopover|InfoPopover
13
+ * Design system 1.0
13
14
  *
14
15
  * @example
15
16
  * ```tsx