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

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

@@ -0,0 +1,198 @@
+import * as React from 'react';
+import type { PolymorphicForwardRefComponent } from '../props.js';
+/**
+ * Utility to create a type-safe polymorphic component with a simple class.
+ *
+ * Can be called directly or as a property of the `Polymorphic` object.
+ * In both cases, returns a component that:
+ * - supports `as` prop with default element
+ * - forwards ref and rest props
+ * - adds and merges css classes
+ *
+ * @example
+ * const MyPolyDiv = polymorphic('my-poly-div');
+ * <MyPolyDiv>...</MyPolyDiv>;
+ *
+ * @example
+ * const MyPolyButton = polymorphic.button('my-poly-button', { type: 'button' });
+ * <MyPolyButton as='a' href='#'>...</MyPolyButton>;
+ *
+ * @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, {}>) & {
+    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", {}>;
+    area: (className: string, attrs?: React.DetailedHTMLProps<React.AreaHTMLAttributes<HTMLAreaElement>, HTMLAreaElement> | undefined) => PolymorphicForwardRefComponent<"area", {}>;
+    article: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"article", {}>;
+    aside: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"aside", {}>;
+    audio: (className: string, attrs?: React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement> | undefined) => PolymorphicForwardRefComponent<"audio", {}>;
+    b: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"b", {}>;
+    base: (className: string, attrs?: React.DetailedHTMLProps<React.BaseHTMLAttributes<HTMLBaseElement>, HTMLBaseElement> | undefined) => PolymorphicForwardRefComponent<"base", {}>;
+    bdi: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"bdi", {}>;
+    bdo: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"bdo", {}>;
+    big: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"big", {}>;
+    blockquote: (className: string, attrs?: React.DetailedHTMLProps<React.BlockquoteHTMLAttributes<HTMLQuoteElement>, HTMLQuoteElement> | undefined) => PolymorphicForwardRefComponent<"blockquote", {}>;
+    body: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLBodyElement>, HTMLBodyElement> | undefined) => PolymorphicForwardRefComponent<"body", {}>;
+    br: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLBRElement>, HTMLBRElement> | undefined) => PolymorphicForwardRefComponent<"br", {}>;
+    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", {}>;
+    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", {}>;
+    colgroup: (className: string, attrs?: React.DetailedHTMLProps<React.ColgroupHTMLAttributes<HTMLTableColElement>, HTMLTableColElement> | undefined) => PolymorphicForwardRefComponent<"colgroup", {}>;
+    data: (className: string, attrs?: React.DetailedHTMLProps<React.DataHTMLAttributes<HTMLDataElement>, HTMLDataElement> | undefined) => PolymorphicForwardRefComponent<"data", {}>;
+    datalist: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLDataListElement>, HTMLDataListElement> | undefined) => PolymorphicForwardRefComponent<"datalist", {}>;
+    dd: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"dd", {}>;
+    del: (className: string, attrs?: React.DetailedHTMLProps<React.DelHTMLAttributes<HTMLModElement>, HTMLModElement> | undefined) => PolymorphicForwardRefComponent<"del", {}>;
+    details: (className: string, attrs?: React.DetailedHTMLProps<React.DetailsHTMLAttributes<HTMLDetailsElement>, HTMLDetailsElement> | undefined) => PolymorphicForwardRefComponent<"details", {}>;
+    dfn: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"dfn", {}>;
+    dialog: (className: string, attrs?: React.DetailedHTMLProps<React.DialogHTMLAttributes<HTMLDialogElement>, HTMLDialogElement> | undefined) => PolymorphicForwardRefComponent<"dialog", {}>;
+    div: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement> | undefined) => PolymorphicForwardRefComponent<"div", {}>;
+    dl: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLDListElement>, HTMLDListElement> | undefined) => PolymorphicForwardRefComponent<"dl", {}>;
+    dt: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"dt", {}>;
+    em: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"em", {}>;
+    embed: (className: string, attrs?: React.DetailedHTMLProps<React.EmbedHTMLAttributes<HTMLEmbedElement>, HTMLEmbedElement> | undefined) => PolymorphicForwardRefComponent<"embed", {}>;
+    fieldset: (className: string, attrs?: React.DetailedHTMLProps<React.FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement> | undefined) => PolymorphicForwardRefComponent<"fieldset", {}>;
+    figcaption: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"figcaption", {}>;
+    figure: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"figure", {}>;
+    footer: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"footer", {}>;
+    form: (className: string, attrs?: React.DetailedHTMLProps<React.FormHTMLAttributes<HTMLFormElement>, HTMLFormElement> | undefined) => PolymorphicForwardRefComponent<"form", {}>;
+    h1: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement> | undefined) => PolymorphicForwardRefComponent<"h1", {}>;
+    h2: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement> | undefined) => PolymorphicForwardRefComponent<"h2", {}>;
+    h3: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement> | undefined) => PolymorphicForwardRefComponent<"h3", {}>;
+    h4: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement> | undefined) => PolymorphicForwardRefComponent<"h4", {}>;
+    h5: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement> | undefined) => PolymorphicForwardRefComponent<"h5", {}>;
+    h6: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement> | undefined) => PolymorphicForwardRefComponent<"h6", {}>;
+    head: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadElement>, HTMLHeadElement> | undefined) => PolymorphicForwardRefComponent<"head", {}>;
+    header: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"header", {}>;
+    hgroup: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"hgroup", {}>;
+    hr: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLHRElement>, HTMLHRElement> | undefined) => PolymorphicForwardRefComponent<"hr", {}>;
+    html: (className: string, attrs?: React.DetailedHTMLProps<React.HtmlHTMLAttributes<HTMLHtmlElement>, HTMLHtmlElement> | undefined) => PolymorphicForwardRefComponent<"html", {}>;
+    i: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"i", {}>;
+    iframe: (className: string, attrs?: React.DetailedHTMLProps<React.IframeHTMLAttributes<HTMLIFrameElement>, HTMLIFrameElement> | undefined) => PolymorphicForwardRefComponent<"iframe", {}>;
+    img: (className: string, attrs?: React.DetailedHTMLProps<React.ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement> | undefined) => PolymorphicForwardRefComponent<"img", {}>;
+    input: (className: string, attrs?: React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement> | undefined) => PolymorphicForwardRefComponent<"input", {}>;
+    ins: (className: string, attrs?: React.DetailedHTMLProps<React.InsHTMLAttributes<HTMLModElement>, HTMLModElement> | undefined) => PolymorphicForwardRefComponent<"ins", {}>;
+    kbd: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"kbd", {}>;
+    keygen: (className: string, attrs?: React.DetailedHTMLProps<React.KeygenHTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"keygen", {}>;
+    label: (className: string, attrs?: React.DetailedHTMLProps<React.LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement> | undefined) => PolymorphicForwardRefComponent<"label", {}>;
+    legend: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLLegendElement>, HTMLLegendElement> | undefined) => PolymorphicForwardRefComponent<"legend", {}>;
+    li: (className: string, attrs?: React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement> | undefined) => PolymorphicForwardRefComponent<"li", {}>;
+    link: (className: string, attrs?: React.DetailedHTMLProps<React.LinkHTMLAttributes<HTMLLinkElement>, HTMLLinkElement> | undefined) => PolymorphicForwardRefComponent<"link", {}>;
+    main: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"main", {}>;
+    map: (className: string, attrs?: React.DetailedHTMLProps<React.MapHTMLAttributes<HTMLMapElement>, HTMLMapElement> | undefined) => PolymorphicForwardRefComponent<"map", {}>;
+    mark: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"mark", {}>;
+    menu: (className: string, attrs?: React.DetailedHTMLProps<React.MenuHTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"menu", {}>;
+    menuitem: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"menuitem", {}>;
+    meta: (className: string, attrs?: React.DetailedHTMLProps<React.MetaHTMLAttributes<HTMLMetaElement>, HTMLMetaElement> | undefined) => PolymorphicForwardRefComponent<"meta", {}>;
+    meter: (className: string, attrs?: React.DetailedHTMLProps<React.MeterHTMLAttributes<HTMLMeterElement>, HTMLMeterElement> | undefined) => PolymorphicForwardRefComponent<"meter", {}>;
+    nav: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"nav", {}>;
+    noindex: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"noindex", {}>;
+    noscript: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"noscript", {}>;
+    object: (className: string, attrs?: React.DetailedHTMLProps<React.ObjectHTMLAttributes<HTMLObjectElement>, HTMLObjectElement> | undefined) => PolymorphicForwardRefComponent<"object", {}>;
+    ol: (className: string, attrs?: React.DetailedHTMLProps<React.OlHTMLAttributes<HTMLOListElement>, HTMLOListElement> | undefined) => PolymorphicForwardRefComponent<"ol", {}>;
+    optgroup: (className: string, attrs?: React.DetailedHTMLProps<React.OptgroupHTMLAttributes<HTMLOptGroupElement>, HTMLOptGroupElement> | undefined) => PolymorphicForwardRefComponent<"optgroup", {}>;
+    option: (className: string, attrs?: React.DetailedHTMLProps<React.OptionHTMLAttributes<HTMLOptionElement>, HTMLOptionElement> | undefined) => PolymorphicForwardRefComponent<"option", {}>;
+    output: (className: string, attrs?: React.DetailedHTMLProps<React.OutputHTMLAttributes<HTMLOutputElement>, HTMLOutputElement> | undefined) => PolymorphicForwardRefComponent<"output", {}>;
+    p: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement> | undefined) => PolymorphicForwardRefComponent<"p", {}>;
+    param: (className: string, attrs?: React.DetailedHTMLProps<React.ParamHTMLAttributes<HTMLParamElement>, HTMLParamElement> | undefined) => PolymorphicForwardRefComponent<"param", {}>;
+    picture: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"picture", {}>;
+    pre: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLPreElement>, HTMLPreElement> | undefined) => PolymorphicForwardRefComponent<"pre", {}>;
+    progress: (className: string, attrs?: React.DetailedHTMLProps<React.ProgressHTMLAttributes<HTMLProgressElement>, HTMLProgressElement> | undefined) => PolymorphicForwardRefComponent<"progress", {}>;
+    q: (className: string, attrs?: React.DetailedHTMLProps<React.QuoteHTMLAttributes<HTMLQuoteElement>, HTMLQuoteElement> | undefined) => PolymorphicForwardRefComponent<"q", {}>;
+    rp: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"rp", {}>;
+    rt: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"rt", {}>;
+    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", {}>;
+    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", {}>;
+    select: (className: string, attrs?: React.DetailedHTMLProps<React.SelectHTMLAttributes<HTMLSelectElement>, HTMLSelectElement> | undefined) => PolymorphicForwardRefComponent<"select", {}>;
+    small: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"small", {}>;
+    source: (className: string, attrs?: React.DetailedHTMLProps<React.SourceHTMLAttributes<HTMLSourceElement>, HTMLSourceElement> | undefined) => PolymorphicForwardRefComponent<"source", {}>;
+    span: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement> | undefined) => PolymorphicForwardRefComponent<"span", {}>;
+    strong: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"strong", {}>;
+    style: (className: string, attrs?: React.DetailedHTMLProps<React.StyleHTMLAttributes<HTMLStyleElement>, HTMLStyleElement> | undefined) => PolymorphicForwardRefComponent<"style", {}>;
+    sub: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"sub", {}>;
+    summary: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"summary", {}>;
+    sup: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"sup", {}>;
+    table: (className: string, attrs?: React.DetailedHTMLProps<React.TableHTMLAttributes<HTMLTableElement>, HTMLTableElement> | undefined) => PolymorphicForwardRefComponent<"table", {}>;
+    template: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLTemplateElement>, HTMLTemplateElement> | undefined) => PolymorphicForwardRefComponent<"template", {}>;
+    tbody: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement> | undefined) => PolymorphicForwardRefComponent<"tbody", {}>;
+    td: (className: string, attrs?: React.DetailedHTMLProps<React.TdHTMLAttributes<HTMLTableDataCellElement>, HTMLTableDataCellElement> | undefined) => PolymorphicForwardRefComponent<"td", {}>;
+    textarea: (className: string, attrs?: React.DetailedHTMLProps<React.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement> | undefined) => PolymorphicForwardRefComponent<"textarea", {}>;
+    tfoot: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement> | undefined) => PolymorphicForwardRefComponent<"tfoot", {}>;
+    th: (className: string, attrs?: React.DetailedHTMLProps<React.ThHTMLAttributes<HTMLTableHeaderCellElement>, HTMLTableHeaderCellElement> | undefined) => PolymorphicForwardRefComponent<"th", {}>;
+    thead: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement> | undefined) => PolymorphicForwardRefComponent<"thead", {}>;
+    time: (className: string, attrs?: React.DetailedHTMLProps<React.TimeHTMLAttributes<HTMLTimeElement>, HTMLTimeElement> | undefined) => PolymorphicForwardRefComponent<"time", {}>;
+    title: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLTitleElement>, HTMLTitleElement> | undefined) => PolymorphicForwardRefComponent<"title", {}>;
+    tr: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableRowElement>, HTMLTableRowElement> | undefined) => PolymorphicForwardRefComponent<"tr", {}>;
+    track: (className: string, attrs?: React.DetailedHTMLProps<React.TrackHTMLAttributes<HTMLTrackElement>, HTMLTrackElement> | undefined) => PolymorphicForwardRefComponent<"track", {}>;
+    u: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"u", {}>;
+    ul: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLUListElement>, HTMLUListElement> | undefined) => PolymorphicForwardRefComponent<"ul", {}>;
+    var: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"var", {}>;
+    video: (className: string, attrs?: React.DetailedHTMLProps<React.VideoHTMLAttributes<HTMLVideoElement>, HTMLVideoElement> | undefined) => PolymorphicForwardRefComponent<"video", {}>;
+    wbr: (className: string, attrs?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> | undefined) => PolymorphicForwardRefComponent<"wbr", {}>;
+    webview: (className: string, attrs?: React.DetailedHTMLProps<React.WebViewHTMLAttributes<HTMLWebViewElement>, HTMLWebViewElement> | undefined) => PolymorphicForwardRefComponent<"webview", {}>;
+    svg: (className: string, attrs?: React.SVGProps<SVGSVGElement> | undefined) => PolymorphicForwardRefComponent<"svg", {}>;
+    animate: (className: string, attrs?: React.SVGProps<SVGElement> | undefined) => PolymorphicForwardRefComponent<"animate", {}>;
+    animateMotion: (className: string, attrs?: React.SVGProps<SVGElement> | undefined) => PolymorphicForwardRefComponent<"animateMotion", {}>;
+    animateTransform: (className: string, attrs?: React.SVGProps<SVGElement> | undefined) => PolymorphicForwardRefComponent<"animateTransform", {}>;
+    circle: (className: string, attrs?: React.SVGProps<SVGCircleElement> | undefined) => PolymorphicForwardRefComponent<"circle", {}>;
+    clipPath: (className: string, attrs?: React.SVGProps<SVGClipPathElement> | undefined) => PolymorphicForwardRefComponent<"clipPath", {}>;
+    defs: (className: string, attrs?: React.SVGProps<SVGDefsElement> | undefined) => PolymorphicForwardRefComponent<"defs", {}>;
+    desc: (className: string, attrs?: React.SVGProps<SVGDescElement> | undefined) => PolymorphicForwardRefComponent<"desc", {}>;
+    ellipse: (className: string, attrs?: React.SVGProps<SVGEllipseElement> | undefined) => PolymorphicForwardRefComponent<"ellipse", {}>;
+    feBlend: (className: string, attrs?: React.SVGProps<SVGFEBlendElement> | undefined) => PolymorphicForwardRefComponent<"feBlend", {}>;
+    feColorMatrix: (className: string, attrs?: React.SVGProps<SVGFEColorMatrixElement> | undefined) => PolymorphicForwardRefComponent<"feColorMatrix", {}>;
+    feComponentTransfer: (className: string, attrs?: React.SVGProps<SVGFEComponentTransferElement> | undefined) => PolymorphicForwardRefComponent<"feComponentTransfer", {}>;
+    feComposite: (className: string, attrs?: React.SVGProps<SVGFECompositeElement> | undefined) => PolymorphicForwardRefComponent<"feComposite", {}>;
+    feConvolveMatrix: (className: string, attrs?: React.SVGProps<SVGFEConvolveMatrixElement> | undefined) => PolymorphicForwardRefComponent<"feConvolveMatrix", {}>;
+    feDiffuseLighting: (className: string, attrs?: React.SVGProps<SVGFEDiffuseLightingElement> | undefined) => PolymorphicForwardRefComponent<"feDiffuseLighting", {}>;
+    feDisplacementMap: (className: string, attrs?: React.SVGProps<SVGFEDisplacementMapElement> | undefined) => PolymorphicForwardRefComponent<"feDisplacementMap", {}>;
+    feDistantLight: (className: string, attrs?: React.SVGProps<SVGFEDistantLightElement> | undefined) => PolymorphicForwardRefComponent<"feDistantLight", {}>;
+    feDropShadow: (className: string, attrs?: React.SVGProps<SVGFEDropShadowElement> | undefined) => PolymorphicForwardRefComponent<"feDropShadow", {}>;
+    feFlood: (className: string, attrs?: React.SVGProps<SVGFEFloodElement> | undefined) => PolymorphicForwardRefComponent<"feFlood", {}>;
+    feFuncA: (className: string, attrs?: React.SVGProps<SVGFEFuncAElement> | undefined) => PolymorphicForwardRefComponent<"feFuncA", {}>;
+    feFuncB: (className: string, attrs?: React.SVGProps<SVGFEFuncBElement> | undefined) => PolymorphicForwardRefComponent<"feFuncB", {}>;
+    feFuncG: (className: string, attrs?: React.SVGProps<SVGFEFuncGElement> | undefined) => PolymorphicForwardRefComponent<"feFuncG", {}>;
+    feFuncR: (className: string, attrs?: React.SVGProps<SVGFEFuncRElement> | undefined) => PolymorphicForwardRefComponent<"feFuncR", {}>;
+    feGaussianBlur: (className: string, attrs?: React.SVGProps<SVGFEGaussianBlurElement> | undefined) => PolymorphicForwardRefComponent<"feGaussianBlur", {}>;
+    feImage: (className: string, attrs?: React.SVGProps<SVGFEImageElement> | undefined) => PolymorphicForwardRefComponent<"feImage", {}>;
+    feMerge: (className: string, attrs?: React.SVGProps<SVGFEMergeElement> | undefined) => PolymorphicForwardRefComponent<"feMerge", {}>;
+    feMergeNode: (className: string, attrs?: React.SVGProps<SVGFEMergeNodeElement> | undefined) => PolymorphicForwardRefComponent<"feMergeNode", {}>;
+    feMorphology: (className: string, attrs?: React.SVGProps<SVGFEMorphologyElement> | undefined) => PolymorphicForwardRefComponent<"feMorphology", {}>;
+    feOffset: (className: string, attrs?: React.SVGProps<SVGFEOffsetElement> | undefined) => PolymorphicForwardRefComponent<"feOffset", {}>;
+    fePointLight: (className: string, attrs?: React.SVGProps<SVGFEPointLightElement> | undefined) => PolymorphicForwardRefComponent<"fePointLight", {}>;
+    feSpecularLighting: (className: string, attrs?: React.SVGProps<SVGFESpecularLightingElement> | undefined) => PolymorphicForwardRefComponent<"feSpecularLighting", {}>;
+    feSpotLight: (className: string, attrs?: React.SVGProps<SVGFESpotLightElement> | undefined) => PolymorphicForwardRefComponent<"feSpotLight", {}>;
+    feTile: (className: string, attrs?: React.SVGProps<SVGFETileElement> | undefined) => PolymorphicForwardRefComponent<"feTile", {}>;
+    feTurbulence: (className: string, attrs?: React.SVGProps<SVGFETurbulenceElement> | undefined) => PolymorphicForwardRefComponent<"feTurbulence", {}>;
+    filter: (className: string, attrs?: React.SVGProps<SVGFilterElement> | undefined) => PolymorphicForwardRefComponent<"filter", {}>;
+    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", {}>;
+    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", {}>;
+    metadata: (className: string, attrs?: React.SVGProps<SVGMetadataElement> | undefined) => PolymorphicForwardRefComponent<"metadata", {}>;
+    mpath: (className: string, attrs?: React.SVGProps<SVGElement> | undefined) => PolymorphicForwardRefComponent<"mpath", {}>;
+    path: (className: string, attrs?: React.SVGProps<SVGPathElement> | undefined) => PolymorphicForwardRefComponent<"path", {}>;
+    pattern: (className: string, attrs?: React.SVGProps<SVGPatternElement> | undefined) => PolymorphicForwardRefComponent<"pattern", {}>;
+    polygon: (className: string, attrs?: React.SVGProps<SVGPolygonElement> | undefined) => PolymorphicForwardRefComponent<"polygon", {}>;
+    polyline: (className: string, attrs?: React.SVGProps<SVGPolylineElement> | undefined) => PolymorphicForwardRefComponent<"polyline", {}>;
+    radialGradient: (className: string, attrs?: React.SVGProps<SVGRadialGradientElement> | undefined) => PolymorphicForwardRefComponent<"radialGradient", {}>;
+    rect: (className: string, attrs?: React.SVGProps<SVGRectElement> | undefined) => PolymorphicForwardRefComponent<"rect", {}>;
+    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", {}>;
+    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", {}>;
+    view: (className: string, attrs?: React.SVGProps<SVGViewElement> | undefined) => PolymorphicForwardRefComponent<"view", {}>;
+};

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

@@ -0,0 +1,81 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.polymorphic = void 0;
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+const React = __importStar(require("react"));
+const classnames_1 = __importDefault(require("classnames"));
+const useGlobals_js_1 = require("../hooks/useGlobals.js");
+const _base = (defaultElement) => {
+    return (className, attrs) => {
+        const Comp = React.forwardRef(({ as = defaultElement, ...props }, ref) => {
+            const Element = as || 'div'; // eslint-disable-line
+            (0, useGlobals_js_1.useGlobals)();
+            return (React.createElement(Element, { ref: ref, ...attrs, ...props, className: (0, classnames_1.default)(className, attrs === null || attrs === void 0 ? void 0 : attrs.className, props.className) }));
+        });
+        Comp.displayName = getDisplayNameFromClass(className);
+        return Comp;
+    };
+};
+/**
+ * Utility to create a type-safe polymorphic component with a simple class.
+ *
+ * Can be called directly or as a property of the `Polymorphic` object.
+ * In both cases, returns a component that:
+ * - supports `as` prop with default element
+ * - forwards ref and rest props
+ * - adds and merges css classes
+ *
+ * @example
+ * const MyPolyDiv = polymorphic('my-poly-div');
+ * <MyPolyDiv>...</MyPolyDiv>;
+ *
+ * @example
+ * const MyPolyButton = polymorphic.button('my-poly-button', { type: 'button' });
+ * <MyPolyButton as='a' href='#'>...</MyPolyButton>;
+ *
+ * @private
+ */
+exports.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);
+    },
+});
+// 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);
+};

