@itwin/itwinui-react 3.0.0-dev.0 → 3.0.0-dev.10

package/esm/core/utils/components/WithCSSTransition.js

@@ -5,28 +5,45 @@
 import * as React from 'react';
 import { CSSTransition } from 'react-transition-group';
 export const WithCSSTransition = (props) => {
-    const { in: visible, dimension = 'height', children, ...rest } = props;
-    const expandedSize = React.useRef(0);
-    const dimensionCamelCase = dimension === 'height' ? 'Height' : 'Width';
-    return (React.createElement(CSSTransition, { in: visible, timeout: 200, unmountOnExit: true, onEnter: (node) => {
-            node.style[`min${dimensionCamelCase}`] = 'initial';
-            node.style[dimension] = '0px';
-        }, onEntering: (node) => {
-            node.style[dimension] = `${expandedSize.current}px`;
-        }, onEntered: (node) => {
-            node.style[`min${dimensionCamelCase}`] = '';
-            node.style[dimension] = '';
-        }, onExit: (node) => {
-            node.style[dimension] = `${expandedSize.current}px`;
-        }, onExiting: (node) => {
-            node.style[`min${dimensionCamelCase}`] = 'initial';
-            node.style[dimension] = '0px';
-        }, classNames: 'iui', ...rest }, React.cloneElement(children, {
-        ref: (el) => {
+  const { in: visible, dimension = 'height', children, ...rest } = props;
+  const expandedSize = React.useRef(0);
+  const dimensionCamelCase = dimension === 'height' ? 'Height' : 'Width';
+  return React.createElement(
+    CSSTransition,
+    {
+      in: visible,
+      timeout: 200,
+      unmountOnExit: true,
+      onEnter: (node) => {
+        node.style[`min${dimensionCamelCase}`] = 'initial';
+        node.style[dimension] = '0px';
+      },
+      onEntering: (node) => {
+        node.style[dimension] = `${expandedSize.current}px`;
+      },
+      onEntered: (node) => {
+        node.style[`min${dimensionCamelCase}`] = '';
+        node.style[dimension] = '';
+      },
+      onExit: (node) => {
+        node.style[dimension] = `${expandedSize.current}px`;
+      },
+      onExiting: (node) => {
+        node.style[`min${dimensionCamelCase}`] = 'initial';
+        node.style[dimension] = '0px';
+      },
+      classNames: 'iui',
+      ...rest,
+    },
+    React.isValidElement(children)
+      ? React.cloneElement(children, {
+          ref: (el) => {
             if (el) {
-                expandedSize.current = el.getBoundingClientRect()[dimension];
+              expandedSize.current = el.getBoundingClientRect()[dimension];
             }
-        },
-    })));
+          },
+        })
+      : React.createElement(React.Fragment, null),
+  );
 };
 export default WithCSSTransition;

package/esm/core/utils/components/index.d.ts

@@ -13,3 +13,5 @@ export * from './Divider.js';
 export * from './LinkAction.js';
 export * from './AutoclearingHiddenLiveRegion.js';
 export * from './Box.js';
+export * from './ButtonBase.js';
+export * from './Portal.js';

package/esm/core/utils/components/index.js

@@ -17,3 +17,5 @@ export * from './Divider.js';
 export * from './LinkAction.js';
 export * from './AutoclearingHiddenLiveRegion.js';
 export * from './Box.js';
+export * from './ButtonBase.js';
+export * from './Portal.js';

package/esm/core/utils/functions/colors.d.ts

@@ -17,4 +17,4 @@ export declare const isSoftBackground: (value: string) => value is "skyblue" | "
  * Generate color from user name or email.
  * Recommended to use for `backgroundColor` in `Avatar` component.
  */
-export declare const getUserColor: (emailOrName: string) => string;
+export declare const getUserColor: (emailOrName: string) => "var(--iui-color-background-skyblue)" | "var(--iui-color-background-celery)" | "var(--iui-color-background-froly)" | "var(--iui-color-background-steelblue)" | "var(--iui-color-background-sunglow)" | "var(--iui-color-background-seabuckthorn)" | "var(--iui-color-background-montecarlo)" | "var(--iui-color-background-poloblue)" | "var(--iui-color-background-bouquet)" | "var(--iui-color-background-ash)" | "var(--iui-color-background-oak)";

package/esm/core/utils/functions/colors.js

@@ -3,45 +3,33 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 export const SoftBackgrounds = {
-    skyblue: 'var(--iui-color-background-skyblue)',
-    celery: 'var(--iui-color-background-celery)',
-    froly: 'var(--iui-color-background-froly)',
-    steelblue: 'var(--iui-color-background-steelblue)',
-    sunglow: 'var(--iui-color-background-sunglow)',
-    seabuckthorn: 'var(--iui-color-background-seabuckthorn)',
-    montecarlo: 'var(--iui-color-background-montecarlo)',
-    poloblue: 'var(--iui-color-background-poloblue)',
-    bouquet: 'var(--iui-color-background-bouquet)',
-    ash: 'var(--iui-color-background-ash)',
-    oak: 'var(--iui-color-background-oak)',
+  skyblue: 'var(--iui-color-background-skyblue)',
+  celery: 'var(--iui-color-background-celery)',
+  froly: 'var(--iui-color-background-froly)',
+  steelblue: 'var(--iui-color-background-steelblue)',
+  sunglow: 'var(--iui-color-background-sunglow)',
+  seabuckthorn: 'var(--iui-color-background-seabuckthorn)',
+  montecarlo: 'var(--iui-color-background-montecarlo)',
+  poloblue: 'var(--iui-color-background-poloblue)',
+  bouquet: 'var(--iui-color-background-bouquet)',
+  ash: 'var(--iui-color-background-ash)',
+  oak: 'var(--iui-color-background-oak)',
 };
 /** Returns true if a string value is one of the SoftBackgrounds keys */
 export const isSoftBackground = (value) => {
-    return Object.keys(SoftBackgrounds).includes(value);
+  return Object.keys(SoftBackgrounds).includes(value);
 };
