@itwin/itwinui-react 1.28.0 → 1.29.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [1.29.0](https://www.github.com/iTwin/iTwinUI-react/compare/v1.28.0...v1.29.0) (2022-01-11)
+
+### What's new
+
+* **Button:** Allow rendering as anchor element using `as` prop ([#409](https://www.github.com/iTwin/iTwinUI-react/issues/409)) ([9dfcef7](https://www.github.com/iTwin/iTwinUI-react/commit/9dfcef7ba1c2dc2a43b49fc8e40ef2dcbd89bd0b))
+* **Anchor:** Add new anchor component ([#501](https://www.github.com/iTwin/iTwinUI-react/issues/501)) ([684c18b](https://www.github.com/iTwin/iTwinUI-react/commit/684c18b313a3a7485a766b784d28a482e38e1a3d))
+* **useTheme:** Add event listener to respond to theme changes ([#491](https://www.github.com/iTwin/iTwinUI-react/issues/491)) ([b940ef0](https://www.github.com/iTwin/iTwinUI-react/commit/b940ef0eccc762e07c76bb46beb4a7e8de793d11))
+
 ## [1.28.0](https://www.github.com/iTwin/iTwinUI-react/compare/v1.27.0...v1.28.0) (2021-12-21)
 
 ### What's new

package/cjs/core/Breadcrumbs/Breadcrumbs.js

@@ -84,7 +84,7 @@ exports.Breadcrumbs = react_1.default.forwardRef(function (props, ref) {
                 react_1.default.createElement(Separator, null))),
             items.length - visibleCount > 0 && (react_1.default.createElement(react_1.default.Fragment, null,
                 react_1.default.createElement("li", { className: 'iui-breadcrumbs-item' },
-                    react_1.default.createElement("span", { className: 'iui-ellipsis' }, "\u2026")),
+                    react_1.default.createElement("span", null, "\u2026")),
                 react_1.default.createElement(Separator, null))),
             items
                 .slice(visibleCount > 1

package/cjs/core/Buttons/Button/Button.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
+import { PolymorphicComponentProps, PolymorphicForwardRefComponent } from '../../utils';
 import '@itwin/itwinui-css/css/button.css';
-export declare type ButtonProps = {
+declare type ButtonOwnProps = {
     /**
      * Modify size of the button.
      */
@@ -23,7 +24,9 @@ export declare type ButtonProps = {
      * Content of the button.
      */
     children?: React.ReactNode;
-} & React.ButtonHTMLAttributes<HTMLButtonElement>;
+};
+export declare type ButtonProps<T extends React.ElementType = 'button'> = PolymorphicComponentProps<T, ButtonOwnProps>;
+declare type ButtonComponent = PolymorphicForwardRefComponent<'button', ButtonOwnProps>;
 /**
  * Generic button component
  * @example
@@ -33,28 +36,5 @@ export declare type ButtonProps = {
  * <Button size='small' styleType='cta'>This is a small call to action button</Button>
  * <Button startIcon={<SvgAdd />}>New</Button>
  */
-export declare const Button: React.ForwardRefExoticComponent<{
-    /**
-     * Modify size of the button.
-     */
-    size?: "small" | "large" | undefined;
-    /**
-     * Style of the button.
-     * Use 'borderless' to hide outline.
-     * @default 'default'
-     */
-    styleType?: "default" | "cta" | "high-visibility" | "borderless" | undefined;
-    /**
-     * Icon shown before the main button content.
-     */
-    startIcon?: JSX.Element | undefined;
-    /**
-     * Icon shown after the main button content.
-     */
-    endIcon?: JSX.Element | undefined;
-    /**
-     * Content of the button.
-     */
-    children?: React.ReactNode;
-} & React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export declare const Button: ButtonComponent;
 export default Button;

package/cjs/core/Buttons/Button/Button.js

@@ -45,9 +45,9 @@ require("@itwin/itwinui-css/css/button.css");
  */
 exports.Button = react_1.default.forwardRef(function (props, ref) {
     var _a;
-    var children = props.children, className = props.className, size = props.size, style = props.style, _b = props.styleType, styleType = _b === void 0 ? 'default' : _b, _c = props.type, type = _c === void 0 ? 'button' : _c, startIcon = props.startIcon, endIcon = props.endIcon, rest = __rest(props, ["children", "className", "size", "style", "styleType", "type", "startIcon", "endIcon"]);
+    var children = props.children, className = props.className, size = props.size, style = props.style, _b = props.styleType, styleType = _b === void 0 ? 'default' : _b, _c = props.type, type = _c === void 0 ? 'button' : _c, startIcon = props.startIcon, endIcon = props.endIcon, _d = props.as, Element = _d === void 0 ? 'button' : _d, rest = __rest(props, ["children", "className", "size", "style", "styleType", "type", "startIcon", "endIcon", "as"]);
     (0, utils_1.useTheme)();
-    return (react_1.default.createElement("button", __assign({ ref: ref, className: (0, classnames_1.default)('iui-button', "iui-" + styleType, (_a = {},
+    return (react_1.default.createElement(Element, __assign({ ref: ref, className: (0, classnames_1.default)('iui-button', "iui-" + styleType, (_a = {},
             _a["iui-" + size] = !!size,
             _a), className), style: style, type: type }, rest),
         startIcon &&

package/cjs/core/Buttons/DropdownButton/DropdownButton.d.ts

@@ -37,5 +37,5 @@ export declare const DropdownButton: React.ForwardRefExoticComponent<{
      * @default 'default'
      */
     styleType?: "default" | "borderless" | undefined;
-} & Omit<ButtonProps, "styleType" | "endIcon" | "onClick"> & React.RefAttributes<HTMLButtonElement>>;
+} & Omit<ButtonProps<"button">, "onClick" | "styleType" | "endIcon"> & React.RefAttributes<HTMLButtonElement>>;
 export default DropdownButton;

package/cjs/core/Buttons/IconButton/IconButton.d.ts

@@ -1,5 +1,5 @@
-import React from 'react';
 import { ButtonProps } from '../Button';
+import { PolymorphicForwardRefComponent } from '../../utils';
 import '@itwin/itwinui-css/css/button.css';
 export declare type IconButtonProps = {
     /**
@@ -8,17 +8,12 @@ export declare type IconButtonProps = {
      */
     isActive?: boolean;
 } & Omit<ButtonProps, 'startIcon' | 'endIcon'>;
+declare type IconButtonComponent = PolymorphicForwardRefComponent<'button', IconButtonProps>;
 /**
  * Icon button
  * @example
  * <IconButton><SvgAdd /></IconButton>
  * <IconButton styleType='borderless'><SvgAdd /></IconButton>
  */
-export declare const IconButton: React.ForwardRefExoticComponent<{
-    /**
-     * Button gets active style.
-     * @default false
-     */
-    isActive?: boolean | undefined;
-} & Omit<ButtonProps, "startIcon" | "endIcon"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const IconButton: IconButtonComponent;
 export default IconButton;

package/cjs/core/Buttons/IconButton/IconButton.js

@@ -42,9 +42,9 @@ require("@itwin/itwinui-css/css/button.css");
  */
 exports.IconButton = react_1.default.forwardRef(function (props, ref) {
     var _a;
-    var isActive = props.isActive, children = props.children, _b = props.styleType, styleType = _b === void 0 ? 'default' : _b, size = props.size, _c = props.type, type = _c === void 0 ? 'button' : _c, className = props.className, rest = __rest(props, ["isActive", "children", "styleType", "size", "type", "className"]);
+    var isActive = props.isActive, children = props.children, _b = props.styleType, styleType = _b === void 0 ? 'default' : _b, size = props.size, _c = props.type, type = _c === void 0 ? 'button' : _c, className = props.className, _d = props.as, Element = _d === void 0 ? 'button' : _d, rest = __rest(props, ["isActive", "children", "styleType", "size", "type", "className", "as"]);
     (0, utils_1.useTheme)();
-    return (react_1.default.createElement("button", __assign({ ref: ref, className: (0, classnames_1.default)('iui-button', "iui-" + styleType, (_a = {},
+    return (react_1.default.createElement(Element, __assign({ ref: ref, className: (0, classnames_1.default)('iui-button', "iui-" + styleType, (_a = {},
             _a["iui-" + size] = !!size,
             _a['iui-active'] = isActive,
             _a), className), type: type }, rest), react_1.default.cloneElement(children, {

package/cjs/core/Buttons/SplitButton/SplitButton.d.ts

@@ -1,12 +1,9 @@
 import React from 'react';
 import { ButtonProps } from '../Button';
 import { Placement } from 'tippy.js';
+import { PolymorphicForwardRefComponent } from '../../utils';
 import '@itwin/itwinui-css/css/button.css';
-export declare type SplitButtonProps = {
-    /**
-     * Callback fired on clicking the primary button.
-     */
-    onClick: React.MouseEventHandler<HTMLButtonElement>;
+export declare type SplitButtonProps = ButtonProps & {
     /**
      * Items in the dropdown menu.
      * Pass a function that takes the `close` argument (to close the menu),
@@ -22,9 +19,14 @@ export declare type SplitButtonProps = {
      * Content of primary button.
      */
     children: React.ReactNode;
-} & Omit<ButtonProps, 'onClick'>;
+};
+declare type SplitButtonComponent = PolymorphicForwardRefComponent<'button', SplitButtonProps>;
 /**
  * Split button component with a DropdownMenu.
+ *
+ * The delegated props and forwarded ref are passed onto the primary button.
+ * It also supports using the `as` prop to change which element is rendered.
+ *
  * @example
  * const menuItems = (close: () => void) => [
  *   <MenuItem key={1} onClick={onClick(1, close)}>Item #1</MenuItem>,
@@ -33,5 +35,5 @@ export declare type SplitButtonProps = {
  * <SplitButton onClick={onClick} menuItems={menuItems}>Default</SplitButton>
  * <SplitButton onClick={onClick} menuItems={menuItems} styleType='high-visibility'>High visibility</SplitButton>
  */
-export declare const SplitButton: (props: SplitButtonProps) => JSX.Element;
+export declare const SplitButton: SplitButtonComponent;
 export default SplitButton;

package/cjs/core/Buttons/SplitButton/SplitButton.js

@@ -41,6 +41,10 @@ var utils_1 = require("../../utils");
 require("@itwin/itwinui-css/css/button.css");
 /**
  * Split button component with a DropdownMenu.
+ *
+ * The delegated props and forwarded ref are passed onto the primary button.
+ * It also supports using the `as` prop to change which element is rendered.
+ *
  * @example
  * const menuItems = (close: () => void) => [
  *   <MenuItem key={1} onClick={onClick(1, close)}>Item #1</MenuItem>,
@@ -49,7 +53,7 @@ require("@itwin/itwinui-css/css/button.css");
  * <SplitButton onClick={onClick} menuItems={menuItems}>Default</SplitButton>
  * <SplitButton onClick={onClick} menuItems={menuItems} styleType='high-visibility'>High visibility</SplitButton>
  */
-var SplitButton = function (props) {
+exports.SplitButton = react_1.default.forwardRef(function (props, forwardedRef) {
     var onClick = props.onClick, menuItems = props.menuItems, className = props.className, _a = props.menuPlacement, menuPlacement = _a === void 0 ? 'bottom-end' : _a, _b = props.styleType, styleType = _b === void 0 ? 'default' : _b, size = props.size, children = props.children, style = props.style, title = props.title, rest = __rest(props, ["onClick", "menuItems", "className", "menuPlacement", "styleType", "size", "children", "style", "title"]);
     (0, utils_1.useTheme)();
     var _c = react_1.default.useState(false), isMenuOpen = _c[0], setIsMenuOpen = _c[1];
@@ -64,10 +68,9 @@ var SplitButton = function (props) {
             'iui-disabled': props.disabled,
         }), style: style, title: title, ref: ref },
         react_1.default.createElement("div", null,
-            react_1.default.createElement(Button_1.Button, __assign({ styleType: styleType, size: size, onClick: onClick }, rest), children)),
+            react_1.default.createElement(Button_1.Button, __assign({ styleType: styleType, size: size, onClick: onClick, ref: forwardedRef }, rest), children)),
         react_1.default.createElement("div", null,
             react_1.default.createElement(DropdownMenu_1.DropdownMenu, { placement: menuPlacement, menuItems: menuItems, style: { minWidth: menuWidth }, onShow: react_1.default.useCallback(function () { return setIsMenuOpen(true); }, []), onHide: react_1.default.useCallback(function () { return setIsMenuOpen(false); }, []) },
                 react_1.default.createElement(IconButton_1.IconButton, { styleType: styleType, size: size, disabled: props.disabled }, isMenuOpen ? react_1.default.createElement(CaretUpSmall_1.default, null) : react_1.default.createElement(CaretDownSmall_1.default, null))))));
-};
-exports.SplitButton = SplitButton;
+});
 exports.default = exports.SplitButton;

package/cjs/core/Checkbox/Checkbox.js

@@ -66,8 +66,8 @@ exports.Checkbox = react_1.default.forwardRef(function (props, ref) {
         }
     });
     var defaultCheckbox = (react_1.default.createElement("svg", { viewBox: '0 0 16 16', "aria-hidden": 'true', focusable: 'false' },
-        react_1.default.createElement("path", { className: 'iui-check', d: 'M6,14L0,8l2-2l4,4l8-8l2,2L6,14z' }),
-        react_1.default.createElement("path", { className: 'iui-check-partial', d: 'm1 6.5h14v3h-14z' })));
+        react_1.default.createElement("path", { className: 'iui-check', d: 'm6.5 12.5-4.5-4.5 1.5-1.5 3 3 6-6 1.5 1.5z' }),
+        react_1.default.createElement("path", { className: 'iui-check-partial', d: 'm2.75 6.875h10.5v2.25h-10.5z' })));
     var visibilityCheckbox = (react_1.default.createElement("svg", { viewBox: '0 0 16 16', "aria-hidden": 'true', focusable: 'false' },
         react_1.default.createElement("path", { className: 'iui-check', d: 'm8 2.99051a8.81883 8.81883 0 0 0 -8 4.95062 8.74664 8.74664 0 0 0 8 5.06836 8.63266 8.63266 0 0 0 8-5.06836 8.83631 8.83631 0 0 0 -8-4.95062zm-1.31445 1.86981a1.47663 1.47663 0 1 1 -1.47663 1.47668 1.47665 1.47665 0 0 1 1.47663-1.47668zm1.31445 6.64917a7.17486 7.17486 0 0 1 -6.30475-3.55237 7.4952 7.4952 0 0 1 2.81475-2.6336 3.83956 3.83956 0 1 0 6.98126.00244 7.522 7.522 0 0 1 2.81774 2.63916 7.09785 7.09785 0 0 1 -6.309 3.54437z' }),
         react_1.default.createElement("g", { className: 'iui-check-partial' },

package/cjs/core/ColorPicker/ColorInputPanel.js

@@ -36,6 +36,7 @@ var Buttons_1 = require("../Buttons");
 var Input_1 = require("../Input");
 var utils_1 = require("../utils");
 var ColorPickerContext_1 = require("./ColorPickerContext");
+var Swap_1 = __importDefault(require("@itwin/itwinui-icons-react/cjs/icons/Swap"));
 require("@itwin/itwinui-css/css/color-picker.css");
 /**
  * `ColorInputPanel` shows input fields to enter precise color values in the specified format.
@@ -302,8 +303,7 @@ exports.ColorInputPanel = react_1.default.forwardRef(function (props, ref) {
             : currentFormat.toUpperCase()),
         react_1.default.createElement("div", { className: 'iui-color-input' },
             allowedColorFormats.length > 1 && (react_1.default.createElement(Buttons_1.IconButton, { styleType: 'borderless', onClick: swapColorFormat, size: 'small' },
-                react_1.default.createElement("svg", { viewBox: '0 0 16 16', className: 'iui-icon', "aria-hidden": true },
-                    react_1.default.createElement("path", { d: 'm5 15-3.78125-3.5 3.78125-3.5v2h8v3h-8zm6-7 3.78125-3.5-3.78125-3.5v2h-8v3h8z' })))),
+                react_1.default.createElement(Swap_1.default, null))),
             react_1.default.createElement("div", { ref: inputsContainerRef, className: 'iui-color-input-fields' },
                 currentFormat === 'hex' && hexInputField,
                 currentFormat === 'rgb' && rgbInputs,

package/cjs/core/ColorPicker/ColorSwatch.d.ts

@@ -17,5 +17,5 @@ export declare type ColorSwatchProps = {
  * <ColorSwatch color='#23450b' onClick={onClick}/>
  * <ColorSwatch color={{ r: 255, g: 255, b: 0 }} onClick={onClick}/>
  */
-export declare const ColorSwatch: React.ForwardRefExoticComponent<Pick<ColorSwatchProps, "dir" | "slot" | "style" | "title" | "id" | "role" | "children" | "className" | "accessKey" | "draggable" | "hidden" | "lang" | "translate" | "prefix" | "contentEditable" | "inputMode" | "tabIndex" | "onFocus" | "color" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "contextMenu" | "placeholder" | "spellCheck" | "radioGroup" | "about" | "datatype" | "inlist" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "isActive" | "key"> & React.RefAttributes<HTMLDivElement>>;
+export declare const ColorSwatch: React.ForwardRefExoticComponent<Pick<ColorSwatchProps, "dir" | "slot" | "style" | "title" | "id" | "role" | "children" | "className" | "accessKey" | "draggable" | "hidden" | "lang" | "translate" | "prefix" | "contentEditable" | "inputMode" | "tabIndex" | "onFocus" | "color" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "contextMenu" | "placeholder" | "spellCheck" | "radioGroup" | "about" | "datatype" | "inlist" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "is" | "isActive"> & React.RefAttributes<HTMLDivElement>>;
 export default ColorSwatch;

package/cjs/core/DatePicker/DatePicker.js

@@ -254,22 +254,21 @@ var DatePicker = function (props) {
         }
     };
     return (react_1.default.createElement("div", __assign({ className: (0, classnames_1.default)('iui-date-picker', className), style: style }, rest),
-        react_1.default.createElement("div", { className: 'iui-calendar' },
-            react_1.default.createElement("div", { className: 'iui-header' },
-                react_1.default.createElement("div", { className: 'iui-month-year' },
-                    react_1.default.createElement(IconButton_1.IconButton, { styleType: 'borderless', onClick: handleMoveToPreviousMonth, "aria-label": 'Previous month' },
-                        react_1.default.createElement(ChevronLeft_1.default, null)),
-                    react_1.default.createElement("span", { "aria-live": 'polite' },
-                        react_1.default.createElement("span", { className: 'iui-month', title: monthNames[displayedMonthIndex] }, monthNames[displayedMonthIndex]),
-                        "\u00A0",
-                        displayedYear),
-                    react_1.default.createElement(IconButton_1.IconButton, { styleType: 'borderless', onClick: handleMoveToNextMonth, "aria-label": 'Next month' },
-                        react_1.default.createElement(ChevronRight_1.default, null))),
-                react_1.default.createElement("div", { className: 'iui-weekdays' }, shortDays.map(function (day, index) { return (react_1.default.createElement("div", { key: day, title: longDays[index] }, day)); }))),
-            react_1.default.createElement("div", { className: 'iui-dates', onKeyDown: handleCalendarKeyDown, role: 'listbox' }, weeks.map(function (weekDays, weekIndex) {
-                return (react_1.default.createElement("div", { key: "week-" + displayedMonthIndex + "-" + weekIndex, className: 'iui-week' }, weekDays.map(function (weekDay, dayIndex) {
+        react_1.default.createElement("div", null,
+            react_1.default.createElement("div", { className: 'iui-calendar-month-year' },
+                react_1.default.createElement(IconButton_1.IconButton, { styleType: 'borderless', onClick: handleMoveToPreviousMonth, "aria-label": 'Previous month' },
+                    react_1.default.createElement(ChevronLeft_1.default, null)),
+                react_1.default.createElement("span", { "aria-live": 'polite' },
+                    react_1.default.createElement("span", { className: 'iui-calendar-month', title: monthNames[displayedMonthIndex] }, monthNames[displayedMonthIndex]),
+                    "\u00A0",
+                    displayedYear),
+                react_1.default.createElement(IconButton_1.IconButton, { styleType: 'borderless', onClick: handleMoveToNextMonth, "aria-label": 'Next month' },
+                    react_1.default.createElement(ChevronRight_1.default, null))),
+            react_1.default.createElement("div", { className: 'iui-calendar-weekdays' }, shortDays.map(function (day, index) { return (react_1.default.createElement("div", { key: day, title: longDays[index] }, day)); })),
+            react_1.default.createElement("div", { onKeyDown: handleCalendarKeyDown, role: 'listbox' }, weeks.map(function (weekDays, weekIndex) {
+                return (react_1.default.createElement("div", { key: "week-" + displayedMonthIndex + "-" + weekIndex, className: 'iui-calendar-week' }, weekDays.map(function (weekDay, dayIndex) {
                     var dateValue = weekDay.getDate();
-                    return (react_1.default.createElement("div", { key: "day-" + displayedMonthIndex + "-" + dayIndex, className: (0, classnames_1.default)('iui-date', {
+                    return (react_1.default.createElement("div", { key: "day-" + displayedMonthIndex + "-" + dayIndex, className: (0, classnames_1.default)('iui-calendar-day', {
                             'iui-outside-month': weekDay.getMonth() !== displayedMonthIndex,
                             'iui-today': isSameDay(weekDay, new Date()),
                             'iui-selected': isSameDay(weekDay, selectedDay),

package/cjs/core/Header/HeaderButton.d.ts

@@ -1,13 +1,14 @@
 import React from 'react';
 import { ButtonProps, DropdownButtonProps } from '../Buttons';
+import { PolymorphicForwardRefComponent } from '../utils';
 import '@itwin/itwinui-css/css/header.css';
 export declare type HeaderButtonProps = {
     /**
-     * Name.
+     * Main label of the header button.
      */
     name: React.ReactNode;
     /**
-     * Description shown below the name, will be hidden in `Header` slim mode.
+     * Description shown below the main label, will be hidden in `Header` slim mode.
      */
     description?: React.ReactNode;
     /**
@@ -15,7 +16,8 @@ export declare type HeaderButtonProps = {
      * @default false
      */
     isActive?: boolean;
-} & Omit<Partial<DropdownButtonProps> & Partial<ButtonProps>, 'children' | 'styleType' | 'name'>;
+} & Partial<Pick<DropdownButtonProps, 'menuItems'>> & Pick<ButtonProps, 'startIcon' | 'endIcon'>;
+declare type HeaderButtonComponent = PolymorphicForwardRefComponent<'button', HeaderButtonProps>;
 /**
  * Header button that handles slim state of the `Header` it's in.
  * When in slim mode, will only display the name and reduce icon size.
@@ -26,5 +28,5 @@ export declare type HeaderButtonProps = {
  * <HeaderButton name='Project C' startIcon={<img style={{ objectFit: 'cover' }} src='project.png' />} />
  * <HeaderButton name='Project D' isActive />
  */
-export declare const HeaderButton: (props: HeaderButtonProps) => JSX.Element;
+export declare const HeaderButton: HeaderButtonComponent;
 export default HeaderButton;

package/cjs/core/Header/HeaderButton.js

@@ -51,7 +51,7 @@ var isDropdownButton = function (props) {
  * <HeaderButton name='Project C' startIcon={<img style={{ objectFit: 'cover' }} src='project.png' />} />
  * <HeaderButton name='Project D' isActive />
  */
-var HeaderButton = function (props) {
+exports.HeaderButton = react_1.default.forwardRef(function (props, ref) {
     var name = props.name, description = props.description, _a = props.isActive, isActive = _a === void 0 ? false : _a, className = props.className, startIcon = props.startIcon, menuItems = props.menuItems, rest = __rest(props, ["name", "description", "isActive", "className", "startIcon", "menuItems"]);
     (0, utils_1.useTheme)();
     var buttonProps = __assign(__assign({ startIcon: react_1.default.isValidElement(startIcon)
@@ -64,7 +64,7 @@ var HeaderButton = function (props) {
             'iui-active': isActive,
         }, className), 'aria-current': isActive ? 'location' : undefined, children: (react_1.default.createElement(react_1.default.Fragment, null,
             react_1.default.createElement("div", null, name),
-            description && react_1.default.createElement("div", { className: 'iui-description' }, description))) }, (!!menuItems && { menuItems: menuItems })), rest);
+            description && react_1.default.createElement("div", { className: 'iui-description' }, description))), ref: ref }, (!!menuItems && { menuItems: menuItems })), rest);
     if (isSplitButton(buttonProps)) {
         return react_1.default.createElement(Buttons_1.SplitButton, __assign({}, buttonProps));
     }
@@ -72,6 +72,5 @@ var HeaderButton = function (props) {
         return react_1.default.createElement(Buttons_1.DropdownButton, __assign({}, buttonProps));
     }
     return react_1.default.createElement(Buttons_1.Button, __assign({}, buttonProps));
-};
-exports.HeaderButton = HeaderButton;
+});
 exports.default = exports.HeaderButton;

package/cjs/core/LabeledInput/LabeledInput.d.ts

@@ -84,7 +84,7 @@ export declare const LabeledInput: React.ForwardRefExoticComponent<{
      * - 'inline' - appears in the same line as input.
      * @default 'default'
      */
-    displayStyle?: "inline" | "default" | undefined;
+    displayStyle?: "default" | "inline" | undefined;
     /**
      * Set display style of icon.
      * Supported values:

package/cjs/core/SideNavigation/SidenavButton.d.ts

@@ -1,4 +1,4 @@
-import React from 'react';
+import { PolymorphicForwardRefComponent } from '../utils';
 import { ButtonProps } from '../Buttons';
 import '@itwin/itwinui-css/css/side-navigation.css';
 export declare type SidenavButtonProps = {
@@ -13,20 +13,10 @@ export declare type SidenavButtonProps = {
      */
     isSubmenuOpen?: boolean;
 } & Omit<ButtonProps, 'styleType' | 'size'>;
+declare type SideNavButtonComponent = PolymorphicForwardRefComponent<'button', SidenavButtonProps>;
 /**
  * Wrapper around Button to be used as SideNavigation items.
  * Label is hidden when sidenav is collapsed.
  */
-export declare const SidenavButton: React.ForwardRefExoticComponent<{
-    /**
-     * Whether the sidenav button is active,
-     * i.e. the current page corresponds to this button.
-     */
-    isActive?: boolean | undefined;
-    /**
-     * Whether the sidenav button only has submenu open,
-     * i.e. submenu is open but the current page does not correspond to this button.
-     */
-    isSubmenuOpen?: boolean | undefined;
-} & Omit<ButtonProps, "size" | "styleType"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const SidenavButton: SideNavButtonComponent;
 export default SidenavButton;

package/cjs/core/Table/TablePaginator.js

@@ -35,7 +35,6 @@ var classnames_1 = __importDefault(require("classnames"));
 require("@itwin/itwinui-css/css/table.css");
 var ChevronLeft_1 = __importDefault(require("@itwin/itwinui-icons-react/cjs/icons/ChevronLeft"));
 var ChevronRight_1 = __importDefault(require("@itwin/itwinui-icons-react/cjs/icons/ChevronRight"));
-var ButtonGroup_1 = require("../ButtonGroup");
 var Buttons_1 = require("../Buttons");
 var ProgressIndicators_1 = require("../ProgressIndicators");
 var Menu_1 = require("../Menu");
@@ -77,7 +76,7 @@ var TablePaginator = function (props) {
         // Checking `isMounted.current` prevents from focusing on initial load.
         // Checking `needFocus.current` prevents from focusing page when clicked on previous/next page.
         if (isMounted.current && needFocus.current) {
-            var buttonToFocus = Array.from((_b = (_a = pageListRef.current) === null || _a === void 0 ? void 0 : _a.querySelectorAll('.iui-button')) !== null && _b !== void 0 ? _b : []).find(function (el) { var _a; return ((_a = el.textContent) === null || _a === void 0 ? void 0 : _a.trim()) === (focusedIndex + 1).toString(); });
+            var buttonToFocus = Array.from((_b = (_a = pageListRef.current) === null || _a === void 0 ? void 0 : _a.querySelectorAll('.iui-paginator-page-button')) !== null && _b !== void 0 ? _b : []).find(function (el) { var _a; return ((_a = el.textContent) === null || _a === void 0 ? void 0 : _a.trim()) === (focusedIndex + 1).toString(); });
             (_c = buttonToFocus) === null || _c === void 0 ? void 0 : _c.focus();
             needFocus.current = false;
         }
@@ -86,7 +85,11 @@ var TablePaginator = function (props) {
     var buttonSize = size != 'default' ? 'small' : undefined;
     var pageButton = react_1.default.useCallback(function (index, tabIndex) {
         if (tabIndex === void 0) { tabIndex = index === focusedIndex ? 0 : -1; }
-        return (react_1.default.createElement(Buttons_1.Button, { key: index, styleType: 'borderless', className: (0, classnames_1.default)({ 'iui-active': index === currentPage }), onClick: function () { return onPageChange(index); }, "aria-current": index === currentPage, "aria-label": localization.goToPageLabel(index + 1), tabIndex: tabIndex, size: buttonSize }, index + 1));
+        return (react_1.default.createElement("div", { key: index },
+            react_1.default.createElement("button", { className: (0, classnames_1.default)('iui-paginator-page-button', {
+                    'iui-active': index === currentPage,
+                    'iui-paginator-page-button-small': buttonSize === 'small',
+                }), onClick: function () { return onPageChange(index); }, "aria-current": index === currentPage, "aria-label": localization.goToPageLabel(index + 1), tabIndex: tabIndex }, index + 1)));
     }, [focusedIndex, currentPage, localization, buttonSize, onPageChange]);
     var totalPagesCount = Math.ceil(totalRowsCount / pageSize);
     var pageList = react_1.default.useMemo(function () {
@@ -148,7 +151,10 @@ var TablePaginator = function (props) {
     var hasNoRows = totalPagesCount === 0;
     var showPagesList = totalPagesCount > 1 || isLoading;
     var showPageSizeList = pageSizeList && onPageSizeChange && !!totalRowsCount;
-    var ellipsis = (react_1.default.createElement("span", { className: (0, classnames_1.default)('iui-ellipsis', { 'iui-small': size === 'small' }) }, "\u2026"));
+    var ellipsis = (react_1.default.createElement("div", null,
+        react_1.default.createElement("span", { className: (0, classnames_1.default)('iui-paginator-ellipsis', {
+                'iui-paginator-ellipsis-small': size === 'small',
+            }) }, "\u2026")));
     var noRowsContent = (react_1.default.createElement(react_1.default.Fragment, null, isLoading ? (react_1.default.createElement(ProgressIndicators_1.ProgressRadial, { indeterminate: true, size: 'small' })) : (react_1.default.createElement(Buttons_1.Button, { styleType: 'borderless', disabled: true, size: buttonSize }, "1"))));
     if (!showPagesList && !showPageSizeList) {
         return null;
@@ -158,7 +164,7 @@ var TablePaginator = function (props) {
         showPagesList && (react_1.default.createElement("div", { className: 'iui-center', ref: overflowRef },
             react_1.default.createElement(Buttons_1.IconButton, { styleType: 'borderless', disabled: currentPage === 0, onClick: function () { return onPageChange(currentPage - 1); }, size: buttonSize, "aria-label": localization.previousPage },
                 react_1.default.createElement(ChevronLeft_1.default, null)),
-            react_1.default.createElement(ButtonGroup_1.ButtonGroup, { onKeyDown: onKeyDown, ref: pageListRef }, (function () {
+            react_1.default.createElement("span", { className: 'iui-paginator-pages-group', onKeyDown: onKeyDown, ref: pageListRef }, (function () {
                 if (hasNoRows) {
                     return noRowsContent;
                 }

package/cjs/core/Typography/Anchor/Anchor.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+export declare const Anchor: React.ForwardRefExoticComponent<Pick<React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "key" | keyof React.AnchorHTMLAttributes<HTMLAnchorElement>> & React.RefAttributes<HTMLAnchorElement>>;
+export default Anchor;

package/cjs/core/Typography/Anchor/Anchor.js

@@ -0,0 +1,41 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Anchor = void 0;
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+var react_1 = __importDefault(require("react"));
+var classnames_1 = __importDefault(require("classnames"));
+var utils_1 = require("../../utils");
+exports.Anchor = react_1.default.forwardRef(function (_a, ref) {
+    var className = _a.className, rest = __rest(_a, ["className"]);
+    (0, utils_1.useTheme)();
+    return react_1.default.createElement("a", __assign({ className: (0, classnames_1.default)('iui-anchor', className), ref: ref }, rest));
+});
+exports.default = exports.Anchor;

package/cjs/core/Typography/Anchor/index.d.ts

@@ -0,0 +1,3 @@
+export { Anchor } from './Anchor';
+declare const _default: "./Anchor";
+export default _default;

package/cjs/core/Typography/Anchor/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Anchor = void 0;
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+var Anchor_1 = require("./Anchor");
+Object.defineProperty(exports, "Anchor", { enumerable: true, get: function () { return Anchor_1.Anchor; } });
+exports.default = './Anchor';

package/cjs/core/Typography/Text/Text.d.ts

@@ -1,12 +1,7 @@
 import React from 'react';
-import { CommonProps } from '../../utils';
+import { PolymorphicComponentProps, PolymorphicForwardRefComponent } from '../../utils';
 import '@itwin/itwinui-css/css/text.css';
-declare type TextOwnProps<T extends React.ElementType | React.ComponentType = 'div'> = {
-    /**
-     * What element should the text be rendered as?
-     * @default 'div'
-     */
-    as?: T;
+declare type TextOwnProps = {
     /**
      * Which typography variant/size should be used for the styling?
      *
@@ -30,8 +25,9 @@ declare type TextOwnProps<T extends React.ElementType | React.ComponentType = 'd
      * @default false
      */
     isSkeleton?: boolean;
-} & CommonProps;
-export declare type TextProps<T extends React.ElementType | React.ComponentType = 'div'> = TextOwnProps<T> & Omit<React.ComponentPropsWithoutRef<T>, keyof TextOwnProps<T>>;
+};
+export declare type TextProps<T extends React.ElementType = 'div'> = PolymorphicComponentProps<T, TextOwnProps>;
+declare type TextComponent = PolymorphicForwardRefComponent<'div', TextOwnProps>;
 /**
  * Polymorphic typography component to render any kind of text as any kind of element.
  * @example
@@ -42,5 +38,5 @@ export declare type TextProps<T extends React.ElementType | React.ComponentType
  * <Text isMuted>Some muted text.</Text>
  * <Text isSkeleton>Skeleton text</Text>
  */
-export declare const Text: <T extends React.ElementType<any> | React.ComponentType<{}> = "div">(props: TextProps<T>) => JSX.Element;
+export declare const Text: TextComponent;
 export default Text;

package/cjs/core/Typography/Text/Text.js

@@ -44,7 +44,7 @@ require("@itwin/itwinui-css/css/text.css");
  * <Text isMuted>Some muted text.</Text>
  * <Text isSkeleton>Skeleton text</Text>
  */
-var Text = function (props) {
+exports.Text = react_1.default.forwardRef(function (props, ref) {
     var _a;
     var _b = props.variant, variant = _b === void 0 ? 'body' : _b, _c = props.as, Element = _c === void 0 ? 'div' : _c, className = props.className, _d = props.isMuted, isMuted = _d === void 0 ? false : _d, _e = props.isSkeleton, isSkeleton = _e === void 0 ? false : _e, rest = __rest(props, ["variant", "as", "className", "isMuted", "isSkeleton"]);
     (0, utils_1.useTheme)();
@@ -53,7 +53,6 @@ var Text = function (props) {
             _a['iui-text-block'] = variant === 'body',
             _a['iui-text-muted'] = isMuted,
             _a['iui-skeleton'] = isSkeleton,
-            _a), className) }, rest)));
-};
-exports.Text = Text;
+            _a), className), ref: ref }, rest)));
+});
 exports.default = exports.Text;

package/cjs/core/Typography/index.d.ts

@@ -1,3 +1,4 @@
+export { Anchor } from './Anchor';
 export { Headline } from './Headline';
 export type { HeadlineProps } from './Headline';
 export { Title } from './Title';