@itwin/itwinui-react 3.0.0-dev.1 → 3.0.0-dev.11

package/esm/core/Slider/Thumb.js

@@ -4,7 +4,7 @@
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
 import cx from 'classnames';
-import { Tooltip } from '../Tooltip/index.js';
+import { Tooltip } from '../Tooltip/Tooltip.js';
 import { Box } from '../utils/index.js';
 /**
  * Thumb is a local component used to show and modify the values maintained by the Slider.
@@ -12,56 +12,105 @@ import { Box } from '../utils/index.js';
  * it with pointer. Whenever a Thumb is active, focused, or hovered its tooltip is shown.
  */
 export const Thumb = (props) => {
-    const { value, index, minVal, maxVal, step, sliderMin, sliderMax, isActive, onThumbActivated, onThumbValueChanged, tooltipProps, thumbProps, disabled, orientation, } = props;
-    const thumbRef = React.useRef(null);
-    const handleOnKeyboardEvent = React.useCallback((event, keyboardReleased) => {
-        if (disabled || event.altKey) {
-            return;
-        }
-        switch (event.key) {
-            case 'ArrowLeft':
-            case 'ArrowDown':
-                onThumbValueChanged(index, Math.max(value - step, minVal), keyboardReleased);
-                break;
-            case 'ArrowRight':
-            case 'ArrowUp':
-                onThumbValueChanged(index, Math.min(value + step, maxVal), keyboardReleased);
-                break;
-            case 'Home':
-                onThumbValueChanged(index, minVal, keyboardReleased);
-                break;
-            case 'End':
-                onThumbValueChanged(index, maxVal, keyboardReleased);
-                break;
-            default:
-                return;
-        }
-        event.preventDefault();
-    }, [disabled, onThumbValueChanged, index, value, step, minVal, maxVal]);
-    const handlePointerDownOnThumb = React.useCallback(() => {
-        !disabled && onThumbActivated(index);
-    }, [disabled, index, onThumbActivated]);
-    const adjustedValue = React.useMemo(() => {
-        if (value < sliderMin) {
-            return sliderMin;
-        }
-        if (value > sliderMax) {
-            return sliderMax;
-        }
-        return value;
-    }, [sliderMax, sliderMin, value]);
-    const lowPercent = React.useMemo(() => {
-        if (sliderMax === sliderMin) {
-            return 0;
-        }
-        return (100.0 * (adjustedValue - sliderMin)) / (sliderMax - sliderMin);
-    }, [adjustedValue, sliderMax, sliderMin]);
-    const { style, className, ...rest } = thumbProps || {};
-    return (React.createElement(Tooltip, { placement: 'top', trigger: (tooltipProps === null || tooltipProps === void 0 ? void 0 : tooltipProps.visible) == null ? 'mouseenter click focus' : undefined, ...tooltipProps },
-        React.createElement(Box, { ...rest, "data-index": index, ref: thumbRef, style: {
-                ...style,
-                ...(orientation === 'horizontal'
-                    ? { left: `${lowPercent}%` }
-                    : { bottom: `${lowPercent}%` }),
-            }, className: cx('iui-slider-thumb', { 'iui-active': isActive }, className), role: 'slider', tabIndex: disabled ? undefined : 0, "aria-valuemin": minVal, "aria-valuenow": value, "aria-valuemax": maxVal, "aria-disabled": disabled, onPointerDown: handlePointerDownOnThumb, onKeyDown: (event) => handleOnKeyboardEvent(event, false), onKeyUp: (event) => handleOnKeyboardEvent(event, true) })));
+  const {
+    value,
+    index,
+    minVal,
+    maxVal,
+    step,
+    sliderMin,
+    sliderMax,
+    isActive,
+    onThumbActivated,
+    onThumbValueChanged,
+    tooltipProps,
+    thumbProps,
+    disabled,
+    orientation,
+  } = props;
+  const thumbRef = React.useRef(null);
+  const handleOnKeyboardEvent = React.useCallback(
+    (event, keyboardReleased) => {
+      if (disabled || event.altKey) {
+        return;
+      }
+      switch (event.key) {
+        case 'ArrowLeft':
+        case 'ArrowDown':
+          onThumbValueChanged(
+            index,
+            Math.max(value - step, minVal),
+            keyboardReleased,
+          );
+          break;
+        case 'ArrowRight':
+        case 'ArrowUp':
+          onThumbValueChanged(
+            index,
+            Math.min(value + step, maxVal),
+            keyboardReleased,
+          );
+          break;
+        case 'Home':
+          onThumbValueChanged(index, minVal, keyboardReleased);
+          break;
+        case 'End':
+          onThumbValueChanged(index, maxVal, keyboardReleased);
+          break;
+        default:
+          return;
+      }
+      event.preventDefault();
+    },
+    [disabled, onThumbValueChanged, index, value, step, minVal, maxVal],
+  );
+  const handlePointerDownOnThumb = React.useCallback(() => {
+    !disabled && onThumbActivated(index);
+  }, [disabled, index, onThumbActivated]);
+  const adjustedValue = React.useMemo(() => {
+    if (value < sliderMin) {
+      return sliderMin;
+    }
+    if (value > sliderMax) {
+      return sliderMax;
+    }
+    return value;
+  }, [sliderMax, sliderMin, value]);
+  const lowPercent = React.useMemo(() => {
+    if (sliderMax === sliderMin) {
+      return 0;
+    }
+    return (100.0 * (adjustedValue - sliderMin)) / (sliderMax - sliderMin);
+  }, [adjustedValue, sliderMax, sliderMin]);
+  const { style, className, ...rest } = thumbProps || {};
+  return React.createElement(
+    Tooltip,
+    {
+      placement: 'top',
+      autoUpdateOptions: { animationFrame: true },
+      ariaStrategy: 'none',
+      ...tooltipProps,
+    },
+    React.createElement(Box, {
+      ...rest,
+      'data-index': index,
+      ref: thumbRef,
+      style: {
+        ...style,
+        ...(orientation === 'horizontal'
+          ? { insetInlineStart: `${lowPercent}%` }
+          : { insetBlockEnd: `${lowPercent}%` }),
+      },
+      className: cx('iui-slider-thumb', { 'iui-active': isActive }, className),
+      role: 'slider',
+      tabIndex: disabled ? undefined : 0,
+      'aria-valuemin': minVal,
+      'aria-valuenow': value,
+      'aria-valuemax': maxVal,
+      'aria-disabled': disabled,
+      onPointerDown: handlePointerDownOnThumb,
+      onKeyDown: (event) => handleOnKeyboardEvent(event, false),
+      onKeyUp: (event) => handleOnKeyboardEvent(event, true),
+    }),
+  );
 };

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

