@dynatrace/strato-components 3.7.1 → 3.9.0

package/esm/core/hooks/useResizeObserver.js

@@ -0,0 +1,124 @@
+import {
+  useCallback,
+  useEffect,
+  useMemo,
+  useRef,
+  useState
+} from "react";
+function resolveElement(cbElement, refOrElement) {
+  if (cbElement) {
+    return cbElement;
+  }
+  if (!refOrElement) {
+    return null;
+  }
+  if (refOrElement instanceof Element) {
+    return refOrElement;
+  }
+  return refOrElement.current;
+}
+function extractSize(entry, boxProp, sizeType) {
+  if (!entry[boxProp]) {
+    if (boxProp === "contentBoxSize") {
+      return entry.contentRect[sizeType === "inlineSize" ? "width" : "height"];
+    }
+    return void 0;
+  }
+  const sizes = entry[boxProp];
+  return Array.isArray(sizes) ? sizes[0]?.[sizeType] : sizes[sizeType];
+}
+function useResizeObserver(options = {}) {
+  const onResizeRef = useRef(options.onResize);
+  onResizeRef.current = options.onResize;
+  const [size, setSize] = useState({
+    width: void 0,
+    height: void 0
+  });
+  const didUnmount = useRef(false);
+  useEffect(() => {
+    didUnmount.current = false;
+    return () => {
+      didUnmount.current = true;
+    };
+  }, []);
+  const previous = useRef({
+    width: void 0,
+    height: void 0
+  });
+  const lastReport = useRef(null);
+  const cbElementRef = useRef(null);
+  const refOrElementRef = useRef(options.ref);
+  refOrElementRef.current = options.ref;
+  const subscriber = useCallback(
+    (element) => {
+      let boxProp = "contentBoxSize";
+      if (options.box === "border-box") {
+        boxProp = "borderBoxSize";
+      } else if (options.box === "device-pixel-content-box") {
+        boxProp = "devicePixelContentBoxSize";
+      }
+      const ro = new ResizeObserver((entries) => {
+        const entry = entries[0];
+        const newWidth = extractSize(entry, boxProp, "inlineSize");
+        const newHeight = extractSize(entry, boxProp, "blockSize");
+        const roundedWidth = newWidth === void 0 ? void 0 : Math.round(newWidth);
+        const roundedHeight = newHeight === void 0 ? void 0 : Math.round(newHeight);
+        if (previous.current.width !== roundedWidth || previous.current.height !== roundedHeight) {
+          const newSize = { width: roundedWidth, height: roundedHeight };
+          previous.current = newSize;
+          if (onResizeRef.current) {
+            onResizeRef.current(newSize);
+          } else if (!didUnmount.current) {
+            setSize(newSize);
+          }
+        }
+      });
+      ro.observe(element, { box: options.box });
+      return () => ro.unobserve(element);
+    },
+    [options.box]
+  );
+  const evaluateSubscription = useCallback(() => {
+    const element = resolveElement(
+      cbElementRef.current,
+      refOrElementRef.current
+    );
+    if (lastReport?.current?.element === element && lastReport?.current?.subscriber === subscriber) {
+      return;
+    }
+    lastReport.current?.cleanup?.();
+    lastReport.current = {
+      element,
+      subscriber,
+      cleanup: element ? subscriber(element) : void 0
+    };
+  }, [subscriber]);
+  useEffect(() => {
+    evaluateSubscription();
+  });
+  useEffect(() => {
+    return () => {
+      lastReport.current?.cleanup?.();
+      lastReport.current = null;
+    };
+  }, []);
+  const refCallback = useCallback(
+    (element) => {
+      cbElementRef.current = element;
+      evaluateSubscription();
+    },
+    [evaluateSubscription]
+  );
+  return useMemo(
+    () => ({
+      ref: refCallback,
+      width: size.width,
+      height: size.height
+    }),
+    [refCallback, size.width, size.height]
+  );
+}
+export {
+  useResizeObserver
+};
+//# sourceMappingURL=useResizeObserver.js.map

package/esm/core/hooks/useResizeObserver.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/hooks/useResizeObserver.ts"],
+  "sourcesContent": ["import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type RefCallback,\n  type RefObject,\n} from 'react';\n\n/** @internal */\nexport type ObservedSize = {\n  width: number | undefined;\n  height: number | undefined;\n};\n\ntype UseResizeObserverOptions<T extends Element> = {\n  ref?: RefObject<T | null> | T | null;\n  onResize?: (size: ObservedSize) => void;\n  box?: ResizeObserverBoxOptions;\n};\n\ntype UseResizeObserverResult<T extends Element> = ObservedSize & {\n  ref: RefCallback<T | null>;\n};\n\ntype SubscriberCleanup = () => void;\n\n// Resolves the element to observe from either a callback ref element, an\n// external element reference, or an external RefObject.\nfunction resolveElement<T extends Element>(\n  cbElement: T | null,\n  refOrElement: RefObject<T | null> | T | null | undefined,\n): T | null {\n  if (cbElement) {\n    return cbElement;\n  }\n  if (!refOrElement) {\n    return null;\n  }\n  if (refOrElement instanceof Element) {\n    return refOrElement;\n  }\n  return (refOrElement as RefObject<T | null>).current;\n}\n\ntype BoxProp = 'borderBoxSize' | 'contentBoxSize' | 'devicePixelContentBoxSize';\n\nfunction extractSize(\n  entry: ResizeObserverEntry,\n  boxProp: BoxProp,\n  sizeType: keyof ResizeObserverSize,\n): number | undefined {\n  if (!entry[boxProp]) {\n    if (boxProp === 'contentBoxSize') {\n      return entry.contentRect[sizeType === 'inlineSize' ? 'width' : 'height'];\n    }\n    return undefined;\n  }\n  // The spec exposes sizes as FrozenArray; some older browsers returned an object\n  const sizes = entry[boxProp] as ResizeObserverSize[] | ResizeObserverSize;\n  return Array.isArray(sizes)\n    ? sizes[0]?.[sizeType]\n    : (sizes as ResizeObserverSize)[sizeType];\n}\n\n/**\n * Observes an element's size using the native `ResizeObserver` API and returns\n * its dimensions. Accepts either a React ref or a direct element reference via\n * options; when neither is provided the returned `ref` callback should be\n * attached to the target element.\n *\n * Behaviour matches the `use-resize-observer` npm package: when `onResize` is\n * provided the hook skips state updates to avoid unnecessary re-renders.\n * @internal\n */\nexport function useResizeObserver<T extends Element = HTMLElement>(\n  options: UseResizeObserverOptions<T> = {},\n): UseResizeObserverResult<T> {\n  const onResizeRef = useRef(options.onResize);\n  onResizeRef.current = options.onResize;\n\n  const [size, setSize] = useState<ObservedSize>({\n    width: undefined,\n    height: undefined,\n  });\n\n  // Guard against calling setSize after unmount (ResizeObserver may fire late).\n  const didUnmount = useRef(false);\n  useEffect(() => {\n    didUnmount.current = false;\n    return () => {\n      didUnmount.current = true;\n    };\n  }, []);\n\n  // Track previous dimensions to skip no-op updates.\n  const previous = useRef<ObservedSize>({\n    width: undefined,\n    height: undefined,\n  });\n\n  // Tracks the last element we subscribed to and its cleanup function.\n  const lastReport = useRef<{\n    element: Element | null;\n    subscriber: ((element: Element) => SubscriberCleanup) | null;\n    cleanup?: SubscriberCleanup;\n  } | null>(null);\n\n  // Element from the returned ref callback (takes priority over options.ref).\n  const cbElementRef = useRef<T | null>(null);\n\n  // Store options.ref in a ref so evaluateSubscription reads it fresh each time,\n  // matching the original library's behaviour of re-checking after every render.\n  const refOrElementRef = useRef(options.ref);\n  refOrElementRef.current = options.ref;\n\n  // The subscriber is re-created when the box option changes, which triggers a\n  // re-subscription in evaluateSubscription via reference comparison.\n  const subscriber = useCallback(\n    (element: Element): SubscriberCleanup => {\n      let boxProp: BoxProp = 'contentBoxSize';\n      if (options.box === 'border-box') {\n        boxProp = 'borderBoxSize';\n      } else if (options.box === 'device-pixel-content-box') {\n        boxProp = 'devicePixelContentBoxSize';\n      }\n\n      const ro = new ResizeObserver((entries) => {\n        const entry = entries[0];\n\n        const newWidth = extractSize(entry, boxProp, 'inlineSize');\n        const newHeight = extractSize(entry, boxProp, 'blockSize');\n\n        const roundedWidth =\n          newWidth === undefined ? undefined : Math.round(newWidth);\n        const roundedHeight =\n          newHeight === undefined ? undefined : Math.round(newHeight);\n\n        if (\n          previous.current.width !== roundedWidth ||\n          previous.current.height !== roundedHeight\n        ) {\n          const newSize = { width: roundedWidth, height: roundedHeight };\n          previous.current = newSize;\n          if (onResizeRef.current) {\n            onResizeRef.current(newSize);\n          } else if (!didUnmount.current) {\n            setSize(newSize);\n          }\n        }\n      });\n\n      ro.observe(element, { box: options.box });\n      return () => ro.unobserve(element);\n    },\n    [options.box],\n  );\n\n  const evaluateSubscription = useCallback(() => {\n    const element = resolveElement(\n      cbElementRef.current,\n      refOrElementRef.current,\n    );\n\n    if (\n      lastReport?.current?.element === element &&\n      lastReport?.current?.subscriber === subscriber\n    ) {\n      return;\n    }\n\n    lastReport.current?.cleanup?.();\n    lastReport.current = {\n      element,\n      subscriber,\n      cleanup: element ? subscriber(element) : undefined,\n    };\n  }, [subscriber]);\n\n  // Run after every render with no dependency array \u2014 this is intentional and\n  // mirrors the original library. It ensures that changes to a RefObject's\n  // `.current` (which React sets after commit, not during render) are picked up\n  // on the very next render cycle without requiring an extra state update.\n  useEffect(() => {\n    evaluateSubscription();\n  });\n\n  // Cleanup the current subscription on unmount.\n  useEffect(() => {\n    return () => {\n      lastReport.current?.cleanup?.();\n      lastReport.current = null;\n    };\n  }, []);\n\n  const refCallback: RefCallback<T | null> = useCallback(\n    (element) => {\n      cbElementRef.current = element;\n      evaluateSubscription();\n    },\n    [evaluateSubscription],\n  );\n\n  return useMemo(\n    () => ({\n      ref: refCallback,\n      width: size.width,\n      height: size.height,\n    }),\n    [refCallback, size.width, size.height],\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/esm/core/hooks/useVisualRefreshEnabled.js

@@ -0,0 +1,14 @@
+import { useSyncExternalStore } from "react";
+import { isVisualRefreshEnabled } from "../utils/is-visual-refresh-enabled.js";
+function useVisualRefreshEnabled() {
+  return useSyncExternalStore(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    () => () => globalThis.dtVisualRefreshEnabled,
+    () => isVisualRefreshEnabled(),
+    () => false
+  );
+}
+export {
+  useVisualRefreshEnabled
+};
+//# sourceMappingURL=useVisualRefreshEnabled.js.map

package/esm/core/hooks/useVisualRefreshEnabled.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/hooks/useVisualRefreshEnabled.ts"],
+  "sourcesContent": ["import { useSyncExternalStore } from 'react';\n\nimport { isVisualRefreshEnabled } from '../utils/is-visual-refresh-enabled.js';\n\n/**\n * @internal\n */\nexport function useVisualRefreshEnabled(): boolean {\n  return useSyncExternalStore(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    () => () => (globalThis as any).dtVisualRefreshEnabled,\n    () => isVisualRefreshEnabled(),\n    () => false,\n  );\n}\n"],
+  "mappings": "AAAA,SAAS,4BAA4B;AAErC,SAAS,8BAA8B;AAKhC,SAAS,0BAAmC;AACjD,SAAO;AAAA;AAAA,IAEL,MAAM,MAAO,WAAmB;AAAA,IAChC,MAAM,uBAAuB;AAAA,IAC7B,MAAM;AAAA,EACR;AACF;",
+  "names": []
+}

