@itwin/itwinui-react 3.15.5 → 3.16.0

package/cjs/core/Panels/Panels.js

@@ -0,0 +1,312 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', {
+  value: true,
+});
+function _export(target, all) {
+  for (var name in all)
+    Object.defineProperty(target, name, {
+      enumerable: true,
+      get: all[name],
+    });
+}
+_export(exports, {
+  Panels: function () {
+    return Panels;
+  },
+  PanelsWrapper: function () {
+    return PanelsWrapper;
+  },
+  PanelsWrapperContext: function () {
+    return PanelsWrapperContext;
+  },
+});
+const _interop_require_default = require('@swc/helpers/_/_interop_require_default');
+const _interop_require_wildcard = require('@swc/helpers/_/_interop_require_wildcard');
+const _react = _interop_require_wildcard._(require('react'));
+const _reactdom = _interop_require_wildcard._(require('react-dom'));
+const _index = require('../../utils/index.js');
+const _IconButton = require('../Buttons/IconButton.js');
+const _Flex = require('../Flex/Flex.js');
+const _Text = require('../Typography/Text.js');
+const _classnames = _interop_require_default._(require('classnames'));
+const _helpers = require('./helpers.js');
+const PanelsWrapper = _react.forwardRef((props, forwardedRef) => {
+  let {
+    children,
+    className,
+    onActiveIdChange: onActiveIdChangeProp,
+    instance,
+    ...rest
+  } = props;
+  let onActiveIdChange = (0, _index.useLatestRef)(onActiveIdChangeProp);
+  let ref = _react.useRef(null);
+  let [activePanelId, setActivePanelId] = _react.useState(void 0);
+  let [triggers, setTriggers] = _react.useState({});
+  let panels = _react.useRef(new Set());
+  let [shouldFocus, setShouldFocus] = _react.useState(void 0);
+  let motionOk = (0, _index.useMediaQuery)(
+    '(prefers-reduced-motion: no-preference)',
+  );
+  let changeActivePanel = _react.useCallback(
+    (newActiveId) => {
+      if (!panels.current.has(newActiveId) || newActiveId === activePanelId)
+        return;
+      _reactdom.flushSync(() => setActivePanelId(newActiveId));
+      onActiveIdChange.current?.(newActiveId);
+      ref.current?.ownerDocument.getElementById(newActiveId)?.scrollIntoView({
+        block: 'nearest',
+        inline: 'center',
+        behavior: motionOk ? 'smooth' : 'instant',
+      });
+    },
+    [activePanelId, motionOk, onActiveIdChange],
+  );
+  return _react.createElement(
+    PanelsWrapperContext.Provider,
+    {
+      value: _react.useMemo(
+        () => ({
+          activePanelId,
+          setActivePanelId,
+          changeActivePanel,
+          triggers,
+          setTriggers,
+          shouldFocus,
+          setShouldFocus,
+          panels,
+        }),
+        [
+          activePanelId,
+          changeActivePanel,
+          setActivePanelId,
+          setTriggers,
+          shouldFocus,
+          triggers,
+        ],
+      ),
+    },
+    _react.createElement(
+      _helpers.PanelsInstanceProvider,
+      {
+        instance: instance,
+      },
+      _react.createElement(
+        _index.Box,
+        {
+          ref: (0, _index.useMergedRefs)(ref, forwardedRef),
+          ...rest,
+          className: (0, _classnames.default)('iui-panel-wrapper', className),
+        },
+        children,
+      ),
+    ),
+  );
+});
+const PanelsWrapperContext = _react.createContext(void 0);
+const Panel = _react.forwardRef((props, forwardedRef) => {
+  let { id, children, className, ...rest } = props;
+  let { activePanelId, triggers, panels, setActivePanelId } = (0,
+  _index.useSafeContext)(PanelsWrapperContext);
+  let associatedTrigger = _react.useMemo(() => triggers[id], [id, triggers]);
+  let previousActivePanelId = useDelayed(activePanelId) || activePanelId;
+  let isMounted = [activePanelId, previousActivePanelId].includes(id);
+  let isTransitioning =
+    activePanelId === id && activePanelId !== previousActivePanelId;
+  let isInert = previousActivePanelId === id && activePanelId !== id;
+  (0, _index.useLayoutEffect)(() => {
+    let isFirstPanel = null == activePanelId && 0 === panels.current.size;
+    if (isFirstPanel) setActivePanelId(id);
+    let panelsCurrent = panels.current;
+    if (!panelsCurrent.has(id)) panelsCurrent.add(id);
+    return () => {
+      panelsCurrent.delete(id);
+    };
+  }, [activePanelId, id, panels, setActivePanelId]);
+  return _react.createElement(
+    PanelContext.Provider,
+    {
+      value: _react.useMemo(
+        () => ({
+          id,
+          associatedTrigger,
+        }),
+        [associatedTrigger, id],
+      ),
+    },
+    isMounted &&
+      _react.createElement(
+        _index.Box,
+        {
+          ref: forwardedRef,
+          id: id,
+          className: (0, _classnames.default)('iui-panel', className),
+          'aria-labelledby': `${id}-header-title`,
+          role: 'group',
+          inert: isInert ? '' : void 0,
+          'data-iui-transitioning': isTransitioning ? 'true' : void 0,
+          ...rest,
+        },
+        children,
+      ),
+  );
+});
+const PanelContext = _react.createContext(void 0);
+const PanelTrigger = (props) => {
+  let { children, for: forProp } = props;
+  let {
+    changeActivePanel,
+    triggers,
+    setTriggers,
+    activePanelId: activePanel,
+    shouldFocus,
+    setShouldFocus,
+    panels,
+  } = (0, _index.useSafeContext)(PanelsWrapperContext);
+  let { id: panelId } = (0, _index.useSafeContext)(PanelContext);
+  let fallbackId = _react.useId();
+  let triggerId = children.props.id || fallbackId;
+  let onClick = _react.useCallback(() => {
+    if (null == activePanel) return;
+    setShouldFocus({
+      fromPanelId: activePanel,
+      toPanelId: forProp,
+      direction: 'forward',
+    });
+    changeActivePanel?.(forProp);
+  }, [activePanel, changeActivePanel, forProp, setShouldFocus]);
+  let focusRef = _react.useCallback(
+    (el) => {
+      if (
+        shouldFocus?.direction === 'backward' &&
+        shouldFocus?.toPanelId === panelId &&
+        shouldFocus?.fromPanelId === forProp
+      ) {
+        el?.focus({
+          preventScroll: true,
+        });
+        setShouldFocus(void 0);
+      }
+    },
+    [forProp, panelId, setShouldFocus, shouldFocus],
+  );
+  let logWarning = (0, _index.useWarningLogger)();
+  _react.useEffect(() => {
+    if (!panels.current.has(forProp))
+      logWarning(
+        `Panels.Trigger's \`for\` prop ("${forProp}") corresponds to no Panel.`,
+      );
+  }, [forProp, logWarning, panels, triggers]);
+  _react.useEffect(() => {
+    setTriggers((oldTriggers) => {
+      let triggersMatch = oldTriggers[forProp];
+      if (
+        null == triggersMatch ||
+        panelId !== triggersMatch.panelId ||
+        triggerId !== triggersMatch.triggerId
+      )
+        return {
+          ...oldTriggers,
+          [forProp]: {
+            panelId,
+            triggerId,
+          },
+        };
+      return oldTriggers;
+    });
+  }, [forProp, panelId, setTriggers, triggerId]);
+  return (0, _index.cloneElementWithRef)(children, (children) => ({
+    ...children.props,
+    id: triggerId,
+    ref: focusRef,
+    onClick: (0, _index.mergeEventHandlers)(children.props.onClick, onClick),
+    'aria-expanded': activePanel === forProp,
+    'aria-controls': forProp,
+  }));
+};
+const PanelHeader = _react.forwardRef((props, forwardedRef) => {
+  let { titleProps, children, ...rest } = props;
+  let { shouldFocus, setShouldFocus } = (0, _index.useSafeContext)(
+    PanelsWrapperContext,
+  );
+  let { id: panelId, associatedTrigger: panelAssociatedTrigger } = (0,
+  _index.useSafeContext)(PanelContext);
+  let focusRef = _react.useCallback(
+    (el) => {
+      if (
+        shouldFocus?.direction === 'forward' &&
+        shouldFocus.toPanelId === panelId
+      ) {
+        el?.focus({
+          preventScroll: true,
+        });
+        setShouldFocus(void 0);
+      }
+    },
+    [panelId, setShouldFocus, shouldFocus?.direction, shouldFocus?.toPanelId],
+  );
+  return _react.createElement(
+    _Flex.Flex,
+    {
+      ref: forwardedRef,
+      ...rest,
+    },
+    panelAssociatedTrigger && _react.createElement(PanelBackButton, null),
+    _react.createElement(
+      _Text.Text,
+      {
+        id: `${panelId}-header-title`,
+        as: 'h2',
+        tabIndex: -1,
+        ref: focusRef,
+        ...titleProps,
+      },
+      children,
+    ),
+  );
+});
+const PanelBackButton = _react.forwardRef((props, forwardedRef) => {
+  let { children, onClick, ...rest } = props;
+  let { instance: panelInstance } = (0, _index.useSafeContext)(
+    _helpers.PanelsInstanceContext,
+  );
+  return _react.createElement(
+    _IconButton.IconButton,
+    {
+      ref: forwardedRef,
+      'aria-label': 'Previous panel',
+      styleType: 'borderless',
+      size: 'small',
+      'data-iui-shift': 'left',
+      ...rest,
+      onClick: (0, _index.mergeEventHandlers)(
+        _react.useCallback(() => panelInstance?.goBack(), [panelInstance]),
+        onClick,
+      ),
+    },
+    children || _react.createElement(_index.SvgChevronLeft, null),
+  );
+});
+const Panels = {
+  Wrapper: PanelsWrapper,
+  Panel,
+  Trigger: PanelTrigger,
+  Header: PanelHeader,
+  useInstance: _index.useInstance,
+};
+function useDelayed(
+  value,
+  { delay } = {
+    delay: 500,
+  },
+) {
+  let [delayed, setDelayed] = _react.useState(void 0);
+  let timeout = _react.useRef(void 0);
+  _react.useEffect(() => {
+    if (0 === delay) setDelayed(value);
+    else timeout.current = setTimeout(() => setDelayed(value), delay);
+    return () => {
+      clearTimeout(timeout.current);
+    };
+  }, [value, delay]);
+  return delayed;
+}