package/cjs/core/utils/hooks/index.d.ts

@@ -3,7 +3,7 @@ export * from './useMergedRefs.js';
 export * from './useOverflow.js';
 export * from './useResizeObserver.js';
 export * from './useContainerWidth.js';
-export * from './useTheme.js';
+export * from './useGlobals.js';
 export * from './useIntersection.js';
 export * from './useMediaQuery.js';
 export * from './useSafeContext.js';

package/cjs/core/utils/hooks/index.js

@@ -23,7 +23,7 @@ __exportStar(require("./useMergedRefs.js"), exports);
 __exportStar(require("./useOverflow.js"), exports);
 __exportStar(require("./useResizeObserver.js"), exports);
 __exportStar(require("./useContainerWidth.js"), exports);
-__exportStar(require("./useTheme.js"), exports);
+__exportStar(require("./useGlobals.js"), exports);
 __exportStar(require("./useIntersection.js"), exports);
 __exportStar(require("./useMediaQuery.js"), exports);
 __exportStar(require("./useSafeContext.js"), exports);

package/cjs/core/utils/hooks/useGlobals.d.ts

@@ -0,0 +1,10 @@
+import '@itwin/itwinui-css/css/global.css';
+import '@itwin/itwinui-variables/index.css';
+/**
+ * Hook used in every component for any shared setup and side effects.
+ *
+ * @private
+ */
+export declare const useGlobals: () => void;
+/** Shows console error if ThemeProvider is not used */
+export declare const useThemeProviderWarning: () => void;