package/esm/core/index.js

@@ -73,6 +73,14 @@ import { Intent } from "./slots/Intent/Intent.js";
 import {
   usePermissions
 } from "./hooks/usePermissions.js";
+import {
+  useAppState,
+  useUserAppState
+} from "./sdk/app-state/useAppState.js";
+import {
+  useAppStateValue,
+  useUserAppStateValue
+} from "./sdk/app-state/useAppStateValue.js";
 export {
   AppRoot,
   FocusScope,
@@ -108,6 +116,8 @@ export {
   mergeProps as _mergeProps,
   parseBoolean as _parseBoolean,
   _sanitizeSymbol,
+  useAppState as _useAppState,
+  useAppStateValue as _useAppStateValue,
   useAriaLabelingProps as _useAriaLabelingProps,
   useBehavioralTrackingProps as _useBehavioralTrackingProps,
   useControllableState as _useControllableState,
@@ -119,6 +129,8 @@ export {
   useRequestAnimationFrame as _useRequestAnimationFrame,
   useSafeForwardProps as _useSafeForwardProps,
   useSharedInputPropsContext as _useSharedInputPropsContext,
+  useUserAppState as _useUserAppState,
+  useUserAppStateValue as _useUserAppStateValue,
   createStore,
   getThresholdColor,
   isNumber,

package/esm/core/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/core/index.ts"],
-  "sourcesContent": ["export { AppRoot, type AppRootProps } from './components/app-root/AppRoot.js';\nexport { dtVisualRefreshEnabled as _dtVisualRefreshEnabled } from './components/app-root/AppRoot.sty.js';\nexport {\n  FocusScope,\n  type FocusScopeProps,\n} from './components/focus-scope/FocusScope.js';\n\nexport type {\n  FocusContextProps as _FocusContextProps,\n  FocusScopeRegistration as _FocusScopeRegistration,\n} from './contexts/FocusContext.js';\n\nexport { useCurrentTheme } from './hooks/useCurrentTheme.js';\nexport { useFocusContext as _useFocusContext } from './hooks/useFocusContext.js';\nexport {\n  type UseFocusRingProps,\n  type FocusRingProps,\n  useFocusRing,\n} from './hooks/useFocusRing.js';\nexport { FocusProvider as _FocusProvider } from './providers/FocusProvider.js';\nexport type { MaskingProps } from './types/masking-props.js';\nexport type { DataTestId } from './types/data-props.js';\nexport type { StylingProps } from './types/styling-props.js';\nexport type { WithChildren } from './types/with-children.js';\nexport type {\n  PolymorphOwnProps,\n  PolymorphProps,\n  PolymorphicComponentProps,\n} from './types/polymorph.js';\nexport { attemptFocus as _attemptFocus } from './utils/focus-management/attempt-focus.js';\nexport { focusFirstDescendant as _focusFirstDescendant } from './utils/focus-management/focus-first-descendant.js';\nexport { getFirstFocusableChild as _getFirstFocusableChild } from './utils/focus-management/get-first-focusable-child.js';\nexport { getLastFocusableChild as _getLastFocusableChild } from './utils/focus-management/get-last-focusable-child.js';\nexport { isFocusable as _isFocusable } from './utils/focus-management/is-focusable.js';\nexport { isBrowser as _isBrowser } from './utils/isBrowser.js';\nexport {\n  mergeProps as _mergeProps,\n  type NullToObject as _NullToObject,\n  type TupleTypes as _TupleTypes,\n  type UnionToIntersection as _UnionToIntersection,\n} from './utils/merge-props.js';\nexport { type _HeadingLevel, type _HeadingTag } from './types/heading.js';\nexport { useAriaLabelingProps as _useAriaLabelingProps } from './hooks/useAriaLabelingProps.js';\nexport { useBehavioralTrackingProps as _useBehavioralTrackingProps } from './hooks/useBehavioralTrackingProps.js';\nexport { useId } from './hooks/useId.js';\nexport { useSafeForwardProps as _useSafeForwardProps } from './hooks/useSafeForwardProps.js';\nexport type { UseSafeForwardReturnProps as _UseSafeForwardReturnProps } from './hooks/useSafeForwardProps.js';\nexport type {\n  AriaDisabledProps,\n  AriaLabelingProps,\n} from './types/a11y-props.js';\nexport type { DOMProps } from './types/dom.js';\nexport { canReceiveDefaultTextFormat as _canReceiveDefaultTextFormat } from './utils/can-receive-default-text-format.js';\nexport { parseBoolean as _parseBoolean } from './utils/parse-boolean.js';\nexport type { BehaviorTrackingProps } from './types/behavior-tracking-props.js';\nexport { OverlayContainer } from './components/OverlayContainer.js';\nexport type { OverlayContainerProps } from './components/OverlayContainer.js';\nexport { VisuallyHidden as _VisuallyHidden } from './components/visually-hidden/VisuallyHidden.js';\nexport { ModalContext } from './contexts/ModalContext.js';\nexport type { ModalContextProps } from './contexts/ModalContext.js';\nexport { OverlayStackingContext } from './contexts/OverlayStacking.js';\nexport { SharedInputPropsContext } from './contexts/SharedInputPropsContext.js';\nexport type { SharedInputProps } from './contexts/SharedInputPropsContext.js';\nexport { useBreakpointProps } from './hooks/useBreakpointProps.js';\nexport type { BreakpointProps } from './hooks/useBreakpointProps.js';\nexport { useContainerBreakpoint } from './hooks/useContainerBreakpoint.js';\nexport { useContainerSize } from './hooks/useContainerSize.js';\nexport type { ContainerSize } from './hooks/useContainerSize.js';\nexport { useControllableState as _useControllableState } from './hooks/useControllableState.js';\nexport type { useControllableStateProps as _useControllableStateProps } from './hooks/useControllableState.js';\nexport { useFocusRing as _useFocusRing } from './hooks/useFocusRing.js';\nexport type {\n  FocusRingProps as _FocusRingProps,\n  UseFocusRingProps as _UseFocusRingProps,\n} from './hooks/useFocusRing.js';\nexport { useFormControlState as _useFormControlState } from './hooks/useFormControlState.js';\nexport type { useFormControlStateReturnType as _useFormControlStateReturnType } from './hooks/useFormControlState.js';\nexport { useIsInViewport as _useIsInViewport } from './hooks/useIsInViewport.js';\nexport { useMeasureChildren as _useMeasureChildren } from './hooks/useMeasureChildren.js';\nexport type {\n  UseMeasureChildrenChildProps as _UseMeasureChildrenChildProps,\n  UseMeasureChildrenReturnType as _UseMeasureChildrenReturnType,\n  ContainerSize as _ContainerSize,\n} from './hooks/useMeasureChildren.js';\nexport { useMergeRefs } from './hooks/useMergeRefs.js';\nexport { useOverlayStacking } from './hooks/useOverlayStacking.js';\nexport type { Elevation } from './hooks/useOverlayStacking.js';\nexport { usePrevious } from './hooks/usePrevious.js';\nexport { useRequestAnimationFrame as _useRequestAnimationFrame } from './hooks/useRequestAnimationFrame.js';\nexport type { useThrottleReturnType as _useThrottleReturnType } from './hooks/useRequestAnimationFrame.js';\nexport { useRovingFocus } from './hooks/useRovingFocus.js';\nexport type {\n  RovingFocusOptions,\n  RovingFocusReturnType,\n} from './hooks/useRovingFocus.js';\nexport { useSafeLayoutEffect } from './hooks/useSafeLayoutEffect.js';\nexport { useSharedInputPropsContext as _useSharedInputPropsContext } from './hooks/useSharedInputPropsContext.js';\nexport type {\n  NumberFormatParser as _NumberFormatParser,\n  NumberFormatParserArgs as _NumberFormatParserArgs,\n} from '../filters/filter-field/parser/getNumberParser.js';\nexport { ModalContextProvider } from './providers/ModalContextProvider.js';\nexport type { ModalContextProviderProps } from './providers/ModalContextProvider.js';\nexport { OverlayProvider } from './providers/OverlayProvider.js';\nexport { OverlayStackingProvider } from './providers/OverlayStackingProvider.js';\nexport { ScrollProvider } from './providers/ScrollProvider.js';\nexport type { ScrollProviderProps } from './providers/ScrollProvider.js';\nexport { useStoreSelector } from './store/selector.js';\nexport { createStore } from './store/store.js';\nexport type { Store } from './store/store.js';\nexport type {\n  BaseEvent,\n  FocusEvents,\n  KeyboardEvent,\n  KeyboardEvents,\n  PressEvent,\n} from './types/events.js';\nexport type {\n  FormControlProps,\n  FormControlBaseProps,\n  FormControlControlledProps,\n  FormControlUncontrolledProps,\n} from './types/form-control-props.js';\nexport type {\n  FormControlState,\n  FormControlStateProps,\n  FormControlValueState,\n} from './types/form-control-state.js';\nexport type {\n  Components,\n  NormalComponents as ReactMarkdownNormalComponents,\n  SpecialComponents as ReactMarkdownSpecialComponents,\n  UnorderedListComponent as ReactMarkdownUnorderedListComponent,\n  TableRowComponent as ReactMarkdownTableRowComponent,\n  TableCellComponent as ReactMarkdownTableCellComponent,\n  OrderedListComponent as ReactMarkdownOrderedListComponent,\n  LiComponent as ReactMarkdownLiComponent,\n  HeadingComponent as ReactMarkdownHeadingComponent,\n  CodeComponent as ReactMarkdownCodeComponent,\n  ReactMarkdownProps as ReactMarkdownReactMarkdownProps,\n  ReactMarkdownNames as ReactMarkdownReactMarkdownNames,\n  IntrinsicElements as ReactMarkdownIntrinsicElements,\n} from './types/markdown/react-markdown.js';\nexport type {\n  Position as UnistPosition,\n  Point as UnistPoint,\n  Parent as UnistParent,\n  Node as UnistNode,\n  Literal as UnistLiteral,\n  NodeData as UnistNodeData,\n  Data as UnistData,\n} from './types/markdown/unist.js';\nexport type {\n  Element as HastElement,\n  Properties as HastProperties,\n  Root as HastRoot,\n  Parent as HastParent,\n  Content as HastContent,\n  RootContent as HastRootContent,\n  ElementContent as HastElementContent,\n  RootContentMap as HastRootContentMap,\n  ElementContentMap as HastElementContentMap,\n  Comment as HastComment,\n  DocType as HastDocType,\n  Text as HastText,\n  Literal as HastLiteral,\n} from './types/markdown/hast.js';\nexport type { Orientation } from './types/orientation.js';\nexport type { PointerType } from './types/pointer.js';\nexport type {\n  CombinedThresholds,\n  ThresholdPropsWithBackgroundColorOptional,\n  ThresholdPropsWithColorOptional,\n  SingleThreshold,\n  Threshold,\n  ThresholdColor,\n  ThresholdColors,\n  ThresholdExtended,\n  ThresholdForNumbers,\n  ThresholdForStrings,\n  ThresholdNumbersComparator,\n  ThresholdOptions,\n  ThresholdRule,\n  ThresholdStringsComparator,\n} from './types/threshold-types.js';\nexport type {\n  // DEPRECATION: [APPDEV-16487] BREAKING-CHANGE: Forms - Remove deprecated parseTime.\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  TimeDetails,\n  Timeframe,\n  TimeValue,\n} from './types/time.js';\nexport { isNumber, isPotentialDateValue } from './types/type-guards.js';\n// DEPRECATION: [APPDEV-16044] BREAKING-CHANGE: Remove 'date' columnType.\nexport {\n  /**\n   * @deprecated Will be removed in the future.\n   */\n  formatDatetimeDefault as _formatDate,\n} from './utils/default-formatters.js';\nexport { _sanitizeSymbol } from './utils/sanitize-symbol.js';\nexport { convertToNumberIfPureNumber as _convertToNumberIfPureNumber } from './utils/string-utils.js';\nexport { _InteractiveSelector } from './utils/styles/interactiveSelector.js';\nexport {\n  _checkCombinedThresholdRules,\n  _matchesThreshold,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  getThresholdColor,\n} from './utils/threshold-utils.js';\n// eslint-disable-next-line @typescript-eslint/no-deprecated\nexport { TIMEFRAME_EXPRESSION, parseTime } from './utils/timeParser.js';\nexport {\n  downloadBlob as _downloadBlob,\n  downloadCSV as _downloadCSV,\n  downloadFromUrl as _downloadFromUrl,\n} from './utils/download.js';\nexport { accessValue as _accessValue } from './utils/accessors/access-value.js';\nexport type {\n  IntentProps,\n  IntentWithResponseProps,\n  IntentWithoutResponseProps,\n  SuccessRes,\n  ErrorRes,\n  IntentBaseProps,\n} from './slots/Intent/Intent.js';\nexport { Intent } from './slots/Intent/Intent.js';\n\nexport {\n  usePermissions,\n  type PermissionsResult,\n  type PermissionDetail,\n} from './hooks/usePermissions.js';\n"],
-  "mappings": "AAAA,SAAS,eAAkC;AAC3C,SAAmC,8BAA+B;AAClE;AAAA,EACE;AAAA,OAEK;AAOP,SAAS,uBAAuB;AAChC,SAA4B,uBAAwB;AACpD;AAAA,EAGE;AAAA,OACK;AACP,SAA0B,qBAAsB;AAUhD,SAAyB,oBAAqB;AAC9C,SAAiC,4BAA6B;AAC9D,SAAmC,8BAA+B;AAClE,SAAkC,6BAA8B;AAChE,SAAwB,mBAAoB;AAC5C,SAAsB,iBAAkB;AACxC;AAAA,EACgB;AAAA,OAIT;AAEP,SAAiC,4BAA6B;AAC9D,SAAuC,kCAAmC;AAC1E,SAAS,aAAa;AACtB,SAAgC,2BAA4B;AAO5D,SAAwC,mCAAoC;AAC5E,SAAyB,oBAAqB;AAE9C,SAAS,wBAAwB;AAEjC,SAA2B,sBAAuB;AAClD,SAAS,oBAAoB;AAE7B,SAAS,8BAA8B;AACvC,SAAS,+BAA+B;AAExC,SAAS,0BAA0B;AAEnC,SAAS,8BAA8B;AACvC,SAAS,wBAAwB;AAEjC,SAAiC,4BAA6B;AAE9D,SAAyB,gBAAhBA,qBAAqC;AAK9C,SAAgC,2BAA4B;AAE5D,SAA4B,uBAAwB;AACpD,SAA+B,0BAA2B;AAM1D,SAAS,oBAAoB;AAC7B,SAAS,0BAA0B;AAEnC,SAAS,mBAAmB;AAC5B,SAAqC,gCAAiC;AAEtE,SAAS,sBAAsB;AAK/B,SAAS,2BAA2B;AACpC,SAAuC,kCAAmC;AAK1E,SAAS,4BAA4B;AAErC,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AACxC,SAAS,sBAAsB;AAE/B,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAoF5B,SAAS,UAAU,4BAA4B;AAE/C;AAAA,EAI2B;AAAA,OACpB;AACP,SAAS,uBAAuB;AAChC,SAAwC,mCAAoC;AAC5E,SAAS,4BAA4B;AACrC;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AAEP,SAAS,sBAAsB,iBAAiB;AAChD;AAAA,EACkB;AAAA,EACD;AAAA,EACI;AAAA,OACd;AACP,SAAwB,mBAAoB;AAS5C,SAAS,cAAc;AAEvB;AAAA,EACE;AAAA,OAGK;",
+  "sourcesContent": ["export { AppRoot, type AppRootProps } from './components/app-root/AppRoot.js';\nexport { dtVisualRefreshEnabled as _dtVisualRefreshEnabled } from './components/app-root/AppRoot.sty.js';\nexport {\n  FocusScope,\n  type FocusScopeProps,\n} from './components/focus-scope/FocusScope.js';\n\nexport type {\n  FocusContextProps as _FocusContextProps,\n  FocusScopeRegistration as _FocusScopeRegistration,\n} from './contexts/FocusContext.js';\n\nexport { useCurrentTheme } from './hooks/useCurrentTheme.js';\nexport { useFocusContext as _useFocusContext } from './hooks/useFocusContext.js';\nexport {\n  type UseFocusRingProps,\n  type FocusRingProps,\n  useFocusRing,\n} from './hooks/useFocusRing.js';\nexport { FocusProvider as _FocusProvider } from './providers/FocusProvider.js';\nexport type { MaskingProps } from './types/masking-props.js';\nexport type { DataTestId } from './types/data-props.js';\nexport type { StylingProps } from './types/styling-props.js';\nexport type { WithChildren } from './types/with-children.js';\nexport type {\n  PolymorphOwnProps,\n  PolymorphProps,\n  PolymorphicComponentProps,\n} from './types/polymorph.js';\nexport { attemptFocus as _attemptFocus } from './utils/focus-management/attempt-focus.js';\nexport { focusFirstDescendant as _focusFirstDescendant } from './utils/focus-management/focus-first-descendant.js';\nexport { getFirstFocusableChild as _getFirstFocusableChild } from './utils/focus-management/get-first-focusable-child.js';\nexport { getLastFocusableChild as _getLastFocusableChild } from './utils/focus-management/get-last-focusable-child.js';\nexport { isFocusable as _isFocusable } from './utils/focus-management/is-focusable.js';\nexport { isBrowser as _isBrowser } from './utils/isBrowser.js';\nexport {\n  mergeProps as _mergeProps,\n  type NullToObject as _NullToObject,\n  type TupleTypes as _TupleTypes,\n  type UnionToIntersection as _UnionToIntersection,\n} from './utils/merge-props.js';\nexport { type _HeadingLevel, type _HeadingTag } from './types/heading.js';\nexport { useAriaLabelingProps as _useAriaLabelingProps } from './hooks/useAriaLabelingProps.js';\nexport { useBehavioralTrackingProps as _useBehavioralTrackingProps } from './hooks/useBehavioralTrackingProps.js';\nexport { useId } from './hooks/useId.js';\nexport { useSafeForwardProps as _useSafeForwardProps } from './hooks/useSafeForwardProps.js';\nexport type { UseSafeForwardReturnProps as _UseSafeForwardReturnProps } from './hooks/useSafeForwardProps.js';\nexport type {\n  AriaDisabledProps,\n  AriaLabelingProps,\n} from './types/a11y-props.js';\nexport type { DOMProps } from './types/dom.js';\nexport { canReceiveDefaultTextFormat as _canReceiveDefaultTextFormat } from './utils/can-receive-default-text-format.js';\nexport { parseBoolean as _parseBoolean } from './utils/parse-boolean.js';\nexport type { BehaviorTrackingProps } from './types/behavior-tracking-props.js';\nexport { OverlayContainer } from './components/OverlayContainer.js';\nexport type { OverlayContainerProps } from './components/OverlayContainer.js';\nexport { VisuallyHidden as _VisuallyHidden } from './components/visually-hidden/VisuallyHidden.js';\nexport { ModalContext } from './contexts/ModalContext.js';\nexport type { ModalContextProps } from './contexts/ModalContext.js';\nexport { OverlayStackingContext } from './contexts/OverlayStacking.js';\nexport { SharedInputPropsContext } from './contexts/SharedInputPropsContext.js';\nexport type { SharedInputProps } from './contexts/SharedInputPropsContext.js';\nexport { useBreakpointProps } from './hooks/useBreakpointProps.js';\nexport type { BreakpointProps } from './hooks/useBreakpointProps.js';\nexport { useContainerBreakpoint } from './hooks/useContainerBreakpoint.js';\nexport { useContainerSize } from './hooks/useContainerSize.js';\nexport type { ContainerSize } from './hooks/useContainerSize.js';\nexport { useControllableState as _useControllableState } from './hooks/useControllableState.js';\nexport type { useControllableStateProps as _useControllableStateProps } from './hooks/useControllableState.js';\nexport { useFocusRing as _useFocusRing } from './hooks/useFocusRing.js';\nexport type {\n  FocusRingProps as _FocusRingProps,\n  UseFocusRingProps as _UseFocusRingProps,\n} from './hooks/useFocusRing.js';\nexport { useFormControlState as _useFormControlState } from './hooks/useFormControlState.js';\nexport type { useFormControlStateReturnType as _useFormControlStateReturnType } from './hooks/useFormControlState.js';\nexport { useIsInViewport as _useIsInViewport } from './hooks/useIsInViewport.js';\nexport { useMeasureChildren as _useMeasureChildren } from './hooks/useMeasureChildren.js';\nexport type {\n  UseMeasureChildrenChildProps as _UseMeasureChildrenChildProps,\n  UseMeasureChildrenReturnType as _UseMeasureChildrenReturnType,\n  ContainerSize as _ContainerSize,\n} from './hooks/useMeasureChildren.js';\nexport { useMergeRefs } from './hooks/useMergeRefs.js';\nexport { useOverlayStacking } from './hooks/useOverlayStacking.js';\nexport type { Elevation } from './hooks/useOverlayStacking.js';\nexport { usePrevious } from './hooks/usePrevious.js';\nexport { useRequestAnimationFrame as _useRequestAnimationFrame } from './hooks/useRequestAnimationFrame.js';\nexport type { useThrottleReturnType as _useThrottleReturnType } from './hooks/useRequestAnimationFrame.js';\nexport { useRovingFocus } from './hooks/useRovingFocus.js';\nexport type {\n  RovingFocusOptions,\n  RovingFocusReturnType,\n} from './hooks/useRovingFocus.js';\nexport { useSafeLayoutEffect } from './hooks/useSafeLayoutEffect.js';\nexport { useSharedInputPropsContext as _useSharedInputPropsContext } from './hooks/useSharedInputPropsContext.js';\nexport type {\n  NumberFormatParser as _NumberFormatParser,\n  NumberFormatParserArgs as _NumberFormatParserArgs,\n} from '../filters/filter-field/parser/getNumberParser.js';\nexport { ModalContextProvider } from './providers/ModalContextProvider.js';\nexport type { ModalContextProviderProps } from './providers/ModalContextProvider.js';\nexport { OverlayProvider } from './providers/OverlayProvider.js';\nexport { OverlayStackingProvider } from './providers/OverlayStackingProvider.js';\nexport { ScrollProvider } from './providers/ScrollProvider.js';\nexport type { ScrollProviderProps } from './providers/ScrollProvider.js';\nexport { useStoreSelector } from './store/selector.js';\nexport { createStore } from './store/store.js';\nexport type { Store } from './store/store.js';\nexport type {\n  BaseEvent,\n  FocusEvents,\n  KeyboardEvent,\n  KeyboardEvents,\n  PressEvent,\n} from './types/events.js';\nexport type {\n  FormControlProps,\n  FormControlBaseProps,\n  FormControlControlledProps,\n  FormControlUncontrolledProps,\n} from './types/form-control-props.js';\nexport type {\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  FormControlState,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  FormControlStateProps,\n  FormControlValueState,\n} from './types/form-control-state.js';\nexport type {\n  Components,\n  NormalComponents as ReactMarkdownNormalComponents,\n  SpecialComponents as ReactMarkdownSpecialComponents,\n  UnorderedListComponent as ReactMarkdownUnorderedListComponent,\n  TableRowComponent as ReactMarkdownTableRowComponent,\n  TableCellComponent as ReactMarkdownTableCellComponent,\n  OrderedListComponent as ReactMarkdownOrderedListComponent,\n  LiComponent as ReactMarkdownLiComponent,\n  HeadingComponent as ReactMarkdownHeadingComponent,\n  CodeComponent as ReactMarkdownCodeComponent,\n  ReactMarkdownProps as ReactMarkdownReactMarkdownProps,\n  ReactMarkdownNames as ReactMarkdownReactMarkdownNames,\n  IntrinsicElements as ReactMarkdownIntrinsicElements,\n} from './types/markdown/react-markdown.js';\nexport type {\n  Position as UnistPosition,\n  Point as UnistPoint,\n  Parent as UnistParent,\n  Node as UnistNode,\n  Literal as UnistLiteral,\n  NodeData as UnistNodeData,\n  Data as UnistData,\n} from './types/markdown/unist.js';\nexport type {\n  Element as HastElement,\n  Properties as HastProperties,\n  Root as HastRoot,\n  Parent as HastParent,\n  Content as HastContent,\n  RootContent as HastRootContent,\n  ElementContent as HastElementContent,\n  RootContentMap as HastRootContentMap,\n  ElementContentMap as HastElementContentMap,\n  Comment as HastComment,\n  DocType as HastDocType,\n  Text as HastText,\n  Literal as HastLiteral,\n} from './types/markdown/hast.js';\nexport type { Orientation } from './types/orientation.js';\nexport type { PointerType } from './types/pointer.js';\nexport type {\n  CombinedThresholds,\n  ThresholdPropsWithBackgroundColorOptional,\n  ThresholdPropsWithColorOptional,\n  SingleThreshold,\n  Threshold,\n  ThresholdColor,\n  ThresholdColors,\n  ThresholdExtended,\n  ThresholdForNumbers,\n  ThresholdForStrings,\n  ThresholdNumbersComparator,\n  ThresholdOptions,\n  ThresholdRule,\n  ThresholdStringsComparator,\n} from './types/threshold-types.js';\nexport type {\n  // DEPRECATION: [APPDEV-16487] BREAKING-CHANGE: Forms - Remove deprecated parseTime.\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  TimeDetails,\n  Timeframe,\n  TimeValue,\n} from './types/time.js';\nexport { isNumber, isPotentialDateValue } from './types/type-guards.js';\n// DEPRECATION: [APPDEV-16044] BREAKING-CHANGE: Remove 'date' columnType.\nexport {\n  /**\n   * @deprecated Will be removed in the future.\n   */\n  formatDatetimeDefault as _formatDate,\n} from './utils/default-formatters.js';\nexport { _sanitizeSymbol } from './utils/sanitize-symbol.js';\nexport { convertToNumberIfPureNumber as _convertToNumberIfPureNumber } from './utils/string-utils.js';\nexport { _InteractiveSelector } from './utils/styles/interactiveSelector.js';\nexport {\n  _checkCombinedThresholdRules,\n  _matchesThreshold,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  getThresholdColor,\n} from './utils/threshold-utils.js';\n// eslint-disable-next-line @typescript-eslint/no-deprecated\nexport { TIMEFRAME_EXPRESSION, parseTime } from './utils/timeParser.js';\nexport {\n  downloadBlob as _downloadBlob,\n  downloadCSV as _downloadCSV,\n  downloadFromUrl as _downloadFromUrl,\n} from './utils/download.js';\nexport { accessValue as _accessValue } from './utils/accessors/access-value.js';\nexport type {\n  IntentProps,\n  IntentWithResponseProps,\n  IntentWithoutResponseProps,\n  SuccessRes,\n  ErrorRes,\n  IntentBaseProps,\n} from './slots/Intent/Intent.js';\nexport { Intent } from './slots/Intent/Intent.js';\n\nexport {\n  usePermissions,\n  type PermissionsResult,\n  type PermissionDetail,\n} from './hooks/usePermissions.js';\nexport {\n  useAppState as _useAppState,\n  useUserAppState as _useUserAppState,\n} from './sdk/app-state/useAppState.js';\nexport {\n  useAppStateValue as _useAppStateValue,\n  useUserAppStateValue as _useUserAppStateValue,\n  type UseAppStateValueResult as _UseAppStateValueResult,\n  type UseUserAppStateValueResult as _UseUserAppStateValueResult,\n} from './sdk/app-state/useAppStateValue.js';\n\nexport type {\n  _SetOptions,\n  _UseAppStateResult,\n} from './sdk/app-state/useAppStateInternal.js';\n"],
+  "mappings": "AAAA,SAAS,eAAkC;AAC3C,SAAmC,8BAA+B;AAClE;AAAA,EACE;AAAA,OAEK;AAOP,SAAS,uBAAuB;AAChC,SAA4B,uBAAwB;AACpD;AAAA,EAGE;AAAA,OACK;AACP,SAA0B,qBAAsB;AAUhD,SAAyB,oBAAqB;AAC9C,SAAiC,4BAA6B;AAC9D,SAAmC,8BAA+B;AAClE,SAAkC,6BAA8B;AAChE,SAAwB,mBAAoB;AAC5C,SAAsB,iBAAkB;AACxC;AAAA,EACgB;AAAA,OAIT;AAEP,SAAiC,4BAA6B;AAC9D,SAAuC,kCAAmC;AAC1E,SAAS,aAAa;AACtB,SAAgC,2BAA4B;AAO5D,SAAwC,mCAAoC;AAC5E,SAAyB,oBAAqB;AAE9C,SAAS,wBAAwB;AAEjC,SAA2B,sBAAuB;AAClD,SAAS,oBAAoB;AAE7B,SAAS,8BAA8B;AACvC,SAAS,+BAA+B;AAExC,SAAS,0BAA0B;AAEnC,SAAS,8BAA8B;AACvC,SAAS,wBAAwB;AAEjC,SAAiC,4BAA6B;AAE9D,SAAyB,gBAAhBA,qBAAqC;AAK9C,SAAgC,2BAA4B;AAE5D,SAA4B,uBAAwB;AACpD,SAA+B,0BAA2B;AAM1D,SAAS,oBAAoB;AAC7B,SAAS,0BAA0B;AAEnC,SAAS,mBAAmB;AAC5B,SAAqC,gCAAiC;AAEtE,SAAS,sBAAsB;AAK/B,SAAS,2BAA2B;AACpC,SAAuC,kCAAmC;AAK1E,SAAS,4BAA4B;AAErC,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AACxC,SAAS,sBAAsB;AAE/B,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAsF5B,SAAS,UAAU,4BAA4B;AAE/C;AAAA,EAI2B;AAAA,OACpB;AACP,SAAS,uBAAuB;AAChC,SAAwC,mCAAoC;AAC5E,SAAS,4BAA4B;AACrC;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AAEP,SAAS,sBAAsB,iBAAiB;AAChD;AAAA,EACkB;AAAA,EACD;AAAA,EACI;AAAA,OACd;AACP,SAAwB,mBAAoB;AAS5C,SAAS,cAAc;AAEvB;AAAA,EACE;AAAA,OAGK;AACP;AAAA,EACiB;AAAA,EACI;AAAA,OACd;AACP;AAAA,EACsB;AAAA,EACI;AAAA,OAGnB;",
   "names": ["useFocusRing"]
 }

package/esm/core/sdk/app-state/AppStateContext.js

@@ -0,0 +1,27 @@
+import { QueryClient } from "@tanstack/react-query";
+import { createContext } from "react";
+import { createAppStateStore } from "./app-state-store.js";
+const queryClientConfig = {
+  defaultOptions: {
+    queries: {
+      retry: false,
+      // Data only changes via explicit mutations — prevent unnecessary refetches.
+      staleTime: Infinity
+    },
+    mutations: {
+      retry: false
+    }
+  }
+};
+const defaultStore = createAppStateStore();
+defaultStore.setState({ isLoading: false });
+const AppStateContext = createContext({
+  store: defaultStore,
+  scope: "user",
+  queryClient: new QueryClient(queryClientConfig)
+});
+export {
+  AppStateContext,
+  queryClientConfig
+};
+//# sourceMappingURL=AppStateContext.js.map

package/esm/core/sdk/app-state/AppStateContext.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/core/sdk/app-state/AppStateContext.ts"],
+  "sourcesContent": ["import { QueryClient } from '@tanstack/react-query';\nimport { createContext } from 'react';\nimport { type StoreApi } from 'zustand';\n\nimport { createAppStateStore, type AppStateStore } from './app-state-store.js';\n\nexport const queryClientConfig = {\n  defaultOptions: {\n    queries: {\n      retry: false,\n      // Data only changes via explicit mutations \u2014 prevent unnecessary refetches.\n      staleTime: Infinity,\n    },\n    mutations: {\n      retry: false,\n    },\n  },\n};\n\n/**\n * @internal\n */\nexport interface AppStateContextValue {\n  store: StoreApi<AppStateStore>;\n  scope: 'user' | 'app';\n  queryClient: QueryClient;\n}\n\n// Default store used when no AppStateProvider is present.\n// isLoading is false \u2014 no provider means no bulk fetch will happen.\nconst defaultStore = createAppStateStore();\ndefaultStore.setState({ isLoading: false });\n\n/**\n * @internal\n */\nexport const AppStateContext = createContext<AppStateContextValue>({\n  store: defaultStore,\n  scope: 'user',\n  queryClient: new QueryClient(queryClientConfig),\n});\n"],
+  "mappings": "AAAA,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAG9B,SAAS,2BAA+C;AAEjD,MAAM,oBAAoB;AAAA,EAC/B,gBAAgB;AAAA,IACd,SAAS;AAAA,MACP,OAAO;AAAA;AAAA,MAEP,WAAW;AAAA,IACb;AAAA,IACA,WAAW;AAAA,MACT,OAAO;AAAA,IACT;AAAA,EACF;AACF;AAaA,MAAM,eAAe,oBAAoB;AACzC,aAAa,SAAS,EAAE,WAAW,MAAM,CAAC;AAKnC,MAAM,kBAAkB,cAAoC;AAAA,EACjE,OAAO;AAAA,EACP,OAAO;AAAA,EACP,aAAa,IAAI,YAAY,iBAAiB;AAChD,CAAC;",
+  "names": []
+}

package/esm/core/sdk/app-state/AppStateProvider.js

@@ -0,0 +1,87 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { QueryClient, useQuery } from "@tanstack/react-query";
+import {
+  useContext,
+  useLayoutEffect,
+  useMemo,
+  useRef
+} from "react";
+import { stateClient } from "@dynatrace-sdk/client-state";
+import { createAppStateStore } from "./app-state-store.js";
+import {
+  AppStateContext,
+  queryClientConfig
+} from "./AppStateContext.js";
+function AppStateLoader() {
+  const { store, scope, queryClient } = useContext(AppStateContext);
+  const { data, error } = useQuery(
+    {
+      queryKey: ["app-state", scope],
+      queryFn: ({ signal }) => {
+        if (scope === "user") {
+          return stateClient.getUserAppStates({
+            addFields: "value",
+            abortSignal: signal
+          });
+        }
+        return stateClient.getAppStates({
+          addFields: "value",
+          abortSignal: signal
+        });
+      },
+      throwOnError: false
+    },
+    queryClient
+  );
+  useLayoutEffect(() => {
+    if (data !== void 0) {
+      const flattened = {};
+      for (const item of data) {
+        if (item.value !== void 0) {
+          flattened[item.key] = item.value;
+        }
+      }
+      store.setState({ data: flattened, isLoading: false, error: null });
+    }
+  }, [data, store]);
+  useLayoutEffect(() => {
+    if (error !== null) {
+      store.setState({ isLoading: false, error });
+      store.getState().onError?.(error);
+    }
+  }, [error, store]);
+  return null;
+}
+function AppStateProvider({
+  children,
+  scope = "user",
+  onError
+}) {
+  const storeRef = useRef(null);
+  const queryClientRef = useRef(null);
+  let store = storeRef.current;
+  let queryClient = queryClientRef.current;
+  if (store === null || queryClient === null) {
+    store = createAppStateStore();
+    queryClient = new QueryClient(queryClientConfig);
+    storeRef.current = store;
+    queryClientRef.current = queryClient;
+  }
+  useLayoutEffect(() => {
+    store.setState({ onError });
+  }, [onError, store]);
+  const contextValue = useMemo(
+    () => ({ store, scope, queryClient }),
+    // store and queryClient are stable refs; only scope can change
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [scope]
+  );
+  return /* @__PURE__ */ jsxs(AppStateContext.Provider, { value: contextValue, children: [
+    /* @__PURE__ */ jsx(AppStateLoader, {}),
+    children
+  ] });
+}
+export {
+  AppStateProvider
+};
+//# sourceMappingURL=AppStateProvider.js.map

package/esm/core/sdk/app-state/AppStateProvider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/core/sdk/app-state/AppStateProvider.tsx"],
+  "sourcesContent": ["import { QueryClient, useQuery } from '@tanstack/react-query';\nimport {\n  useContext,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  type ReactNode,\n} from 'react';\nimport { type StoreApi } from 'zustand';\n\nimport { stateClient } from '@dynatrace-sdk/client-state';\n\nimport { type AppStateStore, createAppStateStore } from './app-state-store.js';\nimport {\n  AppStateContext,\n  queryClientConfig,\n  type AppStateContextValue,\n} from './AppStateContext.js';\n\n/**\n * Props for {@link AppStateProvider}.\n */\nexport interface AppStateProviderProps {\n  children: ReactNode;\n  /**\n   * Whether to use user-scoped or app-scoped state.\n   * - `'user'`: state is stored per user per app (default is `'user'`)\n   * - `'app'`: state is shared across all users of the app\n   */\n  scope?: 'user' | 'app';\n  /**\n   * Called when the initial state fetch or a mutation fails.\n   */\n  onError?: (error: Error) => void;\n}\n\nfunction AppStateLoader() {\n  const { store, scope, queryClient } = useContext(AppStateContext);\n\n  const { data, error } = useQuery(\n    {\n      queryKey: ['app-state', scope],\n      queryFn: ({ signal }) => {\n        if (scope === 'user') {\n          return stateClient.getUserAppStates({\n            addFields: 'value',\n            abortSignal: signal,\n          });\n        }\n        return stateClient.getAppStates({\n          addFields: 'value',\n          abortSignal: signal,\n        });\n      },\n      throwOnError: false,\n    },\n    queryClient,\n  );\n\n  useLayoutEffect(() => {\n    if (data !== undefined) {\n      const flattened: Record<string, string> = {};\n      for (const item of data) {\n        if (item.value !== undefined) {\n          flattened[item.key] = item.value;\n        }\n      }\n      store.setState({ data: flattened, isLoading: false, error: null });\n    }\n  }, [data, store]);\n\n  useLayoutEffect(() => {\n    if (error !== null) {\n      store.setState({ isLoading: false, error: error as Error });\n      // Read onError imperatively \u2014 it lives in the Zustand store to avoid\n      // putting a potentially-unstable function reference in React context.\n      store.getState().onError?.(error as Error);\n    }\n  }, [error, store]);\n\n  return null;\n}\n\n/**\n * Provides reactive access to Dynatrace app state for its subtree.\n *\n * Wrap your app (or a section of it) in `<AppStateProvider>` and use\n * `_useUserAppState` / `_useAppState` to read and write persisted state keys.\n */\nexport function AppStateProvider({\n  children,\n  scope = 'user',\n  onError,\n}: AppStateProviderProps) {\n  const storeRef = useRef<StoreApi<AppStateStore> | null>(null);\n  const queryClientRef = useRef<QueryClient | null>(null);\n\n  let store = storeRef.current;\n  let queryClient = queryClientRef.current;\n\n  if (store === null || queryClient === null) {\n    store = createAppStateStore();\n    queryClient = new QueryClient(queryClientConfig);\n    storeRef.current = store;\n    queryClientRef.current = queryClient;\n  }\n\n  // Keep onError in the Zustand store so hooks can call it imperatively\n  // without putting a potentially-unstable function reference in React context.\n  useLayoutEffect(() => {\n    store.setState({ onError });\n  }, [onError, store]);\n\n  const contextValue = useMemo<AppStateContextValue>(\n    () => ({ store, scope, queryClient }),\n    // store and queryClient are stable refs; only scope can change\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [scope],\n  );\n\n  return (\n    <AppStateContext.Provider value={contextValue}>\n      <AppStateLoader />\n      {children}\n    </AppStateContext.Provider>\n  );\n}\n"],
+  "mappings": "AAyHI,SACE,KADF;AAzHJ,SAAS,aAAa,gBAAgB;AACtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAGP,SAAS,mBAAmB;AAE5B,SAA6B,2BAA2B;AACxD;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAmBP,SAAS,iBAAiB;AACxB,QAAM,EAAE,OAAO,OAAO,YAAY,IAAI,WAAW,eAAe;AAEhE,QAAM,EAAE,MAAM,MAAM,IAAI;AAAA,IACtB;AAAA,MACE,UAAU,CAAC,aAAa,KAAK;AAAA,MAC7B,SAAS,CAAC,EAAE,OAAO,MAAM;AACvB,YAAI,UAAU,QAAQ;AACpB,iBAAO,YAAY,iBAAiB;AAAA,YAClC,WAAW;AAAA,YACX,aAAa;AAAA,UACf,CAAC;AAAA,QACH;AACA,eAAO,YAAY,aAAa;AAAA,UAC9B,WAAW;AAAA,UACX,aAAa;AAAA,QACf,CAAC;AAAA,MACH;AAAA,MACA,cAAc;AAAA,IAChB;AAAA,IACA;AAAA,EACF;AAEA,kBAAgB,MAAM;AACpB,QAAI,SAAS,QAAW;AACtB,YAAM,YAAoC,CAAC;AAC3C,iBAAW,QAAQ,MAAM;AACvB,YAAI,KAAK,UAAU,QAAW;AAC5B,oBAAU,KAAK,GAAG,IAAI,KAAK;AAAA,QAC7B;AAAA,MACF;AACA,YAAM,SAAS,EAAE,MAAM,WAAW,WAAW,OAAO,OAAO,KAAK,CAAC;AAAA,IACnE;AAAA,EACF,GAAG,CAAC,MAAM,KAAK,CAAC;AAEhB,kBAAgB,MAAM;AACpB,QAAI,UAAU,MAAM;AAClB,YAAM,SAAS,EAAE,WAAW,OAAO,MAAsB,CAAC;AAG1D,YAAM,SAAS,EAAE,UAAU,KAAc;AAAA,IAC3C;AAAA,EACF,GAAG,CAAC,OAAO,KAAK,CAAC;AAEjB,SAAO;AACT;AAQO,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA,QAAQ;AAAA,EACR;AACF,GAA0B;AACxB,QAAM,WAAW,OAAuC,IAAI;AAC5D,QAAM,iBAAiB,OAA2B,IAAI;AAEtD,MAAI,QAAQ,SAAS;AACrB,MAAI,cAAc,eAAe;AAEjC,MAAI,UAAU,QAAQ,gBAAgB,MAAM;AAC1C,YAAQ,oBAAoB;AAC5B,kBAAc,IAAI,YAAY,iBAAiB;AAC/C,aAAS,UAAU;AACnB,mBAAe,UAAU;AAAA,EAC3B;AAIA,kBAAgB,MAAM;AACpB,UAAM,SAAS,EAAE,QAAQ,CAAC;AAAA,EAC5B,GAAG,CAAC,SAAS,KAAK,CAAC;AAEnB,QAAM,eAAe;AAAA,IACnB,OAAO,EAAE,OAAO,OAAO,YAAY;AAAA;AAAA;AAAA,IAGnC,CAAC,KAAK;AAAA,EACR;AAEA,SACE,qBAAC,gBAAgB,UAAhB,EAAyB,OAAO,cAC/B;AAAA,wBAAC,kBAAe;AAAA,IACf;AAAA,KACH;AAEJ;",
+  "names": []
+}