package/cjs/core/Panels/helpers.d.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+export type PanelsInstance = {
+    /** Go back to the panel that has a trigger that points to the current panel. */
+    goBack: () => void;
+};
+export type TriggerMapEntry = {
+    triggerId: string;
+    panelId: string;
+};
+export type FocusEntry = {
+    fromPanelId: string;
+    toPanelId: string;
+    direction: 'forward' | 'backward';
+} | undefined;
+export declare const PanelsInstanceContext: React.Context<{
+    instance: PanelsInstance;
+} | undefined>;
+type PanelInstanceProviderProps = {
+    children: React.ReactNode;
+    instance: PanelsInstance | undefined;
+};
+export declare const PanelsInstanceProvider: (props: PanelInstanceProviderProps) => React.JSX.Element;
+export {};

package/cjs/core/Panels/helpers.js

@@ -0,0 +1,61 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', {
+  value: true,
+});
+function _export(target, all) {
+  for (var name in all)
+    Object.defineProperty(target, name, {
+      enumerable: true,
+      get: all[name],
+    });
+}
+_export(exports, {
+  PanelsInstanceContext: function () {
+    return PanelsInstanceContext;
+  },
+  PanelsInstanceProvider: function () {
+    return PanelsInstanceProvider;
+  },
+});
+const _interop_require_wildcard = require('@swc/helpers/_/_interop_require_wildcard');
+const _react = _interop_require_wildcard._(require('react'));
+const _index = require('../../utils/index.js');
+const _Panels = require('./Panels.js');
+const PanelsInstanceContext = _react.createContext(void 0);
+const PanelsInstanceProvider = (props) => {
+  let { children, instance: instanceProp } = props;
+  let instanceBackup = _Panels.Panels.useInstance();
+  let instance = instanceProp || instanceBackup;
+  let { activePanelId, changeActivePanel, triggers, setShouldFocus } = (0,
+  _index.useSafeContext)(_Panels.PanelsWrapperContext);
+  let goBack = _react.useCallback(async () => {
+    if (null == activePanelId) return;
+    let trigger = triggers[activePanelId];
+    if (null != trigger.triggerId) {
+      setShouldFocus({
+        fromPanelId: activePanelId,
+        toPanelId: trigger.panelId,
+        direction: 'backward',
+      });
+      changeActivePanel(trigger.panelId);
+    }
+  }, [activePanelId, changeActivePanel, setShouldFocus, triggers]);
+  (0, _index.useSynchronizeInstance)(
+    instance,
+    _react.useMemo(
+      () => ({
+        goBack,
+      }),
+      [goBack],
+    ),
+  );
+  return _react.createElement(
+    PanelsInstanceContext.Provider,
+    {
+      value: {
+        instance,
+      },
+    },
+    children,
+  );
+};

