@aseguragonzalez/ui 1.0.2 → 1.0.3

package/dist/patterns/AuthLayout/AuthLayout.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from 'react';
+export interface AuthLayoutProps {
+    /** Form or main content rendered in the right panel. */
+    children: ReactNode;
+    /** Custom branding content for the left panel. Replaces the default tagline. */
+    branding?: ReactNode;
+    /** Logo shown at the top of the form panel on mobile, and inside the branding panel on desktop. */
+    logo?: ReactNode;
+    /** Accessible label for the branding panel (hidden from visual display). */
+    brandingLabel?: string;
+}
+export declare function AuthLayout({ children, branding, logo, brandingLabel, }: AuthLayoutProps): import("react").JSX.Element;
+export declare namespace AuthLayout {
+    var displayName: string;
+}

package/dist/patterns/ExampleApp/AppShell.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from 'react';
+import type { Page } from './mockData';
+interface AppShellProps {
+    currentPage: Page;
+    onNavigate: (page: Page) => void;
+    children: ReactNode;
+}
+export declare function AppShell({ currentPage, onNavigate, children }: AppShellProps): import("react").JSX.Element;
+export {};

package/dist/patterns/ExampleApp/ExampleApp.d.ts

@@ -0,0 +1 @@
+export declare function ExampleApp(): import("react").JSX.Element;

package/dist/patterns/ExampleApp/components/KpiCard.d.ts

@@ -0,0 +1,9 @@
+import type { BadgeVariant } from '../../../primitives/Badge/Badge';
+interface KpiCardProps {
+    label: string;
+    value: string;
+    change?: string;
+    changeVariant?: BadgeVariant;
+}
+export declare function KpiCard({ label, value, change, changeVariant }: KpiCardProps): import("react").JSX.Element;
+export {};

package/dist/patterns/ExampleApp/mockData.d.ts

@@ -0,0 +1,22 @@
+import type { BarChartSeries } from '../../components/BarChart/BarChart';
+import type { DonutSegment } from '../../components/DonutChart/DonutChart';
+export type Page = 'dashboard' | 'users' | 'settings';
+export interface User {
+    id: number;
+    name: string;
+    email: string;
+    role: string;
+    status: string;
+    joined: string;
+}
+export declare const USERS: User[];
+export declare const MONTHLY_REVENUE_SERIES: BarChartSeries[];
+export declare const USER_BY_PLAN_SEGMENTS: DonutSegment[];
+export declare const ROLE_OPTIONS: {
+    value: string;
+    label: string;
+}[];
+export declare const NOTIFICATION_OPTIONS: {
+    value: string;
+    label: string;
+}[];

package/dist/patterns/ExampleApp/pages/DashboardPage.d.ts

@@ -0,0 +1 @@
+export declare function DashboardPage(): import("react").JSX.Element;

package/dist/patterns/ExampleApp/pages/SettingsPage.d.ts

@@ -0,0 +1 @@
+export declare function SettingsPage(): import("react").JSX.Element;

package/dist/patterns/ExampleApp/pages/UsersPage.d.ts

@@ -0,0 +1 @@
+export declare function UsersPage(): import("react").JSX.Element;

package/dist/primitives/Alert/Alert.d.ts

@@ -0,0 +1,10 @@
+export type AlertVariant = 'error' | 'warning' | 'success' | 'info';
+export interface AlertProps extends React.HTMLAttributes<HTMLDivElement> {
+    variant: AlertVariant;
+    title?: string;
+    children: React.ReactNode;
+    onDismiss?: () => void;
+    dismissLabel?: string;
+}
+declare const Alert: import("react").ForwardRefExoticComponent<AlertProps & import("react").RefAttributes<HTMLDivElement>>;
+export { Alert };

package/dist/primitives/Avatar/Avatar.d.ts

@@ -0,0 +1,11 @@
+export type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+export type AvatarShape = 'circle' | 'square';
+export interface AvatarProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /** Full name — used for accessible label and to derive initials. */
+    name: string;
+    src?: string;
+    size?: AvatarSize;
+    shape?: AvatarShape;
+}
+declare const Avatar: import("react").ForwardRefExoticComponent<AvatarProps & import("react").RefAttributes<HTMLSpanElement>>;
+export { Avatar };

package/dist/primitives/Badge/Badge.d.ts

