@itwin/itwinui-react 3.0.0-dev.5 → 3.0.0-dev.7

package/esm/core/Slider/Track.js

@@ -3,6 +3,7 @@
  * 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) {
@@ -37,7 +38,14 @@ function generateSegments(values, min, max) {
  * colorized is based on `trackDisplayMode`.
  */
 export 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),
   );
@@ -63,16 +71,16 @@ export const Track = (props) => {
           { key: index },
           shouldDisplaySegment(index, trackDisplayMode)
             ? React.createElement(Box, {
-                className: 'iui-slider-track',
+                className: cx('iui-slider-track', className),
                 style: {
                   ...(orientation === 'horizontal'
                     ? {
-                        left: `${lowPercent}%`,
-                        right: `${highPercent}%`,
+                        insetInlineStart: `${lowPercent}%`,
+                        insetInlineEnd: `${highPercent}%`,
                       }
                     : {
-                        top: `${highPercent}%`,
-                        bottom: `${lowPercent}%`,
+                        insetBlockStart: `${highPercent}%`,
+                        insetBlockEnd: `${lowPercent}%`,
                       }),
                 },
               })

package/esm/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/esm/core/Stepper/Stepper.js

@@ -2,6 +2,7 @@
  * 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';
@@ -16,6 +17,12 @@ export const Stepper = React.forwardRef((props, ref) => {
     type = 'default',
     localization = defaultStepperLocalization,
     onStepClick,
+    stepProps,
+    trackContentProps,
+    circleProps,
+    nameProps,
+    labelProps,
+    labelCountProps,
     ...rest
   } = props;
   const boundedCurrentStep = Math.min(
@@ -28,8 +35,16 @@ export const Stepper = React.forwardRef((props, ref) => {
     React.createElement(
       'ol',
       null,
-      steps.map((s, index) =>
-        React.createElement(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, {
+          stepProps: thisStepProps,
+          trackContentProps: thisTrackContentProps,
+          circleProps: thisCircleProps,
+          nameProps: thisNameProps,
           key: index,
           index: index,
           title: type === 'long' ? '' : s.name,
@@ -38,16 +53,27 @@ export const Stepper = React.forwardRef((props, ref) => {
           type: type,
           onClick: onStepClick,
           description: s.description,
-        }),
-      ),
+        });
+      }),
     ),
     type === 'long' &&
       React.createElement(
         Box,
-        { className: 'iui-stepper-steps-label' },
+        {
+          as: 'div',
+          ...labelProps,
+          className: cx('iui-stepper-steps-label', labelProps?.className),
+        },
         React.createElement(
           Box,
-          { as: 'span', className: 'iui-stepper-steps-label-count' },
+          {
+            as: 'span',
+            ...labelCountProps,
+            className: cx(
+              'iui-stepper-steps-label-count',
+              labelCountProps?.className,
+            ),
+          },
           localization.stepsCountLabel(boundedCurrentStep + 1, steps.length),
         ),
         steps[boundedCurrentStep].name,

package/esm/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/esm/core/Stepper/StepperStep.js

@@ -17,6 +17,10 @@ export const StepperStep = React.forwardRef((props, forwardedRef) => {
     description,
     className,
     style,
+    stepProps,
+    trackContentProps,
+    circleProps,
+    nameProps,
     ...rest
   } = props;
   const isPast = currentStepNumber > index;
@@ -42,17 +46,17 @@ export const StepperStep = React.forwardRef((props, forwardedRef) => {
     Box,
     {
       as: 'li',
+      ...stepProps,
       className: cx(
         '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,
@@ -63,17 +67,32 @@ export const StepperStep = React.forwardRef((props, forwardedRef) => {
     },
     React.createElement(
       Box,
-      { className: 'iui-stepper-track-content' },
+      {
+        as: 'div',
+        ...trackContentProps,
+        className: cx(
+          'iui-stepper-track-content',
+          trackContentProps?.className,
+        ),
+      },
       React.createElement(
         Box,
-        { as: 'span', className: 'iui-stepper-circle' },
+        {
+          as: 'span',
+          ...circleProps,
+          className: cx('iui-stepper-circle', circleProps?.className),
+        },
         index + 1,
       ),
     ),
     type === 'default' &&
       React.createElement(
         Box,
-        { as: 'span', className: 'iui-stepper-step-name' },
+        {
+          as: 'span',
+          ...nameProps,
+          className: cx('iui-stepper-step-name', nameProps?.className),
+        },
         title,
       ),
   );

package/esm/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;

package/esm/core/Stepper/WorkflowDiagram.js

@@ -3,25 +3,28 @@
  * 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';
 import { WorkflowDiagramStep } from './WorkflowDiagramStep.js';
 export const WorkflowDiagram = React.forwardRef(
   // TODO: Remove this ref cast. ref and rest props should be applied on the same element
   (props, ref) => {
-    const { steps, ...rest } = props;
+    const { steps, className, contentProps, wrapperProps, ...rest } = props;
     return React.createElement(
       Box,
-      { ref: ref },
+      { as: 'div', ...wrapperProps, ref: ref },
       React.createElement(
         Box,
-        { as: 'ol', className: 'iui-workflow-diagram', ...rest },
-        steps.map((s, index) =>
-          React.createElement(WorkflowDiagramStep, {
+        { as: 'ol', className: cx('iui-workflow-diagram', className), ...rest },
+        steps.map((s, index) => {
+          const thisContentProps = contentProps?.(index);
+          return React.createElement(WorkflowDiagramStep, {
+            contentProps: thisContentProps,
             key: index,
             title: s.name,
             description: s.description,
-          }),
-        ),
+          });
+        }),
       ),
     );
   },

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

@@ -1,5 +1,10 @@
 import * as React from 'react';
 import { type CommonProps } from '../utils/index.js';
 import type { StepperStepProps } from './StepperStep.js';
-export type WorkflowDiagramStepProps = Pick<StepperStepProps, 'title' | 'description'> & Omit<CommonProps, 'title'>;
+export type WorkflowDiagramStepProps = {
+    /**
+     *  Allows props to be passed for diagram content.
+     */
+    contentProps?: React.ComponentProps<'span'>;
+} & Pick<StepperStepProps, 'title' | 'description'> & Omit<CommonProps, 'title'>;
 export declare const WorkflowDiagramStep: (props: WorkflowDiagramStepProps) => React.JSX.Element;

package/esm/core/Stepper/WorkflowDiagramStep.js

@@ -7,7 +7,7 @@ import * as React from 'react';
 import { Tooltip } from '../Tooltip/index.js';
 import { Box } from '../utils/index.js';
 export const WorkflowDiagramStep = (props) => {
-  const { title, description, className, style, ...rest } = props;
+  const { title, description, className, style, contentProps, ...rest } = props;
   const stepShape = React.createElement(
     Box,
     {
@@ -18,7 +18,11 @@ export const WorkflowDiagramStep = (props) => {
     },
     React.createElement(
       Box,
-      { as: 'span', className: 'iui-workflow-diagram-content' },
+      {
+        as: 'span',
+        ...contentProps,
+        className: cx('iui-workflow-diagram-content', contentProps?.className),
+      },
       title,
     ),
   );

package/esm/core/Table/SubRowExpander.js

@@ -16,7 +16,7 @@ export const SubRowExpander = (props) => {
           IconButton,
           {
             style: {
-              marginRight:
+              marginInlineEnd:
                 density === 'default' || density === undefined ? 8 : 4,
             },
             className: 'iui-table-row-expander',

package/esm/core/Table/Table.d.ts

@@ -190,6 +190,22 @@ export type TableProps<T extends Record<string, unknown> = Record<string, unknow
      * @default false
      */
     enableColumnReordering?: boolean;
+    /**
+     * Passes props to Table header wrapper.
+     */
+    headerWrapperProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to Table header.
+     */
+    headerProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes custom props to Table body.
+     */
+    bodyProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes custom props to empty table.
+     */
+    emptyTableContentProps?: React.ComponentProps<'div'>;
     /**
      * Function that returns index of the row that you want to scroll to.
      *

package/esm/core/Table/Table.js

@@ -146,6 +146,10 @@ export const Table = (props) => {
     styleType = 'default',
     enableVirtualization = false,
     enableColumnReordering = false,
+    headerWrapperProps,
+    headerProps,
+    bodyProps,
+    emptyTableContentProps,
     ...rest
   } = props;
   useGlobals();
@@ -596,7 +600,7 @@ export const Table = (props) => {
         return React.createElement(
           Box,
           {
-            className: 'iui-table-header-wrapper',
+            as: 'div',
             ref: headerRef,
             onScroll: () => {
               if (headerRef.current && bodyRef.current) {
@@ -605,10 +609,19 @@ export const Table = (props) => {
               }
             },
             key: headerGroupProps.key,
+            ...headerWrapperProps,
+            className: cx(
+              'iui-table-header-wrapper',
+              headerWrapperProps?.className,
+            ),
           },
           React.createElement(
             Box,
-            { className: 'iui-table-header' },
+            {
+              as: 'div',
+              ...headerProps,
+              className: cx('iui-table-header', headerProps?.className),
+            },
             React.createElement(
               Box,
               { ...headerGroupProps },
@@ -723,10 +736,15 @@ export const Table = (props) => {
       React.createElement(
         Box,
         {
+          ...bodyProps,
           ...getTableBodyProps({
-            className: cx('iui-table-body', {
-              'iui-zebra-striping': styleType === 'zebra-rows',
-            }),
+            className: cx(
+              'iui-table-body',
+              {
+                'iui-zebra-striping': styleType === 'zebra-rows',
+              },
+              bodyProps?.className,
+            ),
             style: { outline: 0 },
           }),
           ref: bodyRef,
@@ -756,7 +774,14 @@ export const Table = (props) => {
           data.length === 0 &&
           React.createElement(
             Box,
-            { className: 'iui-table-empty' },
+            {
+              as: 'div',
+              ...emptyTableContentProps,
+              className: cx(
+                'iui-table-empty',
+                emptyTableContentProps?.className,
+              ),
+            },
             React.createElement(ProgressRadial, { indeterminate: true }),
           ),
         isLoading &&
@@ -773,7 +798,6 @@ export const Table = (props) => {
               React.createElement(ProgressRadial, {
                 indeterminate: true,
                 size: 'small',
-                style: { float: 'none', marginLeft: 0 },
               }),
             ),
           ),
@@ -782,7 +806,14 @@ export const Table = (props) => {
           !areFiltersSet &&
           React.createElement(
             Box,
-            { className: 'iui-table-empty' },
+            {
+              as: 'div',
+              ...emptyTableContentProps,
+              className: cx(
+                'iui-table-empty',
+                emptyTableContentProps?.className,
+              ),
+            },
             React.createElement('div', null, emptyTableContent),
           ),
         !isLoading &&
@@ -790,7 +821,14 @@ export const Table = (props) => {
           areFiltersSet &&
           React.createElement(
             Box,
-            { className: 'iui-table-empty' },
+            {
+              as: 'div',
+              ...emptyTableContentProps,
+              className: cx(
+                'iui-table-empty',
+                emptyTableContentProps?.className,
+              ),
+            },
             React.createElement('div', null, emptyFilteredTableContent),
           ),
       ),

package/esm/core/Table/TableCell.js

@@ -39,7 +39,7 @@ export const TableCell = (props) => {
     }
     const multiplier = 26 + expanderMargin; // 26 = expander width
     return {
-      paddingLeft: cellPadding + dynamicMargin * multiplier,
+      paddingInlineStart: cellPadding + dynamicMargin * multiplier,
     };
   };
   const cellElementProps = cell.getCellProps({

package/esm/core/Table/TablePaginator.js

@@ -15,6 +15,7 @@ import {
   SvgChevronLeft,
   SvgChevronRight,
   Box,
+  ButtonBase,
 } from '../utils/index.js';
 const defaultLocalization = {
   pageSizeLabel: (size) => `${size} per page`,
@@ -86,11 +87,9 @@ export const TablePaginator = (props) => {
   const pageButton = React.useCallback(
     (index, tabIndex = index === focusedIndex ? 0 : -1) =>
       React.createElement(
-        Box,
+        ButtonBase,
         {
-          as: 'button',
           key: index,
-          type: 'button',
           className: cx('iui-table-paginator-page-button', {
             'iui-table-paginator-page-button-small': buttonSize === 'small',
           }),

package/esm/core/Tabs/Tab.js

@@ -4,7 +4,7 @@
  *--------------------------------------------------------------------------------------------*/
 import cx from 'classnames';
 import * as React from 'react';
-import { Box } from '../utils/index.js';
+import { Box, ButtonBase } from '../utils/index.js';
 /**
  * Individual tab component to be used in the `labels` prop of `Tabs`.
  * @example
@@ -24,9 +24,8 @@ export const Tab = React.forwardRef((props, forwardedRef) => {
     ...rest
   } = props;
   return React.createElement(
-    Box,
+    ButtonBase,
     {
-      as: 'button',
       className: cx('iui-tab', { 'iui-active': active }, className),
       role: 'tab',
       tabIndex: -1,

package/esm/core/ThemeProvider/ThemeContext.d.ts

@@ -3,5 +3,5 @@ import type { ThemeOptions, ThemeType } from './ThemeProvider.js';
 export declare const ThemeContext: React.Context<{
     theme?: ThemeType | undefined;
     themeOptions?: ThemeOptions | undefined;
-    portalContainerRef?: React.RefObject<HTMLElement> | undefined;
+    portalContainer?: HTMLElement | null | undefined;
 } | undefined>;

package/esm/core/ThemeProvider/ThemeProvider.d.ts

@@ -44,11 +44,31 @@ type RootProps = {
 type ThemeProviderOwnProps = Pick<RootProps, 'theme'> & {
     themeOptions?: RootProps['themeOptions'];
     children: Required<React.ReactNode>;
+    /**
+     * The element used as the portal for floating elements (Tooltip, Toast, DropdownMenu, Dialog, etc).
+     *
+     * Defaults to a `<div>` rendered at the end of the ThemeProvider.
+     *
+     * When passing an element, it is recommended to use state.
+     *
+     * @example
+     * const [myPortal, setMyPortal] = React.useState(null);
+     *
+     * <div ref={setMyPortal} />
+     * <ThemeProvider
+     *   portalContainer={myPortal}
+     * >
+     *   ...
+     * </ThemeProvider>
+     */
+    portalContainer?: HTMLElement;
 };
 /**
- * This component provides global styles and applies theme to the entire tree
- * that it is wrapping around. The `theme` prop is optional and defaults to the
- * light theme.
+ * This component provides global state and applies theme to the entire tree
+ * that it is wrapping around.
+ *
+ * The `theme` prop defaults to "inherit", which looks upwards for closest ThemeProvider
+ * and falls back to "light" theme if one is not found.
  *
  * If you want to theme the entire app, you should use this component at the root. You can also
  * use this component to apply a different theme to only a part of the tree.