-const USER_COLORS = [
-    '#6AB9EC',
-    '#B1C854',
-    '#F7706C',
-    '#4585A5',
-    '#FFC335',
-    '#F7963E',
-    '#73C7C1',
-    '#85A9CF',
-    '#A3779F',
-    '#C8C2B4',
-    '#A47854',
-];
+const USER_COLORS = Object.values(SoftBackgrounds);
 /**
  * Generate color from user name or email.
  * Recommended to use for `backgroundColor` in `Avatar` component.
  */
 export const getUserColor = (emailOrName) => {
-    const normalizedString = emailOrName.trim().toLowerCase();
-    let hash = 0;
-    for (let i = 0; i < normalizedString.length; i++) {
-        const charCode = normalizedString.charCodeAt(i);
-        hash = (hash + charCode) % USER_COLORS.length;
-    }
-    return USER_COLORS[hash];
+  const normalizedString = emailOrName.trim().toLowerCase();
+  let hash = 0;
+  for (let i = 0; i < normalizedString.length; i++) {
+    const charCode = normalizedString.charCodeAt(i);
+    hash = (hash + charCode) % USER_COLORS.length;
+  }
+  return USER_COLORS[hash];
 };

package/esm/core/utils/functions/date.js

@@ -6,12 +6,12 @@
  * Return true if the first date is earlier than the second date
  */
 export const isBefore = (beforeDate, afterDate) => {
-    if (!beforeDate || !afterDate) {
-        return false;
-    }
-    const firstDate = new Date(beforeDate);
-    const secondDate = new Date(afterDate);
-    firstDate && firstDate.setHours(0, 0, 0, 0);
-    secondDate && secondDate.setHours(0, 0, 0, 0);
-    return firstDate < secondDate;
+  if (!beforeDate || !afterDate) {
+    return false;
+  }
+  const firstDate = new Date(beforeDate);
+  const secondDate = new Date(afterDate);
+  firstDate && firstDate.setHours(0, 0, 0, 0);
+  secondDate && secondDate.setHours(0, 0, 0, 0);
+  return firstDate < secondDate;
 };

package/esm/core/utils/functions/dev.d.ts

@@ -0,0 +1,11 @@
+declare const isJest: boolean;
+declare let isDev: boolean;
+/**
+ * Logs message one time only in dev environments.
+ *
+ * @example
+ * const logWarningInDev = createWarningLogger();
+ * logWarningInDev("please don't use this")
+ */
+declare const createWarningLogger: () => (message: string) => void;
+export { isJest, isDev, createWarningLogger };

package/esm/core/utils/functions/dev.js

@@ -0,0 +1,29 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+const isJest = typeof jest !== 'undefined';
+let isDev = false;
+// wrapping in try-catch because process might be undefined
+try {
+  isDev = process.env.NODE_ENV !== 'production' && !isJest;
+} catch {}
+/**
+ * Logs message one time only in dev environments.
+ *
+ * @example
+ * const logWarningInDev = createWarningLogger();
+ * logWarningInDev("please don't use this")
+ */
+const createWarningLogger = !isDev
+  ? () => () => {}
+  : () => {
+      let logged = false;
+      return (message) => {
+        if (!logged) {
+          console.warn(message);
+          logged = true;
+        }
+      };
+    };
+export { isJest, isDev, createWarningLogger };

package/esm/core/utils/functions/dom.d.ts

@@ -1,12 +1,4 @@
 /// <reference types="react" />
-/**
- * Get the container as a child of body, or create one if it doesn't exist.
- * Mostly used for dynamic components like Modal or Toast.
- *
- * @param containerId id of the container to find or create
- * @param ownerDocument Can be changed if the container should be in a different document (e.g. in popup).
- */
-export declare const getContainer: (containerId: string, ownerDocument?: Document | undefined) => HTMLElement | undefined;
 /**
  * Get document if it is defined.
  * Used to support SSR/SSG applications.
@@ -22,3 +14,9 @@ export declare const getWindow: () => (Window & typeof globalThis) | undefined;
  * `defaultPrevented` is respected for each callback.
  */
 export declare const mergeEventHandlers: <E extends import("react").SyntheticEvent<Element, Event>>(...callbacks: (((event: E) => void) | undefined)[]) => (event: E) => void;
+/**
+ * Returns translate values as an array of a given element.
+ * @param element HTML element you want to get translate value of
+ * @returns Translate values in pixels in an array `[translateX, translateY]`
+ */
+export declare const getTranslateValues: (element: HTMLElement | null | undefined) => number[];

package/esm/core/utils/functions/dom.js