package/esm/core/sdk/app-state/app-state-store.js

@@ -0,0 +1,12 @@
+import { createStore } from "zustand";
+function createAppStateStore() {
+  return createStore(() => ({
+    data: {},
+    isLoading: true,
+    error: null
+  }));
+}
+export {
+  createAppStateStore
+};
+//# sourceMappingURL=app-state-store.js.map

package/esm/core/sdk/app-state/app-state-store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/core/sdk/app-state/app-state-store.ts"],
+  "sourcesContent": ["import { createStore, type StoreApi } from 'zustand';\n\n/**\n * @internal\n */\nexport type AppStateStore = {\n  data: Record<string, string>;\n  isLoading: boolean;\n  error: Error | null;\n  onError?: (error: Error) => void;\n};\n\n/**\n * @internal\n */\nexport function createAppStateStore(): StoreApi<AppStateStore> {\n  return createStore<AppStateStore>(() => ({\n    data: {},\n    isLoading: true,\n    error: null,\n  }));\n}\n"],
+  "mappings": "AAAA,SAAS,mBAAkC;AAepC,SAAS,sBAA+C;AAC7D,SAAO,YAA2B,OAAO;AAAA,IACvC,MAAM,CAAC;AAAA,IACP,WAAW;AAAA,IACX,OAAO;AAAA,EACT,EAAE;AACJ;",
+  "names": []
+}

