@dynatrace/strato-components 0.84.42 → 0.85.0

package/content/progress/hooks/useProgressAriaProps.js

@@ -0,0 +1,63 @@
+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 useProgressAriaProps_exports = {};
+__export(useProgressAriaProps_exports, {
+  useProgressAriaProps: () => useProgressAriaProps
+});
+module.exports = __toCommonJS(useProgressAriaProps_exports);
+var import_lodash_es = require("lodash");
+var import_units = require("@dynatrace-sdk/units");
+function useProgressAriaProps(originalValue, min, max, valueText) {
+  let value;
+  let isIndeterminate;
+  if (originalValue === "indeterminate" || originalValue === void 0) {
+    value = void 0;
+    isIndeterminate = true;
+  } else {
+    value = originalValue;
+    isIndeterminate = false;
+  }
+  if (!isIndeterminate) {
+    value = (0, import_lodash_es.clamp)(originalValue, min, max);
+  }
+  if (!isIndeterminate && value !== void 0 && !valueText) {
+    valueText = (0, import_units.format)(value, { input: import_units.units.percentage.percent });
+  }
+  const progressAriaProps = {
+    // aria-valuenow should only be provided and updated if the value is not indeterminate https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/progressbar_role)
+    "aria-valuenow": isIndeterminate ? void 0 : value,
+    "aria-valuetext": isIndeterminate ? void 0 : valueText,
+    // aria-valuemin should only be provided if min is not 0 (https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/progressbar_role)
+    "aria-valuemin": min !== 0 ? min : void 0,
+    // aria-valuemax should only be provided if min is not 100 (https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/progressbar_role)
+    "aria-valuemax": max !== 100 ? max : void 0,
+    role: "progressbar"
+  };
+  if (isIndeterminate === true && value === void 0) {
+    return {
+      value: void 0,
+      isIndeterminate: true,
+      progressAriaProps
+    };
+  }
+  return {
+    value,
+    isIndeterminate: false,
+    progressAriaProps
+  };
+}

package/content/progress/hooks/useProgressBarPropsContext.d.ts

@@ -0,0 +1,2 @@
+import { SharedProgressBarProps } from '../contexts/SharedProgressBarPropsContext.js';
+export declare function _useSharedProgressBarPropsContext(): SharedProgressBarProps;

package/content/progress/hooks/useProgressBarPropsContext.js

@@ -0,0 +1,32 @@
+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 useProgressBarPropsContext_exports = {};
+__export(useProgressBarPropsContext_exports, {
+  _useSharedProgressBarPropsContext: () => _useSharedProgressBarPropsContext
+});
+module.exports = __toCommonJS(useProgressBarPropsContext_exports);
+var import_react = require("react");
+var import_SharedProgressBarPropsContext = require("../contexts/SharedProgressBarPropsContext.js");
+function _useSharedProgressBarPropsContext() {
+  const context = (0, import_react.useContext)(import_SharedProgressBarPropsContext.SharedProgressBarPropsContext);
+  return {
+    id: context.id,
+    variant: context.variant,
+    density: context.density
+  };
+}

package/content/progress/utils.d.ts

@@ -0,0 +1,2 @@
+import { RoleVariantType } from '../../core/types/role-variant.js';
+export declare function getFillColorFromVariant($variant: RoleVariantType): string;

package/content/progress/utils.js

@@ -0,0 +1,50 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var utils_exports = {};
+__export(utils_exports, {
+  getFillColorFromVariant: () => getFillColorFromVariant
+});
+module.exports = __toCommonJS(utils_exports);
+var import_colors = __toESM(require("@dynatrace/strato-design-tokens/colors"));
+function getFillColorFromVariant($variant) {
+  switch ($variant) {
+    case "onAccent":
+      return import_colors.default.Border.OnAccent.Default;
+    case "primary":
+      return import_colors.default.Border.Primary.Accent;
+    case "success":
+      return import_colors.default.Border.Success.Accent;
+    case "warning":
+      return import_colors.default.Border.Warning.Accent;
+    case "critical":
+      return import_colors.default.Border.Critical.Accent;
+    case "neutral":
+    default:
+      return import_colors.default.Border.Neutral.Accent;
+  }
+}

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

