@dynatrace/strato-components 0.85.21 → 0.85.32

package/buttons/button/Button.d.ts

@@ -86,9 +86,9 @@ export declare const _Button: <E extends ElementType = 'button'>(props: ButtonPr
  * `Enter` or `Space` while the button has focus.
  * @public
  */
-export declare const Button: (<E extends React.ElementType = "button">(props: ButtonProps<E>) => ReactElement | null) & {
-    Suffix: (props: import("./Suffix.js").ButtonSuffixProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
-    Prefix: (props: import("./Prefix.js").ButtonPrefixProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
-    Label: (props: import("./Label.js").ButtonLabelProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Button: (<E extends ElementType = "button">(props: ButtonProps<E>) => ReactElement | null) & {
+    Suffix: (props: import("./Suffix.js").ButtonSuffixProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
+    Prefix: (props: import("./Prefix.js").ButtonPrefixProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
+    Label: (props: import("./Label.js").ButtonLabelProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
 };
 export {};

package/buttons/button/Label.d.ts

@@ -13,4 +13,4 @@ export interface ButtonLabelProps extends StylingProps, DataTestId {
  * Button Label component.
  * @public
  */
-export declare const Label: (props: ButtonLabelProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Label: (props: ButtonLabelProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;

package/buttons/button/Prefix.d.ts

@@ -13,4 +13,4 @@ export interface ButtonPrefixProps extends StylingProps, DataTestId {
  * Button Prefix component.
  * @public
  */
-export declare const Prefix: (props: ButtonPrefixProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Prefix: (props: ButtonPrefixProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;

package/buttons/button/Suffix.d.ts

@@ -13,4 +13,4 @@ export interface ButtonSuffixProps extends StylingProps, DataTestId {
  * Button Suffix component.
  * @public
  */
-export declare const Suffix: (props: ButtonSuffixProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Suffix: (props: ButtonSuffixProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;

package/buttons/intent-button/IntentButton.d.ts

@@ -41,4 +41,4 @@ export type IntentButtonProps = IntentButtonPropsBase & ({
  * in the AppShell context.
  * @public
  */
-export declare const IntentButton: (props: IntentButtonProps & React.RefAttributes<HTMLAnchorElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const IntentButton: (props: IntentButtonProps & React.RefAttributes<HTMLAnchorElement>) => React.ReactElement | null;

package/content/progress/ProgressBar.d.ts

@@ -49,8 +49,8 @@ export interface ProgressBarProps extends WithChildren, DOMProps, AriaLabelingPr
  * The `ProgressBar` can be used to visualize determinate or indeterminate progress.
  * @public
  */
-export declare const ProgressBar: ((props: ProgressBarProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null) & {
-    Value: (props: import("./ProgressBarValue.js").ProgressBarValueProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
-    Label: (props: import("./ProgressBarLabel.js").ProgressBarLabelProps & React.RefAttributes<HTMLLabelElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
-    Icon: (props: import("./ProgressBarIcon.js").ProgressBarIconProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const ProgressBar: ((props: ProgressBarProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null) & {
+    Value: (props: import("./ProgressBarValue.js").ProgressBarValueProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
+    Label: (props: import("./ProgressBarLabel.js").ProgressBarLabelProps & React.RefAttributes<HTMLLabelElement>) => React.ReactElement | null;
+    Icon: (props: import("./ProgressBarIcon.js").ProgressBarIconProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
 };

package/content/progress/ProgressBarIcon.d.ts

@@ -12,4 +12,4 @@ export interface ProgressBarIconProps extends WithChildren, StylingProps, DataTe
  * The ProgressBarIcon subcomponent is rendered inside the ProgressBar component.
  * @public
  */
-export declare const ProgressBarIcon: (props: ProgressBarIconProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const ProgressBarIcon: (props: ProgressBarIconProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;

package/content/progress/ProgressBarLabel.d.ts

@@ -12,4 +12,4 @@ export interface ProgressBarLabelProps extends WithChildren, StylingProps, DataT
  * ProgressBarLabel sub-component is rendered inside ProgressBar component.
  * @public
  */
-export declare const ProgressBarLabel: (props: ProgressBarLabelProps & React.RefAttributes<HTMLLabelElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const ProgressBarLabel: (props: ProgressBarLabelProps & React.RefAttributes<HTMLLabelElement>) => React.ReactElement | null;

package/content/progress/ProgressBarValue.d.ts

@@ -12,4 +12,4 @@ export interface ProgressBarValueProps extends WithChildren, StylingProps, DataT
  * ProgressBarValue sub-component is rendered inside ProgressBar component.
  * @public
  */
-export declare const ProgressBarValue: (props: ProgressBarValueProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const ProgressBarValue: (props: ProgressBarValueProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;

package/content/progress/ProgressCircle.d.ts

@@ -48,4 +48,4 @@ export interface ProgressCircleProps extends WithChildren, DOMProps, AriaLabelin
  * The `ProgressCircle` component is used to indicate the progress or completion status of a task or process.
  * @public
  * */
-export declare const ProgressCircle: (props: ProgressCircleProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const ProgressCircle: (props: ProgressCircleProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;

package/content/skeleton/Skeleton.d.ts

@@ -27,4 +27,4 @@ export interface SkeletonProps extends WithChildren, StylingProps, DataTestId {
  * The `Skeleton` component renders a colored block with an animated background, indicating that something is loading.
  * @public
  */
-export declare const Skeleton: (props: SkeletonProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Skeleton: (props: SkeletonProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;

package/content/skeleton/SkeletonText.d.ts

@@ -21,4 +21,4 @@ export interface SkeletonTextProps extends StylingProps, DataTestId {
  * The `SkeletonText` component renders a specified number of placeholder boxes for lines of text with an animated background.
  * @public
  */
-export declare const SkeletonText: (props: SkeletonTextProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const SkeletonText: (props: SkeletonTextProps & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;

package/core/components/app-root/AppRoot.d.ts

@@ -18,5 +18,5 @@ export type AppRootProps = PropsWithChildren<DataTestId & StylingProps & Masking
  * @public
  */
 export declare const AppRoot: (props: DataTestId & StylingProps & MaskingProps & {
-    children?: React.ReactNode;
-} & React.RefAttributes<HTMLDivElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+    children?: React.ReactNode | undefined;
+} & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;

package/core/components/focus-scope/FocusScope.d.ts

@@ -17,11 +17,11 @@ export interface FocusScopeProps extends WithChildren {
     contain?: boolean;
 }
 /**
- * @internal
  * The `FocusScope` helps you manage the focus when opening any overlay. If you
  * want to create a custom overlay, you can wrap the content of your overlay in the
  * `FocusScope` to help you make the overlay accessible and handle focus
  * appropriately.
+ * @internal
  */
 export declare const FocusScope: {
     (props: FocusScopeProps): React.JSX.Element;

package/core/contexts/FocusContext.d.ts

@@ -9,11 +9,10 @@ export type FocusContextProps = {
     setBackgroundInertness: (value: boolean) => void;
 };
 /**
- * @internal
- *
  * This context keeps all information needed for proper focus management.
  * @param modality - currently used pointer device
  * @param backgroundInertness - if the background (behind overlays) is currently inert (inactive)
  * @param setBackgroundInertness - updates the backgrounds active status
+ * @internal
  */
 export declare const FocusContext: import("react").Context<FocusContextProps>;

package/core/providers/FocusProvider.d.ts

@@ -1,15 +1,14 @@
 import React from 'react';
 import type { WithChildren } from '../types/with-children.js';
 /**
- * @internal
  * Type defining the modality options for the focus handling.
+ * @internal
  */
 export type Modality = 'keyboard' | 'pointer' | 'touch' | 'unknown';
 /**
- * @internal
- *
  * Provider that can be reused in components for storing the focus context props.
  * Loosely inspired by [what-input-js](https://github.com/ten1seven/what-input/blob/main/src/scripts/what-input.js).
+ * @internal
  */
 export declare const FocusProvider: {
     ({ children }: WithChildren): React.JSX.Element;

package/esm/core/components/focus-scope/FocusScope.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/core/components/focus-scope/FocusScope.tsx"],
-  "sourcesContent": ["import React, { useEffect, useRef } from 'react';\n\nimport { useActiveElement } from '../../hooks/useActiveElement.js';\nimport { useFocusContext } from '../../hooks/useFocusContext.js';\nimport type { WithChildren } from '../../types/with-children.js';\nimport { focusFirstDescendant } from '../../utils/focus-management/focus-first-descendant.js';\n\n// #region Types\n\n/**\n * Prop definition of the `FocusScope` component.\n * @internal\n */\nexport interface FocusScopeProps extends WithChildren {\n  /**\n   * If set to true, the focus scope automatically focuses the first focusable element inside.\n   * @defaultValue false\n   */\n  autoFocus?: boolean;\n  /**\n   * If set to true, the focus scope traps the focus inside.\n   * @defaultValue false\n   */\n  contain?: boolean;\n}\n// #endregion Types\n\n/**\n * @internal\n * The `FocusScope` helps you manage the focus when opening any overlay. If you\n * want to create a custom overlay, you can wrap the content of your overlay in the\n * `FocusScope` to help you make the overlay accessible and handle focus\n * appropriately.\n */\nexport const FocusScope = (props: FocusScopeProps) => {\n  const { autoFocus, contain, children } = props;\n  const focusContext = useFocusContext();\n  const wrapperRef = useRef<HTMLDivElement>(null);\n  const focusedElement = useActiveElement();\n  const triggerElement = useRef(focusedElement);\n\n  useEffect(() => {\n    if (contain || autoFocus) {\n      focusFirstDescendant(wrapperRef.current);\n    }\n\n    if (contain) {\n      focusContext.setBackgroundInertness(true);\n      const triggerElementCopy = triggerElement.current;\n\n      return () => {\n        focusContext.setBackgroundInertness(false);\n        // The focus must be restored on the trigger after removing the inert prop on\n        // AppRoot (rendering complete). SetTimeout creates a macrotask to change queueing order.\n        window.setTimeout(() => triggerElementCopy.focus(), 0);\n      };\n    }\n\n    if (!autoFocus && !contain) {\n      document.addEventListener('keydown', (e) => {\n        if (e.key !== 'Tab') {\n          return;\n        }\n\n        if (e.target === triggerElement.current) {\n          e.preventDefault();\n          focusFirstDescendant(wrapperRef.current);\n        }\n      });\n    }\n\n    const triggerElementCopy = triggerElement.current;\n\n    return () => {\n      // restore focus on trigger when unmounting the focusscope\n      triggerElementCopy.focus();\n    };\n\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [contain, autoFocus]);\n\n  return (\n    <div\n      style={{ display: 'contents' }}\n      ref={wrapperRef}\n      aria-labelledby={triggerElement.current.id}\n      // Prevents that focus is lost when clicking on non-focusable items inside (atm used in the internal Drawer).\n      // Probably worth considering moving that to the focusScope when redoing the overlays.\n      // tabIndex={-1}\n    >\n      {children}\n    </div>\n  );\n};\n\nFocusScope.displayName = 'FocusScope';\n"],
+  "sourcesContent": ["import React, { useEffect, useRef } from 'react';\n\nimport { useActiveElement } from '../../hooks/useActiveElement.js';\nimport { useFocusContext } from '../../hooks/useFocusContext.js';\nimport type { WithChildren } from '../../types/with-children.js';\nimport { focusFirstDescendant } from '../../utils/focus-management/focus-first-descendant.js';\n\n// #region Types\n\n/**\n * Prop definition of the `FocusScope` component.\n * @internal\n */\nexport interface FocusScopeProps extends WithChildren {\n  /**\n   * If set to true, the focus scope automatically focuses the first focusable element inside.\n   * @defaultValue false\n   */\n  autoFocus?: boolean;\n  /**\n   * If set to true, the focus scope traps the focus inside.\n   * @defaultValue false\n   */\n  contain?: boolean;\n}\n// #endregion Types\n\n/**\n * The `FocusScope` helps you manage the focus when opening any overlay. If you\n * want to create a custom overlay, you can wrap the content of your overlay in the\n * `FocusScope` to help you make the overlay accessible and handle focus\n * appropriately.\n * @internal\n */\nexport const FocusScope = (props: FocusScopeProps) => {\n  const { autoFocus, contain, children } = props;\n  const focusContext = useFocusContext();\n  const wrapperRef = useRef<HTMLDivElement>(null);\n  const focusedElement = useActiveElement();\n  const triggerElement = useRef(focusedElement);\n\n  useEffect(() => {\n    if (contain || autoFocus) {\n      focusFirstDescendant(wrapperRef.current);\n    }\n\n    if (contain) {\n      focusContext.setBackgroundInertness(true);\n      const triggerElementCopy = triggerElement.current;\n\n      return () => {\n        focusContext.setBackgroundInertness(false);\n        // The focus must be restored on the trigger after removing the inert prop on\n        // AppRoot (rendering complete). SetTimeout creates a macrotask to change queueing order.\n        window.setTimeout(() => triggerElementCopy.focus(), 0);\n      };\n    }\n\n    if (!autoFocus && !contain) {\n      document.addEventListener('keydown', (e) => {\n        if (e.key !== 'Tab') {\n          return;\n        }\n\n        if (e.target === triggerElement.current) {\n          e.preventDefault();\n          focusFirstDescendant(wrapperRef.current);\n        }\n      });\n    }\n\n    const triggerElementCopy = triggerElement.current;\n\n    return () => {\n      // restore focus on trigger when unmounting the focusscope\n      triggerElementCopy.focus();\n    };\n\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [contain, autoFocus]);\n\n  return (\n    <div\n      style={{ display: 'contents' }}\n      ref={wrapperRef}\n      aria-labelledby={triggerElement.current.id}\n      // Prevents that focus is lost when clicking on non-focusable items inside (atm used in the internal Drawer).\n      // Probably worth considering moving that to the focusScope when redoing the overlays.\n      // tabIndex={-1}\n    >\n      {children}\n    </div>\n  );\n};\n\nFocusScope.displayName = 'FocusScope';\n"],
   "mappings": "AAAA,OAAO,SAAS,WAAW,cAAc;AAEzC,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAEhC,SAAS,4BAA4B;AA6B9B,MAAM,aAAa,CAAC,UAA2B;AACpD,QAAM,EAAE,WAAW,SAAS,SAAS,IAAI;AACzC,QAAM,eAAe,gBAAgB;AACrC,QAAM,aAAa,OAAuB,IAAI;AAC9C,QAAM,iBAAiB,iBAAiB;AACxC,QAAM,iBAAiB,OAAO,cAAc;AAE5C,YAAU,MAAM;AACd,QAAI,WAAW,WAAW;AACxB,2BAAqB,WAAW,OAAO;AAAA,IACzC;AAEA,QAAI,SAAS;AACX,mBAAa,uBAAuB,IAAI;AACxC,YAAMA,sBAAqB,eAAe;AAE1C,aAAO,MAAM;AACX,qBAAa,uBAAuB,KAAK;AAGzC,eAAO,WAAW,MAAMA,oBAAmB,MAAM,GAAG,CAAC;AAAA,MACvD;AAAA,IACF;AAEA,QAAI,CAAC,aAAa,CAAC,SAAS;AAC1B,eAAS,iBAAiB,WAAW,CAAC,MAAM;AAC1C,YAAI,EAAE,QAAQ,OAAO;AACnB;AAAA,QACF;AAEA,YAAI,EAAE,WAAW,eAAe,SAAS;AACvC,YAAE,eAAe;AACjB,+BAAqB,WAAW,OAAO;AAAA,QACzC;AAAA,MACF,CAAC;AAAA,IACH;AAEA,UAAM,qBAAqB,eAAe;AAE1C,WAAO,MAAM;AAEX,yBAAmB,MAAM;AAAA,IAC3B;AAAA,EAGF,GAAG,CAAC,SAAS,SAAS,CAAC;AAEvB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,OAAO,EAAE,SAAS,WAAW;AAAA,MAC7B,KAAK;AAAA,MACL,mBAAiB,eAAe,QAAQ;AAAA;AAAA,IAKvC;AAAA,EACH;AAEJ;AAEA,WAAW,cAAc;",
   "names": ["triggerElementCopy"]
 }

package/esm/core/contexts/FocusContext.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/core/contexts/FocusContext.tsx"],
-  "sourcesContent": ["import { createContext } from 'react';\n\nimport type { Modality } from '../providers/FocusProvider.js';\n\n/**\n * Defines the contents of the FocusContext.\n * @internal\n */\nexport type FocusContextProps = {\n  backgroundInertness?: boolean;\n  modality: Modality;\n  setBackgroundInertness: (value: boolean) => void;\n};\n\n/**\n * @internal\n *\n * This context keeps all information needed for proper focus management.\n * @param modality - currently used pointer device\n * @param backgroundInertness - if the background (behind overlays) is currently inert (inactive)\n * @param setBackgroundInertness - updates the backgrounds active status\n */\nexport const FocusContext = createContext<FocusContextProps>({\n  modality: 'unknown',\n  backgroundInertness: undefined,\n  setBackgroundInertness: (value) => null,\n});\n"],
-  "mappings": "AAAA,SAAS,qBAAqB;AAsBvB,MAAM,eAAe,cAAiC;AAAA,EAC3D,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,wBAAwB,CAAC,UAAU;AACrC,CAAC;",
+  "sourcesContent": ["import { createContext } from 'react';\n\nimport type { Modality } from '../providers/FocusProvider.js';\n\n/**\n * Defines the contents of the FocusContext.\n * @internal\n */\nexport type FocusContextProps = {\n  backgroundInertness?: boolean;\n  modality: Modality;\n  setBackgroundInertness: (value: boolean) => void;\n};\n\n/**\n * This context keeps all information needed for proper focus management.\n * @param modality - currently used pointer device\n * @param backgroundInertness - if the background (behind overlays) is currently inert (inactive)\n * @param setBackgroundInertness - updates the backgrounds active status\n * @internal\n */\nexport const FocusContext = createContext<FocusContextProps>({\n  modality: 'unknown',\n  backgroundInertness: undefined,\n  setBackgroundInertness: (value) => null,\n});\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAqBvB,MAAM,eAAe,cAAiC;AAAA,EAC3D,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,wBAAwB,CAAC,UAAU;AACrC,CAAC;",
   "names": []
 }

package/esm/core/providers/FocusProvider.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/core/providers/FocusProvider.tsx"],
-  "sourcesContent": ["import React, { useCallback, useEffect, useState } from 'react';\n\nimport { FocusContext } from '../contexts/FocusContext.js';\nimport { useFocusContext } from '../hooks/useFocusContext.js';\nimport type { WithChildren } from '../types/with-children.js';\nimport { mergeProps } from '../utils/merge-props.js';\n\n// list of modifier keys commonly used in a mouse or keyboard combination,\n// see https://developer.mozilla.org/en-US/docs/Web/API/UI_Events/Keyboard_event_key_values#modifier_keys.\nconst ignoreMap = [\n  'Alt',\n  'AltGraph',\n  'CapsLock',\n  'Control',\n  'Fn',\n  'FnLock',\n  'Hyper',\n  'Meta', // Command (Mac), in some browsers also Windows-key\n  'NumLock',\n  'OS', // Windows-key\n  'ScrollLock',\n  'Super', // Virtual keyboard key\n  'Symbol',\n  'SymbolLock',\n];\n\n/** Look-up map of all event types and the corresponding modalities. */\nconst eventTypeMap: Record<string, string> = {\n  keydown: 'keyboard',\n  keyup: 'keyboard',\n  mousedown: 'mouse',\n  mousemove: 'mouse',\n  MSPointerDown: 'pointer',\n  MSPointerMove: 'pointer',\n  pointerdown: 'pointer',\n  pointermove: 'pointer',\n  touchstart: 'touch',\n  touchend: 'touch',\n  wheel: 'wheel',\n};\n\n/**\n * @internal\n * Type defining the modality options for the focus handling.\n */\nexport type Modality = 'keyboard' | 'pointer' | 'touch' | 'unknown';\n\n/**\n * All navigational keys that should be considered keyboard users,\n * see https://developer.mozilla.org/en-US/docs/Web/API/UI_Events/Keyboard_event_key_values#navigation_keys\n */\nconst navigationalKeys = [\n  'Tab',\n  'Esc',\n  'Escape',\n  ' ',\n  'ArrowDown',\n  'Down',\n  'ArrowUp',\n  'Up',\n  'ArrowLeft',\n  'Left',\n  'ArrowRight',\n  'Right',\n  'End',\n  'Home',\n  'PageDown',\n  'PageUp',\n];\n\n/**\n * @internal\n *\n * Provider that can be reused in components for storing the focus context props.\n * Loosely inspired by [what-input-js](https://github.com/ten1seven/what-input/blob/main/src/scripts/what-input.js).\n */\nexport const FocusProvider = ({ children }: WithChildren) => {\n  const [backgroundInertness, setBackgroundInertness] = useState(false);\n  const focusContext = useFocusContext();\n  const [modality, setModality] = useState<Modality>('unknown');\n\n  const setKeyboardInputModality = useCallback((event: KeyboardEvent) => {\n    if (ignoreMap.includes(event.key)) {\n      setModality('pointer');\n      return;\n    }\n\n    if (!event.target || navigationalKeys.includes(event.key)) {\n      setModality('keyboard');\n    }\n  }, []);\n\n  const setMouseInputModality = useCallback((event: MouseEvent) => {\n    switch (eventTypeMap[event.type]) {\n      case 'touch':\n      case 'pen':\n        return setModality('touch');\n      case 'mouse':\n      case 'pointer':\n      case 'wheel':\n        return setModality('pointer');\n      default:\n        return 'unknown';\n    }\n  }, []);\n\n  useEffect(() => {\n    window.addEventListener('pointerdown', setMouseInputModality);\n    // we need to rely on the keydown event (already in the capture phase) here so we don't break usages where the event default behavior is prevented or propagation is stopped,\n    // which would otherwise get the wrong, initial, modality (unknown); by using the capture phase, we can ensure we set the modality correctly before the other events occur\n    window.addEventListener('keydown', setKeyboardInputModality, {\n      capture: true,\n    });\n    window.addEventListener('wheel', setMouseInputModality);\n\n    return () => {\n      window.removeEventListener('pointerdown', setMouseInputModality);\n      window.removeEventListener('keydown', setKeyboardInputModality, {\n        capture: true,\n      });\n      window.removeEventListener('wheel', setMouseInputModality);\n    };\n  }, [setKeyboardInputModality, setMouseInputModality]);\n\n  const focusProps = backgroundInertness\n    ? {\n        inert: 'true',\n        tabIndex: -1,\n        'aria-hidden': true,\n      }\n    : { inert: undefined, tabIndex: undefined, 'aria-hidden': false };\n\n  return (\n    <FocusContext.Provider\n      value={{\n        ...mergeProps(focusContext, {\n          backgroundInertness,\n          setBackgroundInertness,\n          modality,\n        }),\n      }}\n    >\n      <div {...focusProps}>{children}</div>\n    </FocusContext.Provider>\n  );\n};\n\nFocusProvider['displayName'] = 'FocusProvider';\n"],
-  "mappings": "AAAA,OAAO,SAAS,aAAa,WAAW,gBAAgB;AAExD,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAEhC,SAAS,kBAAkB;AAI3B,MAAM,YAAY;AAAA,EAChB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AACF;AAGA,MAAM,eAAuC;AAAA,EAC3C,SAAS;AAAA,EACT,OAAO;AAAA,EACP,WAAW;AAAA,EACX,WAAW;AAAA,EACX,eAAe;AAAA,EACf,eAAe;AAAA,EACf,aAAa;AAAA,EACb,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,OAAO;AACT;AAYA,MAAM,mBAAmB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQO,MAAM,gBAAgB,CAAC,EAAE,SAAS,MAAoB;AAC3D,QAAM,CAAC,qBAAqB,sBAAsB,IAAI,SAAS,KAAK;AACpE,QAAM,eAAe,gBAAgB;AACrC,QAAM,CAAC,UAAU,WAAW,IAAI,SAAmB,SAAS;AAE5D,QAAM,2BAA2B,YAAY,CAAC,UAAyB;AACrE,QAAI,UAAU,SAAS,MAAM,GAAG,GAAG;AACjC,kBAAY,SAAS;AACrB;AAAA,IACF;AAEA,QAAI,CAAC,MAAM,UAAU,iBAAiB,SAAS,MAAM,GAAG,GAAG;AACzD,kBAAY,UAAU;AAAA,IACxB;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,QAAM,wBAAwB,YAAY,CAAC,UAAsB;AAC/D,YAAQ,aAAa,MAAM,IAAI,GAAG;AAAA,MAChC,KAAK;AAAA,MACL,KAAK;AACH,eAAO,YAAY,OAAO;AAAA,MAC5B,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACH,eAAO,YAAY,SAAS;AAAA,MAC9B;AACE,eAAO;AAAA,IACX;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM;AACd,WAAO,iBAAiB,eAAe,qBAAqB;AAG5D,WAAO,iBAAiB,WAAW,0BAA0B;AAAA,MAC3D,SAAS;AAAA,IACX,CAAC;AACD,WAAO,iBAAiB,SAAS,qBAAqB;AAEtD,WAAO,MAAM;AACX,aAAO,oBAAoB,eAAe,qBAAqB;AAC/D,aAAO,oBAAoB,WAAW,0BAA0B;AAAA,QAC9D,SAAS;AAAA,MACX,CAAC;AACD,aAAO,oBAAoB,SAAS,qBAAqB;AAAA,IAC3D;AAAA,EACF,GAAG,CAAC,0BAA0B,qBAAqB,CAAC;AAEpD,QAAM,aAAa,sBACf;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,eAAe;AAAA,EACjB,IACA,EAAE,OAAO,QAAW,UAAU,QAAW,eAAe,MAAM;AAElE,SACE;AAAA,IAAC,aAAa;AAAA,IAAb;AAAA,MACC,OAAO;AAAA,QACL,GAAG,WAAW,cAAc;AAAA,UAC1B;AAAA,UACA;AAAA,UACA;AAAA,QACF,CAAC;AAAA,MACH;AAAA;AAAA,IAEA,oCAAC,SAAK,GAAG,cAAa,QAAS;AAAA,EACjC;AAEJ;AAEA,cAAc,aAAa,IAAI;",
+  "sourcesContent": ["import React, { useCallback, useEffect, useState } from 'react';\n\nimport { FocusContext } from '../contexts/FocusContext.js';\nimport { useFocusContext } from '../hooks/useFocusContext.js';\nimport type { WithChildren } from '../types/with-children.js';\nimport { mergeProps } from '../utils/merge-props.js';\n\n// list of modifier keys commonly used in a mouse or keyboard combination,\n// see https://developer.mozilla.org/en-US/docs/Web/API/UI_Events/Keyboard_event_key_values#modifier_keys.\nconst ignoreMap = [\n  'Alt',\n  'AltGraph',\n  'CapsLock',\n  'Control',\n  'Fn',\n  'FnLock',\n  'Hyper',\n  'Meta', // Command (Mac), in some browsers also Windows-key\n  'NumLock',\n  'OS', // Windows-key\n  'ScrollLock',\n  'Super', // Virtual keyboard key\n  'Symbol',\n  'SymbolLock',\n];\n\n/** Look-up map of all event types and the corresponding modalities. */\nconst eventTypeMap: Record<string, string> = {\n  keydown: 'keyboard',\n  keyup: 'keyboard',\n  mousedown: 'mouse',\n  mousemove: 'mouse',\n  MSPointerDown: 'pointer',\n  MSPointerMove: 'pointer',\n  pointerdown: 'pointer',\n  pointermove: 'pointer',\n  touchstart: 'touch',\n  touchend: 'touch',\n  wheel: 'wheel',\n};\n\n/**\n * Type defining the modality options for the focus handling.\n * @internal\n */\nexport type Modality = 'keyboard' | 'pointer' | 'touch' | 'unknown';\n\n/**\n * All navigational keys that should be considered keyboard users,\n * see https://developer.mozilla.org/en-US/docs/Web/API/UI_Events/Keyboard_event_key_values#navigation_keys\n */\nconst navigationalKeys = [\n  'Tab',\n  'Esc',\n  'Escape',\n  ' ',\n  'ArrowDown',\n  'Down',\n  'ArrowUp',\n  'Up',\n  'ArrowLeft',\n  'Left',\n  'ArrowRight',\n  'Right',\n  'End',\n  'Home',\n  'PageDown',\n  'PageUp',\n];\n\n/**\n * Provider that can be reused in components for storing the focus context props.\n * Loosely inspired by [what-input-js](https://github.com/ten1seven/what-input/blob/main/src/scripts/what-input.js).\n * @internal\n */\nexport const FocusProvider = ({ children }: WithChildren) => {\n  const [backgroundInertness, setBackgroundInertness] = useState(false);\n  const focusContext = useFocusContext();\n  const [modality, setModality] = useState<Modality>('unknown');\n\n  const setKeyboardInputModality = useCallback((event: KeyboardEvent) => {\n    if (ignoreMap.includes(event.key)) {\n      setModality('pointer');\n      return;\n    }\n\n    if (!event.target || navigationalKeys.includes(event.key)) {\n      setModality('keyboard');\n    }\n  }, []);\n\n  const setMouseInputModality = useCallback((event: MouseEvent) => {\n    switch (eventTypeMap[event.type]) {\n      case 'touch':\n      case 'pen':\n        return setModality('touch');\n      case 'mouse':\n      case 'pointer':\n      case 'wheel':\n        return setModality('pointer');\n      default:\n        return 'unknown';\n    }\n  }, []);\n\n  useEffect(() => {\n    window.addEventListener('pointerdown', setMouseInputModality);\n    // we need to rely on the keydown event (already in the capture phase) here so we don't break usages where the event default behavior is prevented or propagation is stopped,\n    // which would otherwise get the wrong, initial, modality (unknown); by using the capture phase, we can ensure we set the modality correctly before the other events occur\n    window.addEventListener('keydown', setKeyboardInputModality, {\n      capture: true,\n    });\n    window.addEventListener('wheel', setMouseInputModality);\n\n    return () => {\n      window.removeEventListener('pointerdown', setMouseInputModality);\n      window.removeEventListener('keydown', setKeyboardInputModality, {\n        capture: true,\n      });\n      window.removeEventListener('wheel', setMouseInputModality);\n    };\n  }, [setKeyboardInputModality, setMouseInputModality]);\n\n  const focusProps = backgroundInertness\n    ? {\n        inert: 'true',\n        tabIndex: -1,\n        'aria-hidden': true,\n      }\n    : { inert: undefined, tabIndex: undefined, 'aria-hidden': false };\n\n  return (\n    <FocusContext.Provider\n      value={{\n        ...mergeProps(focusContext, {\n          backgroundInertness,\n          setBackgroundInertness,\n          modality,\n        }),\n      }}\n    >\n      <div {...focusProps}>{children}</div>\n    </FocusContext.Provider>\n  );\n};\n\nFocusProvider['displayName'] = 'FocusProvider';\n"],
+  "mappings": "AAAA,OAAO,SAAS,aAAa,WAAW,gBAAgB;AAExD,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAEhC,SAAS,kBAAkB;AAI3B,MAAM,YAAY;AAAA,EAChB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AACF;AAGA,MAAM,eAAuC;AAAA,EAC3C,SAAS;AAAA,EACT,OAAO;AAAA,EACP,WAAW;AAAA,EACX,WAAW;AAAA,EACX,eAAe;AAAA,EACf,eAAe;AAAA,EACf,aAAa;AAAA,EACb,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,OAAO;AACT;AAYA,MAAM,mBAAmB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOO,MAAM,gBAAgB,CAAC,EAAE,SAAS,MAAoB;AAC3D,QAAM,CAAC,qBAAqB,sBAAsB,IAAI,SAAS,KAAK;AACpE,QAAM,eAAe,gBAAgB;AACrC,QAAM,CAAC,UAAU,WAAW,IAAI,SAAmB,SAAS;AAE5D,QAAM,2BAA2B,YAAY,CAAC,UAAyB;AACrE,QAAI,UAAU,SAAS,MAAM,GAAG,GAAG;AACjC,kBAAY,SAAS;AACrB;AAAA,IACF;AAEA,QAAI,CAAC,MAAM,UAAU,iBAAiB,SAAS,MAAM,GAAG,GAAG;AACzD,kBAAY,UAAU;AAAA,IACxB;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,QAAM,wBAAwB,YAAY,CAAC,UAAsB;AAC/D,YAAQ,aAAa,MAAM,IAAI,GAAG;AAAA,MAChC,KAAK;AAAA,MACL,KAAK;AACH,eAAO,YAAY,OAAO;AAAA,MAC5B,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACH,eAAO,YAAY,SAAS;AAAA,MAC9B;AACE,eAAO;AAAA,IACX;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM;AACd,WAAO,iBAAiB,eAAe,qBAAqB;AAG5D,WAAO,iBAAiB,WAAW,0BAA0B;AAAA,MAC3D,SAAS;AAAA,IACX,CAAC;AACD,WAAO,iBAAiB,SAAS,qBAAqB;AAEtD,WAAO,MAAM;AACX,aAAO,oBAAoB,eAAe,qBAAqB;AAC/D,aAAO,oBAAoB,WAAW,0BAA0B;AAAA,QAC9D,SAAS;AAAA,MACX,CAAC;AACD,aAAO,oBAAoB,SAAS,qBAAqB;AAAA,IAC3D;AAAA,EACF,GAAG,CAAC,0BAA0B,qBAAqB,CAAC;AAEpD,QAAM,aAAa,sBACf;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,eAAe;AAAA,EACjB,IACA,EAAE,OAAO,QAAW,UAAU,QAAW,eAAe,MAAM;AAElE,SACE;AAAA,IAAC,aAAa;AAAA,IAAb;AAAA,MACC,OAAO;AAAA,QACL,GAAG,WAAW,cAAc;AAAA,UAC1B;AAAA,UACA;AAAA,UACA;AAAA,QACF,CAAC;AAAA,MACH;AAAA;AAAA,IAEA,oCAAC,SAAK,GAAG,cAAa,QAAS;AAAA,EACjC;AAEJ;AAEA,cAAc,aAAa,IAAI;",
   "names": []
 }

package/esm/layouts/hooks/useBreakpoint.js

@@ -0,0 +1,44 @@
+import { useCallback, useMemo, useSyncExternalStore } from "react";
+function useBreakpoint(queries, ssrInitialValue) {
+  const _ssrInitialValue = ssrInitialValue ?? (Array.isArray(queries) ? [] : false);
+  const mediaQueryLists = useMemo(() => {
+    const queryStrings = Array.isArray(queries) ? queries : [queries];
+    return queryStrings.map((q) => window.matchMedia(q));
+  }, [queries]);
+  const subscribe = useCallback(
+    (callback) => {
+      mediaQueryLists.forEach(
+        (mql) => mql.addEventListener("change", callback)
+      );
+      return () => {
+        mediaQueryLists.forEach(
+          (mql) => mql.removeEventListener("change", callback)
+        );
+      };
+    },
+    [mediaQueryLists]
+  );
+  const getSnapshot = () => {
+    return JSON.stringify(mediaQueryLists.map((q) => q.matches));
+  };
+  const getServerSnapshot = () => {
+    if (Array.isArray(_ssrInitialValue)) {
+      const adjustedValue = _ssrInitialValue.concat(Array(queries.length).fill(false)).slice(0, queries.length);
+      return JSON.stringify(adjustedValue);
+    }
+    return JSON.stringify([_ssrInitialValue]);
+  };
+  const queryValues = useSyncExternalStore(
+    subscribe,
+    getSnapshot,
+    getServerSnapshot
+  );
+  if (!Array.isArray(queries)) {
+    return JSON.parse(queryValues)[0];
+  }
+  return JSON.parse(queryValues);
+}
+export {
+  useBreakpoint
+};
+//# sourceMappingURL=useBreakpoint.js.map

package/esm/layouts/hooks/useBreakpoint.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/layouts/hooks/useBreakpoint.ts"],
+  "sourcesContent": ["// taken and adapted from https://github.com/jepser/use-match-media\n\nimport { useCallback, useMemo, useSyncExternalStore } from 'react';\n\n/**\n * `useBreakpoint` is a hook used to determine if the document matches the media\n * query string (or media query list). It will listen to the breakpoints specified\n * and will return a boolean value indicating if this media query is met or not.\n * @public\n */\nfunction useBreakpoint(\n  /** Media Query you want to test, eg '(min-width: 800px)' */\n  query: string,\n  /** Default value (fallback value to support SSR)\n   * @defaultValue false\n   */\n  ssrInitialValue?: boolean,\n): boolean;\n\n/**\n * `useBreakpoint` is a hook used to determine if the document matches the media\n * query string (or media query list). It will listen to the breakpoints specified\n * and will return a boolean value indicating if this media query is met or not.\n * @public\n */\nfunction useBreakpoint(\n  /** Media Queries you want to test, eg '[(min-width: 400px), (min-width: 800px)]' */\n  queries: string[],\n  /** Default values (fallback values to support SSR)\n   * @defaultValue []\n   */\n  ssrInitialValue?: boolean[],\n): boolean[];\n\n/** @public */\nfunction useBreakpoint(\n  queries: string | string[],\n  ssrInitialValue?: boolean | boolean[],\n): boolean | boolean[] {\n  const _ssrInitialValue =\n    ssrInitialValue ?? (Array.isArray(queries) ? [] : false);\n\n  const mediaQueryLists = useMemo(() => {\n    const queryStrings = Array.isArray(queries) ? queries : [queries];\n    return queryStrings.map((q) => window.matchMedia(q));\n  }, [queries]);\n\n  const subscribe = useCallback(\n    (callback: () => void) => {\n      mediaQueryLists.forEach((mql) =>\n        mql.addEventListener('change', callback),\n      );\n      return (): void => {\n        mediaQueryLists.forEach((mql) =>\n          mql.removeEventListener('change', callback),\n        );\n      };\n    },\n    [mediaQueryLists],\n  );\n\n  /**\n   * Generates an immutable snapshot of the current media query matches.\n   * This is necessary to ensure the snapshot remains consistent and does not change.\n   * @see {@link https://react.dev/reference/react/useSyncExternalStore#im-getting-an-error-the-result-of-getsnapshot-should-be-cached}\n   */\n  const getSnapshot = () => {\n    return JSON.stringify(mediaQueryLists.map((q) => q.matches));\n  };\n\n  const getServerSnapshot = () => {\n    if (Array.isArray(_ssrInitialValue)) {\n      // Ensure the array is filled with false values or sliced to match queries.length\n      const adjustedValue = _ssrInitialValue\n        .concat(Array(queries.length).fill(false))\n        .slice(0, queries.length);\n      return JSON.stringify(adjustedValue);\n    }\n    return JSON.stringify([_ssrInitialValue] || [false]);\n  };\n\n  const queryValues = useSyncExternalStore(\n    subscribe,\n    getSnapshot,\n    getServerSnapshot,\n  );\n\n  if (!Array.isArray(queries)) {\n    return JSON.parse(queryValues)[0];\n  }\n  return JSON.parse(queryValues);\n}\n\nexport { useBreakpoint };\n"],
+  "mappings": "AAEA,SAAS,aAAa,SAAS,4BAA4B;AAiC3D,SAAS,cACP,SACA,iBACqB;AACrB,QAAM,mBACJ,oBAAoB,MAAM,QAAQ,OAAO,IAAI,CAAC,IAAI;AAEpD,QAAM,kBAAkB,QAAQ,MAAM;AACpC,UAAM,eAAe,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,OAAO;AAChE,WAAO,aAAa,IAAI,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAAA,EACrD,GAAG,CAAC,OAAO,CAAC;AAEZ,QAAM,YAAY;AAAA,IAChB,CAAC,aAAyB;AACxB,sBAAgB;AAAA,QAAQ,CAAC,QACvB,IAAI,iBAAiB,UAAU,QAAQ;AAAA,MACzC;AACA,aAAO,MAAY;AACjB,wBAAgB;AAAA,UAAQ,CAAC,QACvB,IAAI,oBAAoB,UAAU,QAAQ;AAAA,QAC5C;AAAA,MACF;AAAA,IACF;AAAA,IACA,CAAC,eAAe;AAAA,EAClB;AAOA,QAAM,cAAc,MAAM;AACxB,WAAO,KAAK,UAAU,gBAAgB,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;AAAA,EAC7D;AAEA,QAAM,oBAAoB,MAAM;AAC9B,QAAI,MAAM,QAAQ,gBAAgB,GAAG;AAEnC,YAAM,gBAAgB,iBACnB,OAAO,MAAM,QAAQ,MAAM,EAAE,KAAK,KAAK,CAAC,EACxC,MAAM,GAAG,QAAQ,MAAM;AAC1B,aAAO,KAAK,UAAU,aAAa;AAAA,IACrC;AACA,WAAO,KAAK,UAAU,CAAC,gBAAgB,CAAY;AAAA,EACrD;AAEA,QAAM,cAAc;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,MAAI,CAAC,MAAM,QAAQ,OAAO,GAAG;AAC3B,WAAO,KAAK,MAAM,WAAW,EAAE,CAAC;AAAA,EAClC;AACA,SAAO,KAAK,MAAM,WAAW;AAC/B;",
+  "names": []
+}

package/esm/layouts/index.js

@@ -4,12 +4,14 @@ import { Divider } from "./divider/Divider.js";
 import { Container } from "./container/Container.js";
 import { Surface } from "./surface/Surface.js";
 import { surfaceBorderRadius } from "./surface/variables.sty.js";
+import { useBreakpoint } from "./hooks/useBreakpoint.js";
 export {
   Container,
   Divider,
   Flex,
   Grid,
   Surface,
-  surfaceBorderRadius as _surfaceBorderRadius
+  surfaceBorderRadius as _surfaceBorderRadius,
+  useBreakpoint
 };
 //# sourceMappingURL=index.js.map

package/esm/layouts/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/layouts/index.ts"],
-  "sourcesContent": ["export { Flex, type FlexOwnProps, type FlexProps } from './flex/Flex.js';\nexport { Grid, type GridOwnProps, type GridProps } from './grid/Grid.js';\nexport { Divider } from './divider/Divider.js';\nexport type { DividerProps } from './divider/Divider.js';\nexport { Container } from './container/Container.js';\nexport type {\n  ContainerOwnProps,\n  ContainerProps,\n} from './container/Container.js';\nexport type { LayoutSizeCSS } from './types/layout.types.js';\nexport { Surface } from './surface/Surface.js';\nexport type { SurfaceOwnProps, SurfaceProps } from './surface/Surface.js';\nexport { surfaceBorderRadius as _surfaceBorderRadius } from './surface/variables.sty.js';\n"],
-  "mappings": "AAAA,SAAS,YAA+C;AACxD,SAAS,YAA+C;AACxD,SAAS,eAAe;AAExB,SAAS,iBAAiB;AAM1B,SAAS,eAAe;AAExB,SAAgC,2BAA4B;",
+  "sourcesContent": ["export { Flex, type FlexOwnProps, type FlexProps } from './flex/Flex.js';\nexport { Grid, type GridOwnProps, type GridProps } from './grid/Grid.js';\nexport { Divider } from './divider/Divider.js';\nexport type { DividerProps } from './divider/Divider.js';\nexport { Container } from './container/Container.js';\nexport type {\n  ContainerOwnProps,\n  ContainerProps,\n} from './container/Container.js';\nexport type { LayoutSizeCSS } from './types/layout.types.js';\nexport { Surface } from './surface/Surface.js';\nexport type { SurfaceOwnProps, SurfaceProps } from './surface/Surface.js';\nexport { surfaceBorderRadius as _surfaceBorderRadius } from './surface/variables.sty.js';\nexport { useBreakpoint } from './hooks/useBreakpoint.js';\n"],
+  "mappings": "AAAA,SAAS,YAA+C;AACxD,SAAS,YAA+C;AACxD,SAAS,eAAe;AAExB,SAAS,iBAAiB;AAM1B,SAAS,eAAe;AAExB,SAAgC,2BAA4B;AAC5D,SAAS,qBAAqB;",
   "names": []
 }

package/esm/typography/text/Text.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/typography/text/Text.tsx"],
-  "sourcesContent": ["import clsx from 'clsx';\nimport React, { type ElementType, type ReactElement, forwardRef } from 'react';\n\nimport { textCSS } from './Text.sty.js';\nimport type { AriaLabelingProps } from '../../core/types/a11y-props.js';\nimport type { DataTestId } from '../../core/types/data-props.js';\nimport type { DOMProps } from '../../core/types/dom.js';\nimport type { MaskingProps } from '../../core/types/masking-props.js';\nimport type { PolymorphicComponentProps } from '../../core/types/polymorph.js';\nimport type { StylingProps } from '../../core/types/styling-props.js';\nimport type { WithChildren } from '../../core/types/with-children.js';\nimport { textStyleCSS } from '../../styles/textStyle.sty.js';\n\n/**\n * The props for the text component without any props coming from polymorphing.\n * @public\n */\nexport interface TextOwnProps\n  extends WithChildren,\n    DOMProps,\n    AriaLabelingProps,\n    StylingProps,\n    DataTestId,\n    MaskingProps {\n  /** Sets the text style. Variants include \"base\", \"base-emphasized\", etc. */\n  textStyle?: 'base' | 'base-emphasized' | 'small' | 'small-emphasized';\n  /** Sets the font style. Can either be \"text\" or \"code\" */\n  fontStyle?: 'text' | 'code';\n}\n\n/**\n * @public\n * Combined props for the text component - polymorphing and own props. */\nexport type TextProps<E extends ElementType> = PolymorphicComponentProps<\n  E,\n  TextOwnProps\n>;\n\n/**\n * Use the `Text` component for text that is rendered without any semantic markup.\n * @public\n */\nexport const Text: <E extends ElementType = 'span'>(\n  props: TextProps<E>,\n) => ReactElement | null = /* @__PURE__ */ forwardRef(\n  <E extends ElementType>(\n    {\n      children,\n      textStyle,\n      fontStyle,\n      as,\n      className: consumerClassName,\n      style: consumerStyle,\n      'data-testid': dataTestId,\n      'data-dtrum-mask': dataDtrumMask,\n      'data-dtrum-allow': dataDtrumAllow,\n      ...remainingProps\n    }: TextProps<E>,\n    ref: typeof remainingProps.ref,\n  ) => {\n    const TextTag = as || 'span';\n\n    let ellipsis: undefined | 'singleLine' | 'multiLine';\n\n    return (\n      <TextTag\n        data-testid={dataTestId}\n        data-dtrum-mask={dataDtrumMask}\n        data-dtrum-allow={dataDtrumAllow}\n        ref={ref}\n        className={clsx([\n          textCSS({ ellipsis }),\n          (fontStyle || textStyle) && textStyleCSS({ fontStyle, textStyle }),\n          consumerClassName,\n        ])}\n        style={consumerStyle}\n        {...remainingProps}\n      >\n        {children}\n      </TextTag>\n    );\n  },\n);\n\n(Text as typeof Text & { displayName: string }).displayName = 'Text';\n"],
-  "mappings": "AAAA,OAAO,UAAU;AACjB,OAAO,SAA8C,kBAAkB;AAEvE,SAAS,eAAe;AAQxB,SAAS,oBAAoB;AA+BtB,MAAM,OAE8B;AAAA,EACzC,CACE;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,OAAO;AAAA,IACP,eAAe;AAAA,IACf,mBAAmB;AAAA,IACnB,oBAAoB;AAAA,IACpB,GAAG;AAAA,EACL,GACA,QACG;AACH,UAAM,UAAU,MAAM;AAEtB,QAAI;AAEJ,WACE;AAAA,MAAC;AAAA;AAAA,QACC,eAAa;AAAA,QACb,mBAAiB;AAAA,QACjB,oBAAkB;AAAA,QAClB;AAAA,QACA,WAAW,KAAK;AAAA,UACd,QAAQ,EAAE,SAAS,CAAC;AAAA,WACnB,aAAa,cAAc,aAAa,EAAE,WAAW,UAAU,CAAC;AAAA,UACjE;AAAA,QACF,CAAC;AAAA,QACD,OAAO;AAAA,QACN,GAAG;AAAA;AAAA,MAEH;AAAA,IACH;AAAA,EAEJ;AACF;AAEC,KAA+C,cAAc;",
+  "sourcesContent": ["import clsx from 'clsx';\nimport React, { type ElementType, type ReactElement, forwardRef } from 'react';\n\nimport { textCSS } from './Text.sty.js';\nimport type { AriaLabelingProps } from '../../core/types/a11y-props.js';\nimport type { DataTestId } from '../../core/types/data-props.js';\nimport type { DOMProps } from '../../core/types/dom.js';\nimport type { MaskingProps } from '../../core/types/masking-props.js';\nimport type { PolymorphicComponentProps } from '../../core/types/polymorph.js';\nimport type { StylingProps } from '../../core/types/styling-props.js';\nimport type { WithChildren } from '../../core/types/with-children.js';\nimport { textStyleCSS } from '../../styles/textStyle.sty.js';\n\n/**\n * The props for the text component without any props coming from polymorphing.\n * @public\n */\nexport interface TextOwnProps\n  extends WithChildren,\n    DOMProps,\n    AriaLabelingProps,\n    StylingProps,\n    DataTestId,\n    MaskingProps {\n  /** Sets the text style. Variants include \"base\", \"base-emphasized\", etc. */\n  textStyle?: 'base' | 'base-emphasized' | 'small' | 'small-emphasized';\n  /** Sets the font style. Can either be \"text\" or \"code\" */\n  fontStyle?: 'text' | 'code';\n}\n\n/**\n * Combined props for the text component - polymorphing and own props.\n * @public\n */\nexport type TextProps<E extends ElementType> = PolymorphicComponentProps<\n  E,\n  TextOwnProps\n>;\n\n/**\n * Use the `Text` component for text that is rendered without any semantic markup.\n * @public\n */\nexport const Text: <E extends ElementType = 'span'>(\n  props: TextProps<E>,\n) => ReactElement | null = /* @__PURE__ */ forwardRef(\n  <E extends ElementType>(\n    {\n      children,\n      textStyle,\n      fontStyle,\n      as,\n      className: consumerClassName,\n      style: consumerStyle,\n      'data-testid': dataTestId,\n      'data-dtrum-mask': dataDtrumMask,\n      'data-dtrum-allow': dataDtrumAllow,\n      ...remainingProps\n    }: TextProps<E>,\n    ref: typeof remainingProps.ref,\n  ) => {\n    const TextTag = as || 'span';\n\n    let ellipsis: undefined | 'singleLine' | 'multiLine';\n\n    return (\n      <TextTag\n        data-testid={dataTestId}\n        data-dtrum-mask={dataDtrumMask}\n        data-dtrum-allow={dataDtrumAllow}\n        ref={ref}\n        className={clsx([\n          textCSS({ ellipsis }),\n          (fontStyle || textStyle) && textStyleCSS({ fontStyle, textStyle }),\n          consumerClassName,\n        ])}\n        style={consumerStyle}\n        {...remainingProps}\n      >\n        {children}\n      </TextTag>\n    );\n  },\n);\n\n(Text as typeof Text & { displayName: string }).displayName = 'Text';\n"],
+  "mappings": "AAAA,OAAO,UAAU;AACjB,OAAO,SAA8C,kBAAkB;AAEvE,SAAS,eAAe;AAQxB,SAAS,oBAAoB;AAgCtB,MAAM,OAE8B;AAAA,EACzC,CACE;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,OAAO;AAAA,IACP,eAAe;AAAA,IACf,mBAAmB;AAAA,IACnB,oBAAoB;AAAA,IACpB,GAAG;AAAA,EACL,GACA,QACG;AACH,UAAM,UAAU,MAAM;AAEtB,QAAI;AAEJ,WACE;AAAA,MAAC;AAAA;AAAA,QACC,eAAa;AAAA,QACb,mBAAiB;AAAA,QACjB,oBAAkB;AAAA,QAClB;AAAA,QACA,WAAW,KAAK;AAAA,UACd,QAAQ,EAAE,SAAS,CAAC;AAAA,WACnB,aAAa,cAAc,aAAa,EAAE,WAAW,UAAU,CAAC;AAAA,UACjE;AAAA,QACF,CAAC;AAAA,QACD,OAAO;AAAA,QACN,GAAG;AAAA;AAAA,MAEH;AAAA,IACH;AAAA,EAEJ;AACF;AAEC,KAA+C,cAAc;",
   "names": []
 }

package/layouts/divider/Divider.d.ts

@@ -36,4 +36,4 @@ export interface DividerProps extends StylingProps, DataTestId {
  * The `Divider` component visually separates groups of content.
  * @public
  */
-export declare const Divider: (props: DividerProps & React.RefAttributes<HTMLDivElement | HTMLHRElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Divider: (props: DividerProps & React.RefAttributes<HTMLDivElement | HTMLHRElement>) => React.ReactElement | null;

package/layouts/hooks/useBreakpoint.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `useBreakpoint` is a hook used to determine if the document matches the media
+ * query string (or media query list). It will listen to the breakpoints specified
+ * and will return a boolean value indicating if this media query is met or not.
+ * @public
+ */
+declare function useBreakpoint(
+/** Media Query you want to test, eg '(min-width: 800px)' */
+query: string, 
+/** Default value (fallback value to support SSR)
+ * @defaultValue false
+ */
+ssrInitialValue?: boolean): boolean;
+/**
+ * `useBreakpoint` is a hook used to determine if the document matches the media
+ * query string (or media query list). It will listen to the breakpoints specified
+ * and will return a boolean value indicating if this media query is met or not.
+ * @public
+ */
+declare function useBreakpoint(
+/** Media Queries you want to test, eg '[(min-width: 400px), (min-width: 800px)]' */
+queries: string[], 
+/** Default values (fallback values to support SSR)
+ * @defaultValue []
+ */
+ssrInitialValue?: boolean[]): boolean[];
+export { useBreakpoint };

package/layouts/hooks/useBreakpoint.js

@@ -0,0 +1,62 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useBreakpoint_exports = {};
+__export(useBreakpoint_exports, {
+  useBreakpoint: () => useBreakpoint
+});
+module.exports = __toCommonJS(useBreakpoint_exports);
+var import_react = require("react");
+function useBreakpoint(queries, ssrInitialValue) {
+  const _ssrInitialValue = ssrInitialValue ?? (Array.isArray(queries) ? [] : false);
+  const mediaQueryLists = (0, import_react.useMemo)(() => {
+    const queryStrings = Array.isArray(queries) ? queries : [queries];
+    return queryStrings.map((q) => window.matchMedia(q));
+  }, [queries]);
+  const subscribe = (0, import_react.useCallback)(
+    (callback) => {
+      mediaQueryLists.forEach(
+        (mql) => mql.addEventListener("change", callback)
+      );
+      return () => {
+        mediaQueryLists.forEach(
+          (mql) => mql.removeEventListener("change", callback)
+        );
+      };
+    },
+    [mediaQueryLists]
+  );
+  const getSnapshot = () => {
+    return JSON.stringify(mediaQueryLists.map((q) => q.matches));
+  };
+  const getServerSnapshot = () => {
+    if (Array.isArray(_ssrInitialValue)) {
+      const adjustedValue = _ssrInitialValue.concat(Array(queries.length).fill(false)).slice(0, queries.length);
+      return JSON.stringify(adjustedValue);
+    }
+    return JSON.stringify([_ssrInitialValue]);
+  };
+  const queryValues = (0, import_react.useSyncExternalStore)(
+    subscribe,
+    getSnapshot,
+    getServerSnapshot
+  );
+  if (!Array.isArray(queries)) {
+    return JSON.parse(queryValues)[0];
+  }
+  return JSON.parse(queryValues);
+}

package/layouts/index.d.ts

@@ -8,3 +8,4 @@ export type { LayoutSizeCSS } from './types/layout.types.js';
 export { Surface } from './surface/Surface.js';
 export type { SurfaceOwnProps, SurfaceProps } from './surface/Surface.js';
 export { surfaceBorderRadius as _surfaceBorderRadius } from './surface/variables.css.js';
+export { useBreakpoint } from './hooks/useBreakpoint.js';

package/layouts/index.js

@@ -22,7 +22,8 @@ __export(layouts_exports, {
   Flex: () => import_Flex.Flex,
   Grid: () => import_Grid.Grid,
   Surface: () => import_Surface.Surface,
-  _surfaceBorderRadius: () => import_variables_css.surfaceBorderRadius
+  _surfaceBorderRadius: () => import_variables_css.surfaceBorderRadius,
+  useBreakpoint: () => import_useBreakpoint.useBreakpoint
 });
 module.exports = __toCommonJS(layouts_exports);
 var import_Flex = require("./flex/Flex.js");
@@ -31,3 +32,4 @@ var import_Divider = require("./divider/Divider.js");
 var import_Container = require("./container/Container.js");
 var import_Surface = require("./surface/Surface.js");
 var import_variables_css = require("./surface/variables.sty.js");
+var import_useBreakpoint = require("./hooks/useBreakpoint.js");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynatrace/strato-components",
-  "version": "0.85.21",
+  "version": "0.85.32",
   "private": false,
   "license": "Apache-2.0",
   "lang": "lang/uncompiled",
@@ -75,12 +75,16 @@
     "@dynatrace/devkit": "^0.3.2",
     "@formatjs/icu-messageformat-parser": "^2.7.8",
     "@jest/globals": "^29.7.0",
+    "@vanilla-extract/css": "^1.15.5",
+    "@vanilla-extract/dynamic": "^2.1.0",
+    "@vanilla-extract/recipes": "^0.5.5",
+    "@vanilla-extract/sprinkles": "^1.6.3",
     "clsx": "^2.1.1",
     "lodash-es": "^4.17.21",
     "wicg-inert": "^3.1.2",
     "use-resize-observer": "^9.1.0",
     "@dynatrace/strato-design-tokens": "0.20.40",
-    "@dynatrace/strato-icons": "0.39.1"
+    "@dynatrace/strato-icons": "0.39.2"
   },
   "peerDependencies": {
     "@dynatrace-sdk/app-environment": "^1.0.0",
@@ -107,5 +111,8 @@
     "./esm/core/components/app-root/AppRoot.css",
     "./core/components/app-root/AppRoot.sty.js",
     "./esm/core/components/app-root/AppRoot.sty.js"
-  ]
+  ],
+  "dt": {
+    "migrations": []
+  }
 }

package/typography/block-quote/Blockquote.d.ts

@@ -16,4 +16,4 @@ export interface BlockquoteProps extends WithChildren, StylingProps, DataTestId,
  * The `Blockquote` component wraps longer text blocks and indicates that the passage is quoted from another source.
  * @public
  */
-export declare const Blockquote: (props: BlockquoteProps & React.RefAttributes<HTMLQuoteElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Blockquote: (props: BlockquoteProps & React.RefAttributes<HTMLQuoteElement>) => React.ReactElement | null;

package/typography/code/Code.d.ts

@@ -14,4 +14,4 @@ export interface CodeProps extends WithChildren, StylingProps, DataTestId, Maski
  * component instead.
  * @public
  */
-export declare const Code: (props: CodeProps & React.RefAttributes<HTMLElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Code: (props: CodeProps & React.RefAttributes<HTMLElement>) => React.ReactElement | null;

package/typography/emphasis/Emphasis.d.ts

@@ -11,4 +11,4 @@ export interface EmphasisProps extends WithChildren, StylingProps, DataTestId, M
  * The `Emphasis` component adds visual and semantic emphasis to stressed or essential content.
  * @public
  */
-export declare const Emphasis: (props: EmphasisProps & React.RefAttributes<HTMLElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Emphasis: (props: EmphasisProps & React.RefAttributes<HTMLElement>) => React.ReactElement | null;

package/typography/external-link/ExternalLink.d.ts

@@ -18,4 +18,4 @@ export interface ExternalLinkProps extends WithChildren, StylingProps, DataTestI
  * component instead.
  * @public
  */
-export declare const ExternalLink: (props: ExternalLinkProps & React.RefAttributes<HTMLAnchorElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const ExternalLink: (props: ExternalLinkProps & React.RefAttributes<HTMLAnchorElement>) => React.ReactElement | null;

package/typography/heading/Heading.d.ts

@@ -22,4 +22,4 @@ export interface HeadingProps extends DOMProps, WithChildren, StylingProps, Data
  * The component allows you to independently define both the visual and the semantic level of the heading.
  * @public
  */
-export declare const Heading: (props: HeadingProps & React.RefAttributes<HTMLHeadingElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Heading: (props: HeadingProps & React.RefAttributes<HTMLHeadingElement>) => React.ReactElement | null;

package/typography/list/List.d.ts

@@ -36,4 +36,4 @@ export interface ListProps<TOrdered extends boolean = false> extends WithChildre
  * (for unordered lists).
  * @public
  */
-export declare const List: <TOrdered extends boolean = false>(props: ListProps<TOrdered> & React.RefAttributes<TOrdered extends true ? HTMLOListElement : HTMLUListElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const List: <TOrdered extends boolean = false>(props: ListProps<TOrdered> & React.RefAttributes<TOrdered extends true ? HTMLOListElement : HTMLUListElement>) => React.ReactElement | null;

package/typography/paragraph/Paragraph.d.ts

@@ -16,4 +16,4 @@ export interface ParagraphProps extends WithChildren, DOMProps, StylingProps, Da
  * The `Paragraph` component displays a block of text with the default text style and supports text truncation.
  * @public
  */
-export declare const Paragraph: (props: ParagraphProps & React.RefAttributes<HTMLParagraphElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Paragraph: (props: ParagraphProps & React.RefAttributes<HTMLParagraphElement>) => React.ReactElement | null;

package/typography/strikethrough/Strikethrough.d.ts

@@ -12,4 +12,4 @@ export interface StrikethroughProps extends WithChildren, StylingProps, DataTest
  * represent things that are no longer relevant or accurate.
  * @public
  */
-export declare const Strikethrough: (props: StrikethroughProps & React.RefAttributes<HTMLElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Strikethrough: (props: StrikethroughProps & React.RefAttributes<HTMLElement>) => React.ReactElement | null;

package/typography/strong/Strong.d.ts

@@ -11,4 +11,4 @@ export interface StrongProps extends WithChildren, StylingProps, DataTestId, Mas
  * Use the `Strong` component to render text in bold type to emphasize it.
  * @public
  */
-export declare const Strong: (props: StrongProps & React.RefAttributes<HTMLElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const Strong: (props: StrongProps & React.RefAttributes<HTMLElement>) => React.ReactElement | null;

package/typography/text/Text.d.ts

@@ -17,8 +17,9 @@ export interface TextOwnProps extends WithChildren, DOMProps, AriaLabelingProps,
     fontStyle?: 'text' | 'code';
 }
 /**
+ * Combined props for the text component - polymorphing and own props.
  * @public
- * Combined props for the text component - polymorphing and own props. */
+ */
 export type TextProps<E extends ElementType> = PolymorphicComponentProps<E, TextOwnProps>;
 /**
  * Use the `Text` component for text that is rendered without any semantic markup.

package/typography/text-ellipsis/TextEllipsis.d.ts

@@ -29,4 +29,4 @@ export interface TextEllipsisProps extends HTMLAttributes<HTMLSpanElement>, Styl
  * when writing your own components.
  * @public
  */
-export declare const TextEllipsis: (props: TextEllipsisProps & React.RefAttributes<HTMLSpanElement>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+export declare const TextEllipsis: (props: TextEllipsisProps & React.RefAttributes<HTMLSpanElement>) => React.ReactElement | null;