@itwin/itwinui-react 3.18.3 → 3.19.1

package/cjs/core/Table/ColumnHeader.js

@@ -105,10 +105,14 @@ const ColumnHeader = _react.forwardRef((props, forwardedRef) => {
       'string' == typeof column.Header
         ? _react.createElement(
             _index.ShadowRoot,
-            null,
+            {
+              css: _index.lineClamp.css,
+            },
             _react.createElement(
-              _index.LineClamp,
-              null,
+              'div',
+              {
+                className: _index.lineClamp.className,
+              },
               _react.createElement('slot', null),
             ),
             _react.createElement('slot', {

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

@@ -206,8 +206,8 @@ export type TableProps<T extends Record<string, unknown> = Record<string, unknow
     /**
      * Passes props to the `role="table"` element within the wrapper.
      *
-     * If `tableProps` or `role` is passed to `Table`, all ARIA attributes passed to `Table` will be passed to the wrapper.
-     * Else, all ARIA attributes will be passed to the inner element with `role="table"`.
+     * - If `tableProps` or `role` is passed to `Table`, all ARIA attributes passed to `Table` will be passed to the wrapper.
+     * - Else, all ARIA attributes will be passed to the inner element with `role="table"`.
      */
     tableProps?: React.ComponentProps<'div'>;
     /**

package/cjs/core/Table/Table.js

@@ -100,6 +100,38 @@ const Table = (props) => {
     caption = 'Table',
     role,
     scrollToRow,
+    useControlledState,
+    autoResetExpanded,
+    autoResetFilters,
+    autoResetGlobalFilter,
+    autoResetHiddenColumns,
+    autoResetPage,
+    autoResetResize,
+    autoResetSelectedRows,
+    autoResetSortBy,
+    defaultCanFilter,
+    defaultCanSort,
+    defaultColumn: defaultColumnProp,
+    disableFilters,
+    disableGlobalFilter,
+    disableMultiSort,
+    disableSortRemove,
+    disabledMultiRemove,
+    expandSubRows,
+    globalFilter,
+    initialState,
+    isMultiSortEvent,
+    manualExpandedKey,
+    manualFilters,
+    manualGlobalFilter,
+    manualRowSelectedKey,
+    manualSortBy,
+    maxMultiSortColCount,
+    orderByFn,
+    pageCount,
+    sortTypes,
+    manualPagination,
+    paginateExpandedRows,
     ..._rest
   } = props;
   let { ariaRestAttributes, nonAriaRestAttributes } = _react.useMemo(
@@ -140,8 +172,9 @@ const Table = (props) => {
       maxWidth: 0,
       minWidth: 0,
       width: 0,
+      ...defaultColumnProp,
     }),
-    [],
+    [defaultColumnProp],
   );
   let rowHeight = _react.useMemo(() => {
     if ('condensed' === density) return 50;
@@ -295,9 +328,36 @@ const Table = (props) => {
   );
   let instance = (0, _reacttable.useTable)(
     {
-      manualPagination: !paginatorRenderer,
-      paginateExpandedRows: false,
-      ...props,
+      manualPagination: manualPagination ?? !paginatorRenderer,
+      paginateExpandedRows: paginateExpandedRows ?? false,
+      useControlledState,
+      autoResetExpanded,
+      autoResetFilters,
+      autoResetGlobalFilter,
+      autoResetHiddenColumns,
+      autoResetPage,
+      autoResetResize,
+      autoResetSelectedRows,
+      autoResetSortBy,
+      defaultCanFilter,
+      defaultCanSort,
+      disableFilters,
+      disableGlobalFilter,
+      disableMultiSort,
+      disableSortRemove,
+      disabledMultiRemove,
+      expandSubRows,
+      globalFilter,
+      isMultiSortEvent,
+      manualExpandedKey,
+      manualFilters,
+      manualGlobalFilter,
+      manualRowSelectedKey,
+      manualSortBy,
+      maxMultiSortColCount,
+      orderByFn,
+      pageCount: pageCount ?? -1,
+      sortTypes,
       columns,
       defaultColumn,
       disableSortBy: !isSortable,
@@ -308,7 +368,7 @@ const Table = (props) => {
       getSubRows: subComponent ? getSubRowsWithSubComponents : getSubRows,
       initialState: {
         pageSize,
-        ...props.initialState,
+        ...initialState,
       },
       columnResizeMode,
       getRowId: subComponent ? getRowIdWithSubComponents : getRowId,

package/cjs/core/Table/cells/DefaultCell.js

@@ -37,6 +37,10 @@ const DefaultCell = (props) => {
   );
   let isCellRendererChildrenCustom =
     _react.useContext(DefaultCellRendererPropsChildren) !== props.children;
+  let isDefaultTextCell =
+    'string' == typeof props.cellProps.value &&
+    !isCustomCell &&
+    !isCellRendererChildrenCustom;
   let {
     cellElementProps: {
       className: cellElementClassName,
@@ -51,9 +55,7 @@ const DefaultCell = (props) => {
     className,
     style,
     status,
-    clamp = 'string' == typeof cellProps.value &&
-      !isCustomCell &&
-      !isCellRendererChildrenCustom,
+    clamp = isDefaultTextCell,
     ...rest
   } = props;
   let { key: cellElementKey, ...cellElementPropsRest } = cellElementProps;
@@ -84,12 +86,14 @@ const DefaultCell = (props) => {
       _react.createElement(
         TableCellContent,
         {
-          shouldRenderWrapper: isCellRendererChildrenCustom,
+          shouldRenderWrapper: isDefaultTextCell,
         },
         clamp
           ? _react.createElement(
-              _index.LineClamp,
-              null,
+              'div',
+              {
+                className: _index.lineClamp.className,
+              },
               _react.createElement('slot', null),
             )
           : _react.createElement('slot', null),
@@ -129,15 +133,15 @@ if ('development' === process.env.NODE_ENV)
 const TableCellContent = (props) => {
   let { children, shouldRenderWrapper } = props;
   return shouldRenderWrapper
-    ? children
-    : _react.createElement(
+    ? _react.createElement(
         'div',
         {
           className: '_iui-table-cell-default-content',
           onClick: (e) => e.stopPropagation(),
         },
         children,
-      );
+      )
+    : children;
 };
 const css = `
 ._iui-table-cell-default-content {
@@ -151,4 +155,5 @@ const css = `
   inset: -6px;
   z-index: -1;
 }
+${_index.lineClamp.css}
 `;

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

@@ -28,6 +28,7 @@ type ActionColumnProps = {
 export declare const ActionColumn: <T extends Record<string, unknown>>({ columnManager, }?: ActionColumnProps) => {
     id: string;
     disableResizing: boolean;
+    canResize: boolean;
     disableGroupBy: boolean;
     minWidth: number;
     width: number;

package/cjs/core/Table/columns/actionColumn.js

@@ -23,6 +23,7 @@ const ACTION_CELL_ID = 'iui-table-action';
 const ActionColumn = ({ columnManager = false } = {}) => ({
   id: ACTION_CELL_ID,
   disableResizing: true,
+  canResize: false,
   disableGroupBy: true,
   minWidth: 48,
   width: 48,

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

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { CellProps, CellRendererProps, Row } from '../../../react-table/react-table.js';
+import type { CellRendererProps, Row } from '../../../react-table/react-table.js';
 export declare const EXPANDER_CELL_ID = "iui-table-expander";
 /**
  * Expander column that adds sub-content expander column to the Table.
@@ -39,6 +39,6 @@ export declare const ExpanderColumn: <T extends Record<string, unknown>>(props?:
     maxWidth: number;
     columnClassName: string;
     cellClassName: string;
-    Cell: (props: CellProps<T>) => React.JSX.Element | null;
+    Cell: () => null;
     cellRenderer: (props: CellRendererProps<T>) => React.JSX.Element;
 };

package/cjs/core/Table/columns/expanderColumn.js

@@ -35,30 +35,35 @@ const ExpanderColumn = (props = {}) => {
     maxWidth: 48,
     columnClassName: 'iui-slot',
     cellClassName: 'iui-slot',
-    Cell: (props) => {
-      let { row } = props;
-      if (!subComponent?.(row)) return null;
+    Cell: () => null,
+    cellRenderer: (props) => {
+      let { row } = props.cellProps;
+      let children = subComponent?.(row)
+        ? _react.createElement(
+            _IconButton.IconButton,
+            {
+              'aria-label': 'Toggle expandable content',
+              className: 'iui-table-row-expander',
+              styleType: 'borderless',
+              size: 'small',
+              onClick: (e) => {
+                e.stopPropagation();
+                row.toggleRowExpanded();
+              },
+              disabled: isDisabled?.(row.original),
+              'aria-expanded': row.isExpanded,
+            },
+            _react.createElement(_index.SvgChevronRight, null),
+          )
+        : null;
       return _react.createElement(
-        _IconButton.IconButton,
+        _index1.DefaultCell,
         {
-          'aria-label': 'Toggle expandable content',
-          className: 'iui-table-row-expander',
-          styleType: 'borderless',
-          size: 'small',
-          onClick: (e) => {
-            e.stopPropagation();
-            row.toggleRowExpanded();
-          },
-          disabled: isDisabled?.(props.row.original),
-          'aria-expanded': row.isExpanded,
+          ...props,
+          isDisabled: (rowData) => !!isDisabled?.(rowData),
         },
-        _react.createElement(_index.SvgChevronRight, null),
+        children,
       );
     },
-    cellRenderer: (props) =>
-      _react.createElement(_index1.DefaultCell, {
-        ...props,
-        isDisabled: (rowData) => !!isDisabled?.(rowData),
-      }),
   };
 };

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

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { CellProps, CellRendererProps, HeaderProps } from '../../../react-table/react-table.js';
+import type { CellRendererProps, HeaderProps } from '../../../react-table/react-table.js';
 export declare const SELECTION_CELL_ID = "iui-table-checkbox-selector";
 /**
  * Selection column that adds selection checkbox column to the Table.
@@ -28,6 +28,6 @@ export declare const SelectionColumn: <T extends Record<string, unknown>>(props?
     columnClassName: string;
     cellClassName: string;
     Header: ({ getToggleAllRowsSelectedProps, toggleAllRowsSelected, rows, preFilteredFlatRows, state, }: HeaderProps<T>) => React.JSX.Element;
-    Cell: ({ row, selectSubRows }: CellProps<T>) => React.JSX.Element;
+    Cell: () => null;
     cellRenderer: (props: CellRendererProps<T>) => React.JSX.Element;
 };

package/cjs/core/Table/columns/selectionColumn.js

@@ -64,8 +64,10 @@ const SelectionColumn = (props = {}) => {
         onChange: () => toggleAllRowsSelected(nextToggleState),
       });
     },
-    Cell: ({ row, selectSubRows = true }) =>
-      _react.createElement(_Checkbox.Checkbox, {
+    Cell: () => null,
+    cellRenderer: (props) => {
+      let { row, selectSubRows = true } = props.cellProps;
+      let children = _react.createElement(_Checkbox.Checkbox, {
         ...row.getToggleRowSelectedProps(),
         style: {},
         title: '',
@@ -85,11 +87,15 @@ const SelectionColumn = (props = {}) => {
             );
           else row.toggleRowSelected(!row.isSelected);
         },
-      }),
-    cellRenderer: (props) =>
-      _react.createElement(_index.DefaultCell, {
-        ...props,
-        isDisabled: (rowData) => !!isDisabled?.(rowData),
-      }),
+      });
+      return _react.createElement(
+        _index.DefaultCell,
+        {
+          ...props,
+          isDisabled: (rowData) => !!isDisabled?.(rowData),
+        },
+        children,
+      );
+    },
   };
 };

package/cjs/core/Table/hooks/useExpanderCell.js

@@ -11,6 +11,7 @@ Object.defineProperty(exports, 'useExpanderCell', {
 const _interop_require_wildcard = require('@swc/helpers/_/_interop_require_wildcard');
 const _react = /*#__PURE__*/ _interop_require_wildcard._(require('react'));
 const _index = require('../columns/index.js');
+const _DefaultCell = require('../cells/DefaultCell.js');
 const useExpanderCell =
   (subComponent, expanderCell, isRowDisabled) => (hooks) => {
     if (!subComponent) return;
@@ -26,14 +27,17 @@ const useExpanderCell =
       return [
         {
           ...expanderColumn,
-          Cell: expanderCell
-            ? (cellProps) =>
+          cellRenderer: expanderCell
+            ? (props) =>
                 _react.createElement(
-                  _react.Fragment,
-                  null,
-                  expanderCell(cellProps),
+                  _DefaultCell.DefaultCell,
+                  {
+                    ...props,
+                    isDisabled: (rowData) => !!isRowDisabled?.(rowData),
+                  },
+                  expanderCell(props.cellProps),
                 )
-            : expanderColumn.Cell,
+            : expanderColumn.cellRenderer,
         },
         ...columns,
       ];

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

@@ -42,9 +42,12 @@ type TabsWrapperOwnProps = {
      */
     value?: string;
     /**
-     * Function that gets called when active tab is changed.
+     * Function that gets called when active tab *changes* (uncontrolled mode) or should *change* (controlled mode).
      *
      * Should be used alongside `value` prop.
+     *
+     * If need to listen to each tab click, use `onClick` prop on `Tabs.Tab`.
+     * Similarly, for each focus, use `onFocus` prop on `Tabs.Tab`.
      */
     onValueChange?: (value: string) => void;
     /**

package/cjs/core/Tag/Tag.js

@@ -53,8 +53,11 @@ const Tag = _react.forwardRef((props, forwardedRef) => {
           _index.Box,
           {
             as: shouldUseLinkAction ? _LinkAction.LinkAction : 'span',
-            onClick: shouldUseLinkAction ? onClick : void 0,
             ...labelProps,
+            onClick: (0, _index.mergeEventHandlers)(
+              labelProps?.onClick,
+              shouldUseLinkAction ? onClick : void 0,
+            ),
             className: (0, _classnames.default)(
               'iui-tag-label',
               labelProps?.className,
@@ -69,9 +72,12 @@ const Tag = _react.forwardRef((props, forwardedRef) => {
         {
           styleType: 'borderless',
           size: 'small',
-          onClick: onRemove,
           'aria-label': 'Delete tag',
           ...removeButtonProps,
+          onClick: (0, _index.mergeEventHandlers)(
+            removeButtonProps?.onClick,
+            onRemove,
+          ),
           className: (0, _classnames.default)(
             'iui-tag-button',
             removeButtonProps?.className,

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

@@ -1,8 +1,7 @@
 import * as React from 'react';
-import type { FutureOptions, ThemeOptions, ThemeType } from './ThemeProvider.js';
+import type { ThemeOptions, ThemeType } from './ThemeProvider.js';
 export declare const ThemeContext: React.Context<{
     theme?: ThemeType;
     themeOptions?: ThemeOptions;
     portalContainer?: HTMLElement | null;
-    future?: FutureOptions;
 } | undefined>;

package/cjs/core/ThemeProvider/ThemeProvider.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { PolymorphicForwardRefComponent } from '../../utils/index.js';
+import type { FutureOptions, PolymorphicForwardRefComponent } from '../../utils/index.js';
 export type ThemeOptions = {
     /**
      * Whether to apply high-contrast versions of light and dark themes.
@@ -7,18 +7,6 @@ export type ThemeOptions = {
      */
     highContrast?: boolean;
 };
-export type FutureOptions = {
-    /**
-     * @alpha
-     *
-     * If enabled, the theme resembles the future iTwinUI version's theme (including alphas) *whenever possible*.
-     *
-     * This is useful in making apps looks like future versions of iTwinUI to help with incremental adoption.
-     *
-     * **NOTE**: Since this is a theme bridge to *future* versions, the theme could have breaking changes.
-     */
-    themeBridge?: boolean;
-};
 export type ThemeType = 'light' | 'dark' | 'os';
 type RootProps = {
     /**
@@ -53,12 +41,8 @@ type RootProps = {
          */
         applyBackground?: boolean;
     };
-    /**
-     * Options to help with early adoption of features from future versions.
-     */
-    future?: FutureOptions;
 };
-type ThemeProviderOwnProps = Pick<RootProps, 'theme' | 'future'> & {
+type ThemeProviderOwnProps = Pick<RootProps, 'theme'> & {
     themeOptions?: RootProps['themeOptions'];
     children: Required<React.ReactNode>;
     /**
@@ -89,6 +73,12 @@ type ThemeProviderOwnProps = Pick<RootProps, 'theme' | 'future'> & {
      * If true or false is passed, it will override the default behavior.
      */
     includeCss?: boolean;
+    /**
+     * Options to help with early adoption of features from future versions.
+     *
+     * All future options will be automatically inherited across nested ThemeProviders, unless explicitly overridden.
+     */
+    future?: true | FutureOptions;
 };
 /**
  * This component provides global state and applies theme to the entire tree

package/cjs/core/ThemeProvider/ThemeProvider.js

@@ -24,14 +24,14 @@ const _meta = require('../../utils/meta.js');
 const versionWithoutDots = _meta.meta.version.replace(/\./g, '');
 const OwnerDocumentContext = _react.createContext(void 0);
 const ThemeProvider = _react.forwardRef((props, forwardedRef) => {
-  var _themeOptions, _themeOptions1, _future;
+  var _themeOptions, _themeOptions1;
   let {
     theme: themeProp = 'inherit',
     children,
     themeOptions = {},
     portalContainer: portalContainerProp,
     includeCss = 'inherit' === themeProp,
-    future = {},
+    future: futureProp = {},
     ...rest
   } = props;
   useInertPolyfill();
@@ -43,68 +43,69 @@ const ThemeProvider = _react.forwardRef((props, forwardedRef) => {
   (_themeOptions1 = themeOptions).highContrast ??
     (_themeOptions1.highContrast =
       'inherit' === themeProp ? parent.highContrast : void 0);
-  (_future = future).themeBridge ??
-    (_future.themeBridge = parent.context?.future?.themeBridge);
   let portalContainerFromParent = _react.useContext(
     _index.PortalContainerContext,
   );
-  let contextValue = _react.useMemo(
+  let themeContextValue = _react.useMemo(
     () => ({
       theme,
       themeOptions,
-      future,
     }),
-    [theme, JSON.stringify(themeOptions), JSON.stringify(future)],
+    [theme, JSON.stringify(themeOptions)],
   );
   let [portalContainer, setPortalContainer] = _react.useState(
     portalContainerProp || null,
   );
   return _react.createElement(
-    _index.PortalContainerContext.Provider,
+    _index.FutureFlagsProvider,
     {
-      value: portalContainer,
+      value: futureProp,
     },
     _react.createElement(
-      _index.HydrationProvider,
-      null,
+      _index.PortalContainerContext.Provider,
+      {
+        value: portalContainer,
+      },
       _react.createElement(
-        _ThemeContext.ThemeContext.Provider,
-        {
-          value: contextValue,
-        },
+        _index.HydrationProvider,
+        null,
         _react.createElement(
-          _Toaster.ToastProvider,
+          _ThemeContext.ThemeContext.Provider,
           {
-            inherit: 'inherit' === themeProp && !portalContainerProp,
+            value: themeContextValue,
           },
-          includeCss && rootElement
-            ? _react.createElement(FallbackStyles, {
-                root: rootElement,
-              })
-            : null,
           _react.createElement(
-            MainRoot,
+            _Toaster.ToastProvider,
             {
-              theme: theme,
-              themeOptions: themeOptions,
-              future: future,
-              ref: (0, _index.useMergedRefs)(
-                forwardedRef,
-                setRootElement,
-                useIuiDebugRef,
-              ),
-              ...rest,
+              inherit: 'inherit' === themeProp && !portalContainerProp,
             },
-            children,
-            _react.createElement(PortalContainer, {
-              theme: theme,
-              themeOptions: themeOptions,
-              future: future,
-              portalContainerProp: portalContainerProp,
-              portalContainerFromParent: portalContainerFromParent,
-              setPortalContainer: setPortalContainer,
-              isInheritingTheme: 'inherit' === themeProp,
-            }),
+            includeCss && rootElement
+              ? _react.createElement(FallbackStyles, {
+                  root: rootElement,
+                })
+              : null,
+            _react.createElement(
+              MainRoot,
+              {
+                theme: theme,
+                themeOptions: themeOptions,
+                ref: (0, _index.useMergedRefs)(
+                  forwardedRef,
+                  setRootElement,
+                  useIuiDebugRef,
+                ),
+                ...rest,
+              },
+              children,
+              _react.createElement(PortalContainer, {
+                theme: theme,
+                themeOptions: themeOptions,
+                portalContainerProp: portalContainerProp,
+                portalContainerFromParent: portalContainerFromParent,
+                setPortalContainer: setPortalContainer,
+                isInheritingTheme: 'inherit' === themeProp,
+              }),
+            ),
           ),
         ),
       ),
@@ -134,7 +135,7 @@ const MainRoot = _react.forwardRef((props, forwardedRef) => {
   );
 });
 const Root = _react.forwardRef((props, forwardedRef) => {
-  let { theme, children, themeOptions, className, future, ...rest } = props;
+  let { theme, children, themeOptions, className, ...rest } = props;
   let prefersDark = (0, _index.useMediaQuery)('(prefers-color-scheme: dark)');
   let prefersHighContrast = (0, _index.useMediaQuery)(
     '(prefers-contrast: more)',
@@ -142,6 +143,7 @@ const Root = _react.forwardRef((props, forwardedRef) => {
   let shouldApplyDark = 'dark' === theme || ('os' === theme && prefersDark);
   let shouldApplyHC = themeOptions?.highContrast ?? prefersHighContrast;
   let shouldApplyBackground = themeOptions?.applyBackground;
+  let themeBridge = (0, _index.useFutureFlag)('themeBridge');
   return _react.createElement(
     _index.Box,
     {
@@ -154,7 +156,7 @@ const Root = _react.forwardRef((props, forwardedRef) => {
       ),
       'data-iui-theme': shouldApplyDark ? 'dark' : 'light',
       'data-iui-contrast': shouldApplyHC ? 'high' : 'default',
-      'data-iui-bridge': future?.themeBridge ? true : void 0,
+      'data-iui-bridge': themeBridge ? 'true' : void 0,
       ref: forwardedRef,
       ...rest,
     },
@@ -205,7 +207,6 @@ const PortalContainer = _react.memo(
     isInheritingTheme,
     theme,
     themeOptions,
-    future,
   }) => {
     let ownerDocument = _react.useContext(OwnerDocumentContext);
     let shouldSetupPortalContainer =
@@ -237,7 +238,6 @@ const PortalContainer = _react.memo(
               ...themeOptions,
               applyBackground: false,
             },
-            future: future,
             'data-iui-portal': true,
             style: {
               display: 'contents',

package/cjs/core/Tile/Tile.d.ts

@@ -247,13 +247,13 @@ export declare const Tile: PolymorphicForwardRefComponent<"div", TileLegacyProps
     /**
      * `IconButton` subcomponent: custom icon for `QuickAction` and `TypeIndicator` buttons.
      */
-    IconButton: PolymorphicForwardRefComponent<"button", Omit<Omit<React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "label" | "title" | "as" | "size" | "htmlDisabled" | "styleType" | "labelProps" | "stretched" | "isActive" | "iconProps"> & {
+    IconButton: PolymorphicForwardRefComponent<"button", Omit<Omit<React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "label" | "title" | "as" | "size" | "htmlDisabled" | "styleType" | "labelProps" | "isActive" | "iconProps"> & {
         isActive?: boolean;
         label?: React.ReactNode;
         labelProps?: Omit<React.ComponentPropsWithoutRef<typeof import("../Tooltip/Tooltip.js").Tooltip>, "content" | "reference" | "ariaStrategy" | "children">;
         iconProps?: React.ComponentProps<"span">;
         title?: string;
-    } & Omit<import("../Buttons/Button.js").ButtonProps, "loading" | "startIcon" | "endIcon" | "labelProps" | "startIconProps" | "endIconProps"> & {
+    } & Omit<import("../Buttons/Button.js").ButtonProps, "loading" | "startIcon" | "endIcon" | "labelProps" | "startIconProps" | "endIconProps" | "stretched"> & {
         as?: "button" | undefined;
     }, "ref">>;
     /**