@hitachivantara/uikit-react-core 5.93.1 → 5.94.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/dist/cjs/Avatar/Avatar.styles.cjs +1 -0
  2. package/dist/cjs/Badge/Badge.cjs +7 -0
  3. package/dist/cjs/Badge/Badge.styles.cjs +1 -1
  4. package/dist/cjs/Banner/BannerContent/BannerContent.styles.cjs +1 -2
  5. package/dist/cjs/BaseDropdown/BaseDropdown.styles.cjs +5 -16
  6. package/dist/cjs/BaseDropdown/BaseDropdownPanel.cjs +1 -0
  7. package/dist/cjs/BaseInput/BaseInput.styles.cjs +1 -1
  8. package/dist/cjs/BulkActions/BulkActions.styles.cjs +1 -1
  9. package/dist/cjs/DropDownMenu/DropDownMenu.styles.cjs +1 -15
  10. package/dist/cjs/DropdownButton/DropdownButton.styles.cjs +1 -8
  11. package/dist/cjs/FormElement/CharCounter/CharCounter.cjs +1 -1
  12. package/dist/cjs/FormElement/Suggestions/Suggestions.styles.cjs +7 -1
  13. package/dist/cjs/IconContainer/IconContainer.cjs +4 -4
  14. package/dist/cjs/Input/Input.cjs +18 -21
  15. package/dist/cjs/Input/Input.styles.cjs +2 -6
  16. package/dist/cjs/Select/Select.styles.cjs +5 -12
  17. package/dist/cjs/TagsInput/TagsInput.cjs +3 -0
  18. package/dist/cjs/TagsInput/TagsInput.styles.cjs +1 -1
  19. package/dist/cjs/TextArea/TextArea.cjs +1 -0
  20. package/dist/cjs/VerticalNavigation/VerticalNavigation.cjs +1 -2
  21. package/dist/cjs/icons.cjs +19 -21
  22. package/dist/cjs/utils/Callout.cjs +4 -2
  23. package/dist/cjs/utils/focusUtils.cjs +2 -0
  24. package/dist/esm/Avatar/Avatar.styles.js +1 -0
  25. package/dist/esm/Badge/Badge.js +8 -1
  26. package/dist/esm/Badge/Badge.styles.js +1 -1
  27. package/dist/esm/Banner/BannerContent/BannerContent.styles.js +1 -2
  28. package/dist/esm/BaseDropdown/BaseDropdown.styles.js +5 -16
  29. package/dist/esm/BaseDropdown/BaseDropdownPanel.js +1 -0
  30. package/dist/esm/BaseInput/BaseInput.styles.js +1 -1
  31. package/dist/esm/BulkActions/BulkActions.styles.js +1 -1
  32. package/dist/esm/DropDownMenu/DropDownMenu.styles.js +1 -15
  33. package/dist/esm/DropdownButton/DropdownButton.styles.js +1 -8
  34. package/dist/esm/FormElement/CharCounter/CharCounter.js +1 -1
  35. package/dist/esm/FormElement/Suggestions/Suggestions.styles.js +7 -1
  36. package/dist/esm/IconContainer/IconContainer.js +4 -4
  37. package/dist/esm/Input/Input.js +19 -22
  38. package/dist/esm/Input/Input.styles.js +2 -6
  39. package/dist/esm/Select/Select.styles.js +5 -12
  40. package/dist/esm/TagsInput/TagsInput.js +3 -0
  41. package/dist/esm/TagsInput/TagsInput.styles.js +1 -1
  42. package/dist/esm/TextArea/TextArea.js +1 -0
  43. package/dist/esm/VerticalNavigation/VerticalNavigation.js +1 -2
  44. package/dist/esm/icons.js +19 -21
  45. package/dist/esm/utils/Callout.js +4 -2
  46. package/dist/esm/utils/focusUtils.js +2 -0
  47. package/dist/types/index.d.ts +62 -95
  48. package/package.json +5 -5
  49. package/dist/cjs/VerticalNavigation/utils/VerticalNavigation.utils.cjs +0 -6
  50. package/dist/esm/VerticalNavigation/utils/VerticalNavigation.utils.js +0 -6
@@ -1053,7 +1053,7 @@ export declare type HvAccentColorKeys = HvAccentColor;
1053
1053
  export declare type HvAccentColors = Record<HvAccentColorKeys, string>;
1054
1054
 
1055
1055
  /**
1056
- * A accordion is a design element that expands in place to expose hidden information.
1056
+ * An accordion is a design element that expands in place to expose hidden information.
1057
1057
  */