@@ -5,17 +5,17 @@ import { type DataTestId } from '../../types/data-props.js';
 import { type MaskingProps } from '../../types/masking-props.js';
 import { type StylingProps } from '../../types/styling-props.js';
 /**
- * @public
  * AppRoot component props.
+ * @public
  */
 export type AppRootProps = PropsWithChildren<DataTestId & StylingProps & MaskingProps>;
 /**
- * @public
  * In order to have all the providers in place for rendering overlays, applying
  * global styles or internationalization, you need to wrap your app in the
  * `AppRoot`. If you're using the `dt-app` to create your app, this is
  * automatically taken care of and you can start working on your app without
  * further ado.
+ * @public
  */
 export declare const AppRoot: (props: DataTestId & StylingProps & MaskingProps & {
     children?: React.ReactNode;

package/core/hooks/useAriaLabelingProps.d.ts

@@ -0,0 +1,6 @@
+import { AriaLabelingProps } from '../types/a11y-props.js';
+/**
+ * Utility function to extract aria-labeling props from component props to easily spread them to the desired child.
+ * @internal
+ */
+export declare function useAriaLabelingProps<T extends object>(props: AriaLabelingProps & T): AriaLabelingProps;

package/core/hooks/useAriaLabelingProps.js

@@ -0,0 +1,30 @@
+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 useAriaLabelingProps_exports = {};
+__export(useAriaLabelingProps_exports, {
+  useAriaLabelingProps: () => useAriaLabelingProps
+});
+module.exports = __toCommonJS(useAriaLabelingProps_exports);
+function useAriaLabelingProps(props) {
+  return {
+    "aria-label": props["aria-label"],
+    "aria-labelledby": props["aria-labelledby"],
+    "aria-describedby": props["aria-describedby"],
+    "aria-details": props["aria-details"]
+  };
+}

package/core/hooks/useCurrentTheme.d.ts

@@ -1,5 +1,5 @@
 /**
+ * Returns the current theme based on sdk-setting or browsers preferred color-scheme.
  * @public
- * Returns the current theme based on sdk-setting or browsers preferred color-scheme
  */
 export declare function useCurrentTheme(): 'light' | 'dark';

package/core/hooks/useId.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hook used to generate a unique identifier.
+ * @internal
+ */
+export declare const useId: (props?: {
+    /** If a prefix is defined, the hook prepends the prefix with a hyphen to the generated id.
+     * @defaultValue 'strato'
+     */
+    prefix?: string;
+    /** If a seed is defined, the hook uses a seeded random function to generate the id consistently. */
+    seed?: number;
+}) => string;

package/core/hooks/useId.js

@@ -0,0 +1,32 @@
+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 useId_exports = {};
+__export(useId_exports, {
+  useId: () => useId
+});
+module.exports = __toCommonJS(useId_exports);
+var import_react = require("react");
+var import_uuidv4 = require("../utils/uuidv4.js");
+const useId = (props = {}) => {
+  const { prefix = "strato", seed } = props;
+  const generatedId = (0, import_react.useMemo)(
+    () => `${prefix}-${(0, import_uuidv4.uuidv4)(seed)}`,
+    [prefix, seed]
+  );
+  return generatedId;
+};

package/core/hooks/useSafeForwardProps.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The Filtered Props from 'useSafeForwardProps'
+ * @internal
+ */
+export type UseSafeForwardReturnProps<T, P> = Omit<T, keyof P | 'className' | 'classNames' | 'style'>;
+/**
+ * Filters props out of a prop list. Per default className, classNames & style are filtered.
+ * @internal
+ */
+export declare function useSafeForwardProps<T extends object, P extends object>(props: T, excludedProps?: P): UseSafeForwardReturnProps<T, P>;

package/core/hooks/useSafeForwardProps.js

@@ -0,0 +1,34 @@
+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 useSafeForwardProps_exports = {};
+__export(useSafeForwardProps_exports, {
+  useSafeForwardProps: () => useSafeForwardProps
+});
+module.exports = __toCommonJS(useSafeForwardProps_exports);
+function useSafeForwardProps(props, excludedProps) {
+  const ignoreStyles = ["className", "classNames", "style"];
+  const ignoreList = excludedProps ? [...ignoreStyles, ...Object.keys(excludedProps)] : ignoreStyles;
+  const safeForwardProps = {};
+  for (const [name, prop] of Object.entries(props)) {
+    if (!ignoreList.includes(name)) {
+      const localName = name;
+      safeForwardProps[localName] = prop;
+    }
+  }
+  return safeForwardProps;
+}

package/core/index.d.ts

@@ -8,6 +8,7 @@ export type { MaskingProps } from './types/masking-props.js';
 export type { DataTestId } from './types/data-props.js';
 export type { StylingProps } from './types/styling-props.js';
 export type { WithChildren } from './types/with-children.js';
+export type { PolymorphOwnProps, PolymorphProps, PolymorphicComponentProps, } from './types/polymorph.js';
 export { attemptFocus as _attemptFocus } from './utils/focus-management/attempt-focus.js';
 export { focusFirstDescendant as _focusFirstDescendant } from './utils/focus-management/focus-first-descendant.js';
 export { getFirstFocusableChild as _getFirstFocusableChild } from './utils/focus-management/get-first-focusable-child.js';
@@ -15,7 +16,14 @@ export { getLastFocusableChild as _getLastFocusableChild } from './utils/focus-m
 export { isFocusable as _isFocusable } from './utils/focus-management/is-focusable.js';
 export { isBrowser as _isBrowser } from './utils/isBrowser.js';
 export { mergeProps as _mergeProps, type NullToObject as _NullToObject, type TupleTypes as _TupleTypes, type UnionToIntersection as _UnionToIntersection, } from './utils/merge-props.js';
-export type { AriaLabelingProps } from './types/a11y-props.js';
-export type { DOMProps } from './types/dom.js';
-export type { PolymorphicComponentProps, PolymorphProps, PolymorphOwnProps, } from './types/polymorph.js';
 export { type _HeadingLevel, type _HeadingTag } from './types/heading.js';
+export { useAriaLabelingProps as _useAriaLabelingProps } from './hooks/useAriaLabelingProps.js';
+export { useId as _useId } from './hooks/useId.js';
+export { useSafeForwardProps as _useSafeForwardProps } from './hooks/useSafeForwardProps.js';
+export type { UseSafeForwardReturnProps as _UseSafeForwardReturnProps } from './hooks/useSafeForwardProps.js';
+export type { AriaDisabledProps, AriaLabelingProps, } from './types/a11y-props.js';
+export type { DOMProps } from './types/dom.js';
+export { roleVariants } from './types/role-variant.js';
+export type { RoleVariantType } from './types/role-variant.js';
+export { uuidv4 as _uuidv4 } from './utils/uuidv4.js';
+export { isStringChildren as _isStringChildren } from './utils/_is-string-children.js';

package/core/index.js

@@ -26,8 +26,14 @@ __export(core_exports, {
   _getLastFocusableChild: () => import_get_last_focusable_child.getLastFocusableChild,
   _isBrowser: () => import_isBrowser.isBrowser,
   _isFocusable: () => import_is_focusable.isFocusable,
+  _isStringChildren: () => import_is_string_children.isStringChildren,
   _mergeProps: () => import_merge_props.mergeProps,
+  _useAriaLabelingProps: () => import_useAriaLabelingProps.useAriaLabelingProps,
   _useFocusContext: () => import_useFocusContext.useFocusContext,
+  _useId: () => import_useId.useId,
+  _useSafeForwardProps: () => import_useSafeForwardProps.useSafeForwardProps,
+  _uuidv4: () => import_uuidv4.uuidv4,
+  roleVariants: () => import_role_variant.roleVariants,
   useCurrentTheme: () => import_useCurrentTheme.useCurrentTheme
 });
 module.exports = __toCommonJS(core_exports);
@@ -43,3 +49,9 @@ var import_get_last_focusable_child = require("./utils/focus-management/get-last
 var import_is_focusable = require("./utils/focus-management/is-focusable.js");
 var import_isBrowser = require("./utils/isBrowser.js");
 var import_merge_props = require("./utils/merge-props.js");
+var import_useAriaLabelingProps = require("./hooks/useAriaLabelingProps.js");
+var import_useId = require("./hooks/useId.js");
+var import_useSafeForwardProps = require("./hooks/useSafeForwardProps.js");
+var import_role_variant = require("./types/role-variant.js");
+var import_uuidv4 = require("./utils/uuidv4.js");
+var import_is_string_children = require("./utils/_is-string-children.js");

package/core/types/a11y-props.d.ts

@@ -1,5 +1,8 @@
 import type { AriaAttributes } from 'react';
-/** @public */
+/**
+ * Collection of component aria props.
+ * @public
+ */
 export interface AriaLabelingProps {
     /** Labels the current element. */
     'aria-label'?: string;
@@ -10,6 +13,10 @@ export interface AriaLabelingProps {
     /** Identifies the element (or elements) that provide(s) a detailed, extended description for the object. */
     'aria-details'?: string;
 }
+/**
+ * Type used for the adding the `aria-disabled` prop.
+ * @public
+ */
 export type AriaDisabledProps = {
     /**
      * Whether the element and all focusable descendants are disabled.

package/core/types/data-props.d.ts

@@ -1,6 +1,6 @@
 /**
- * @public
  * Type defining the data-testid prop that is mapped to the rendered components root node.
+ * @public
  */
 export type DataTestId = {
     /** Test id used for selecting the component's container. */

package/core/types/dom.d.ts

@@ -1,19 +1,8 @@
-import type { AriaAttributes, AriaRole, CSSProperties, DOMAttributes as ReactDOMAttributes } from 'react';
-import type { FocusableElement } from './focusable-element.js';
-export interface DOMAttributes<T = FocusableElement> extends AriaAttributes, ReactDOMAttributes<T> {
-    id?: string | undefined;
-    role?: AriaRole | undefined;
-    tabIndex?: number | undefined;
-    style?: CSSProperties | undefined;
-    className?: string | undefined;
-}
 /**
  * The props of a DOM Element.
  * @public
- *  */
+ */
 export interface DOMProps {
-    /**
-     * The element's unique identifier. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id).
-     */
+    /** The element's unique identifier. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id). */
     id?: string;
 }

package/core/types/masking-props.d.ts

@@ -1,6 +1,7 @@
 /**
+ * Props defining the masking of data in Session Replay. They are applied to the component's root node.
  * @public
- * Props defining the masking of data in Session Replay. They are applied to the component's root node. */
+ */
 export interface MaskingProps {
     /** Determines whether masking is enabled and the data is replaced with asterisks. */
     'data-dtrum-mask'?: boolean;

package/core/types/polymorph.d.ts

@@ -1,11 +1,12 @@
-import { ComponentProps, ElementType } from 'react';
+import React, { type ComponentProps, type ElementType } from 'react';
 /**
+ * Props type to use with your own to add the as polymorphing prop.
  * @public
- * Props type to use with your own to add the as polymorphing prop */
+ */
 export type PolymorphOwnProps<E extends ElementType = ElementType> = {
     /**
-     * The element type / component used to render
-     * e.g. when `a` is used an anchor tag is created and the component
+     * The element type / component used for rendering
+     * e.g. when `a` is used, an anchor tag is created and the component
      * accepts all props a native anchor also accepts, e.g. a `href` tag.
      * Custom components with their own props are also supported, e.g. a `Link`
      * from a router.
@@ -13,12 +14,14 @@ export type PolymorphOwnProps<E extends ElementType = ElementType> = {
     as?: E;
 };
 /**
+ * Combine the props that come from the underlying ElementType and from your own types and omit naming duplicates.
  * @public
- *  Combine the props that come from the underlying ElementType and from your own types and omit naming duplicates */
+ */
 export type PolymorphProps<E extends ElementType> = PolymorphOwnProps<E> & Omit<ComponentProps<E>, keyof PolymorphOwnProps>;
 /**
- *  @public
- *  Uniontype for the elementtypes polymorph props and your own props P */
+ * Union type for the element types polymorphic props and your own props
+ * @public
+ */
 export type PolymorphicComponentProps<E extends ElementType, P> = P & PolymorphProps<E>;
 declare module 'react' {
     function forwardRef<T, P = unknown>(render: (props: P, ref: React.Ref<T>) => React.ReactElement | null): (props: P & React.RefAttributes<T>) => React.ReactElement | null;

package/core/types/role-variant.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Defines role / color variants
+ * @public
+ */
+export declare const roleVariants: readonly ["neutral", "primary", "success", "warning", "critical", "onAccent"];
+/**
+ * Defines the types of role variants
+ * @public
+ */
+export type RoleVariantType = (typeof roleVariants)[number];

package/core/types/{focusable-element.js → role-variant.js}

@@ -2,6 +2,10 @@ 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))
@@ -11,5 +15,16 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var focusable_element_exports = {};
-module.exports = __toCommonJS(focusable_element_exports);
+var role_variant_exports = {};
+__export(role_variant_exports, {
+  roleVariants: () => roleVariants
+});
+module.exports = __toCommonJS(role_variant_exports);
+const roleVariants = [
+  "neutral",
+  "primary",
+  "success",
+  "warning",
+  "critical",
+  "onAccent"
+];

package/core/types/styling-props.d.ts

@@ -1,7 +1,7 @@
 import type { CSSProperties } from 'react';
 /**
- * @public
  * Collection of component styling props including `style` and `className` types.
+ * @public
  */
 export interface StylingProps {
     /**

package/core/types/with-children.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
 /**
+ * Helper type to add children to props.
  * @public
- * Helper type to add children to props
  */
 export interface WithChildren {
     /** Children provided to the component. */

package/core/utils/_is-string-children.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+/**
+ * Returns whether children only consist of text nodes.
+ * @internal
+ */
+export declare function isStringChildren(children: React.ReactNode): boolean;

package/core/utils/_is-string-children.js

@@ -0,0 +1,44 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var is_string_children_exports = {};
+__export(is_string_children_exports, {
+  isStringChildren: () => isStringChildren
+});
+module.exports = __toCommonJS(is_string_children_exports);
+var import_react = __toESM(require("react"));
+var import_react_intl = require("react-intl");
+var import_react_is = require("react-is");
+function isStringChildren(children) {
+  const childrenArray = import_react.default.Children.toArray(children);
+  if (!childrenArray.some(import_react_is.isElement)) {
+    return true;
+  }
+  return childrenArray.every(
+    (child) => !(0, import_react_is.isElement)(child) || (0, import_react_is.isElement)(child) && child.type && child.type === import_react_intl.FormattedMessage
+  );
+}

package/core/utils/isBrowser.d.ts

@@ -2,6 +2,6 @@
  * @internal
  *
  * Whether the code is currently executed in a browser
- * @see https://github.com/chakra-ui/chakra-ui/blob/main/packages/utils/src/dom.ts
+ * @see {@link https://github.com/chakra-ui/chakra-ui/blob/main/packages/utils/src/dom.ts}
  */
 export declare const isBrowser: boolean;

package/core/utils/merge-props.d.ts

@@ -1,6 +1,6 @@
 /**
+ * Internal helper mapper type for mergeProps.
  * @internal
- * Internal helper mapper type for mergeProps
  */
 export type TupleTypes<T> = {
     [P in keyof T]: T[P];
@@ -8,23 +8,22 @@ export type TupleTypes<T> = {
     [key: number]: infer V;
 } ? NullToObject<V> : never;
 /**
+ * Internal helper mapper type for mergeProps.
  * @internal
- * Internal helper mapper type for mergeProps
  */
 export type NullToObject<T> = T extends null | undefined ? {} : T;
 /**
+ * Internal helper mapper type for mergeProps.
  * @internal
- * Internal helper mapper type for mergeProps
  */
 export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 /**
- * @internal
- *
  * Merges multiple props objects together. Event handlers are chained,
  * classNames are combined, and ids are deduplicated - different ids
  * will trigger a side-effect and re-render components hooked up with `useId`.
  * For all other props, the last prop object overrides all previous ones.
  * @param args - Multiple sets of props to merge together.
+ * @internal
  */
 export declare function mergeProps<T extends ({
     [key: string]: any;

package/core/utils/seed-random.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate a random seed function based on the mulberry32 algorithm
+ * @internal
+ */
+export declare function mulberry32(seed: number): () => number;