@capra/core 1.8.2 → 1.10.0

package/dist/index.d.cts

@@ -1,10 +1,14 @@
 import * as React$2 from "react";
 import React$1, { HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy } from "react";
-import { BreadcrumbProps as BreadcrumbProps$1, BreadcrumbsProps as BreadcrumbsProps$1, ButtonProps as ButtonProps$1, ComboBoxRenderProps, DatePickerProps, DateRangePickerProps, DateValue, DisclosureProps, Focusable, LinkProps as LinkProps$1, ListBoxItemProps, PopoverProps as PopoverProps$1, PressEvent, RouterProvider } from "react-aria-components";
+import { BreadcrumbProps as BreadcrumbProps$1, BreadcrumbsProps as BreadcrumbsProps$1, ButtonProps as ButtonProps$1, ComboBoxRenderProps, DatePickerProps, DateRangePickerProps, DateValue, DisclosureProps, Focusable, Key, LinkProps as LinkProps$1, ListBoxItemProps, PopoverProps as PopoverProps$1, PressEvent, RouterProvider } from "react-aria-components";
 import { SvgIcon } from "@capra/icons";
 import { SvgLogo } from "@capra/icons/logos";
 //#region src/utils/stylingOverride.d.ts
 interface StylingOverrideProps {
+  /** Use `FORCE__className` instead. */
+  className?: never;
+  /** Inline styles are not supported; use component props or `FORCE__className`. */
+  style?: never;
   /**
    * 🚨 This prop is meant to be an escape hatch. 🚨
    *
@@ -208,7 +212,7 @@ type TextProps<As extends React$2.ElementType> = {
    * The underlying element rendered by the component. Defaults to `span`.
    */
   as?: As;
-} & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<As>, 'className'>;
+} & StylingOverrideProps & React$2.ComponentPropsWithoutRef<As>;
 /**
  * Component for displaying text. The visual display can be controlled via
  * `variant`. The underlying HTML element can be controlled via the `as` prop,
@@ -228,7 +232,7 @@ declare const Text: <As extends React$2.ElementType = "span">(props: {
    * The underlying element rendered by the component. Defaults to `span`.
    */
   as?: As | undefined;
-} & StylingOverrideProps & Omit<React$2.PropsWithoutRef<React$2.ComponentProps<As>>, "className"> & React$2.RefAttributes<unknown>) => React$2.ReactElement;
+} & StylingOverrideProps & React$2.PropsWithoutRef<React$2.ComponentProps<As>> & React$2.RefAttributes<unknown>) => React$2.ReactElement;
 //#endregion
 //#region src/components/Card/Card.d.ts
 /**
@@ -305,6 +309,8 @@ type AccessibleLabelProps = LabelledByProp | LabelProp;
 type AccessibleBadgeProps = AccessibleLabelProps & {
   'aria-live'?: React$2.AriaAttributes['aria-live'];
 };
+declare const badgeSizes: readonly ['sm', 'md'];
+type BadgeSize = (typeof badgeSizes)[number];
 type BadgeProps = {
   /**
    * The variant of the badge. 'counter' displays a count, 'dot' displays only a dot.
@@ -315,7 +321,12 @@ type BadgeProps = {
    * Controls the Badge color.
    * @default 'danger'
    */
-  appearance?: 'danger' | 'info' | 'success' | 'warning';
+  appearance?: 'danger' | 'info' | 'success' | 'warning' | 'neutral';
+  /**
+   * Controls the Badge dimensions.
+   * @default 'md'
+   */
+  size?: BadgeSize;
   /**
    * The number to display in the badge. Default is 0.
    */