1058
1058
  export declare const HvAccordion: ForwardRefExoticComponent<HvAccordionProps & RefAttributes<HTMLDivElement>>;
1059
1059
 
@@ -1171,6 +1171,9 @@ export declare interface HvAdornmentProps extends HvBaseProps<HTMLDivElement | H
1171
1171
  classes?: HvAdornmentClasses;
1172
1172
  }
1173
1173
 
1174
+ /**
1175
+ * An app switcher lets users quickly navigate between different applications or modules within a platform.
1176
+ */
1174
1177
  export declare const HvAppSwitcher: ForwardRefExoticComponent<HvAppSwitcherProps & RefAttributes<HTMLDivElement>>;
1175
1178
 
1176
1179
  export declare const HvAppSwitcherAction: ({ id, className, classes: classesProp, application, onClickCallback, isSelectedCallback, }: HvAppSwitcherActionProps) => JSX_2.Element;
@@ -1245,15 +1248,14 @@ export declare type HvAtmosphereColorKeys = HvAtmosphereColor;
1245
1248
  export declare type HvAtmosphereColors = Record<HvAtmosphereColorKeys, string>;
1246
1249
 
1247
1250
  /**
1248
- * Avatars can be used to represent a user or a brand.
1249
- * They can show an image, an icon or the initial letters of a name, for example.
1251
+ * Avatars represent a user or brand and can display an image, icon, or initials.
1250
1252
  */
1251
1253
  export declare const HvAvatar: ForwardRefExoticComponent<HvAvatarProps & RefAttributes<HTMLDivElement>>;
1252
1254
 
1253
1255
  export declare type HvAvatarClasses = ExtractNames<typeof useClasses_27>;
1254
1256
 
1255
1257
  /**
1256
- * The AvatarGroup component is used to group multiple avatars.
1258
+ *The Avatar Group displays a collection of avatars, often used to represent groups or teams.
1257
1259
  */
1258
1260
  export declare const HvAvatarGroup: ForwardRefExoticComponent<HvAvatarGroupProps & RefAttributes<HTMLDivElement>>;
1259
1261
 
@@ -1333,6 +1335,8 @@ export declare const HvBadge: ForwardRefExoticComponent<HvBadgeProps & RefAttrib
1333
1335
  export declare type HvBadgeClasses = ExtractNames<typeof useClasses_29>;
1334
1336
 