package/esm/core/sdk/app-state/useAppState.js

@@ -0,0 +1,26 @@
+import { useContext } from "react";
+import { AppStateContext } from "./AppStateContext.js";
+import {
+  appScopedMutateFns,
+  useAppStateInternal,
+  userScopedMutateFns
+} from "./useAppStateInternal.js";
+function useAppState(key) {
+  return useAppStateInternal(
+    key,
+    appScopedMutateFns,
+    useContext(AppStateContext)
+  );
+}
+function useUserAppState(key) {
+  return useAppStateInternal(
+    key,
+    userScopedMutateFns,
+    useContext(AppStateContext)
+  );
+}
+export {
+  useAppState,
+  useUserAppState
+};
+//# sourceMappingURL=useAppState.js.map

package/esm/core/sdk/app-state/useAppState.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/core/sdk/app-state/useAppState.ts"],
+  "sourcesContent": ["import { useContext } from 'react';\n\nimport { AppStateContext } from './AppStateContext.js';\nimport {\n  appScopedMutateFns,\n  useAppStateInternal,\n  userScopedMutateFns,\n  type _UseAppStateResult as UseAppStateResult,\n} from './useAppStateInternal.js';\n\n/**\n * Reads and writes an app-scoped state key (shared across all users).\n * @internal\n */\nexport function useAppState<T = unknown>(key: string): UseAppStateResult<T> {\n  return useAppStateInternal<T>(\n    key,\n    appScopedMutateFns,\n    useContext(AppStateContext),\n  );\n}\n\n/**\n * Reads and writes a user-scoped app state key.\n *\n * Works without a provider \u2014 uses the module-level default context with\n * `scope: 'user'`. Add an `<AppStateProvider>` to get the initial bulk\n * fetch and provider-isolated store.\n * @internal\n */\nexport function useUserAppState<T = unknown>(\n  key: string,\n): UseAppStateResult<T> {\n  return useAppStateInternal<T>(\n    key,\n    userScopedMutateFns,\n    useContext(AppStateContext),\n  );\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAE3B,SAAS,uBAAuB;AAChC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAMA,SAAS,YAAyB,KAAmC;AAC1E,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,WAAW,eAAe;AAAA,EAC5B;AACF;AAUO,SAAS,gBACd,KACsB;AACtB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,WAAW,eAAe;AAAA,EAC5B;AACF;",
+  "names": []
+}

