react-native-terra-ui 0.11.17 → 0.12.1

package/src/components/accordion/parts/AccordionTrigger.tsx

@@ -0,0 +1,88 @@
+import { Children, type ComponentRef, forwardRef, type ReactNode } from "react";
+import { type GestureResponderEvent, Pressable, type PressableProps } from "react-native";
+
+import { StyleSheet } from "react-native-unistyles";
+
+import { Text } from "../../text";
+import { useAccordionItem } from "../context";
+
+export interface AccordionTriggerProps extends Omit<PressableProps, "children" | "disabled"> {
+  /**
+   * The header row. Strings and numbers become the item's title; put an
+   * `Accordion.Indicator` last to show the open state.
+   */
+  children?: ReactNode;
+}
+
+function renderTitle(children: ReactNode): ReactNode {
+  return Children.map(children, (child) => {
+    if (typeof child === "string") {
+      return child.trim().length > 0 ? (
+        <Text variant="body-lg" weight="medium" style={styles.title}>
+          {child}
+        </Text>
+      ) : null;
+    }
+    if (typeof child === "number") {
+      return (
+        <Text variant="body-lg" weight="medium" style={styles.title}>
+          {child}
+        </Text>
+      );
+    }
+    return child;
+  });
+}
+
+export const AccordionTrigger = forwardRef<ComponentRef<typeof Pressable>, AccordionTriggerProps>(
+  function AccordionTrigger({ children, onPress, style, ...rest }, ref) {
+    const { isExpanded, isDisabled, toggle } = useAccordionItem();
+
+    const handlePress = (event: GestureResponderEvent) => {
+      onPress?.(event);
+      toggle();
+    };
+
+    return (
+      <Pressable
+        ref={ref}
+        accessibilityRole="button"
+        accessibilityState={{ expanded: isExpanded, disabled: isDisabled }}
+        disabled={isDisabled}
+        onPress={handlePress}
+        style={(state) => [
+          styles.trigger,
+          state.pressed && styles.pressed,
+          isDisabled && styles.disabled,
+          typeof style === "function" ? style(state) : style,
+        ]}
+        {...rest}
+      >
+        {renderTitle(children)}
+      </Pressable>
+    );
+  }
+);
+
+// ─── Styles ───────────────────────────────────────────────────────────────────
+
+const styles = StyleSheet.create((theme) => ({
+  trigger: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: theme.spacing["3"],
+    minHeight: 48,
+    paddingVertical: theme.spacing["4"],
+  },
+  pressed: {
+    opacity: theme.opacity.pressed,
+  },
+  disabled: {
+    opacity: theme.opacity.disabled,
+  },
+  // Takes the free space so an indicator after it sits at the row's end, and
+  // wraps a long title instead of pushing the indicator off.
+  title: {
+    flex: 1,
+  },
+}));

package/src/components/accordion/types.ts

@@ -0,0 +1,71 @@
+import type { ReactNode } from "react";
+import type { ViewProps } from "react-native";
+
+export type AccordionSelectionMode = "single" | "multiple";
+
+export type AccordionVariant = "plain" | "surface";
+
+interface AccordionBaseProps extends Omit<ViewProps, "children"> {
+  /**
+   * Visual treatment. `'plain'` draws the items straight onto whatever sits
+   * behind the accordion; `'surface'` puts them in a filled, rounded container.
+   * Defaults to `'plain'`.
+   */
+  variant?: AccordionVariant;
+  /** Draws a hairline rule between items. Defaults to `true`. */
+  divided?: boolean;
+  /** Disables every item. Defaults to `false`. */
+  isDisabled?: boolean;
+  /** `Accordion.Item` elements. */
+  children?: ReactNode;
+}
+
+export interface AccordionSingleProps extends AccordionBaseProps {
+  /**
+   * `'single'` keeps at most one item open; opening another closes the current
+   * one. Defaults to `'single'`.
+   */
+  selectionMode?: "single";
+  /**
+   * The open item, controlled. `null` means none is open — `undefined` leaves
+   * the accordion uncontrolled.
+   */
+  value?: string | null;
+  /** The item open on first render, uncontrolled. Defaults to `undefined`. */
+  defaultValue?: string;
+  /** Called with the newly open item, or `null` when the open item closes. */
+  onValueChange?: (value: string | null) => void;
+  /**
+   * Lets the open item close by pressing its trigger again. `false` keeps one
+   * item open at all times once any has been opened. Defaults to `true`.
+   */
+  isCollapsible?: boolean;
+}
+
+export interface AccordionMultipleProps extends AccordionBaseProps {
+  /** `'multiple'` lets any number of items be open at once. */
+  selectionMode: "multiple";
+  /** The open items, controlled. */
+  value?: string[];
+  /** The items open on first render, uncontrolled. Defaults to `[]`. */
+  defaultValue?: string[];
+  /** Called with every open item after one is toggled. */
+  onValueChange?: (value: string[]) => void;
+  /** Multiple mode can always close an item. */
+  isCollapsible?: never;
+}
+
+export type AccordionProps = AccordionSingleProps | AccordionMultipleProps;
+
+export interface AccordionItemState {
+  /** Whether the item's content is open. */
+  isExpanded: boolean;
+  /** Whether the item, or the whole accordion, is disabled. */
+  isDisabled: boolean;
+}
+
+export interface AccordionItemContextValue extends AccordionItemState {
+  value: string;
+  /** Opens or closes this item, following the accordion's selection rules. */
+  toggle: () => void;
+}