1335
1337
  export declare interface HvBadgeProps extends HvBaseProps {
1338
+ /** The badge color. */
1339
+ color?: HvColorAny;
1336
1340
  /**
1337
1341
  * Count is the number of unread notifications.
1338
1342
  * Note count and label are mutually exclusive.
@@ -1365,8 +1369,7 @@ export declare interface HvBadgeProps extends HvBaseProps {
1365
1369
  }
1366
1370
 
1367
1371
  /**
1368
- * A Banner displays an important and succinct message. It can also provide actions for the user to address, or dismiss.
1369
- * It requires a user action, for it to be dismissed. Banners should appear at the top of the screen, below a top app bar.
1372
+ * A **Banner** shows an important message with optional actions. It appears below the top app bar and requires user dismissal.
1370
1373
  */
1371
1374
  export declare const HvBanner: ForwardRefExoticComponent<Omit<HvBannerProps, "ref"> & RefAttributes<unknown>>;
1372
1375
 
@@ -1896,8 +1899,7 @@ export declare interface HvBreadCrumbProps extends HvBaseProps<HTMLDivElement, "
1896
1899
  export { HvBreakpoints }
1897
1900
 
1898
1901
  /**
1899
- * Bulk Actions allow users to perform an action on a single or multiple items.
1900
- * Also known as "batch production" of multiple items at once, one stage at a time.
1902
+ * Bulk Actions let users apply an action to one or multiple items at once, streamlining repetitive tasks.
1901
1903
  */
1902
1904
  export declare const HvBulkActions: ForwardRefExoticComponent<HvBulkActionsProps & RefAttributes<HTMLDivElement>>;
1903
1905
 
@@ -1999,7 +2001,7 @@ export declare const HvButton: <C extends React.ElementType = "button">(props: {
1999
2001
  component?: C | undefined;
2000
2002
  } & {
2001
2003
  children?: ReactNode | undefined;
2002
- } & (Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "component" | "className" | "radius" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> extends infer T ? T extends Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "component" | "className" | "radius" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> ? T extends any ? T : never : never : never) & {
2004
+ } & (Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "radius" | "component" | "className" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> extends infer T ? T extends Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "radius" | "component" | "className" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> ? T extends any ? T : never : never : never) & {
2003
2005
  ref?: PolymorphicRef<C> | undefined;
2004
2006
  } & RefAttributes<unknown>) => React.ReactElement<any> | null;
2005
2007
 
@@ -2181,10 +2183,7 @@ export declare interface HvCalendarProps extends Omit<React.HTMLAttributes<HTMLD
2181
2183
  declare type HvCalloutVariant = "success" | "warning" | "error" | "default" | "info" | "accent";
2182
2184
 
2183
2185
  /**
2184
- * A card is a container for a few short and related pieces of content.
2185
- * It roughly resembles a playing card in size and shape and is intended as a
2186
- * linked short representation of a conceptual unit. For that reason,
2187
- * this pattern must be used as an entry-point for further information.
2186
+ * A Card is a container for short, related content—similar in shape to a playing card—and serves as an entry point to more detailed information.
2188
2187
  */
2189
2188
  export declare const HvCard: ForwardRefExoticComponent<HvCardProps & RefAttributes<HTMLDivElement>>;
2190
2189
 
@@ -2251,8 +2250,7 @@ export declare interface HvCardProps extends HvBaseProps {
2251
2250
  }
2252
2251
 
2253
2252
  /**
2254
- * A Carousel is commonly used to browse images, it can also be used to browse any kind of content like text, video, or charts.
2255
- * It allows you to focus on a particular content while having a notion of how many you have to explore.
2253
+ A Carousel is used to browse content—commonly images, but also text, video, or charts. It highlights one item at a time while giving users a sense of the total content available.
2256
2254
  */
2257
2255
  export declare const HvCarousel: ForwardRefExoticComponent<HvCarouselProps & RefAttributes<HTMLDivElement>>;
2258
2256
 
@@ -2386,13 +2384,8 @@ export declare interface HvCharCounterProps extends HvBaseProps {
2386
2384
  }
2387
2385
 
2388
2386
  /**
2389
- * A Checkbox is a mechanism that allows the user to select one or more options.
2390
- *
2391
- * Usually used in a Checkbox Group to present the user with a range of options from
2392
- * which the user **may select any number of options** to complete their task.
2393
- *
2394
- * It can also be used individually to represent the toggle of a single option, when
2395
- * the Toggle Switch and Toggle Button aren't more appropriate.
2387
+ * A Checkbox lets users select one or more options.
2388
+ * It’s commonly used in a Checkbox Group to present multiple choices, but can also be used individually to toggle a single option.
2396
2389
  */
2397
2390
  export declare const HvCheckBox: ForwardRefExoticComponent<Omit<HvCheckBoxProps, "ref"> & RefAttributes<HTMLButtonElement>>;
2398
2391
 
@@ -3423,8 +3416,6 @@ export declare type HvFilesAddedEvent = (files: HvFileData[]) => void;
3423
3416
  /**
3424
3417
  * Lets the user choose one or more files from their device storage. Once chosen,
3425
3418
  * the files can be uploaded to a server or manipulated on the client side.
3426
- *
3427
- * Accepted file types follow the format of the html [input accept attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file).
3428
3419
  */
3429
3420
  export declare const HvFileUploader: (props: HvFileUploaderProps) => JSX_2.Element;
3430
3421
 
@@ -3514,9 +3505,7 @@ export declare interface HvFileUploaderProps extends HvFormElementProps {
3514
3505
  }
3515
3506
 
3516
3507
  /**
3517
- * This component implements one potential use-case of the Filter Group pattern Design System Specifies.
3518
- * Due to the enormous variety of capabilities required for this, we strongly recommend checking the code of the component and extend it yourself,
3519
- * while we do not provide a better approach for building this component with smaller and more composable parts.
3508
+ A Filter Group is a UI pattern used to organize and apply multiple filters to a dataset, helping users refine and narrow down results.
3520
3509
  */
3521
3510
  export declare const HvFilterGroup: ForwardRefExoticComponent<HvFilterGroupProps & RefAttributes<HTMLDivElement>>;
3522
3511
 
@@ -4022,7 +4011,7 @@ export declare const HvIconButton: <C extends React.ElementType = "button">(prop
4022
4011
  component?: C | undefined;
4023
4012
  } & {
4024
4013
  children?: ReactNode | undefined;
4025
- } & (Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "title" | "selected" | "variant" | "size" | "component" | "className" | "radius" | "overrideIconColors" | "placement" | "enterDelay" | "tooltipProps" | Exclude<keyof (Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "component" | "className" | "radius" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> extends infer T ? T extends Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "component" | "className" | "radius" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> ? T extends any ? T : never : never : never), "icon" | "title" | "children" | "ref" | "component" | "focusableWhenDisabled" | "startIcon" | "endIcon">> extends infer T_1 ? T_1 extends Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "title" | "selected" | "variant" | "size" | "component" | "className" | "radius" | "overrideIconColors" | "placement" | "enterDelay" | "tooltipProps" | Exclude<keyof (Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "component" | "className" | "radius" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> extends infer T_2 ? T_2 extends Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "component" | "className" | "radius" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> ? T_2 extends any ? T_2 : never : never : never), "icon" | "title" | "children" | "ref" | "component" | "focusableWhenDisabled" | "startIcon" | "endIcon">> ? T_1 extends any ? T_1 : never : never : never) & {
4014
+ } & (Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "title" | "selected" | "variant" | "size" | "radius" | "component" | "className" | "overrideIconColors" | "placement" | "enterDelay" | "tooltipProps" | Exclude<keyof (Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "radius" | "component" | "className" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> extends infer T ? T extends Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "radius" | "component" | "className" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> ? T extends any ? T : never : never : never), "icon" | "title" | "children" | "ref" | "component" | "focusableWhenDisabled" | "startIcon" | "endIcon">> extends infer T_1 ? T_1 extends Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "title" | "selected" | "variant" | "size" | "radius" | "component" | "className" | "overrideIconColors" | "placement" | "enterDelay" | "tooltipProps" | Exclude<keyof (Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "radius" | "component" | "className" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> extends infer T_2 ? T_2 extends Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "classes" | "disabled" | "icon" | "selected" | "variant" | "size" | "radius" | "component" | "className" | "focusableWhenDisabled" | "startIcon" | "endIcon" | "overrideIconColors"> ? T_2 extends any ? T_2 : never : never : never), "icon" | "title" | "children" | "ref" | "component" | "focusableWhenDisabled" | "startIcon" | "endIcon">> ? T_1 extends any ? T_1 : never : never : never) & {
4026
4015
  ref?: PolymorphicRef<C> | undefined;
4027
4016
  } & RefAttributes<unknown>) => React.ReactElement<any> | null;
