@commercetools/nimbus 0.0.0-canary-20251015173928 → 0.0.0-canary-20251015182814

package/dist/accordion.d.ts

@@ -1,6 +1,5 @@
 import { AccordionContentProps as AccordionContentProps_2 } from './accordion.types';
 import { AccordionHeaderProps as AccordionHeaderProps_2 } from './accordion.types';
-import { AccordionHeaderRightContentSlot as _AccordionHeaderRightContent } from './accordion.slots';
 import { AccordionItemProps as AccordionItemProps_2 } from './accordion.types';
 import { AccordionRootProps as AccordionRootProps_2 } from './accordion.types';
 import { ButtonProps } from 'react-aria-components';
@@ -31,7 +30,7 @@ export declare const Accordion: {
 export declare const _AccordionContent: ({ children, ref, ...props }: AccordionContentProps) => JSX.Element;
 
 /**
- * Props for Accordion Content component.
+ * Props for the Accordion.Content component.
  * Contains the collapsible content area.
  */
 export declare type AccordionContentProps = ExcludePolymorphicFromProps<DisclosurePanelProps & HTMLChakraProps<"div">> & {
@@ -44,7 +43,7 @@ export declare type AccordionContentProps = ExcludePolymorphicFromProps<Disclosu
 export declare const _AccordionHeader: ({ children, ref, ...props }: AccordionHeaderProps) => JSX.Element;
 
 /**
- * Props for Accordion Header component.
+ * Props for the Accordion.Header component.
  * Displays the clickable header that expands/collapses content.
  */
 export declare type AccordionHeaderProps = ExcludePolymorphicFromProps<ButtonProps & HTMLChakraProps<"div">> & {
@@ -54,12 +53,12 @@ export declare type AccordionHeaderProps = ExcludePolymorphicFromProps<ButtonPro
     ref?: Ref<HTMLButtonElement>;
 };
 
-export { _AccordionHeaderRightContent }
+export declare const _AccordionHeaderRightContent: ForwardRefExoticComponent<Omit<PatchHtmlProps<Omit<DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">>, "page" | "container" | "_hover" | "_active" | "_focus" | "_focusWithin" | "_focusVisible" | "_disabled" | "_visited" | "_target" | "_readOnly" | "_readWrite" | "_empty" | "_checked" | "_enabled" | "_expanded" | "_highlighted" | "_complete" | "_incomplete" | "_dragging" | "_before" | "_after" | "_firstLetter" | "_firstLine" | "_marker" | "_selection" | "_file" | "_backdrop" | "_first" | "_last" | "_notFirst" | "_notLast" | "_only" | "_even" | "_odd" | "_peerFocus" | "_peerHover" | "_peerActive" | "_peerFocusWithin" | "_peerFocusVisible" | "_peerDisabled" | "_peerChecked" | "_peerInvalid" | "_peerExpanded" | "_peerPlaceholderShown" | "_groupFocus" | "_groupHover" | "_groupActive" | "_groupFocusWithin" | "_groupFocusVisible" | "_groupDisabled" | "_groupChecked" | "_groupExpanded" | "_groupInvalid" | "_indeterminate" | "_required" | "_valid" | "_invalid" | "_autofill" | "_inRange" | "_outOfRange" | "_placeholder" | "_placeholderShown" | "_pressed" | "_selected" | "_grabbed" | "_underValue" | "_overValue" | "_atValue" | "_default" | "_optional" | "_open" | "_closed" | "_fullscreen" | "_loading" | "_hidden" | "_current" | "_currentPage" | "_currentStep" | "_today" | "_unavailable" | "_rangeStart" | "_rangeEnd" | "_now" | "_topmost" | "_motionReduce" | "_motionSafe" | "_print" | "_landscape" | "_portrait" | "_dark" | "_light" | "_osDark" | "_osLight" | "_highContrast" | "_lessContrast" | "_moreContrast" | "_ltr" | "_rtl" | "_scrollbar" | "_scrollbarThumb" | "_scrollbarTrack" | "_horizontal" | "_vertical" | "_icon" | "_starting" | "sm" | "smOnly" | "smDown" | "md" | "mdOnly" | "mdDown" | "lg" | "lgOnly" | "lgDown" | "xl" | "xlOnly" | "xlDown" | "2xl" | "2xlOnly" | "2xlDown" | "smToMd" | "smToLg" | "smToXl" | "smTo2xl" | "mdToLg" | "mdToXl" | "mdTo2xl" | "lgToXl" | "lgTo2xl" | "xlTo2xl" | "base" | "borderRadius" | "accentColor" | "alignContent" | "alignItems" | "alignSelf" | "alignTracks" | "animationComposition" | "animationDelay" | "animationDirection" | "animationDuration" | "animationFillMode" | "animationIterationCount" | "animationName" | "animationPlayState" | "animationRangeEnd" | "animationRangeStart" | "animationTimeline" | "animationTimingFunction" | "appearance" | "aspectRatio" | "backdropFilter" | "backfaceVisibility" | "backgroundAttachment" | "backgroundBlendMode" | "backgroundClip" | "backgroundColor" | "backgroundImage" | "backgroundOrigin" | "backgroundPositionX" | "backgroundPositionY" | "backgroundRepeat" | "backgroundSize" | "blockSize" | "borderBlockColor" | "borderBlockEndColor" | "borderBlockEndStyle" | "borderBlockEndWidth" | "borderBlockStartColor" | "borderBlockStartStyle" | "borderBlockStartWidth" | "borderBlockStyle" | "borderBlockWidth" | "borderBottomColor" | "borderBottomLeftRadius" | "borderBottomRightRadius" | "borderBottomStyle" | "borderBottomWidth" | "borderCollapse" | "borderEndEndRadius" | "borderEndStartRadius" | "borderImageOutset" | "borderImageRepeat" | "borderImageSlice" | "borderImageSource" | "borderImageWidth" | "borderInlineColor" | "borderInlineEndColor" | "borderInlineEndStyle" | "borderInlineEndWidth" | "borderInlineStartColor" | "borderInlineStartStyle" | "borderInlineStartWidth" | "borderInlineStyle" | "borderInlineWidth" | "borderLeftColor" | "borderLeftStyle" | "borderLeftWidth" | "borderRightColor" | "borderRightStyle" | "borderRightWidth" | "borderSpacing" | "borderStartEndRadius" | "borderStartStartRadius" | "borderTopColor" | "borderTopLeftRadius" | "borderTopRightRadius" | "borderTopStyle" | "borderTopWidth" | "bottom" | "boxDecorationBreak" | "boxShadow" | "boxSizing" | "breakAfter" | "breakBefore" | "breakInside" | "captionSide" | "caretColor" | "caretShape" | "clear" | "clipPath" | "color" | "colorScheme" | "columnCount" | "columnFill" | "columnGap" | "columnRuleColor" | "columnRuleStyle" | "columnRuleWidth" | "columnSpan" | "columnWidth" | "contain" | "containIntrinsicBlockSize" | "containIntrinsicHeight" | "containIntrinsicInlineSize" | "containIntrinsicWidth" | "containerName" | "containerType" | "content" | "contentVisibility" | "counterIncrement" | "counterReset" | "counterSet" | "cursor" | "direction" | "display" | "emptyCells" | "filter" | "flexBasis" | "flexDirection" | "flexGrow" | "flexShrink" | "flexWrap" | "float" | "fontFamily" | "fontFeatureSettings" | "fontKerning" | "fontLanguageOverride" | "fontOpticalSizing" | "fontPalette" | "fontSize" | "fontSizeAdjust" | "fontSmooth" | "fontStretch" | "fontStyle" | "fontSynthesis" | "fontSynthesisPosition" | "fontSynthesisSmallCaps" | "fontSynthesisStyle" | "fontSynthesisWeight" | "fontVariant" | "fontVariantAlternates" | "fontVariantCaps" | "fontVariantEastAsian" | "fontVariantEmoji" | "fontVariantLigatures" | "fontVariantNumeric" | "fontVariantPosition" | "fontVariationSettings" | "fontWeight" | "forcedColorAdjust" | "gridAutoColumns" | "gridAutoFlow" | "gridAutoRows" | "gridColumnEnd" | "gridColumnStart" | "gridRowEnd" | "gridRowStart" | "gridTemplateAreas" | "gridTemplateColumns" | "gridTemplateRows" | "hangingPunctuation" | "height" | "hyphenateCharacter" | "hyphenateLimitChars" | "hyphens" | "imageOrientation" | "imageRendering" | "imageResolution" | "initialLetter" | "inlineSize" | "insetBlockEnd" | "insetBlockStart" | "insetInlineEnd" | "insetInlineStart" | "isolation" | "justifyContent" | "justifyItems" | "justifySelf" | "justifyTracks" | "left" | "letterSpacing" | "lineBreak" | "lineHeight" | "lineHeightStep" | "listStyleImage" | "listStylePosition" | "listStyleType" | "marginBlockEnd" | "marginBlockStart" | "marginBottom" | "marginInlineEnd" | "marginInlineStart" | "marginLeft" | "marginRight" | "marginTop" | "marginTrim" | "maskBorderMode" | "maskBorderOutset" | "maskBorderRepeat" | "maskBorderSlice" | "maskBorderSource" | "maskBorderWidth" | "maskClip" | "maskComposite" | "maskImage" | "maskMode" | "maskOrigin" | "maskPosition" | "maskRepeat" | "maskSize" | "maskType" | "masonryAutoFlow" | "mathDepth" | "mathShift" | "mathStyle" | "maxBlockSize" | "maxHeight" | "maxInlineSize" | "maxLines" | "maxWidth" | "minBlockSize" | "minHeight" | "minInlineSize" | "minWidth" | "mixBlendMode" | "objectFit" | "objectPosition" | "offsetAnchor" | "offsetDistance" | "offsetPath" | "offsetPosition" | "offsetRotate" | "opacity" | "order" | "orphans" | "outlineColor" | "outlineOffset" | "outlineStyle" | "outlineWidth" | "overflowAnchor" | "overflowBlock" | "overflowClipBox" | "overflowClipMargin" | "overflowInline" | "overflowWrap" | "overflowX" | "overflowY" | "overlay" | "overscrollBehaviorBlock" | "overscrollBehaviorInline" | "overscrollBehaviorX" | "overscrollBehaviorY" | "paddingBlockEnd" | "paddingBlockStart" | "paddingBottom" | "paddingInlineEnd" | "paddingInlineStart" | "paddingLeft" | "paddingRight" | "paddingTop" | "pageBreakAfter" | "pageBreakBefore" | "pageBreakInside" | "paintOrder" | "perspective" | "perspectiveOrigin" | "pointerEvents" | "position" | "printColorAdjust" | "quotes" | "resize" | "right" | "rotate" | "rowGap" | "rubyAlign" | "rubyMerge" | "rubyPosition" | "scale" | "scrollBehavior" | "scrollMarginBlockEnd" | "scrollMarginBlockStart" | "scrollMarginBottom" | "scrollMarginInlineEnd" | "scrollMarginInlineStart" | "scrollMarginLeft" | "scrollMarginRight" | "scrollMarginTop" | "scrollPaddingBlockEnd" | "scrollPaddingBlockStart" | "scrollPaddingBottom" | "scrollPaddingInlineEnd" | "scrollPaddingInlineStart" | "scrollPaddingLeft" | "scrollPaddingRight" | "scrollPaddingTop" | "scrollSnapAlign" | "scrollSnapMarginBottom" | "scrollSnapMarginLeft" | "scrollSnapMarginRight" | "scrollSnapMarginTop" | "scrollSnapStop" | "scrollSnapType" | "scrollTimelineAxis" | "scrollTimelineName" | "scrollbarColor" | "scrollbarGutter" | "scrollbarWidth" | "shapeImageThreshold" | "shapeMargin" | "shapeOutside" | "tabSize" | "tableLayout" | "textAlign" | "textAlignLast" | "textCombineUpright" | "textDecorationColor" | "textDecorationLine" | "textDecorationSkip" | "textDecorationSkipInk" | "textDecorationStyle" | "textDecorationThickness" | "textEmphasisColor" | "textEmphasisPosition" | "textEmphasisStyle" | "textIndent" | "textJustify" | "textOrientation" | "textOverflow" | "textRendering" | "textShadow" | "textSizeAdjust" | "textTransform" | "textUnderlineOffset" | "textUnderlinePosition" | "textWrap" | "timelineScope" | "top" | "touchAction" | "transform" | "transformBox" | "transformOrigin" | "transformStyle" | "transitionBehavior" | "transitionDelay" | "transitionDuration" | "transitionProperty" | "transitionTimingFunction" | "translate" | "unicodeBidi" | "userSelect" | "verticalAlign" | "viewTimelineAxis" | "viewTimelineInset" | "viewTimelineName" | "viewTransitionName" | "visibility" | "whiteSpace" | "whiteSpaceCollapse" | "widows" | "width" | "willChange" | "wordBreak" | "wordSpacing" | "wordWrap" | "writingMode" | "zIndex" | "zoom" | "all" | "animation" | "animationRange" | "background" | "backgroundPosition" | "border" | "borderBlock" | "borderBlockEnd" | "borderBlockStart" | "borderBottom" | "borderColor" | "borderImage" | "borderInline" | "borderInlineEnd" | "borderInlineStart" | "borderLeft" | "borderRight" | "borderStyle" | "borderTop" | "borderWidth" | "caret" | "columnRule" | "columns" | "containIntrinsicSize" | "flex" | "flexFlow" | "font" | "gap" | "grid" | "gridArea" | "gridColumn" | "gridRow" | "gridTemplate" | "inset" | "insetBlock" | "insetInline" | "lineClamp" | "listStyle" | "margin" | "marginBlock" | "marginInline" | "mask" | "maskBorder" | "offset" | "outline" | "overflow" | "overscrollBehavior" | "padding" | "paddingBlock" | "paddingInline" | "placeContent" | "placeItems" | "placeSelf" | "scrollMargin" | "scrollMarginBlock" | "scrollMarginInline" | "scrollPadding" | "scrollPaddingBlock" | "scrollPaddingInline" | "scrollSnapMargin" | "scrollTimeline" | "textDecoration" | "textEmphasis" | "transition" | "viewTimeline" | "WebkitAppearance" | "WebkitBorderBeforeColor" | "WebkitBorderBeforeStyle" | "WebkitBorderBeforeWidth" | "WebkitBoxReflect" | "WebkitLineClamp" | "WebkitMaskAttachment" | "WebkitMaskClip" | "WebkitMaskComposite" | "WebkitMaskImage" | "WebkitMaskOrigin" | "WebkitMaskPosition" | "WebkitMaskPositionX" | "WebkitMaskPositionY" | "WebkitMaskRepeat" | "WebkitMaskRepeatX" | "WebkitMaskRepeatY" | "WebkitMaskSize" | "WebkitOverflowScrolling" | "WebkitTapHighlightColor" | "WebkitTextFillColor" | "WebkitTextStrokeColor" | "WebkitTextStrokeWidth" | "WebkitTouchCallout" | "WebkitUserModify" | "WebkitUserSelect" | "WebkitBorderBefore" | "WebkitMask" | "WebkitTextStroke" | "boxAlign" | "boxDirection" | "boxFlex" | "boxFlexGroup" | "boxLines" | "boxOrdinalGroup" | "boxOrient" | "boxPack" | "clip" | "gridColumnGap" | "gridGap" | "gridRowGap" | "imeMode" | "scrollSnapCoordinate" | "scrollSnapDestination" | "scrollSnapPointsX" | "scrollSnapPointsY" | "scrollSnapTypeX" | "scrollSnapTypeY" | "alignmentBaseline" | "baselineShift" | "clipRule" | "colorInterpolation" | "colorRendering" | "dominantBaseline" | "fill" | "fillOpacity" | "fillRule" | "floodColor" | "floodOpacity" | "glyphOrientationVertical" | "lightingColor" | "marker" | "markerEnd" | "markerMid" | "markerStart" | "shapeRendering" | "stopColor" | "stopOpacity" | "stroke" | "strokeDasharray" | "strokeDashoffset" | "strokeLinecap" | "strokeLinejoin" | "strokeMiterlimit" | "strokeOpacity" | "strokeWidth" | "textAnchor" | "vectorEffect" | "bg" | "colorPalette" | "invert" | "focusVisibleRing" | "layerStyle" | "focusRing" | "h" | "minW" | "px" | "anchorName" | "anchorScope" | "colorInterpolationFilters" | "cx" | "cy" | "d" | "fieldSizing" | "initialLetterAlign" | "interpolateSize" | "positionAnchor" | "positionArea" | "positionTry" | "positionTryFallbacks" | "positionTryOrder" | "positionVisibility" | "r" | "rx" | "ry" | "textBox" | "textBoxEdge" | "textBoxTrim" | "textSpacingTrim" | "textWrapMode" | "textWrapStyle" | "x" | "y" | "bgColor" | "bgSize" | "bgPos" | "bgRepeat" | "bgAttachment" | "bgClip" | "bgGradient" | "bgImg" | "bgImage" | "borderStart" | "borderEnd" | "borderX" | "borderY" | "borderStartColor" | "borderEndColor" | "borderStartStyle" | "borderEndStyle" | "rounded" | "roundedTopLeft" | "roundedStartStart" | "borderTopStartRadius" | "roundedEndStart" | "borderBottomStartRadius" | "roundedTopRight" | "roundedStartEnd" | "borderTopEndRadius" | "roundedEndEnd" | "borderBottomEndRadius" | "roundedBottomLeft" | "roundedBottomRight" | "roundedStart" | "borderStartRadius" | "roundedEnd" | "borderEndRadius" | "roundedTop" | "roundedBottom" | "roundedLeft" | "roundedRight" | "borderXWidth" | "borderStartWidth" | "borderEndWidth" | "borderYWidth" | "shadow" | "shadowColor" | "blendMode" | "bgBlendMode" | "gapY" | "gapX" | "flexDir" | "w" | "minH" | "maxW" | "maxH" | "overscroll" | "overscrollX" | "overscrollY" | "scrollPaddingX" | "scrollPaddingY" | "listStylePos" | "listStyleImg" | "pos" | "insetX" | "insetY" | "insetStart" | "insetEnd" | "m" | "mt" | "mr" | "mb" | "ml" | "ms" | "marginStart" | "me" | "marginEnd" | "mx" | "marginX" | "my" | "marginY" | "p" | "pt" | "pr" | "pb" | "pl" | "ps" | "paddingStart" | "pe" | "paddingEnd" | "paddingX" | "py" | "paddingY" | "textDecor" | "backgroundGradient" | "gradientFrom" | "gradientTo" | "gradientVia" | "borderInlineStartRadius" | "borderInlineEndRadius" | "borderTopRadius" | "borderBottomRadius" | "borderLeftRadius" | "borderRightRadius" | "divideX" | "divideY" | "divideColor" | "divideStyle" | "boxShadowColor" | "blur" | "brightness" | "contrast" | "grayscale" | "hueRotate" | "saturate" | "sepia" | "dropShadow" | "backdropBlur" | "backdropBrightness" | "backdropContrast" | "backdropGrayscale" | "backdropHueRotate" | "backdropInvert" | "backdropOpacity" | "backdropSaturate" | "backdropSepia" | "focusRingColor" | "focusRingOffset" | "focusRingWidth" | "focusRingStyle" | "boxSize" | "hideFrom" | "hideBelow" | "scrollbar" | "scrollMarginX" | "scrollMarginY" | "scrollSnapStrictness" | "ring" | "ringColor" | "ringOffset" | "ringOffsetColor" | "ringInset" | "skewX" | "skewY" | "scaleX" | "scaleY" | "spaceXReverse" | "spaceX" | "spaceYReverse" | "spaceY" | "rotateX" | "rotateY" | "translateX" | "translateY" | "truncate" | "borderSpacingX" | "borderSpacingY" | "srOnly" | "debug" | "textStyle" | "animationStyle" | "css" | keyof PolymorphicProps> & Omit<JsxStyleProps, never> & PolymorphicProps & RefAttributes<HTMLDivElement>>;
 
 export declare const _AccordionItem: ({ children, value, ref, ...props }: AccordionItemProps) => JSX.Element;
 
 /**
- * Props for individual Accordion Item components.
+ * Props for the Accordion.Item component.
  */
 export declare type AccordionItemProps = ExcludePolymorphicFromProps<DisclosureProps & HTMLChakraProps<"div">> & {
     /** The accordion item content (Header and Content components) */
@@ -82,7 +81,7 @@ declare type AccordionRecipeProps = SlotRecipeProps<"accordion">;
 export declare const _AccordionRoot: (props: AccordionRootProps) => JSX.Element;
 
 /**
- * Props for the Accordion Root component.
+ * Props for the Accordion.Root component.
  * Controls the overall accordion container and behavior.
  */
 export declare type AccordionRootProps = AccordionRootSlotProps & DisclosureGroupProps & {
@@ -95,16 +94,32 @@ export declare type AccordionRootProps = AccordionRootSlotProps & DisclosureGrou
 export declare type AccordionRootSlotProps = HTMLChakraProps<"div", AccordionRecipeProps>;
 
 /**
- * For use in components that use the polymorphic `as` and `asChild` props
+ * Utility type helpers for Nimbus components
+ */
+/**
+ * Excludes polymorphic props (`as` and `asChild`) from a type.
+ *
+ * **Use case:** For components that use the polymorphic `as` and `asChild` props
  * internally, but do not make them available to the consumer.
  *
- * Long rambling background:
+ * **Background:**
  * React-Aria's components cannot be configured to use `as` and `asChild` internally,
- * and cannot be directly styled by chakra's styledSystem. Therefore components
- * from `react-aria-components` should be wrapped in a chakra `withContext`
+ * and cannot be directly styled by Chakra's styledSystem. Therefore components
+ * from `react-aria-components` should be wrapped in a Chakra `withContext`
  * root component to set the styles onto the `r-a-c` component using `asChild`.
  * This means that we need to allow polymorphism internally, but should not
- * allow it in the external props api since it would not work.
+ * allow it in the external props API since it would not work.
+ *
+ * @template T - The type to exclude polymorphic props from
+ *
+ * @example
+ * ```typescript
+ * export type AccordionItemProps = ExcludePolymorphicFromProps<
+ *   RaDisclosureProps & HTMLChakraProps<"div">
+ * > & {
+ *   children: ReactNode;
+ * };
+ * ```
  */
 declare type ExcludePolymorphicFromProps<T> = Omit<T, "as" | "asChild">;
 

package/dist/alert.d.ts

@@ -40,15 +40,21 @@ export declare const _AlertActions: {
     displayName: string;
 };
 
-/** Base Chakra styling props for the `actions` slot (`div`). */
-export declare type AlertActionsProps = HTMLChakraProps<"div">;
+/**
+ * Props for the Alert.Actions component.
+ */
+export declare type AlertActionsProps = AlertActionsSlotProps;
+
+export declare type AlertActionsSlotProps = HTMLChakraProps<"div">;
 
 export declare const _AlertDescription: {
     ({ children, ...props }: AlertDescriptionProps): null;
     displayName: string;
 };
 
-/** Props for the `Alert.Description` sub-component (inherits from Text). */
+/**
+ * Props for the Alert.Description component.
+ */
 export declare type AlertDescriptionProps = Omit<TextProps, "ref"> & {
     ref?: React.Ref<HTMLDivElement>;
 };
@@ -58,20 +64,30 @@ export declare const _AlertDismissButton: {
     displayName: string;
 };
 
-/** Props for the `Alert.DismissButton` sub-component (inherits from Button). */
+/**
+ * Props for the Alert.DismissButton component.
+ */
 export declare type AlertDismissButtonProps = ButtonProps;
 
-/** Base Chakra styling props for the `icon` slot (`div`). */
-export declare type AlertIconProps = HTMLChakraProps<"div">;
+/**
+ * Props for the Alert.Icon component.
+ */
+export declare type AlertIconProps = AlertIconSlotProps;
+
+export declare type AlertIconSlotProps = HTMLChakraProps<"div">;
 
-/** Final external props for the `<Alert>` component (variants + children + data-* attrs). */
-export declare type AlertProps = AlertRootProps & {
+/**
+ * Props for the Alert.Root component.
+ */
+export declare type AlertProps = AlertRootSlotProps & {
     [key: `data-${string}`]: unknown;
     ref?: React.Ref<HTMLDivElement>;
 };
 
 declare type AlertRecipeProps = {
+    /** Color tone palette for the alert */
     tone?: SlotRecipeProps<"alert">["tone"];
+    /** Visual style variant of the alert */
     variant?: SlotRecipeProps<"alert">["variant"];
 };
 
@@ -84,51 +100,61 @@ declare type AlertRecipeProps = {
  */
 export declare const _AlertRoot: AlertRootComponent;
 
-/** Type signature for the main `Alert` component. */
+/**
+ * Type signature for the main Alert component.
+ */
 export declare type AlertRootComponent = React.FC<AlertProps>;
 
-/** Base Chakra styling props for the root `div` slot. */
-export declare type AlertRootProps = HTMLChakraProps<"div", AlertRecipeProps>;
+export declare type AlertRootSlotProps = HTMLChakraProps<"div", AlertRecipeProps>;
 
 export declare const _AlertTitle: {
     ({ children, ...props }: AlertTitleProps): null;
     displayName: string;
 };
 
-/** Props for the `Alert.Title` sub-component (inherits from Text). */
+/**
+ * Props for the Alert.Title component.
+ */
 export declare type AlertTitleProps = Omit<TextProps, "ref"> & {
     ref?: React.Ref<HTMLDivElement>;
 };
 
-declare type ButtonProps = ButtonRootProps & FunctionalButtonProps & {
+declare type ButtonProps = Omit<ButtonRootSlotProps, keyof AriaButtonProps> & AriaButtonProps & {
+    /**
+     * Data attributes for testing or custom metadata
+     */
+    [key: `data-${string}`]: unknown;
+    /**
+     * Slot name for React Aria Components composition
+     */
     slot?: string | null | undefined;
+    /**
+     * Ref forwarding to the button element
+     */
     ref?: React.Ref<HTMLButtonElement>;
 };
 
-/**
- * Base recipe props interface that combines Chakra UI's recipe props
- * with the unstyled prop option for the button element.
- */
 declare type ButtonRecipeProps = {
+    /**
+     * Size variant of the button
+     * @default "md"
+     */
     size?: RecipeProps<"button">["size"];
+    /**
+     * Visual style variant of the button
+     * @default "subtle"
+     */
     variant?: RecipeProps<"button">["variant"];
+    /**
+     * Color tone palette for the button
+     */
     tone?: RecipeProps<"button">["tone"];
 } & UnstyledProp;
 
-/**
- * Root props interface that extends Chakra's HTML props with our recipe props.
- * This creates a complete set of props for the root element, combining
- * HTML attributes, Chakra's styling system, and our custom recipe props.
- */
-declare type ButtonRootProps = Omit<HTMLChakraProps<"button", ButtonRecipeProps>, "slot"> & {
+declare type ButtonRootSlotProps = Omit<HTMLChakraProps<"button", ButtonRecipeProps>, "slot"> & {
     slot?: string | null | undefined;
 };
 
-/** combine chakra-button props with aria-button props */
-declare type FunctionalButtonProps = AriaButtonProps & Omit<ButtonRootProps, keyof AriaButtonProps | "slot"> & {
-    [key: `data-${string}`]: unknown;
-};
-
 declare type TextProps = Omit<TextProps_2, "slot"> & {
     ref?: React.Ref<HTMLElement>;
     slot?: string | null | undefined;

package/dist/avatar.d.ts

@@ -9,49 +9,47 @@ export declare const Avatar: {
     displayName: string;
 };
 
-export declare type AvatarComponentProps = HTMLAttributes<HTMLDivElement> & {
+export declare type AvatarProps = AvatarRootSlotProps & HTMLAttributes<HTMLDivElement> & {
     /**
-     * The first name used to show initials
+     * First name for generating initials
      */
     firstName: string;
     /**
-     * The last name used to show initials
+     * Last name for generating initials
      */
     lastName: string;
     /**
-     * The image URL
+     * Image source URL for the avatar
      */
     src?: string;
     /**
-     * Alt text for the avatar image
+     * Alternative text for the avatar image
      */
     alt?: string;
     /**
-     * If the avatar is disabled
+     * Whether the avatar is disabled
+     * @default false
      */
     isDisabled?: boolean;
-};
-
-export declare type AvatarProps = FunctionalAvatarProps & {
+    /**
+     * Custom content to override default avatar rendering
+     */
     children?: React.ReactNode;
+    /**
+     * Ref forwarding to the root element
+     */
     ref?: React.Ref<HTMLDivElement>;
 };
 
 declare type AvatarRecipeProps = {
-    size?: RecipeProps<"avatar">["size"];
-} & UnstyledProp;
-
-declare type AvatarRecipeVariantProps = {
     /**
-     * Size variant
+     * Size variant of the avatar
      * @default "md"
      */
-    size?: "md" | "xs" | "2xs";
-};
-
-export declare type AvatarRootProps = HTMLChakraProps<"div", AvatarRecipeProps>;
+    size?: RecipeProps<"avatar">["size"];
+} & UnstyledProp;
 
-declare type FunctionalAvatarProps = AvatarRootProps & AvatarComponentProps & AvatarRecipeVariantProps;
+export declare type AvatarRootSlotProps = HTMLChakraProps<"div", AvatarRecipeProps>;
 
 export { }
 

package/dist/badge.d.ts

@@ -15,31 +15,30 @@ export declare const Badge: {
     displayName: string;
 };
 
-/**
- * Main props interface for the Badge component.
- * Extends BadgeVariantProps to include both root props and variant props,
- * while adding support for React children.
- */
-export declare type BadgeProps = BadgeRootProps & {
+export declare type BadgeProps = BadgeRootSlotProps & {
+    /**
+     * Content to display inside the badge
+     */
     children?: React.ReactNode;
+    /**
+     * Ref forwarding to the root element
+     */
     ref?: React.Ref<HTMLSpanElement>;
+    /**
+     * Data attributes for testing or custom metadata
+     */
     [key: `data-${string}`]: string;
 };
 
-/**
- * Base recipe props interface that combines Chakra UI's recipe props
- * with the unstyled prop option for the span element.
- */
-export declare type BadgeRecipeProps = {
+declare type BadgeRecipeProps = {
+    /**
+     * Size variant of the badge
+     * @default "md"
+     */
     size?: RecipeProps<"badge">["size"];
 } & UnstyledProp;
 
-/**
- * Root props interface that extends Chakra's HTML props with our recipe props.
- * This creates a complete set of props for the root element, combining
- * HTML attributes, Chakra's styling system, and our custom recipe props.
- */
-export declare type BadgeRootProps = HTMLChakraProps<"span", BadgeRecipeProps>;
+export declare type BadgeRootSlotProps = HTMLChakraProps<"span", BadgeRecipeProps>;
 
 export { }
 

package/dist/button.d.ts

@@ -16,35 +16,42 @@ export declare const Button: {
     displayName: string;
 };
 
-export declare type ButtonProps = ButtonRootProps & FunctionalButtonProps & {
+export declare type ButtonProps = Omit<ButtonRootSlotProps, keyof AriaButtonProps> & AriaButtonProps & {
+    /**
+     * Data attributes for testing or custom metadata
+     */
+    [key: `data-${string}`]: unknown;
+    /**
+     * Slot name for React Aria Components composition
+     */
     slot?: string | null | undefined;
+    /**
+     * Ref forwarding to the button element
+     */
     ref?: React.Ref<HTMLButtonElement>;
 };
 
-/**
- * Base recipe props interface that combines Chakra UI's recipe props
- * with the unstyled prop option for the button element.
- */
 declare type ButtonRecipeProps = {
+    /**
+     * Size variant of the button
+     * @default "md"
+     */
     size?: RecipeProps<"button">["size"];
+    /**
+     * Visual style variant of the button
+     * @default "subtle"
+     */
     variant?: RecipeProps<"button">["variant"];
+    /**
+     * Color tone palette for the button
+     */
     tone?: RecipeProps<"button">["tone"];
 } & UnstyledProp;
 
-/**
- * Root props interface that extends Chakra's HTML props with our recipe props.
- * This creates a complete set of props for the root element, combining
- * HTML attributes, Chakra's styling system, and our custom recipe props.
- */
-export declare type ButtonRootProps = Omit<HTMLChakraProps<"button", ButtonRecipeProps>, "slot"> & {
+export declare type ButtonRootSlotProps = Omit<HTMLChakraProps<"button", ButtonRecipeProps>, "slot"> & {
     slot?: string | null | undefined;
 };
 
-/** combine chakra-button props with aria-button props */
-declare type FunctionalButtonProps = AriaButtonProps & Omit<ButtonRootProps, keyof AriaButtonProps | "slot"> & {
-    [key: `data-${string}`]: unknown;
-};
-
 export { }
 
 

package/dist/calendar.d.ts

@@ -36,10 +36,6 @@ declare type CalendarRecipeProps = SlotRecipeProps<"calendar">;
 
 export declare type CalendarRootSlotProps = HTMLChakraProps<"div", CalendarRecipeProps>;
 
-/**
- * Additional properties we want to exclude from the TimeInput component.
- * These are either deprecated or not intended for use in this component.
- */
 declare type ExcludedProps = "as" | "asChild" | "style" | "createCalendar";
 
 export { }

package/dist/card.d.ts

@@ -26,34 +26,39 @@ export declare const _CardContent: {
     displayName: string;
 };
 
-export declare type CardContentProps = HTMLChakraProps<"div">;
+export declare type CardContentProps = CardContentSlotProps & {
+    children?: React.ReactNode;
+    ref?: React.Ref<HTMLDivElement>;
+};
+
+export declare type CardContentSlotProps = HTMLChakraProps<"div">;
 
 export declare const _CardHeader: {
     ({ children, ...props }: CardHeaderProps): null;
     displayName: string;
 };
 
-export declare type CardHeaderProps = HTMLChakraProps<"div">;
+export declare type CardHeaderProps = CardHeaderSlotProps & {
+    children?: React.ReactNode;
+    ref?: React.Ref<HTMLDivElement>;
+};
+
+export declare type CardHeaderSlotProps = HTMLChakraProps<"div">;
 
-/**
- * Main props interface for the Card component.
- * Extends CardRecipeVariantProps to include both root props and variant props,
- * while adding support for React children.
- */
-export declare type CardProps = CardRootProps & {
+export declare type CardProps = CardRootSlotProps & {
     children?: React.ReactNode;
     ref?: React.Ref<HTMLDivElement>;
     [key: `data-${string}`]: unknown;
 };
 
-/**
- * Base recipe props interface that combines Chakra UI's recipe props
- * with the unstyled prop option for the div element.
- */
 declare type CardRecipeProps = {
+    /** Internal padding variant for the card content */
     cardPadding?: SlotRecipeProps<"card">["cardPadding"];
+    /** Border style variant (outline, none, etc.) */
     borderStyle?: SlotRecipeProps<"card">["borderStyle"];
+    /** Elevation shadow level for the card */
     elevation?: SlotRecipeProps<"card">["elevation"];
+    /** Background style variant (white, gray, etc.) */
     backgroundStyle?: SlotRecipeProps<"card">["backgroundStyle"];
 } & UnstyledProp;
 
@@ -69,12 +74,7 @@ export declare const _CardRoot: {
     displayName: string;
 };
 
-/**
- * Root props interface that extends Chakra's HTML props with our recipe props.
- * This creates a complete set of props for the root element, combining
- * HTML attributes, Chakra's styling system, and our custom recipe props.
- */
-export declare type CardRootProps = HTMLChakraProps<"div", CardRecipeProps>;
+export declare type CardRootSlotProps = HTMLChakraProps<"div", CardRecipeProps>;
 
 export { }
 

package/dist/checkbox.d.ts

@@ -17,25 +17,30 @@ export declare const Checkbox: {
     displayName: string;
 };
 
-export declare type CheckboxIndicatorProps = HTMLChakraProps<"span">;
+export declare type CheckboxIndicatorSlotProps = HTMLChakraProps<"span">;
 
-export declare type CheckboxLabelProps = HTMLChakraProps<"span">;
+export declare type CheckboxLabelSlotProps = HTMLChakraProps<"span">;
 
-/**
- * Main props interface for the Checkbox component.
- * Extends CheckboxRootProps (which includes SlotRecipeProps and RaCheckboxProps),
- * while adding support for React children and ref forwarding.
- */
-export declare type CheckboxProps = CheckboxRootProps & {
+export declare type CheckboxProps = CheckboxRootSlotProps & {
+    /**
+     * Ref forwarding to the label element
+     */
     ref?: Ref<HTMLLabelElement>;
+    /**
+     * The label content to display next to the checkbox
+     */
     children?: ReactNode;
 };
 
 declare type CheckboxRecipeProps = {
+    /**
+     * Size variant of the checkbox
+     * @default "md"
+     */
     size?: SlotRecipeProps<"checkbox">["size"];
 };
 
-export declare type CheckboxRootProps = Omit<HTMLChakraProps<"label", CheckboxRecipeProps>, keyof CheckboxProps_2> & CheckboxProps_2;
+export declare type CheckboxRootSlotProps = Omit<HTMLChakraProps<"label", CheckboxRecipeProps>, keyof CheckboxProps_2> & CheckboxProps_2;
 
 export { }