package/cjs/core/Radio/Radio.js

@@ -28,7 +28,7 @@ const Radio = _react.forwardRef((props, ref) => {
   let refs = (0, _index.useMergedRefs)(inputElementRef, ref);
   let radio = _react.createElement(_index.Box, {
     as: 'input',
-    className: (0, _classnames.default)('iui-radio', className),
+    className: (0, _classnames.default)('iui-checkbox', 'iui-radio', className),
     style: style,
     disabled: disabled,
     type: 'radio',
@@ -42,13 +42,11 @@ const Radio = _react.forwardRef((props, ref) => {
           as: 'label',
           ...wrapperProps,
           className: (0, _classnames.default)(
-            'iui-radio-wrapper',
-            {
-              'iui-disabled': disabled,
-              [`iui-${status}`]: !!status,
-            },
+            'iui-checkbox-wrapper',
             wrapperProps?.className,
           ),
+          'data-iui-status': status,
+          'data-iui-disabled': disabled ? 'true' : void 0,
         },
         radio,
         label &&

package/cjs/core/RadioTiles/RadioTileGroup.d.ts

@@ -1,7 +1,9 @@
 import * as React from 'react';
 import { InputGroup } from '../InputGroup/InputGroup.js';
 import type { PolymorphicForwardRefComponent } from '../../utils/index.js';
-type RadioTileGroupProps = Omit<React.ComponentProps<typeof InputGroup>, 'displayStyle' | 'disabled'>;
+type RadioTileGroupProps = {
+    tileContainerProps?: React.ComponentProps<'div'>;
+} & Omit<React.ComponentProps<typeof InputGroup>, 'displayStyle' | 'disabled'>;
 /**
  * RadioTileGroup component to group RadioTile components together
  * @example

package/cjs/core/RadioTiles/RadioTileGroup.js

@@ -8,12 +8,14 @@ Object.defineProperty(exports, 'RadioTileGroup', {
     return RadioTileGroup;
   },
 });
+const _interop_require_default = require('@swc/helpers/_/_interop_require_default');
 const _interop_require_wildcard = require('@swc/helpers/_/_interop_require_wildcard');
 const _react = _interop_require_wildcard._(require('react'));
 const _InputGroup = require('../InputGroup/InputGroup.js');
 const _index = require('../../utils/index.js');
+const _classnames = _interop_require_default._(require('classnames'));
 const RadioTileGroup = _react.forwardRef((props, forwardedRef) => {
-  let { children, label, ...rest } = props;
+  let { children, label, tileContainerProps, ...rest } = props;
   return _react.createElement(
     _InputGroup.InputGroup,
     {
@@ -24,7 +26,12 @@ const RadioTileGroup = _react.forwardRef((props, forwardedRef) => {
     _react.createElement(
       _index.Box,
       {
-        className: 'iui-radio-tile-container',
+        as: 'div',
+        ...tileContainerProps,
+        className: (0, _classnames.default)(
+          'iui-radio-tile-container',
+          tileContainerProps?.className,
+        ),
       },
       children,
     ),

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

@@ -1,10 +1,12 @@
+import * as React from 'react';
+import { Tag } from '../Tag/Tag.js';
 import type { PolymorphicForwardRefComponent } from '../../utils/index.js';
 type SelectTagProps = {
     /**
      * Text inside the tag.
      */
     label: string;
-};
+} & Pick<React.ComponentProps<typeof Tag>, 'onClick' | 'onRemove'>;
 /**
  * Tag for showing selected value in `Select`.
  * @private

package/cjs/core/Select/SelectTag.js

@@ -12,24 +12,22 @@ const _interop_require_default = require('@swc/helpers/_/_interop_require_defaul
 const _interop_require_wildcard = require('@swc/helpers/_/_interop_require_wildcard');
 const _classnames = _interop_require_default._(require('classnames'));
 const _react = _interop_require_wildcard._(require('react'));
-const _index = require('../../utils/index.js');
+const _Tag = require('../Tag/Tag.js');
 const SelectTag = _react.forwardRef((props, forwardedRef) => {
   let { className, label, ...rest } = props;
   return _react.createElement(
-    _index.Box,
+    _Tag.Tag,
     {
-      as: 'span',
       className: (0, _classnames.default)('iui-select-tag', className),
+      labelProps: {
+        className: 'iui-select-tag-label',
+      },
+      removeButtonProps: {
+        className: 'iui-select-tag-button',
+      },
       ref: forwardedRef,
       ...rest,
     },
-    _react.createElement(
-      _index.Box,
-      {
-        as: 'span',
-        className: 'iui-select-tag-label',
-      },
-      label,
-    ),
+    label,
   );
 });

package/cjs/core/Select/SelectTagContainer.js

@@ -14,7 +14,7 @@ const _react = _interop_require_wildcard._(require('react'));
 const _classnames = _interop_require_default._(require('classnames'));
 const _SelectTag = require('./SelectTag.js');
 const _index = require('../../utils/index.js');
-const SelectTagContainer = _react.forwardRef((props, ref) => {
+const SelectTagContainer = _react.forwardRef((props, forwardedRef) => {
   let { tags: tagsProp, className, ...rest } = props;
   let tags = _react.useMemo(
     () => _react.Children.toArray(tagsProp),
@@ -28,7 +28,7 @@ const SelectTagContainer = _react.forwardRef((props, ref) => {
         'iui-select-tag-container',
         className,
       ),
-      ref: ref,
+      ref: forwardedRef,
       ...rest,
     },
     _react.createElement(SelectTagContainerContent, {

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

@@ -12,6 +12,10 @@ export type StepProperties = {
      * A tooltip giving detailed description to this step.
      */
     description?: string;
+    /**
+     * Custom content displayed in the step's circle.
+     */
+    stepContent?: () => React.ReactNode;
 } & React.ComponentProps<'li'>;
 export type StepperProps = {
     /**

package/cjs/core/Stepper/Stepper.js

@@ -65,6 +65,7 @@ const Stepper = _react.forwardRef((props, ref) => {
           type: type,
           onClick: onStepClick,
           description: s.description,
+          stepContent: s.stepContent,
         });
       }),
     ),

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

@@ -29,6 +29,10 @@ export type StepperStepProps = {
      * A tooltip giving detailed description to this step.
      */
     description?: string;
+    /**
+     * Custom content displayed in the step's circle.
+     */
+    stepContent?: () => React.ReactNode;
     /**
      * Allows props to be passed for stepper step.
      */

package/cjs/core/Stepper/StepperStep.js

@@ -29,6 +29,7 @@ const StepperStep = _react.forwardRef((props, forwardedRef) => {
     trackContentProps,
     circleProps,
     nameProps,
+    stepContent,
     ...rest
   } = props;
   let isPast = currentStepNumber > index;
@@ -89,7 +90,7 @@ const StepperStep = _react.forwardRef((props, forwardedRef) => {
             circleProps?.className,
           ),
         },
-        index + 1,
+        stepContent ? stepContent() : index + 1,
       ),
     ),
     'default' === type &&

package/cjs/core/Table/Table.d.ts

@@ -3,6 +3,7 @@ import type { CellProps, TableOptions, Row, TableState } from '../../react-table
 import type { CommonProps } from '../../utils/index.js';
 import type { TableFilterValue } from './filters/index.js';
 export declare const tableResizeStartAction = "tableResizeStart";
+export declare const iuiId: unique symbol;
 export type TablePaginatorRendererProps = {
     /**
      * The zero-based index of the current page.

package/cjs/core/Table/Table.js

@@ -13,6 +13,9 @@ _export(exports, {
   Table: function () {
     return Table;
   },
+  iuiId: function () {
+    return iuiId;
+  },
   tableResizeStartAction: function () {
     return tableResizeStartAction;
   },
@@ -650,11 +653,7 @@ const Table = (props) => {
               },
               bodyProps?.className,
             ),
-            style: {
-              outline: 0,
-            },
           }),
-          tabIndex: -1,
           'aria-multiselectable':
             (isSelectable && 'multi' === selectionMode) || void 0,
         },

package/cjs/core/Table/TablePaginator.js

@@ -60,7 +60,7 @@ const TablePaginator = (props) => {
   );
   let pageListRef = _react.useRef(null);
   let [focusedIndex, setFocusedIndex] = _react.useState(currentPage);
-  _react.useLayoutEffect(() => {
+  (0, _index.useLayoutEffect)(() => {
     setFocusedIndex(currentPage);
   }, [currentPage]);
   let needFocus = _react.useRef(false);
@@ -182,6 +182,7 @@ const TablePaginator = (props) => {
             : _react.createElement(TablePaginatorPageButtons, {
                 size: size,
                 focusedIndex: focusedIndex,
+                setFocusedIndex: setFocusedIndex,
                 totalPagesCount: totalPagesCount,
                 onPageChange: onPageChange,
                 currentPage: currentPage,
@@ -255,6 +256,7 @@ const TablePaginator = (props) => {
 const TablePaginatorPageButtons = (props) => {
   let {
     focusedIndex,
+    setFocusedIndex,
     totalPagesCount,
     onPageChange,
     currentPage,
@@ -274,14 +276,24 @@ const TablePaginatorPageButtons = (props) => {
           styleType: 'borderless',
           size: buttonSize,
           'data-iui-active': index === currentPage,
-          onClick: () => onPageChange(index),
+          onClick: () => {
+            setFocusedIndex(index);
+            onPageChange(index);
+          },
           'aria-current': index === currentPage,
           'aria-label': localization.goToPageLabel?.(index + 1),
           tabIndex: tabIndex,
         },
         index + 1,
       ),
-    [focusedIndex, currentPage, localization, buttonSize, onPageChange],
+    [
+      focusedIndex,
+      buttonSize,
+      currentPage,
+      localization,
+      setFocusedIndex,
+      onPageChange,
+    ],
   );
   let pageList = _react.useMemo(
     () =>