@@ -1,14 +1,14 @@
-/// <reference types="react" />
+import * as React from 'react';
 import type { SliderProps, TrackDisplayMode } from './Slider.js';
-export declare type TrackProps = {
+export type TrackProps = {
     trackDisplayMode: TrackDisplayMode;
     sliderMin: number;
     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`.
  */
-export declare const Track: (props: TrackProps) => JSX.Element;
+export declare const Track: (props: TrackProps) => React.JSX.Element;

package/esm/core/Slider/Track.js

@@ -3,63 +3,89 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import cx from 'classnames';
 import { Box } from '../utils/index.js';
 function shouldDisplaySegment(segmentIndex, mode) {
-    if ('odd-segments' === mode && 0 === (segmentIndex + 1) % 2) {
-        return true;
-    }
-    else if ('even-segments' === mode && 0 === segmentIndex % 2) {
-        return true;
-    }
-    return false;
+  if ('odd-segments' === mode && 0 === (segmentIndex + 1) % 2) {
+    return true;
+  } else if ('even-segments' === mode && 0 === segmentIndex % 2) {
+    return true;
+  }
+  return false;
 }
 function generateSegments(values, min, max) {
-    const segments = [];
-    const newValues = [...values];
-    newValues.sort((a, b) => a - b);
-    if (0 === newValues.length ||
-        newValues[0] < min ||
-        newValues[newValues.length - 1] > max ||
-        min === max) {
-        return [];
-    }
-    let lastValue = min;
-    for (let i = 0; i < newValues.length; i++) {
-        segments.push({ left: lastValue, right: newValues[i] });
-        lastValue = newValues[i];
-    }
-    segments.push({ left: lastValue, right: max });
-    return segments;
+  const segments = [];
+  const newValues = [...values];
+  newValues.sort((a, b) => a - b);
+  if (
+    0 === newValues.length ||
+    newValues[0] < min ||
+    newValues[newValues.length - 1] > max ||
+    min === max
+  ) {
+    return [];
+  }
+  let lastValue = min;
+  for (let i = 0; i < newValues.length; i++) {
+    segments.push({ left: lastValue, right: newValues[i] });
+    lastValue = newValues[i];
+  }
+  segments.push({ left: lastValue, right: max });
+  return segments;
 }
 /**
  * Track displays color segments above Rail. Which, if any, segments that are
  * colorized is based on `trackDisplayMode`.
  */
 export const Track = (props) => {
-    const { trackDisplayMode, sliderMin, sliderMax, values, orientation } = props;
-    const [segments, setSegments] = React.useState(() => generateSegments(values, sliderMin, sliderMax));
-    React.useEffect(() => {
-        setSegments(generateSegments(values, sliderMin, sliderMax));
-    }, [values, sliderMin, sliderMax]);
-    return (React.createElement(React.Fragment, null, 'none' !== trackDisplayMode &&
-        segments.map((segment, index) => {
-            const lowPercent = segment.left >= sliderMin && sliderMax !== sliderMin
-                ? (100.0 * (segment.left - sliderMin)) / (sliderMax - sliderMin)
-                : 0;
-            const highPercent = segment.right >= sliderMin && sliderMax !== sliderMin
-                ? 100.0 -
-                    (100.0 * (segment.right - sliderMin)) / (sliderMax - sliderMin)
-                : 100;
-            return (React.createElement(React.Fragment, { key: index }, shouldDisplaySegment(index, trackDisplayMode) ? (React.createElement(Box, { className: 'iui-slider-track', style: {
-                    ...(orientation === 'horizontal'
-                        ? {
-                            left: `${lowPercent}%`,
-                            right: `${highPercent}%`,
-                        }
-                        : {
-                            top: `${highPercent}%`,
-                            bottom: `${lowPercent}%`,
-                        }),
-                } })) : null));
-        })));
+  const {
+    className,
+    trackDisplayMode,
+    sliderMin,
+    sliderMax,
+    values,
+    orientation,
+  } = props;
+  const [segments, setSegments] = React.useState(() =>
+    generateSegments(values, sliderMin, sliderMax),
+  );
+  React.useEffect(() => {
+    setSegments(generateSegments(values, sliderMin, sliderMax));
+  }, [values, sliderMin, sliderMax]);
+  return React.createElement(
+    React.Fragment,
+    null,
+    'none' !== trackDisplayMode &&
+      segments.map((segment, index) => {
+        const lowPercent =
+          segment.left >= sliderMin && sliderMax !== sliderMin
+            ? (100.0 * (segment.left - sliderMin)) / (sliderMax - sliderMin)
+            : 0;
+        const highPercent =
+          segment.right >= sliderMin && sliderMax !== sliderMin
+            ? 100.0 -
+              (100.0 * (segment.right - sliderMin)) / (sliderMax - sliderMin)
+            : 100;
+        return React.createElement(
+          React.Fragment,
+          { key: index },
+          shouldDisplaySegment(index, trackDisplayMode)
+            ? React.createElement(Box, {
+                className: cx('iui-slider-track', className),
+                style: {
+                  ...(orientation === 'horizontal'
+                    ? {
+                        insetInlineStart: `${lowPercent}%`,
+                        insetInlineEnd: `${highPercent}%`,
+                      }
+                    : {
+                        insetBlockStart: `${highPercent}%`,
+                        insetBlockEnd: `${lowPercent}%`,
+                      }),
+                },
+              })
+            : null,
+        );
+      }),
+  );
 };

package/esm/core/StatusMessage/StatusMessage.d.ts

@@ -1,5 +1,7 @@
 import * as React from 'react';
-declare type StatusMessageProps = {
+import type { PolymorphicForwardRefComponent } from '../utils/index.js';
+import { Icon } from '../Icon/Icon.js';
+type StatusMessageProps = {
     /**
      * Custom icon to be displayed at the beginning.
      * It will default to the `status` icon, if it's set.
@@ -13,12 +15,20 @@ declare 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) => JSX.Element;
+export declare const StatusMessage: PolymorphicForwardRefComponent<"div", StatusMessageProps>;
 export default StatusMessage;

package/esm/core/StatusMessage/StatusMessage.js

@@ -4,16 +4,37 @@
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
 import { Box, StatusIconMap } from '../utils/index.js';
+import cx from 'classnames';
+import { Icon } from '../Icon/Icon.js';
 /**
- * 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 const StatusMessage = ({ startIcon: userStartIcon, children, status, }) => {
-    const icon = userStartIcon !== null && userStartIcon !== void 0 ? userStartIcon : (status && StatusIconMap[status]());
-    return (React.createElement(React.Fragment, null,
-        !!icon ? (React.createElement(Box, { as: 'span', className: 'iui-input-icon', "aria-hidden": true }, icon)) : null,
-        React.createElement(Box, { className: 'iui-message' }, children)));
-};
+export const StatusMessage = React.forwardRef((props, ref) => {
+  const {
+    children,
+    startIcon: userStartIcon,
+    status,
+    className,
+    iconProps,
+    contentProps,
+    ...rest
+  } = props;
+  const icon = userStartIcon ?? (status && StatusIconMap[status]());
+  return React.createElement(
+    Box,
+    {
+      className: cx('iui-status-message', className),
+      'data-iui-status': status,
+      ref: ref,
+      ...rest,
+    },
+    !!icon
+      ? React.createElement(Icon, { 'aria-hidden': true, ...iconProps }, icon)
+      : null,
+    React.createElement(Box, { ...contentProps }, children),
+  );
+});
 export default StatusMessage;

package/esm/core/Stepper/Stepper.d.ts

@@ -1,8 +1,9 @@
+import * as React from 'react';
 import type { PolymorphicForwardRefComponent } from '../utils/index.js';
-export declare type StepperLocalization = {
+export type StepperLocalization = {
     stepsCountLabel: (currentStep: number, totalSteps: number) => string;
 };
-export declare type StepProperties = {
+export type StepProperties = {
     /**
      * The title/label of the step.
      */
@@ -11,8 +12,8 @@ export declare type StepProperties = {
      * A tooltip giving detailed description to this step.
      */
     description?: string;
-};
-export declare type StepperProps = {
+} & React.ComponentProps<'li'>;
+export type StepperProps = {
     /**
      * Current step index, 0 - based.
      */
@@ -34,6 +35,30 @@ export declare 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/esm/core/Stepper/Stepper.js

@@ -2,19 +2,82 @@
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
+import cx from 'classnames';
 import * as React from 'react';
 import { Box } from '../utils/index.js';
 import { StepperStep } from './StepperStep.js';
 const defaultStepperLocalization = {
-    stepsCountLabel: (currentStep, totalSteps) => `Step ${currentStep} of ${totalSteps}:`,
+  stepsCountLabel: (currentStep, totalSteps) =>
+    `Step ${currentStep} of ${totalSteps}:`,
 };
 export const Stepper = React.forwardRef((props, ref) => {
-    const { currentStep, steps, type = 'default', localization = defaultStepperLocalization, onStepClick, ...rest } = props;
-    const boundedCurrentStep = Math.min(Math.max(0, currentStep !== null && currentStep !== void 0 ? currentStep : 0), steps.length - 1);
-    return (React.createElement(Box, { className: 'iui-stepper', ref: ref, ...rest },
-        React.createElement("ol", null, steps.map((s, index) => (React.createElement(StepperStep, { key: index, index: index, title: type === 'long' ? '' : s.name, currentStepNumber: boundedCurrentStep, totalSteps: steps.length, type: type, onClick: onStepClick, description: s.description })))),
-        type === 'long' && (React.createElement(Box, { className: 'iui-stepper-steps-label' },
-            React.createElement(Box, { as: 'span', className: 'iui-stepper-steps-label-count' }, localization.stepsCountLabel(boundedCurrentStep + 1, steps.length)),
-            steps[boundedCurrentStep].name))));
+  const {
+    currentStep,
+    steps,
+    type = 'default',
+    localization = defaultStepperLocalization,
+    onStepClick,
+    stepProps,
+    trackContentProps,
+    circleProps,
+    nameProps,
+    labelProps,
+    labelCountProps,
+    ...rest
+  } = props;
+  const boundedCurrentStep = Math.min(
+    Math.max(0, currentStep ?? 0),
+    steps.length - 1,
+  );
+  return React.createElement(
+    Box,
+    { className: 'iui-stepper', ref: ref, ...rest },
+    React.createElement(
+      'ol',
+      null,
+      steps.map((s, index) => {
+        const thisStepProps = stepProps?.(index);
+        const thisTrackContentProps = trackContentProps?.(index);
+        const thisCircleProps = circleProps?.(index);
+        const thisNameProps = nameProps?.(index);
+        return React.createElement(StepperStep, {
+          stepProps: thisStepProps,
+          trackContentProps: thisTrackContentProps,
+          circleProps: thisCircleProps,
+          nameProps: thisNameProps,
+          key: index,
+          index: index,
+          title: type === 'long' ? '' : s.name,
+          currentStepNumber: boundedCurrentStep,
+          totalSteps: steps.length,
+          type: type,
+          onClick: onStepClick,
+          description: s.description,
+        });
+      }),
+    ),
+    type === 'long' &&
+      React.createElement(
+        Box,
+        {
+          as: 'div',
+          ...labelProps,
+          className: cx('iui-stepper-steps-label', labelProps?.className),
+        },
+        React.createElement(
+          Box,
+          {
+            as: 'span',
+            ...labelCountProps,
+            className: cx(
+              'iui-stepper-steps-label-count',
+              labelCountProps?.className,
+            ),
+          },
+          localization.stepsCountLabel(boundedCurrentStep + 1, steps.length),
+        ),
+        steps[boundedCurrentStep].name,
+      ),
+  );
 });
 export default Stepper;

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

@@ -1,5 +1,6 @@
+import * as React from 'react';
 import type { PolymorphicForwardRefComponent } from '../utils/index.js';
-export declare type StepperStepProps = {
+export type StepperStepProps = {
     /**
      * The title/label of the step.
      */
@@ -28,5 +29,21 @@ export declare 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>;