4028
4017
 
@@ -4171,7 +4160,7 @@ export declare type HvInlineEditorProps<C extends React.ElementType = typeof HvI
4171
4160
  }>;
4172
4161
 
4173
4162
  /**
4174
- * A text input box is a graphical control element intended to enable the user to input text information to be used by the software.
4163
+ The Input is a UI control that allows users to enter and edit text, typically used for collecting user-provided information.
4175
4164
  */
4176
4165
  export declare const HvInput: <InputElement extends HTMLElement = HTMLInputElement | HTMLTextAreaElement>(props: HvInputProps<InputElement> & RefAttributes<InputElement>) => React.ReactElement<any> | null;
4177
4166
 
@@ -4666,9 +4655,8 @@ export declare function hvNumberColumn<D extends object = Record<string, unknown
4666
4655
  export declare const hvNumberFallback: (value: any) => number | "—";
4667
4656
 
4668
4657
  /**
4669
- * A number input component that allows the user to enter a number and displays two buttons to decrease / increase the value.
4670
- *
4671
- * This component extends the `HvInput` component, please check its documentation for more information on the available props.
4658
+ *A Number Input lets users enter numeric values and provides buttons to increment or decrement the value.
4659
+ *It extends the HvInput component—refer to its documentation for additional available props.
4672
4660
  *
4673
4661
  * @extends HvInput
4674
4662
  */
@@ -4712,7 +4700,7 @@ export declare interface HvOptionProps<OptionValue extends {}> extends Omit<HvLi
4712
4700
  }
4713
4701
 
4714
4702
  /**
4715
- * This component generates a tooltip whenever the text is overflowed.
4703
+ * Displays a tooltip automatically when the text content overflows its container.
4716
4704
  */
4717
4705
  export declare const HvOverflowTooltip: (props: HvOverflowTooltipProps) => JSX_2.Element;
4718
4706
 
@@ -4779,9 +4767,7 @@ export declare interface HvPaginationProps extends HvBaseProps {
4779
4767
  }
4780
4768
 
4781
4769
  /**
4782
- * A panel is a container used in a variety of patterns (e.g. dropdown, filter group, details section).
4783
- * It can be horizontal or vertical and its size is defined by its content and how it relates to surrounding patterns.
4784
- * Regardless of its content, a panel look and feel should be consistent.
4770
+ * A Panel is a flexible container used in patterns like dropdowns, filter groups, or detail sections. It can be horizontal or vertical, with size defined by its content and context. Its appearance should remain consistent regardless of usage.
4785
4771
  */
