@versaur/react 0.0.1 → 1.0.1

package/dist/{utils/cx.js → cx-B9vmfsc1.js}

@@ -1,4 +1,4 @@
 const e = (...o) => o.filter(Boolean).join(" ");
 export {
-  e as cx
+  e as c
 };

package/dist/forms.d.ts

@@ -0,0 +1,527 @@
+import { ButtonHTMLAttributes } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { HTMLAttributes } from 'react';
+import { InputHTMLAttributes } from 'react';
+import { LabelHTMLAttributes } from 'react';
+import { OptgroupHTMLAttributes } from 'react';
+import { OptionHTMLAttributes } from 'react';
+import { Radio as Radio_2 } from '@versaur/core/forms';
+import { RadioGroup as RadioGroup_2 } from '@versaur/core/forms';
+import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+import { SelectHTMLAttributes } from 'react';
+import { TextareaHTMLAttributes } from 'react';
+
+/**
+ * Checkbox - Native checkbox input with custom styling
+ *
+ * @example
+ * ```tsx
+ * <Checkbox
+ *   checked={agreed}
+ *   onChange={(e) => setAgreed(e.target.checked)}
+ * >
+ *   I agree to the terms and conditions
+ * </Checkbox>
+ * ```
+ */
+export declare const Checkbox: ForwardRefExoticComponent<CheckboxProps & RefAttributes<HTMLInputElement>>;
+
+/**
+ * CheckboxGroup compound component with Option subcomponent
+ */
+export declare const CheckboxGroup: ForwardRefExoticComponent<CheckboxGroupRootProps & RefAttributes<HTMLDivElement>> & {
+    Option: ForwardRefExoticComponent<CheckboxGroupOptionProps & RefAttributes<HTMLInputElement>>;
+};
+
+export declare interface CheckboxGroupOptionProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
+    /**
+     * Checkbox value
+     */
+    value: string;
+    /**
+     * Label text (children)
+     */
+    children?: ReactNode;
+    /**
+     * Required indicator for this specific option
+     */
+    required?: boolean;
+    /**
+     * Disabled state for this specific option
+     */
+    disabled?: boolean;
+}
+
+export declare interface CheckboxGroupRootProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /**
+     * Array of selected checkbox values
+     */
+    value: string[];
+    /**
+     * Change handler
+     */
+    onChange: (value: string[]) => void;
+    /**
+     * Name attribute for all checkbox inputs
+     */
+    name?: string;
+    /**
+     * Label for the checkbox group
+     */
+    label?: ReactNode;
+    /**
+     * Helper text shown below the group
+     */
+    helper?: ReactNode;
+    /**
+     * Error message shown below the group
+     */
+    error?: ReactNode;
+    /**
+     * Required indicator
+     */
+    required?: boolean;
+    /**
+     * Disabled state for all checkboxes
+     */
+    disabled?: boolean;
+    /**
+     * Layout direction
+     * @default "column"
+     */
+    direction?: "row" | "column";
+}
+
+export declare interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
+    /**
+     * Label text (children)
+     */
+    children?: ReactNode;
+    /**
+     * Invalid/error state
+     */
+    invalid?: boolean;
+    /**
+     * Required field indicator
+     */
+    required?: boolean;
+}
+
+/**
+ * ChipMultipleInput compound component with Option subcomponent
+ */
+export declare const ChipMultipleInput: ForwardRefExoticComponent<ChipMultipleInputRootProps & RefAttributes<HTMLDivElement>> & {
+    Option: ForwardRefExoticComponent<ChipMultipleInputOptionProps & RefAttributes<HTMLButtonElement>>;
+};
+
+export declare interface ChipMultipleInputOptionProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "value"> {
+    /**
+     * Chip value
+     */
+    value: string;
+    /**
+     * Label text (children)
+     */
+    children?: ReactNode;
+    /**
+     * Disabled state for this specific chip
+     */
+    disabled?: boolean;
+}
+
+export declare interface ChipMultipleInputRootProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /**
+     * Array of selected chip values
+     */
+    value: string[];
+    /**
+     * Change handler
+     */
+    onChange: (value: string[]) => void;
+    /**
+     * Name attribute for the input group
+     */
+    name?: string;
+    /**
+     * Label for the chip group
+     */
+    label?: ReactNode;
+    /**
+     * Helper text shown below the group
+     */
+    helper?: ReactNode;
+    /**
+     * Error message shown below the group
+     */
+    error?: ReactNode;
+    /**
+     * Required indicator
+     */
+    required?: boolean;
+    /**
+     * Disabled state for all chips
+     */
+    disabled?: boolean;
+    /**
+     * Gap between chips
+     * @default "2"
+     */
+    gap?: "1" | "2" | "3" | "4";
+    /**
+     * Enable wrapping
+     * @default true
+     */
+    wrap?: boolean;
+}
+
+/**
+ * ChipSingleInput compound component with Option subcomponent
+ */
+export declare const ChipSingleInput: ForwardRefExoticComponent<ChipSingleInputRootProps & RefAttributes<HTMLDivElement>> & {
+    Option: ForwardRefExoticComponent<ChipSingleInputOptionProps & RefAttributes<HTMLButtonElement>>;
+};
+
+export declare interface ChipSingleInputOptionProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "value"> {
+    /**
+     * Chip value
+     */
+    value: string;
+    /**
+     * Label text (children)
+     */
+    children?: ReactNode;
+    /**
+     * Disabled state for this specific chip
+     */
+    disabled?: boolean;
+}
+
+export declare interface ChipSingleInputRootProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /**
+     * Selected chip value
+     */
+    value: string | undefined;
+    /**
+     * Change handler
+     */
+    onChange: (value: string) => void;
+    /**
+     * Name attribute for the input group
+     */
+    name?: string;
+    /**
+     * Label for the chip group
+     */
+    label?: ReactNode;
+    /**
+     * Helper text shown below the group
+     */
+    helper?: ReactNode;
+    /**
+     * Error message shown below the group
+     */
+    error?: ReactNode;
+    /**
+     * Required indicator
+     */
+    required?: boolean;
+    /**
+     * Disabled state for all chips
+     */
+    disabled?: boolean;
+    /**
+     * Gap between chips
+     * @default "2"
+     */
+    gap?: "1" | "2" | "3" | "4";
+    /**
+     * Enable wrapping
+     * @default true
+     */
+    wrap?: boolean;
+}
+
+/**
+ * ErrorText component for form field error messages
+ * Internal primitive - not exported from main package
+ * Uses role="alert" for screen reader announcements
+ */
+export declare const ErrorText: ForwardRefExoticComponent<ErrorTextProps & RefAttributes<HTMLParagraphElement>>;
+
+declare interface ErrorTextProps extends HTMLAttributes<HTMLParagraphElement> {
+    /**
+     * Optional ID for linking with aria-describedby
+     */
+    id?: string;
+}
+
+/**
+ * HelperText component for form field helper/hint text
+ * Internal primitive - not exported from main package
+ */
+export declare const HelperText: ForwardRefExoticComponent<HelperTextProps & RefAttributes<HTMLParagraphElement>>;
+
+declare interface HelperTextProps extends HTMLAttributes<HTMLParagraphElement> {
+    /**
+     * Optional ID for linking with aria-describedby
+     */
+    id?: string;
+}
+
+/**
+ * Label component for form fields
+ * Internal primitive - not exported from main package
+ */
+export declare const Label: ForwardRefExoticComponent<LabelProps & RefAttributes<HTMLLabelElement>>;
+
+declare interface LabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
+    /**
+     * Shows red asterisk after label text
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Muted appearance for disabled fields
+     * @default false
+     */
+    disabled?: boolean;
+}
+
+/**
+ * Radio - Native radio input with custom styling
+ *
+ * @example
+ * ```tsx
+ * <Radio
+ *   name="plan"
+ *   value="basic"
+ *   checked={selectedPlan === 'basic'}
+ *   onChange={(e) => setSelectedPlan(e.target.value)}
+ * >
+ *   Basic Plan - $10/month
+ * </Radio>
+ * ```
+ */
+export declare const Radio: ForwardRefExoticComponent<RadioProps & RefAttributes<HTMLInputElement>>;
+
+/**
+ * RadioGroup compound component with Option subcomponent
+ */
+export declare const RadioGroup: ForwardRefExoticComponent<RadioGroupRootProps & RefAttributes<HTMLDivElement>> & {
+    Option: ForwardRefExoticComponent<RadioGroupOptionProps & RefAttributes<HTMLInputElement>>;
+};
+
+export declare interface RadioGroupOptionProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
+    /**
+     * Radio value
+     */
+    value: string;
+    /**
+     * Label text (children)
+     */
+    children?: ReactNode;
+    /**
+     * Disabled state for this specific option
+     */
+    disabled?: boolean;
+}
+
+export declare interface RadioGroupRootProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /**
+     * Selected radio value
+     */
+    value: string | undefined;
+    /**
+     * Change handler
+     */
+    onChange: (value: string) => void;
+    /**
+     * Name attribute for all radio inputs
+     */
+    name?: string;
+    /**
+     * Visual variant
+     * @default "outline"
+     */
+    variant?: RadioGroup_2.Variant;
+    /**
+     * Size variant
+     * @default "medium"
+     */
+    size?: RadioGroup_2.Size;
+    /**
+     * Label for the radio group
+     */
+    label?: ReactNode;
+    /**
+     * Helper text shown below the group
+     */
+    helper?: ReactNode;
+    /**
+     * Error message shown below the group
+     */
+    error?: ReactNode;
+    /**
+     * Required indicator
+     */
+    required?: boolean;
+    /**
+     * Disabled state for all radios
+     */
+    disabled?: boolean;
+    /**
+     * Layout direction
+     * @default "column"
+     */
+    direction?: "row" | "column";
+}
+
+export declare interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
+    /**
+     * Visual variant of the radio
+     * @default "outline"
+     */
+    variant?: Radio_2.Variant;
+    /**
+     * Size of the radio
+     * @default "medium"
+     */
+    size?: Radio_2.Size;
+    /**
+     * Label text (children)
+     */
+    children?: ReactNode;
+    /**
+     * Invalid/error state
+     */
+    invalid?: boolean;
+}
+
+export declare const Select: SelectComponent;
+
+declare interface SelectComponent extends ForwardRefExoticComponent<SelectProps & RefAttributes<HTMLSelectElement>> {
+    Option: typeof SelectOption;
+    OptionGroup: typeof SelectOptionGroup;
+}
+
+/**
+ * SelectOption component
+ * An option within a Select dropdown
+ */
+declare const SelectOption: ForwardRefExoticComponent<SelectOptionProps & RefAttributes<HTMLOptionElement>>;
+
+/**
+ * SelectOptionGroup component
+ * A grouped set of options within a Select dropdown
+ */
+declare const SelectOptionGroup: ForwardRefExoticComponent<SelectOptionGroupProps & RefAttributes<HTMLOptGroupElement>>;
+
+declare interface SelectOptionGroupProps extends OptgroupHTMLAttributes<HTMLOptGroupElement> {
+    /**
+     * The group label
+     */
+    label: string;
+}
+
+declare interface SelectOptionProps extends OptionHTMLAttributes<HTMLOptionElement> {
+    /**
+     * The option label/value text
+     */
+    children?: string;
+}
+
+export declare interface SelectProps extends SelectHTMLAttributes<HTMLSelectElement> {
+    /**
+     * Label text displayed above select
+     */
+    label?: string;
+    /**
+     * Helper text displayed below select
+     */
+    helper?: string;
+    /**
+     * Error message displayed below select (replaces helper)
+     */
+    error?: string;
+    /**
+     * Placeholder text (creates a disabled first option)
+     */
+    placeholder?: string;
+}
+
+/**
+ * TextArea component
+ * Native textarea with label, validation states, and helper text
+ */
+export declare const TextArea: ForwardRefExoticComponent<TextAreaProps & RefAttributes<HTMLTextAreaElement>>;
+
+export declare interface TextAreaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+    /**
+     * Label text displayed above textarea
+     */
+    label?: string;
+    /**
+     * Helper text displayed below textarea
+     */
+    helper?: string;
+    /**
+     * Error message displayed below textarea (replaces helper)
+     */
+    error?: string;
+    /**
+     * Whether the textarea is read-only
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * Whether the textarea is resizable
+     * @default true
+     */
+    resizable?: boolean;
+    /**
+     * Minimum number of visible rows
+     * @default 3
+     */
+    minRows?: number;
+    /**
+     * Maximum number of rows before scrolling
+     * @default 5
+     */
+    maxRows?: number;
+}
+
+/**
+ * TextInput component
+ * Native text input with label, icons, validation states, and helper text
+ */
+export declare const TextInput: ForwardRefExoticComponent<TextInputProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface TextInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size"> {
+    /**
+     * Label text displayed above input
+     */
+    label?: string;
+    /**
+     * Helper text displayed below input
+     */
+    helper?: string;
+    /**
+     * Error message displayed below input (replaces helper)
+     */
+    error?: string;
+    /**
+     * Icon or element displayed on the left side of input
+     */
+    leftIcon?: ReactNode;
+    /**
+     * Icon or element displayed on the right side of input
+     */
+    rightIcon?: ReactNode;
+    /**
+     * Whether the input is read-only
+     */
+    readOnly?: boolean;
+}
+
+export { }