@bubbasfw/ui 0.0.0-stage → 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,376 @@
+import * as react from 'react';
+import { ReactNode, SyntheticEvent } from 'react';
+import * as react_native from 'react-native';
+import { PressableProps, TextProps as TextProps$1, Text as Text$1, ViewProps, View, ImageSourcePropType, TextInputProps, TextInput, GestureResponderEvent } from 'react-native';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { tokens } from './tokens.js';
+export { BubbaTokens } from './tokens.js';
+
+type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost';
+type ButtonSize = 'sm' | 'md' | 'lg';
+interface ButtonProps extends Omit<PressableProps, 'children' | 'className'> {
+    /** Text content, or inline React Native Text content. */
+    children: ReactNode;
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    loading?: boolean;
+    loadingLabel?: string;
+    className?: string;
+    textClassName?: string;
+}
+/** One native Pressable and Text implementation on iOS, Android, and web. */
+declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<react_native.View>>;
+
+type TextTone = 'default' | 'muted' | 'info' | 'success' | 'warning' | 'error';
+type TextVariant = 'body' | 'lead' | 'small' | 'label' | 'caption' | 'code';
+interface TextProps extends TextProps$1 {
+    tone?: TextTone;
+    variant?: TextVariant;
+    className?: string;
+}
+declare const Text: react.ForwardRefExoticComponent<TextProps & react.RefAttributes<Text$1>>;
+interface HeadingProps extends TextProps$1 {
+    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    className?: string;
+}
+declare const Heading: react.ForwardRefExoticComponent<HeadingProps & react.RefAttributes<Text$1>>;
+
+declare const gaps: {
+    0: string;
+    1: string;
+    2: string;
+    3: string;
+    4: string;
+    6: string;
+    8: string;
+    12: string;
+    16: string;
+};
+declare const alignments: {
+    start: string;
+    center: string;
+    end: string;
+    stretch: string;
+};
+declare const justifications: {
+    start: string;
+    center: string;
+    end: string;
+    between: string;
+};
+interface StackProps extends ViewProps {
+    gap?: keyof typeof gaps;
+    align?: keyof typeof alignments;
+    justify?: keyof typeof justifications;
+    className?: string;
+}
+declare const Stack: react.ForwardRefExoticComponent<StackProps & react.RefAttributes<View>>;
+interface InlineProps extends StackProps {
+    wrap?: boolean;
+}
+declare const Inline: react.ForwardRefExoticComponent<InlineProps & react.RefAttributes<View>>;
+interface ContainerProps extends ViewProps {
+    reading?: boolean;
+    className?: string;
+}
+declare const Container: react.ForwardRefExoticComponent<ContainerProps & react.RefAttributes<View>>;
+interface CardProps extends ViewProps {
+    className?: string;
+    padding?: keyof typeof gaps;
+}
+declare const Card: react.ForwardRefExoticComponent<CardProps & react.RefAttributes<View>>;
+interface DividerProps extends ViewProps {
+    orientation?: 'horizontal' | 'vertical';
+    className?: string;
+}
+declare function Divider({ orientation, className, ...props }: DividerProps): react_jsx_runtime.JSX.Element;
+
+interface IconButtonProps extends Omit<PressableProps, 'children' | 'accessibilityLabel'> {
+    accessibilityLabel: string;
+    children: ReactNode;
+    variant?: 'primary' | 'outline' | 'ghost';
+    className?: string;
+}
+declare const IconButton: react.ForwardRefExoticComponent<IconButtonProps & react.RefAttributes<react_native.View>>;
+interface LinkProps extends Omit<PressableProps, 'children'> {
+    href: string;
+    children: ReactNode;
+    external?: boolean;
+    className?: string;
+    textClassName?: string;
+    /** Called when the operating system cannot open a native URL. */
+    onOpenError?: (error: unknown) => void;
+}
+declare const Link: react.ForwardRefExoticComponent<LinkProps & react.RefAttributes<react_native.View>>;
+
+type StatusTone = 'neutral' | 'info' | 'success' | 'warning' | 'error';
+interface BadgeProps extends ViewProps {
+    children: ReactNode;
+    tone?: StatusTone;
+    className?: string;
+    textClassName?: string;
+}
+declare function Badge({ children, tone, className, textClassName, ...props }: BadgeProps): react_jsx_runtime.JSX.Element;
+interface AvatarProps extends ViewProps {
+    source?: ImageSourcePropType;
+    name: string;
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+}
+declare function Avatar({ source, name, size, className, ...props }: AvatarProps): react_jsx_runtime.JSX.Element;
+interface EmptyStateProps extends ViewProps {
+    title: string;
+    description?: string;
+    children?: ReactNode;
+    className?: string;
+}
+declare function EmptyState({ title, description, children, className, ...props }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+interface ListItemProps extends Omit<ViewProps, 'children'> {
+    title: string;
+    description?: string;
+    leading?: ReactNode;
+    trailing?: ReactNode;
+    className?: string;
+    onPress?: PressableProps['onPress'];
+    disabled?: boolean;
+}
+declare const ListItem: react.ForwardRefExoticComponent<ListItemProps & react.RefAttributes<View>>;
+
+interface AccordionItem {
+    value: string;
+    title: string;
+    content: ReactNode;
+    disabled?: boolean;
+}
+interface AccordionProps extends ViewProps {
+    items: AccordionItem[];
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    className?: string;
+}
+/** Single-open disclosure. An empty value collapses every section. */
+declare function Accordion({ items, value, defaultValue, onValueChange, className, ...props }: AccordionProps): react_jsx_runtime.JSX.Element;
+
+interface DialogProps extends Omit<ViewProps, 'children'> {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    title: string;
+    description?: string;
+    children: ReactNode;
+    closeLabel?: string;
+    dismissOnBackdropPress?: boolean;
+    className?: string;
+    contentClassName?: string;
+}
+/** Controlled or initially open modal dialog; supplies no hidden trigger. */
+declare function Dialog(props: DialogProps): react_jsx_runtime.JSX.Element;
+type SheetProps = DialogProps;
+/** Bottom-aligned, scrollable modal sheet with the same dismissal contract. */
+declare function Sheet(props: SheetProps): react_jsx_runtime.JSX.Element;
+
+interface AlertProps extends ViewProps {
+    title: string;
+    description?: string;
+    children?: ReactNode;
+    tone?: StatusTone;
+    announce?: 'off' | 'polite' | 'assertive';
+    className?: string;
+}
+declare function Alert({ title, description, children, tone, announce, className, ...props }: AlertProps): react_jsx_runtime.JSX.Element;
+interface ToastProps extends Omit<AlertProps, 'announce'> {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Zero keeps the notification until explicitly dismissed. */
+    duration?: number;
+    dismissLabel?: string;
+}
+/** Nonmodal inline notification. The consumer chooses its location. */
+declare function Toast({ open, defaultOpen, onOpenChange, duration, dismissLabel, className, children, ...props }: ToastProps): react_jsx_runtime.JSX.Element | null;
+interface SpinnerProps extends ViewProps {
+    label?: string;
+    size?: 'small' | 'large';
+    className?: string;
+}
+declare function Spinner({ label, size, className, ...props }: SpinnerProps): react_jsx_runtime.JSX.Element;
+interface ProgressProps extends ViewProps {
+    value: number;
+    max?: number;
+    label: string;
+    className?: string;
+    indicatorClassName?: string;
+}
+declare function Progress({ value, max, label, className, indicatorClassName, ...props }: ProgressProps): react_jsx_runtime.JSX.Element;
+interface SkeletonProps extends ViewProps {
+    className?: string;
+}
+/** Static placeholder; avoids forcing motion on either platform. */
+declare function Skeleton({ className, ...props }: SkeletonProps): react_jsx_runtime.JSX.Element;
+
+interface BreadcrumbItem {
+    label: string;
+    href?: string;
+}
+interface BreadcrumbsProps extends ViewProps {
+    items: BreadcrumbItem[];
+    label?: string;
+    className?: string;
+}
+declare function Breadcrumbs({ items, label, className, ...props }: BreadcrumbsProps): react_jsx_runtime.JSX.Element;
+interface PaginationProps extends ViewProps {
+    page: number;
+    count: number;
+    onPageChange: (page: number) => void;
+    label?: string;
+    className?: string;
+}
+declare function Pagination({ page, count, onPageChange, label, className, ...props }: PaginationProps): react_jsx_runtime.JSX.Element;
+
+type Appearance = 'light' | 'dark' | 'system';
+type ResolvedAppearance = 'light' | 'dark';
+type ThemeColor = Exclude<keyof typeof tokens.themes.light, `shadow-${string}`>;
+type ThemeColors = {
+    [Key in ThemeColor]: string;
+};
+declare function themeVariables(appearance: ResolvedAppearance): Record<string, string>;
+interface ThemeProviderProps extends ViewProps {
+    children: ReactNode;
+    appearance?: Appearance;
+    className?: string;
+}
+/** Scoped variables support nested themes without changing global appearance. */
+declare function ThemeProvider({ appearance, children, className, style, ...props }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare function useTheme(): {
+    appearance: Appearance;
+    resolvedAppearance: ResolvedAppearance;
+    colors: ThemeColors;
+    variables: Record<string, string>;
+};
+
+interface FormFieldProps extends ViewProps {
+    label: string;
+    hint?: string;
+    error?: string;
+    required?: boolean;
+    disabled?: boolean;
+    /** Opt into announcing errors that change during interaction. */
+    announceError?: boolean;
+    children: ReactNode;
+    className?: string;
+    labelClassName?: string;
+}
+/** Associates a visible label, hint, and error with the enclosed form control. */
+declare const FormField: react.ForwardRefExoticComponent<FormFieldProps & react.RefAttributes<View>>;
+
+interface InputProps extends TextInputProps {
+    disabled?: boolean;
+    invalid?: boolean;
+    required?: boolean;
+    className?: string;
+}
+/** Native TextInput with field association and matching light/dark paint. */
+declare const Input: react.ForwardRefExoticComponent<InputProps & react.RefAttributes<TextInput>>;
+interface TextareaProps extends InputProps {
+}
+/** A multiline Input; numberOfLines and style/minHeight remain native props. */
+declare const Textarea: react.ForwardRefExoticComponent<TextareaProps & react.RefAttributes<TextInput>>;
+
+/** RNW's Enter activation forwards a raw DOM keyup, without React event methods. */
+interface ChoiceDOMKeyboardEvent {
+    readonly key: string;
+    readonly code: string;
+    readonly repeat: boolean;
+    readonly type: string;
+    readonly defaultPrevented: boolean;
+    readonly target: unknown;
+    readonly currentTarget: unknown;
+    preventDefault(): void;
+    stopPropagation(): void;
+}
+type ChoicePressEvent = GestureResponderEvent | SyntheticEvent<unknown, unknown> | ChoiceDOMKeyboardEvent;
+interface ChoiceProps extends Omit<PressableProps, 'children' | 'onPress'> {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+    /** Web supplies React keyboard events for Space and raw DOM keyup for Enter. */
+    onPress?: ((event: ChoicePressEvent) => void) | null;
+    label?: string;
+    description?: string;
+    invalid?: boolean;
+    required?: boolean;
+    className?: string;
+    textClassName?: string;
+}
+interface CheckboxProps extends ChoiceProps {
+    /** A mixed checkbox becomes checked on its next activation. */
+    indeterminate?: boolean;
+}
+interface SwitchProps extends ChoiceProps {
+}
+declare const Checkbox: react.ForwardRefExoticComponent<CheckboxProps & react.RefAttributes<View>>;
+declare const Switch: react.ForwardRefExoticComponent<SwitchProps & react.RefAttributes<View>>;
+
+interface RadioOption {
+    value: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}
+interface RadioGroupProps extends Omit<ViewProps, 'children'> {
+    options: readonly RadioOption[];
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    label?: string;
+    disabled?: boolean;
+    required?: boolean;
+    invalid?: boolean;
+    orientation?: 'horizontal' | 'vertical';
+    className?: string;
+    optionClassName?: string;
+    textClassName?: string;
+}
+/** Single selection with roving web focus and native radio accessibility. */
+declare const RadioGroup: react.ForwardRefExoticComponent<RadioGroupProps & react.RefAttributes<View>>;
+
+type SelectOption = RadioOption;
+interface SelectProps extends Omit<PressableProps, 'children'> {
+    options: readonly SelectOption[];
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    label?: string;
+    placeholder?: string;
+    required?: boolean;
+    invalid?: boolean;
+    className?: string;
+    textClassName?: string;
+}
+/** A labelled button opens a single-choice dialog on web and native. */
+declare const Select: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<View>>;
+
+interface TabItem {
+    value: string;
+    label: string;
+    content: ReactNode;
+    disabled?: boolean;
+}
+interface TabsProps extends Omit<ViewProps, 'children'> {
+    items: readonly TabItem[];
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    label?: string;
+    orientation?: 'horizontal' | 'vertical';
+    className?: string;
+    tabListClassName?: string;
+    tabClassName?: string;
+    textClassName?: string;
+    panelClassName?: string;
+}
+/** Automatically activates tabs with arrow keys; inactive panels are unmounted. */
+declare const Tabs: react.ForwardRefExoticComponent<TabsProps & react.RefAttributes<View>>;
+
+export { Accordion, type AccordionItem, type AccordionProps, Alert, type AlertProps, type Appearance, Avatar, type AvatarProps, Badge, type BadgeProps, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardProps, Checkbox, type CheckboxProps, type ChoiceDOMKeyboardEvent, type ChoicePressEvent, type ChoiceProps, Container, type ContainerProps, Dialog, type DialogProps, Divider, type DividerProps, EmptyState, type EmptyStateProps, FormField, type FormFieldProps, Heading, type HeadingProps, IconButton, type IconButtonProps, Inline, type InlineProps, Input, type InputProps, Link, type LinkProps, ListItem, type ListItemProps, Pagination, type PaginationProps, Progress, type ProgressProps, RadioGroup, type RadioGroupProps, type RadioOption, type ResolvedAppearance, Select, type SelectOption, type SelectProps, Sheet, type SheetProps, Skeleton, type SkeletonProps, Spinner, type SpinnerProps, Stack, type StackProps, type StatusTone, Switch, type SwitchProps, type TabItem, Tabs, type TabsProps, Text, type TextProps, type TextTone, type TextVariant, Textarea, type TextareaProps, type ThemeColor, type ThemeColors, ThemeProvider, type ThemeProviderProps, Toast, type ToastProps, themeVariables, tokens, useTheme };