4786
4772
  export declare const HvPanel: ForwardRefExoticComponent<HvPanelProps & RefAttributes<HTMLDivElement>>;
4787
4773
 
@@ -4794,13 +4780,13 @@ export declare interface HvPanelProps extends HvBaseProps {
4794
4780
 
4795
4781
  export declare type HvPolarizedColorKeys = "positive" | "positive_120" | "positive_80" | "warning" | "warning_120" | "warning_140" | "negative" | "cat21" | "cat22" | "cat23" | "cat24" | "cat25" | "cat26" | "cat27" | "cat28" | "catastrophic";
4796
4782
 
4783
+ /**
4784
+ * Progress Bar provides feedback about a process that is taking place in the application.
4785
+ */
4797
4786
  export declare const HvProgressBar: (props: HvProgressBarProps) => JSX_2.Element;
4798
4787
 
4799
4788
  export declare type HvProgressBarClasses = ExtractNames<typeof useClasses_96>;
4800
4789
 
4801
- /**
4802
- * ProgressBar provides feedback about a process that is taking place in the application.
4803
- */
4804
4790
  export declare interface HvProgressBarProps extends HvBaseProps {
4805
4791
  /** The value of the progress bar. */
4806
4792
  value: number;
@@ -5167,13 +5153,9 @@ export declare interface HvQueryBuilderRendererProps<V = any> {
5167
5153
  export declare type HvQueryBuilderRenderers = Record<string, ValueRenderer>;
5168
5154
 
5169
5155
  /**
5170
- * A Radio Button is a mechanism that allows user to select just an option from a group of options.
5171
- *
5172
- * It should used in a Radio Button Group to present the user with a range of options from
5173
- * which the user **may select just one option** to complete their task.
5174
- *
5175
- * Individual use of radio buttons, at least uncontrolled, is unadvised as React state management doesn't
5176
- * respond to the browser's native management of radio inputs checked state.
5156
+ A Radio Button lets users select a single option from a group.
5157
+
5158
+ Use it within a Radio Button Group—individual usage is discouraged, as React may not track the `checked` state reliably outside a group.
5177
5159
  */
5178
5160
  export declare const HvRadio: ForwardRefExoticComponent<Omit<HvRadioProps, "ref"> & RefAttributes<HTMLButtonElement>>;
5179
5161
 
@@ -5547,9 +5529,7 @@ export declare interface HvScrollToVerticalProps extends HvBaseProps<HTMLOListEl
5547
5529
  }
5548
5530
 
5549
5531
  /**
5550
- * A search input component that allows the user to enter a search term.
5551
- *
5552
- * This component extends the `HvInput` component, please check its documentation for more information on the available props.
5532
+ * A Search Input allows users to enter and submit a search term.
5553
5533
  *
5554
5534
  * @extends HvInput
5555
5535
  */
@@ -5589,9 +5569,9 @@ export declare interface HvSectionProps extends Omit<HvBaseProps<HTMLDivElement>
5589
5569
  }
5590
5570
 
5591
5571
  /**
5592
- * The `HvSelect` component is a form control element that allows selection from a list of options.
5572
+ * The `HvSelect` component is a form control for choosing an option from a list.
5593
5573
  *
5594
- * It aims to be aligned with the native HTML `<select>` and `<option>` APIs and be easily integrated with forms.
5574
+ * It aligns with the native `<select>` and `<option>` APIs, making it easy to integrate into forms.
5595
5575
  *
5596
5576
  * @example
5597
5577
  * <HvSelect name="pets">
@@ -5604,10 +5584,9 @@ export declare const HvSelect: <OptionValue extends {}, Multiple extends boolean
5604
5584
  export declare type HvSelectClasses = ExtractNames<typeof useClasses_13>;
5605
5585
 
5606
5586
  /**
5607
- * Allows the user to select one or more items from a list of choices.
5587
+ * SelectionList allows users to select one or more items from a list.
5608
5588
  *
5609
- * Although it supports multi-selection, DS recommends the use of a selection list
5610
- * when it’s clear that the user can only select just one option from the range provided.
5589
+ * While it supports multi-selection, it’s recommended to use it when it’s clear that only a single option should be selected.
5611
5590
  */
5612
5591
  export declare const HvSelectionList: ForwardRefExoticComponent<HvSelectionListProps & RefAttributes<HTMLUListElement>>;
5613
5592
 
@@ -5691,6 +5670,9 @@ export declare type HvSemanticColors = Record<HvSemanticColorKeys, string>;
5691
5670
 
5692
5671
  export declare type HvSequentialColorKeys = "cat1" | "cat1_100" | "cat1_200" | "cat1_300" | "cat1_400" | "cat1_500" | "cat1_600" | "cat1_700" | "cat1_800" | "cat1_900";
5693
5672
 
5673
+ /**
5674
+ * SimpleGrid is a lightweight, responsive grid for evenly spaced items across a fixed number of columns.
5675
+ */
5694
5676
  export declare const HvSimpleGrid: (props: HvSimpleGridProps) => JSX_2.Element;
5695
5677
 
5696
5678
  export declare type HvSimpleGridClasses = ExtractNames<typeof useClasses_104>;
@@ -5736,7 +5718,7 @@ declare interface HvSingleCalendarProps extends Omit<HvCalendarProps, "classes">
5736
5718
  export { HvSize }
5737
5719
 
5738
5720
  /**
5739
- * The `HvSkeleton` component is used to create a placeholder element that represents the shape and size of the content that will be loaded.
5721
+ * The Skeleton component displays a placeholder that mimics the shape and size of loading content.
5740
5722
  */
5741
5723
  export declare const HvSkeleton: (props: HvSkeletonProps) => JSX_2.Element;
5742
5724
 
@@ -5760,7 +5742,7 @@ export declare interface HvSkeletonProps extends HvBaseProps {
5760
5742
  }
5761
5743
 
5762
5744
  /**
5763
- * Sliders reflect a range of values along a bar, from which users may select a single value. They are ideal for adjusting settings such as volume, brightness, or applying image filters.
5745
+ * Sliders let users select a value from a range along a track. They're ideal for settings like volume, brightness, or image filters.
5764
5746
  */
5765
5747
  export declare const HvSlider: ForwardRefExoticComponent<HvSliderProps & RefAttributes<SliderRef>>;
5766
5748
 
@@ -5855,12 +5837,13 @@ export declare interface HvSliderProps extends HvBaseProps<HTMLDivElement, "onCh
5855
5837
  }