package/esm/core/sdk/app-state/useAppStateInternal.js

@@ -0,0 +1,125 @@
+import { useStore } from "zustand";
+import { getCurrentUserDetails } from "@dynatrace-sdk/app-environment";
+import { stateClient } from "@dynatrace-sdk/client-state";
+const currentUser = getCurrentUserDetails();
+const userScopedMutateFns = {
+  set(key, value, validUntilTime) {
+    return stateClient.setUserAppState({
+      key,
+      body: {
+        value,
+        validUntilTime: validUntilTime ?? null,
+        modificationInfo: {
+          lastModifiedBy: currentUser.id,
+          lastModifiedTime: /* @__PURE__ */ new Date()
+        }
+      }
+    });
+  },
+  remove(key) {
+    return stateClient.deleteUserAppState({ key });
+  }
+};
+const appScopedMutateFns = {
+  set(key, value, validUntilTime) {
+    return stateClient.setAppState({
+      key,
+      body: {
+        value,
+        validUntilTime: validUntilTime ?? null,
+        modificationInfo: {
+          lastModifiedBy: currentUser.id,
+          lastModifiedTime: /* @__PURE__ */ new Date()
+        }
+      }
+    });
+  },
+  remove(key) {
+    return stateClient.deleteAppState({ key });
+  }
+};
+function useAppStateInternal(key, mutateFns, { store: activeStore, scope, queryClient }) {
+  const rawValue = useStore(activeStore, (s) => s.data[key]);
+  const isLoading = useStore(activeStore, (s) => s.isLoading);
+  const error = useStore(activeStore, (s) => s.error);
+  const value = rawValue !== void 0 ? JSON.parse(rawValue) : void 0;
+  async function set(newValue, options) {
+    const cached = queryClient.getQueryData([
+      "app-state",
+      scope
+    ])?.find((item) => item.key === key)?.value;
+    const previous = cached ?? activeStore.getState().data[key];
+    let updatedValue;
+    if (typeof newValue === "function") {
+      const currentValue = previous !== void 0 ? JSON.parse(previous) : void 0;
+      updatedValue = newValue(currentValue);
+    } else {
+      updatedValue = newValue;
+    }
+    try {
+      const serialized = JSON.stringify(updatedValue);
+      activeStore.setState((s) => ({ data: { ...s.data, [key]: serialized } }));
+      await mutateFns.set(key, serialized, options?.validUntilTime);
+      queryClient.setQueryData(
+        ["app-state", scope],
+        (old) => {
+          if (!old) {
+            return old;
+          }
+          const idx = old.findIndex((item) => item.key === key);
+          if (idx === -1) {
+            return [...old, { key, value: serialized }];
+          }
+          return old.map(
+            (item, i) => i === idx ? { ...item, value: serialized } : item
+          );
+        }
+      );
+    } catch (err) {
+      activeStore.setState((s) => {
+        const next = { ...s.data };
+        if (previous === void 0) {
+          delete next[key];
+        } else {
+          next[key] = previous;
+        }
+        return { data: next };
+      });
+      activeStore.getState().onError?.(err);
+    }
+  }
+  async function remove() {
+    const previous = activeStore.getState().data[key];
+    activeStore.setState((s) => {
+      const next = { ...s.data };
+      delete next[key];
+      return { data: next };
+    });
+    try {
+      await mutateFns.remove(key);
+      queryClient.setQueryData(
+        ["app-state", scope],
+        (old) => {
+          if (!old) {
+            return old;
+          }
+          return old.filter((item) => item.key !== key);
+        }
+      );
+    } catch (err) {
+      if (previous !== void 0) {
+        activeStore.setState((s) => ({
+          data: { ...s.data, [key]: previous }
+        }));
+      }
+      activeStore.getState().onError?.(err);
+    }
+  }
+  return { value, isLoading, error, setValue: set, remove };
+}
+export {
+  appScopedMutateFns,
+  useAppStateInternal,
+  userScopedMutateFns
+};
+//# sourceMappingURL=useAppStateInternal.js.map

