@epam/ai-dial-ui-kit 0.15.0-dev.3 → 0.15.0-dev.30

package/dist/src/components/SchemaRenderer/utils.d.ts

@@ -1,9 +1,14 @@
-import { JsonSchema, JsonSchemaDef, ValidationError } from './types';
+import { JsonSchemaType, JsonSchema, JsonSchemaDef, ValidationError } from './types';
 export declare function resolveRef(schema: JsonSchemaDef, rootSchema: JsonSchema, depth?: number): JsonSchemaDef;
 export declare function sortByPropertyOrder(entries: [string, JsonSchemaDef][]): [string, JsonSchemaDef][];
 export declare function isMissingRequiredValue(value: unknown): boolean;
 export declare function isObjectType(schema: JsonSchemaDef): boolean;
 export declare function toFieldLabel(key: string): string;
+/**
+ * Builds the "required" error message for a field. The label is quoted so a
+ * long title stays visually separate from the "is required" suffix.
+ */
+export declare const toRequiredMessage: (label: string) => string;
 export declare function getOptionLabel(schema: JsonSchemaDef, rootSchema: JsonSchema): string;
 export declare function extractDefaults(schema: JsonSchemaDef, rootSchema: JsonSchema, depth?: number): unknown;
 export declare function validateRequired(value: unknown, schema: JsonSchemaDef, rootSchema: JsonSchema, path?: string, depth?: number): ValidationError[];