5856
5838
 
5857
5839
  /**
5858
- * A Snackbar provides brief messages about app processes.
5859
- * It is dismissed automatically after a given interval.
5840
+ * A Snackbar displays brief messages about app processes and dismisses automatically after a set time.
5841
+ *
5842
+ * You can build a Snackbar using:
5843
+ *
5844
+ * - `HvSnackbar` – handles positioning, transitions, auto-hide, and more.
5845
+ * - `HvSnackbarContent` – offers fine-grained control over the content and appearance.
5860
5846
  *
5861
- * Snackbar can be built with two different components:
5862
- * - `HvSnackbar`, which wraps all the positioning, transition, auto hide, etc.
5863
- * - `HvSnackbarContent`, which allows a finer control and customization of the content of the Snackbar.
5864
5847
  */
5865
5848
  export declare const HvSnackbar: ForwardRefExoticComponent<Omit<HvSnackbarProps, "ref"> & RefAttributes<unknown>>;
5866
5849
 
@@ -5976,9 +5959,10 @@ export declare interface HvSnackbarProviderProps {
5976
5959
  export declare type HvSnackbarVariant = HvCalloutVariant;
5977
5960
 
5978
5961
  /**
5979
- * A Stack component allows the organization of its children in a vertical or horizontal layout.
5962
+ * The Stack component arranges its children in a vertical or horizontal layout.
5963
+ *
5964
+ * It supports customizable spacing and optional dividers between elements.
5980
5965
  *
5981
- * It also allows the specification of the spacing between the stack elements and the addition of a divider between the elements.
5982
5966
  */
5983
5967
  export declare const HvStack: (props: HvStackProps) => JSX_2.Element;
5984
5968
 
@@ -6530,10 +6514,9 @@ export declare interface HvTabsProps extends Omit<TabsProps, "onChange"> {
6530
6514
  }
6531
6515
 
6532
6516
  /**
6533
- * A Tag is one word that describes a specific aspect of an asset. A single asset can have
6534
- * multiple tags.
6535
- * Use tags to highlight an item's status for quick recognition and navigation
6536
- * Use color to indicate meanings that users can learn and recognize across products.
6517
+ * A Tag is a single word that highlights a specific aspect of an asset. An asset can have multiple tags.
6518
+ *
6519
+ * Use tags to indicate status, aid recognition, and support navigation—leveraging color to convey consistent meaning across products.
6537
6520
  */
6538
6521
  export declare const HvTag: ForwardRefExoticComponent<Omit<HvTagProps, "ref"> & RefAttributes<HTMLElement>>;
6539
6522
 
@@ -6907,7 +6890,9 @@ export declare type HvTimePickerValue = {
6907
6890
  };
6908
6891
 
6909
6892
  /**
6910
- * Use when two instances are opposite and the on/off analogy doesn’t apply. Only well-known icons should be used, otherwise, use a single checkbox for the same situation.
6893
+ * Use when two opposing states are represented and the on/off analogy doesn’t fit.
6894
+ *
6895
+ * Only use well-known icons—otherwise, prefer a single checkbox instead.
6911
6896
  */
6912
6897
  export declare const HvToggleButton: ForwardRefExoticComponent<HvToggleButtonProps & RefAttributes<HTMLButtonElement>>;
6913
6898
 
@@ -6927,11 +6912,10 @@ export declare interface HvToggleButtonProps extends HvBaseProps<HTMLButtonEleme
6927
6912
  }