@@ -0,0 +1,8 @@
+export type BadgeVariant = 'neutral' | 'brand' | 'accent' | 'error' | 'warning' | 'success' | 'info';
+export type BadgeSize = 'sm' | 'md' | 'lg';
+export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+}
+declare const Badge: import("react").ForwardRefExoticComponent<BadgeProps & import("react").RefAttributes<HTMLSpanElement>>;
+export { Badge };

package/dist/primitives/Button/Button.d.ts

@@ -0,0 +1,11 @@
+export type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'accent' | 'destructive';
+export type ButtonSize = 'sm' | 'md' | 'lg';
+export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    fullWidth?: boolean;
+    isLoading?: boolean;
+    loadingText?: string;
+}
+declare const Button: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+export { Button };

package/dist/primitives/Checkbox/Checkbox.d.ts

@@ -0,0 +1,7 @@
+export type CheckboxSize = 'sm' | 'md' | 'lg';
+export interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    hasError?: boolean;
+    size?: CheckboxSize;
+}
+declare const Checkbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLInputElement>>;
+export { Checkbox };

package/dist/primitives/DateInput/DateInput.d.ts

@@ -0,0 +1,13 @@
+export type DateInputSize = 'sm' | 'md' | 'lg';
+export interface DateInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    hasError?: boolean;
+    size?: DateInputSize;
+    /** ISO 8601 date string (YYYY-MM-DD). */
+    value?: string;
+    /** ISO 8601 date string (YYYY-MM-DD). */
+    min?: string;
+    /** ISO 8601 date string (YYYY-MM-DD). */
+    max?: string;
+}
+declare const DateInput: import("react").ForwardRefExoticComponent<DateInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export { DateInput };

package/dist/primitives/Divider/Divider.d.ts

@@ -0,0 +1,13 @@
+export type DividerOrientation = 'horizontal' | 'vertical';
+export interface DividerProps extends React.HTMLAttributes<HTMLHRElement> {
+    orientation?: DividerOrientation;
+    /**
+     * When true (default), the divider is purely visual — aria-hidden="true".
+     * When false, it acts as a semantic thematic break with role="separator".
+     */
+    decorative?: boolean;
+    /** Accessible label for semantic dividers (decorative=false). */
+    label?: string;
+}
+declare const Divider: import("react").ForwardRefExoticComponent<DividerProps & import("react").RefAttributes<HTMLHRElement>>;
+export { Divider };

package/dist/primitives/EmailInput/EmailInput.d.ts

@@ -0,0 +1,12 @@
+export type EmailInputSize = 'sm' | 'md' | 'lg';
+export interface EmailInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    hasError?: boolean;
+    size?: EmailInputSize;
+}
+/**
+ * Primitive email input — wraps input[type="email"].
+ * Does not manage label, hint, or error rendering.
+ * Use EmailField for the full accessible field composition.
+ */
+declare const EmailInput: import("react").ForwardRefExoticComponent<EmailInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export { EmailInput };

package/dist/primitives/ErrorMessage/ErrorMessage.d.ts

@@ -0,0 +1,12 @@
+export type ErrorMessageProps = React.HTMLAttributes<HTMLSpanElement>;
+/**
+ * Renders a validation error for a form field.
+ * Must be connected to the input via aria-describedby on the input side.
+ * We do NOT use role="alert" here — the parent TextField sets aria-invalid
+ * on the input, which is the correct WCAG pattern for inline form errors.
+ */
+declare function ErrorMessage({ children, className, ...nativeProps }: ErrorMessageProps): import("react").JSX.Element;
+declare namespace ErrorMessage {
+    var displayName: string;
+}
+export { ErrorMessage };

package/dist/primitives/Heading/Heading.d.ts

@@ -0,0 +1,15 @@
+export type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+export type HeadingSize = 'xl' | 'lg' | 'md' | 'sm' | 'xs';
+export type HeadingColor = 'default' | 'muted' | 'inherit';
+export interface HeadingProps extends React.HTMLAttributes<HTMLHeadingElement> {
+    /** Semantic heading level — determines the rendered HTML element (h1–h6). */
+    level: HeadingLevel;
+    /**
+     * Visual size. Defaults to a size appropriate for the level.
+     * Allows decoupling semantic hierarchy from visual hierarchy.
+     */
+    size?: HeadingSize;
+    color?: HeadingColor;
+}
+declare const Heading: import("react").ForwardRefExoticComponent<HeadingProps & import("react").RefAttributes<HTMLHeadingElement>>;
+export { Heading };

package/dist/primitives/Hint/Hint.d.ts

