@itwin/itwinui-react 3.0.0-dev.12 → 3.0.0-dev.14

package/cjs/core/ColorPicker/ColorSwatch.js

@@ -10,6 +10,7 @@ const React = tslib_1.__importStar(require('react'));
 const classnames_1 = tslib_1.__importDefault(require('classnames'));
 const index_js_1 = require('../utils/index.js');
 const ColorPicker_js_1 = require('./ColorPicker.js');
+const VisuallyHidden_js_1 = require('../VisuallyHidden/VisuallyHidden.js');
 /**
  * ColorSwatch component to display within a color palette.
  * @example
@@ -25,21 +26,30 @@ exports.ColorSwatch = React.forwardRef((props, ref) => {
         : (0, ColorPicker_js_1.getColorValue)(color).toHslString(true),
     [color],
   );
-  return React.createElement(index_js_1.Box, {
-    className: (0, classnames_1.default)(
-      'iui-color-swatch',
-      { 'iui-active': isActive },
-      className,
-    ),
-    style: {
-      '--iui-color-swatch-background': colorString,
-      ...style,
+  return React.createElement(
+    index_js_1.Box,
+    {
+      as: !!onClick ? index_js_1.ButtonBase : 'span',
+      className: (0, classnames_1.default)(
+        'iui-color-swatch',
+        { 'iui-active': isActive },
+        className,
+      ),
+      style: {
+        '--iui-color-swatch-background': colorString,
+        ...style,
+      },
+      onClick: onClick,
+      'aria-pressed': !!onClick && isActive ? 'true' : undefined,
+      ref: ref,
+      ...rest,
     },
-    onClick: onClick,
-    tabIndex: isActive ? 0 : -1,
-    'aria-selected': isActive,
-    ref: ref,
-    ...rest,
-  });
+    props.children ??
+      React.createElement(
+        VisuallyHidden_js_1.VisuallyHidden,
+        null,
+        colorString.toUpperCase(),
+      ),
+  );
 });
 exports.default = exports.ColorSwatch;

package/cjs/core/LabeledSelect/LabeledSelect.d.ts

@@ -76,5 +76,5 @@ export type LabeledSelectProps<T> = {
  *   svgIcon={<SvgCamera />}
  * />
  */
-export declare const LabeledSelect: <T>(props: LabeledSelectProps<T>) => JSX.Element;
+export declare const LabeledSelect: React.ForwardRefExoticComponent<LabeledSelectProps<unknown> & React.RefAttributes<HTMLElement>>;
 export default LabeledSelect;

package/cjs/core/LabeledSelect/LabeledSelect.js

@@ -46,7 +46,7 @@ const Icon_js_1 = require('../Icon/Icon.js');
  *   svgIcon={<SvgCamera />}
  * />
  */
-const LabeledSelect = (props) => {
+exports.LabeledSelect = React.forwardRef((props, forwardedRef) => {
   const {
     className,
     disabled = false,
@@ -95,6 +95,7 @@ const LabeledSelect = (props) => {
       style: style,
       status: status,
       ...rest,
+      ref: forwardedRef,
       triggerProps: {
         'aria-labelledby': labelId,
         ...triggerProps,
@@ -113,6 +114,5 @@ const LabeledSelect = (props) => {
         )
       : message,
   );
-};
-exports.LabeledSelect = LabeledSelect;
+});
 exports.default = exports.LabeledSelect;

package/cjs/core/Select/Select.d.ts

@@ -168,5 +168,5 @@ export type SelectProps<T> = {
  *   )}
  * />
  */
-export declare const Select: <T>(props: SelectProps<T>) => JSX.Element;
+export declare const Select: React.ForwardRefExoticComponent<SelectProps<unknown> & React.RefAttributes<HTMLElement>>;
 export default Select;

package/cjs/core/Select/Select.js

@@ -71,7 +71,7 @@ const isSingleOnChange = (onChange, multiple) => {
  *   )}
  * />
  */