package/cjs/core/utils/hooks/useGlobals.js

@@ -0,0 +1,79 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useThemeProviderWarning = exports.useGlobals = void 0;
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+const React = __importStar(require("react"));
+require("@itwin/itwinui-css/css/global.css");
+require("@itwin/itwinui-variables/index.css");
+const ThemeContext_js_1 = require("../../ThemeProvider/ThemeContext.js");
+let isDev = false;
+// wrapping in try-catch because process might be undefined
+try {
+    isDev = process.env.NODE_ENV !== 'production';
+}
+catch (_a) { }
+const didLogWarning = {
+    fontSize: false,
+    themeProvider: false,
+};
+/**
+ * Hook used in every component for any shared setup and side effects.
+ *
+ * @private
+ */
+const useGlobals = () => {
+    (0, exports.useThemeProviderWarning)();
+    useRootFontSizeWarning();
+};
+exports.useGlobals = useGlobals;
+// ----------------------------------------------------------------------------
+/** Shows console error if ThemeProvider is not used */
+const useThemeProviderWarning = () => {
+    const themeContext = React.useContext(ThemeContext_js_1.ThemeContext);
+    React.useEffect(() => {
+        if (isDev && !didLogWarning.themeProvider && !themeContext) {
+            console.error('iTwinUI components must be used within a tree wrapped in a ThemeProvider.');
+            didLogWarning.themeProvider = true;
+        }
+    }, [themeContext]);
+};
+exports.useThemeProviderWarning = useThemeProviderWarning;
+// ----------------------------------------------------------------------------
+/** Shows console error if the page changes the root font size */
+const useRootFontSizeWarning = () => {
+    React.useEffect(() => {
+        if (isDev && !didLogWarning.fontSize) {
+            const rootFontSize = parseInt(getComputedStyle(document.documentElement).fontSize);
+            if (rootFontSize < 16) {
+                console.error('Root font size must not be overridden. \nSee https://github.com/iTwin/iTwinUI/wiki/iTwinUI-react-v2-migration-guide#relative-font-size');
+            }
+            didLogWarning.fontSize = true;
+        }
+    }, []);
+};

