@capitaltg/vero 1.8.1 → 1.9.0

package/dist/types/index.d.ts

@@ -60,12 +60,14 @@ declare type AlertVariant = 'success' | 'warning' | 'danger' | 'info';
 
 export declare const Autocomplete: default_2.ForwardRefExoticComponent<AutocompleteProps & default_2.RefAttributes<HTMLButtonElement>>;
 
+declare type AutocompleteFormAttributes = Pick<React.SelectHTMLAttributes<HTMLSelectElement>, 'name' | 'required' | 'autoFocus'>;
+
 export declare interface AutocompleteOption {
     value: string;
     label: string;
 }
 
-export declare interface AutocompleteProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled'> {
+export declare interface AutocompleteProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled'>, AutocompleteFormAttributes {
     loadOptions?: (inputValue: string) => Promise<AutocompleteOption[]>;
     options?: AutocompleteOption[];
     value: string;
@@ -81,6 +83,20 @@ export declare interface AutocompleteProps extends Omit<ButtonHTMLAttributes<HTM
     errorMessage?: string;
     zIndex?: number;
     isDisabled?: boolean;
+    /**
+     * The name attribute for form submission.
+     * This is required for the autocomplete value to be included in form data.
+     */
+    name?: string;
+    /**
+     * Whether the autocomplete is required for form validation.
+     * When true, the form cannot be submitted without a selection.
+     */
+    required?: boolean;
+    /**
+     * Automatically focuses the autocomplete when the page loads.
+     */
+    autoFocus?: boolean;
 }
 
 export declare const Badge: React_2.ForwardRefExoticComponent<BadgeProps & React_2.RefAttributes<HTMLDivElement>>;
@@ -154,12 +170,14 @@ export declare function cn(...inputs: ClassValue[]): string;
 
 export declare const Combobox: default_2.ForwardRefExoticComponent<ComboboxProps & default_2.RefAttributes<HTMLButtonElement>>;
 
+declare type ComboboxFormAttributes = Pick<React.SelectHTMLAttributes<HTMLSelectElement>, 'name' | 'required' | 'autoFocus'>;
+
 export declare interface ComboboxOption {
     value: string;
     label: string;
 }
 
-export declare interface ComboboxProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled'> {
+export declare interface ComboboxProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled'>, ComboboxFormAttributes {
     options: ComboboxOption[];
     value: string;
     onChange: (value: string) => void;
@@ -170,6 +188,20 @@ export declare interface ComboboxProps extends Omit<ButtonHTMLAttributes<HTMLBut
     listClassName?: string;
     zIndex?: number;
     isDisabled?: boolean;