@@ -2,47 +2,45 @@
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
-/**
- * Get the container as a child of body, or create one if it doesn't exist.
- * Mostly used for dynamic components like Modal or Toast.
- *
- * @param containerId id of the container to find or create
- * @param ownerDocument Can be changed if the container should be in a different document (e.g. in popup).
- */
-export const getContainer = (containerId, ownerDocument = getDocument()) => {
-    var _a, _b;
-    let container = (_a = ownerDocument === null || ownerDocument === void 0 ? void 0 : ownerDocument.getElementById(containerId)) !== null && _a !== void 0 ? _a : undefined;
-    if (container == null && !!ownerDocument) {
-        container = ownerDocument.createElement('div');
-        container.setAttribute('id', containerId);
-        const root = (_b = ownerDocument.querySelector('.iui-root')) !== null && _b !== void 0 ? _b : ownerDocument.body;
-        root.appendChild(container);
-    }
-    return container;
-};
 /**
  * Get document if it is defined.
  * Used to support SSR/SSG applications.
  */
 export const getDocument = () => {
-    return typeof document === 'undefined' ? undefined : document;
+  return typeof document === 'undefined' ? undefined : document;
 };
 /**
  * Get window if it is defined.
  * Used to support SSR/SSG applications.
  */
 export const getWindow = () => {
-    return typeof window === 'undefined' ? undefined : window;
+  return typeof window === 'undefined' ? undefined : window;
 };
 /**
  * Merges multiple event handlers into one, while making sure that
  * `defaultPrevented` is respected for each callback.
  */