package/cjs/core/utils/hooks/useIsThemeAlreadySet.js

@@ -29,7 +29,7 @@ exports.useIsThemeAlreadySet = void 0;
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 const React = __importStar(require("react"));
-const ThemeProvider_js_1 = require("../../ThemeProvider/ThemeProvider.js");
+const ThemeContext_js_1 = require("../../ThemeProvider/ThemeContext.js");
 const useIsomorphicLayoutEffect_js_1 = require("./useIsomorphicLayoutEffect.js");
 const index_js_1 = require("../functions/index.js");
 /**
@@ -38,7 +38,7 @@ const index_js_1 = require("../functions/index.js");
  * - The <body> element has data-iui-theme attribute
  */
 const useIsThemeAlreadySet = (ownerDocument = (0, index_js_1.getDocument)()) => {
-    const parentContext = React.useContext(ThemeProvider_js_1.ThemeContext);
+    const parentContext = React.useContext(ThemeContext_js_1.ThemeContext);
     const isThemeAlreadySet = React.useRef(!!parentContext || !!(ownerDocument === null || ownerDocument === void 0 ? void 0 : ownerDocument.body.dataset.iuiTheme));
     (0, useIsomorphicLayoutEffect_js_1.useIsomorphicLayoutEffect)(() => {
         if (parentContext ||

package/cjs/core/utils/icons/Svg.d.ts

@@ -0,0 +1 @@
+export declare const Svg: import("../props.js").PolymorphicForwardRefComponent<"svg", {}>;

package/cjs/core/{Typography/Body/index.js → utils/icons/Svg.js}

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Body = void 0;
+exports.Svg = 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 Body_js_1 = require("./Body.js");
-Object.defineProperty(exports, "Body", { enumerable: true, get: function () { return Body_js_1.Body; } });
-exports.default = './Body';
+const polymorphic_js_1 = require("../functions/polymorphic.js");
+exports.Svg = polymorphic_js_1.polymorphic.svg('', { viewBox: '0 0 16 16' });

package/cjs/core/utils/icons/SvgCalendar.d.ts

@@ -1,2 +1,2 @@
 import * as React from 'react';
-export declare const SvgCalendar: (props: React.ComponentProps<'svg'>) => JSX.Element;
+export declare const SvgCalendar: (props: React.ComponentPropsWithoutRef<'svg'>) => JSX.Element;

package/cjs/core/utils/icons/SvgCalendar.js

@@ -29,8 +29,9 @@ exports.SvgCalendar = void 0;
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 const React = __importStar(require("react"));
+const Svg_js_1 = require("./Svg.js");
 const SvgCalendar = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg_js_1.Svg, { ...props },
         React.createElement("path", { d: 'M13,13H9V10h4ZM16,3V15a1,1,0,0,1-1,1H1a1,1,0,0,1-1-1V3A1,1,0,0,1,1,2H3V0H4V2h8V0h1V2h2A1,1,0,0,1,16,3ZM15,6H1v9H15Z' })));
 };
 exports.SvgCalendar = SvgCalendar;

package/cjs/core/utils/icons/SvgCaretDownSmall.d.ts

@@ -1,2 +1,2 @@
 import * as React from 'react';
-export declare const SvgCaretDownSmall: (props: React.ComponentProps<'svg'>) => JSX.Element;
+export declare const SvgCaretDownSmall: (props: React.ComponentPropsWithoutRef<'svg'>) => JSX.Element;

package/cjs/core/utils/icons/SvgCaretDownSmall.js

@@ -29,8 +29,9 @@ exports.SvgCaretDownSmall = void 0;
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 const React = __importStar(require("react"));
+const Svg_js_1 = require("./Svg.js");
 const SvgCaretDownSmall = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg_js_1.Svg, { ...props },
         React.createElement("path", { d: 'M4.807 6h6.395a.28.28 0 0 1 .24.443L8.27 9.9a.34.34 0 0 1-.481 0L4.566 6.443A.27.27 0 0 1 4.806 6z' })));
 };
 exports.SvgCaretDownSmall = SvgCaretDownSmall;