+    /**
+     * The name attribute for form submission.
+     * This is required for the combobox value to be included in form data.
+     */
+    name?: string;
+    /**
+     * Whether the combobox is required for form validation.
+     * When true, the form cannot be submitted without a selection.
+     */
+    required?: boolean;
+    /**
+     * Automatically focuses the combobox when the page loads.
+     */
+    autoFocus?: boolean;
 }
 
 /**
@@ -193,7 +225,9 @@ export declare function configureZIndex(config: Partial<ZIndexConfig>): void;
 
 export declare const DatePicker: default_2.ForwardRefExoticComponent<DatePickerProps & default_2.RefAttributes<HTMLButtonElement>>;
 
-export declare interface DatePickerProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled' | 'value'> {
+declare type DatePickerFormAttributes = Pick<React.SelectHTMLAttributes<HTMLSelectElement>, 'name' | 'required' | 'autoFocus'>;
+
+export declare interface DatePickerProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled' | 'value'>, DatePickerFormAttributes {
     value?: Date;
     startMonth?: Date;
     endMonth?: Date;
@@ -202,6 +236,20 @@ export declare interface DatePickerProps extends Omit<ButtonHTMLAttributes<HTMLB
     className?: string;
     zIndex?: number;
     isDisabled?: boolean;
+    /**
+     * The name attribute for form submission.
+     * This is required for the date picker value to be included in form data.
+     */
+    name?: string;
+    /**
+     * Whether the date picker is required for form validation.
+     * When true, the form cannot be submitted without a date selection.
+     */
+    required?: boolean;
+    /**
+     * Automatically focuses the date picker when the page loads.
+     */
+    autoFocus?: boolean;
 }
 
 export declare interface DateRange {
@@ -211,7 +259,9 @@ export declare interface DateRange {
 
 export declare const DateRangePicker: React_2.ForwardRefExoticComponent<DateRangePickerProps & React_2.RefAttributes<HTMLButtonElement>>;
 
-export declare interface DateRangePickerProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled' | 'value'> {
+declare type DateRangePickerFormAttributes = Pick<React.SelectHTMLAttributes<HTMLSelectElement>, 'name' | 'required' | 'autoFocus'>;
+
+export declare interface DateRangePickerProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled' | 'value'>, DateRangePickerFormAttributes {
     value: DateRange;
     onChange: (range: DateRange) => void;
     placeholder?: {
@@ -221,6 +271,20 @@ export declare interface DateRangePickerProps extends Omit<ButtonHTMLAttributes<
     className?: string;
     zIndex?: number;
     isDisabled?: boolean;
+    /**
+     * The name attribute for form submission.
+     * This is required for the date range picker value to be included in form data.
+     */
+    name?: string;
+    /**
+     * Whether the date range picker is required for form validation.
+     * When true, the form cannot be submitted without a date range selection.
+     */
+    required?: boolean;
+    /**
+     * Automatically focuses the date range picker when the page loads.
+     */
+    autoFocus?: boolean;
 }
 
 export declare const Dialog: FC<DialogPrimitive.DialogProps>;
@@ -367,14 +431,16 @@ declare type MultipleProps = {
     onValueChange?: (value: string[]) => void;
 };
 
-export declare const MultiSelect: default_2.ForwardRefExoticComponent<MultiSelectProps & default_2.RefAttributes<HTMLButtonElement>>;
+export declare const MultiSelect: default_2.ForwardRefExoticComponent<MultiSelectProps & default_2.RefAttributes<HTMLDivElement>>;
+
+declare type MultiSelectFormAttributes = Pick<React.SelectHTMLAttributes<HTMLSelectElement>, 'name' | 'required' | 'autoFocus'>;
 
 export declare interface MultiSelectOption {
     value: string;
     label: string;
 }
 
-export declare interface MultiSelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled'> {
+export declare interface MultiSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>, MultiSelectFormAttributes {
     options: MultiSelectOption[];
     value: string[];
     onChange: (value: string[]) => void;
@@ -385,6 +451,20 @@ export declare interface MultiSelectProps extends Omit<ButtonHTMLAttributes<HTML
     listClassName?: string;
     zIndex?: number;
     isDisabled?: boolean;
+    /**
+     * The name attribute for form submission.
+     * This is required for the multi-select value to be included in form data.
+     */
+    name?: string;
+    /**
+     * Whether the multi-select is required for form validation.
+     * When true, the form cannot be submitted without at least one selection.
+     */
+    required?: boolean;
+    /**
+     * Automatically focuses the multi-select when the page loads.
+     */
+    autoFocus?: boolean;
 }
 
 declare type OmittedPrimitiveProps = Omit<ComponentPropsWithoutRef<typeof AccordionPrimitive.Root>, 'type' | 'value' | 'defaultValue' | 'collapsible' | 'onValueChange'>;
@@ -447,6 +527,8 @@ export declare interface SelectContentProps extends ComponentPropsWithoutRef<typ
     zIndex?: number;
 }
 
+declare type SelectFormAttributes = Pick<React.SelectHTMLAttributes<HTMLSelectElement>, 'name' | 'required' | 'autoFocus'>;
+
 export declare const SelectGroup: React_2.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare const SelectItem: React_2.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
@@ -462,7 +544,7 @@ export declare interface SelectOption {
     label: string;
 }
 
-export declare interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled'> {
+export declare interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'disabled'>, SelectFormAttributes {
     options: SelectOption[];
     value: string;
     onChange: (value: string) => void;
@@ -470,6 +552,20 @@ export declare interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButto
     className?: string;
     zIndex?: number;
     isDisabled?: boolean;
+    /**
+     * The name attribute for form submission.
+     * This is required for the select value to be included in form data.
+     */
+    name?: string;
+    /**
+     * Whether the select is required for form validation.
+     * When true, the form cannot be submitted without a selection.
+     */
+    required?: boolean;
+    /**
+     * Automatically focuses the select when the page loads.
+     */
+    autoFocus?: boolean;
 }
 
 export declare const SelectRoot: React_2.FC<SelectPrimitive.SelectProps>;
@@ -587,7 +683,7 @@ export declare interface SwitchProps extends Omit<ComponentPropsWithoutRef<typeo
     isDisabled?: boolean;
 }
 
-export declare const Tabs: React_2.ForwardRefExoticComponent<TabsPrimitive.TabsProps & React_2.RefAttributes<HTMLDivElement>>;
+export declare const Tabs: React_2.ForwardRefExoticComponent<TabsProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare const TabsContent: React_2.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsContentProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
 
@@ -597,7 +693,16 @@ export declare const TabsList: React_2.ForwardRefExoticComponent<Omit<TabsPrimit
 
 export declare type TabsListProps = ComponentPropsWithoutRef<typeof TabsPrimitive.List>;
 
-export declare type TabsProps = ComponentPropsWithoutRef<typeof TabsPrimitive.Root>;
+export declare interface TabsProps extends ComponentPropsWithoutRef<typeof TabsPrimitive.Root> {
+    /**
+     * The controlled value of the active tab. When provided, the component becomes a controlled component.
+     */
+    value?: string;
+    /**
+     * The default value of the active tab when the component is uncontrolled.
+     */
+    defaultValue?: string;
+}
 
 export declare const TabsTrigger: React_2.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsTriggerProps & React_2.RefAttributes<HTMLButtonElement>, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
 

package/package.json

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