@epam/ai-dial-ui-kit 0.15.0-dev.3 → 0.15.0-dev.30
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +185 -0
- package/dist/CHANGELOG.md +48 -0
- package/dist/{DateCellRenderer-BVM-Q8yx.cjs → DateCellRenderer-BFEh4rXZ.cjs} +26 -26
- package/dist/DateCellRenderer-J1V3xwF7.cjs +1 -0
- package/dist/IconButton-DHOFapLo.cjs +1 -0
- package/dist/{JsonEditor-qv1Z0dLX.cjs → JsonEditor-BDe6elKO.cjs} +1 -1
- package/dist/{MarkdownEditor-DHn2pYOJ.cjs → MarkdownEditor-C7BONfsl.cjs} +1 -1
- package/dist/{MarkdownEditor-jQ8nDJfx.cjs → MarkdownEditor-FVzYMdkC.cjs} +1 -1
- package/dist/{MarkdownEditorContainer-Bzcnoemw.cjs → MarkdownEditorContainer-GvlxX6kx.cjs} +1 -1
- package/dist/{Switch-CUKClcEz.cjs → Switch-DE6MrcqJ.cjs} +1 -1
- package/dist/components/Button/constants.js +9 -8
- package/dist/components/Dropdown/Dropdown.js +70 -65
- package/dist/components/Dropdown/DropdownSubMenuItem.js +63 -55
- package/dist/components/Dropdown/constants.js +16 -14
- package/dist/components/DropdownIcon/DropdownIcon.js +43 -32
- package/dist/components/FileManager/FileManager.js +373 -372
- package/dist/components/FileManager/FileManagerProvider.js +266 -264
- package/dist/components/FileManager/hooks/use-grid-context-menu.js +59 -59
- package/dist/components/New/Accordion/Accordion.js +87 -71
- package/dist/components/New/Breadcrumbs/Breadcrumbs.js +159 -0
- package/dist/components/New/Breadcrumbs/constants.js +41 -0
- package/dist/components/New/Button/Button.js +32 -32
- package/dist/components/New/Button/ButtonWrappers.js +93 -37
- package/dist/components/New/Button/constants.js +3 -0
- package/dist/components/New/Button/utils.js +18 -8
- package/dist/components/New/ButtonDropdown/ButtonDropdown.js +26 -16
- package/dist/components/New/Calendar/Calendar.js +337 -289
- package/dist/components/New/Calendar/constants.js +5 -5
- package/dist/components/New/CaptionText/CaptionText.js +18 -15
- package/dist/components/New/CardShell/CardShell.js +5 -3
- package/dist/components/New/Checkbox/Checkbox.js +67 -56
- package/dist/components/New/Checkbox/CheckboxBox.js +5 -3
- package/dist/components/New/CloseButton/CloseButton.js +18 -16
- package/dist/components/New/CollapsibleSidebar/CollapsibleSidebar.js +39 -34
- package/dist/components/New/ConfirmationPopup/ConfirmationPopup.js +44 -39
- package/dist/components/New/Dropdown/Dropdown.js +112 -105
- package/dist/components/New/Dropdown/DropdownSubMenuItem.js +17 -17
- package/dist/components/New/Dropdown/constants.js +22 -17
- package/dist/components/New/EllipsisTooltip/EllipsisTooltip.js +20 -18
- package/dist/components/New/FileDropzone/FileDropzone.js +27 -25
- package/dist/components/New/FileIcon/FileIcon.js +55 -0
- package/dist/components/New/FileIcon/constants.js +134 -0
- package/dist/components/New/FileIcon/icons/FileGlyph.js +150 -0
- package/dist/components/New/FileIcon/icons/FolderGlyph.js +50 -0
- package/dist/components/New/FileName/FileName.js +78 -0
- package/dist/components/New/FilterChips/FilterChips.js +43 -0
- package/dist/components/New/FilterChips/constants.js +5 -0
- package/dist/components/New/FolderName/FolderName.js +16 -0
- package/dist/components/New/FolderPath/FolderPath.js +29 -28
- package/dist/components/New/Highlight/Highlight.js +23 -30
- package/dist/components/New/IconButton/IconButton.js +30 -28
- package/dist/components/New/InfoButton/InfoButton.js +13 -11
- package/dist/components/New/InlineSelect/InlineSelect.js +74 -56
- package/dist/components/New/InteractiveTooltip/InteractiveTooltip.js +41 -39
- package/dist/components/New/InteractiveTooltip/constants.js +2 -2
- package/dist/components/New/Label/Label.js +13 -8
- package/dist/components/New/MenuItem/MenuItem.js +29 -27
- package/dist/components/New/MenuItem/constants.js +9 -8
- package/dist/components/New/NoDataContent/NoDataContent.js +21 -19
- package/dist/components/New/Notification/Notification.js +33 -29
- package/dist/components/New/NumberInput/NumberInput.js +42 -33
- package/dist/components/New/PasswordInput/PasswordInput.js +41 -35
- package/dist/components/New/Popup/Popup.js +46 -44
- package/dist/components/New/Popup/constants.js +3 -3
- package/dist/components/New/Radio/Radio.js +75 -64
- package/dist/components/New/RadioGroup/RadioGroup.js +76 -65
- package/dist/components/New/RadioGroupPopupField/RadioGroupPopupField.js +117 -106
- package/dist/components/New/ResizableContainer/ResizableContainer.js +42 -40
- package/dist/components/New/Search/Search.js +29 -27
- package/dist/components/New/SegmentedControl/SegmentedControl.js +29 -23
- package/dist/components/New/Select/Select.js +120 -109
- package/dist/components/New/Select/constants.js +23 -20
- package/dist/components/New/SharedEntityIndicator/SharedEntityIndicator.js +34 -0
- package/dist/components/New/Switch/Switch.js +69 -58
- package/dist/components/New/Tabs/Tabs.js +125 -61
- package/dist/components/New/Tag/Tag.js +42 -40
- package/dist/components/New/TagInput/TagInput.js +45 -43
- package/dist/components/New/ToggleIconButton/ToggleIconButton.js +26 -24
- package/dist/components/New/Tooltip/TooltipContent.js +11 -9
- package/dist/components/New/Tooltip/constants.js +1 -1
- package/dist/components/New/TransferQueue/TransferQueue.js +124 -0
- package/dist/components/New/TransferQueue/TransferQueueHeader.js +71 -0
- package/dist/components/New/TransferQueue/TransferQueueRow.js +119 -0
- package/dist/components/New/TransferQueue/constants.js +24 -0
- package/dist/components/New/constants/overlay.js +15 -9
- package/dist/components/Popup/constants.js +8 -8
- package/dist/components/ProgressBar/ProgressBar.js +45 -33
- package/dist/components/SchemaRenderer/components/SchemaAdditionalPropertiesEditor.js +46 -31
- package/dist/components/SchemaRenderer/components/SchemaField.js +19 -19
- package/dist/components/SchemaRenderer/components/SchemaFieldContent.js +18 -18
- package/dist/components/SchemaRenderer/components/SchemaKeyValueEditor.js +223 -135
- package/dist/components/SchemaRenderer/types.js +19 -8
- package/dist/components/SchemaRenderer/utils.js +122 -95
- package/dist/components/Skeleton/Skeleton.js +25 -19
- package/dist/components/Spinner/Spinner.js +7 -5
- package/dist/components/Tooltip/TooltipContent.js +11 -11
- package/dist/components-manifest.json +830 -31
- package/dist/constants/public-class-names.js +198 -0
- package/dist/dial-ui-kit.cjs +2 -2
- package/dist/dial-ui-kit.js +330 -302
- package/dist/editors.cjs +1 -1
- package/dist/file-manager.cjs +1 -1
- package/dist/grid.cjs +1 -1
- package/dist/index.css +2 -2
- package/dist/lazy-BEsZqouS.cjs +1 -0
- package/dist/merge-classes-BEJXjzkx.cjs +1 -0
- package/dist/node_modules/tailwind-merge/dist/bundle-mjs.js +419 -399
- package/dist/src/components/FileManager/FileManager.d.ts +2 -0
- package/dist/src/components/FileManager/FileManagerContext.d.ts +1 -0
- package/dist/src/components/FileManager/hooks/use-grid-context-menu.d.ts +2 -1
- package/dist/src/components/New/Accordion/Accordion.d.ts +6 -1
- package/dist/src/components/New/Breadcrumbs/Breadcrumbs.d.ts +94 -0
- package/dist/src/components/New/Breadcrumbs/constants.d.ts +60 -0
- package/dist/src/components/New/Button/Button.d.ts +4 -1
- package/dist/src/components/New/Button/ButtonWrappers.d.ts +20 -0
- package/dist/src/components/New/Button/utils.d.ts +15 -0
- package/dist/src/components/New/ButtonDropdown/ButtonDropdown.d.ts +4 -0
- package/dist/src/components/New/Calendar/Calendar.d.ts +14 -1
- package/dist/src/components/New/Calendar/constants.d.ts +1 -1
- package/dist/src/components/New/Dropdown/Dropdown.d.ts +9 -1
- package/dist/src/components/New/Dropdown/constants.d.ts +3 -0
- package/dist/src/components/New/FileIcon/FileIcon.d.ts +61 -0
- package/dist/src/components/New/FileIcon/constants.d.ts +16 -0
- package/dist/src/components/New/FileIcon/icons/FileGlyph.d.ts +18 -0
- package/dist/src/components/New/FileIcon/icons/FolderGlyph.d.ts +17 -0
- package/dist/src/components/New/FileName/FileName.d.ts +79 -0
- package/dist/src/components/New/FilterChips/FilterChips.d.ts +69 -0
- package/dist/src/components/New/FilterChips/constants.d.ts +13 -0
- package/dist/src/components/New/FolderName/FolderName.d.ts +37 -0
- package/dist/src/components/New/InlineSelect/InlineSelect.d.ts +16 -1
- package/dist/src/components/New/InteractiveTooltip/constants.d.ts +5 -4
- package/dist/src/components/New/Notification/Notification.d.ts +18 -0
- package/dist/src/components/New/Popup/constants.d.ts +1 -1
- package/dist/src/components/New/Select/constants.d.ts +3 -2
- package/dist/src/components/New/SharedEntityIndicator/SharedEntityIndicator.d.ts +35 -0
- package/dist/src/components/New/Tabs/Tabs.d.ts +54 -6
- package/dist/src/components/New/Tooltip/constants.d.ts +5 -3
- package/dist/src/components/New/TransferQueue/TransferQueue.d.ts +139 -0
- package/dist/src/components/New/TransferQueue/TransferQueueHeader.d.ts +16 -0
- package/dist/src/components/New/TransferQueue/TransferQueueRow.d.ts +10 -0
- package/dist/src/components/New/TransferQueue/constants.d.ts +6 -0
- package/dist/src/components/New/constants/overlay.d.ts +13 -0
- package/dist/src/components/Popup/constants.d.ts +1 -1
- package/dist/src/components/SchemaRenderer/types.d.ts +11 -0
- package/dist/src/components/SchemaRenderer/utils.d.ts +10 -1
- package/dist/src/constants/public-class-names.d.ts +189 -0
- package/dist/src/index.d.ts +22 -1
- package/dist/src/types/accordion.d.ts +7 -0
- package/dist/src/types/breadcrumbs.d.ts +9 -0
- package/dist/src/types/button.d.ts +1 -0
- package/dist/src/types/transfer-queue.d.ts +10 -0
- package/dist/src/utils/__tests__/timezone.spec.d.ts +1 -0
- package/dist/src/utils/sub-menu-floating.d.ts +7 -4
- package/dist/src/utils/timezone.d.ts +24 -0
- package/dist/types/accordion.js +4 -0
- package/dist/types/breadcrumbs.js +4 -0
- package/dist/types/button.js +3 -3
- package/dist/types/transfer-queue.js +4 -0
- package/dist/use-file-manager-tabs-C0h1Sq5T.cjs +3 -0
- package/dist/utils/merge-classes.js +12 -5
- package/dist/utils/sub-menu-floating.js +98 -54
- package/dist/utils/timezone.js +19 -0
- package/package.json +3 -3
- package/dist/DateCellRenderer-ssp7eaZY.cjs +0 -1
- package/dist/IconButton-DWqoaBWf.cjs +0 -1
- package/dist/lazy-tfN4sKhq.cjs +0 -1
- package/dist/merge-classes-Dipy1Ih1.cjs +0 -1
- package/dist/use-file-manager-tabs-DjdR_mYM.cjs +0 -3
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.15.0-dev.
|
|
3
|
-
"generatedAt": "2026-09-
|
|
2
|
+
"version": "0.15.0-dev.30",
|
|
3
|
+
"generatedAt": "2026-09-30T09:23:39.248Z",
|
|
4
4
|
"kit": {
|
|
5
5
|
"name": "@epam/ai-dial-ui-kit",
|
|
6
6
|
"description": "A modern UI kit for building AI DIAL interfaces with React",
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"setupNotes": "## Next.js Integration\n1. Install the package. React is the only peer you have to supply — everything\n the kit renders with, it installs itself.\n\n``` bash\nnpm install @epam/ai-dial-ui-kit\nnpm install react react-dom\n```\n\nAdd the editor packages only if you use the `@epam/ai-dial-ui-kit/editors`\nsubpath. They are optional peers, so `npm install` stays quiet without them, and\nthe kit only reaches for them when a `Lazy*` editor actually mounts:\n\n``` bash\nnpm install monaco-editor @monaco-editor/react @uiw/react-md-editor\n```\n\n2. Import style in the root layout of the project:\n\n```tsx\n// app/layout.tsx\nimport \"@epam/ai-dial-ui-kit/styles.css\";\n```\n\n3. Usage example\n\n```tsx\n// app/page.tsx\n\"use client\";\nimport { DialPrimaryButton } from \"@epam/ai-dial-ui-kit\";\n\nexport default function Home() {\n return (\n <div className=\"w-full h-full flex flex-col gap-3 items-center justify-center\">\n <h1>Test library</h1>\n <DialPrimaryButton onClick={() => alert('Hello AI DIAL!')} />\n </div>\n );\n}\n```\nSee \"🎨 Theming & Customization\" section in README."
|
|
18
18
|
},
|
|
19
19
|
"styles": "# Typography CSS Utility Classes\n\n## Design-system-compliant classes (`dial-*-text`)\n\nUse these by default. They follow the design system type scale.\n\n| Class | Design name | Weight | Size / Line-height |\n| --------------------------------- | --------------------------- | -------- | ----------------------------------- |\n| `.dial-display1-text` | Display 1 | semibold | 32px / 48px |\n| `.dial-display2-text` | Display 2 | semibold | 28px / 40px |\n| `.dial-display3-text` | Display 3 | semibold | 22px / 32px |\n| `.dial-h1-text` | Heading 1 | semibold | 20px / 28px |\n| `.dial-h2-text` | Heading 2 | semibold | 18px / 26px |\n| `.dial-h3-text` | Heading 3 | semibold | 16px / 24px |\n| `.dial-body-text` | Body Text | normal | 16px / 24px |\n| `.dial-body-semi-text` | Body Text (Semi Bold) | semibold | 16px / 24px |\n| `.dial-body-paragraph-text` | Body Paragraph | normal | 16px / 26px |\n| `.dial-body-paragraph-semi-text` | Body Paragraph (Semi Bold) | semibold | 16px / 26px |\n| `.dial-small-text` | Small Text | normal | 14px / 20px |\n| `.dial-small-semi-text` | Small Text (Semi Bold) | semibold | 14px / 20px |\n| `.dial-small-paragraph-text` | Small Paragraph | normal | 14px / 24px |\n| `.dial-small-paragraph-semi-text` | Small Paragraph (Semi Bold) | semibold | 14px / 24px |\n| `.dial-tiny-text` | Tiny Text | normal | 12px / 16px |\n| `.dial-tiny-lead-text` | Tiny Text Lead | normal | 12px / 16px (+0.03em, uppercase) |\n| `.dial-tiny-semi-text` | Tiny Text (Semi Bold) | semibold | 12px / 16px |\n| `.dial-tiny-lead-semi-text` | Tiny Text Lead (Semi Bold) | semibold | 12px / 16px (+0.03em, uppercase) |\n| `.dial-caption-text` | Caption | normal | 10px / 12px |\n| `.dial-caption-lead-semi-text` | Caption Lead (Semi Bold) | semibold | 10px / 12px (+0.06em, uppercase) |\n| `.dial-code-text` | Code | normal | 14px / 20px (Fira Code / monospace) |\n| `.dial-italic-text` | Italic | normal | 18px / 22px (serif, italic) |\n| `.dial-small-italic-text` | Small Italic | normal | 14px / 20px (serif, italic) |\n| `.dial-tiny-italic-text` | Tiny Italic | normal | 12px / 16px (serif, italic) |\n| `.dial-caption-italic-text` | Caption Italic | normal | 10px / 12px (serif, italic) |\n\nThe three `*-lead-*` classes apply `text-transform: uppercase` themselves — pass them the sentence-case string, not a pre-uppercased one, so the accessible name stays readable.\n\n`.dial-code-text` resolves its family through `var(--theme-font-mono, var(--font-fira-code, 'Fira Code'))` before falling back to the system monospace stack. The kit ships no font file; the host provides the face.\n\nThe `*-italic-text` classes use a serif italic face and are intended for mathematical and formula symbols. Their line-heights follow the corresponding typography size; the default 18px variant uses a fixed 22px line-height to keep standalone symbols vertically aligned without changing their container's height.\n\n## Legacy classes (avoid in new code)\n\nClasses like `dial-h1`, `dial-h2`, `dial-body`, `dial-small*`, `dial-tiny*`, `dial-caption` are legacy. They can be used in legacy projects if user explicidly specify they need legacy typography.\n\n## Raw SCSS source\n",
|
|
20
|
-
"theming": "# Theming & CSS Variable Tokens\n\nAI DIAL UI Kit uses CSS custom properties (variables) for theming.\nDark and light themes are switched by setting different values for these variables on `:root` or a theme wrapper element.\n\n## Usage in Tailwind\n\nThe Tailwind config maps CSS variables to utility classes.\nUse these classes in your components:\n\n```tsx\n// Backgrounds\n<div className=\"bg-layer-0\" /> // darkest background\n<div className=\"bg-layer-1\" /> // main content area\n<div className=\"bg-layer-2\" /> // elevated panels\n\n// Text\n<span className=\"text-primary\" /> // main text color\n<span className=\"text-secondary\" /> // muted text\n<span className=\"text-error\" /> // error state\n\n// Borders\n<div className=\"border border-primary\" /> // standard border\n<div className=\"border border-error\" /> // error border\n```\n\n## Override CSS Variables\n\n```css\n:root {\n --bg-layer-0: #000000;\n --bg-layer-1: #0c101d;\n --bg-layer-2: #161b2d;\n --bg-layer-3: #1d2439;\n --text-primary: #eef1f7;\n --text-secondary: #9fa6bd;\n --text-error: #f76464;\n --stroke-primary: #696e7c;\n --controls-bg-accent-primary: #3664e2;\n /* ... see tailwind.config.js for full list */\n}\n```\n\n## Token Reference\n\n\n### backgroundsColors\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `layer-sunken` | `var(--bg-layer-sunken)` | `#EEF1F7` |\n| `layer-base` | `var(--bg-layer-base)` | `#F5F7FA` |\n| `layer-raised` | `var(--bg-layer-raised)` | `#FCFCFC` |\n| `gradient-1` | `var(--bg-gradient-1)` | `#1D4ED8` |\n| `gradient-1-hover` | `var(--bg-gradient-1-hover)` | `#6785FB` |\n| `gradient-1-active` | `var(--bg-gradient-1-active)` | `#1D4ED8` |\n| `gradient-2` | `var(--bg-gradient-2)` | `#885DF2` |\n| `gradient-2-hover` | `var(--bg-gradient-2-hover)` | `#885DF2` |\n| `gradient-2-active` | `var(--bg-gradient-2-active)` | `#7C3AED` |\n| `control-accent-alpha` | `var(--bg-control-accent-alpha)` | `#2764D90F` |\n| `control-accent-alpha-hover` | `var(--bg-control-accent-alpha-hover)` | `#2764D924` |\n| `control-accent-alpha-active` | `var(--bg-control-accent-alpha-active)` | `#2764D933` |\n| `control-accent` | `var(--bg-control-accent)` | `#1D4ED8` |\n| `control-accent-hover` | `var(--bg-control-accent-hover)` | `#5976E9` |\n| `control-neutral` | `var(--bg-control-neutral)` | `#FCFCFC` |\n| `control-neutral-hover-strong` | `var(--bg-control-neutral-hover-strong)` | `#848E9C` |\n| `control-neutral-active` | `var(--bg-control-neutral-active)` | `#D1DBEA` |\n| `control-neutral-default` | `var(--bg-control-neutral-default)` | `#ACB3C3` |\n| `control-inverted` | `var(--bg-control-inverted)` | `#57647A` |\n| `control-error` | `var(--bg-control-error)` | `#AE2F2F` |\n| `control-error-hover` | `var(--bg-control-error-hover)` | `#BF3939` |\n| `control-error-active` | `var(--bg-control-error-active)` | `#CC4545` |\n| `control-error-alpha-hover` | `var(--bg-control-error-alpha-hover)` | `#F764641A` |\n| `control-error-alpha-active` | `var(--bg-control-error-alpha-active)` | `#F7646433` |\n| `control-disable-primary` | `var(--bg-control-disable-primary)` | `#DCE0E8` |\n| `control-disable-secondary` | `var(--bg-control-disable-secondary)` | `#ACB3C3` |\n| `green-1` | `var(--bg-visual-green-1)` | `#CDE8E5` |\n| `green-2` | `var(--bg-visual-green-2)` | `#D1F0DC` |\n| `violet-1` | `var(--bg-visual-violet-1)` | `#DDE3F9` |\n| `violet-2` | `var(--bg-visual-violet-2)` | `#F1E9FF` |\n\n### shadowColors\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `xs-1` | `var(--shadow-xs-1)` | `#2764D933` |\n| `xs-2` | `var(--shadow-xs-2)` | `#161B2D08` |\n\n### borderColors\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `accent-alpha` | `var(--stroke-accent-alpha)` | `#2764D933` |\n| `gradient-1` | `var(--stroke-gradient-1)` | `#5976E9` |\n| `gradient-2` | `var(--stroke-gradient-2)` | `#885DF2` |\n| `accent-focus` | `var(--stroke-accent-focus)` | `#6785FB` |\n| `error-alpha` | `var(--stroke-error-alpha)` | `#AE2F2F73` |\n| `control-disable-primary` | `var(--stroke-control-disable-primary)` | `#848E9C` |\n\n### textColors\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `warning-icon` | `var(--text-warning-icon)` | `#EEC840` |\n| `green-1` | `var(--text-visual-green-1)` | `#059669` |\n| `green-2` | `var(--text-visual-green-2)` | `#0D6E72` |\n| `green-3` | `var(--text-visual-green-3)` | `#065F46` |\n| `brown-1` | `var(--text-visual-brown-1)` | `#D36817` |\n| `brown-2` | `var(--text-visual-brown-2)` | `#B45309` |\n| `violet-1` | `var(--text-visual-violet-1)` | `#7C3AED` |\n| `violet-2` | `var(--text-visual-violet-2)` | `#3730B7` |\n| `control-permanent` | `var(--text-control-permanent)` | `#FCFCFC` |\n| `control-inverted` | `var(--text-control-inverted)` | `#FCFCFC` |\n| `control-disable-primary` | `var(--text-control-disable-primary)` | `#848E9C` |\n| `control-disable-secondary` | `var(--text-control-disable-secondary)` | `#DCE0E8` |\n| `control-accent-hover` | `var(--text-control-accent-hover)` | `#5976E9` |\n| `control-accent-active` | `var(--text-control-accent-active)` | `#6785FB` |\n\n### backgroundsColorsToRemove\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `layer-0` | `var(--bg-layer-0)` | `#FCFCFC` |\n| `layer-1` | `var(--bg-layer-1)` | `#E0E6F0` |\n| `layer-2` | `var(--bg-layer-2)` | `#EEF1F7` |\n| `layer-3` | `var(--bg-layer-3)` | `#FCFCFC` |\n| `layer-4` | `var(--bg-layer-4)` | `#D1DBEA` |\n| `accent-primary-alpha` | `var(--bg-accent-primary-alpha)` | `#7DA4FF26` |\n| `accent-secondary-alpha` | `var(--bg-accent-secondary-alpha)` | `#37BABC2E` |\n| `accent-tertiary-alpha` | `var(--bg-accent-tertiary-alpha)` | `#A972FF2E` |\n| `accent-primary` | `var(--bg-accent-primary)` | `#5C8DEA` |\n| `accent-secondary` | `var(--bg-accent-secondary)` | `#37BABC` |\n| `red-400` | `var(--bg-red-400)` | `#F76464` |\n| `controls-accent-primary` | `var(--controls-bg-accent-primary)` | `#124ACE` |\n| `controls-accent-primary-hover` | `var(--controls-bg-accent-primary-hover)` | `#2656D9` |\n| `controls-accent-primary-active` | `var(--controls-bg-accent-primary-active)` | `#3664E2` |\n| `controls-accent-primary-alpha-active` | `var(--controls-bg-accent-primary-alpha-active)` | `#7DA4FF5C` |\n| `controls-accent-secondary-alpha-active` | `var(--controls-bg-accent-secondary-alpha-active)` | `#37BABC5C` |\n| `controls-accent-tertiary-alpha-active` | `var(--controls-bg-accent-tertiary-alpha-active)` | `#A972FF5C` |\n| `controls-error` | `var(--controls-bg-error)` | `#AE2F2F` |\n| `controls-error-hover` | `var(--controls-bg-error-hover)` | `#BF3939` |\n| `controls-error-active` | `var(--controls-bg-error-active)` | `#CC4545` |\n| `controls-error-alpha-active` | `var(--controls-bg-error-alpha-active)` | `#F764645C` |\n| `controls-disable-accent` | `var(--controls-bg-disable-accent)` | `#7C8293` |\n| `controls-disable` | `var(--controls-bg-disable)` | `#D1DBEA` |\n| `controls-neutral-hover` | `var(--controls-bg-neutral-hover)` | `#D1DBEA` |\n| `controls-neutral-active` | `var(--controls-bg-neutral-active)` | `#9FA6BD` |\n| `controls-accent-success-alpha-hover` | `var(--controls-bg-accent-success-alpha-hover)` | `#37BABC2E` |\n| `controls-accent-success-alpha-active` | `var(--controls-bg-accent-success-alpha-active)` | `#37BABC5C` |\n| `controls-enable-primary` | `var(--controls-enable-primary)` | `#FCFCFC` |\n\n### borderColorsToRemove\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `accent-primary` | `var(--stroke-accent-primary)` | `#124ACE` |\n| `accent-secondary` | `var(--stroke-accent-secondary)` | `#007274` |\n| `controls-accent` | `var(--controls-bg-accent)` | `#5C8DEA` |\n| `red-900` | `var(--red-900)` | `#402027` |\n\n### textColorsToRemove\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `accent-primary` | `var(--text-accent-primary)` | `#7DA4FF` |\n| `accent-secondary` | `var(--text-accent-secondary)` | `#37BABC` |\n| `accent-tertiary` | `var(--text-accent-tertiary)` | `#A972FF` |\n| `controls-permanent` | `var(--controls-text-permanent)` | `#FCFCFC` |\n| `controls-accent-disable` | `var(--controls-text-accent-disable)` | `#D1DBEA` |\n| `controls-primary-disable` | `var(--controls-text-primary-disable)` | `#696E7C` |\n| `controls-secondary-disable` | `var(--controls-text-secondary-disable)` | `#9FA6BD` |\n| `controls-neutral` | `var(--controls-text-neutral)` | `#161B2D` |\n| `controls-accent-primary-hover` | `var(--controls-text-accent-primary-hover)` | `#3664E2` |\n| `controls-accent-primary-active` | `var(--controls-text-accent-primary-active)` | `#7DA4FF` |",
|
|
20
|
+
"theming": "# Theming & CSS Variable Tokens\n\nAI DIAL UI Kit uses CSS custom properties (variables) for theming.\nDark and light themes are switched by setting different values for these variables on `:root` or a theme wrapper element.\n\n## Usage in Tailwind\n\nThe Tailwind config maps CSS variables to utility classes.\nUse these classes in your components:\n\n```tsx\n// Backgrounds\n<div className=\"bg-layer-0\" /> // darkest background\n<div className=\"bg-layer-1\" /> // main content area\n<div className=\"bg-layer-2\" /> // elevated panels\n\n// Text\n<span className=\"text-primary\" /> // main text color\n<span className=\"text-secondary\" /> // muted text\n<span className=\"text-error\" /> // error state\n\n// Borders\n<div className=\"border border-primary\" /> // standard border\n<div className=\"border border-error\" /> // error border\n```\n\n## Override CSS Variables\n\n```css\n:root {\n --bg-layer-0: #000000;\n --bg-layer-1: #0c101d;\n --bg-layer-2: #161b2d;\n --bg-layer-3: #1d2439;\n --text-primary: #eef1f7;\n --text-secondary: #9fa6bd;\n --text-error: #f76464;\n --stroke-primary: #696e7c;\n --controls-bg-accent-primary: #3664e2;\n /* ... see tailwind.config.js for full list */\n}\n```\n\n## Overlay stacking\n\nPortalled overlays stack on a ladder driven by one variable, `--z-overlay`\n(default `52`): `z-popup` (base — `Popup` backdrop), `z-floating` (+1 —\n`Dropdown`/`Select` overlays, submenus, `Calendar`), `z-interactive-tooltip`\n(+2 — `InteractiveTooltip`), `z-tooltip` (+3 — `Tooltip`). To lift every\noverlay above a host's own sticky header or modal, set the base once on `:root`\n(or in a `ThemeScope` class) — the steps move together, so their order is kept:\n\n```css\n:root {\n --z-overlay: 1000;\n}\n```\n\nDo not override `[role='menu']` or hardcode `z-[53]` in a host. To move one\noverlay only, pass a `z-*` utility through its class prop (`listClassName`,\n`overlayClassName`, `contentClassName`, `panelClassName`) — `mergeClasses`\nreplaces the layer's step with it.\n\n## Token Reference\n\n\n### backgroundsColors\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `layer-sunken` | `var(--bg-layer-sunken)` | `#EEF1F7` |\n| `layer-base` | `var(--bg-layer-base)` | `#F5F7FA` |\n| `layer-raised` | `var(--bg-layer-raised)` | `#FCFCFC` |\n| `gradient-1` | `var(--bg-gradient-1)` | `#1D4ED8` |\n| `gradient-1-hover` | `var(--bg-gradient-1-hover)` | `#6785FB` |\n| `gradient-1-active` | `var(--bg-gradient-1-active)` | `#1D4ED8` |\n| `gradient-2` | `var(--bg-gradient-2)` | `#885DF2` |\n| `gradient-2-hover` | `var(--bg-gradient-2-hover)` | `#885DF2` |\n| `gradient-2-active` | `var(--bg-gradient-2-active)` | `#7C3AED` |\n| `control-accent-alpha` | `var(--bg-control-accent-alpha)` | `#2764D90F` |\n| `control-accent-alpha-hover` | `var(--bg-control-accent-alpha-hover)` | `#2764D924` |\n| `control-accent-alpha-active` | `var(--bg-control-accent-alpha-active)` | `#2764D933` |\n| `control-accent` | `var(--bg-control-accent)` | `#1D4ED8` |\n| `control-accent-hover` | `var(--bg-control-accent-hover)` | `#5976E9` |\n| `control-neutral` | `var(--bg-control-neutral)` | `#FCFCFC` |\n| `control-neutral-hover-strong` | `var(--bg-control-neutral-hover-strong)` | `#848E9C` |\n| `control-neutral-active` | `var(--bg-control-neutral-active)` | `#D1DBEA` |\n| `control-neutral-default` | `var(--bg-control-neutral-default)` | `#ACB3C3` |\n| `control-inverted` | `var(--bg-control-inverted)` | `#57647A` |\n| `control-error` | `var(--bg-control-error)` | `#AE2F2F` |\n| `control-error-hover` | `var(--bg-control-error-hover)` | `#BF3939` |\n| `control-error-active` | `var(--bg-control-error-active)` | `#CC4545` |\n| `control-error-alpha-hover` | `var(--bg-control-error-alpha-hover)` | `#F764641A` |\n| `control-error-alpha-active` | `var(--bg-control-error-alpha-active)` | `#F7646433` |\n| `control-disable-primary` | `var(--bg-control-disable-primary)` | `#DCE0E8` |\n| `control-disable-secondary` | `var(--bg-control-disable-secondary)` | `#ACB3C3` |\n| `green-1` | `var(--bg-visual-green-1)` | `#CDE8E5` |\n| `green-2` | `var(--bg-visual-green-2)` | `#D1F0DC` |\n| `violet-1` | `var(--bg-visual-violet-1)` | `#DDE3F9` |\n| `violet-2` | `var(--bg-visual-violet-2)` | `#F1E9FF` |\n\n### shadowColors\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `xs-1` | `var(--shadow-xs-1)` | `#2764D933` |\n| `xs-2` | `var(--shadow-xs-2)` | `#161B2D08` |\n\n### borderColors\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `accent-alpha` | `var(--stroke-accent-alpha)` | `#2764D933` |\n| `gradient-1` | `var(--stroke-gradient-1)` | `#5976E9` |\n| `gradient-2` | `var(--stroke-gradient-2)` | `#885DF2` |\n| `accent-focus` | `var(--stroke-accent-focus)` | `#6785FB` |\n| `error-alpha` | `var(--stroke-error-alpha)` | `#AE2F2F73` |\n| `control-disable-primary` | `var(--stroke-control-disable-primary)` | `#848E9C` |\n\n### textColors\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `warning-icon` | `var(--text-warning-icon)` | `#EEC840` |\n| `green-1` | `var(--text-visual-green-1)` | `#059669` |\n| `green-2` | `var(--text-visual-green-2)` | `#0D6E72` |\n| `green-3` | `var(--text-visual-green-3)` | `#065F46` |\n| `brown-1` | `var(--text-visual-brown-1)` | `#D36817` |\n| `brown-2` | `var(--text-visual-brown-2)` | `#B45309` |\n| `violet-1` | `var(--text-visual-violet-1)` | `#7C3AED` |\n| `violet-2` | `var(--text-visual-violet-2)` | `#3730B7` |\n| `control-permanent` | `var(--text-control-permanent)` | `#FCFCFC` |\n| `control-inverted` | `var(--text-control-inverted)` | `#FCFCFC` |\n| `control-disable-primary` | `var(--text-control-disable-primary)` | `#848E9C` |\n| `control-disable-secondary` | `var(--text-control-disable-secondary)` | `#DCE0E8` |\n| `control-accent-hover` | `var(--text-control-accent-hover)` | `#5976E9` |\n| `control-accent-active` | `var(--text-control-accent-active)` | `#6785FB` |\n\n### backgroundsColorsToRemove\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `layer-0` | `var(--bg-layer-0)` | `#FCFCFC` |\n| `layer-1` | `var(--bg-layer-1)` | `#E0E6F0` |\n| `layer-2` | `var(--bg-layer-2)` | `#EEF1F7` |\n| `layer-3` | `var(--bg-layer-3)` | `#FCFCFC` |\n| `layer-4` | `var(--bg-layer-4)` | `#D1DBEA` |\n| `accent-primary-alpha` | `var(--bg-accent-primary-alpha)` | `#7DA4FF26` |\n| `accent-secondary-alpha` | `var(--bg-accent-secondary-alpha)` | `#37BABC2E` |\n| `accent-tertiary-alpha` | `var(--bg-accent-tertiary-alpha)` | `#A972FF2E` |\n| `accent-primary` | `var(--bg-accent-primary)` | `#5C8DEA` |\n| `accent-secondary` | `var(--bg-accent-secondary)` | `#37BABC` |\n| `red-400` | `var(--bg-red-400)` | `#F76464` |\n| `controls-accent-primary` | `var(--controls-bg-accent-primary)` | `#124ACE` |\n| `controls-accent-primary-hover` | `var(--controls-bg-accent-primary-hover)` | `#2656D9` |\n| `controls-accent-primary-active` | `var(--controls-bg-accent-primary-active)` | `#3664E2` |\n| `controls-accent-primary-alpha-active` | `var(--controls-bg-accent-primary-alpha-active)` | `#7DA4FF5C` |\n| `controls-accent-secondary-alpha-active` | `var(--controls-bg-accent-secondary-alpha-active)` | `#37BABC5C` |\n| `controls-accent-tertiary-alpha-active` | `var(--controls-bg-accent-tertiary-alpha-active)` | `#A972FF5C` |\n| `controls-error` | `var(--controls-bg-error)` | `#AE2F2F` |\n| `controls-error-hover` | `var(--controls-bg-error-hover)` | `#BF3939` |\n| `controls-error-active` | `var(--controls-bg-error-active)` | `#CC4545` |\n| `controls-error-alpha-active` | `var(--controls-bg-error-alpha-active)` | `#F764645C` |\n| `controls-disable-accent` | `var(--controls-bg-disable-accent)` | `#7C8293` |\n| `controls-disable` | `var(--controls-bg-disable)` | `#D1DBEA` |\n| `controls-neutral-hover` | `var(--controls-bg-neutral-hover)` | `#D1DBEA` |\n| `controls-neutral-active` | `var(--controls-bg-neutral-active)` | `#9FA6BD` |\n| `controls-accent-success-alpha-hover` | `var(--controls-bg-accent-success-alpha-hover)` | `#37BABC2E` |\n| `controls-accent-success-alpha-active` | `var(--controls-bg-accent-success-alpha-active)` | `#37BABC5C` |\n| `controls-enable-primary` | `var(--controls-enable-primary)` | `#FCFCFC` |\n\n### borderColorsToRemove\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `accent-primary` | `var(--stroke-accent-primary)` | `#124ACE` |\n| `accent-secondary` | `var(--stroke-accent-secondary)` | `#007274` |\n| `controls-accent` | `var(--controls-bg-accent)` | `#5C8DEA` |\n| `red-900` | `var(--red-900)` | `#402027` |\n\n### textColorsToRemove\n| Tailwind class suffix | CSS variable | Default value |\n|---|---|---|\n| `accent-primary` | `var(--text-accent-primary)` | `#7DA4FF` |\n| `accent-secondary` | `var(--text-accent-secondary)` | `#37BABC` |\n| `accent-tertiary` | `var(--text-accent-tertiary)` | `#A972FF` |\n| `controls-permanent` | `var(--controls-text-permanent)` | `#FCFCFC` |\n| `controls-accent-disable` | `var(--controls-text-accent-disable)` | `#D1DBEA` |\n| `controls-primary-disable` | `var(--controls-text-primary-disable)` | `#696E7C` |\n| `controls-secondary-disable` | `var(--controls-text-secondary-disable)` | `#9FA6BD` |\n| `controls-neutral` | `var(--controls-text-neutral)` | `#161B2D` |\n| `controls-accent-primary-hover` | `var(--controls-text-accent-primary-hover)` | `#3664E2` |\n| `controls-accent-primary-active` | `var(--controls-text-accent-primary-active)` | `#7DA4FF` |",
|
|
21
21
|
"components": [
|
|
22
22
|
{
|
|
23
23
|
"name": "Spinner",
|
|
@@ -212,6 +212,12 @@
|
|
|
212
212
|
"required": true,
|
|
213
213
|
"description": "Message text to display inside the alert"
|
|
214
214
|
},
|
|
215
|
+
{
|
|
216
|
+
"name": "action",
|
|
217
|
+
"type": "ReactNode",
|
|
218
|
+
"required": false,
|
|
219
|
+
"description": "Optional control (typically a small `Button`) rendered at the inline end, after the text and before the close button; the caller supplies its accessible name"
|
|
220
|
+
},
|
|
215
221
|
{
|
|
216
222
|
"name": "closable",
|
|
217
223
|
"type": "boolean",
|
|
@@ -247,7 +253,7 @@
|
|
|
247
253
|
}
|
|
248
254
|
],
|
|
249
255
|
"examples": [
|
|
250
|
-
"<Notification\n variant={NotificationVariant.Info}\n message=\"This is an info alert.\"\n/>\n\n<Notification\n variant={NotificationVariant.Success}\n title=\"Saved\"\n message=\"Changes saved successfully.\"\n/>\n\n<Notification\n variant={NotificationVariant.Error}\n closable\n message=\"Something went wrong.\"\n onClose={(e) => console.log('closed', e)}\n/>\n\n<Notification\n variant={NotificationVariant.Loading}\n title=\"Processing\"\n message=\"Please wait...\"\n/>\n\n<Notification\n variant={NotificationVariant.General}\n type={NotificationType.SectionMessage}\n title=\"Title\"\n message=\"Description text example\"\n/>"
|
|
256
|
+
"<Notification\n variant={NotificationVariant.Info}\n message=\"This is an info alert.\"\n/>\n\n<Notification\n variant={NotificationVariant.Success}\n title=\"Saved\"\n message=\"Changes saved successfully.\"\n/>\n\n<Notification\n variant={NotificationVariant.Error}\n closable\n message=\"Something went wrong.\"\n onClose={(e) => console.log('closed', e)}\n/>\n\n<Notification\n variant={NotificationVariant.Loading}\n title=\"Processing\"\n message=\"Please wait...\"\n/>\n\n<Notification\n variant={NotificationVariant.General}\n type={NotificationType.SectionMessage}\n title=\"Title\"\n message=\"Description text example\"\n/>\n\n<Notification\n variant={NotificationVariant.Error}\n type={NotificationType.SectionMessage}\n title=\"Couldn't finish this response\"\n message=\"Something went wrong. Try again in a moment.\"\n action={\n <Button\n variant={ButtonVariant.Neutral}\n appearance={ButtonAppearance.Outlined}\n size={ElementSize.Small}\n label=\"Try again\"\n onClick={handleRetry}\n />\n }\n/>"
|
|
251
257
|
],
|
|
252
258
|
"sourceFile": "components/New/Notification/Notification.tsx"
|
|
253
259
|
},
|
|
@@ -429,6 +435,12 @@
|
|
|
429
435
|
"required": false,
|
|
430
436
|
"description": "Callback fired with the next value when the selection changes"
|
|
431
437
|
},
|
|
438
|
+
{
|
|
439
|
+
"name": "onBlur",
|
|
440
|
+
"type": "FocusEventHandler<HTMLInputElement>",
|
|
441
|
+
"required": false,
|
|
442
|
+
"description": "Called when the Calendar's input field loses focus, e.g. for on-blur validation"
|
|
443
|
+
},
|
|
432
444
|
{
|
|
433
445
|
"name": "labelProps",
|
|
434
446
|
"type": "LabelProps",
|
|
@@ -491,6 +503,13 @@
|
|
|
491
503
|
"type": "string",
|
|
492
504
|
"required": false,
|
|
493
505
|
"description": "Additional classes merged onto the trigger field, overriding conflicting defaults"
|
|
506
|
+
},
|
|
507
|
+
{
|
|
508
|
+
"name": "showTimezone",
|
|
509
|
+
"type": "boolean",
|
|
510
|
+
"required": false,
|
|
511
|
+
"defaultValue": "false",
|
|
512
|
+
"description": "Shows the viewer's timezone (e.g. `(GMT+01:00) Europe/Berlin`) at the trailing edge of the `time` field"
|
|
494
513
|
}
|
|
495
514
|
],
|
|
496
515
|
"examples": [
|
|
@@ -543,6 +562,71 @@
|
|
|
543
562
|
],
|
|
544
563
|
"sourceFile": "components/New/FolderPath/FolderPath.tsx"
|
|
545
564
|
},
|
|
565
|
+
{
|
|
566
|
+
"name": "Breadcrumbs",
|
|
567
|
+
"category": "Components_2_0",
|
|
568
|
+
"generation": "2.0",
|
|
569
|
+
"description": "A navigation trail: where the user is, and every level they can step back to.\naliases: Breadcrumb|NavigationPath|BreadcrumbTrail\nDesign system 2.0\n\nThe last item is the current page — drawn semibold and primary, and never a\ncontrol, since a link to the page you are already on does nothing. Every\nearlier item with an `href` or an `onClick` is a link; one with neither is\ndrawn as plain text, which is how a read-only location path is built.\n\nThe trail never wraps. Segments truncate instead, each revealing its full\nlabel in a tooltip only once it is actually clipped, and a trail longer than\n`maxVisibleItems` collapses its middle behind an ellipsis menu — the root and\nthe current page, the two segments that carry the most meaning, always stay\non screen.\n\na11y: an `<ol>` inside a named `<nav>`, with `aria-current=\"page\"` on the last\nsegment. Separators are decorative and hidden from assistive tech, so the\ntrail is announced as a list of links rather than a string of chevrons.\n\nThe trail is drawn at `dial-small-text` by default; `size` switches it to\n`dial-h2-text` for a trail that doubles as the page heading, where the\ntoken's own semibold weight applies to every segment.\n\nLabels are the caller's to translate; the two accessible names default to\nEnglish and take an override.",
|
|
570
|
+
"props": [
|
|
571
|
+
{
|
|
572
|
+
"name": "items",
|
|
573
|
+
"type": "BreadcrumbsItem[]",
|
|
574
|
+
"required": true,
|
|
575
|
+
"description": "The trail, outermost first; the last entry is the current page"
|
|
576
|
+
},
|
|
577
|
+
{
|
|
578
|
+
"name": "maxVisibleItems",
|
|
579
|
+
"type": "number",
|
|
580
|
+
"required": false,
|
|
581
|
+
"defaultValue": "DEFAULT_MAX_VISIBLE_ITEMS",
|
|
582
|
+
"description": "Segments drawn before the middle collapses behind an ellipsis menu"
|
|
583
|
+
},
|
|
584
|
+
{
|
|
585
|
+
"name": "size",
|
|
586
|
+
"type": "BreadcrumbsSize",
|
|
587
|
+
"required": false,
|
|
588
|
+
"defaultValue": "BreadcrumbsSize.Small",
|
|
589
|
+
"description": "The trail's type scale: `dial-small-text` or `dial-h2-text`"
|
|
590
|
+
},
|
|
591
|
+
{
|
|
592
|
+
"name": "separator",
|
|
593
|
+
"type": "ReactNode",
|
|
594
|
+
"required": false,
|
|
595
|
+
"defaultValue": "defaultSeparator",
|
|
596
|
+
"description": "Node drawn between two segments; defaults to a right chevron"
|
|
597
|
+
},
|
|
598
|
+
{
|
|
599
|
+
"name": "ariaLabel",
|
|
600
|
+
"type": "string",
|
|
601
|
+
"required": false,
|
|
602
|
+
"defaultValue": "'Breadcrumb'",
|
|
603
|
+
"description": "Accessible name for the `<nav>`"
|
|
604
|
+
},
|
|
605
|
+
{
|
|
606
|
+
"name": "overflowAriaLabel",
|
|
607
|
+
"type": "string",
|
|
608
|
+
"required": false,
|
|
609
|
+
"defaultValue": "'Show hidden path segments'",
|
|
610
|
+
"description": "Accessible name for the ellipsis button"
|
|
611
|
+
},
|
|
612
|
+
{
|
|
613
|
+
"name": "className",
|
|
614
|
+
"type": "string",
|
|
615
|
+
"required": false,
|
|
616
|
+
"description": "Additional CSS classes for the `<nav>`"
|
|
617
|
+
},
|
|
618
|
+
{
|
|
619
|
+
"name": "itemClassName",
|
|
620
|
+
"type": "string",
|
|
621
|
+
"required": false,
|
|
622
|
+
"description": "Additional CSS classes applied to every segment"
|
|
623
|
+
}
|
|
624
|
+
],
|
|
625
|
+
"examples": [
|
|
626
|
+
"<Breadcrumbs\n ariaLabel={t('File path')}\n items={[\n { label: t('My files'), onClick: () => open('/') },\n { label: 'DK Test', onClick: () => open('/DK Test') },\n { label: 'DK Test with nested' },\n ]}\n/>"
|
|
627
|
+
],
|
|
628
|
+
"sourceFile": "components/New/Breadcrumbs/Breadcrumbs.tsx"
|
|
629
|
+
},
|
|
546
630
|
{
|
|
547
631
|
"name": "DangerButton",
|
|
548
632
|
"category": "Components_2_0",
|
|
@@ -610,6 +694,17 @@
|
|
|
610
694
|
],
|
|
611
695
|
"sourceFile": "components/New/Button/ButtonWrappers.tsx"
|
|
612
696
|
},
|
|
697
|
+
{
|
|
698
|
+
"name": "StarterButton",
|
|
699
|
+
"category": "Components_2_0",
|
|
700
|
+
"generation": "2.0",
|
|
701
|
+
"description": "A Starter Button component — a conversation starter: an outlined neutral\npill whose icons are stroked with the accent gradient\nDesign system 2.0\n\nAn SVG stroke cannot take a CSS gradient, so the button renders its own\n`linearGradient` with a per-instance id and hands it to its icons through\nthe `--dial-kit-starter-icon-stroke` custom property. Any icon that strokes\nwith `currentColor`, as Tabler icons do, picks it up.",
|
|
702
|
+
"props": [],
|
|
703
|
+
"examples": [
|
|
704
|
+
"<StarterButton\n label=\"Summarize this document\"\n iconBefore={<IconSparkles />}\n onClick={handleClick}\n/>"
|
|
705
|
+
],
|
|
706
|
+
"sourceFile": "components/New/Button/ButtonWrappers.tsx"
|
|
707
|
+
},
|
|
613
708
|
{
|
|
614
709
|
"name": "DangerIconButton",
|
|
615
710
|
"category": "Components_2_0",
|
|
@@ -719,7 +814,7 @@
|
|
|
719
814
|
"name": "tooltipProps",
|
|
720
815
|
"type": "ButtonTooltipProps",
|
|
721
816
|
"required": false,
|
|
722
|
-
"description": "Props of the 2.0 wrapping the button"
|
|
817
|
+
"description": "Props of the 2.0 wrapping the button.\nA disabled button with a visible tooltip is marked `aria-disabled` rather\nthan natively `disabled`, so it stays focusable and hoverable and the\ntooltip can still explain why it is unavailable; its click does nothing."
|
|
723
818
|
},
|
|
724
819
|
{
|
|
725
820
|
"name": "href",
|
|
@@ -826,6 +921,12 @@
|
|
|
826
921
|
"type": "DropdownItem[]",
|
|
827
922
|
"required": true,
|
|
828
923
|
"description": "DropdownItems with actions"
|
|
924
|
+
},
|
|
925
|
+
{
|
|
926
|
+
"name": "dropdownProps",
|
|
927
|
+
"type": "Pick<DropdownProps, 'listClassName' | 'matchReferenceWidth'>",
|
|
928
|
+
"required": false,
|
|
929
|
+
"description": "`listClassName` and `matchReferenceWidth` forwarded to the menu `Dropdown`"
|
|
829
930
|
}
|
|
830
931
|
],
|
|
831
932
|
"examples": [
|
|
@@ -961,10 +1062,35 @@
|
|
|
961
1062
|
"type": "string",
|
|
962
1063
|
"required": false
|
|
963
1064
|
},
|
|
1065
|
+
{
|
|
1066
|
+
"name": "listStyle",
|
|
1067
|
+
"type": "CSSProperties",
|
|
1068
|
+
"required": false
|
|
1069
|
+
},
|
|
964
1070
|
{
|
|
965
1071
|
"name": "ariaLabel",
|
|
966
1072
|
"type": "string",
|
|
967
1073
|
"required": false
|
|
1074
|
+
},
|
|
1075
|
+
{
|
|
1076
|
+
"name": "triggerClassName",
|
|
1077
|
+
"type": "string",
|
|
1078
|
+
"required": false
|
|
1079
|
+
},
|
|
1080
|
+
{
|
|
1081
|
+
"name": "triggerLabelClassName",
|
|
1082
|
+
"type": "string",
|
|
1083
|
+
"required": false
|
|
1084
|
+
},
|
|
1085
|
+
{
|
|
1086
|
+
"name": "open",
|
|
1087
|
+
"type": "boolean",
|
|
1088
|
+
"required": false
|
|
1089
|
+
},
|
|
1090
|
+
{
|
|
1091
|
+
"name": "onOpenChange",
|
|
1092
|
+
"type": "(open: boolean) => void",
|
|
1093
|
+
"required": false
|
|
968
1094
|
}
|
|
969
1095
|
],
|
|
970
1096
|
"examples": [
|
|
@@ -993,6 +1119,11 @@
|
|
|
993
1119
|
"type": "boolean",
|
|
994
1120
|
"required": false,
|
|
995
1121
|
"defaultValue": "false"
|
|
1122
|
+
},
|
|
1123
|
+
{
|
|
1124
|
+
"name": "labelClassName",
|
|
1125
|
+
"type": "string",
|
|
1126
|
+
"required": false
|
|
996
1127
|
}
|
|
997
1128
|
],
|
|
998
1129
|
"examples": [],
|
|
@@ -1992,6 +2123,12 @@
|
|
|
1992
2123
|
"required": false,
|
|
1993
2124
|
"description": "Additional CSS classes applied to the floating overlay"
|
|
1994
2125
|
},
|
|
2126
|
+
{
|
|
2127
|
+
"name": "listStyle",
|
|
2128
|
+
"type": "CSSProperties",
|
|
2129
|
+
"required": false,
|
|
2130
|
+
"description": "Inline style applied to the floating overlay, under the dropdown's own positioning styles"
|
|
2131
|
+
},
|
|
1995
2132
|
{
|
|
1996
2133
|
"name": "outsidePressIgnoreRef",
|
|
1997
2134
|
"type": "RefObject<HTMLElement | null>",
|
|
@@ -2186,7 +2323,7 @@
|
|
|
2186
2323
|
"name": "Accordion",
|
|
2187
2324
|
"category": "Components_2_0",
|
|
2188
2325
|
"generation": "2.0",
|
|
2189
|
-
"description": "A collapsible panel that toggles its content when the header is clicked.\naliases: Collapse|Disclosure|ExpandablePanel\nDesign system 2.0\n\nWorks as a controlled component when `expanded` is provided, otherwise it manages\nits own state from `defaultExpanded`. The header shows a caret that rotates when\nexpanded, a title, and an optional description stacked beneath it.\n\nThe revealed content is a labelled `region`, so assistive tech announces it by the\nheader it belongs to. `nonCollapsible` renders the header as static text instead of\na permanently disabled button, which keeps a decorative panel out of the tab order.",
|
|
2326
|
+
"description": "A collapsible panel that toggles its content when the header is clicked.\naliases: Collapse|Disclosure|ExpandablePanel\nDesign system 2.0\n\nWorks as a controlled component when `expanded` is provided, otherwise it manages\nits own state from `defaultExpanded`. The header shows a caret that rotates when\nexpanded, a title, and an optional description stacked beneath it.\n\nThe revealed content is a labelled `region`, so assistive tech announces it by the\nheader it belongs to. It stays mounted while collapsed so it can slide open and shut,\nand is `inert` then, out of both the tab order and the accessibility tree. `nonCollapsible` renders the header as static text instead of\na permanently disabled button, which keeps a decorative panel out of the tab order.",
|
|
2190
2327
|
"props": [
|
|
2191
2328
|
{
|
|
2192
2329
|
"name": "title",
|
|
@@ -2243,6 +2380,13 @@
|
|
|
2243
2380
|
"required": false,
|
|
2244
2381
|
"description": "Fired when the header is clicked. Receives the next expanded state."
|
|
2245
2382
|
},
|
|
2383
|
+
{
|
|
2384
|
+
"name": "caretPosition",
|
|
2385
|
+
"type": "AccordionCaretPosition",
|
|
2386
|
+
"required": false,
|
|
2387
|
+
"defaultValue": "AccordionCaretPosition.End",
|
|
2388
|
+
"description": "Where the header draws its caret: before or after the title."
|
|
2389
|
+
},
|
|
2246
2390
|
{
|
|
2247
2391
|
"name": "className",
|
|
2248
2392
|
"type": "string",
|
|
@@ -2841,7 +2985,7 @@
|
|
|
2841
2985
|
"name": "Tabs",
|
|
2842
2986
|
"category": "Components_2_0",
|
|
2843
2987
|
"generation": "2.0",
|
|
2844
|
-
"description": "A
|
|
2988
|
+
"description": "A row or rail of tabs, marking the active one and showing optional icons and count badges.\naliases: TabRow|TabNavigation|TabBar|VerticalTabs|SettingsNav|SideNav\nDesign system 2.0\n\nFollows the ARIA tabs pattern with automatic activation: only the active tab is\nin the tab order, and the arrow keys move both focus and selection. `Home` and\n`End` jump to the first and last tab, and the arrows wrap around the ends.\nTabs marked `disabled` are greyed out, cannot be clicked, and are skipped by\nkeyboard navigation.\n\n`TabOrientation.Horizontal` draws the default row: the active tab takes a\ngradient underline, and `ArrowLeft` / `ArrowRight` move along it.\n`TabOrientation.Vertical` draws the settings-page rail instead — full-width\nrows with the active one on a tinted pill rather than an underline, driven by\n`ArrowUp` / `ArrowDown`. The rail is the shape to reach for when the tabs\nlabel whole pages of a settings surface; the row, when they filter one.\n\n`className` lands on whichever element is outermost: the heading wrapper when\n`sectionLabel` is set, the `role=\"tablist\"` itself when it is not.\n\nThe component renders the tabs only; the panels stay with the consumer.",
|
|
2845
2989
|
"props": [
|
|
2846
2990
|
{
|
|
2847
2991
|
"name": "tabs",
|
|
@@ -2861,6 +3005,19 @@
|
|
|
2861
3005
|
"required": true,
|
|
2862
3006
|
"description": "Fired with the tab's `id` when the user selects a tab."
|
|
2863
3007
|
},
|
|
3008
|
+
{
|
|
3009
|
+
"name": "orientation",
|
|
3010
|
+
"type": "TabOrientation",
|
|
3011
|
+
"required": false,
|
|
3012
|
+
"defaultValue": "TabOrientation.Horizontal",
|
|
3013
|
+
"description": "Layout direction of the tab list."
|
|
3014
|
+
},
|
|
3015
|
+
{
|
|
3016
|
+
"name": "sectionLabel",
|
|
3017
|
+
"type": "string",
|
|
3018
|
+
"required": false,
|
|
3019
|
+
"description": "Heading rendered above the tabs, which also names the tab list."
|
|
3020
|
+
},
|
|
2864
3021
|
{
|
|
2865
3022
|
"name": "ariaLabel",
|
|
2866
3023
|
"type": "string",
|
|
@@ -2871,20 +3028,92 @@
|
|
|
2871
3028
|
"name": "className",
|
|
2872
3029
|
"type": "string",
|
|
2873
3030
|
"required": false,
|
|
2874
|
-
"description": "Additional CSS classes for the
|
|
3031
|
+
"description": "Additional CSS classes for the root element."
|
|
3032
|
+
},
|
|
3033
|
+
{
|
|
3034
|
+
"name": "tabListClassName",
|
|
3035
|
+
"type": "string",
|
|
3036
|
+
"required": false,
|
|
3037
|
+
"description": "Additional CSS classes for the `role=\"tablist\"`."
|
|
2875
3038
|
},
|
|
2876
3039
|
{
|
|
2877
3040
|
"name": "tabClassName",
|
|
2878
3041
|
"type": "string",
|
|
2879
3042
|
"required": false,
|
|
2880
3043
|
"description": "Additional CSS classes applied to every tab."
|
|
3044
|
+
},
|
|
3045
|
+
{
|
|
3046
|
+
"name": "sectionLabelClassName",
|
|
3047
|
+
"type": "string",
|
|
3048
|
+
"required": false,
|
|
3049
|
+
"description": "Additional CSS classes for the `sectionLabel` heading."
|
|
2881
3050
|
}
|
|
2882
3051
|
],
|
|
2883
3052
|
"examples": [
|
|
2884
|
-
"<Tabs\n ariaLabel=\"Conversation views\"\n tabs={[\n { id: 'all', label: 'All', count: 12 },\n { id: 'shared', label: 'Shared with me' },\n ]}\n activeTabId={activeTabId}\n onTabChange={setActiveTabId}\n/>"
|
|
3053
|
+
"<Tabs\n ariaLabel=\"Conversation views\"\n tabs={[\n { id: 'all', label: 'All', count: 12 },\n { id: 'shared', label: 'Shared with me' },\n ]}\n activeTabId={activeTabId}\n onTabChange={setActiveTabId}\n/>",
|
|
3054
|
+
"<Tabs\norientation={TabOrientation.Vertical}\nsectionLabel={t('Settings')}\nclassName=\"w-[240px] shrink-0 border-e border-e-tertiary\"\ntabs={[\n{ id: 'preferences', label: t('Preferences'), icon: <IconSettings size={18} /> },\n{ id: 'usage', label: t('Usage'), icon: <IconChartBar size={18} /> },\n]}\nactiveTabId={activeTabId}\nonTabChange={setActiveTabId}\n/>"
|
|
2885
3055
|
],
|
|
2886
3056
|
"sourceFile": "components/New/Tabs/Tabs.tsx"
|
|
2887
3057
|
},
|
|
3058
|
+
{
|
|
3059
|
+
"name": "FilterChips",
|
|
3060
|
+
"category": "Components_2_0",
|
|
3061
|
+
"generation": "2.0",
|
|
3062
|
+
"description": "A row of filter chips that picks one value out of a few.\naliases: FilterChipRow|ChipTabs|TagTabs|FilterTabs\nDesign system 2.0\n\nThe chip-shaped sibling of the kit's other single-select rows, and the one to\nreach for when the options label a *subset of a list* — \"All\", \"Shared\",\n\"Mine\" above a history panel. `Tabs` underlines the active option and reads\nas navigation between panels; `SegmentedControl` sinks equal segments into a\ntrack and reads as a view switch. This one draws `TagAppearance.Selectable`\nchips: no fill until selected, and a semibold label once it is. Selecting a\nchip therefore widens it by the difference between the regular and semibold\nlabel — give the row `stretch`, or the chips a width, if that shift matters.\n\nEach chip is a toggle button carrying its state on `aria-pressed`, wrapped in\na named `role=\"group\"` — the pattern `Tag` is built for. That makes every\nchip its own tab stop, which is what a filter row wants: unlike a\n`radiogroup`, arrowing onto a chip never changes the filter by accident.\nName the group through `aria-label` or `aria-labelledby`, or the chips are\nannounced as a handful of unrelated toggles.\n\nThere is no disabled chip. An option the user must not pick is left out of\n`items` — a chip that renders but cannot be activated is a label and nothing\nelse, and `Tag` drops its button role when disabled, so it would not even\nannounce as unavailable.\n\nLabels are the caller's to translate — the component ships no English\ndefaults.",
|
|
3063
|
+
"props": [
|
|
3064
|
+
{
|
|
3065
|
+
"name": "items",
|
|
3066
|
+
"type": "FilterChipItem<T>[]",
|
|
3067
|
+
"required": true,
|
|
3068
|
+
"description": "Chips to render, in order; each needs a unique `value` and a `label`"
|
|
3069
|
+
},
|
|
3070
|
+
{
|
|
3071
|
+
"name": "value",
|
|
3072
|
+
"type": "T",
|
|
3073
|
+
"required": true,
|
|
3074
|
+
"description": "The `value` of the selected chip"
|
|
3075
|
+
},
|
|
3076
|
+
{
|
|
3077
|
+
"name": "onChange",
|
|
3078
|
+
"type": "(value: T) => void",
|
|
3079
|
+
"required": true,
|
|
3080
|
+
"description": "Called with the `value` of the chip the user picked. A click on the already-selected chip fires it again, so a row that clears back to a default handles that itself"
|
|
3081
|
+
},
|
|
3082
|
+
{
|
|
3083
|
+
"name": "stretch",
|
|
3084
|
+
"type": "boolean",
|
|
3085
|
+
"required": false,
|
|
3086
|
+
"defaultValue": "false",
|
|
3087
|
+
"description": "Grows the chips to share the row width equally instead of hugging their labels"
|
|
3088
|
+
},
|
|
3089
|
+
{
|
|
3090
|
+
"name": "className",
|
|
3091
|
+
"type": "string",
|
|
3092
|
+
"required": false,
|
|
3093
|
+
"description": "Additional classes for the row, e.g. its padding or `flex-wrap`"
|
|
3094
|
+
},
|
|
3095
|
+
{
|
|
3096
|
+
"name": "chipClassName",
|
|
3097
|
+
"type": "string",
|
|
3098
|
+
"required": false,
|
|
3099
|
+
"description": "Additional classes for every chip. A panel too narrow for the chips' default padding can tighten it here"
|
|
3100
|
+
},
|
|
3101
|
+
{
|
|
3102
|
+
"name": "'aria-label'",
|
|
3103
|
+
"type": "string",
|
|
3104
|
+
"required": false
|
|
3105
|
+
},
|
|
3106
|
+
{
|
|
3107
|
+
"name": "'aria-labelledby'",
|
|
3108
|
+
"type": "string",
|
|
3109
|
+
"required": false
|
|
3110
|
+
}
|
|
3111
|
+
],
|
|
3112
|
+
"examples": [
|
|
3113
|
+
"<FilterChips\n aria-label={t('Filter chats')}\n value={tab}\n onChange={setTab}\n items={[\n { value: 'all', label: t('All') },\n { value: 'mine', label: t('My chats') },\n { value: 'shared', label: t('Shared') },\n ]}\n/>"
|
|
3114
|
+
],
|
|
3115
|
+
"sourceFile": "components/New/FilterChips/FilterChips.tsx"
|
|
3116
|
+
},
|
|
2888
3117
|
{
|
|
2889
3118
|
"name": "FileDropzone",
|
|
2890
3119
|
"category": "Components_2_0",
|
|
@@ -2935,47 +3164,299 @@
|
|
|
2935
3164
|
"description": "Whether more than one file can be selected."
|
|
2936
3165
|
},
|
|
2937
3166
|
{
|
|
2938
|
-
"name": "disabled",
|
|
3167
|
+
"name": "disabled",
|
|
3168
|
+
"type": "boolean",
|
|
3169
|
+
"required": false,
|
|
3170
|
+
"defaultValue": "false",
|
|
3171
|
+
"description": "Disables picking and dropping."
|
|
3172
|
+
},
|
|
3173
|
+
{
|
|
3174
|
+
"name": "errorText",
|
|
3175
|
+
"type": "string",
|
|
3176
|
+
"required": false,
|
|
3177
|
+
"description": "Error message rendered below the area."
|
|
3178
|
+
},
|
|
3179
|
+
{
|
|
3180
|
+
"name": "icon",
|
|
3181
|
+
"type": "ReactNode",
|
|
3182
|
+
"required": false,
|
|
3183
|
+
"description": "Icon rendered above the copy."
|
|
3184
|
+
},
|
|
3185
|
+
{
|
|
3186
|
+
"name": "id",
|
|
3187
|
+
"type": "string",
|
|
3188
|
+
"required": false,
|
|
3189
|
+
"description": "`id` of the underlying file input."
|
|
3190
|
+
},
|
|
3191
|
+
{
|
|
3192
|
+
"name": "ariaLabel",
|
|
3193
|
+
"type": "string",
|
|
3194
|
+
"required": false,
|
|
3195
|
+
"description": "Accessible name; needed when `label` carries no text."
|
|
3196
|
+
},
|
|
3197
|
+
{
|
|
3198
|
+
"name": "className",
|
|
3199
|
+
"type": "string",
|
|
3200
|
+
"required": false,
|
|
3201
|
+
"description": "Additional CSS classes for the drop area."
|
|
3202
|
+
}
|
|
3203
|
+
],
|
|
3204
|
+
"examples": [
|
|
3205
|
+
"<FileDropzone\n label=\"Drag and drop it or click here to upload\"\n description=\"File formats .md, .zip and .skill\"\n accept=\".md,.zip,.skill\"\n onChange={(files) => upload(files)}\n onReject={() => setError('Unsupported file format')}\n/>"
|
|
3206
|
+
],
|
|
3207
|
+
"sourceFile": "components/New/FileDropzone/FileDropzone.tsx"
|
|
3208
|
+
},
|
|
3209
|
+
{
|
|
3210
|
+
"name": "FileIcon",
|
|
3211
|
+
"category": "Components_2_0",
|
|
3212
|
+
"generation": "2.0",
|
|
3213
|
+
"description": "The icon of a file or folder row in a file manager: a file-type glyph picked\nby extension, or a folder, with an optional shared badge and loading state.\naliases: FileTypeIcon|EntityIcon\nDesign system 2.0\n\nThe root is a `role=\"img\"` whose name says what the item is, and that it is\nshared — the badge itself is drawn inside the image, so its tooltip is a\npointer-only hint and never the only place the state is conveyed. While\n`loading`, the root drops the role and holds a `Spinner`, which announces\nitself as a status. Pass `decorative` when the row already names the item.",
|
|
3214
|
+
"props": [
|
|
3215
|
+
{
|
|
3216
|
+
"name": "type",
|
|
3217
|
+
"type": "DialItemType",
|
|
3218
|
+
"required": true,
|
|
3219
|
+
"description": "Whether the item is a file or a folder"
|
|
3220
|
+
},
|
|
3221
|
+
{
|
|
3222
|
+
"name": "name",
|
|
3223
|
+
"type": "string",
|
|
3224
|
+
"required": true,
|
|
3225
|
+
"description": "Item name; a file's extension is read from it"
|
|
3226
|
+
},
|
|
3227
|
+
{
|
|
3228
|
+
"name": "fileExtension",
|
|
3229
|
+
"type": "string",
|
|
3230
|
+
"required": false,
|
|
3231
|
+
"description": "Extension overriding the one in `name`"
|
|
3232
|
+
},
|
|
3233
|
+
{
|
|
3234
|
+
"name": "shared",
|
|
3235
|
+
"type": "boolean",
|
|
3236
|
+
"required": false,
|
|
3237
|
+
"defaultValue": "false",
|
|
3238
|
+
"description": "Draws the shared badge"
|
|
3239
|
+
},
|
|
3240
|
+
{
|
|
3241
|
+
"name": "loading",
|
|
3242
|
+
"type": "boolean",
|
|
3243
|
+
"required": false,
|
|
3244
|
+
"defaultValue": "false",
|
|
3245
|
+
"description": "Replaces the glyph with a spinner"
|
|
3246
|
+
},
|
|
3247
|
+
{
|
|
3248
|
+
"name": "size",
|
|
3249
|
+
"type": "number",
|
|
3250
|
+
"required": false,
|
|
3251
|
+
"defaultValue": "DIAL_ICON_SIZE.MD",
|
|
3252
|
+
"description": "Glyph size in px"
|
|
3253
|
+
},
|
|
3254
|
+
{
|
|
3255
|
+
"name": "className",
|
|
3256
|
+
"type": "string",
|
|
3257
|
+
"required": false,
|
|
3258
|
+
"description": "Additional CSS classes for the root element"
|
|
3259
|
+
},
|
|
3260
|
+
{
|
|
3261
|
+
"name": "decorative",
|
|
3262
|
+
"type": "boolean",
|
|
3263
|
+
"required": false,
|
|
3264
|
+
"defaultValue": "false",
|
|
3265
|
+
"description": "Hides the icon from assistive technology"
|
|
3266
|
+
},
|
|
3267
|
+
{
|
|
3268
|
+
"name": "label",
|
|
3269
|
+
"type": "string",
|
|
3270
|
+
"required": false,
|
|
3271
|
+
"description": "Accessible name, overriding the generated one"
|
|
3272
|
+
},
|
|
3273
|
+
{
|
|
3274
|
+
"name": "loadingLabel",
|
|
3275
|
+
"type": "string",
|
|
3276
|
+
"required": false,
|
|
3277
|
+
"defaultValue": "'Loading'",
|
|
3278
|
+
"description": "Accessible name of the spinner"
|
|
3279
|
+
},
|
|
3280
|
+
{
|
|
3281
|
+
"name": "sharedIndicatorClassName",
|
|
3282
|
+
"type": "string",
|
|
3283
|
+
"required": false,
|
|
3284
|
+
"description": "Additional CSS classes for the shared badge"
|
|
3285
|
+
},
|
|
3286
|
+
{
|
|
3287
|
+
"name": "sharedIndicatorTooltip",
|
|
3288
|
+
"type": "ReactNode",
|
|
3289
|
+
"required": false,
|
|
3290
|
+
"description": "Tooltip shown over the shared badge"
|
|
3291
|
+
}
|
|
3292
|
+
],
|
|
3293
|
+
"examples": [
|
|
3294
|
+
"<FileIcon name=\"report.pdf\" type={DialItemType.File} shared />\n<FileIcon name=\"Projects\" type={DialItemType.Folder} loading />"
|
|
3295
|
+
],
|
|
3296
|
+
"sourceFile": "components/New/FileIcon/FileIcon.tsx"
|
|
3297
|
+
},
|
|
3298
|
+
{
|
|
3299
|
+
"name": "FileName",
|
|
3300
|
+
"category": "Components_2_0",
|
|
3301
|
+
"generation": "2.0",
|
|
3302
|
+
"description": "A file or folder name with its type icon, truncated with a tooltip when it\ndoes not fit.\naliases: FileDisplay|NameDisplay\nDesign system 2.0\n\nThe visible name already says what the item is, so the icon is decorative;\nthe shared state, which only the badge shows, is announced by a\nvisually-hidden `sharedLabel` after the name instead.\n\nWhile `loading` the icon is swapped for a `Spinner`, which is left in the\naccessibility tree so the busy state is announced.\n\nWith `details` the text switches to two lines — the name, then the metadata.",
|
|
3303
|
+
"props": [
|
|
3304
|
+
{
|
|
3305
|
+
"name": "name",
|
|
3306
|
+
"type": "string",
|
|
3307
|
+
"required": true,
|
|
3308
|
+
"description": "Full item name, with or without an extension"
|
|
3309
|
+
},
|
|
3310
|
+
{
|
|
3311
|
+
"name": "type",
|
|
3312
|
+
"type": "DialItemType",
|
|
3313
|
+
"required": false,
|
|
3314
|
+
"defaultValue": "DialItemType.File",
|
|
3315
|
+
"description": "Whether the item is a file or a folder"
|
|
3316
|
+
},
|
|
3317
|
+
{
|
|
3318
|
+
"name": "fileExtension",
|
|
3319
|
+
"type": "string",
|
|
3320
|
+
"required": false,
|
|
3321
|
+
"description": "Extension overriding the one in `name`"
|
|
3322
|
+
},
|
|
3323
|
+
{
|
|
3324
|
+
"name": "shared",
|
|
3325
|
+
"type": "boolean",
|
|
3326
|
+
"required": false,
|
|
3327
|
+
"defaultValue": "false",
|
|
3328
|
+
"description": "Draws the shared badge on the icon"
|
|
3329
|
+
},
|
|
3330
|
+
{
|
|
3331
|
+
"name": "loading",
|
|
3332
|
+
"type": "boolean",
|
|
3333
|
+
"required": false,
|
|
3334
|
+
"defaultValue": "false",
|
|
3335
|
+
"description": "Replaces the icon with a spinner"
|
|
3336
|
+
},
|
|
3337
|
+
{
|
|
3338
|
+
"name": "loadingLabel",
|
|
3339
|
+
"type": "string",
|
|
3340
|
+
"required": false,
|
|
3341
|
+
"description": "Accessible name of the spinner"
|
|
3342
|
+
},
|
|
3343
|
+
{
|
|
3344
|
+
"name": "iconSize",
|
|
3345
|
+
"type": "number",
|
|
3346
|
+
"required": false,
|
|
3347
|
+
"description": "Icon size in px"
|
|
3348
|
+
},
|
|
3349
|
+
{
|
|
3350
|
+
"name": "details",
|
|
3351
|
+
"type": "ReactNode",
|
|
3352
|
+
"required": false,
|
|
3353
|
+
"description": "Metadata under the name"
|
|
3354
|
+
},
|
|
3355
|
+
{
|
|
3356
|
+
"name": "isInvalidName",
|
|
3357
|
+
"type": "boolean",
|
|
3358
|
+
"required": false,
|
|
3359
|
+
"defaultValue": "false",
|
|
3360
|
+
"description": "Mutes the name, marking it as invalid"
|
|
3361
|
+
},
|
|
3362
|
+
{
|
|
3363
|
+
"name": "className",
|
|
3364
|
+
"type": "string",
|
|
3365
|
+
"required": false,
|
|
3366
|
+
"description": "Additional CSS classes for the root element"
|
|
3367
|
+
},
|
|
3368
|
+
{
|
|
3369
|
+
"name": "nameClassName",
|
|
3370
|
+
"type": "string",
|
|
3371
|
+
"required": false,
|
|
3372
|
+
"description": "Additional CSS classes for the name text"
|
|
3373
|
+
},
|
|
3374
|
+
{
|
|
3375
|
+
"name": "sharedIndicatorClassName",
|
|
3376
|
+
"type": "string",
|
|
3377
|
+
"required": false,
|
|
3378
|
+
"description": "Additional CSS classes for the shared badge"
|
|
3379
|
+
},
|
|
3380
|
+
{
|
|
3381
|
+
"name": "sharedIndicatorTooltip",
|
|
3382
|
+
"type": "ReactNode",
|
|
3383
|
+
"required": false,
|
|
3384
|
+
"description": "Tooltip shown over the shared badge"
|
|
3385
|
+
},
|
|
3386
|
+
{
|
|
3387
|
+
"name": "sharedLabel",
|
|
3388
|
+
"type": "string",
|
|
3389
|
+
"required": false,
|
|
3390
|
+
"defaultValue": "'Shared'",
|
|
3391
|
+
"description": "Screen-reader text announcing the shared state"
|
|
3392
|
+
},
|
|
3393
|
+
{
|
|
3394
|
+
"name": "hideTooltip",
|
|
2939
3395
|
"type": "boolean",
|
|
2940
3396
|
"required": false,
|
|
2941
3397
|
"defaultValue": "false",
|
|
2942
|
-
"description": "
|
|
3398
|
+
"description": "Suppresses the full-name tooltip"
|
|
2943
3399
|
},
|
|
2944
3400
|
{
|
|
2945
|
-
"name": "
|
|
2946
|
-
"type": "
|
|
3401
|
+
"name": "tooltipContent",
|
|
3402
|
+
"type": "ReactNode",
|
|
2947
3403
|
"required": false,
|
|
2948
|
-
"description": "
|
|
2949
|
-
}
|
|
3404
|
+
"description": "Shown instead of the full name while truncated"
|
|
3405
|
+
}
|
|
3406
|
+
],
|
|
3407
|
+
"examples": [
|
|
3408
|
+
"<FileName name=\"Document.pdf\" shared />\n<FileName\n name=\"Document.pdf\"\n details={<span className=\"dial-tiny-text text-secondary\">24 KB · Jul 20</span>}\n/>"
|
|
3409
|
+
],
|
|
3410
|
+
"sourceFile": "components/New/FileName/FileName.tsx"
|
|
3411
|
+
},
|
|
3412
|
+
{
|
|
3413
|
+
"name": "FolderName",
|
|
3414
|
+
"category": "Components_2_0",
|
|
3415
|
+
"generation": "2.0",
|
|
3416
|
+
"description": "A folder name with the folder icon, truncated with a tooltip when it does\nnot fit.\naliases: FolderDisplay|DirectoryName\nDesign system 2.0\n\nA `FileName` fixed to `DialItemType.Folder`, so it shares every behaviour of\nit — decorative icon, visually-hidden shared label, `details` line and the\n`loading` spinner. Its root carries `dial-kit-folder-name` on top of\n`dial-kit-file-name`.",
|
|
3417
|
+
"props": [],
|
|
3418
|
+
"examples": [
|
|
3419
|
+
"<FolderName name=\"Organization\" shared />\n<FolderName name=\"Uploads\" loading />"
|
|
3420
|
+
],
|
|
3421
|
+
"sourceFile": "components/New/FolderName/FolderName.tsx"
|
|
3422
|
+
},
|
|
3423
|
+
{
|
|
3424
|
+
"name": "SharedEntityIndicator",
|
|
3425
|
+
"category": "Components_2_0",
|
|
3426
|
+
"generation": "2.0",
|
|
3427
|
+
"description": "A small arrow badge marking an entity as shared.\naliases: SharedIcon|AccessIndicator\nDesign system 2.0\n\nA `role=\"img\"` named by `label`, so it can stand on its own. Placed inside a\nlarger `role=\"img\"` — as `FileIcon` does — its name is folded into the\nparent's, which is why `FileIcon` names the shared state itself. The tooltip\nis a pointer-only hint: the badge is not focusable, and the tooltip never\nreaches assistive technology, so `label` is what carries the meaning.",
|
|
3428
|
+
"props": [
|
|
2950
3429
|
{
|
|
2951
|
-
"name": "
|
|
2952
|
-
"type": "
|
|
3430
|
+
"name": "label",
|
|
3431
|
+
"type": "string",
|
|
2953
3432
|
"required": false,
|
|
2954
|
-
"
|
|
3433
|
+
"defaultValue": "'Shared'",
|
|
3434
|
+
"description": "Accessible name of the badge"
|
|
2955
3435
|
},
|
|
2956
3436
|
{
|
|
2957
|
-
"name": "
|
|
2958
|
-
"type": "
|
|
3437
|
+
"name": "tooltip",
|
|
3438
|
+
"type": "ReactNode",
|
|
2959
3439
|
"required": false,
|
|
2960
|
-
"description": "
|
|
3440
|
+
"description": "Tooltip shown while the badge is hovered"
|
|
2961
3441
|
},
|
|
2962
3442
|
{
|
|
2963
|
-
"name": "
|
|
2964
|
-
"type": "
|
|
3443
|
+
"name": "size",
|
|
3444
|
+
"type": "number",
|
|
2965
3445
|
"required": false,
|
|
2966
|
-
"
|
|
3446
|
+
"defaultValue": "12",
|
|
3447
|
+
"description": "Arrow size in px"
|
|
2967
3448
|
},
|
|
2968
3449
|
{
|
|
2969
3450
|
"name": "className",
|
|
2970
3451
|
"type": "string",
|
|
2971
3452
|
"required": false,
|
|
2972
|
-
"description": "Additional CSS classes for the
|
|
3453
|
+
"description": "Additional CSS classes for the badge"
|
|
2973
3454
|
}
|
|
2974
3455
|
],
|
|
2975
3456
|
"examples": [
|
|
2976
|
-
"<
|
|
3457
|
+
"<SharedEntityIndicator />\n<SharedEntityIndicator tooltip=\"Shared with 3 people\" className=\"absolute -bottom-0.5 -left-0.5\" />"
|
|
2977
3458
|
],
|
|
2978
|
-
"sourceFile": "components/New/
|
|
3459
|
+
"sourceFile": "components/New/SharedEntityIndicator/SharedEntityIndicator.tsx"
|
|
2979
3460
|
},
|
|
2980
3461
|
{
|
|
2981
3462
|
"name": "Tag",
|
|
@@ -3792,6 +4273,67 @@
|
|
|
3792
4273
|
],
|
|
3793
4274
|
"sourceFile": "components/New/NoDataContent/NoDataContent.tsx"
|
|
3794
4275
|
},
|
|
4276
|
+
{
|
|
4277
|
+
"name": "TransferQueue",
|
|
4278
|
+
"category": "Components_2_0",
|
|
4279
|
+
"generation": "2.0",
|
|
4280
|
+
"description": "A floating panel listing the files of an upload, download, import or export\nwith a live status per row.\naliases: UploadQueue|ImportQueue|ExportQueue|UploadProgress|ProgressToast\nDesign system 2.0\n\nEach row shows the file's `FileIcon` and name, and a trailing status: a\nspinner (with a cancel control on hover or focus) while in progress, a check\non success, a warning or error icon whose reason is both its tooltip and its\naccessible name, or \"Canceled\". The header carries the host's title, a count\nof failed items, and collapse and close controls. Collapsed while work runs,\nthe rows are replaced by one aggregate `ProgressBar`.\n\nClosing while an item is in progress or has failed asks for confirmation\nfirst. Once every item has succeeded the queue closes itself after\n`autoCloseDelay`; a warned or canceled row keeps it open so it can be read.\n\nThe root is a polite `role=\"status\"` live region. Positioning is left to\nthe host — wrap it in a fixed container at the screen corner.",
|
|
4281
|
+
"props": [
|
|
4282
|
+
{
|
|
4283
|
+
"name": "title",
|
|
4284
|
+
"type": "string",
|
|
4285
|
+
"required": true,
|
|
4286
|
+
"description": "Heading, rendered verbatim"
|
|
4287
|
+
},
|
|
4288
|
+
{
|
|
4289
|
+
"name": "items",
|
|
4290
|
+
"type": "TransferQueueItem[]",
|
|
4291
|
+
"required": true,
|
|
4292
|
+
"description": "Items to show, in display order"
|
|
4293
|
+
},
|
|
4294
|
+
{
|
|
4295
|
+
"name": "onClose",
|
|
4296
|
+
"type": "() => void",
|
|
4297
|
+
"required": true,
|
|
4298
|
+
"description": "Called when the queue should close"
|
|
4299
|
+
},
|
|
4300
|
+
{
|
|
4301
|
+
"name": "onCancelItem",
|
|
4302
|
+
"type": "(id: string) => void",
|
|
4303
|
+
"required": false,
|
|
4304
|
+
"description": "Called with an item's id when the user cancels it"
|
|
4305
|
+
},
|
|
4306
|
+
{
|
|
4307
|
+
"name": "labels",
|
|
4308
|
+
"type": "Partial<TransferQueueLabels>",
|
|
4309
|
+
"required": false,
|
|
4310
|
+
"description": "Overrides for the English default strings"
|
|
4311
|
+
},
|
|
4312
|
+
{
|
|
4313
|
+
"name": "autoCloseDelay",
|
|
4314
|
+
"type": "number",
|
|
4315
|
+
"required": false,
|
|
4316
|
+
"defaultValue": "TRANSFER_QUEUE_AUTO_CLOSE_DELAY_MS",
|
|
4317
|
+
"description": "Delay before an all-succeeded queue closes itself; `0` disables"
|
|
4318
|
+
},
|
|
4319
|
+
{
|
|
4320
|
+
"name": "className",
|
|
4321
|
+
"type": "string",
|
|
4322
|
+
"required": false,
|
|
4323
|
+
"description": "Additional CSS classes for the root panel"
|
|
4324
|
+
},
|
|
4325
|
+
{
|
|
4326
|
+
"name": "bodyClassName",
|
|
4327
|
+
"type": "string",
|
|
4328
|
+
"required": false,
|
|
4329
|
+
"description": "Additional CSS classes for the list of rows"
|
|
4330
|
+
}
|
|
4331
|
+
],
|
|
4332
|
+
"examples": [
|
|
4333
|
+
"<TransferQueue\n title=\"Importing 2 files\"\n items={[\n { id: '1', name: 'report.pdf', status: TransferQueueItemStatus.Success },\n { id: '2', name: 'data.csv', status: TransferQueueItemStatus.InProgress, percent: 40 },\n ]}\n onClose={handleClose}\n onCancelItem={handleCancel}\n/>"
|
|
4334
|
+
],
|
|
4335
|
+
"sourceFile": "components/New/TransferQueue/TransferQueue.tsx"
|
|
4336
|
+
},
|
|
3795
4337
|
{
|
|
3796
4338
|
"name": "Grid",
|
|
3797
4339
|
"category": "Components_2_0",
|
|
@@ -5480,7 +6022,8 @@
|
|
|
5480
6022
|
"examples": [
|
|
5481
6023
|
"<DialFileIcon extension=\".pdf\" />\n<DialFileIcon extension=\"tsx\" size={28} stroke={1.25} />\n<DialFileIcon extension=\"unknown\" decorative /> // decorative, hidden from AT"
|
|
5482
6024
|
],
|
|
5483
|
-
"sourceFile": "components/FileIcon/FileIcon.tsx"
|
|
6025
|
+
"sourceFile": "components/FileIcon/FileIcon.tsx",
|
|
6026
|
+
"supersededBy": "FileIcon"
|
|
5484
6027
|
},
|
|
5485
6028
|
{
|
|
5486
6029
|
"name": "DialFormItem",
|
|
@@ -5598,7 +6141,8 @@
|
|
|
5598
6141
|
"examples": [
|
|
5599
6142
|
"<DialSharedEntityIndicator />\n<DialSharedEntityIndicator size={12} label=\"Opens in new window\" />"
|
|
5600
6143
|
],
|
|
5601
|
-
"sourceFile": "components/SharedEntityIndicator/SharedEntityIndicator.tsx"
|
|
6144
|
+
"sourceFile": "components/SharedEntityIndicator/SharedEntityIndicator.tsx",
|
|
6145
|
+
"supersededBy": "SharedEntityIndicator"
|
|
5602
6146
|
},
|
|
5603
6147
|
{
|
|
5604
6148
|
"name": "DialFileName",
|
|
@@ -5678,7 +6222,8 @@
|
|
|
5678
6222
|
"examples": [
|
|
5679
6223
|
"// Without details\n<DialFileName name=\"Document.pdf\" />\n\n// With details (file size and updated date)\n<DialFileName\n name=\"Document.pdf\"\n details={<span className=\"text-secondary\">24 KB · Jul 20, 2025</span>}\n/>"
|
|
5680
6224
|
],
|
|
5681
|
-
"sourceFile": "components/FileName/FileName.tsx"
|
|
6225
|
+
"sourceFile": "components/FileName/FileName.tsx",
|
|
6226
|
+
"supersededBy": "FileName"
|
|
5682
6227
|
},
|
|
5683
6228
|
{
|
|
5684
6229
|
"name": "DialFolderName",
|
|
@@ -5755,7 +6300,8 @@
|
|
|
5755
6300
|
"examples": [
|
|
5756
6301
|
"<DialFolderName name=\"Organization\" />"
|
|
5757
6302
|
],
|
|
5758
|
-
"sourceFile": "components/FolderName/FolderName.tsx"
|
|
6303
|
+
"sourceFile": "components/FolderName/FolderName.tsx",
|
|
6304
|
+
"supersededBy": "FolderName"
|
|
5759
6305
|
},
|
|
5760
6306
|
{
|
|
5761
6307
|
"name": "DialResizableContainer",
|
|
@@ -8268,6 +8814,12 @@
|
|
|
8268
8814
|
"required": false,
|
|
8269
8815
|
"description": "Optional tooltip displayed when a file or folder name contains forbidden characters"
|
|
8270
8816
|
},
|
|
8817
|
+
{
|
|
8818
|
+
"name": "skipForbiddenSymbolsCheckForActions",
|
|
8819
|
+
"type": "boolean",
|
|
8820
|
+
"required": false,
|
|
8821
|
+
"description": "When provided, skips the forbidden-symbols check when building row action menus, so all actions are shown even for items whose names contain forbidden characters."
|
|
8822
|
+
},
|
|
8271
8823
|
{
|
|
8272
8824
|
"name": "onCreateFolder",
|
|
8273
8825
|
"type": "(\n file: DialUploadFileItem,\n folderPath: string,\n fileId: string,\n ) => void | Promise<void>",
|
|
@@ -9070,6 +9622,10 @@
|
|
|
9070
9622
|
"name": "Static",
|
|
9071
9623
|
"value": "'static'"
|
|
9072
9624
|
},
|
|
9625
|
+
{
|
|
9626
|
+
"name": "Starter",
|
|
9627
|
+
"value": "'starter'"
|
|
9628
|
+
},
|
|
9073
9629
|
{
|
|
9074
9630
|
"name": "Success",
|
|
9075
9631
|
"value": "'success'"
|
|
@@ -10375,6 +10931,47 @@
|
|
|
10375
10931
|
"sourceFile": "components/New/Calendar/Calendar.tsx",
|
|
10376
10932
|
"typeBody": "Date | string | null"
|
|
10377
10933
|
},
|
|
10934
|
+
{
|
|
10935
|
+
"name": "BreadcrumbsSize",
|
|
10936
|
+
"kind": "enum",
|
|
10937
|
+
"members": [
|
|
10938
|
+
{
|
|
10939
|
+
"name": "Small",
|
|
10940
|
+
"value": "'small'",
|
|
10941
|
+
"comment": "14px `dial-small-text`, with a `dial-small-semi-text` current page."
|
|
10942
|
+
},
|
|
10943
|
+
{
|
|
10944
|
+
"name": "Heading",
|
|
10945
|
+
"value": "'heading'",
|
|
10946
|
+
"comment": "18px `dial-h2-text`, for a trail that doubles as the page heading. The\ntoken is semibold, so every segment is — including the current page."
|
|
10947
|
+
}
|
|
10948
|
+
],
|
|
10949
|
+
"sourceFile": "types/breadcrumbs.ts"
|
|
10950
|
+
},
|
|
10951
|
+
{
|
|
10952
|
+
"name": "BreadcrumbsItem",
|
|
10953
|
+
"kind": "interface",
|
|
10954
|
+
"members": [
|
|
10955
|
+
{
|
|
10956
|
+
"name": "label",
|
|
10957
|
+
"value": "string"
|
|
10958
|
+
},
|
|
10959
|
+
{
|
|
10960
|
+
"name": "href?",
|
|
10961
|
+
"value": "string"
|
|
10962
|
+
},
|
|
10963
|
+
{
|
|
10964
|
+
"name": "onClick?",
|
|
10965
|
+
"value": "(event: MouseEvent<HTMLElement>) => void"
|
|
10966
|
+
},
|
|
10967
|
+
{
|
|
10968
|
+
"name": "icon?",
|
|
10969
|
+
"value": "ReactNode"
|
|
10970
|
+
}
|
|
10971
|
+
],
|
|
10972
|
+
"sourceFile": "components/New/Breadcrumbs/Breadcrumbs.tsx",
|
|
10973
|
+
"description": "One step of the trail rendered by ."
|
|
10974
|
+
},
|
|
10378
10975
|
{
|
|
10379
10976
|
"name": "TextareaResize",
|
|
10380
10977
|
"kind": "enum",
|
|
@@ -10398,6 +10995,24 @@
|
|
|
10398
10995
|
],
|
|
10399
10996
|
"sourceFile": "components/New/Textarea/Textarea.tsx"
|
|
10400
10997
|
},
|
|
10998
|
+
{
|
|
10999
|
+
"name": "AccordionCaretPosition",
|
|
11000
|
+
"kind": "enum",
|
|
11001
|
+
"members": [
|
|
11002
|
+
{
|
|
11003
|
+
"name": "Start",
|
|
11004
|
+
"value": "'start'",
|
|
11005
|
+
"comment": "Before the title, at the header's leading edge."
|
|
11006
|
+
},
|
|
11007
|
+
{
|
|
11008
|
+
"name": "End",
|
|
11009
|
+
"value": "'end'",
|
|
11010
|
+
"comment": "After the title, at the header's trailing edge."
|
|
11011
|
+
}
|
|
11012
|
+
],
|
|
11013
|
+
"sourceFile": "types/accordion.ts",
|
|
11014
|
+
"description": "Where an `Accordion` header draws its caret."
|
|
11015
|
+
},
|
|
10401
11016
|
{
|
|
10402
11017
|
"name": "RadioGroupItem",
|
|
10403
11018
|
"kind": "interface",
|
|
@@ -10472,6 +11087,10 @@
|
|
|
10472
11087
|
"name": "count?",
|
|
10473
11088
|
"value": "number"
|
|
10474
11089
|
},
|
|
11090
|
+
{
|
|
11091
|
+
"name": "icon?",
|
|
11092
|
+
"value": "ReactNode"
|
|
11093
|
+
},
|
|
10475
11094
|
{
|
|
10476
11095
|
"name": "disabled?",
|
|
10477
11096
|
"value": "boolean"
|
|
@@ -10480,6 +11099,25 @@
|
|
|
10480
11099
|
"sourceFile": "components/New/Tabs/Tabs.tsx",
|
|
10481
11100
|
"description": "A single tab entry rendered by ."
|
|
10482
11101
|
},
|
|
11102
|
+
{
|
|
11103
|
+
"name": "FilterChipItem",
|
|
11104
|
+
"kind": "interface",
|
|
11105
|
+
"members": [
|
|
11106
|
+
{
|
|
11107
|
+
"name": "value",
|
|
11108
|
+
"value": "T"
|
|
11109
|
+
},
|
|
11110
|
+
{
|
|
11111
|
+
"name": "label",
|
|
11112
|
+
"value": "string"
|
|
11113
|
+
},
|
|
11114
|
+
{
|
|
11115
|
+
"name": "icon?",
|
|
11116
|
+
"value": "ReactNode"
|
|
11117
|
+
}
|
|
11118
|
+
],
|
|
11119
|
+
"sourceFile": "components/New/FilterChips/FilterChips.tsx"
|
|
11120
|
+
},
|
|
10483
11121
|
{
|
|
10484
11122
|
"name": "TagAppearance",
|
|
10485
11123
|
"kind": "enum",
|
|
@@ -10544,6 +11182,140 @@
|
|
|
10544
11182
|
}
|
|
10545
11183
|
],
|
|
10546
11184
|
"sourceFile": "types/tooltip.ts"
|
|
11185
|
+
},
|
|
11186
|
+
{
|
|
11187
|
+
"name": "TransferQueueItem",
|
|
11188
|
+
"kind": "interface",
|
|
11189
|
+
"members": [
|
|
11190
|
+
{
|
|
11191
|
+
"name": "id",
|
|
11192
|
+
"value": "string"
|
|
11193
|
+
},
|
|
11194
|
+
{
|
|
11195
|
+
"name": "name",
|
|
11196
|
+
"value": "string"
|
|
11197
|
+
},
|
|
11198
|
+
{
|
|
11199
|
+
"name": "status",
|
|
11200
|
+
"value": "TransferQueueItemStatus"
|
|
11201
|
+
},
|
|
11202
|
+
{
|
|
11203
|
+
"name": "percent?",
|
|
11204
|
+
"value": "number"
|
|
11205
|
+
},
|
|
11206
|
+
{
|
|
11207
|
+
"name": "message?",
|
|
11208
|
+
"value": "string"
|
|
11209
|
+
}
|
|
11210
|
+
],
|
|
11211
|
+
"sourceFile": "components/New/TransferQueue/TransferQueue.tsx",
|
|
11212
|
+
"description": "One file (or other named unit of work) tracked by a `TransferQueue`."
|
|
11213
|
+
},
|
|
11214
|
+
{
|
|
11215
|
+
"name": "TransferQueueLabels",
|
|
11216
|
+
"kind": "interface",
|
|
11217
|
+
"members": [
|
|
11218
|
+
{
|
|
11219
|
+
"name": "cancelItemAriaLabel",
|
|
11220
|
+
"value": "(name: string) => string"
|
|
11221
|
+
},
|
|
11222
|
+
{
|
|
11223
|
+
"name": "itemProgressAriaLabel",
|
|
11224
|
+
"value": "(name: string) => string"
|
|
11225
|
+
},
|
|
11226
|
+
{
|
|
11227
|
+
"name": "successLabel",
|
|
11228
|
+
"value": "string"
|
|
11229
|
+
},
|
|
11230
|
+
{
|
|
11231
|
+
"name": "canceledLabel",
|
|
11232
|
+
"value": "string"
|
|
11233
|
+
},
|
|
11234
|
+
{
|
|
11235
|
+
"name": "failedMessage",
|
|
11236
|
+
"value": "string"
|
|
11237
|
+
},
|
|
11238
|
+
{
|
|
11239
|
+
"name": "warningMessage",
|
|
11240
|
+
"value": "string"
|
|
11241
|
+
},
|
|
11242
|
+
{
|
|
11243
|
+
"name": "queueProgressAriaLabel",
|
|
11244
|
+
"value": "string"
|
|
11245
|
+
},
|
|
11246
|
+
{
|
|
11247
|
+
"name": "queueProgressValueText",
|
|
11248
|
+
"value": "(completed: number, total: number) => string"
|
|
11249
|
+
},
|
|
11250
|
+
{
|
|
11251
|
+
"name": "collapseAriaLabel",
|
|
11252
|
+
"value": "string"
|
|
11253
|
+
},
|
|
11254
|
+
{
|
|
11255
|
+
"name": "expandAriaLabel",
|
|
11256
|
+
"value": "string"
|
|
11257
|
+
},
|
|
11258
|
+
{
|
|
11259
|
+
"name": "closeAriaLabel",
|
|
11260
|
+
"value": "string"
|
|
11261
|
+
},
|
|
11262
|
+
{
|
|
11263
|
+
"name": "closeConfirmHeader",
|
|
11264
|
+
"value": "string"
|
|
11265
|
+
},
|
|
11266
|
+
{
|
|
11267
|
+
"name": "closeConfirmDescriptionInProgress",
|
|
11268
|
+
"value": "string"
|
|
11269
|
+
},
|
|
11270
|
+
{
|
|
11271
|
+
"name": "closeConfirmDescriptionFailed",
|
|
11272
|
+
"value": "string"
|
|
11273
|
+
},
|
|
11274
|
+
{
|
|
11275
|
+
"name": "closeConfirmDescriptionMixed",
|
|
11276
|
+
"value": "string"
|
|
11277
|
+
},
|
|
11278
|
+
{
|
|
11279
|
+
"name": "closeConfirmLabel",
|
|
11280
|
+
"value": "string"
|
|
11281
|
+
},
|
|
11282
|
+
{
|
|
11283
|
+
"name": "closeCancelLabel",
|
|
11284
|
+
"value": "string"
|
|
11285
|
+
}
|
|
11286
|
+
],
|
|
11287
|
+
"sourceFile": "components/New/TransferQueue/TransferQueue.tsx",
|
|
11288
|
+
"description": "Every user-visible string of `TransferQueue`."
|
|
11289
|
+
},
|
|
11290
|
+
{
|
|
11291
|
+
"name": "TransferQueueItemStatus",
|
|
11292
|
+
"kind": "enum",
|
|
11293
|
+
"members": [
|
|
11294
|
+
{
|
|
11295
|
+
"name": "InProgress",
|
|
11296
|
+
"value": "'inProgress'",
|
|
11297
|
+
"comment": "Queued or running; the row shows a spinner and, when cancelable, a cancel control."
|
|
11298
|
+
},
|
|
11299
|
+
{
|
|
11300
|
+
"name": "Success",
|
|
11301
|
+
"value": "'success'"
|
|
11302
|
+
},
|
|
11303
|
+
{
|
|
11304
|
+
"name": "Warning",
|
|
11305
|
+
"value": "'warning'",
|
|
11306
|
+
"comment": "Delivered, but not everything the user asked for made it through."
|
|
11307
|
+
},
|
|
11308
|
+
{
|
|
11309
|
+
"name": "Failed",
|
|
11310
|
+
"value": "'failed'"
|
|
11311
|
+
},
|
|
11312
|
+
{
|
|
11313
|
+
"name": "Canceled",
|
|
11314
|
+
"value": "'canceled'"
|
|
11315
|
+
}
|
|
11316
|
+
],
|
|
11317
|
+
"sourceFile": "types/transfer-queue.ts",
|
|
11318
|
+
"description": "Lifecycle status of one item in a `TransferQueue`."
|
|
10547
11319
|
}
|
|
10548
11320
|
],
|
|
10549
11321
|
"hooks": [
|
|
@@ -10614,6 +11386,18 @@
|
|
|
10614
11386
|
"description": "Tests a file against the value of a native `accept` attribute.\n\nThe file picker filters by `accept` on its own, but a drop does not: dropping\na `.png` onto an input that accepts `.md` hands the file over regardless. Any\ndrop target therefore has to re-check what it received.\n\nSupports all three `accept` token forms — an extension (`.md`), a full MIME\ntype (`text/markdown`) and a MIME wildcard (`image/*`). An empty or missing\n`accept` accepts everything, matching the attribute's own semantics.",
|
|
10615
11387
|
"signature": "(file: File, accept?: string) => boolean"
|
|
10616
11388
|
},
|
|
11389
|
+
{
|
|
11390
|
+
"name": "DEFAULT_TRANSFER_QUEUE_LABELS",
|
|
11391
|
+
"sourceFile": "components/New/TransferQueue/constants.ts",
|
|
11392
|
+
"description": "English defaults for every `TransferQueue` string; a host passes translations through `labels`.",
|
|
11393
|
+
"signature": "DEFAULT_TRANSFER_QUEUE_LABELS: TransferQueueLabels"
|
|
11394
|
+
},
|
|
11395
|
+
{
|
|
11396
|
+
"name": "TRANSFER_QUEUE_AUTO_CLOSE_DELAY_MS",
|
|
11397
|
+
"sourceFile": "components/New/TransferQueue/constants.ts",
|
|
11398
|
+
"description": "Delay before a queue whose items have all succeeded closes itself.",
|
|
11399
|
+
"signature": "TRANSFER_QUEUE_AUTO_CLOSE_DELAY_MS = 8000"
|
|
11400
|
+
},
|
|
10617
11401
|
{
|
|
10618
11402
|
"name": "GRID_SELECTION_COLUMN_ID",
|
|
10619
11403
|
"sourceFile": "components/New/Grid/Grid.tsx",
|
|
@@ -10686,6 +11470,16 @@
|
|
|
10686
11470
|
"sourceFile": "utils/flat-to-hierarchy-convertor.ts",
|
|
10687
11471
|
"description": "Helper to create a root folder wrapping flat items.\nUseful when you want the entire tree to be nested under a single root.",
|
|
10688
11472
|
"signature": "function wrapInRootFolder(flatItems: FlatFileItem[], rootName = 'Prompts', rootPath = 'prompts/public/', rootFolderId = 'root'): DialFile[]"
|
|
11473
|
+
},
|
|
11474
|
+
{
|
|
11475
|
+
"name": "getTimezoneLabel",
|
|
11476
|
+
"sourceFile": "utils/timezone.ts",
|
|
11477
|
+
"description": "Returns a timezone as a hint label for time-of-day fields, e.g.\n`(GMT+01:00) Europe/Berlin`: the UTC offset in effect at `options.date`\nrendered by `Intl` (`timeZoneName: 'longOffset'`), followed by the IANA\ntimezone name.",
|
|
11478
|
+
"signature": "({\n locale,\n timeZone,\n date = new Date(),\n}: TimezoneLabelOptions = {}) => string"
|
|
11479
|
+
},
|
|
11480
|
+
{
|
|
11481
|
+
"name": "TimezoneLabelOptions",
|
|
11482
|
+
"sourceFile": "utils/timezone.ts"
|
|
10689
11483
|
}
|
|
10690
11484
|
],
|
|
10691
11485
|
"constants": [
|
|
@@ -10738,6 +11532,11 @@
|
|
|
10738
11532
|
"name": "NOT_ALLOWED_SPACES_REGEXP",
|
|
10739
11533
|
"sourceFile": "constants/validation.ts",
|
|
10740
11534
|
"signature": "NOT_ALLOWED_SPACES_REGEXP = new RegExp(NOT_ALLOWED_SPACES)"
|
|
11535
|
+
},
|
|
11536
|
+
{
|
|
11537
|
+
"name": "DIAL_KIT_CLASS",
|
|
11538
|
+
"sourceFile": "constants/public-class-names.ts",
|
|
11539
|
+
"signature": "DIAL_KIT_CLASS = {\n /* ── Feedback and status ───────────────────────────────────────────────── */\n /** The `role=\"status\"` root of a `Spinner`. */\n spinner: 'dial-kit-spinner',\n /**\n * The outermost element of a `ProgressBar`: the box wrapping its label,\n * track and readout — or the track itself, which is the root when the bar\n * has neither.\n */\n progressBar: 'dial-kit-progress-bar',\n /** The root of a `Skeleton`, wrapping its avatar and text rows. */\n skeleton: 'dial-kit-skeleton',\n /**\n * The `Notification` surface. Present on every wrapper too — the toast and\n * section-message variants of error, info, success, warning, loading and\n * general all render this component.\n */\n notification: 'dial-kit-notification',\n /** The empty-state root of `NoDataContent`. */\n noDataContent: 'dial-kit-no-data-content',\n /** The `role=\"status\"` panel of a `TransferQueue`: header, rows and aggregate bar. */\n transferQueue: 'dial-kit-transfer-queue',\n\n /* ── Text ──────────────────────────────────────────────────────────────── */\n /** The text element of a `Highlight`, which renders the matched query. */\n highlight: 'dial-kit-highlight',\n /** The caption line under a field, rendered by `CaptionText`. */\n captionText: 'dial-kit-caption-text',\n /**\n * A caption in its error variant — what `ErrorText` renders. Additive to\n * `captionText`, since one component draws both.\n */\n errorText: 'dial-kit-error-text',\n /** The `Label` root, which wraps the `label` element and its info button. */\n label: 'dial-kit-label',\n\n /* ── Containers ────────────────────────────────────────────────────────── */\n /** The `article` element of a `CardShell`. */\n cardShell: 'dial-kit-card-shell',\n /** The `aside` element of a `CollapsibleSidebar`. */\n collapsibleSidebar: 'dial-kit-collapsible-sidebar',\n /** The content box inside a `ResizableContainer`'s resize frame. */\n resizableContainer: 'dial-kit-resizable-container',\n /**\n * The `role=\"dialog\"` panel of a `Popup`. Its backdrop is reached through\n * `overlayClassName`.\n */\n popup: 'dial-kit-popup',\n /** The `Popup` panel of a `ConfirmationPopup`, additive to `popup`. */\n confirmationPopup: 'dial-kit-confirmation-popup',\n /** The root of an `Accordion`. */\n accordion: 'dial-kit-accordion',\n /** The breadcrumb root of a `FolderPath`. */\n folderPath: 'dial-kit-folder-path',\n /** The `nav` element of a `Breadcrumbs` trail. */\n breadcrumbs: 'dial-kit-breadcrumbs',\n /**\n * One segment of a `Breadcrumbs` trail: the link, button or plain span that\n * draws the label — not the `li`, which also holds the separator after it.\n */\n breadcrumbsItem: 'dial-kit-breadcrumbs-item',\n\n /* ── Menus and overlays ────────────────────────────────────────────────── */\n /**\n * The trigger wrapper of a `Dropdown`. Its floating panel is reached through\n * `listClassName`.\n */\n dropdown: 'dial-kit-dropdown',\n /**\n * The `role=\"none\"` item list inside a dropdown overlay — the box that holds\n * the rows and owns their vertical padding. Present in both generations, and\n * on a submenu's own list. It is *not* the floating panel.\n */\n dropdownList: 'dial-kit-dropdown-list',\n /**\n * One row of a floating overlay: a dropdown item, a `Select` option, a\n * submenu trigger, or a submenu child. It sits on the element that draws the\n * row box — so on the wrapper, not the inner button, for a row that has a\n * `rightControl` beside it.\n */\n menuItem: 'dial-kit-menuitem',\n /**\n * The trailing check of a chosen `MenuItemMark.Check` row. Decorative, like\n * the glyph itself — the row's `aria-checked` / `aria-selected` carries the\n * state.\n */\n menuItemCheck: 'dial-kit-menuitem-check',\n /** The primary icon of a `DialDropdownIcon` trigger. */\n dropdownIcon: 'dial-kit-dropdown-icon',\n /**\n * The caret badge of a `DialDropdownIcon` trigger — the round plate the\n * chevron sits on. Absent when `showCaret` is `false`.\n */\n dropdownIconCaret: 'dial-kit-dropdown-icon-caret',\n /** The bubble of a `Tooltip`, rendered by `TooltipContent` into a portal. */\n tooltip: 'dial-kit-tooltip',\n /** The panel of an `InteractiveTooltip` — the one whose content takes focus. */\n interactiveTooltip: 'dial-kit-interactive-tooltip',\n /** The text element of an `EllipsisTooltip`, which is also its trigger. */\n ellipsisTooltip: 'dial-kit-ellipsis-tooltip',\n\n /* ── Fields ────────────────────────────────────────────────────────────── */\n /** The `Search` field, additive to the `dial-kit-input` its `Input` carries. */\n search: 'dial-kit-search',\n /** The `PasswordInput` field, additive to `dial-kit-input`. */\n passwordInput: 'dial-kit-password-input',\n /** The `NumberInput` field, additive to `dial-kit-input`. */\n numberInput: 'dial-kit-number-input',\n /** The `TagInput` field, additive to `dial-kit-input`. */\n tagInput: 'dial-kit-tag-input',\n /** The root of a `Select`, wrapping its label, field and caption. */\n select: 'dial-kit-select',\n /** The trigger button of an `InlineSelect`. */\n inlineSelect: 'dial-kit-inline-select',\n /** The root of a `Calendar`, wrapping its label and date field. */\n calendar: 'dial-kit-calendar',\n /** The drop area of a `FileDropzone`. */\n fileDropzone: 'dial-kit-file-dropzone',\n /**\n * The root of a `FileIcon`, wrapping the file or folder glyph (or\n * its spinner while loading) and the shared badge.\n */\n fileIcon: 'dial-kit-file-icon',\n /** The row of a `FileName`: its type icon, the name and any details. */\n fileName: 'dial-kit-file-name',\n /** The `FileName` row of a `FolderName`, additive to `fileName`. */\n folderName: 'dial-kit-folder-name',\n /**\n * The `role=\"img\"` badge of a `SharedEntityIndicator` — standalone, or the\n * shared badge a `FileIcon` draws over its glyph.\n */\n sharedEntityIndicator: 'dial-kit-shared-entity-indicator',\n\n /* ── Controls ──────────────────────────────────────────────────────────── */\n /** The row of a `Switch`: the control and its label. */\n switch: 'dial-kit-switch',\n /** The row of a `Checkbox`: the box and its label. */\n checkbox: 'dial-kit-checkbox',\n /** The decorative box a `CheckboxBox` draws, in a checkbox or a menu row. */\n checkboxBox: 'dial-kit-checkbox-box',\n /** The row of a `Radio`: the circle and its label. */\n radio: 'dial-kit-radio',\n /** The root of a `RadioGroup`, wrapping its label and its radios. */\n radioGroup: 'dial-kit-radio-group',\n /**\n * The root of a `RadioGroupPopupField`, wrapping its label and the collapsed\n * field that opens the group.\n */\n radioGroupPopupField: 'dial-kit-radio-group-popup-field',\n /** The `role=\"radiogroup\"` track of a `SegmentedControl`. */\n segmentedControl: 'dial-kit-segmented-control',\n /** One segment of a `SegmentedControl`. */\n segmentedControlItem: 'dial-kit-segmented-control-item',\n /**\n * The outermost element of a `Tabs`: the box wrapping its heading and tab\n * list — or the `role=\"tablist\"` itself, which is the root when the tabs\n * carry no `sectionLabel`.\n */\n tabs: 'dial-kit-tabs',\n /**\n * The `role=\"tablist\"` holding the tabs, in either orientation. Additive to\n * `tabs` when there is no heading above it, since one element is then both.\n */\n tabList: 'dial-kit-tab-list',\n /**\n * One tab inside `Tabs`, in either orientation. The selected tab of a\n * horizontal row keeps its own `dial-kit-tab-selected-underline`.\n */\n tab: 'dial-kit-tab',\n /**\n * The selected tab, additive to `tab`. A horizontal row draws its selection\n * with `dial-kit-tab-selected-underline`, which carries the gradient rule;\n * this one carries no declarations and marks the selected tab in either\n * orientation.\n */\n tabSelected: 'dial-kit-tab-selected',\n /** The `sectionLabel` heading above a `Tabs`. Absent when there is none. */\n tabsSectionLabel: 'dial-kit-tabs-section-label',\n /**\n * The `role=\"group\"` row of a `FilterChips`. Its chips are `Tag` pills, so\n * they carry `dial-kit-tag` and have no entry of their own.\n */\n filterChips: 'dial-kit-filter-chips',\n /** A `Tag` pill, wherever it is rendered — including a `TagInput`'s rows. */\n tag: 'dial-kit-tag',\n /**\n * A `ToggleIconButton`, additive to the `dial-kit-base-icon-button` it\n * already carries.\n */\n toggleIconButton: 'dial-kit-toggle-icon-button',\n /** A `CloseButton`, additive to `dial-kit-base-icon-button`. */\n closeButton: 'dial-kit-close-button',\n /** An `InfoButton`, additive to `dial-kit-base-icon-button`. */\n infoButton: 'dial-kit-info-button',\n /**\n * The wrapper of a `ButtonDropdown` — its trigger carries\n * `dial-kit-base-button`.\n */\n buttonDropdown: 'dial-kit-button-dropdown',\n} as const"
|
|
10741
11540
|
}
|
|
10742
11541
|
]
|
|
10743
11542
|
}
|