@capitaltg/vero 1.10.8 → 1.11.0

package/dist/types/index.d.ts

@@ -141,6 +141,10 @@ export declare interface AutocompleteProps<T, K extends keyof T, L extends keyof
      * @default 'Failed to load options'
      */
     errorMessage?: string;
+    /**
+     * Additional class names for the popover content (e.g. to set min-width or width).
+     */
+    popoverClassName?: string;
     /**
      * Z-index value for the popover dropdown.
      * If not provided, uses the default z-index from the theme.
@@ -225,15 +229,19 @@ export declare interface CheckboxGroupProps extends Omit<HTMLAttributes<HTMLDivE
     value: string[];
     onChange: (value: string[]) => void;
     className?: string;
+    /** Number of columns for default and tile variants (vertical orientation). Defaults to 1. */
     columns?: 1 | 2 | 3 | 4;
     orientation?: 'horizontal' | 'vertical';
     variant?: 'default' | 'tile' | 'button';
 }
 
 export declare interface CheckboxOption {
+    /** Option identifier (used in value array). Consider standardizing with RadioGroup, which uses "value" for the option key. */
     id: string;
     label: string;
     description?: string;
+    /** Optional explicit id for the checkbox input. Defaults to `${groupId}-${id}` when CheckboxGroup has an id. */
+    inputId?: string;
 }
 
 export declare interface CheckboxProps extends Omit<ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>, 'checked' | 'disabled'> {
@@ -262,9 +270,26 @@ export declare interface ComboboxProps extends Omit<ButtonHTMLAttributes<HTMLBut
     placeholder?: string;
     searchPlaceholder?: string;
     emptyMessage?: string;
+    /**
+     * Custom filter function for search. Receives the option's value and current search string.
+     * Return 0 to hide the item, or a positive number to show it (higher = better match rank).
+     * When not provided, default filtering matches by both value and label (case-insensitive substring).
+     */
+    filter?: (value: string, search: string) => number;
     className?: string;
     listClassName?: string;
+    /** Additional class names for the popover content (e.g. to set min-width or width). */
+    popoverClassName?: string;
+    /**
+     * Z-index value for the popover dropdown.
+     * If not provided, uses the default z-index from the theme.
+     */
     zIndex?: number;
+    /**
+     * Whether the component is disabled.
+     * When true, the combobox cannot be interacted with.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * The name attribute for form submission.
@@ -527,7 +552,18 @@ export declare interface MultiSelectProps extends Omit<HTMLAttributes<HTMLDivEle
     emptyMessage?: string;
     className?: string;
     listClassName?: string;
+    /** Additional class names for the popover content (e.g. to set min-width or width). */
+    popoverClassName?: string;
+    /**
+     * Z-index value for the popover dropdown.
+     * If not provided, uses the default z-index from the theme.
+     */
     zIndex?: number;
+    /**
+     * Whether the component is disabled.
+     * When true, the multi-select cannot be interacted with.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * The name attribute for form submission.
@@ -566,20 +602,36 @@ export declare const Radio: React_2.ForwardRefExoticComponent<RadioProps & React
 
 export declare const RadioGroup: React_2.ForwardRefExoticComponent<RadioGroupProps & React_2.RefAttributes<HTMLDivElement>>;
 
-export declare interface RadioGroupProps extends Omit<ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root>, 'onValueChange' | 'onChange'> {
-    options: RadioOption[];
-    value: string;
-    onChange: (value: string) => void;
+declare type RadioGroupBaseProps = Omit<ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root>, 'onValueChange' | 'onChange'> & {
+    value?: string;
+    onChange?: (value: string) => void;
     className?: string;
+    /** Number of columns for default and tile variants (vertical orientation). Defaults to 1. */
     columns?: 1 | 2 | 3 | 4;
     orientation?: 'horizontal' | 'vertical';
     variant?: 'default' | 'tile' | 'button';
+};
+
+export declare type RadioGroupProps = RadioGroupPropsWithOptions | RadioGroupPropsWithChildren;
+
+/** Use with Radio components as children when you need custom layout or structure. */
+declare interface RadioGroupPropsWithChildren extends RadioGroupBaseProps {
+    options?: never;
+    children: ReactNode;
+}
+
+/** Use with an `options` array; RadioGroup renders Radio items and applies layout. */
+declare interface RadioGroupPropsWithOptions extends RadioGroupBaseProps {
+    options: RadioOption[];
+    children?: never;
 }
 
 export declare interface RadioOption {
     value: string;
     label: string;
     description?: string;
+    /** Optional explicit id for the radio input. Defaults to `${groupId}-${value}` when RadioGroup has an id. */
+    id?: string;
 }
 
 export declare interface RadioProps extends Omit<ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item>, 'checked' | 'disabled'> {
@@ -656,6 +708,8 @@ export declare const SelectTrigger: React_2.ForwardRefExoticComponent<SelectTrig
 
 export declare interface SelectTriggerProps extends Omit<ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger>, 'disabled'> {
     isDisabled?: boolean;
+    /** When false, the trigger value span is shown with muted styling (placeholder state). */
+    hasValue?: boolean;
 }
 
 export declare const SelectValue: React_2.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React_2.RefAttributes<HTMLSpanElement>>;
@@ -812,7 +866,7 @@ export declare interface TooltipProps extends Omit<ComponentPropsWithoutRef<type
     zIndex?: number;
 }
 
-export declare const TooltipProvider: React_2.FC<TooltipPrimitive.TooltipProviderProps>;
+export declare function TooltipProvider({ delayDuration, ...props }: Readonly<React_2.ComponentPropsWithoutRef<typeof TooltipPrimitive.Provider>>): JSX_2.Element;
 
 export declare const tw: <T extends string>(strings: TemplateStringsArray, ...values: unknown[]) => T;
 
@@ -839,6 +893,8 @@ declare type UseAriaDisabledActive = {
     onClick: (evt: React.MouseEvent) => void;
     onTouchStart: (evt: React.TouchEvent) => void;
     onTouchEnd: (evt: React.TouchEvent) => void;
+    onPointerDown: (evt: React.PointerEvent) => void;
+    onPointerDownCapture: (evt: React.PointerEvent) => void;
     onKeyDown: (evt: React.KeyboardEvent) => void;
     onKeyUp: (evt: React.KeyboardEvent) => void;
     onKeyPress: (evt: React.KeyboardEvent) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capitaltg/vero",
-  "version": "1.10.8",
+  "version": "1.11.0",
   "description": "Accessible, modern, open source React component library inspired by USWDS built with Radix UI",
   "type": "module",
   "main": "dist/index.js",