package/src/components/accordion/utils.ts

@@ -0,0 +1,12 @@
+import { Easing, ReduceMotion, type WithTimingConfig } from "react-native-reanimated";
+
+/**
+ * Shared by the content's height and the indicator's rotation so the chevron
+ * finishes turning as the panel finishes opening. Honours the system
+ * reduce-motion setting, which makes both jump straight to their end state.
+ */
+export const ACCORDION_TIMING: WithTimingConfig = {
+  duration: 250,
+  easing: Easing.bezier(0.25, 0.1, 0.25, 1),
+  reduceMotion: ReduceMotion.System,
+};

package/src/components/avatar/Avatar.tsx

@@ -4,6 +4,7 @@ import { Text, View } from "react-native";
 import { StyleSheet, useUnistyles } from "react-native-unistyles";
 
 import type { RadiusKey } from "#theme/types";
+import { FONT_WEIGHT_VALUE, SYSTEM_FONT } from "#utils/typography";
 import { Icon } from "../icon";
 import { Image } from "../image";
 import type { AvatarProps, AvatarShape, AvatarSize } from "./types";
@@ -16,8 +17,9 @@ const SIZE_PX: Record<AvatarSize, number> = {
   xl: 64,
 };
 
+// `xs` sits at the 10dp legibility floor rather than scaling the ratio down.
 const INITIALS_FONT_SIZE: Record<AvatarSize, number> = {
-  xs: 9,
+  xs: 10,
   sm: 12,
   md: 15,
   lg: 18,
@@ -75,6 +77,11 @@ export function Avatar({
   const bg = styles.base.backgroundColor ?? "";
   const fg = styles.base.color ?? "";
 
+  // Initials follow the theme's semibold face so a custom font family reaches
+  // the avatar too; the system font takes a numeric weight instead.
+  const initialsFont = theme.typography.fonts.semibold;
+  const isSystemInitialsFont = initialsFont === SYSTEM_FONT;
+
   const fallbackContent =
     fallback !== undefined ? (
       fallback
@@ -82,10 +89,13 @@ export function Avatar({
       <Text
         style={{
           fontSize: INITIALS_FONT_SIZE[size],
-          fontWeight: "600",
+          fontFamily: isSystemInitialsFont ? undefined : initialsFont,
+          fontWeight: isSystemInitialsFont ? FONT_WEIGHT_VALUE.semibold : undefined,
           color: fg,
           includeFontPadding: false,
         }}
+        // The circle is fixed-size, so cap scaling like a control label.
+        maxFontSizeMultiplier={theme.typography.variants["label-sm"].maxFontSizeMultiplier}
         numberOfLines={1}
       >
         {getInitials(name)}

package/src/components/badge/Badge.tsx

@@ -1,78 +1,197 @@
-import { type ComponentRef, forwardRef } from "react";
-import { View } from "react-native";
+import { Text as RNText, View } from "react-native";
 
-import { StyleSheet } from "react-native-unistyles";
+import { StyleSheet, useUnistyles } from "react-native-unistyles";
 
-import { BadgeIndicator } from "./parts/BadgeIndicator";
-import type { BadgeProps } from "./types";
-import { getAnchorPosition } from "./utils";
+import type { ColorToken, RoleTextVariant } from "#theme/types";
+import { resolveThemeColor } from "#utils/resolve-theme-color";
+import { FONT_WEIGHT_VALUE, SYSTEM_FONT } from "#utils/typography";
+import type { BadgeProps, BadgeSize } from "./types";
+import { getCustomBadgeColors, hasLabel } from "./utils";
+
+const SCHEME_NAMES = new Set(["primary", "secondary", "success", "warning", "danger"]);
+
+type BadgeScheme = "primary" | "secondary" | "success" | "warning" | "danger";
+
+/** Label foreground per scheme — mirrors the spec's token table. */
+const FG_TOKEN: Record<BadgeScheme, ColorToken> = {
+  primary: "accent.solid.fg",
+  secondary: "neutral.solid.fg",
+  success: "success.solid.fg",
+  warning: "warning.solid.fg",
+  danger: "danger.solid.fg",
+};
+
+const LABEL_VARIANT: Record<BadgeSize, RoleTextVariant> = {
+  sm: "label-sm",
+  md: "label-md",
+  lg: "label-lg",
+};
 
 /**
- * Overlays a count or status indicator on one corner of the element it wraps.
+ * A dot, or a pill carrying a count or short label.
  *
  * ```tsx
- * <Badge placement="top-right" color="danger" label={3}>
- *   <Toolbar.Button icon="bell" accessibilityLabel="Notifications" />
- * </Badge>
+ * <Text>Appearing</Text>
+ * <Badge color="secondary" size="sm" label={56} />
  * ```
  *
- * The child renders untouched — `Badge` contributes the positioning context and
- * the overlay, nothing else. A round child usually wants a negative `offset`,
- * since the corner being anchored to is the bounding box's, not the circle's.
+ * Stands on its own, inline in a row beside the text it counts. To pin one to
+ * the corner of an icon or button, wrap that element in `WithBadge`, which
+ * renders this and owns only the position.
+ *
+ * `useUnistyles` is called unconditionally, which is what subscribes this
+ * component to theme changes. The background below comes from a variant, which
+ * unistyles applies straight to the native node on a theme switch; without a
+ * re-render React would go on believing the node holds the previous theme's
+ * value. `Chip` documents the same hazard on its root.
  */
-const Badge = forwardRef<ComponentRef<typeof View>, BadgeProps>(function Badge(
-  {
-    children,
-    placement = "top-right",
-    label,
-    color = "danger",
-    size = "md",
-    offset = 0,
-    isVisible = true,
-    fullWidth = false,
-    accessibilityLabel,
-    style,
-    ...rest
-  },
-  ref
-) {
-  styles.useVariants({ fullWidth });
+export const Badge = ({
+  label,
+  color = "danger",
+  size = "md",
+  ring = false,
+  accessibilityLabel,
+  style,
+  ...rest
+}: BadgeProps) => {
+  const { theme } = useUnistyles();
+  // A literal never matches one of the five variant options, so it's cast to
+  // satisfy `useVariants`'s literal-union type while still being compared
+  // against the real value below.
+  styles.useVariants({ color: color as BadgeScheme, size, ring });
+
+  const custom = SCHEME_NAMES.has(color) ? null : getCustomBadgeColors(color);
+  const labelled = hasLabel(label);
+  const foreground = custom ? custom.fg : FG_TOKEN[color as BadgeScheme];
+
+  // An explicit label wins even on a dot; a dot with nothing to announce is
+  // decorative and hidden rather than read out as an unlabelled element.
+  const announced = accessibilityLabel ?? (labelled ? String(label) : undefined);
+  const accessibility = announced
+    ? { accessible: true, accessibilityLabel: announced }
+    : {
+        accessibilityElementsHidden: true,
+        importantForAccessibility: "no-hide-descendants" as const,
+        "aria-hidden": true,
+      };
 
   return (
-    // `style` last so an explicit `alignSelf` beats `fullWidth`.
-    <View ref={ref} style={[styles.wrapper, style]} {...rest}>
-      {children}
-      {isVisible ? (
-        <View pointerEvents="box-none" style={[styles.anchor, getAnchorPosition(placement, size, offset)]}>
-          <BadgeIndicator label={label} color={color} size={size} accessibilityLabel={accessibilityLabel} />
-        </View>
+    <View
+      style={[
+        styles.indicator,
+        labelled ? styles.pill : styles.dot,
+        custom ? { backgroundColor: custom.bg } : null,
+        style,
+      ]}
+      {...rest}
+      {...accessibility}
+    >
+      {labelled ? (
+        <RNText
+          style={[styles.label, { color: resolveThemeColor(foreground, theme) }]}
+          maxFontSizeMultiplier={theme.typography.variants[LABEL_VARIANT[size]].maxFontSizeMultiplier}
+          numberOfLines={1}
+        >
+          {label}
+        </RNText>
       ) : null}
     </View>
   );
-});
-
-export { Badge };
+};
 
 // ─── Styles ───────────────────────────────────────────────────────────────────
 //
-// The indicator's insets are computed in `getAnchorPosition`, not declared here:
-// `offset` is an open-ended number, so it could never be a variant condition,
-// and the position involves no theme tokens at all. That leaves this stylesheet
-// with only what genuinely varies declaratively.
-const styles = StyleSheet.create(() => ({
-  wrapper: {
-    position: "relative",
-    variants: {
-      // `alignSelf: 'flex-start'` hugs the child, so the indicator anchors to
-      // the child's bounds rather than the surrounding container's. A child
-      // that was stretching needs `fullWidth` to go on doing so.
-      fullWidth: {
-        true: { alignSelf: "stretch" },
-        false: { alignSelf: "flex-start" },
+// `color` is a plain variant rather than a compound one: `Badge` renders solid
+// only, so there is no second paint axis for it to interact with.
+//
+// React Native's box model is border-box, so the ring below eats into the
+// badge rather than growing it — the dot's outer diameter stays exactly what
+// `size` declares, with no compensation arithmetic, ring or not.
+const styles = StyleSheet.create((theme) => {
+  const c = theme.color;
+  // A custom font encodes its weight in the family name, so only the system
+  // font takes a numeric `fontWeight` — the same branch `Chip` makes. Inlined
+  // rather than extracted: the unistyles Babel plugin rewrites this factory,
+  // and an imported function called from inside it is not in scope at runtime.
+  const labelFont = theme.typography.fonts.semibold;
+  const isSystemLabelFont = labelFont === SYSTEM_FONT;
+
+  return {
+    indicator: {
+      alignItems: "center",
+      justifyContent: "center",
+      borderRadius: theme.radius.full,
+      borderColor: c["surface.canvas"],
+      variants: {
+        // No styles of its own; it only has to exist for the compound rows
+        // below to match on. The ring's width depends on size as well.
+        size: { sm: {}, md: {}, lg: {} },
+        ring: {
+          true: {},
+          false: { borderWidth: 0 },
+        },
+        color: {
+          primary: { backgroundColor: c["accent.solid.bg"] },
+          secondary: { backgroundColor: c["neutral.solid.bg"] },
+          success: { backgroundColor: c["success.solid.bg"] },
+          warning: { backgroundColor: c["warning.solid.bg"] },
+          danger: { backgroundColor: c["danger.solid.bg"] },
+        },
       },
+      compoundVariants: [
+        { ring: true, size: "sm", styles: { borderWidth: 1.5 } },
+        { ring: true, size: "md", styles: { borderWidth: 2 } },
+        { ring: true, size: "lg", styles: { borderWidth: 2 } },
+      ],
     },
-  },
-  anchor: {
-    position: "absolute",
-  },
-}));
+    // These diameters are mirrored by `DOT_SIZE` in `./utils.ts`, which the
+    // anchor arithmetic reads. The Babel plugin needs them literal here, so a
+    // test asserts the two stay equal.
+    dot: {
+      variants: {
+        size: {
+          sm: { width: 12, height: 12 },
+          md: { width: 16, height: 16 },
+          lg: { width: 20, height: 20 },
+        },
+      },
+    },
+    pill: {
+      variants: {
+        size: {
+          sm: { height: 18, minWidth: 18, paddingHorizontal: 5 },
+          md: { height: 22, minWidth: 22, paddingHorizontal: 6 },
+          lg: { height: 26, minWidth: 26, paddingHorizontal: 8 },
+        },
+      },
+    },
+    // Spelled out rather than derived from `LABEL_VARIANT`: the unistyles Babel
+    // plugin reads this object statically, so computed variant keys are not
+    // safe here even though they would resolve correctly under test.
+    label: {
+      textAlign: "center",
+      includeFontPadding: false,
+      fontFamily: isSystemLabelFont ? undefined : labelFont,
+      fontWeight: isSystemLabelFont ? FONT_WEIGHT_VALUE.semibold : undefined,
+      variants: {
+        size: {
+          sm: {
+            fontSize: theme.typography.variants["label-sm"].fontSize,
+            lineHeight: theme.typography.variants["label-sm"].lineHeight,
+            letterSpacing: theme.typography.variants["label-sm"].letterSpacing,
+          },
+          md: {
+            fontSize: theme.typography.variants["label-md"].fontSize,
+            lineHeight: theme.typography.variants["label-md"].lineHeight,
+            letterSpacing: theme.typography.variants["label-md"].letterSpacing,
+          },
+          lg: {
+            fontSize: theme.typography.variants["label-lg"].fontSize,
+            lineHeight: theme.typography.variants["label-lg"].lineHeight,
+            letterSpacing: theme.typography.variants["label-lg"].letterSpacing,
+          },
+        },
+      },
+    },
+  };
+});

package/src/components/badge/WithBadge.tsx

@@ -0,0 +1,79 @@
+import { type ComponentRef, forwardRef } from "react";
+import { View } from "react-native";
+
+import { StyleSheet } from "react-native-unistyles";
+
+import { Badge } from "./Badge";
+import type { WithBadgeProps } from "./types";
+import { getAnchorPosition } from "./utils";
+
+/**
+ * Pins a `Badge` to one corner of the element it wraps.
+ *
+ * ```tsx
+ * <WithBadge placement="top-right" color="danger" label={3}>
+ *   <Toolbar.Button icon="bell" accessibilityLabel="Notifications" />
+ * </WithBadge>
+ * ```
+ *
+ * The child renders untouched — `WithBadge` contributes the positioning context
+ * and the overlay, nothing else. A round child usually wants a negative
+ * `offset`, since the corner being anchored to is the bounding box's, not the
+ * circle's. For a badge that sits inline beside text, use `Badge` on its own.
+ */
+const WithBadge = forwardRef<ComponentRef<typeof View>, WithBadgeProps>(function WithBadge(
+  {
+    children,
+    placement = "top-right",
+    label,
+    color = "danger",
+    size = "md",
+    offset = 0,
+    isVisible = true,
+    fullWidth = false,
+    accessibilityLabel,
+    style,
+    ...rest
+  },
+  ref
+) {
+  styles.useVariants({ fullWidth });
+
+  return (
+    // `style` last so an explicit `alignSelf` beats `fullWidth`.
+    <View ref={ref} style={[styles.wrapper, style]} {...rest}>
+      {children}
+      {isVisible ? (
+        <View pointerEvents="box-none" style={[styles.anchor, getAnchorPosition(placement, size, offset)]}>
+          <Badge label={label} color={color} size={size} ring accessibilityLabel={accessibilityLabel} />
+        </View>
+      ) : null}
+    </View>
+  );
+});
+
+export { WithBadge };
+
+// ─── Styles ───────────────────────────────────────────────────────────────────
+//
+// The badge's insets are computed in `getAnchorPosition`, not declared here:
+// `offset` is an open-ended number, so it could never be a variant condition,
+// and the position involves no theme tokens at all. That leaves this stylesheet
+// with only what genuinely varies declaratively.
+const styles = StyleSheet.create(() => ({
+  wrapper: {
+    position: "relative",
+    variants: {
+      // `alignSelf: 'flex-start'` hugs the child, so the indicator anchors to
+      // the child's bounds rather than the surrounding container's. A child
+      // that was stretching needs `fullWidth` to go on doing so.
+      fullWidth: {
+        true: { alignSelf: "stretch" },
+        false: { alignSelf: "flex-start" },
+      },
+    },
+  },
+  anchor: {
+    position: "absolute",
+  },
+}));

package/src/components/badge/index.ts

@@ -1,2 +1,3 @@
 export { Badge } from "./Badge";
-export type { BadgeColor, BadgePlacement, BadgeProps, BadgeSize } from "./types";
+export type { BadgeColor, BadgePlacement, BadgeProps, BadgeSize, WithBadgeProps } from "./types";
+export { WithBadge } from "./WithBadge";

package/src/components/badge/types.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from "react";
 import type { ViewProps } from "react-native";
 
-/** Corner of the wrapped child the indicator is anchored to. */
+/** Corner of the wrapped child a `WithBadge` anchors its badge to. */
 export type BadgePlacement = "top-right" | "top-left" | "bottom-right" | "bottom-left";
 
 /** Scale of the dot, pill, and label. */
@@ -9,7 +9,7 @@ export type BadgeSize = "sm" | "md" | "lg";
 
 /**
  * Semantic color scheme, or a raw CSS color literal (`#fff`, `rgb(...)`, `hsl(...)`).
- * A literal paints the indicator with that exact value and derives a readable
+ * A literal paints the badge with that exact value and derives a readable
  * foreground for the label.
  */
 export type BadgeColor =
@@ -21,37 +21,61 @@ export type BadgeColor =
   // literals last so scheme-name autocomplete still surfaces
   | (string & {});
 
-export interface BadgeProps extends ViewProps {
-  /** The element being badged. Rendered untouched; `Badge` only adds the overlay. */
+export interface BadgeProps extends Omit<ViewProps, "children"> {
+  /**
+   * Text in the badge. Omit it (or pass an empty string) for a dot.
+   * `0` renders as a label; a caller hiding a zero count leaves the badge out.
+   */
+  label?: string | number;
+  /** Semantic scheme or raw color literal. Defaults to `'danger'`. */
+  color?: BadgeColor;
+  /** Scale of the badge. Defaults to `'md'`. */
+  size?: BadgeSize;
+  /**
+   * Draws a `surface.canvas` ring around the badge, so it stays legible over
+   * whatever it overlaps. `WithBadge` turns it on. A badge inline beside text
+   * overlaps nothing, so it defaults to `false`: on a card the ring would only
+   * read as an outline.
+   */
+  ring?: boolean;
+  /**
+   * Announced in place of the label. Defaults to the label's own text; an
+   * unlabelled dot is hidden from assistive technology.
+   */
+  accessibilityLabel?: string;
+}
+
+export interface WithBadgeProps extends ViewProps {
+  /** The element being badged. Rendered untouched; `WithBadge` only adds the overlay. */
   children: ReactNode;
   /**
-   * Corner the indicator sits on. Defaults to `'top-right'`.
+   * Corner the badge sits on. Defaults to `'top-right'`.
    *
-   * The indicator overhangs the child, so an ancestor that clips — a `Surface`
+   * The badge overhangs the child, so an ancestor that clips — a `Surface`
    * with a radius, or a `Screen` list row — will cut it off. Pad that container
-   * by the overhang, or lift the `Badge` outside it.
+   * by the overhang, or lift the `WithBadge` outside it.
    */
   placement?: BadgePlacement;
   /**
-   * Text in the indicator. Omit it (or pass an empty string) for a dot.
+   * Text in the badge. Omit it (or pass an empty string) for a dot.
    * `0` renders as a label — use `isVisible` to suppress a zero count.
    */
   label?: string | number;
   /** Semantic scheme or raw color literal. Defaults to `'danger'`. */
   color?: BadgeColor;
-  /** Scale of the indicator. Defaults to `'md'`. */
+  /** Scale of the badge. Defaults to `'md'`. */
   size?: BadgeSize;
   /**
-   * Nudges the indicator along both axes from the corner `placement` picked.
+   * Nudges the badge along both axes from the corner `placement` picked.
    * Positive moves it away from the child's centre, negative pulls it in.
    * A number applies to both axes; `{ x, y }` sets them separately.
    *
    * The corner it anchors to is the child's **bounding box**, so a round child
-   * needs a negative offset to bring the indicator onto the visible edge — a
+   * needs a negative offset to bring the badge onto the visible edge — a
    * circle only meets its box at 45°, about `0.21 × width` away. Defaults to `0`.
    */
   offset?: number | { x?: number; y?: number };
-  /** Renders the indicator. The child renders either way. Defaults to `true`. */
+  /** Renders the badge. The child renders either way. Defaults to `true`. */
   isVisible?: boolean;
   /**
    * Stretches the wrapper along its parent's cross axis, so a child that