6928
6913
 
6929
6914
  /**
6930
- * Tooltips display informative text when users hover over, focus on, or tap an element.
6931
- * Accessibility-wise, the tooltip automatically labels the `children` content.
6915
+ * Tooltips display informative text on hover, focus, or tap, and automatically label the target element for accessibility.
6916
+ *
6917
+ * For icon-only buttons, consider using `HvIconButton`, which includes built-in tooltip behavior.
6932
6918
  *
6933
- * If you are looking to wrap an icon only button with a tooltip, take a look at the `HvIconButton` component
6934
- * which offers you thus behavior out of the box.
6935
6919
  */
6936
6920
  export declare const HvTooltip: ForwardRefExoticComponent<Omit<HvTooltipProps, "ref"> & RefAttributes<unknown>>;
6937
6921
 
@@ -7041,13 +7025,8 @@ export declare interface HvTreeItemProps extends React.HTMLAttributes<HTMLElemen
7041
7025
  }
7042
7026
 
7043
7027
  /**
7044
- * A Tree View displays hierarchical structures.
7045
- * It also facilitates the exploration of categorical levels and their content.
7046
- *
7047
- * Tree structures are built through composing the `HvTreeItem` component,
7048
- * or a custom variation of it.
7049
- *
7050
- * It is based on the [MUI X TreeView](https://mui.com/x/react-tree-view) component.
7028
+ * A Tree View displays hierarchical data and helps users explore nested categories.
7029
+ * Tree structures are built using `HvTreeItem` or a custom variation of it.
7051
7030
  *
7052
7031
  * @example
7053
7032
  * ```tsx
@@ -7195,20 +7174,7 @@ export declare interface HvValidationMessages {
7195
7174
  }
7196
7175
 
7197
7176
  /**
7198
- * Navigation enables users to move through an app to complete tasks.
7199
- *
7200
- * It is recommended to use vertical navigation when your application requires global navigation that is displayed on the left.
7201
- * While vertical navigation menus generally consume more space than their horizontal counterparts, they have become more popular as desktop monitors move to wide-screen formats.
7202
- *
7203
- * Although both the hierarchically organized data and the visual style resemble a treeview-like structure, the [Treeview Design Pattern](https://w3c.github.io/aria-practices/#TreeView)
7204
- * isn't necessarily the most appropriate.
7205
- *
7206
- * The tree role provides complex functionality that is not needed for typical site navigation, and changes the most common keyboard navigation using TAB.
7207
- *
7208
- * The [Disclosure Design Pattern](https://w3c.github.io/aria-practices/#disclosure) is more suited for typical site navigation, with expandable groups of links.
7209
- * However it can be tedious to TAB through all navigation items to reach the actions panel.
7210
- *
7211
- * Both modes are available via the `mode` property and each app should choose the most appropriate.
7177
+ * Use a vertical layout for global navigation on wide screens. treeview mode provides structured hierarchy but overrides standard keyboard navigation.
7212
7178
  */
7213
7179
  export declare const HvVerticalNavigation: ForwardRefExoticComponent<HvVerticalNavigationProps & RefAttributes<HTMLDivElement>>;
7214
7180
 
@@ -7705,6 +7671,7 @@ export declare const optionGroupClasses: {
7705
7671
  };
7706
7672
 
7707
7673
  export declare const outlineStyles: {
7674
+ outline: string;
7708
7675
  boxShadow: string;
7709
7676
  };
7710
7677
 
@@ -8625,7 +8592,7 @@ declare const useClasses_117: (classesProp?: Partial<Record<"root" | "disabled"
8625
8592
  readonly cx: (...args: any) => string;
8626
8593
  };
8627
8594
 