@@ -0,0 +1,6 @@
+export type HintProps = React.HTMLAttributes<HTMLSpanElement>;
+declare function Hint({ children, className, ...nativeProps }: HintProps): import("react").JSX.Element;
+declare namespace Hint {
+    var displayName: string;
+}
+export { Hint };

package/dist/primitives/Label/Label.d.ts

@@ -0,0 +1,9 @@
+export interface LabelProps extends React.LabelHTMLAttributes<HTMLLabelElement> {
+    required?: boolean;
+    disabled?: boolean;
+}
+declare function Label({ required, disabled, children, className, ...nativeProps }: LabelProps): import("react").JSX.Element;
+declare namespace Label {
+    var displayName: string;
+}
+export { Label };

package/dist/primitives/Modal/Modal.d.ts

@@ -0,0 +1,37 @@
+export type ModalSize = 'sm' | 'md' | 'lg';
+export interface ModalProps {
+    /** Whether the modal is open. */
+    open: boolean;
+    /** Called when the user requests to close (Escape key or backdrop click). */
+    onClose: () => void;
+    /** Accessible title rendered in the header. Required for ARIA. */
+    title: string;
+    children: React.ReactNode;
+    /** Accessible description id — set automatically when ModalBody is used. */
+    'aria-describedby'?: string;
+    size?: ModalSize;
+    /** Custom label for the close button. Default: "Close". */
+    closeLabel?: string;
+}
+export interface ModalHeaderProps {
+    children: React.ReactNode;
+    titleId: string;
+    onClose: () => void;
+    closeLabel: string;
+}
+export interface ModalBodyProps {
+    children: React.ReactNode;
+    id?: string;
+}
+export interface ModalFooterProps {
+    children: React.ReactNode;
+}
+export declare function ModalBody({ children, id }: ModalBodyProps): import("react").JSX.Element;
+export declare namespace ModalBody {
+    var displayName: string;
+}
+export declare function ModalFooter({ children }: ModalFooterProps): import("react").JSX.Element;
+export declare namespace ModalFooter {
+    var displayName: string;
+}
+export declare const Modal: import("react").ForwardRefExoticComponent<ModalProps & import("react").RefAttributes<HTMLDialogElement>>;

package/dist/primitives/NumberInput/NumberInput.d.ts

@@ -0,0 +1,10 @@
+export type NumberInputSize = 'sm' | 'md' | 'lg';
+export interface NumberInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    hasError?: boolean;
+    size?: NumberInputSize;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+declare const NumberInput: import("react").ForwardRefExoticComponent<NumberInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export { NumberInput };

package/dist/primitives/PasswordInput/PasswordInput.d.ts

@@ -0,0 +1,16 @@
+export type PasswordInputSize = 'sm' | 'md' | 'lg';
+export interface PasswordInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    hasError?: boolean;
+    size?: PasswordInputSize;
+    /** Accessible label for the "show password" button state. */
+    showPasswordLabel?: string;
+    /** Accessible label for the "hide password" button state. */
+    hidePasswordLabel?: string;
+}
+/**
+ * Primitive password input — wraps input[type="password"] with an integrated show/hide toggle.
+ * Does not manage label, hint, or error rendering.
+ * Use PasswordField for the full accessible field composition.
+ */
+declare const PasswordInput: import("react").ForwardRefExoticComponent<PasswordInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export { PasswordInput };

package/dist/primitives/PhoneInput/PhoneInput.d.ts

@@ -0,0 +1,12 @@
+export type PhoneInputSize = 'sm' | 'md' | 'lg';
+export interface PhoneInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    hasError?: boolean;
+    size?: PhoneInputSize;
+}
+/**
+ * Primitive phone input — wraps input[type="tel"].
+ * Does not manage label, hint, or error rendering.
+ * Use PhoneField for the full accessible field composition.
+ */
+declare const PhoneInput: import("react").ForwardRefExoticComponent<PhoneInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export { PhoneInput };

package/dist/primitives/ProgressBar/ProgressBar.d.ts

@@ -0,0 +1,12 @@
+export type ProgressBarVariant = 'default' | 'accent' | 'success' | 'error' | 'warning';
+export type ProgressBarSize = 'sm' | 'md' | 'lg';
+export interface ProgressBarProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Accessible name — required by ARIA for role="progressbar". */
+    label: string;
+    /** 0–100. Omit for indeterminate state. */
+    value?: number;
+    variant?: ProgressBarVariant;
+    size?: ProgressBarSize;
+}
+declare const ProgressBar: import("react").ForwardRefExoticComponent<ProgressBarProps & import("react").RefAttributes<HTMLDivElement>>;
+export { ProgressBar };