@@ -332,11 +343,14 @@ type BadgeProps = {
 /**
  * Badges display an indicator/counter on an associated component.
  */
-declare function Badge({ appearance, variant, count, showZero, overflowCount, FORCE__className, ...props }: BadgeProps): React$2.JSX.Element | null;
+declare function Badge({ appearance, variant, size, count, showZero, overflowCount, FORCE__className, style, ...props }: BadgeProps): React$2.JSX.Element | null;
+type BadgeLayoutProps = React$2.PropsWithChildren<{
+  offset?: readonly [x: number, y: number];
+}>;
 /**
  * A convenience component allowing you to easily attach a badge to another component.
  */
-declare function BadgeLayout({ children }: React$2.PropsWithChildren): React$2.JSX.Element;
+declare function BadgeLayout({ children, offset }: BadgeLayoutProps): React$2.JSX.Element;
 //#endregion
 //#region src/components/ListItem/ListItem.d.ts
 type ListItemProps<As extends React$2.ElementType> = {
@@ -345,7 +359,7 @@ type ListItemProps<As extends React$2.ElementType> = {
 declare function ListItem<As extends React$2.ElementType = 'li'>({ as: asComponent, children, FORCE__className: classNameOverride, ...props }: ListItemProps<As>): React$2.JSX.Element;
 declare namespace ListItem {
   export { Content };
-  export { Label };
+  export { Label$1 as Label };
   export { Description };
   export { Suffix };
   export { Spacer };
@@ -358,7 +372,7 @@ declare const Content: ({ children, FORCE__className }: React$2.PropsWithChildre
 type ListItemLabelProps = React$2.PropsWithChildren & {
   id?: string;
 };
-declare const Label: ({ children, id }: ListItemLabelProps) => React$2.JSX.Element;
+declare const Label$1: ({ children, id }: ListItemLabelProps) => React$2.JSX.Element;
 declare const Suffix: ({ children }: React$2.PropsWithChildren) => React$2.JSX.Element;
 declare const Description: ({ children }: React$2.PropsWithChildren) => React$2.JSX.Element;
 declare const Spacer: () => React$2.JSX.Element;
@@ -450,11 +464,11 @@ type ChildrenLabel = {
 /**
  * Require either 'aria-label', 'aria-labelledby', or 'children' for accessibility
  */
-type LabelProps = AccessibleLabelProps | ChildrenLabel;
+type LabelProps$1 = AccessibleLabelProps | ChildrenLabel;
 type RadioProps = {
   /** The value of the radio button. */
   value: string | null;
-} & Partial<RadioGroupContextValue> & LabelProps & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'input'>, 'className' | 'type'>;
+} & Partial<RadioGroupContextValue> & LabelProps$1 & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'input'>, 'className' | 'type'>;
 /**
  * A presentational radio button component. You will typically use this component within a RadioGroup component.
  */
@@ -1324,7 +1338,7 @@ declare const Link: <As extends React$2.ElementType = "a">(props: {
 } & RoutedLinkProps & StylingOverrideProps & Omit<React$2.PropsWithoutRef<React$2.ComponentProps<As>>, "className"> & React$2.RefAttributes<unknown>) => React$2.ReactElement;
 //#endregion
 //#region src/components/VerticalNavigation/VerticalNavigation.d.ts
-interface VerticalNavigationProps extends React$2.HTMLAttributes<HTMLElement>, StylingOverrideProps {
+type VerticalNavigationProps = React$2.HTMLAttributes<HTMLElement> & StylingOverrideProps & {
   /**
    * Controlled collapsed state.
    */
@@ -1338,7 +1352,7 @@ interface VerticalNavigationProps extends React$2.HTMLAttributes<HTMLElement>, S
    * @default false
    */
   defaultCollapsed?: boolean;
-}
+};
 type VerticalNavigationItemBaseProps<As extends React$2.ElementType> = Omit<React$2.ComponentPropsWithoutRef<As>, 'className' | 'as' | 'href' | 'isActive' | 'isDisabled' | 'rightElement' | 'label'> & StylingOverrideProps & {
   /**
    * The component to use for the item. Default is either 'a' or 'button' based on the presence of the href prop.
@@ -1391,19 +1405,19 @@ type VerticalNavigationItemProps<As extends React$2.ElementType> = VerticalNavig
  * Supports icons, active state, and 'subItem' variant for indentation.
  */
 declare const Item: <As extends React$2.ElementType>({ as, icon, label, isActive, href, FORCE__className, isDisabled, onClick, variant, rightElement, ...props }: VerticalNavigationItemProps<As>) => React$2.JSX.Element;
-interface VerticalNavigationCollapseProps extends React$2.ButtonHTMLAttributes<HTMLButtonElement>, StylingOverrideProps {}
+type VerticalNavigationCollapseProps = React$2.ButtonHTMLAttributes<HTMLButtonElement> & StylingOverrideProps;
 /**
  * A toggle button to collapse/expand the navigation.
  * Should be placed within VerticalNavigation to control its state.
  */
 declare const Collapse$1: ({ FORCE__className, onClick, ...props }: VerticalNavigationCollapseProps) => React$2.JSX.Element;
-interface VerticalNavigationItemListProps extends React$2.HTMLAttributes<HTMLUListElement>, StylingOverrideProps {}
+type VerticalNavigationItemListProps = React$2.HTMLAttributes<HTMLUListElement> & StylingOverrideProps;
 /**
  * Container for the primary list of navigation items.
  * Renders an unordered list with consistent spacing and layout.
  */
 declare const ItemList: ({ children, FORCE__className, ...props }: VerticalNavigationItemListProps) => React$2.JSX.Element;
-interface VerticalNavigationFooterProps extends React$2.HTMLAttributes<HTMLUListElement>, StylingOverrideProps {}
+type VerticalNavigationFooterProps = React$2.HTMLAttributes<HTMLUListElement> & StylingOverrideProps;
 /**
  * Secondary container for footer navigation actions such as settings or help.
  */
@@ -1588,7 +1602,7 @@ type SkeletonProps = {
    * (`title={false}` and `paragraph={false}`) children render inside the placeholder while loading.
    */
   children?: React$2.ReactNode;
-} & StylingOverrideProps & Omit<React$2.HTMLAttributes<HTMLSpanElement>, 'children' | 'title' | 'paragraph'>;
+} & Omit<StylingOverrideProps, 'style'> & Omit<React$2.HTMLAttributes<HTMLSpanElement>, 'children' | 'title' | 'paragraph' | 'className'>;
 declare function Skeleton(props: SkeletonProps): React$2.JSX.Element | null;
 declare namespace Skeleton {
   var displayName: string;
@@ -1610,7 +1624,7 @@ type SkeletonElementProps = {
   size?: SkeletonSize;
   /** Show animation effect. @default false */
   active?: boolean;
-} & StylingOverrideProps & Omit<React$2.HTMLAttributes<HTMLSpanElement>, 'children'>;
+} & Omit<StylingOverrideProps, 'style'> & Omit<React$2.HTMLAttributes<HTMLSpanElement>, 'children' | 'className' | 'style'>;
 type SkeletonGroupButtonProps = SkeletonElementProps & {
   block?: boolean;
   shape?: 'circle' | 'round' | 'square' | 'default';
@@ -1810,12 +1824,12 @@ type MenuSectionProps = StylingOverrideProps & Omit<React$2.HTMLAttributes<HTMLD
    */
   children?: React$2.ReactNode;
 };
-interface MenuListProps extends StylingOverrideProps, React$2.HTMLAttributes<HTMLDivElement> {
+type MenuListProps = StylingOverrideProps & React$2.HTMLAttributes<HTMLDivElement> & {
   /**
    * Menu content. Use Menu.Item, Menu.Section, Menu.Header, Menu.Divider.
    */
   children?: React$2.ReactNode;
-}
+};
 interface MenuSubmenuProps extends StylingOverrideProps {
   /**
    * Label for the parent row (trailing chevron indicates a nested panel).
@@ -2133,4 +2147,102 @@ type CustomTooltipTriggerProps = {
  */
 declare const CustomTooltipTrigger: React$2.ForwardRefExoticComponent<CustomTooltipTriggerProps & React$2.RefAttributes<HTMLElement>>;
 //#endregion
-export { Alert, type AlertProps, Anchor, type AnchorProps, AutocompleteField, type AutocompleteFieldProps, Badge, BadgeLayout, type BadgeProps, Breadcrumb, type BreadcrumbProps, Breadcrumbs, type BreadcrumbsProps, Button, ButtonLink, type ButtonLinkProps, type ButtonProps, Card, Checkbox, type CheckboxProps, Collapse, type CollapseProps, CustomTooltipTrigger, type CustomTooltipTriggerProps, DatePickerField, type DatePickerFieldProps, DateRangePickerField, type DateRangePickerFieldPlaceholder, type DateRangePickerFieldProps, Divider, type DividerProps, type DividerType, Drawer, type DrawerPlacement, type DrawerProps, EmptyState, type EmptyStateProps, IconButton, type IconButtonProps, InputRow, type InputRowAddonProps, type InputRowProps, Link, type LinkProps, ListItem, type ListItemProps, Menu, type MenuDividerProps, type MenuHeaderProps, type MenuItemProps, type MenuListProps, type MenuPanelPadding, type MenuProps, type MenuSectionProps, type MenuSubmenuProps, Modal, type ModalProps, NumberField, type NumberFieldProps, Pagination, type PaginationProps, PasswordField, type PasswordFieldProps, Pill, type PillProps, Popover, type PopoverProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, RadioTile, type RadioTileProps, Ribbon, type RibbonProps, type RoutedLinkProps, RouterProvider, SKELETON_SIZE, SKELETON_SIZE_TOKENS, Skeleton, type SkeletonElementProps, SkeletonGroup, type SkeletonGroupButtonProps, type SkeletonGroupInputProps, type SkeletonGroupNodeProps, type SkeletonParagraphProps, type SkeletonProps, type SkeletonSize, type SkeletonTitleProps, Spinner, type SpinnerProps, type StylingOverrideProps, Switch, type SwitchProps, TabNav, type TabNavItemType, type TabNavItemVariant, type TabNavPlacement, type TabNavProps, type TabNavSubItemType, Tag, type TagColor, type TagProps, Text, TextArea, type TextAreaAutoSize, type TextAreaProps, TextField, type TextFieldProps, type TextProps, Toast, type ToastOptions, type ToastPosition, type ToastType, Tooltip, type TooltipProps, TopNav, type TopNavCenterProps, type TopNavEndProps, type TopNavProps, type TopNavStartProps, VerticalNavigation, type VerticalNavigationCollapseProps, type VerticalNavigationFooterProps, type VerticalNavigationItemListProps, type VerticalNavigationItemProps, type VerticalNavigationProps, VisuallyHidden, type VisuallyHiddenProps, submenuPanelClassName, tagColors };
+//#region src/components/Tree/Tree.d.ts
+interface TreeItemType {
+  /**
+   * The unique key of the tree item.
+   */
+  key: Key;
+  /**
+   * The label of the tree item.
+   */
+  label: React$2.ReactNode;
+  /**
+   * The children of the tree item.
+   */
+  children?: TreeItemType[];
+  /**
+   * Whether the tree item is disabled.
+   */
+  isDisabled?: boolean;
+  /**
+   * The suffix of the tree item.
+   */
+  suffix?: React$2.ReactNode;
+  /**
+   * The trailing slot of the tree item.
+   */
+  trailingSlot?: React$2.ReactNode;
+}
+type TreeProps = StylingOverrideProps & {
+  /**
+   * Defines a string value that labels the current element.
+   */
+  'aria-label'?: string;
+  /**
+   * Identifies the element (or elements) that labels the current element.
+   */
+  'aria-labelledby'?: string;
+  /**
+   * Items to render in the tree.
+   */
+  items: TreeItemType[];
+  /**
+   * Handler that is called when a user performs an action on an item.
+   */
+  onAction?: (key: Key) => void;
+  /**
+   * The initial expanded keys when in uncontrolled mode.
+   */
+  defaultExpandedKeys?: Iterable<Key>;
+  /**
+   * The initial selected keys when in uncontrolled mode.
+   */
+  defaultSelectedKeys?: Iterable<Key>;
+  /**
+   * The currently expanded keys when in controlled mode.
+   */
+  expandedKeys?: Iterable<Key>;
+  /**
+   * Handler that is called when the expanded keys change.
+   */
+  onExpandedChange?: (keys: Set<Key>) => void;
+  /**
+   * Callback that is fired when the selection changes.
+   */
+  onSelectionChange?: (keys: Set<Key>) => void;
+  /**
+   * The currently selected keys when in controlled mode.
+   */
+  selectedKeys?: Iterable<Key>;
+  /**
+   * The selection mode of the tree.
+   * @default 'multiple'
+   */
+  selectionMode?: 'none' | 'multiple';
+};
+/**
+ * A hierarchical tree with cascading multi-select and Capra ListItem row layout.
+ */
+declare function Tree({ FORCE__className: classNameOverride, items, selectionMode, defaultSelectedKeys, selectedKeys, onSelectionChange, expandedKeys, defaultExpandedKeys, ...props }: TreeProps): React$2.JSX.Element;
+//#endregion
+//#region src/components/input-helpers/Label.d.ts
+type LabelProps = {
+  /** Text to display in the label. */
+  children?: string;
+  /** Whether the field the label is labeling is required (shows asterisk after label). */
+  required?: boolean;
+  /** Content after the label text. */
+  trailingSlot?: React$2.ReactNode;
+} & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'label'>, 'className' | 'style'>;
+/** Label text and optional required indicator for form fields, aligned with Capra field layouts. */
+declare const Label: React$2.ForwardRefExoticComponent<{
+  /** Text to display in the label. */
+  children?: string;
+  /** Whether the field the label is labeling is required (shows asterisk after label). */
+  required?: boolean;
+  /** Content after the label text. */
+  trailingSlot?: React$2.ReactNode;
+} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement>, "ref">, "className" | "style"> & React$2.RefAttributes<HTMLLabelElement>>;
+//#endregion
+export { Alert, type AlertProps, Anchor, type AnchorProps, AutocompleteField, type AutocompleteFieldProps, Badge, BadgeLayout, type BadgeProps, Breadcrumb, type BreadcrumbProps, Breadcrumbs, type BreadcrumbsProps, Button, ButtonLink, type ButtonLinkProps, type ButtonProps, Card, Checkbox, type CheckboxProps, Collapse, type CollapseProps, CustomTooltipTrigger, type CustomTooltipTriggerProps, DatePickerField, type DatePickerFieldProps, DateRangePickerField, type DateRangePickerFieldPlaceholder, type DateRangePickerFieldProps, Divider, type DividerProps, type DividerType, Drawer, type DrawerPlacement, type DrawerProps, EmptyState, type EmptyStateProps, IconButton, type IconButtonProps, InputRow, type InputRowAddonProps, type InputRowProps, Label, type LabelProps, Link, type LinkProps, ListItem, type ListItemProps, Menu, type MenuDividerProps, type MenuHeaderProps, type MenuItemProps, type MenuListProps, type MenuPanelPadding, type MenuProps, type MenuSectionProps, type MenuSubmenuProps, Modal, type ModalProps, NumberField, type NumberFieldProps, Pagination, type PaginationProps, PasswordField, type PasswordFieldProps, Pill, type PillProps, Popover, type PopoverProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, RadioTile, type RadioTileProps, Ribbon, type RibbonProps, type RoutedLinkProps, RouterProvider, SKELETON_SIZE, SKELETON_SIZE_TOKENS, Skeleton, type SkeletonElementProps, SkeletonGroup, type SkeletonGroupButtonProps, type SkeletonGroupInputProps, type SkeletonGroupNodeProps, type SkeletonParagraphProps, type SkeletonProps, type SkeletonSize, type SkeletonTitleProps, Spinner, type SpinnerProps, type StylingOverrideProps, Switch, type SwitchProps, TabNav, type TabNavItemType, type TabNavItemVariant, type TabNavPlacement, type TabNavProps, type TabNavSubItemType, Tag, type TagColor, type TagProps, Text, TextArea, type TextAreaAutoSize, type TextAreaProps, TextField, type TextFieldProps, type TextProps, Toast, type ToastOptions, type ToastPosition, type ToastType, Tooltip, type TooltipProps, TopNav, type TopNavCenterProps, type TopNavEndProps, type TopNavProps, type TopNavStartProps, Tree, type TreeItemType, type TreeProps, VerticalNavigation, type VerticalNavigationCollapseProps, type VerticalNavigationFooterProps, type VerticalNavigationItemListProps, type VerticalNavigationItemProps, type VerticalNavigationProps, VisuallyHidden, type VisuallyHiddenProps, submenuPanelClassName, tagColors };

package/dist/index.d.mts

@@ -1,10 +1,14 @@
 import * as React$2 from "react";
 import React$1, { HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy } from "react";
 import { SvgIcon } from "@capra/icons";
-import { BreadcrumbProps as BreadcrumbProps$1, BreadcrumbsProps as BreadcrumbsProps$1, ButtonProps as ButtonProps$1, ComboBoxRenderProps, DatePickerProps, DateRangePickerProps, DateValue, DisclosureProps, Focusable, LinkProps as LinkProps$1, ListBoxItemProps, PopoverProps as PopoverProps$1, PressEvent, RouterProvider } from "react-aria-components";
+import { BreadcrumbProps as BreadcrumbProps$1, BreadcrumbsProps as BreadcrumbsProps$1, ButtonProps as ButtonProps$1, ComboBoxRenderProps, DatePickerProps, DateRangePickerProps, DateValue, DisclosureProps, Focusable, Key, LinkProps as LinkProps$1, ListBoxItemProps, PopoverProps as PopoverProps$1, PressEvent, RouterProvider } from "react-aria-components";
 import { SvgLogo } from "@capra/icons/logos";
 //#region src/utils/stylingOverride.d.ts
 interface StylingOverrideProps {
+  /** Use `FORCE__className` instead. */
+  className?: never;
+  /** Inline styles are not supported; use component props or `FORCE__className`. */
+  style?: never;
   /**
    * 🚨 This prop is meant to be an escape hatch. 🚨
    *
@@ -208,7 +212,7 @@ type TextProps<As extends React$2.ElementType> = {
    * The underlying element rendered by the component. Defaults to `span`.
    */
   as?: As;
-} & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<As>, 'className'>;
+} & StylingOverrideProps & React$2.ComponentPropsWithoutRef<As>;
 /**
  * Component for displaying text. The visual display can be controlled via
  * `variant`. The underlying HTML element can be controlled via the `as` prop,
@@ -228,7 +232,7 @@ declare const Text: <As extends React$2.ElementType = "span">(props: {
    * The underlying element rendered by the component. Defaults to `span`.
    */
   as?: As | undefined;
-} & StylingOverrideProps & Omit<React$2.PropsWithoutRef<React$2.ComponentProps<As>>, "className"> & React$2.RefAttributes<unknown>) => React$2.ReactElement;
+} & StylingOverrideProps & React$2.PropsWithoutRef<React$2.ComponentProps<As>> & React$2.RefAttributes<unknown>) => React$2.ReactElement;
 //#endregion
 //#region src/components/Card/Card.d.ts
 /**
@@ -305,6 +309,8 @@ type AccessibleLabelProps = LabelledByProp | LabelProp;
 type AccessibleBadgeProps = AccessibleLabelProps & {
   'aria-live'?: React$2.AriaAttributes['aria-live'];
 };
+declare const badgeSizes: readonly ['sm', 'md'];
+type BadgeSize = (typeof badgeSizes)[number];
 type BadgeProps = {
   /**
    * The variant of the badge. 'counter' displays a count, 'dot' displays only a dot.
@@ -315,7 +321,12 @@ type BadgeProps = {
    * Controls the Badge color.
    * @default 'danger'
    */
-  appearance?: 'danger' | 'info' | 'success' | 'warning';
+  appearance?: 'danger' | 'info' | 'success' | 'warning' | 'neutral';
+  /**
+   * Controls the Badge dimensions.
+   * @default 'md'
+   */
+  size?: BadgeSize;
   /**
    * The number to display in the badge. Default is 0.
    */
@@ -332,11 +343,14 @@ type BadgeProps = {
 /**
  * Badges display an indicator/counter on an associated component.
  */
-declare function Badge({ appearance, variant, count, showZero, overflowCount, FORCE__className, ...props }: BadgeProps): React$2.JSX.Element | null;
+declare function Badge({ appearance, variant, size, count, showZero, overflowCount, FORCE__className, style, ...props }: BadgeProps): React$2.JSX.Element | null;
+type BadgeLayoutProps = React$2.PropsWithChildren<{
+  offset?: readonly [x: number, y: number];
+}>;
 /**
  * A convenience component allowing you to easily attach a badge to another component.
  */
-declare function BadgeLayout({ children }: React$2.PropsWithChildren): React$2.JSX.Element;
+declare function BadgeLayout({ children, offset }: BadgeLayoutProps): React$2.JSX.Element;
 //#endregion
 //#region src/components/ListItem/ListItem.d.ts
 type ListItemProps<As extends React$2.ElementType> = {
@@ -345,7 +359,7 @@ type ListItemProps<As extends React$2.ElementType> = {
 declare function ListItem<As extends React$2.ElementType = 'li'>({ as: asComponent, children, FORCE__className: classNameOverride, ...props }: ListItemProps<As>): React$2.JSX.Element;
 declare namespace ListItem {
   export { Content };
-  export { Label };
+  export { Label$1 as Label };
   export { Description };
   export { Suffix };
   export { Spacer };
@@ -358,7 +372,7 @@ declare const Content: ({ children, FORCE__className }: React$2.PropsWithChildre
 type ListItemLabelProps = React$2.PropsWithChildren & {
   id?: string;
 };
-declare const Label: ({ children, id }: ListItemLabelProps) => React$2.JSX.Element;
+declare const Label$1: ({ children, id }: ListItemLabelProps) => React$2.JSX.Element;
 declare const Suffix: ({ children }: React$2.PropsWithChildren) => React$2.JSX.Element;
 declare const Description: ({ children }: React$2.PropsWithChildren) => React$2.JSX.Element;
 declare const Spacer: () => React$2.JSX.Element;
@@ -450,11 +464,11 @@ type ChildrenLabel = {
 /**
  * Require either 'aria-label', 'aria-labelledby', or 'children' for accessibility
  */
-type LabelProps = AccessibleLabelProps | ChildrenLabel;
+type LabelProps$1 = AccessibleLabelProps | ChildrenLabel;
 type RadioProps = {
   /** The value of the radio button. */
   value: string | null;
-} & Partial<RadioGroupContextValue> & LabelProps & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'input'>, 'className' | 'type'>;
+} & Partial<RadioGroupContextValue> & LabelProps$1 & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'input'>, 'className' | 'type'>;
 /**
  * A presentational radio button component. You will typically use this component within a RadioGroup component.
  */
@@ -1324,7 +1338,7 @@ declare const Link: <As extends React$2.ElementType = "a">(props: {
 } & RoutedLinkProps & StylingOverrideProps & Omit<React$2.PropsWithoutRef<React$2.ComponentProps<As>>, "className"> & React$2.RefAttributes<unknown>) => React$2.ReactElement;
 //#endregion
 //#region src/components/VerticalNavigation/VerticalNavigation.d.ts
-interface VerticalNavigationProps extends React$2.HTMLAttributes<HTMLElement>, StylingOverrideProps {
+type VerticalNavigationProps = React$2.HTMLAttributes<HTMLElement> & StylingOverrideProps & {
   /**
    * Controlled collapsed state.
    */
@@ -1338,7 +1352,7 @@ interface VerticalNavigationProps extends React$2.HTMLAttributes<HTMLElement>, S
    * @default false
    */
   defaultCollapsed?: boolean;
-}
+};
 type VerticalNavigationItemBaseProps<As extends React$2.ElementType> = Omit<React$2.ComponentPropsWithoutRef<As>, 'className' | 'as' | 'href' | 'isActive' | 'isDisabled' | 'rightElement' | 'label'> & StylingOverrideProps & {
   /**
    * The component to use for the item. Default is either 'a' or 'button' based on the presence of the href prop.
@@ -1391,19 +1405,19 @@ type VerticalNavigationItemProps<As extends React$2.ElementType> = VerticalNavig
  * Supports icons, active state, and 'subItem' variant for indentation.
  */
 declare const Item: <As extends React$2.ElementType>({ as, icon, label, isActive, href, FORCE__className, isDisabled, onClick, variant, rightElement, ...props }: VerticalNavigationItemProps<As>) => React$2.JSX.Element;
-interface VerticalNavigationCollapseProps extends React$2.ButtonHTMLAttributes<HTMLButtonElement>, StylingOverrideProps {}
+type VerticalNavigationCollapseProps = React$2.ButtonHTMLAttributes<HTMLButtonElement> & StylingOverrideProps;
 /**
  * A toggle button to collapse/expand the navigation.
  * Should be placed within VerticalNavigation to control its state.
  */
 declare const Collapse$1: ({ FORCE__className, onClick, ...props }: VerticalNavigationCollapseProps) => React$2.JSX.Element;
-interface VerticalNavigationItemListProps extends React$2.HTMLAttributes<HTMLUListElement>, StylingOverrideProps {}
+type VerticalNavigationItemListProps = React$2.HTMLAttributes<HTMLUListElement> & StylingOverrideProps;
 /**
  * Container for the primary list of navigation items.
  * Renders an unordered list with consistent spacing and layout.
  */
 declare const ItemList: ({ children, FORCE__className, ...props }: VerticalNavigationItemListProps) => React$2.JSX.Element;
-interface VerticalNavigationFooterProps extends React$2.HTMLAttributes<HTMLUListElement>, StylingOverrideProps {}
+type VerticalNavigationFooterProps = React$2.HTMLAttributes<HTMLUListElement> & StylingOverrideProps;
 /**
  * Secondary container for footer navigation actions such as settings or help.
  */
@@ -1588,7 +1602,7 @@ type SkeletonProps = {
    * (`title={false}` and `paragraph={false}`) children render inside the placeholder while loading.
    */
   children?: React$2.ReactNode;
-} & StylingOverrideProps & Omit<React$2.HTMLAttributes<HTMLSpanElement>, 'children' | 'title' | 'paragraph'>;
+} & Omit<StylingOverrideProps, 'style'> & Omit<React$2.HTMLAttributes<HTMLSpanElement>, 'children' | 'title' | 'paragraph' | 'className'>;
 declare function Skeleton(props: SkeletonProps): React$2.JSX.Element | null;
 declare namespace Skeleton {
   var displayName: string;
@@ -1610,7 +1624,7 @@ type SkeletonElementProps = {
   size?: SkeletonSize;
   /** Show animation effect. @default false */
   active?: boolean;
-} & StylingOverrideProps & Omit<React$2.HTMLAttributes<HTMLSpanElement>, 'children'>;
+} & Omit<StylingOverrideProps, 'style'> & Omit<React$2.HTMLAttributes<HTMLSpanElement>, 'children' | 'className' | 'style'>;
 type SkeletonGroupButtonProps = SkeletonElementProps & {
   block?: boolean;
   shape?: 'circle' | 'round' | 'square' | 'default';
@@ -1810,12 +1824,12 @@ type MenuSectionProps = StylingOverrideProps & Omit<React$2.HTMLAttributes<HTMLD
    */
   children?: React$2.ReactNode;
 };
-interface MenuListProps extends StylingOverrideProps, React$2.HTMLAttributes<HTMLDivElement> {
+type MenuListProps = StylingOverrideProps & React$2.HTMLAttributes<HTMLDivElement> & {
   /**
    * Menu content. Use Menu.Item, Menu.Section, Menu.Header, Menu.Divider.
    */
   children?: React$2.ReactNode;
-}
+};
 interface MenuSubmenuProps extends StylingOverrideProps {
   /**
    * Label for the parent row (trailing chevron indicates a nested panel).
@@ -2133,4 +2147,102 @@ type CustomTooltipTriggerProps = {
  */
 declare const CustomTooltipTrigger: React$2.ForwardRefExoticComponent<CustomTooltipTriggerProps & React$2.RefAttributes<HTMLElement>>;
 //#endregion
-export { Alert, type AlertProps, Anchor, type AnchorProps, AutocompleteField, type AutocompleteFieldProps, Badge, BadgeLayout, type BadgeProps, Breadcrumb, type BreadcrumbProps, Breadcrumbs, type BreadcrumbsProps, Button, ButtonLink, type ButtonLinkProps, type ButtonProps, Card, Checkbox, type CheckboxProps, Collapse, type CollapseProps, CustomTooltipTrigger, type CustomTooltipTriggerProps, DatePickerField, type DatePickerFieldProps, DateRangePickerField, type DateRangePickerFieldPlaceholder, type DateRangePickerFieldProps, Divider, type DividerProps, type DividerType, Drawer, type DrawerPlacement, type DrawerProps, EmptyState, type EmptyStateProps, IconButton, type IconButtonProps, InputRow, type InputRowAddonProps, type InputRowProps, Link, type LinkProps, ListItem, type ListItemProps, Menu, type MenuDividerProps, type MenuHeaderProps, type MenuItemProps, type MenuListProps, type MenuPanelPadding, type MenuProps, type MenuSectionProps, type MenuSubmenuProps, Modal, type ModalProps, NumberField, type NumberFieldProps, Pagination, type PaginationProps, PasswordField, type PasswordFieldProps, Pill, type PillProps, Popover, type PopoverProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, RadioTile, type RadioTileProps, Ribbon, type RibbonProps, type RoutedLinkProps, RouterProvider, SKELETON_SIZE, SKELETON_SIZE_TOKENS, Skeleton, type SkeletonElementProps, SkeletonGroup, type SkeletonGroupButtonProps, type SkeletonGroupInputProps, type SkeletonGroupNodeProps, type SkeletonParagraphProps, type SkeletonProps, type SkeletonSize, type SkeletonTitleProps, Spinner, type SpinnerProps, type StylingOverrideProps, Switch, type SwitchProps, TabNav, type TabNavItemType, type TabNavItemVariant, type TabNavPlacement, type TabNavProps, type TabNavSubItemType, Tag, type TagColor, type TagProps, Text, TextArea, type TextAreaAutoSize, type TextAreaProps, TextField, type TextFieldProps, type TextProps, Toast, type ToastOptions, type ToastPosition, type ToastType, Tooltip, type TooltipProps, TopNav, type TopNavCenterProps, type TopNavEndProps, type TopNavProps, type TopNavStartProps, VerticalNavigation, type VerticalNavigationCollapseProps, type VerticalNavigationFooterProps, type VerticalNavigationItemListProps, type VerticalNavigationItemProps, type VerticalNavigationProps, VisuallyHidden, type VisuallyHiddenProps, submenuPanelClassName, tagColors };
+//#region src/components/Tree/Tree.d.ts
+interface TreeItemType {
+  /**
+   * The unique key of the tree item.
+   */
+  key: Key;
+  /**
+   * The label of the tree item.
+   */
+  label: React$2.ReactNode;
+  /**
+   * The children of the tree item.
+   */
+  children?: TreeItemType[];
+  /**
+   * Whether the tree item is disabled.
+   */
+  isDisabled?: boolean;
+  /**
+   * The suffix of the tree item.
+   */
+  suffix?: React$2.ReactNode;
+  /**
+   * The trailing slot of the tree item.
+   */
+  trailingSlot?: React$2.ReactNode;
+}
+type TreeProps = StylingOverrideProps & {
+  /**
+   * Defines a string value that labels the current element.
+   */
+  'aria-label'?: string;
+  /**
+   * Identifies the element (or elements) that labels the current element.
+   */
+  'aria-labelledby'?: string;
+  /**
+   * Items to render in the tree.
+   */
+  items: TreeItemType[];
+  /**
+   * Handler that is called when a user performs an action on an item.
+   */
+  onAction?: (key: Key) => void;
+  /**
+   * The initial expanded keys when in uncontrolled mode.
+   */
+  defaultExpandedKeys?: Iterable<Key>;
+  /**
+   * The initial selected keys when in uncontrolled mode.
+   */
+  defaultSelectedKeys?: Iterable<Key>;
+  /**
+   * The currently expanded keys when in controlled mode.
+   */
+  expandedKeys?: Iterable<Key>;
+  /**
+   * Handler that is called when the expanded keys change.
+   */
+  onExpandedChange?: (keys: Set<Key>) => void;
+  /**
+   * Callback that is fired when the selection changes.
+   */
+  onSelectionChange?: (keys: Set<Key>) => void;
+  /**
+   * The currently selected keys when in controlled mode.
+   */
+  selectedKeys?: Iterable<Key>;
+  /**
+   * The selection mode of the tree.
+   * @default 'multiple'
+   */
+  selectionMode?: 'none' | 'multiple';
+};
+/**
+ * A hierarchical tree with cascading multi-select and Capra ListItem row layout.
+ */
+declare function Tree({ FORCE__className: classNameOverride, items, selectionMode, defaultSelectedKeys, selectedKeys, onSelectionChange, expandedKeys, defaultExpandedKeys, ...props }: TreeProps): React$2.JSX.Element;
+//#endregion
+//#region src/components/input-helpers/Label.d.ts
+type LabelProps = {
+  /** Text to display in the label. */
+  children?: string;
+  /** Whether the field the label is labeling is required (shows asterisk after label). */
+  required?: boolean;
+  /** Content after the label text. */
+  trailingSlot?: React$2.ReactNode;
+} & StylingOverrideProps & Omit<React$2.ComponentPropsWithoutRef<'label'>, 'className' | 'style'>;
+/** Label text and optional required indicator for form fields, aligned with Capra field layouts. */
+declare const Label: React$2.ForwardRefExoticComponent<{
+  /** Text to display in the label. */
+  children?: string;
+  /** Whether the field the label is labeling is required (shows asterisk after label). */
+  required?: boolean;
+  /** Content after the label text. */
+  trailingSlot?: React$2.ReactNode;
+} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement>, "ref">, "className" | "style"> & React$2.RefAttributes<HTMLLabelElement>>;
+//#endregion
+export { Alert, type AlertProps, Anchor, type AnchorProps, AutocompleteField, type AutocompleteFieldProps, Badge, BadgeLayout, type BadgeProps, Breadcrumb, type BreadcrumbProps, Breadcrumbs, type BreadcrumbsProps, Button, ButtonLink, type ButtonLinkProps, type ButtonProps, Card, Checkbox, type CheckboxProps, Collapse, type CollapseProps, CustomTooltipTrigger, type CustomTooltipTriggerProps, DatePickerField, type DatePickerFieldProps, DateRangePickerField, type DateRangePickerFieldPlaceholder, type DateRangePickerFieldProps, Divider, type DividerProps, type DividerType, Drawer, type DrawerPlacement, type DrawerProps, EmptyState, type EmptyStateProps, IconButton, type IconButtonProps, InputRow, type InputRowAddonProps, type InputRowProps, Label, type LabelProps, Link, type LinkProps, ListItem, type ListItemProps, Menu, type MenuDividerProps, type MenuHeaderProps, type MenuItemProps, type MenuListProps, type MenuPanelPadding, type MenuProps, type MenuSectionProps, type MenuSubmenuProps, Modal, type ModalProps, NumberField, type NumberFieldProps, Pagination, type PaginationProps, PasswordField, type PasswordFieldProps, Pill, type PillProps, Popover, type PopoverProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, RadioTile, type RadioTileProps, Ribbon, type RibbonProps, type RoutedLinkProps, RouterProvider, SKELETON_SIZE, SKELETON_SIZE_TOKENS, Skeleton, type SkeletonElementProps, SkeletonGroup, type SkeletonGroupButtonProps, type SkeletonGroupInputProps, type SkeletonGroupNodeProps, type SkeletonParagraphProps, type SkeletonProps, type SkeletonSize, type SkeletonTitleProps, Spinner, type SpinnerProps, type StylingOverrideProps, Switch, type SwitchProps, TabNav, type TabNavItemType, type TabNavItemVariant, type TabNavPlacement, type TabNavProps, type TabNavSubItemType, Tag, type TagColor, type TagProps, Text, TextArea, type TextAreaAutoSize, type TextAreaProps, TextField, type TextFieldProps, type TextProps, Toast, type ToastOptions, type ToastPosition, type ToastType, Tooltip, type TooltipProps, TopNav, type TopNavCenterProps, type TopNavEndProps, type TopNavProps, type TopNavStartProps, Tree, type TreeItemType, type TreeProps, VerticalNavigation, type VerticalNavigationCollapseProps, type VerticalNavigationFooterProps, type VerticalNavigationItemListProps, type VerticalNavigationItemProps, type VerticalNavigationProps, VisuallyHidden, type VisuallyHiddenProps, submenuPanelClassName, tagColors };