8628
- declare const useClasses_118: (classesProp?: Partial<Record<"label" | "root" | "invalid" | "disabled" | "readOnly" | "input" | "tagInputRoot" | "tagsList" | "error" | "singleLine" | "description" | "labelContainer" | "resizable" | "suggestionsContainer" | "suggestionList" | "inputExtension" | "chipRoot" | "listItemGutters" | "listItemRoot" | "characterCounter" | "tagInputContainerRoot" | "tagSelected" | "tagInputBorderContainer" | "tagInputRootFocused" | "tagInputRootEmpty", string>>, addStatic?: boolean) => {
8595
+ declare const useClasses_118: (classesProp?: Partial<Record<"label" | "root" | "invalid" | "disabled" | "readOnly" | "input" | "tagInputRoot" | "tagsList" | "error" | "singleLine" | "inputExtension" | "description" | "labelContainer" | "resizable" | "suggestionsContainer" | "suggestionList" | "chipRoot" | "listItemGutters" | "listItemRoot" | "characterCounter" | "tagInputContainerRoot" | "tagSelected" | "tagInputBorderContainer" | "tagInputRootFocused" | "tagInputRootEmpty", string>>, addStatic?: boolean) => {
8629
8596
  readonly classes: {
8630
8597
  listItemGutters: string;
8631
8598
  listItemRoot: string;
@@ -9465,7 +9432,7 @@ declare const useClasses_46: (classesProp?: Partial<Record<"image" | "slide", st
9465
9432
  readonly cx: (...args: any) => string;
9466
9433
  };
9467
9434
 
9468
- declare const useClasses_47: (classesProp?: Partial<Record<"label" | "root" | "input" | "icon" | "error" | "inputRoot" | "adornmentsBox" | "description" | "adornmentButton" | "labelContainer" | "inputBorderContainer" | "inputRootFocused" | "inputRootDisabled" | "inputRootMultiline" | "iconClear" | "hasSuggestions" | "suggestionsContainer" | "suggestionList" | "inputExtension", string>>, addStatic?: boolean) => {
9435
+ declare const useClasses_47: (classesProp?: Partial<Record<"label" | "root" | "input" | "icon" | "error" | "inputRoot" | "inputExtension" | "adornmentsBox" | "description" | "adornmentButton" | "labelContainer" | "inputBorderContainer" | "inputRootFocused" | "inputRootDisabled" | "inputRootMultiline" | "iconClear" | "hasSuggestions" | "suggestionsContainer" | "suggestionList", string>>, addStatic?: boolean) => {
9469
9436
  readonly classes: {
9470
9437
  root: string;
9471
9438
  labelContainer: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hitachivantara/uikit-react-core",
3
- "version": "5.93.1",
3
+ "version": "5.94.0",
4
4
  "private": false,
5
5
  "author": "Hitachi Vantara UI Kit Team",
6
6
  "description": "Core React components for the NEXT Design System.",
@@ -32,9 +32,9 @@
32
32
  "dependencies": {
33
33
  "@emotion/cache": "^11.11.0",
34
34
  "@emotion/serialize": "^1.1.2",
35
- "@hitachivantara/uikit-react-shared": "^5.4.1",
36
- "@hitachivantara/uikit-react-utils": "^0.2.34",
37
- "@hitachivantara/uikit-styles": "^5.46.1",
35
+ "@hitachivantara/uikit-react-shared": "^5.4.3",
36
+ "@hitachivantara/uikit-react-utils": "^0.2.36",
37
+ "@hitachivantara/uikit-styles": "^5.47.0",
38
38
  "@internationalized/date": "^3.2.0",
39
39
  "@mui/base": "5.0.0-beta.68",
40
40
  "@popperjs/core": "^2.11.8",
@@ -61,7 +61,7 @@
61
61
  "access": "public",
62
62
  "directory": "package"
63
63
  },
64
- "gitHead": "b05a15b41bfa20c2c4e8bc248429a4a01b23784f",
64
+ "gitHead": "d260751e0d2244d0f37e5368f954d5a261a6535e",
65
65
  "exports": {
66
66
  ".": {
67
67
  "types": "./dist/types/index.d.ts",
@@ -1,6 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
- const hasChildNavigationItems = (data) => {
4
- return data.some((item) => item.data && item.data.length > 0);
5
- };
6
- exports.hasChildNavigationItems = hasChildNavigationItems;
@@ -1,6 +0,0 @@
1
- const hasChildNavigationItems = (data) => {
2
- return data.some((item) => item.data && item.data.length > 0);
3
- };
4
- export {
5
- hasChildNavigationItems
6
- };