package/cjs/core/utils/icons/SvgCaretRightSmall.d.ts

@@ -1,2 +1,2 @@
 import * as React from 'react';
-export declare const SvgCaretRightSmall: (props: React.ComponentProps<'svg'>) => JSX.Element;
+export declare const SvgCaretRightSmall: (props: React.ComponentPropsWithoutRef<'svg'>) => JSX.Element;

package/cjs/core/utils/icons/SvgCaretRightSmall.js

@@ -29,8 +29,9 @@ exports.SvgCaretRightSmall = void 0;
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 const React = __importStar(require("react"));
+const Svg_js_1 = require("./Svg.js");
 const SvgCaretRightSmall = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg_js_1.Svg, { ...props },
         React.createElement("path", { d: 'M6.003 4.807v6.4a.28.28 0 0 0 .443.24L9.9 8.27a.34.34 0 0 0 0-.48L6.446 4.566a.269.269 0 0 0-.443.24z' })));
 };
 exports.SvgCaretRightSmall = SvgCaretRightSmall;

package/cjs/core/utils/icons/SvgCaretUpSmall.d.ts

@@ -1,2 +1,2 @@
 import * as React from 'react';
-export declare const SvgCaretUpSmall: (props: React.ComponentProps<'svg'>) => JSX.Element;
+export declare const SvgCaretUpSmall: (props: React.ComponentPropsWithoutRef<'svg'>) => JSX.Element;

