@ryanhe919/lumen-ui 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,638 @@
+import { default as default_2 } from 'react';
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+
+export declare type BadgeVariant = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+
+/**
+ * Common component props
+ */
+export declare interface BaseComponentProps {
+    className?: string;
+    style?: React.CSSProperties;
+}
+
+/**
+ * Component variant types
+ */
+export declare type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'link' | 'danger';
+
+/**
+ * Common event handlers
+ */
+export declare type ChangeHandler<T = string> = (value: T) => void;
+
+/**
+ * Clamp size to allowed values
+ */
+export declare const clampComponentSize: (size: ComponentSize | undefined, allowedSizes: ComponentSize[], fallback?: ComponentSize) => ComponentSize;
+
+/**
+ * Utility for merging class names
+ * Simple implementation without external dependencies
+ */
+declare type ClassValue = string | undefined | null | false | ClassValue[];
+
+export declare function cn(...inputs: ClassValue[]): string;
+
+/** Size order for iteration */
+export declare const COMPONENT_SIZE_ORDER: ComponentSize[];
+
+/**
+ * @file Component size utilities
+ * @description Shared size tokens for LumenUI components
+ */
+export declare type ComponentSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+
+/**
+ * Form field status
+ */
+export declare type FieldStatus = 'default' | 'success' | 'warning' | 'error';
+
+export declare type InputVariant = 'default' | 'filled' | 'outline';
+
+export declare const LMBadge: default_2.FC<LMBadgeProps>;
+
+export declare interface LMBadgeProps {
+    /** Badge content */
+    children: default_2.ReactNode;
+    /** Color variant */
+    variant?: LMBadgeVariant;
+    /** Size */
+    size?: LMBadgeSize;
+    /** Custom class name */
+    className?: string;
+    /** Show dot */
+    dot?: boolean;
+    /** Icon */
+    icon?: default_2.ReactNode;
+}
+
+export declare type LMBadgeSize = 'xs' | 'sm' | 'md' | 'lg';
+
+export declare type LMBadgeVariant = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'info' | 'neutral';
+
+export declare const LMButton: default_2.NamedExoticComponent<LMButtonProps>;
+
+export declare interface LMButtonProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Button variant */
+    variant?: LMButtonVariant;
+    /** Size */
+    size?: ComponentSize;
+    /** Loading state */
+    loading?: boolean;
+    /** Loading text */
+    loadingText?: string;
+    /** Left icon */
+    leftIcon?: default_2.ReactNode;
+    /** Right icon */
+    rightIcon?: default_2.ReactNode;
+    /** Full width */
+    fullWidth?: boolean;
+    /** Full rounded */
+    rounded?: boolean;
+}
+
+export declare type LMButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'danger' | 'success' | 'warning';
+
+export declare const LMCheckbox: default_2.FC<LMCheckboxProps>;
+
+export declare interface LMCheckboxProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, 'size'> {
+    /** Label text */
+    label: string;
+    /** Description text */
+    description?: string;
+    /** Error state */
+    error?: boolean;
+    /** Error message */
+    errorMessage?: string;
+    /** Size */
+    size?: ComponentSize;
+}
+
+export declare const LMConfirm: default_2.FC<LMConfirmProps>;
+
+export declare interface LMConfirmProps {
+    /** Dialog visible */
+    visible: boolean;
+    /** Dialog title */
+    title?: string;
+    /** Dialog content */
+    content: string;
+    /** Confirm button text */
+    confirmText?: string;
+    /** Cancel button text */
+    cancelText?: string;
+    /** Confirm button style */
+    confirmButtonStyle?: 'primary' | 'danger';
+    /** Confirm callback */
+    onConfirm: () => void;
+    /** Cancel callback */
+    onCancel: () => void;
+    /** Close on overlay click */
+    closeOnOverlayClick?: boolean;
+}
+
+export declare const LMField: default_2.FC<LMFieldProps>;
+
+export declare interface LMFieldProps {
+    /** Field label */
+    label: string;
+    /** Required indicator */
+    required?: boolean;
+    /** Error message */
+    errorMessage?: string;
+    /** Help text */
+    help?: string;
+    /** Children */
+    children: default_2.ReactNode;
+    /** Class name */
+    className?: string;
+}
+
+export declare const LMInput: default_2.FC<LMInputProps>;
+
+export declare interface LMInputProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, 'size'> {
+    /** Left icon */
+    leftIcon?: default_2.ReactNode;
+    /** Right element */
+    rightElement?: default_2.ReactNode;
+    /** Error state */
+    error?: boolean;
+    /** Error message */
+    errorMessage?: string;
+    /** Size */
+    size?: ComponentSize;
+    /** Include seconds for time inputs */
+    includeSeconds?: boolean;
+}
+
+export declare interface LMLoadMoreConfig {
+    /** Enable load more */
+    enabled: boolean;
+    /** Threshold */
+    threshold?: number;
+    /** Has more data */
+    hasMore: boolean;
+    /** Loading state */
+    loading: boolean;
+    /** Load more callback */
+    onLoadMore: () => void;
+}
+
+export declare const LMMessage: default_2.FC<LMMessageProps>;
+
+export declare const LMMessageContainer: default_2.FC<LMMessageContainerProps>;
+
+export declare interface LMMessageContainerProps {
+    /** Messages list */
+    messages: LMMessageItem[];
+    /** Close callback */
+    onClose: (id: string) => void;
+    /** Position */
+    position?: 'top-right' | 'top-left' | 'top-center' | 'bottom-right' | 'bottom-left' | 'bottom-center';
+}
+
+export declare interface LMMessageItem {
+    id: string;
+    type: LMMessageType;
+    title?: string;
+    content: string;
+    duration?: number;
+}
+
+export declare interface LMMessageProps {
+    id: string;
+    type: LMMessageType;
+    title?: string;
+    content: string;
+    /** Auto close duration in ms, 0 means no auto close */
+    duration?: number;
+    onClose: (id: string) => void;
+}
+
+export declare type LMMessageType = 'success' | 'error' | 'warning' | 'info';
+
+export declare const LMModal: default_2.NamedExoticComponent<LMModalProps>;
+
+export declare interface LMModalProps {
+    /** Visibility */
+    visible: boolean;
+    /** Title */
+    title?: string;
+    /** Content */
+    children: default_2.ReactNode;
+    /** Custom footer */
+    footer?: default_2.ReactNode;
+    /** Close callback */
+    onClose?: () => void;
+    /** OK callback */
+    onOk?: () => void;
+    /** Cancel callback */
+    onCancel?: () => void;
+    /** OK button text */
+    okText?: string;
+    /** Cancel button text */
+    cancelText?: string;
+    /** Show OK button */
+    showOk?: boolean;
+    /** Show Cancel button */
+    showCancel?: boolean;
+    /** OK loading state */
+    okLoading?: boolean;
+    /** Cancel loading state */
+    cancelLoading?: boolean;
+    /** Show mask */
+    mask?: boolean;
+    /** Click mask to close */
+    maskClosable?: boolean;
+    /** Show close button */
+    closable?: boolean;
+    /** Custom close icon */
+    closeIcon?: default_2.ReactNode;
+    /** Header icon */
+    headerIcon?: default_2.ReactNode;
+    /** Width */
+    width?: string | number;
+    /** Height */
+    height?: string | number;
+    /** Size preset */
+    size?: ComponentSize;
+    /** Custom class name */
+    className?: string;
+    /** Custom style */
+    style?: default_2.CSSProperties;
+    /** Center vertically */
+    centered?: boolean;
+    /** Fullscreen mode */
+    fullscreen?: boolean;
+    /** Animation duration (ms) */
+    animationDuration?: number;
+    /** Enable animation */
+    animation?: boolean;
+}
+
+export declare const LMNumberInput: default_2.FC<LMNumberInputProps>;
+
+export declare interface LMNumberInputProps {
+    /** Current value (controlled) */
+    value?: number | null;
+    /** Change callback */
+    onChange?: (value: number | null) => void;
+    /** Error state */
+    error?: boolean;
+    /** Error message */
+    errorMessage?: string;
+    /** Placeholder */
+    placeholder?: string;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Class name */
+    className?: string;
+    /** Form field name */
+    name?: string;
+    /** Size */
+    size?: ComponentSize;
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Step */
+    step?: number;
+    /** Decimal precision */
+    precision?: number;
+    /** Show increment/decrement controls */
+    showControls?: boolean;
+    /** Prefix text */
+    prefix?: string;
+    /** Suffix text */
+    suffix?: string;
+}
+
+export declare interface LMPaginationConfig {
+    /** Current page */
+    current: number;
+    /** Page size */
+    pageSize: number;
+    /** Total count */
+    total: number;
+    /** Show pagination */
+    showPagination?: boolean;
+    /** Page size options */
+    pageSizeOptions?: number[];
+    /** Show total */
+    showTotal?: boolean;
+    /** Show quick jumper */
+    showQuickJumper?: boolean;
+    /** Show size changer */
+    showSizeChanger?: boolean;
+    /** Change callback */
+    onChange?: (page: number, pageSize: number) => void;
+}
+
+export declare const LMRadio: default_2.FC<LMRadioProps>;
+
+export declare interface LMRadioProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    /** Label text */
+    label: string;
+    /** Description text */
+    description?: string;
+    /** Error state */
+    error?: boolean;
+    /** Error message */
+    errorMessage?: string;
+    /** Size */
+    size?: ComponentSize;
+}
+
+export declare const LMSearchInput: default_2.FC<LMSearchInputProps>;
+
+export declare interface LMSearchInputProps {
+    /** Current search value */
+    value?: string;
+    /** Change callback */
+    onChange?: (value: string) => void;
+    /** Search submit callback */
+    onSearch?: (value: string) => void;
+    /** Error state */
+    error?: boolean;
+    /** Error message */
+    errorMessage?: string;
+    /** Placeholder */
+    placeholder?: string;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Class name */
+    className?: string;
+    /** Form field name */
+    name?: string;
+    /** Size */
+    size?: ComponentSize;
+    /** Show clear button */
+    showClear?: boolean;
+    /** Show search button */
+    showSearchButton?: boolean;
+    /** Search button text */
+    searchButtonText?: string;
+    /** Debounce delay (ms) */
+    debounceDelay?: number;
+}
+
+export declare const LMSelect: default_2.FC<LMSelectProps>;
+
+export declare interface LMSelectOption {
+    value: string | number;
+    label: string;
+    disabled?: boolean;
+}
+
+export declare interface LMSelectProps {
+    /** Options */
+    options: LMSelectOption[];
+    /** Current value */
+    value?: string | number | (string | number)[];
+    /** Change callback */
+    onChange?: (value: string | number | (string | number)[]) => void;
+    /** Dropdown visibility change callback */
+    onDropdownVisibleChange?: (visible: boolean) => void;
+    /** Error state */
+    error?: boolean;
+    /** Error message */
+    errorMessage?: string;
+    /** Placeholder */
+    placeholder?: string;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Class name */
+    className?: string;
+    /** Form field name */
+    name?: string;
+    /** Size */
+    size?: ComponentSize;
+    /** Multiple selection */
+    multiple?: boolean;
+}
+
+export declare const LMStatCard: default_2.FC<LMStatCardProps>;
+
+export declare interface LMStatCardProps {
+    /** Title */
+    title: string;
+    /** Value */
+    value: string | number;
+    /** Description text */
+    description?: string;
+    /** Left icon */
+    icon?: default_2.ReactNode;
+    /** Trend value (percentage, positive/negative indicates direction; 0 means flat) */
+    trend?: number;
+    /** Trend description text */
+    trendText?: string;
+    /** Visual variant */
+    variant?: 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+    /** Size */
+    size?: ComponentSize;
+    /** Clickable */
+    clickable?: boolean;
+    /** Click event */
+    onClick?: () => void;
+    /** Class name */
+    className?: string;
+    /** Value prefix (e.g., $) */
+    prefix?: string;
+    /** Value suffix (e.g., %, times) */
+    suffix?: string;
+    /** Show border */
+    bordered?: boolean;
+    /** Show shadow */
+    shadow?: boolean;
+    /** Compact mode: uses smaller spacing and fonts when enabled */
+    compact?: boolean;
+}
+
+export declare const LMSwitch: default_2.FC<LMSwitchProps>;
+
+export declare interface LMSwitchProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
+    /** Label text */
+    label?: string;
+    /** Description text */
+    description?: string;
+    /** Error state */
+    error?: boolean;
+    /** Error message */
+    errorMessage?: string;
+    /** Size */
+    size?: ComponentSize;
+}
+
+export declare const LMTable: typeof LMTable_2;
+
+declare const LMTable_2: <T = unknown>({ dataSource, columns, rowKey, pagination, loadMore, loading, emptyText, size, bordered, striped, selectable, selectedRowKeys, onSelectionChange, onRowClick, onSortChange, className, fullHeight, variant, }: LMTableProps<T>) => JSX_2.Element;
+
+export declare interface LMTableColumn<T = Record<string, unknown>> {
+    /** Column title */
+    title: string;
+    /** Data field name */
+    dataIndex: string;
+    /** Column width */
+    width?: string | number;
+    /** Custom render function */
+    render?: (value: unknown, record: T, index: number) => default_2.ReactNode;
+    /** Sortable */
+    sorter?: boolean;
+    /** Column alignment */
+    align?: 'left' | 'center' | 'right';
+    /** Fixed column */
+    fixed?: 'left' | 'right';
+}
+
+export declare interface LMTableProps<T = Record<string, unknown>> {
+    /** Data source */
+    dataSource: T[];
+    /** Columns */
+    columns: LMTableColumn<T>[];
+    /** Row key */
+    rowKey?: string | ((record: T, index: number) => string);
+    /** Pagination config */
+    pagination?: LMPaginationConfig;
+    /** Load more config */
+    loadMore?: LMLoadMoreConfig;
+    /** Loading state */
+    loading?: boolean;
+    /** Empty text */
+    emptyText?: string;
+    /** Size */
+    size?: ComponentSize;
+    /** Bordered */
+    bordered?: boolean;
+    /** Striped */
+    striped?: boolean;
+    /** Selectable */
+    selectable?: boolean;
+    /** Selected row keys */
+    selectedRowKeys?: string[];
+    /** Selection change callback */
+    onSelectionChange?: (selectedRowKeys: string[], selectedRows: T[]) => void;
+    /** Row click callback */
+    onRowClick?: (record: T, index: number) => void;
+    /** Sort change callback */
+    onSortChange?: (field: string, order: 'ascend' | 'descend') => void;
+    /** Class name */
+    className?: string;
+    /** Full height */
+    fullHeight?: boolean;
+    /** Variant */
+    variant?: 'default' | 'elevated' | 'outline' | 'minimal' | 'soft' | 'zebra';
+}
+
+export declare const LMTextarea: default_2.FC<LMTextareaProps>;
+
+export declare interface LMTextareaProps extends default_2.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    /** Error state */
+    error?: boolean;
+    /** Error message */
+    errorMessage?: string;
+    /** Size */
+    size?: ComponentSize;
+}
+
+export declare const LMTooltip: default_2.FC<LMTooltipProps>;
+
+export declare interface LMTooltipProps {
+    /** Tooltip content */
+    content: default_2.ReactNode;
+    /** Trigger element */
+    children: default_2.ReactNode;
+    /** Placement */
+    placement?: 'top' | 'bottom' | 'left' | 'right';
+    /** Max width */
+    maxWidth?: number;
+    /** Size */
+    size?: ComponentSize;
+}
+
+/** Button size config */
+export declare const SIZE_BUTTON_CONFIG: Record<ComponentSize, {
+    padding: string;
+    height: string;
+}>;
+
+/** Display size classes */
+export declare const SIZE_DISPLAY_CLASSES: Record<ComponentSize, string>;
+
+/** Gap classes */
+export declare const SIZE_GAP_CLASSES: Record<ComponentSize, string>;
+
+/** Heading size classes */
+export declare const SIZE_HEADING_CLASSES: Record<ComponentSize, string>;
+
+/** Icon size config */
+export declare const SIZE_ICON_CONFIG: Record<ComponentSize, string>;
+
+/** Input size config */
+export declare const SIZE_INPUT_CONFIG: Record<ComponentSize, {
+    padding: string;
+    height: string;
+    fontSize: string;
+}>;
+
+/** Modal size config */
+export declare const SIZE_MODAL_CONFIG: Record<ComponentSize, {
+    width: string;
+    maxWidth: string;
+}>;
+
+/** Padding classes */
+export declare const SIZE_PADDING_CLASSES: Record<ComponentSize, string>;
+
+/** Selector size config */
+export declare const SIZE_SELECTOR_CONFIG: Record<ComponentSize, {
+    padding: string;
+    height: string;
+    fontSize: string;
+}>;
+
+/** Table size config */
+export declare const SIZE_TABLE_CONFIG: Record<ComponentSize, {
+    cellPadding: string;
+    rowHeight: string;
+}>;
+
+/** Text size classes */
+export declare const SIZE_TEXT_CLASSES: Record<ComponentSize, string>;
+
+/** Tooltip size config */
+export declare const SIZE_TOOLTIP_CONFIG: Record<ComponentSize, {
+    paddingClass: string;
+    textClass: string;
+    maxWidth: number;
+}>;
+
+export declare const useConfirm: () => UseConfirmReturn;
+
+export declare interface UseConfirmReturn {
+    visible: boolean;
+    config: Omit<LMConfirmProps, 'visible' | 'onConfirm' | 'onCancel'> | null;
+    confirm: (options: {
+        title?: string;
+        content: string;
+        confirmText?: string;
+        cancelText?: string;
+        confirmButtonStyle?: 'primary' | 'danger';
+    }) => Promise<boolean>;
+    ConfirmDialog: default_2.FC;
+}
+
+export declare const useMessage: () => UseMessageReturn;
+
+export declare interface UseMessageReturn {
+    messages: LMMessageItem[];
+    addMessage: (message: Omit<LMMessageItem, 'id'>) => string;
+    removeMessage: (id: string) => void;
+    success: (content: string, title?: string, duration?: number) => string;
+    error: (content: string, title?: string, duration?: number) => string;
+    warning: (content: string, title?: string, duration?: number) => string;
+    info: (content: string, title?: string, duration?: number) => string;
+    clearAll: () => void;
+}
+
+export { }