@@ -11,3 +16,7 @@ export declare function buildSummary(value: unknown, schema: JsonSchemaDef, root
 export declare function detectAnyOfVariant(value: unknown, schemas: JsonSchemaDef[], rootSchema: JsonSchema): number;
 export declare function getItemTitle(item: unknown, discriminatorProp: string | undefined, index: number): string;
 export declare function getSchemaDefault(schema: JsonSchemaDef): unknown;
+export type EntryType = JsonSchemaType.String | JsonSchemaType.Number | JsonSchemaType.Boolean | JsonSchemaType.Null | JsonSchemaType.Object | JsonSchemaType.Array;
+export declare const ENTRY_TYPE_OPTIONS: EntryType[];
+export declare function inferEntryType(value: unknown): EntryType;
+export declare function getEntryTypeDefault(type: EntryType): unknown;

package/dist/src/constants/public-class-names.d.ts

@@ -0,0 +1,189 @@
+export declare const DIAL_KIT_CLASS: {
+    /** The `role="status"` root of a `Spinner`. */
+    readonly spinner: "dial-kit-spinner";
+    /**
+     * The outermost element of a `ProgressBar`: the box wrapping its label,
+     * track and readout — or the track itself, which is the root when the bar
+     * has neither.
+     */
+    readonly progressBar: "dial-kit-progress-bar";
+    /** The root of a `Skeleton`, wrapping its avatar and text rows. */
+    readonly skeleton: "dial-kit-skeleton";
+    /**
+     * The `Notification` surface. Present on every wrapper too — the toast and
+     * section-message variants of error, info, success, warning, loading and
+     * general all render this component.
+     */
+    readonly notification: "dial-kit-notification";
+    /** The empty-state root of `NoDataContent`. */
+    readonly noDataContent: "dial-kit-no-data-content";
+    /** The `role="status"` panel of a `TransferQueue`: header, rows and aggregate bar. */
+    readonly transferQueue: "dial-kit-transfer-queue";
+    /** The text element of a `Highlight`, which renders the matched query. */
+    readonly highlight: "dial-kit-highlight";
+    /** The caption line under a field, rendered by `CaptionText`. */
+    readonly captionText: "dial-kit-caption-text";
+    /**
+     * A caption in its error variant — what `ErrorText` renders. Additive to
+     * `captionText`, since one component draws both.
+     */
+    readonly errorText: "dial-kit-error-text";
+    /** The `Label` root, which wraps the `label` element and its info button. */
+    readonly label: "dial-kit-label";
+    /** The `article` element of a `CardShell`. */
+    readonly cardShell: "dial-kit-card-shell";
+    /** The `aside` element of a `CollapsibleSidebar`. */
+    readonly collapsibleSidebar: "dial-kit-collapsible-sidebar";
+    /** The content box inside a `ResizableContainer`'s resize frame. */
+    readonly resizableContainer: "dial-kit-resizable-container";
+    /**
+     * The `role="dialog"` panel of a `Popup`. Its backdrop is reached through
+     * `overlayClassName`.
+     */
+    readonly popup: "dial-kit-popup";
+    /** The `Popup` panel of a `ConfirmationPopup`, additive to `popup`. */
+    readonly confirmationPopup: "dial-kit-confirmation-popup";
+    /** The root of an `Accordion`. */
+    readonly accordion: "dial-kit-accordion";
+    /** The breadcrumb root of a `FolderPath`. */
+    readonly folderPath: "dial-kit-folder-path";
+    /** The `nav` element of a `Breadcrumbs` trail. */
+    readonly breadcrumbs: "dial-kit-breadcrumbs";
+    /**
+     * One segment of a `Breadcrumbs` trail: the link, button or plain span that
+     * draws the label — not the `li`, which also holds the separator after it.
+     */
+    readonly breadcrumbsItem: "dial-kit-breadcrumbs-item";
+    /**
+     * The trigger wrapper of a `Dropdown`. Its floating panel is reached through
+     * `listClassName`.
+     */
+    readonly dropdown: "dial-kit-dropdown";
+    /**
+     * The `role="none"` item list inside a dropdown overlay — the box that holds
+     * the rows and owns their vertical padding. Present in both generations, and
+     * on a submenu's own list. It is *not* the floating panel.
+     */
+    readonly dropdownList: "dial-kit-dropdown-list";
+    /**
+     * One row of a floating overlay: a dropdown item, a `Select` option, a
+     * submenu trigger, or a submenu child. It sits on the element that draws the
+     * row box — so on the wrapper, not the inner button, for a row that has a
+     * `rightControl` beside it.
+     */
+    readonly menuItem: "dial-kit-menuitem";
+    /**
+     * The trailing check of a chosen `MenuItemMark.Check` row. Decorative, like
+     * the glyph itself — the row's `aria-checked` / `aria-selected` carries the
+     * state.
+     */
+    readonly menuItemCheck: "dial-kit-menuitem-check";
+    /** The primary icon of a `DialDropdownIcon` trigger. */
+    readonly dropdownIcon: "dial-kit-dropdown-icon";
+    /**
+     * The caret badge of a `DialDropdownIcon` trigger — the round plate the
+     * chevron sits on. Absent when `showCaret` is `false`.
+     */
+    readonly dropdownIconCaret: "dial-kit-dropdown-icon-caret";
+    /** The bubble of a `Tooltip`, rendered by `TooltipContent` into a portal. */
+    readonly tooltip: "dial-kit-tooltip";
+    /** The panel of an `InteractiveTooltip` — the one whose content takes focus. */
+    readonly interactiveTooltip: "dial-kit-interactive-tooltip";
+    /** The text element of an `EllipsisTooltip`, which is also its trigger. */
+    readonly ellipsisTooltip: "dial-kit-ellipsis-tooltip";
+    /** The `Search` field, additive to the `dial-kit-input` its `Input` carries. */
+    readonly search: "dial-kit-search";
+    /** The `PasswordInput` field, additive to `dial-kit-input`. */
+    readonly passwordInput: "dial-kit-password-input";
+    /** The `NumberInput` field, additive to `dial-kit-input`. */
+    readonly numberInput: "dial-kit-number-input";
+    /** The `TagInput` field, additive to `dial-kit-input`. */
+    readonly tagInput: "dial-kit-tag-input";
+    /** The root of a `Select`, wrapping its label, field and caption. */
+    readonly select: "dial-kit-select";
+    /** The trigger button of an `InlineSelect`. */
+    readonly inlineSelect: "dial-kit-inline-select";
+    /** The root of a `Calendar`, wrapping its label and date field. */
+    readonly calendar: "dial-kit-calendar";
+    /** The drop area of a `FileDropzone`. */
+    readonly fileDropzone: "dial-kit-file-dropzone";
+    /**
+     * The root of a `FileIcon`, wrapping the file or folder glyph (or
+     * its spinner while loading) and the shared badge.
+     */
+    readonly fileIcon: "dial-kit-file-icon";
+    /** The row of a `FileName`: its type icon, the name and any details. */
+    readonly fileName: "dial-kit-file-name";
+    /** The `FileName` row of a `FolderName`, additive to `fileName`. */
+    readonly folderName: "dial-kit-folder-name";
+    /**
+     * The `role="img"` badge of a `SharedEntityIndicator` — standalone, or the
+     * shared badge a `FileIcon` draws over its glyph.
+     */
+    readonly sharedEntityIndicator: "dial-kit-shared-entity-indicator";
+    /** The row of a `Switch`: the control and its label. */
+    readonly switch: "dial-kit-switch";
+    /** The row of a `Checkbox`: the box and its label. */
+    readonly checkbox: "dial-kit-checkbox";
+    /** The decorative box a `CheckboxBox` draws, in a checkbox or a menu row. */
+    readonly checkboxBox: "dial-kit-checkbox-box";
+    /** The row of a `Radio`: the circle and its label. */
+    readonly radio: "dial-kit-radio";
+    /** The root of a `RadioGroup`, wrapping its label and its radios. */
+    readonly radioGroup: "dial-kit-radio-group";
+    /**
+     * The root of a `RadioGroupPopupField`, wrapping its label and the collapsed
+     * field that opens the group.
+     */
+    readonly radioGroupPopupField: "dial-kit-radio-group-popup-field";
+    /** The `role="radiogroup"` track of a `SegmentedControl`. */
+    readonly segmentedControl: "dial-kit-segmented-control";
+    /** One segment of a `SegmentedControl`. */
+    readonly segmentedControlItem: "dial-kit-segmented-control-item";
+    /**
+     * The outermost element of a `Tabs`: the box wrapping its heading and tab
+     * list — or the `role="tablist"` itself, which is the root when the tabs
+     * carry no `sectionLabel`.
+     */
+    readonly tabs: "dial-kit-tabs";
+    /**
+     * The `role="tablist"` holding the tabs, in either orientation. Additive to
+     * `tabs` when there is no heading above it, since one element is then both.
+     */
+    readonly tabList: "dial-kit-tab-list";
+    /**
+     * One tab inside `Tabs`, in either orientation. The selected tab of a
+     * horizontal row keeps its own `dial-kit-tab-selected-underline`.
+     */
+    readonly tab: "dial-kit-tab";
+    /**
+     * The selected tab, additive to `tab`. A horizontal row draws its selection
+     * with `dial-kit-tab-selected-underline`, which carries the gradient rule;
+     * this one carries no declarations and marks the selected tab in either
+     * orientation.
+     */
+    readonly tabSelected: "dial-kit-tab-selected";
+    /** The `sectionLabel` heading above a `Tabs`. Absent when there is none. */
+    readonly tabsSectionLabel: "dial-kit-tabs-section-label";
+    /**
+     * The `role="group"` row of a `FilterChips`. Its chips are `Tag` pills, so
+     * they carry `dial-kit-tag` and have no entry of their own.
+     */
+    readonly filterChips: "dial-kit-filter-chips";
+    /** A `Tag` pill, wherever it is rendered — including a `TagInput`'s rows. */
+    readonly tag: "dial-kit-tag";
+    /**
+     * A `ToggleIconButton`, additive to the `dial-kit-base-icon-button` it
+     * already carries.
+     */
+    readonly toggleIconButton: "dial-kit-toggle-icon-button";
+    /** A `CloseButton`, additive to `dial-kit-base-icon-button`. */
+    readonly closeButton: "dial-kit-close-button";
+    /** An `InfoButton`, additive to `dial-kit-base-icon-button`. */
+    readonly infoButton: "dial-kit-info-button";
+    /**
+     * The wrapper of a `ButtonDropdown` — its trigger carries
+     * `dial-kit-base-button`.
+     */
+    readonly buttonDropdown: "dial-kit-button-dropdown";
+};

package/dist/src/index.d.ts

@@ -138,9 +138,12 @@ export { type DialCopiedItem, type DialDeletedItem, type DialUploadFileItem, typ
 export { GridSelectionMode } from './models/selection-mode';
 export { mergeClasses } from './utils/merge-classes';
 export { wrapInRootFolder } from './utils/flat-to-hierarchy-convertor.ts';
+export { getTimezoneLabel } from './utils/timezone';
+export type { TimezoneLabelOptions } from './utils/timezone';
 export { NAME_COLUMN, SIZE_COLUMN, UPDATED_AT_COLUMN, } from './constants/file-grid-columns';
 export { DIAL_ICON_SIZE, BASE_ICON_PROPS, BASE_ICON_SIZE, } from './constants/icon.ts';
 export { NOT_ALLOWED_SYMBOLS, NOT_ALLOWED_SPACES, NOT_ALLOWED_SYMBOLS_REGEXP, NOT_ALLOWED_SPACES_REGEXP, } from './constants/validation.ts';
+export { DIAL_KIT_CLASS } from './constants/public-class-names';
 export { DialSchemaRenderer } from './components/SchemaRenderer/SchemaRenderer';
 export { SchemaRendererVariant, SchemaDisplayMode, SchemaOrientation, JsonSchemaType, } from './components/SchemaRenderer/types';
 export type { DialSchemaRendererProps, JsonSchema, JsonSchemaDef, ValidationError, } from './components/SchemaRenderer/types';
@@ -157,7 +160,10 @@ export { Calendar } from './components/New/Calendar/Calendar';
 export type { CalendarProps, CalendarValue, } from './components/New/Calendar/Calendar';
 export { FolderPath } from './components/New/FolderPath/FolderPath';
 export type { FolderPathProps } from './components/New/FolderPath/FolderPath';
-export { DangerButton, GhostButton, LinkButton, NeutralButton, OutlinedButton, PrimaryButton, } from './components/New/Button/ButtonWrappers';
+export { BreadcrumbsSize } from './types/breadcrumbs';
+export { Breadcrumbs } from './components/New/Breadcrumbs/Breadcrumbs';
+export type { BreadcrumbsProps, BreadcrumbsItem, } from './components/New/Breadcrumbs/Breadcrumbs';
+export { DangerButton, GhostButton, LinkButton, NeutralButton, OutlinedButton, PrimaryButton, StarterButton, } from './components/New/Button/ButtonWrappers';
 export { DangerIconButton, GhostIconButton, NeutralIconButton, PrimaryIconButton, StaticIconButton, } from './components/New/IconButton/IconButtonWrappers';
 export { Button } from './components/New/Button/Button';
 export { IconButton } from './components/New/IconButton/IconButton';
@@ -203,6 +209,7 @@ export type { CaptionTextProps } from './components/New/CaptionText/CaptionText'
 export { CaptionText, ErrorText, } from './components/New/CaptionText/CaptionText';
 export { Accordion } from './components/New/Accordion/Accordion';
 export type { AccordionProps } from './components/New/Accordion/Accordion';
+export { AccordionCaretPosition } from './types/accordion';
 export { Switch } from './components/New/Switch/Switch';
 export type { SwitchProps } from './components/New/Switch/Switch';
 export { Radio } from './components/New/Radio/Radio';
@@ -221,8 +228,18 @@ export { SegmentedControl } from './components/New/SegmentedControl/SegmentedCon
 export type { SegmentedControlProps, SegmentedControlItem, } from './components/New/SegmentedControl/SegmentedControl';
 export { Tabs } from './components/New/Tabs/Tabs';
 export type { TabsProps, TabItem } from './components/New/Tabs/Tabs';
+export { FilterChips } from './components/New/FilterChips/FilterChips';
+export type { FilterChipsProps, FilterChipItem, } from './components/New/FilterChips/FilterChips';
 export { FileDropzone } from './components/New/FileDropzone/FileDropzone';
 export type { FileDropzoneProps } from './components/New/FileDropzone/FileDropzone';
+export { FileIcon } from './components/New/FileIcon/FileIcon';
+export type { FileIconProps } from './components/New/FileIcon/FileIcon';
+export { FileName } from './components/New/FileName/FileName';
+export type { FileNameProps } from './components/New/FileName/FileName';
+export { FolderName } from './components/New/FolderName/FolderName';
+export type { FolderNameProps } from './components/New/FolderName/FolderName';
+export { SharedEntityIndicator } from './components/New/SharedEntityIndicator/SharedEntityIndicator';
+export type { SharedEntityIndicatorProps } from './components/New/SharedEntityIndicator/SharedEntityIndicator';
 export { Tag } from './components/New/Tag/Tag';
 export type { TagProps } from './components/New/Tag/Tag';
 export { TagAppearance } from './types/tag';
@@ -253,6 +270,10 @@ export { ConditionalResizableContainer } from './components/New/ResizableContain
 export type { ConditionalResizableContainerProps } from './components/New/ResizableContainer/ConditionalResizableContainer';
 export { NoDataContent } from './components/New/NoDataContent/NoDataContent';
 export type { NoDataContentProps } from './components/New/NoDataContent/NoDataContent';
+export { TransferQueue } from './components/New/TransferQueue/TransferQueue';
+export type { TransferQueueItem, TransferQueueLabels, TransferQueueProps, } from './components/New/TransferQueue/TransferQueue';
+export { DEFAULT_TRANSFER_QUEUE_LABELS, TRANSFER_QUEUE_AUTO_CLOSE_DELAY_MS, } from './components/New/TransferQueue/constants';
+export { TransferQueueItemStatus } from './types/transfer-queue';
 export { Grid, GRID_SELECTION_COLUMN_ID } from './components/New/Grid/Grid';
 export type { GridProps } from './components/New/Grid/Grid';
 export { DateCellRenderer } from './components/New/Grid/renderers/DateCellRenderer';

package/dist/src/types/accordion.d.ts

@@ -0,0 +1,7 @@
+/** Where an `Accordion` header draws its caret. */
+export declare enum AccordionCaretPosition {
+    /** Before the title, at the header's leading edge. */
+    Start = "start",
+    /** After the title, at the header's trailing edge. */
+    End = "end"
+}

package/dist/src/types/breadcrumbs.d.ts

@@ -0,0 +1,9 @@
+export declare enum BreadcrumbsSize {
+    /** 14px `dial-small-text`, with a `dial-small-semi-text` current page. */
+    Small = "small",
+    /**
+     * 18px `dial-h2-text`, for a trail that doubles as the page heading. The
+     * token is semibold, so every segment is — including the current page.
+     */
+    Heading = "heading"
+}

package/dist/src/types/button.d.ts

@@ -3,6 +3,7 @@ export declare enum ButtonVariant {
     Neutral = "neutral",
     Danger = "danger",
     Static = "static",
+    Starter = "starter",
     Success = "success",
     Secondary = "secondary",
     Tertiary = "tertiary"

package/dist/src/types/transfer-queue.d.ts

@@ -0,0 +1,10 @@
+/** Lifecycle status of one item in a `TransferQueue`. */
+export declare enum TransferQueueItemStatus {
+    /** Queued or running; the row shows a spinner and, when cancelable, a cancel control. */
+    InProgress = "inProgress",
+    Success = "success",
+    /** Delivered, but not everything the user asked for made it through. */
+    Warning = "warning",
+    Failed = "failed",
+    Canceled = "canceled"
+}

package/dist/src/utils/__tests__/timezone.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/sub-menu-floating.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { HTMLProps, ReactNode } from 'react';
 export interface SubMenuHoverOptions {
     delay?: number | {
         open?: number;
@@ -8,7 +8,10 @@ export interface SubMenuHoverOptions {
 }
 /**
  * Shared floating state for right-side submenus.
- * Handles open state, Floating UI positioning and hover/dismiss/role interactions.
+ * Handles open state, Floating UI positioning, hover/dismiss/role interactions,
+ * and the menu keyboard pattern: the inline-end arrow, Enter, or Space on the
+ * trigger opens the submenu and focuses its first row; ArrowUp/ArrowDown/Home/End
+ * move between its rows; the inline-start arrow closes it back to the trigger.
  */
 export declare function useSubMenuFloating(gap: number, ariaRole?: 'menu' | 'listbox', disabled?: boolean, hoverOptions?: SubMenuHoverOptions): {
     isOpen: boolean;
@@ -38,8 +41,8 @@ export declare function useSubMenuFloating(gap: number, ariaRole?: 'menu' | 'lis
         refs: import('@floating-ui/react').ExtendedRefs<import('@floating-ui/react').ReferenceType>;
         elements: import('@floating-ui/react').ExtendedElements<import('@floating-ui/react').ReferenceType>;
     };
-    getReferenceProps: (userProps?: React.HTMLProps<Element>) => Record<string, unknown>;
-    getFloatingProps: (userProps?: React.HTMLProps<HTMLElement>) => Record<string, unknown>;
+    getReferenceProps: (userProps?: HTMLProps<Element>) => Record<string, unknown>;
+    getFloatingProps: (userProps?: HTMLProps<HTMLElement>) => Record<string, unknown>;
 };
 interface SubMenuPanelProps {
     refs: ReturnType<typeof useSubMenuFloating>['refs'];

package/dist/src/utils/timezone.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Options for {@link getTimezoneLabel}.
+ */
+export interface TimezoneLabelOptions {
+    /** BCP 47 locale tag; only affects how the platform renders the offset
+     * (e.g. `fr` renders `UTC+01:00` where `en` renders `GMT+01:00`). Omitting
+     * it passes `undefined` to `Intl`, which resolves to the runtime's default
+     * locale. */
+    locale?: string;
+    /** IANA timezone name; defaults to the viewer's zone from
+     * `Intl.DateTimeFormat().resolvedOptions().timeZone`. */
+    timeZone?: string;
+    /** The date whose offset is rendered — the one in effect on `date`, so a
+     * value across a DST boundary from today shows its own offset. Defaults to
+     * today. */
+    date?: Date;
+}
+/**
+ * Returns a timezone as a hint label for time-of-day fields, e.g.
+ * `(GMT+01:00) Europe/Berlin`: the UTC offset in effect at `options.date`
+ * rendered by `Intl` (`timeZoneName: 'longOffset'`), followed by the IANA
+ * timezone name.
+ */
+export declare const getTimezoneLabel: ({ locale, timeZone, date, }?: TimezoneLabelOptions) => string;

package/dist/types/accordion.js

@@ -0,0 +1,4 @@
+var t = /* @__PURE__ */ ((r) => (r.Start = "start", r.End = "end", r))(t || {});
+export {
+  t as AccordionCaretPosition
+};

package/dist/types/breadcrumbs.js

@@ -0,0 +1,4 @@
+var l = /* @__PURE__ */ ((a) => (a.Small = "small", a.Heading = "heading", a))(l || {});
+export {
+  l as BreadcrumbsSize
+};

package/dist/types/button.js

@@ -1,5 +1,5 @@
-var s = /* @__PURE__ */ ((r) => (r.Primary = "primary", r.Neutral = "neutral", r.Danger = "danger", r.Static = "static", r.Success = "success", r.Secondary = "secondary", r.Tertiary = "tertiary", r))(s || {}), e = /* @__PURE__ */ ((r) => (r.Solid = "solid", r.Outlined = "outlined", r.Ghost = "ghost", r.Link = "link", r))(e || {});
+var e = /* @__PURE__ */ ((r) => (r.Primary = "primary", r.Neutral = "neutral", r.Danger = "danger", r.Static = "static", r.Starter = "starter", r.Success = "success", r.Secondary = "secondary", r.Tertiary = "tertiary", r))(e || {}), s = /* @__PURE__ */ ((r) => (r.Solid = "solid", r.Outlined = "outlined", r.Ghost = "ghost", r.Link = "link", r))(s || {});
 export {
-  e as ButtonAppearance,
-  s as ButtonVariant
+  s as ButtonAppearance,
+  e as ButtonVariant
 };

package/dist/types/transfer-queue.js

@@ -0,0 +1,4 @@
+var i = /* @__PURE__ */ ((c) => (c.InProgress = "inProgress", c.Success = "success", c.Warning = "warning", c.Failed = "failed", c.Canceled = "canceled", c))(i || {});
+export {
+  i as TransferQueueItemStatus
+};