package/dist/primitives/RadioButton/RadioButton.d.ts

@@ -0,0 +1,7 @@
+export type RadioButtonSize = 'sm' | 'md' | 'lg';
+export interface RadioButtonProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    hasError?: boolean;
+    size?: RadioButtonSize;
+}
+declare const RadioButton: import("react").ForwardRefExoticComponent<RadioButtonProps & import("react").RefAttributes<HTMLInputElement>>;
+export { RadioButton };

package/dist/primitives/SearchInput/SearchInput.d.ts

@@ -0,0 +1,13 @@
+export type SearchInputSize = 'sm' | 'md' | 'lg';
+export interface SearchInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    hasError?: boolean;
+    size?: SearchInputSize;
+}
+/**
+ * Primitive search input — wraps input[type="search"] (implicit role: searchbox).
+ * The native browser cancel button is suppressed via CSS for visual consistency.
+ * Does not manage label, hint, or error rendering.
+ * Use SearchField for the full accessible field composition.
+ */
+declare const SearchInput: import("react").ForwardRefExoticComponent<SearchInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export { SearchInput };

package/dist/primitives/Select/Select.d.ts

@@ -0,0 +1,12 @@
+export type SelectSize = 'sm' | 'md' | 'lg';
+export interface SelectProps extends Omit<React.SelectHTMLAttributes<HTMLSelectElement>, 'size'> {
+    hasError?: boolean;
+    size?: SelectSize;
+}
+/**
+ * Primitive select — wraps native <select>.
+ * Renders inside a wrapper div that provides the custom dropdown arrow.
+ * Use SelectField for the full accessible field composition.
+ */
+declare const Select: import("react").ForwardRefExoticComponent<SelectProps & import("react").RefAttributes<HTMLSelectElement>>;
+export { Select };

package/dist/primitives/Skeleton/Skeleton.d.ts

@@ -0,0 +1,15 @@
+export type SkeletonShape = 'rect' | 'circle' | 'text';
+export interface SkeletonProps extends React.HTMLAttributes<HTMLSpanElement> {
+    shape?: SkeletonShape;
+    /** CSS value for the width. Defaults to 100%. */
+    width?: string | number;
+    /** CSS value for the height. */
+    height?: string | number;
+    /**
+     * Number of text lines to render. Only applies when shape="text".
+     * The last line is rendered at 70% width to mimic natural text endings.
+     */
+    lines?: number;
+}
+declare const Skeleton: import("react").ForwardRefExoticComponent<SkeletonProps & import("react").RefAttributes<HTMLSpanElement>>;
+export { Skeleton };

package/dist/primitives/Spinner/Spinner.d.ts

@@ -0,0 +1,7 @@
+export type SpinnerSize = 'sm' | 'md' | 'lg';
+export interface SpinnerProps extends React.HTMLAttributes<HTMLSpanElement> {
+    size?: SpinnerSize;
+    label?: string;
+}
+declare const Spinner: import("react").ForwardRefExoticComponent<SpinnerProps & import("react").RefAttributes<HTMLSpanElement>>;
+export { Spinner };

package/dist/primitives/Tabs/Tabs.d.ts

@@ -0,0 +1,31 @@
+export interface TabsProps {
+    children: React.ReactNode;
+    /** Controlled active tab value. */
+    value?: string;
+    /** Initial active tab for uncontrolled usage. */
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    className?: string;
+}
+declare const Tabs: import("react").ForwardRefExoticComponent<TabsProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface TabListProps {
+    children: React.ReactNode;
+    /** Accessible label for the tab list — required by ARIA. */
+    label: string;
+    className?: string;
+}
+declare const TabList: import("react").ForwardRefExoticComponent<TabListProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface TabProps {
+    value: string;
+    children: React.ReactNode;
+    disabled?: boolean;
+    className?: string;
+}
+declare const Tab: import("react").ForwardRefExoticComponent<TabProps & import("react").RefAttributes<HTMLButtonElement>>;
+export interface TabPanelProps {
+    value: string;
+    children: React.ReactNode;
+    className?: string;
+}
+declare const TabPanel: import("react").ForwardRefExoticComponent<TabPanelProps & import("react").RefAttributes<HTMLDivElement>>;
+export { Tabs, TabList, Tab, TabPanel };