-export const mergeEventHandlers = (...callbacks) => (event) => {
+export const mergeEventHandlers =
+  (...callbacks) =>
+  (event) => {
     for (const cb of callbacks) {
-        cb === null || cb === void 0 ? void 0 : cb(event);
-        if (event === null || event === void 0 ? void 0 : event.defaultPrevented) {
-            return;
-        }
+      cb?.(event);
+      if (event?.defaultPrevented) {
+        return;
+      }
     }
+  };
+/**
+ * Returns translate values as an array of a given element.
+ * @param element HTML element you want to get translate value of
+ * @returns Translate values in pixels in an array `[translateX, translateY]`
+ */
+export const getTranslateValues = (element) => {
+  if (!element) {
+    return [];
+  }
+  const transformValue =
+    getComputedStyle(element).getPropertyValue('transform');
+  const matrix = new DOMMatrix(transformValue);
+  return [matrix.m41, matrix.m42];
 };

package/esm/core/utils/functions/focusable.js

@@ -2,28 +2,37 @@
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
-const tabbableElementsSelector = 'a[href], button, input, textarea, select, details, audio[controls], video[controls], [contenteditable]:not([contenteditable="false"]), [tabindex]:not([tabindex="-1"])';
+const tabbableElementsSelector =
+  'a[href], button, input, textarea, select, details, audio[controls], video[controls], [contenteditable]:not([contenteditable="false"]), [tabindex]:not([tabindex="-1"])';
 /**
  * Return array of tabbable elements in the container.
  */
 export const getTabbableElements = (container) => {
-    if (!container) {
-        return [];
-    }
-    const elements = container.querySelectorAll(tabbableElementsSelector);
-    return Array.from(elements).filter((el) => !el.hasAttribute('disabled') &&
-        !el.classList.contains('iui-disabled') &&
-        el.getAttribute('aria-disabled') !== 'true');
+  if (!container) {
+    return [];
+  }
+  const elements = container.querySelectorAll(tabbableElementsSelector);
+  return Array.from(elements).filter(
+    (el) =>
+      !el.hasAttribute('disabled') &&
+      !el.classList.contains('iui-disabled') &&
+      el.getAttribute('aria-disabled') !== 'true',
+  );
 };
 /**
  * Return array of focusable elements in the container.
  */
 export const getFocusableElements = (container) => {
-    if (!container) {
-        return [];
-    }
-    const elements = container.querySelectorAll(`${tabbableElementsSelector}, [tabindex="-1"]`);
-    return Array.from(elements).filter((el) => !el.hasAttribute('disabled') &&
-        !el.classList.contains('iui-disabled') &&
-        el.getAttribute('aria-disabled') !== 'true');
+  if (!container) {
+    return [];
+  }
+  const elements = container.querySelectorAll(
+    `${tabbableElementsSelector}, [tabindex="-1"]`,
+  );
+  return Array.from(elements).filter(
+    (el) =>
+      !el.hasAttribute('disabled') &&
+      !el.classList.contains('iui-disabled') &&
+      el.getAttribute('aria-disabled') !== 'true',
+  );
 };

package/esm/core/utils/functions/import.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Wrapper around native `import()` with workarounds for:
+ *   1. typescript trying to transpile dynamic import in CJS environment (https://github.com/microsoft/TypeScript/issues/43329)
+ *   2. jest/node causing segfault when encountering dynamic import (https://github.com/nodejs/node/issues/35889)
+ */
+export declare const dynamicImport: Function;

package/esm/core/utils/functions/import.js

@@ -0,0 +1,14 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/**
+ * Wrapper around native `import()` with workarounds for:
+ *   1. typescript trying to transpile dynamic import in CJS environment (https://github.com/microsoft/TypeScript/issues/43329)
+ *   2. jest/node causing segfault when encountering dynamic import (https://github.com/nodejs/node/issues/35889)
+ */
+export const dynamicImport =
+  typeof jest === undefined
+    ? new Function('specifier', 'return import(specifier)')
+    : (specifier) =>
+        import(/* webpackIgnore: true */ /* @vite-ignore */ specifier);

package/esm/core/utils/functions/index.d.ts

@@ -3,6 +3,8 @@ export * from './dom.js';
 export * from './colors.js';
 export * from './numbers.js';
 export * from './focusable.js';
-export * from './styles.js';
 export * from './supports.js';
 export * from './polymorphic.js';
+export * from './import.js';
+export * from './react.js';
+export * from './dev.js';

package/esm/core/utils/functions/index.js

@@ -7,6 +7,8 @@ export * from './dom.js';
 export * from './colors.js';
 export * from './numbers.js';
 export * from './focusable.js';
-export * from './styles.js';
 export * from './supports.js';
 export * from './polymorphic.js';
+export * from './import.js';
+export * from './react.js';
+export * from './dev.js';

package/esm/core/utils/functions/numbers.js

@@ -6,16 +6,16 @@
  * Return input value bounded by specified range.
  */
 export const getBoundedValue = (val, min, max) => {
-    return Math.min(max, Math.max(min, val));
+  return Math.min(max, Math.max(min, val));
 };
 /**
  * Returns a random value of a given length containing `A-Za-z0-9_-` symbols.
  */
 export const getRandomValue = (length = 21) => {
-    const alphabet = `_-0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ`;
-    let id = '';
-    for (let i = 0; i < length; i++) {
-        id += alphabet[(Math.random() * 64) | 0];
-    }
-    return id;
+  const alphabet = `_-0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ`;
+  let id = '';
+  for (let i = 0; i < length; i++) {
+    id += alphabet[(Math.random() * 64) | 0];
+  }
+  return id;
 };

package/esm/core/utils/functions/polymorphic.d.ts

@@ -19,7 +19,7 @@ import type { PolymorphicForwardRefComponent } from '../props.js';
  *
  * @private
  */
-export declare const polymorphic: ((className: string, attrs?: React.SVGProps<SVGSymbolElement> | React.DetailedHTMLProps<React.ObjectHTMLAttributes<HTMLObjectElement>, HTMLObjectElement> | React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | React.DetailedHTMLProps<React.AreaHTMLAttributes<HTMLAreaElement>, HTMLAreaElement> | React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement> | React.DetailedHTMLProps<React.BaseHTMLAttributes<HTMLBaseElement>, HTMLBaseElement> | React.DetailedHTMLProps<React.BlockquoteHTMLAttributes<HTMLQuoteElement>, HTMLQuoteElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLBodyElement>, HTMLBodyElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLBRElement>, HTMLBRElement> | React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement> | React.DetailedHTMLProps<React.CanvasHTMLAttributes<HTMLCanvasElement>, HTMLCanvasElement> | React.DetailedHTMLProps<React.ColHTMLAttributes<HTMLTableColElement>, HTMLTableColElement> | React.DetailedHTMLProps<React.ColgroupHTMLAttributes<HTMLTableColElement>, HTMLTableColElement> | React.DetailedHTMLProps<React.DataHTMLAttributes<HTMLDataElement>, HTMLDataElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLDataListElement>, HTMLDataListElement> | React.DetailedHTMLProps<React.DelHTMLAttributes<HTMLModElement>, HTMLModElement> | React.DetailedHTMLProps<React.DetailsHTMLAttributes<HTMLDetailsElement>, HTMLDetailsElement> | React.DetailedHTMLProps<React.DialogHTMLAttributes<HTMLDialogElement>, HTMLDialogElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLDListElement>, HTMLDListElement> | React.DetailedHTMLProps<React.EmbedHTMLAttributes<HTMLEmbedElement>, HTMLEmbedElement> | React.DetailedHTMLProps<React.FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement> | React.DetailedHTMLProps<React.FormHTMLAttributes<HTMLFormElement>, HTMLFormElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadElement>, HTMLHeadElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLHRElement>, HTMLHRElement> | React.DetailedHTMLProps<React.HtmlHTMLAttributes<HTMLHtmlElement>, HTMLHtmlElement> | React.DetailedHTMLProps<React.IframeHTMLAttributes<HTMLIFrameElement>, HTMLIFrameElement> | React.DetailedHTMLProps<React.ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement> | React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement> | React.DetailedHTMLProps<React.InsHTMLAttributes<HTMLModElement>, HTMLModElement> | React.DetailedHTMLProps<React.LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLLegendElement>, HTMLLegendElement> | React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement> | React.DetailedHTMLProps<React.LinkHTMLAttributes<HTMLLinkElement>, HTMLLinkElement> | React.DetailedHTMLProps<React.MapHTMLAttributes<HTMLMapElement>, HTMLMapElement> | React.DetailedHTMLProps<React.MenuHTMLAttributes<HTMLElement>, HTMLElement> | React.DetailedHTMLProps<React.MetaHTMLAttributes<HTMLMetaElement>, HTMLMetaElement> | React.DetailedHTMLProps<React.MeterHTMLAttributes<HTMLMeterElement>, HTMLMeterElement> | React.DetailedHTMLProps<React.OlHTMLAttributes<HTMLOListElement>, HTMLOListElement> | React.DetailedHTMLProps<React.OptgroupHTMLAttributes<HTMLOptGroupElement>, HTMLOptGroupElement> | React.DetailedHTMLProps<React.OptionHTMLAttributes<HTMLOptionElement>, HTMLOptionElement> | React.DetailedHTMLProps<React.OutputHTMLAttributes<HTMLOutputElement>, HTMLOutputElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement> | React.DetailedHTMLProps<React.ParamHTMLAttributes<HTMLParamElement>, HTMLParamElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLPreElement>, HTMLPreElement> | React.DetailedHTMLProps<React.ProgressHTMLAttributes<HTMLProgressElement>, HTMLProgressElement> | React.DetailedHTMLProps<React.QuoteHTMLAttributes<HTMLQuoteElement>, HTMLQuoteElement> | React.DetailedHTMLProps<React.ScriptHTMLAttributes<HTMLScriptElement>, HTMLScriptElement> | React.DetailedHTMLProps<React.SelectHTMLAttributes<HTMLSelectElement>, HTMLSelectElement> | React.DetailedHTMLProps<React.SlotHTMLAttributes<HTMLSlotElement>, HTMLSlotElement> | React.DetailedHTMLProps<React.SourceHTMLAttributes<HTMLSourceElement>, HTMLSourceElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement> | React.DetailedHTMLProps<React.StyleHTMLAttributes<HTMLStyleElement>, HTMLStyleElement> | React.DetailedHTMLProps<React.TableHTMLAttributes<HTMLTableElement>, HTMLTableElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement> | React.DetailedHTMLProps<React.TdHTMLAttributes<HTMLTableDataCellElement>, HTMLTableDataCellElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLTemplateElement>, HTMLTemplateElement> | React.DetailedHTMLProps<React.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement> | React.DetailedHTMLProps<React.ThHTMLAttributes<HTMLTableHeaderCellElement>, HTMLTableHeaderCellElement> | React.DetailedHTMLProps<React.TimeHTMLAttributes<HTMLTimeElement>, HTMLTimeElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLTitleElement>, HTMLTitleElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableRowElement>, HTMLTableRowElement> | React.DetailedHTMLProps<React.TrackHTMLAttributes<HTMLTrackElement>, HTMLTrackElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLUListElement>, HTMLUListElement> | React.DetailedHTMLProps<React.VideoHTMLAttributes<HTMLVideoElement>, HTMLVideoElement> | React.SVGProps<SVGTextElement> | React.SVGProps<SVGElement> | React.SVGProps<SVGCircleElement> | React.SVGProps<SVGClipPathElement> | React.SVGProps<SVGDefsElement> | React.SVGProps<SVGDescElement> | React.SVGProps<SVGEllipseElement> | React.SVGProps<SVGFEBlendElement> | React.SVGProps<SVGFEColorMatrixElement> | React.SVGProps<SVGFEComponentTransferElement> | React.SVGProps<SVGFECompositeElement> | React.SVGProps<SVGFEConvolveMatrixElement> | React.SVGProps<SVGFEDiffuseLightingElement> | React.SVGProps<SVGFEDisplacementMapElement> | React.SVGProps<SVGFEDistantLightElement> | React.SVGProps<SVGFEDropShadowElement> | React.SVGProps<SVGFEFloodElement> | React.SVGProps<SVGFEFuncAElement> | React.SVGProps<SVGFEFuncBElement> | React.SVGProps<SVGFEFuncGElement> | React.SVGProps<SVGFEFuncRElement> | React.SVGProps<SVGFEGaussianBlurElement> | React.SVGProps<SVGFEImageElement> | React.SVGProps<SVGFEMergeElement> | React.SVGProps<SVGFEMergeNodeElement> | React.SVGProps<SVGFEMorphologyElement> | React.SVGProps<SVGFEOffsetElement> | React.SVGProps<SVGFEPointLightElement> | React.SVGProps<SVGFESpecularLightingElement> | React.SVGProps<SVGFESpotLightElement> | React.SVGProps<SVGFETileElement> | React.SVGProps<SVGFETurbulenceElement> | React.SVGProps<SVGFilterElement> | React.SVGProps<SVGForeignObjectElement> | React.SVGProps<SVGGElement> | React.SVGProps<SVGImageElement> | React.SVGProps<SVGLineElement> | React.SVGProps<SVGLinearGradientElement> | React.SVGProps<SVGMarkerElement> | React.SVGProps<SVGMaskElement> | React.SVGProps<SVGMetadataElement> | React.SVGProps<SVGPathElement> | React.SVGProps<SVGPatternElement> | React.SVGProps<SVGPolygonElement> | React.SVGProps<SVGPolylineElement> | React.SVGProps<SVGRadialGradientElement> | React.SVGProps<SVGRectElement> | React.SVGProps<SVGStopElement> | React.SVGProps<SVGSVGElement> | React.SVGProps<SVGSwitchElement> | React.SVGProps<SVGTextPathElement> | React.SVGProps<SVGTSpanElement> | React.SVGProps<SVGUseElement> | React.SVGProps<SVGViewElement> | React.DetailedHTMLProps<React.KeygenHTMLAttributes<HTMLElement>, HTMLElement> | React.DetailedHTMLProps<React.WebViewHTMLAttributes<HTMLWebViewElement>, HTMLWebViewElement> | undefined) => PolymorphicForwardRefComponent<keyof JSX.IntrinsicElements, {}>) & {
+export declare const polymorphic: ((className: string, attrs?: React.SVGProps<SVGSymbolElement> | React.DetailedHTMLProps<React.ObjectHTMLAttributes<HTMLObjectElement>, HTMLObjectElement> | React.DetailedHTMLProps<React.MapHTMLAttributes<HTMLMapElement>, HTMLMapElement> | React.SVGProps<SVGFilterElement> | React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | React.DetailedHTMLProps<React.AreaHTMLAttributes<HTMLAreaElement>, HTMLAreaElement> | React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement> | React.DetailedHTMLProps<React.BaseHTMLAttributes<HTMLBaseElement>, HTMLBaseElement> | React.DetailedHTMLProps<React.BlockquoteHTMLAttributes<HTMLQuoteElement>, HTMLQuoteElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLBodyElement>, HTMLBodyElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLBRElement>, HTMLBRElement> | React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement> | React.DetailedHTMLProps<React.CanvasHTMLAttributes<HTMLCanvasElement>, HTMLCanvasElement> | React.DetailedHTMLProps<React.ColHTMLAttributes<HTMLTableColElement>, HTMLTableColElement> | React.DetailedHTMLProps<React.ColgroupHTMLAttributes<HTMLTableColElement>, HTMLTableColElement> | React.DetailedHTMLProps<React.DataHTMLAttributes<HTMLDataElement>, HTMLDataElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLDataListElement>, HTMLDataListElement> | React.DetailedHTMLProps<React.DelHTMLAttributes<HTMLModElement>, HTMLModElement> | React.DetailedHTMLProps<React.DetailsHTMLAttributes<HTMLDetailsElement>, HTMLDetailsElement> | React.DetailedHTMLProps<React.DialogHTMLAttributes<HTMLDialogElement>, HTMLDialogElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLDListElement>, HTMLDListElement> | React.DetailedHTMLProps<React.EmbedHTMLAttributes<HTMLEmbedElement>, HTMLEmbedElement> | React.DetailedHTMLProps<React.FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement> | React.DetailedHTMLProps<React.FormHTMLAttributes<HTMLFormElement>, HTMLFormElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadElement>, HTMLHeadElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLHRElement>, HTMLHRElement> | React.DetailedHTMLProps<React.HtmlHTMLAttributes<HTMLHtmlElement>, HTMLHtmlElement> | React.DetailedHTMLProps<React.IframeHTMLAttributes<HTMLIFrameElement>, HTMLIFrameElement> | React.DetailedHTMLProps<React.ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement> | React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement> | React.DetailedHTMLProps<React.InsHTMLAttributes<HTMLModElement>, HTMLModElement> | React.DetailedHTMLProps<React.LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLLegendElement>, HTMLLegendElement> | React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement> | React.DetailedHTMLProps<React.LinkHTMLAttributes<HTMLLinkElement>, HTMLLinkElement> | React.DetailedHTMLProps<React.MenuHTMLAttributes<HTMLElement>, HTMLElement> | React.DetailedHTMLProps<React.MetaHTMLAttributes<HTMLMetaElement>, HTMLMetaElement> | React.DetailedHTMLProps<React.MeterHTMLAttributes<HTMLMeterElement>, HTMLMeterElement> | React.DetailedHTMLProps<React.OlHTMLAttributes<HTMLOListElement>, HTMLOListElement> | React.DetailedHTMLProps<React.OptgroupHTMLAttributes<HTMLOptGroupElement>, HTMLOptGroupElement> | React.DetailedHTMLProps<React.OptionHTMLAttributes<HTMLOptionElement>, HTMLOptionElement> | React.DetailedHTMLProps<React.OutputHTMLAttributes<HTMLOutputElement>, HTMLOutputElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLPreElement>, HTMLPreElement> | React.DetailedHTMLProps<React.ProgressHTMLAttributes<HTMLProgressElement>, HTMLProgressElement> | React.DetailedHTMLProps<React.QuoteHTMLAttributes<HTMLQuoteElement>, HTMLQuoteElement> | React.DetailedHTMLProps<React.ScriptHTMLAttributes<HTMLScriptElement>, HTMLScriptElement> | React.DetailedHTMLProps<React.SelectHTMLAttributes<HTMLSelectElement>, HTMLSelectElement> | React.DetailedHTMLProps<React.SlotHTMLAttributes<HTMLSlotElement>, HTMLSlotElement> | React.DetailedHTMLProps<React.SourceHTMLAttributes<HTMLSourceElement>, HTMLSourceElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement> | React.DetailedHTMLProps<React.StyleHTMLAttributes<HTMLStyleElement>, HTMLStyleElement> | React.DetailedHTMLProps<React.TableHTMLAttributes<HTMLTableElement>, HTMLTableElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement> | React.DetailedHTMLProps<React.TdHTMLAttributes<HTMLTableDataCellElement>, HTMLTableDataCellElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLTemplateElement>, HTMLTemplateElement> | React.DetailedHTMLProps<React.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement> | React.DetailedHTMLProps<React.ThHTMLAttributes<HTMLTableHeaderCellElement>, HTMLTableHeaderCellElement> | React.DetailedHTMLProps<React.TimeHTMLAttributes<HTMLTimeElement>, HTMLTimeElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLTitleElement>, HTMLTitleElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableRowElement>, HTMLTableRowElement> | React.DetailedHTMLProps<React.TrackHTMLAttributes<HTMLTrackElement>, HTMLTrackElement> | React.DetailedHTMLProps<React.HTMLAttributes<HTMLUListElement>, HTMLUListElement> | React.DetailedHTMLProps<React.VideoHTMLAttributes<HTMLVideoElement>, HTMLVideoElement> | React.SVGProps<SVGElement> | React.SVGProps<SVGCircleElement> | React.SVGProps<SVGClipPathElement> | React.SVGProps<SVGDefsElement> | React.SVGProps<SVGDescElement> | React.SVGProps<SVGEllipseElement> | React.SVGProps<SVGFEBlendElement> | React.SVGProps<SVGFEColorMatrixElement> | React.SVGProps<SVGFEComponentTransferElement> | React.SVGProps<SVGFECompositeElement> | React.SVGProps<SVGFEConvolveMatrixElement> | React.SVGProps<SVGFEDiffuseLightingElement> | React.SVGProps<SVGFEDisplacementMapElement> | React.SVGProps<SVGFEDistantLightElement> | React.SVGProps<SVGFEDropShadowElement> | React.SVGProps<SVGFEFloodElement> | React.SVGProps<SVGFEFuncAElement> | React.SVGProps<SVGFEFuncBElement> | React.SVGProps<SVGFEFuncGElement> | React.SVGProps<SVGFEFuncRElement> | React.SVGProps<SVGFEGaussianBlurElement> | React.SVGProps<SVGFEImageElement> | React.SVGProps<SVGFEMergeElement> | React.SVGProps<SVGFEMergeNodeElement> | React.SVGProps<SVGFEMorphologyElement> | React.SVGProps<SVGFEOffsetElement> | React.SVGProps<SVGFEPointLightElement> | React.SVGProps<SVGFESpecularLightingElement> | React.SVGProps<SVGFESpotLightElement> | React.SVGProps<SVGFETileElement> | React.SVGProps<SVGFETurbulenceElement> | React.SVGProps<SVGForeignObjectElement> | React.SVGProps<SVGGElement> | React.SVGProps<SVGImageElement> | React.SVGLineElementAttributes<SVGLineElement> | React.SVGProps<SVGLinearGradientElement> | React.SVGProps<SVGMarkerElement> | React.SVGProps<SVGMaskElement> | React.SVGProps<SVGMetadataElement> | React.SVGProps<SVGPathElement> | React.SVGProps<SVGPatternElement> | React.SVGProps<SVGPolygonElement> | React.SVGProps<SVGPolylineElement> | React.SVGProps<SVGRadialGradientElement> | React.SVGProps<SVGRectElement> | React.SVGProps<SVGStopElement> | React.SVGProps<SVGSVGElement> | React.SVGProps<SVGSwitchElement> | React.SVGTextElementAttributes<SVGTextElement> | React.SVGProps<SVGTextPathElement> | React.SVGProps<SVGTSpanElement> | React.SVGProps<SVGUseElement> | React.SVGProps<SVGViewElement> | React.DetailedHTMLProps<React.KeygenHTMLAttributes<HTMLElement>, HTMLElement> | React.DetailedHTMLProps<React.ParamHTMLAttributes<HTMLParamElement>, HTMLParamElement> | React.DetailedHTMLProps<React.WebViewHTMLAttributes<HTMLWebViewElement>, HTMLWebViewElement> | undefined) => PolymorphicForwardRefComponent<NonNullable<keyof JSX.IntrinsicElements>, {}>) & {
     a: (className: string, attrs?: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement> | undefined) => PolymorphicForwardRefComponent<"a", {}>;
     abbr: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"abbr", {}>;
     address: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"address", {}>;
@@ -38,6 +38,7 @@ export declare const polymorphic: ((className: string, attrs?: React.SVGProps<SV
     button: (className: string, attrs?: React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement> | undefined) => PolymorphicForwardRefComponent<"button", {}>;
     canvas: (className: string, attrs?: React.DetailedHTMLProps<React.CanvasHTMLAttributes<HTMLCanvasElement>, HTMLCanvasElement> | undefined) => PolymorphicForwardRefComponent<"canvas", {}>;
     caption: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"caption", {}>;
+    center: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"center", {}>;
     cite: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"cite", {}>;
     code: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"code", {}>;
     col: (className: string, attrs?: React.DetailedHTMLProps<React.ColHTMLAttributes<HTMLTableColElement>, HTMLTableColElement> | undefined) => PolymorphicForwardRefComponent<"col", {}>;
@@ -107,6 +108,7 @@ export declare const polymorphic: ((className: string, attrs?: React.SVGProps<SV
     ruby: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"ruby", {}>;
     s: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"s", {}>;
     samp: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"samp", {}>;
+    search: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"search", {}>;
     slot: (className: string, attrs?: React.DetailedHTMLProps<React.SlotHTMLAttributes<HTMLSlotElement>, HTMLSlotElement> | undefined) => PolymorphicForwardRefComponent<"slot", {}>;
     script: (className: string, attrs?: React.DetailedHTMLProps<React.ScriptHTMLAttributes<HTMLScriptElement>, HTMLScriptElement> | undefined) => PolymorphicForwardRefComponent<"script", {}>;
     section: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"section", {}>;
@@ -175,7 +177,7 @@ export declare const polymorphic: ((className: string, attrs?: React.SVGProps<SV
     foreignObject: (className: string, attrs?: React.SVGProps<SVGForeignObjectElement> | undefined) => PolymorphicForwardRefComponent<"foreignObject", {}>;
     g: (className: string, attrs?: React.SVGProps<SVGGElement> | undefined) => PolymorphicForwardRefComponent<"g", {}>;
     image: (className: string, attrs?: React.SVGProps<SVGImageElement> | undefined) => PolymorphicForwardRefComponent<"image", {}>;
-    line: (className: string, attrs?: React.SVGProps<SVGLineElement> | undefined) => PolymorphicForwardRefComponent<"line", {}>;
+    line: (className: string, attrs?: React.SVGLineElementAttributes<SVGLineElement> | undefined) => PolymorphicForwardRefComponent<"line", {}>;
     linearGradient: (className: string, attrs?: React.SVGProps<SVGLinearGradientElement> | undefined) => PolymorphicForwardRefComponent<"linearGradient", {}>;
     marker: (className: string, attrs?: React.SVGProps<SVGMarkerElement> | undefined) => PolymorphicForwardRefComponent<"marker", {}>;
     mask: (className: string, attrs?: React.SVGProps<SVGMaskElement> | undefined) => PolymorphicForwardRefComponent<"mask", {}>;
@@ -190,7 +192,7 @@ export declare const polymorphic: ((className: string, attrs?: React.SVGProps<SV
     stop: (className: string, attrs?: React.SVGProps<SVGStopElement> | undefined) => PolymorphicForwardRefComponent<"stop", {}>;
     switch: (className: string, attrs?: React.SVGProps<SVGSwitchElement> | undefined) => PolymorphicForwardRefComponent<"switch", {}>;
     symbol: (className: string, attrs?: React.SVGProps<SVGSymbolElement> | undefined) => PolymorphicForwardRefComponent<"symbol", {}>;
-    text: (className: string, attrs?: React.SVGProps<SVGTextElement> | undefined) => PolymorphicForwardRefComponent<"text", {}>;
+    text: (className: string, attrs?: React.SVGTextElementAttributes<SVGTextElement> | undefined) => PolymorphicForwardRefComponent<"text", {}>;
     textPath: (className: string, attrs?: React.SVGProps<SVGTextPathElement> | undefined) => PolymorphicForwardRefComponent<"textPath", {}>;
     tspan: (className: string, attrs?: React.SVGProps<SVGTSpanElement> | undefined) => PolymorphicForwardRefComponent<"tspan", {}>;
     use: (className: string, attrs?: React.SVGProps<SVGUseElement> | undefined) => PolymorphicForwardRefComponent<"use", {}>;

package/esm/core/utils/functions/polymorphic.js

@@ -5,16 +5,24 @@
 import * as React from 'react';
 import cx from 'classnames';
 import { useGlobals } from '../hooks/useGlobals.js';
+import styles from '../../../styles.js';
 const _base = (defaultElement) => {
-    return (className, attrs) => {
-        const Comp = React.forwardRef(({ as = defaultElement, ...props }, ref) => {
-            const Element = as || 'div'; // eslint-disable-line
-            useGlobals();
-            return (React.createElement(Element, { ref: ref, ...attrs, ...props, className: cx(className, attrs === null || attrs === void 0 ? void 0 : attrs.className, props.className) }));
-        });
-        Comp.displayName = getDisplayNameFromClass(className);
-        return Comp;
-    };
+  return (className, attrs) => {
+    const Comp = React.forwardRef(({ as = defaultElement, ...props }, ref) => {
+      const Element = as || 'div'; // eslint-disable-line
+      useGlobals();
+      return React.createElement(Element, {
+        ref: ref,
+        ...attrs,
+        ...props,
+        className: getScopedClassName(
+          cx(className, attrs?.className, props.className),
+        ),
+      });
+    });
+    Comp.displayName = getDisplayNameFromClass(className);
+    return Comp;
+  };
 };
 /**
  * Utility to create a type-safe polymorphic component with a simple class.
@@ -36,17 +44,26 @@ const _base = (defaultElement) => {
  * @private
  */
 export const polymorphic = new Proxy(_base('div'), {
-    get: (target, prop) => {
-        if (typeof prop === 'string') {
-            // eslint-disable-next-line -- string is as far as we can narrow it down
-            // @ts-ignore
-            return _base(prop);
-        }
-        return Reflect.get(target, prop);
-    },
+  get: (target, prop) => {
+    if (typeof prop === 'string') {
+      // eslint-disable-next-line -- string is as far as we can narrow it down
+      // @ts-ignore
+      return _base(prop);
+    }
+    return Reflect.get(target, prop);
+  },
 });
 // e.g. iui-list-item-icon -> ListItemIcon
 const getDisplayNameFromClass = (str) => {
-    const camel = str.replace(/-([a-z])/g, (g) => g[1].toUpperCase());
-    return camel.substring(3);
+  const camel = str.replace(/-([a-z])/g, (g) => g[1].toUpperCase());
+  return camel.substring(3);
+};
+// e.g. iui-button -> _iui3-button
+const getScopedClassName = (className = '') => {
+  return (
+    className
+      .split(' ')
+      .map((c) => (c in styles ? styles[c] : c))
+      .join(' ') || null
+  );
 };

package/esm/core/utils/functions/react.d.ts

@@ -0,0 +1,8 @@
+import * as React from 'react';
+/**
+ * Wrapper over `cloneElement` that automatically checks for `isValidElement`
+ * and automatically merges `children.ref` with the ref passed in props.
+ *
+ * @private
+ */
+export declare const cloneElementWithRef: (children: React.ReactNode, getProps: (children: JSX.Element) => Record<string, unknown>) => string | number | true | React.ReactElement<any, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null;