@itwin/itwinui-react 3.0.0-dev.6 → 3.0.0-dev.8

package/cjs/core/SideNavigation/SideNavigation.js

@@ -35,6 +35,10 @@ exports.SideNavigation = React.forwardRef((props, forwardedRef) => {
     onExpanderClick,
     submenu,
     isSubmenuOpen = false,
+    wrapperProps,
+    contentProps,
+    topProps,
+    bottomProps,
     ...rest
   } = props;
   const [_isExpanded, _setIsExpanded] = React.useState(isExpanded);
@@ -44,6 +48,8 @@ exports.SideNavigation = React.forwardRef((props, forwardedRef) => {
   const ExpandButton = React.createElement(
     index_js_2.IconButton,
     {
+      label: 'Toggle icon labels',
+      'aria-expanded': _isExpanded,
       className: 'iui-sidenav-button iui-expand',
       onClick: React.useCallback(() => {
         _setIsExpanded((expanded) => !expanded);
@@ -55,28 +61,48 @@ exports.SideNavigation = React.forwardRef((props, forwardedRef) => {
   return React.createElement(
     index_js_1.Box,
     {
+      ...wrapperProps,
       className: (0, classnames_1.default)(
         'iui-side-navigation-wrapper',
-        className,
+        wrapperProps?.className,
       ),
       ref: forwardedRef,
-      ...rest,
     },
     React.createElement(
       index_js_1.Box,
       {
-        className: (0, classnames_1.default)('iui-side-navigation', {
-          'iui-expanded': _isExpanded,
-          'iui-collapsed': !_isExpanded,
-        }),
+        as: 'div',
+        className: (0, classnames_1.default)(
+          'iui-side-navigation',
+          {
+            'iui-expanded': _isExpanded,
+            'iui-collapsed': !_isExpanded,
+          },
+          className,
+        ),
+        ...rest,
       },
       expanderPlacement === 'top' && ExpandButton,
       React.createElement(
         index_js_1.Box,
-        { className: 'iui-sidenav-content' },
+        {
+          as: 'div',
+          ...contentProps,
+          className: (0, classnames_1.default)(
+            'iui-sidenav-content',
+            contentProps?.className,
+          ),
+        },
         React.createElement(
           index_js_1.Box,
-          { className: 'iui-top' },
+          {
+            as: 'div',
+            ...topProps,
+            className: (0, classnames_1.default)(
+              'iui-top',
+              topProps?.className,
+            ),
+          },
           items.map((sidenavButton, index) =>
             !_isExpanded
               ? React.createElement(
@@ -93,7 +119,14 @@ exports.SideNavigation = React.forwardRef((props, forwardedRef) => {
         ),
         React.createElement(
           index_js_1.Box,
-          { className: 'iui-bottom' },
+          {
+            as: 'div',
+            ...bottomProps,
+            className: (0, classnames_1.default)(
+              'iui-bottom',
+              bottomProps?.className,
+            ),
+          },
           secondaryItems?.map((sidenavButton, index) =>
             !_isExpanded
               ? React.createElement(

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

@@ -68,6 +68,30 @@ export type SliderProps = {
      * Additional props for container `<div>` that hold the slider rail, thumbs, and tracks.
      */
     railContainerProps?: React.HTMLAttributes<HTMLDivElement>;
+    /**
+     * Allows props to be passed for slider-min
+     */
+    minProps?: React.ComponentProps<'span'>;
+    /**
+     * 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
+     */
+    trackProps?: React.ComponentProps<'div'>;
+    /**
+     * Allows props to be passed for slider-tick
+     */
+    tickProps?: React.ComponentProps<'span'>;
+    /**
+     * Allows props to be passed for slider-ticks
+     */
+    ticksProps?: React.ComponentProps<'div'>;
     /**
      * Defines the allowed behavior when moving Thumbs when multiple Thumbs are
      * shown. It controls if a Thumb movement should be limited to only move in

package/cjs/core/Slider/Slider.js

@@ -91,6 +91,12 @@ exports.Slider = React.forwardRef((props, ref) => {
     thumbProps,
     className,
     railContainerProps,
+    minProps,
+    maxProps,
+    railProps,
+    trackProps,
+    tickProps,
+    ticksProps,
     orientation = 'horizontal',
     ...rest
   } = props;
@@ -283,18 +289,33 @@ exports.Slider = React.forwardRef((props, ref) => {
     if (Array.isArray(tickLabels)) {
       return React.createElement(
         index_js_1.Box,
-        { className: 'iui-slider-ticks' },
+        {
+          as: 'div',
+          ...ticksProps,
+          className: (0, classnames_1.default)(
+            'iui-slider-ticks',
+            ticksProps?.className,
+          ),
+        },
         tickLabels.map((label, index) =>
           React.createElement(
             index_js_1.Box,
-            { as: 'span', key: index, className: 'iui-slider-tick' },
+            {
+              as: 'span',
+              ...tickProps,
+              key: index,
+              className: (0, classnames_1.default)(
+                'iui-slider-tick',
+                tickProps?.className,
+              ),
+            },
             label,
           ),
         ),
       );
     }
     return tickLabels;
-  }, [tickLabels]);
+  }, [tickLabels, tickProps, ticksProps]);
   const generateTooltipProps = React.useCallback(
     (index, val) => {
       const outProps = tooltipProps ? tooltipProps(index, val, step) : {};
@@ -322,20 +343,39 @@ exports.Slider = React.forwardRef((props, ref) => {
     minValueLabel &&
       React.createElement(
         index_js_1.Box,
-        { as: 'span', className: 'iui-slider-min' },
+        {
+          as: 'span',
+          ...minProps,
+          className: (0, classnames_1.default)(
+            'iui-slider-min',
+            minProps?.className,
+          ),
+        },
         minValueLabel,
       ),
     React.createElement(
       index_js_1.Box,
       {
+        as: 'div',
         ref: containerRef,
-        className: (0, classnames_1.default)('iui-slider-container', {
-          'iui-grabbing': undefined !== activeThumbIndex,
-        }),
-        onPointerDown: handlePointerDownOnSlider,
         ...railContainerProps,
+        className: (0, classnames_1.default)(
+          'iui-slider-container',
+          {
+            'iui-grabbing': undefined !== activeThumbIndex,
+          },
+          railContainerProps?.className,
+        ),
+        onPointerDown: handlePointerDownOnSlider,
       },
-      React.createElement(index_js_1.Box, { className: 'iui-slider-rail' }),
+      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);
@@ -363,13 +403,21 @@ exports.Slider = React.forwardRef((props, ref) => {
         sliderMax: max,
         values: currentValues,
         orientation: orientation,
+        ...trackProps,
       }),
       tickMarkArea,
     ),
     maxValueLabel &&
       React.createElement(
         index_js_1.Box,
-        { as: 'span', className: 'iui-slider-max' },
+        {
+          as: 'span',
+          ...maxProps,
+          className: (0, classnames_1.default)(
+            'iui-slider-max',
+            maxProps?.className,
+          ),
+        },
         maxValueLabel,
       ),
   );

package/cjs/core/Slider/Thumb.js

@@ -92,6 +92,7 @@ const Thumb = (props) => {
     {
       placement: 'top',
       autoUpdateOptions: { animationFrame: true },
+      ariaStrategy: 'none',
       ...tooltipProps,
     },
     React.createElement(index_js_2.Box, {
@@ -101,8 +102,8 @@ const Thumb = (props) => {
       style: {
         ...style,
         ...(orientation === 'horizontal'
-          ? { left: `${lowPercent}%` }
-          : { bottom: `${lowPercent}%` }),
+          ? { insetInlineStart: `${lowPercent}%` }
+          : { insetBlockEnd: `${lowPercent}%` }),
       },
       className: (0, classnames_1.default)(
         'iui-slider-thumb',

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

@@ -6,7 +6,7 @@ export type TrackProps = {
     sliderMax: number;
     values: number[];
     orientation: SliderProps['orientation'];
-};
+} & React.HTMLAttributes<HTMLDivElement>;
 /**
  * Track displays color segments above Rail. Which, if any, segments that are
  * colorized is based on `trackDisplayMode`.

package/cjs/core/Slider/Track.js

@@ -7,6 +7,7 @@ const tslib_1 = require('tslib');
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 const React = tslib_1.__importStar(require('react'));
+const classnames_1 = tslib_1.__importDefault(require('classnames'));
 const index_js_1 = require('../utils/index.js');
 function shouldDisplaySegment(segmentIndex, mode) {
   if ('odd-segments' === mode && 0 === (segmentIndex + 1) % 2) {
@@ -41,7 +42,14 @@ function generateSegments(values, min, max) {
  * colorized is based on `trackDisplayMode`.
  */
 const Track = (props) => {
-  const { trackDisplayMode, sliderMin, sliderMax, values, orientation } = props;
+  const {
+    className,
+    trackDisplayMode,
+    sliderMin,
+    sliderMax,
+    values,
+    orientation,
+  } = props;
   const [segments, setSegments] = React.useState(() =>
     generateSegments(values, sliderMin, sliderMax),
   );
@@ -67,16 +75,19 @@ const Track = (props) => {
           { key: index },
           shouldDisplaySegment(index, trackDisplayMode)
             ? React.createElement(index_js_1.Box, {
-                className: 'iui-slider-track',
+                className: (0, classnames_1.default)(
+                  'iui-slider-track',
+                  className,
+                ),
                 style: {
                   ...(orientation === 'horizontal'
                     ? {
-                        left: `${lowPercent}%`,
-                        right: `${highPercent}%`,
+                        insetInlineStart: `${lowPercent}%`,
+                        insetInlineEnd: `${highPercent}%`,
                       }
                     : {
-                        top: `${highPercent}%`,
-                        bottom: `${lowPercent}%`,
+                        insetBlockStart: `${highPercent}%`,
+                        insetBlockEnd: `${lowPercent}%`,
                       }),
                 },
               })

package/cjs/core/StatusMessage/StatusMessage.d.ts

@@ -1,4 +1,6 @@
 import * as React from 'react';
+import { Icon } from '../utils/index.js';
+import type { PolymorphicForwardRefComponent } from '../utils/index.js';
 type StatusMessageProps = {
     /**
      * Custom icon to be displayed at the beginning.
@@ -13,12 +15,20 @@ type StatusMessageProps = {
      * Status of the message.
      */
     status?: 'positive' | 'warning' | 'negative';
+    /**
+     * Passes props to icon
+     */
+    iconProps?: React.ComponentProps<typeof Icon>;
+    /**
+     * Passes props to content
+     */
+    contentProps?: React.ComponentPropsWithRef<'div'>;
 };
 /**
- * Component to display icon and text below the `Combobox` component.
+ * Component to display icon and text below the form field.
  * @example
  * <StatusMessage>This is the text</StatusMessage>
  * <StatusMessage startIcon={<SvgStar />}>This is the text</StatusMessage>
  */
-export declare const StatusMessage: ({ startIcon: userStartIcon, children, status, }: StatusMessageProps) => React.JSX.Element;
+export declare const StatusMessage: PolymorphicForwardRefComponent<"div", StatusMessageProps>;
 export default StatusMessage;

package/cjs/core/StatusMessage/StatusMessage.js

@@ -8,26 +8,40 @@ const tslib_1 = require('tslib');
  *--------------------------------------------------------------------------------------------*/
 const React = tslib_1.__importStar(require('react'));
 const index_js_1 = require('../utils/index.js');
+const classnames_1 = tslib_1.__importDefault(require('classnames'));
 /**
- * Component to display icon and text below the `Combobox` component.
+ * Component to display icon and text below the form field.
  * @example
  * <StatusMessage>This is the text</StatusMessage>
  * <StatusMessage startIcon={<SvgStar />}>This is the text</StatusMessage>
  */
-const StatusMessage = ({ startIcon: userStartIcon, children, status }) => {
+exports.StatusMessage = React.forwardRef((props, ref) => {
+  const {
+    children,
+    startIcon: userStartIcon,
+    status,
+    className,
+    iconProps,
+    contentProps,
+    ...rest
+  } = props;
   const icon = userStartIcon ?? (status && index_js_1.StatusIconMap[status]());
   return React.createElement(
-    React.Fragment,
-    null,
+    index_js_1.Box,
+    {
+      className: (0, classnames_1.default)('iui-status-message', className),
+      'data-iui-status': status,
+      ref: ref,
+      ...rest,
+    },
     !!icon
       ? React.createElement(
-          index_js_1.Box,
-          { as: 'span', className: 'iui-input-icon', 'aria-hidden': true },
+          index_js_1.Icon,
+          { 'aria-hidden': true, ...iconProps },
           icon,
         )
       : null,
-    React.createElement(index_js_1.Box, { className: 'iui-message' }, children),
+    React.createElement(index_js_1.Box, { ...contentProps }, children),
   );
-};
-exports.StatusMessage = StatusMessage;
+});
 exports.default = exports.StatusMessage;

package/cjs/core/Stepper/Stepper.d.ts

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { PolymorphicForwardRefComponent } from '../utils/index.js';
 export type StepperLocalization = {
     stepsCountLabel: (currentStep: number, totalSteps: number) => string;
@@ -11,7 +12,7 @@ export type StepProperties = {
      * A tooltip giving detailed description to this step.
      */
     description?: string;
-};
+} & React.ComponentProps<'li'>;
 export type StepperProps = {
     /**
      * Current step index, 0 - based.
@@ -34,6 +35,30 @@ export type StepperProps = {
      *  Click handler on completed step.
      */
     onStepClick?: (clickedIndex: number) => void;
+    /**
+     * Callback that can provide additional props for `<li>` representing a step.
+     */
+    stepProps?: (index: number) => React.ComponentProps<'li'>;
+    /**
+     * Allows props to be passed for track content.
+     */
+    trackContentProps?: (index: number) => React.ComponentProps<'div'>;
+    /**
+     * Allows props to be passed for circle.
+     */
+    circleProps?: (index: number) => React.ComponentProps<'span'>;
+    /**
+     * Allows props to be passed for name.
+     */
+    nameProps?: (index: number) => React.ComponentProps<'span'>;
+    /**
+     * Allows props to be passed for label.
+     */
+    labelProps?: React.ComponentProps<'div'>;
+    /**
+     * Allows props to be passed for label count.
+     */
+    labelCountProps?: React.ComponentProps<'span'>;
 };
 export declare const Stepper: PolymorphicForwardRefComponent<"div", StepperProps>;
 export default Stepper;

package/cjs/core/Stepper/Stepper.js

@@ -6,6 +6,7 @@ const tslib_1 = require('tslib');
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
+const classnames_1 = tslib_1.__importDefault(require('classnames'));
 const React = tslib_1.__importStar(require('react'));
 const index_js_1 = require('../utils/index.js');
 const StepperStep_js_1 = require('./StepperStep.js');
@@ -20,6 +21,12 @@ exports.Stepper = React.forwardRef((props, ref) => {
     type = 'default',
     localization = defaultStepperLocalization,
     onStepClick,
+    stepProps,
+    trackContentProps,
+    circleProps,
+    nameProps,
+    labelProps,
+    labelCountProps,
     ...rest
   } = props;
   const boundedCurrentStep = Math.min(
@@ -32,8 +39,16 @@ exports.Stepper = React.forwardRef((props, ref) => {
     React.createElement(
       'ol',
       null,
-      steps.map((s, index) =>
-        React.createElement(StepperStep_js_1.StepperStep, {
+      steps.map((s, index) => {
+        const thisStepProps = stepProps?.(index);
+        const thisTrackContentProps = trackContentProps?.(index);
+        const thisCircleProps = circleProps?.(index);
+        const thisNameProps = nameProps?.(index);
+        return React.createElement(StepperStep_js_1.StepperStep, {
+          stepProps: thisStepProps,
+          trackContentProps: thisTrackContentProps,
+          circleProps: thisCircleProps,
+          nameProps: thisNameProps,
           key: index,
           index: index,
           title: type === 'long' ? '' : s.name,
@@ -42,16 +57,30 @@ exports.Stepper = React.forwardRef((props, ref) => {
           type: type,
           onClick: onStepClick,
           description: s.description,
-        }),
-      ),
+        });
+      }),
     ),
     type === 'long' &&
       React.createElement(
         index_js_1.Box,
-        { className: 'iui-stepper-steps-label' },
+        {
+          as: 'div',
+          ...labelProps,
+          className: (0, classnames_1.default)(
+            'iui-stepper-steps-label',
+            labelProps?.className,
+          ),
+        },
         React.createElement(
           index_js_1.Box,
-          { as: 'span', className: 'iui-stepper-steps-label-count' },
+          {
+            as: 'span',
+            ...labelCountProps,
+            className: (0, classnames_1.default)(
+              'iui-stepper-steps-label-count',
+              labelCountProps?.className,
+            ),
+          },
           localization.stepsCountLabel(boundedCurrentStep + 1, steps.length),
         ),
         steps[boundedCurrentStep].name,

package/cjs/core/Stepper/StepperStep.d.ts

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { PolymorphicForwardRefComponent } from '../utils/index.js';
 export type StepperStepProps = {
     /**
@@ -28,5 +29,21 @@ export type StepperStepProps = {
      * A tooltip giving detailed description to this step.
      */
     description?: string;
+    /**
+     * Allows props to be passed for stepper step.
+     */
+    stepProps?: React.ComponentProps<'li'>;
+    /**
+     * Allows props to be passed for track content.
+     */
+    trackContentProps?: React.ComponentProps<'div'>;
+    /**
+     * Allows props to be passed for stepper-step circle.
+     */
+    circleProps?: React.ComponentProps<'span'>;
+    /**
+     * Allows props to be passed for stepper name.
+     */
+    nameProps?: React.ComponentProps<'span'>;
 };
 export declare const StepperStep: PolymorphicForwardRefComponent<"li", StepperStepProps>;

package/cjs/core/Stepper/StepperStep.js

@@ -21,6 +21,10 @@ exports.StepperStep = React.forwardRef((props, forwardedRef) => {
     description,
     className,
     style,
+    stepProps,
+    trackContentProps,
+    circleProps,
+    nameProps,
     ...rest
   } = props;
   const isPast = currentStepNumber > index;
@@ -46,17 +50,17 @@ exports.StepperStep = React.forwardRef((props, forwardedRef) => {
     index_js_2.Box,
     {
       as: 'li',
+      ...stepProps,
       className: (0, classnames_1.default)(
         'iui-stepper-step',
-        {
-          'iui-current': isActive,
-          'iui-clickable': isClickable,
-        },
+        { 'iui-current': isActive, 'iui-clickable': isClickable },
         className,
+        stepProps?.className,
       ),
       style: {
-        width: type === 'default' ? `${100 / totalSteps}%` : undefined,
+        inlineSize: type === 'default' ? `${100 / totalSteps}%` : undefined,
         ...style,
+        ...stepProps?.style,
       },
       onClick: onCompletedClick,
       onKeyDown: onKeyDown,
@@ -67,17 +71,38 @@ exports.StepperStep = React.forwardRef((props, forwardedRef) => {
     },
     React.createElement(
       index_js_2.Box,
-      { className: 'iui-stepper-track-content' },
+      {
+        as: 'div',
+        ...trackContentProps,
+        className: (0, classnames_1.default)(
+          'iui-stepper-track-content',
+          trackContentProps?.className,
+        ),
+      },
       React.createElement(
         index_js_2.Box,
-        { as: 'span', className: 'iui-stepper-circle' },
+        {
+          as: 'span',
+          ...circleProps,
+          className: (0, classnames_1.default)(
+            'iui-stepper-circle',
+            circleProps?.className,
+          ),
+        },
         index + 1,
       ),
     ),
     type === 'default' &&
       React.createElement(
         index_js_2.Box,
-        { as: 'span', className: 'iui-stepper-step-name' },
+        {
+          as: 'span',
+          ...nameProps,
+          className: (0, classnames_1.default)(
+            'iui-stepper-step-name',
+            nameProps?.className,
+          ),
+        },
         title,
       ),
   );

package/cjs/core/Stepper/WorkflowDiagram.d.ts

@@ -1,5 +1,15 @@
+import * as React from 'react';
 import type { PolymorphicForwardRefComponent } from '../utils/index.js';
 import type { StepperProps } from './Stepper.js';
-type WorkflowDiagramProps = Pick<StepperProps, 'steps'>;
+type WorkflowDiagramProps = Pick<StepperProps, 'steps'> & {
+    /**
+     *  Allows props to be passed for diagram.
+     */
+    contentProps?: (index: number) => React.ComponentProps<'span'>;
+    /**
+     *  Allows props to be passed for diagram wrapper.
+     */
+    wrapperProps?: React.ComponentProps<'div'>;
+};
 export declare const WorkflowDiagram: PolymorphicForwardRefComponent<"ol", WorkflowDiagramProps>;
 export default WorkflowDiagram;