-const Select = (props) => {
+exports.Select = React.forwardRef((props, forwardedRef) => {
   const uid = (0, index_js_1.useId)();
   const {
     options,
@@ -192,7 +192,10 @@ const Select = (props) => {
         className: (0, classnames_1.default)('iui-input-with-icon', className),
         style: style,
         ...rest,
-        ref: popover.refs.setPositionReference,
+        ref: (0, index_js_1.useMergedRefs)(
+          popover.refs.setPositionReference,
+          forwardedRef,
+        ),
       },
       React.createElement(
         index_js_1.Box,
@@ -282,8 +285,7 @@ const Select = (props) => {
         ),
       ),
   );
-};
-exports.Select = Select;
+});
 const SingleSelectButton = ({ selectedItem, selectedItemRenderer }) => {
   const startIcon = selectedItem?.startIcon ?? selectedItem?.icon;
   return React.createElement(

package/cjs/core/Slider/Slider.d.ts

@@ -65,9 +65,9 @@ export type SliderProps = {
      */
     maxLabel?: React.ReactNode;
     /**
-     * Additional props for container `<div>` that hold the slider rail, thumbs, and tracks.
+     * Additional props for container `<div>` that hold the slider thumbs, and tracks.
      */
-    railContainerProps?: React.HTMLAttributes<HTMLDivElement>;
+    trackContainerProps?: React.HTMLAttributes<HTMLDivElement>;
     /**
      * Allows props to be passed for slider-min
      */
@@ -76,10 +76,6 @@ export type SliderProps = {
      * Allows props to be passed for slider-max
      */
     maxProps?: React.ComponentProps<'span'>;
-    /**
-     * Allows props to be passed for slider-rail
-     */
-    railProps?: React.ComponentProps<'div'>;
     /**
      * Allows props to be passed for slider-track
      */

package/cjs/core/Slider/Slider.js

@@ -90,10 +90,9 @@ exports.Slider = React.forwardRef((props, ref) => {
     onUpdate,
     thumbProps,
     className,
-    railContainerProps,
+    trackContainerProps,
     minProps,
     maxProps,
-    railProps,
     trackProps,
     tickProps,
     ticksProps,
@@ -332,12 +331,9 @@ exports.Slider = React.forwardRef((props, ref) => {
     index_js_1.Box,
     {
       ref: ref,
-      className: (0, classnames_1.default)(
-        'iui-slider-component-container',
-        `iui-slider-${orientation}`,
-        { 'iui-disabled': disabled },
-        className,
-      ),
+      className: (0, classnames_1.default)('iui-slider-container', className),
+      'data-iui-orientation': orientation,
+      'data-iui-disabled': disabled ? 'true' : undefined,
       ...rest,
     },
     minValueLabel &&
@@ -356,26 +352,17 @@ exports.Slider = React.forwardRef((props, ref) => {
     React.createElement(
       index_js_1.Box,
       {
-        as: 'div',
         ref: containerRef,
-        ...railContainerProps,
+        ...trackContainerProps,
         className: (0, classnames_1.default)(
-          'iui-slider-container',
+          'iui-slider',
           {
             'iui-grabbing': undefined !== activeThumbIndex,
           },
-          railContainerProps?.className,
+          trackContainerProps?.className,
         ),
         onPointerDown: handlePointerDownOnSlider,
       },
-      React.createElement(index_js_1.Box, {
-        as: 'div',
-        ...railProps,
-        className: (0, classnames_1.default)(
-          'iui-slider-rail',
-          railProps?.className,
-        ),
-      }),
       currentValues.map((thumbValue, index) => {
         const [minVal, maxVal] = getAllowableThumbRange(index);
         const thisThumbProps = thumbProps?.(index);
@@ -394,7 +381,6 @@ exports.Slider = React.forwardRef((props, ref) => {
           step: step,
           sliderMin: min,
           sliderMax: max,
-          orientation: orientation,
         });
       }),
       React.createElement(Track_js_1.Track, {
@@ -405,8 +391,8 @@ exports.Slider = React.forwardRef((props, ref) => {
         orientation: orientation,
         ...trackProps,
       }),
-      tickMarkArea,
     ),
+    tickMarkArea,
     maxValueLabel &&
       React.createElement(
         index_js_1.Box,

package/cjs/core/Slider/Thumb.d.ts

@@ -1,6 +1,5 @@
 import * as React from 'react';
 import { Tooltip } from '../Tooltip/Tooltip.js';
-import type { SliderProps } from './Slider.js';
 type ThumbProps = {
     /**
      * Thumb value.
@@ -54,7 +53,7 @@ type ThumbProps = {
      * Additional props for Thumb.
      */
     thumbProps?: React.HTMLAttributes<HTMLDivElement>;
-} & Pick<SliderProps, 'orientation'>;
+};
 /**
  * Thumb is a local component used to show and modify the values maintained by the Slider.
  * Only one Thumb can be active at a time. A Thumb is made active when the user selects

package/cjs/core/Slider/Thumb.js

@@ -30,7 +30,6 @@ const Thumb = (props) => {
     tooltipProps,
     thumbProps,
     disabled,
-    orientation,
   } = props;
   const thumbRef = React.useRef(null);
   const handleOnKeyboardEvent = React.useCallback(
@@ -97,13 +96,10 @@ const Thumb = (props) => {
     },
     React.createElement(index_js_1.Box, {
       ...rest,
-      'data-index': index,
       ref: thumbRef,
       style: {
         ...style,
-        ...(orientation === 'horizontal'
-          ? { insetInlineStart: `${lowPercent}%` }
-          : { insetBlockEnd: `${lowPercent}%` }),
+        '--iui-slider-thumb-position': `${lowPercent}%`,
       },
       className: (0, classnames_1.default)(
         'iui-slider-thumb',

package/cjs/core/Tabs/Tabs.d.ts

@@ -1,28 +1,5 @@
 import * as React from 'react';
-export type OverflowOptions = {
-    /**
-     * Whether to allow tabs list to scroll when there is overflow,
-     * i.e. when there is not enough space to fit all the tabs.
-     *
-     * Not applicable to types `pill` and `borderless`.
-     */
-    useOverflow?: boolean;
-};
-type TabsOverflowProps = {
-    /**
-     * Options that can be specified to deal with tabs overflowing the allotted space.
-     */
-    overflowOptions?: OverflowOptions;
-    /**
-     * Type of the tabs.
-     *
-     * If `orientation = 'vertical'`, `pill` is not applicable.
-     * @default 'default'
-     */
-    type?: 'default';
-} | {
-    type: 'pill' | 'borderless';
-};
+import type { PolymorphicForwardRefComponent } from '../utils/index.js';
 type TabsOrientationProps = {
     /**
      * Orientation of the tabs.
@@ -40,24 +17,85 @@ type TabsOrientationProps = {
     orientation: 'vertical';
     type?: 'default' | 'borderless';
 };
-type TabsTypeProps = {
+type TabsWrapperOwnProps = {
     /**
-     * Type of the tabs.
+     * Color of the bar on the active tab.
+     * @default 'blue'
+     */
+    color?: 'blue' | 'green';
+    /**
+     * Control whether focusing tabs (using arrow keys) should automatically select them.
+     * Use 'manual' if tab panel content is not preloaded.
+     * @default 'auto'
+     */
+    focusActivationMode?: 'auto' | 'manual';
+    /**
+     * Value of the tab that should be active on initial render.
      *
-     * If `orientation = 'vertical'`, `pill` is not applicable.
-     * @default 'default'
+     * Should be used for uncontrolled state (when no `value` passed).
+     *
+     * If not specified, then first tab will be active by default.
      */
-    type?: 'default' | 'borderless';
+    defaultValue?: string;
+    /**
+     * Value of the active tab for controlled state.
+     */
+    value?: string;
+    /**
+     * Function that gets called when active tab is changed.
+     *
+     * Should be used alongside `value` prop.
+     */
+    onValueChange?: (value: string) => void;
+    /**
+     * @deprecated Do not use.
+     */
+    defaultChecked?: never;
+} & TabsOrientationProps;
+type TabListOwnProps = {
+    /**
+     * Tab items.
+     */
+    children: React.ReactNode[];
+};
+type TabOwnProps = {
+    /**
+     * Value used to associate the tab with a given panel.
+     */
+    value: string;
+    /**
+     * Tab label used for simple Tab construction.
+     * Cannot be used with tabs that have icons or descriptions.
+     */
+    label?: string | React.ReactNode;
+    /**
+     * @deprecated Don't pass `id`, as it will be automatically set.
+     */
+    id?: string;
+};
+type TabsActionsOwnProps = {
+    /**
+     * Passes props to the wrapper component for the actions
+     */
+    wrapperProps?: React.ComponentPropsWithRef<'div'>;
+};
+type TabsPanelOwnProps = {
+    /**
+     * Value used to associate the panel with a given tab.
+     */
+    value: string;
+    /**
+     * @deprecated Don't pass `id`, as it will be automatically set.
+     */
+    id?: string;
+};
+type TabsLegacyProps = {
     /**
      * Content displayed to the right/bottom of the horizontal/vertical tabs
      *
      * If `type = 'pill'`, `actions` is not applicable.
      */
     actions?: React.ReactNode[];
-} | {
-    type: 'pill';
-};
-export type TabsProps = {
     /**
      * Elements shown for each tab.
      * Recommended to pass an array of `Tab` components.
@@ -98,33 +136,165 @@ export type TabsProps = {
      * Content inside the tab panel.
      */
     children?: React.ReactNode;
-} & TabsOrientationProps & TabsTypeProps & TabsOverflowProps;
+    /**
+     * @deprecated Tabs will now overflow by default, so this prop does nothing.
+     */
+    overflowOptions?: {
+        /**
+         * @deprecated Tabs will now overflow by default, so this prop does nothing.
+         */
+        useOverflow?: boolean;
+    };
+    defaultValue?: never;
+    defaultChecked?: never;
+} & TabsOrientationProps;
+type TabLegacyProps = {
+    /**
+     * The main label shown in the tab.
+     */
+    label?: React.ReactNode;
+    /**
+     * Secondary label shown below the main label.
+     */
+    sublabel?: React.ReactNode;
+    /**
+     * Svg icon shown before the labels.
+     */
+    startIcon?: JSX.Element;
+    /**
+     * Control whether the tab is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * Custom content appended to the tab.
+     */
+    children?: React.ReactNode;
+    /**
+     * `value` of the tab.
+     *
+     * Will be set by parent `Tabs` component.
+     */
+    value?: string;
+};
 /**
- * Tabs organize and allow navigation between groups of content that are related and at the same level of hierarchy.
+ * Legacy Tab component.
+ * For full functionality use composition API.
+ *
+ * Individual tab component to be used in the `labels` prop of `Tabs`.
  * @example
  * const tabs = [
- *   <Tab label='Label 1' />,
- *   <Tab label='Label 2' />,
- *   <Tab label='Label 3' />,
+ *   <Tab label='Label 1' sublabel='Description 1' />,
+ *   <Tab label='Label 2' startIcon={<SvgPlaceholder />} />,
  * ];
- * <Tabs labels={tabs} />
- *
+ */
+declare const LegacyTab: PolymorphicForwardRefComponent<"button", TabLegacyProps>;
+export { LegacyTab as Tab };
+/**
+ * Tabs organize and allow navigation between groups of content that are related and at the same level of hierarchy.
+ * `Tabs.Tab` and `Tabs.Panel` can be associated with each other by passing them the same `value`.
  * @example
- * <Tabs orientation='vertical' labels={tabs} />
+ * <Tabs.Wrapper>
+ *   <Tabs.TabList>
+ *     <Tabs.Tab value='tab1' label='Label 1' />
+ *     <Tabs.Tab value='tab2' label='Label 2' />
+ *     <Tabs.Tab value='tab3' label='Label 3' />
+ *   </Tabs.TabList>
+ *   <Tabs.ActionsWrapper>
+ *     <Tabs.Actions>
+ *       <Button>Sample Button</Button>
+ *     </Tabs.Actions>
+ *   </Tabs.ActionsWrapper>
+ *   <Tabs.Panel value='tab1'>Content 1</Tabs.Panel>
+ *   <Tabs.Panel value='tab2'>Content 2</Tabs.Panel>
+ *   <Tabs.Panel value='tab3'>Content 3</Tabs.Panel>
+ * </Tabs.Wrapper>
  *
  * @example
- * const tabsWithSublabels = [
- *   <Tab label='Label 1' sublabel='First tab' />,
- *   <Tab label='Label 2' sublabel='Active tab' />,
- * ];
- * <Tabs labels={tabsWithSublabels} activeIndex={1} />
+ * <Tabs orientation='vertical'/>
  *
  * @example
- * const tabsWithIcons = [
- *   <Tab label='Label 1' icon={<SvgPlaceholder />} />,
- *   <Tab label='Label 2' icon={<SvgPlaceholder />} />,
- * ];
- * <Tabs labels={tabsWithIcons} type='pill' />
+ * <Tabs.Wrapper focusActivationMode='manual'>
+ *  <Tabs.Tab value='sample'>
+ *   <Tabs.TabIcon>
+ *     <SvgPlaceholder />
+ *   </Tabs.TabIcon>
+ *   <Tabs.TabLabel>Sample Label</Tabs.TabLabel>
+ *   <Tabs.TabDescription>Sample Description</Tabs.TabDescription>
+ *  </Tabs.Tab>
+ * </Tabs.Wrapper>
  */
-export declare const Tabs: (props: TabsProps) => React.JSX.Element;
+export declare const Tabs: PolymorphicForwardRefComponent<"div", TabsLegacyProps> & {
+    /**
+     * A wrapper component for Tabs
+     */
+    Wrapper: PolymorphicForwardRefComponent<"div", TabsWrapperOwnProps>;
+    /**
+     * Tablist subcomponent which contains all of the tab subcomponents.
+     * @example
+     * <Tabs.TabList>
+     *   <Tabs.Tab value='tab1' label='Label 1' />
+     *   <Tabs.Tab value='tab2' label='Label 2' />
+     *   <Tabs.Tab value='tab3' label='Label 3' />
+     * </Tabs.TabList>
+     *
+     * @example
+     * <Tabs.TabList>
+     *   <Tabs.Tab value='tab1' label='Green Tab' />
+     * </Tabs.TabList>
+     *
+     * @example
+     * <Tabs.TabList focusActivationMode='manual'>
+     *   <Tabs.Tab value='tab1' label='Manual Focus Tab' />
+     * </Tabs.TabList>
+     */
+    TabList: PolymorphicForwardRefComponent<"div", TabListOwnProps>;
+    /**
+     * Tab subcomponent which is used for each of the tabs.
+     * @example
+     * <Tabs.Tab value='tab1' label='Label 1' />
+     *
+     * @example
+     * <Tabs.Tab value='sample'>
+     *   <Tabs.TabIcon>
+     *     <SvgPlaceholder />
+     *   </Tabs.TabIcon>
+     *   <Tabs.TabLabel>Sample Label</Tabs.TabLabel>
+     *   <Tabs.TabDescription>Sample Description</Tabs.TabDescription>
+     * </Tabs.Tab>
+     *
+     */
+    Tab: PolymorphicForwardRefComponent<"button", TabOwnProps>;
+    /**
+     * Tab icon subcomponent which places an icon on the left side of the tab.
+     */
+    TabIcon: PolymorphicForwardRefComponent<"span", Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & {
+        ref?: ((instance: HTMLSpanElement | null) => void) | React.RefObject<HTMLSpanElement> | null | undefined;
+    }, "fill" | "as" | "key" | "size" | keyof React.HTMLAttributes<HTMLSpanElement> | "padded"> & {
+        size?: "small" | "auto" | "medium" | "large" | import("../utils/types.js").AnyString | undefined;
+        fill?: "default" | "informational" | "negative" | "positive" | "warning" | import("../utils/types.js").AnyString | undefined;
+        padded?: boolean | undefined;
+    } & Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & {
+        as?: "span" | undefined;
+    }>;
+    /**
+     * Tab label subcomponent which holds the tab's label.
+     */
+    TabLabel: PolymorphicForwardRefComponent<"span", {}>;
+    /**
+     * Tab description subcomponent which places a description under the tab label.
+     */
+    TabDescription: PolymorphicForwardRefComponent<"span", {}>;
+    /**
+     * Tab actions subcomponent which contains action buttons that are placed at the end of the tabs.
+     */
+    Actions: PolymorphicForwardRefComponent<"div", TabsActionsOwnProps>;
+    /**
+     * Tab panel subcomponent which contains the tab's content.
+     * @example
+     * <Tabs.Panel value='tab1'>
+     *   Sample Panel
+     * </Tabs.Panel>
+     */
+    Panel: PolymorphicForwardRefComponent<"div", TabsPanelOwnProps>;
+};
 export default Tabs;