package/cjs/core/utils/icons/SvgCaretUpSmall.js

@@ -29,8 +29,9 @@ exports.SvgCaretUpSmall = void 0;
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 const React = __importStar(require("react"));
+const Svg_js_1 = require("./Svg.js");
 const SvgCaretUpSmall = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg_js_1.Svg, { ...props },
         React.createElement("path", { d: 'M4.807 9.997h6.395a.28.28 0 0 0 .24-.443L8.27 6.097a.34.34 0 0 0-.48 0h-.001L4.566 9.554a.27.27 0 0 0 .24.443z' })));
 };
 exports.SvgCaretUpSmall = SvgCaretUpSmall;

package/cjs/core/utils/icons/SvgCheckmark.d.ts

@@ -1,2 +1,2 @@
 import * as React from 'react';
-export declare const SvgCheckmark: (props: React.ComponentProps<'svg'>) => JSX.Element;
+export declare const SvgCheckmark: (props: React.ComponentPropsWithoutRef<'svg'>) => JSX.Element;

package/cjs/core/utils/icons/SvgCheckmark.js

@@ -29,8 +29,9 @@ exports.SvgCheckmark = void 0;
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 const React = __importStar(require("react"));
+const Svg_js_1 = require("./Svg.js");
 const SvgCheckmark = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg_js_1.Svg, { ...props },
         React.createElement("path", { d: 'M6,14L0,8l2-2l4,4l8-8l2,2L6,14z' })));
 };
 exports.SvgCheckmark = SvgCheckmark;