package/esm/core/sdk/app-state/useAppStateInternal.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/core/sdk/app-state/useAppStateInternal.ts"],
+  "sourcesContent": ["import { useStore } from 'zustand';\n\nimport { getCurrentUserDetails } from '@dynatrace-sdk/app-environment';\nimport { stateClient } from '@dynatrace-sdk/client-state';\n\nimport { type AppStateContextValue } from './AppStateContext.js';\n\nconst currentUser = getCurrentUserDetails();\n\n/**\n * @internal\n */\nexport interface _SetOptions {\n  validUntilTime?: string | null;\n}\n\n/**\n * @internal\n */\nexport type _UseAppStateResult<T> = {\n  value: T | undefined;\n  isLoading: boolean;\n  error: Error | null;\n  setValue: (\n    value: T | ((prev: T | undefined) => T),\n    options?: _SetOptions,\n  ) => Promise<void>;\n  remove: () => Promise<void>;\n};\n\ntype MutateFns = {\n  set: (\n    key: string,\n    value: string,\n    validUntilTime: string | null | undefined,\n  ) => Promise<void>;\n  remove: (key: string) => Promise<void>;\n};\n\nexport const userScopedMutateFns: MutateFns = {\n  set(key: string, value: string, validUntilTime: string | null | undefined) {\n    return stateClient.setUserAppState({\n      key,\n      body: {\n        value,\n        validUntilTime: validUntilTime ?? null,\n        modificationInfo: {\n          lastModifiedBy: currentUser.id,\n          lastModifiedTime: new Date(),\n        },\n      },\n    });\n  },\n  remove(key: string) {\n    return stateClient.deleteUserAppState({ key });\n  },\n};\n\nexport const appScopedMutateFns: MutateFns = {\n  set(key: string, value: string, validUntilTime: string | null | undefined) {\n    return stateClient.setAppState({\n      key,\n      body: {\n        value,\n        validUntilTime: validUntilTime ?? null,\n        modificationInfo: {\n          lastModifiedBy: currentUser.id,\n          lastModifiedTime: new Date(),\n        },\n      },\n    });\n  },\n  remove(key: string) {\n    return stateClient.deleteAppState({ key });\n  },\n};\n\n/**\n * @internal\n */\nexport function useAppStateInternal<T = unknown>(\n  key: string,\n  mutateFns: MutateFns,\n  { store: activeStore, scope, queryClient }: AppStateContextValue,\n): _UseAppStateResult<T> {\n  const rawValue = useStore(activeStore, (s) => s.data[key]);\n  const isLoading = useStore(activeStore, (s) => s.isLoading);\n  const error = useStore(activeStore, (s) => s.error);\n\n  const value =\n    rawValue !== undefined ? (JSON.parse(rawValue) as T) : undefined;\n\n  async function set(\n    newValue: T | ((prev: T) => T),\n    options?: _SetOptions,\n  ): Promise<void> {\n    // The query cache is the source of truth \u2014 it is populated synchronously\n    // when the bulk fetch promise resolves, while the store is only synced via\n    // a re-render cycle that may lag behind under batched updates.\n    const cached = queryClient\n      .getQueryData<Array<{ key: string; value?: string }>>([\n        'app-state',\n        scope,\n      ])\n      ?.find((item) => item.key === key)?.value;\n    const previous = cached ?? activeStore.getState().data[key];\n    let updatedValue: T;\n    if (typeof newValue === 'function') {\n      const currentValue =\n        previous !== undefined ? (JSON.parse(previous) as T) : undefined;\n      updatedValue = (newValue as (prev: T | undefined) => T)(currentValue);\n    } else {\n      updatedValue = newValue as T;\n    }\n\n    try {\n      const serialized = JSON.stringify(updatedValue);\n\n      // Optimistic update\n      activeStore.setState((s) => ({ data: { ...s.data, [key]: serialized } }));\n\n      await mutateFns.set(key, serialized, options?.validUntilTime);\n      // Update query cache so no follow-up GET is needed\n      queryClient.setQueryData(\n        ['app-state', scope],\n        (old: Array<{ key: string; value?: string }> | undefined) => {\n          if (!old) {\n            return old;\n          }\n          const idx = old.findIndex((item) => item.key === key);\n          if (idx === -1) {\n            return [...old, { key, value: serialized }];\n          }\n          return old.map((item, i) =>\n            i === idx ? { ...item, value: serialized } : item,\n          );\n        },\n      );\n    } catch (err) {\n      // Rollback\n      activeStore.setState((s) => {\n        const next = { ...s.data };\n        if (previous === undefined) {\n          delete next[key];\n        } else {\n          next[key] = previous;\n        }\n        return { data: next };\n      });\n      // Read onError imperatively from the store \u2014 avoids React context churn.\n      activeStore.getState().onError?.(err as Error);\n    }\n  }\n\n  async function remove(): Promise<void> {\n    const previous = activeStore.getState().data[key];\n\n    // Optimistic update\n    activeStore.setState((s) => {\n      const next = { ...s.data };\n      delete next[key];\n      return { data: next };\n    });\n\n    try {\n      await mutateFns.remove(key);\n      // Update query cache\n      queryClient.setQueryData(\n        ['app-state', scope],\n        (old: Array<{ key: string; value?: string }> | undefined) => {\n          if (!old) {\n            return old;\n          }\n          return old.filter((item) => item.key !== key);\n        },\n      );\n    } catch (err) {\n      // Rollback\n      if (previous !== undefined) {\n        activeStore.setState((s) => ({\n          data: { ...s.data, [key]: previous },\n        }));\n      }\n      activeStore.getState().onError?.(err as Error);\n    }\n  }\n\n  return { value, isLoading, error, setValue: set, remove };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/esm/core/sdk/app-state/useAppStateValue.js

@@ -0,0 +1,14 @@
+import { useAppState, useUserAppState } from "./useAppState.js";
+function useAppStateValue(key) {
+  const { value, isLoading } = useAppState(key);
+  return { value, isLoading };
+}
+function useUserAppStateValue(key) {
+  const { value, isLoading } = useUserAppState(key);
+  return { value, isLoading };
+}
+export {
+  useAppStateValue,
+  useUserAppStateValue
+};
+//# sourceMappingURL=useAppStateValue.js.map