package/dist/primitives/Text/Text.d.ts

@@ -0,0 +1,13 @@
+export type TextSize = 'lg' | 'md' | 'sm' | 'xs';
+export type TextWeight = 'regular' | 'medium' | 'semibold' | 'bold';
+export type TextColor = 'default' | 'muted' | 'disabled' | 'error' | 'success' | 'warning' | 'inherit';
+export type TextAs = 'p' | 'span' | 'div' | 'em' | 'strong' | 'small';
+export interface TextProps extends React.HTMLAttributes<HTMLElement> {
+    /** Rendered HTML element. Defaults to 'p'. */
+    as?: TextAs;
+    size?: TextSize;
+    weight?: TextWeight;
+    color?: TextColor;
+}
+declare const Text: import("react").ForwardRefExoticComponent<TextProps & import("react").RefAttributes<HTMLElement>>;
+export { Text };

package/dist/primitives/TextArea/TextArea.d.ts

@@ -0,0 +1,9 @@
+export type TextAreaSize = 'sm' | 'md' | 'lg';
+export interface TextAreaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, 'size'> {
+    hasError?: boolean;
+    size?: TextAreaSize;
+    /** Grows to fit content; disables the manual resize handle. */
+    autoResize?: boolean;
+}
+declare const TextArea: import("react").ForwardRefExoticComponent<TextAreaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export { TextArea };

package/dist/primitives/TextInput/TextInput.d.ts

@@ -0,0 +1,12 @@
+export type TextInputSize = 'sm' | 'md' | 'lg';
+export interface TextInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    hasError?: boolean;
+    size?: TextInputSize;
+}
+/**
+ * Primitive text input — wraps input[type="text"].
+ * Does not manage label, hint, or error rendering.
+ * Use TextField for the full accessible field composition.
+ */
+declare const TextInput: import("react").ForwardRefExoticComponent<TextInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export { TextInput };

package/dist/primitives/Toast/Toast.d.ts

@@ -0,0 +1,28 @@
+export type ToastVariant = 'info' | 'success' | 'error' | 'warning';
+export interface ToastItem {
+    id: string;
+    message: React.ReactNode;
+    variant: ToastVariant;
+    /** Auto-dismiss delay in ms. 0 = persist until dismissed. Default: 5000. */
+    duration: number;
+}
+export interface ToastOptions {
+    message: React.ReactNode;
+    variant?: ToastVariant;
+    duration?: number;
+}
+interface ToastContextValue {
+    show: (opts: ToastOptions) => string;
+    dismiss: (id: string) => void;
+}
+export interface ToastProviderProps {
+    children: React.ReactNode;
+    /** Max toasts visible at once. Default: 5. */
+    maxToasts?: number;
+}
+export declare function ToastProvider({ children, maxToasts }: ToastProviderProps): import("react").JSX.Element;
+export declare namespace ToastProvider {
+    var displayName: string;
+}
+export declare function useToast(): ToastContextValue;
+export {};

package/dist/primitives/Toggle/Toggle.d.ts

@@ -0,0 +1,13 @@
+export type ToggleSize = 'sm' | 'md' | 'lg';
+export interface ToggleProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    hasError?: boolean;
+    size?: ToggleSize;
+}
+/**
+ * Primitive toggle switch — wraps input[type="checkbox"] with role="switch".
+ * Semantically distinct from Checkbox: activates/deactivates something immediately.
+ * Does not manage label, hint, or error rendering.
+ * Use ToggleField for the full accessible field composition.
+ */
+declare const Toggle: import("react").ForwardRefExoticComponent<ToggleProps & import("react").RefAttributes<HTMLInputElement>>;
+export { Toggle };

package/dist/primitives/Tooltip/Tooltip.d.ts

@@ -0,0 +1,14 @@
+export type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
+export interface TooltipProps {
+    /** Tooltip content — supplementary info only, never the only means to access critical content. */
+    content: React.ReactNode;
+    /** Must be a single focusable element that forwards its ref. */
+    children: React.ReactElement;
+    placement?: TooltipPlacement;
+    /** Delay before showing, in ms. Default: 200. */
+    delayMs?: number;
+}
+export declare function Tooltip({ content, children, placement, delayMs, }: TooltipProps): import("react").JSX.Element;
+export declare namespace Tooltip {
+    var displayName: string;
+}