package/cjs/core/utils/icons/SvgCheckmarkSmall.d.ts

@@ -1,2 +1,2 @@
 import * as React from 'react';
-export declare const SvgCheckmarkSmall: (props: React.ComponentProps<'svg'>) => JSX.Element;
+export declare const SvgCheckmarkSmall: (props: React.ComponentPropsWithoutRef<'svg'>) => JSX.Element;

package/cjs/core/utils/icons/SvgCheckmarkSmall.js

@@ -29,8 +29,9 @@ exports.SvgCheckmarkSmall = void 0;
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 const React = __importStar(require("react"));
+const Svg_js_1 = require("./Svg.js");
 const SvgCheckmarkSmall = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg_js_1.Svg, { ...props },
         React.createElement("path", { d: 'm6 13.4-4.7-4.7 1.4-1.4 3.3 3.3 7.3-7.3 1.4 1.4z' })));
 };
 exports.SvgCheckmarkSmall = SvgCheckmarkSmall;

package/cjs/core/utils/icons/SvgChevronLeft.d.ts

@@ -1,2 +1,2 @@
 import * as React from 'react';
-export declare const SvgChevronLeft: (props: React.ComponentProps<'svg'>) => JSX.Element;
+export declare const SvgChevronLeft: (props: React.ComponentPropsWithoutRef<'svg'>) => JSX.Element;

package/cjs/core/utils/icons/SvgChevronLeft.js

@@ -29,8 +29,9 @@ exports.SvgChevronLeft = void 0;
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 const React = __importStar(require("react"));
+const Svg_js_1 = require("./Svg.js");
 const SvgChevronLeft = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg_js_1.Svg, { ...props },
         React.createElement("path", { d: 'm11.3 0 1.4 1.4-6.6 6.6 6.6 6.6-1.4 1.4-8-8z' })));
 };
 exports.SvgChevronLeft = SvgChevronLeft;

package/cjs/core/utils/icons/SvgChevronLeftDouble.d.ts

@@ -1,2 +1,2 @@
 import * as React from 'react';
-export declare const SvgChevronLeftDouble: (props: React.ComponentProps<'svg'>) => JSX.Element;
+export declare const SvgChevronLeftDouble: (props: React.ComponentPropsWithoutRef<'svg'>) => JSX.Element;