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

package/esm/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/esm/core/utils/functions/polymorphic.js

@@ -0,0 +1,52 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import * as React from 'react';
+import cx from 'classnames';
+import { useGlobals } from '../hooks/useGlobals.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;
+    };
+};
+/**
+ * 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 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);
+    },
+});
+// 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/esm/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/esm/core/utils/hooks/index.js

@@ -7,7 +7,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/esm/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/esm/core/utils/hooks/useGlobals.js

@@ -0,0 +1,51 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import * as React from 'react';
+import '@itwin/itwinui-css/css/global.css';
+import '@itwin/itwinui-variables/index.css';
+import { ThemeContext } from '../../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
+ */
+export const useGlobals = () => {
+    useThemeProviderWarning();
+    useRootFontSizeWarning();
+};
+// ----------------------------------------------------------------------------
+/** Shows console error if ThemeProvider is not used */
+export const useThemeProviderWarning = () => {
+    const themeContext = React.useContext(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]);
+};
+// ----------------------------------------------------------------------------
+/** 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/esm/core/utils/hooks/useIsThemeAlreadySet.js

@@ -3,7 +3,7 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
-import { ThemeContext } from '../../ThemeProvider/ThemeProvider.js';
+import { ThemeContext } from '../../ThemeProvider/ThemeContext.js';
 import { useIsomorphicLayoutEffect } from './useIsomorphicLayoutEffect.js';
 import { getDocument } from '../functions/index.js';
 /**

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

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

package/esm/core/{Typography/Headline/index.js → utils/icons/Svg.js}

@@ -2,5 +2,5 @@
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
-export { Headline } from './Headline.js';
-export default './Headline';
+import { polymorphic } from '../functions/polymorphic.js';
+export const Svg = polymorphic.svg('', { viewBox: '0 0 16 16' });

package/esm/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/esm/core/utils/icons/SvgCalendar.js

@@ -3,7 +3,8 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import { Svg } from './Svg.js';
 export const SvgCalendar = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(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' })));
 };

package/esm/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/esm/core/utils/icons/SvgCaretDownSmall.js

@@ -3,7 +3,8 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import { Svg } from './Svg.js';
 export const SvgCaretDownSmall = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(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' })));
 };

package/esm/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/esm/core/utils/icons/SvgCaretRightSmall.js

@@ -3,7 +3,8 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import { Svg } from './Svg.js';
 export const SvgCaretRightSmall = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(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' })));
 };

package/esm/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/esm/core/utils/icons/SvgCaretUpSmall.js

@@ -3,7 +3,8 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import { Svg } from './Svg.js';
 export const SvgCaretUpSmall = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(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' })));
 };

package/esm/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/esm/core/utils/icons/SvgCheckmark.js

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

package/esm/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/esm/core/utils/icons/SvgCheckmarkSmall.js

@@ -3,7 +3,8 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import { Svg } from './Svg.js';
 export const SvgCheckmarkSmall = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(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' })));
 };

package/esm/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/esm/core/utils/icons/SvgChevronLeft.js

@@ -3,7 +3,8 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import { Svg } from './Svg.js';
 export const SvgChevronLeft = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(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' })));
 };

package/esm/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;

package/esm/core/utils/icons/SvgChevronLeftDouble.js

@@ -3,7 +3,8 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import { Svg } from './Svg.js';
 export const SvgChevronLeftDouble = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg, { ...props },
         React.createElement("path", { d: 'm14.6 0 1.4 1.4-6.6 6.6 6.6 6.6-1.4 1.4-8-8zm-6.6 0 1.4 1.4-6.6 6.6 6.6 6.6-1.4 1.4-8-8z' })));
 };

package/esm/core/utils/icons/SvgChevronRight.d.ts

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

package/esm/core/utils/icons/SvgChevronRight.js

@@ -3,7 +3,8 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import { Svg } from './Svg.js';
 export const SvgChevronRight = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg, { ...props },
         React.createElement("path", { d: 'm4.7 0-1.4 1.4 6.6 6.6-6.6 6.6 1.4 1.4 8-8z' })));
 };

package/esm/core/utils/icons/SvgChevronRightDouble.d.ts

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

package/esm/core/utils/icons/SvgChevronRightDouble.js

@@ -3,7 +3,8 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import { Svg } from './Svg.js';
 export const SvgChevronRightDouble = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg, { ...props },
         React.createElement("path", { d: 'm1.4 0-1.4 1.4 6.6 6.6-6.6 6.6 1.4 1.4 8-8zm6.6 0-1.4 1.4 6.6 6.6-6.6 6.6 1.4 1.4 8-8z' })));
 };

package/esm/core/utils/icons/SvgClose.d.ts

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

package/esm/core/utils/icons/SvgClose.js

@@ -3,7 +3,8 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import * as React from 'react';
+import { Svg } from './Svg.js';
 export const SvgClose = (props) => {
-    return (React.createElement("svg", { viewBox: '0 0 16 16', ...props },
+    return (React.createElement(Svg, { ...props },
         React.createElement("path", { d: 'm14 0-6 6-6-6-2 2 6 6-6 6 2 2 6-6 6 6 2-2-6-6 6-6' })));
 };

package/esm/core/utils/icons/SvgCloseSmall.d.ts

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