vxui-react 0.1.0

package/dist/components/Progress.d.ts

@@ -0,0 +1,11 @@
+import { HTMLAttributes } from 'react';
+export interface ProgressProps extends HTMLAttributes<HTMLDivElement> {
+    value?: number;
+    max?: number;
+    label?: string;
+    showLabel?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    variant?: 'default' | 'success' | 'warning' | 'danger';
+    indeterminate?: boolean;
+}
+export declare function Progress({ className, value, max, label, showLabel, size, variant, indeterminate, ...props }: ProgressProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Radio.d.ts

@@ -0,0 +1,12 @@
+import { InputHTMLAttributes, ReactNode } from 'react';
+export interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> {
+    label?: ReactNode;
+    description?: string;
+}
+export declare function Radio({ className, label, description, ...props }: RadioProps): import("react/jsx-runtime").JSX.Element;
+export interface RadioGroupProps {
+    label?: string;
+    children: ReactNode;
+    className?: string;
+}
+export declare function RadioGroup({ label, children, className }: RadioGroupProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Select.d.ts

@@ -0,0 +1,7 @@
+import { SelectHTMLAttributes } from 'react';
+export interface SelectProps extends SelectHTMLAttributes<HTMLSelectElement> {
+    label?: string;
+    hint?: string;
+    placeholder?: string;
+}
+export declare function Select({ className, label, hint, placeholder, children, ...props }: SelectProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Separator.d.ts

@@ -0,0 +1,6 @@
+import { HTMLAttributes } from 'react';
+export interface SeparatorProps extends HTMLAttributes<HTMLHRElement> {
+    orientation?: 'horizontal' | 'vertical';
+    decorative?: boolean;
+}
+export declare function Separator({ className, orientation, decorative, ...props }: SeparatorProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Skeleton.d.ts

@@ -0,0 +1,8 @@
+import { HTMLAttributes } from 'react';
+export interface SkeletonProps extends HTMLAttributes<HTMLSpanElement> {
+    width?: string | number;
+    height?: string | number;
+    variant?: 'text' | 'rect' | 'circle';
+    lines?: number;
+}
+export declare function Skeleton({ className, width, height, variant, lines, style, ...props }: SkeletonProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Slider.d.ts

@@ -0,0 +1,7 @@
+import { InputHTMLAttributes } from 'react';
+export interface SliderProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> {
+    label?: string;
+    showValue?: boolean;
+    hint?: string;
+}
+export declare function Slider({ className, label, showValue, hint, value, defaultValue, ...props }: SliderProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Spinner.d.ts

@@ -0,0 +1,8 @@
+import { HTMLAttributes } from 'react';
+type SpinnerSize = 'sm' | 'md' | 'lg';
+export interface SpinnerProps extends HTMLAttributes<HTMLSpanElement> {
+    size?: SpinnerSize;
+    label?: string;
+}
+export declare function Spinner({ className, size, label, ...props }: SpinnerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/Switch.d.ts

@@ -0,0 +1,7 @@
+import { ComponentPropsWithoutRef } from 'react';
+import * as SwitchPrimitive from '@radix-ui/react-switch';
+export interface SwitchProps extends ComponentPropsWithoutRef<typeof SwitchPrimitive.Root> {
+    label: string;
+    description?: string;
+}
+export declare function Switch({ className, label, description, ...props }: SwitchProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Table.d.ts

@@ -0,0 +1,26 @@
+import { ReactNode, HTMLAttributes } from 'react';
+export type SortDirection = 'asc' | 'desc' | null;
+export interface TableColumn<T> {
+    key: string;
+    header: ReactNode;
+    accessor: (row: T) => ReactNode;
+    sortable?: boolean;
+    width?: string | number;
+    align?: 'left' | 'center' | 'right';
+    className?: string;
+}
+export interface TableProps<T> extends HTMLAttributes<HTMLDivElement> {
+    columns: TableColumn<T>[];
+    data: T[];
+    striped?: boolean;
+    hoverable?: boolean;
+    bordered?: boolean;
+    compact?: boolean;
+    stickyHeader?: boolean;
+    caption?: string;
+    emptyText?: ReactNode;
+    sortColumn?: string | null;
+    sortDirection?: SortDirection;
+    onSortChange?: (column: string, direction: SortDirection) => void;
+}
+export declare function Table<T>({ columns, data, striped, hoverable, bordered, compact, stickyHeader, caption, emptyText, sortColumn: controlledSortCol, sortDirection: controlledSortDir, onSortChange, className, ...props }: TableProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/components/Tabs.d.ts

@@ -0,0 +1,5 @@
+import * as TabsPrimitive from '@radix-ui/react-tabs';
+export declare const Tabs: import('react').ForwardRefExoticComponent<TabsPrimitive.TabsProps & import('react').RefAttributes<HTMLDivElement>>;
+export declare const TabsList: import('react').ForwardRefExoticComponent<Omit<TabsPrimitive.TabsListProps & import('react').RefAttributes<HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export declare const TabsTrigger: import('react').ForwardRefExoticComponent<Omit<TabsPrimitive.TabsTriggerProps & import('react').RefAttributes<HTMLButtonElement>, "ref"> & import('react').RefAttributes<HTMLButtonElement>>;
+export declare const TabsContent: import('react').ForwardRefExoticComponent<Omit<TabsPrimitive.TabsContentProps & import('react').RefAttributes<HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/Text.d.ts

@@ -0,0 +1,14 @@
+import { HTMLAttributes } from 'react';
+type TextVariant = 'default' | 'secondary' | 'muted' | 'danger' | 'success';
+type TextSize = 'sm' | 'base' | 'lg' | 'xl';
+type TextWeight = 'normal' | 'medium' | 'semibold' | 'bold';
+type TextElement = 'p' | 'span' | 'div';
+export interface TextProps extends HTMLAttributes<HTMLElement> {
+    as?: TextElement;
+    variant?: TextVariant;
+    size?: TextSize;
+    weight?: TextWeight;
+    truncate?: boolean;
+}
+export declare function Text({ as: Component, variant, size, weight, truncate, className, ...props }: TextProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/Textarea.d.ts

@@ -0,0 +1,7 @@
+import { TextareaHTMLAttributes } from 'react';
+export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+    label?: string;
+    hint?: string;
+    resize?: 'none' | 'vertical' | 'horizontal' | 'both';
+}
+export declare function Textarea({ className, label, hint, resize, style, ...props }: TextareaProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ThemeProvider.d.ts

@@ -0,0 +1,46 @@
+import { ReactNode } from 'react';
+export type ThemeMode = 'light' | 'dark';
+export type ThemeTokens = Partial<Record<`--vx-${string}`, string>>;
+export interface ThemeDefinition {
+    label?: string;
+    mode: ThemeMode;
+    tokens?: ThemeTokens;
+}
+export type ThemeRegistry = Record<string, ThemeDefinition>;
+interface CreateThemeOptions {
+    label?: string;
+    tokens?: ThemeTokens;
+}
+export declare function createTheme(mode: ThemeMode, options?: CreateThemeOptions): ThemeDefinition;
+export declare const themePresets: {
+    sunset: ThemeDefinition;
+    mint: ThemeDefinition;
+    graphite: ThemeDefinition;
+    'ivory-gold': ThemeDefinition;
+    'black-gold': ThemeDefinition;
+    ocean: ThemeDefinition;
+    light: {
+        label: string;
+        mode: "light";
+    };
+    dark: {
+        label: string;
+        mode: "dark";
+    };
+};
+interface ThemeContextValue {
+    theme: string;
+    mode: ThemeMode;
+    themes: ThemeRegistry;
+    setTheme: (theme: string) => void;
+    toggleTheme: () => void;
+}
+interface ThemeProviderProps {
+    children: ReactNode;
+    defaultTheme?: string;
+    storageKey?: string;
+    themes?: ThemeRegistry;
+}
+export declare function ThemeProvider({ children, defaultTheme, storageKey, themes, }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useTheme(): ThemeContextValue;
+export {};

package/dist/components/Toast.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+type ToastTone = 'info' | 'success' | 'warning' | 'danger';
+interface ToastInput {
+    title: string;
+    description?: string;
+    tone?: ToastTone;
+}
+interface ToastContextValue {
+    push: (toast: ToastInput) => void;
+}
+export declare function ToastProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useToast(): ToastContextValue;
+export {};

package/dist/components/Tooltip.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
+export interface TooltipProps {
+    content: ReactNode;
+    placement?: TooltipPlacement;
+    delay?: number;
+    children: ReactNode;
+    className?: string;
+}
+export declare function Tooltip({ content, placement, delay, children, className }: TooltipProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/mobile/ActionSheet.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode, ButtonHTMLAttributes } from 'react';
+export interface ActionSheetProps {
+    open: boolean;
+    onClose: () => void;
+    title?: string;
+    description?: string;
+    children: ReactNode;
+    className?: string;
+}
+export declare function ActionSheet({ open, onClose, title, description, children, className, }: ActionSheetProps): import("react/jsx-runtime").JSX.Element | null;
+export interface ActionSheetItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    icon?: ReactNode;
+    destructive?: boolean;
+}
+export declare function ActionSheetItem({ icon, destructive, className, children, ...props }: ActionSheetItemProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/mobile/BottomNav.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+export interface BottomNavItem {
+    key: string;
+    label: string;
+    icon: ReactNode;
+    /** 数字或字符串角标，超过 99 建议传 '99+' */
+    badge?: string | number;
+    active?: boolean;
+    onSelect?: () => void;
+}
+export interface BottomNavProps {
+    items: BottomNavItem[];
+    className?: string;
+}
+export declare function BottomNav({ items, className }: BottomNavProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/mobile/MobileApp.d.ts

@@ -0,0 +1 @@
+export declare function MobileApp(): import("react/jsx-runtime").JSX.Element;

package/dist/components/mobile/MobileDrawer.d.ts

@@ -0,0 +1,27 @@
+import { ReactNode } from 'react';
+export interface MobileDrawerProps {
+    open: boolean;
+    onClose: () => void;
+    /** 抽屉宽度，默认 280px */
+    width?: number;
+    /** 抽屉头部内容（品牌 logo、用户信息等） */
+    header?: ReactNode;
+    /** 抽屉底部内容（设置、登出等） */
+    footer?: ReactNode;
+    children: ReactNode;
+    className?: string;
+}
+export declare function MobileDrawer({ open, onClose, width, header, footer, children, className, }: MobileDrawerProps): import("react/jsx-runtime").JSX.Element | null;
+export interface DrawerNavItemProps {
+    icon?: ReactNode;
+    label: ReactNode;
+    badge?: string | number;
+    active?: boolean;
+    onClick?: () => void;
+}
+export declare function DrawerNavItem({ icon, label, badge, active, onClick }: DrawerNavItemProps): import("react/jsx-runtime").JSX.Element;
+export interface DrawerNavSectionProps {
+    title?: string;
+    children: ReactNode;
+}
+export declare function DrawerNavSection({ title, children }: DrawerNavSectionProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/mobile/MobileList.d.ts

@@ -0,0 +1,24 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export declare function MobileList({ className, ...props }: HTMLAttributes<HTMLUListElement>): import("react/jsx-runtime").JSX.Element;
+export interface MobileListSectionProps extends HTMLAttributes<HTMLDivElement> {
+    title?: string;
+}
+export declare function MobileListSection({ title, className, children, ...props }: MobileListSectionProps): import("react/jsx-runtime").JSX.Element;
+export interface MobileListItemProps {
+    /** 左侧图标或头像区域 */
+    leading?: ReactNode;
+    /** 右侧自定义内容（如状态标签、数值） */
+    trailing?: ReactNode;
+    /** 主标签文本 */
+    label: ReactNode;
+    /** 副文本描述 */
+    description?: ReactNode;
+    /** 是否显示右侧箭头（表示可进入下一层） */
+    chevron?: boolean;
+    /** 破坏性操作，文字变为危险色 */
+    destructive?: boolean;
+    disabled?: boolean;
+    onClick?: () => void;
+    className?: string;
+}
+export declare function MobileListItem({ leading, trailing, label, description, chevron, destructive, disabled, onClick, className, }: MobileListItemProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/mobile/MobilePreviewPage.d.ts

@@ -0,0 +1,5 @@
+interface MobilePreviewPageProps {
+    onExit: () => void;
+}
+export declare function MobilePreviewPage({ onExit }: MobilePreviewPageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/mobile/MobileShell.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode } from 'react';
+export interface MobileShellProps {
+    /** 固定在顶部的导航栏区域 */
+    topBar?: ReactNode;
+    /** 固定在底部的导航栏区域 */
+    bottomNav?: ReactNode;
+    children: ReactNode;
+    className?: string;
+}
+export declare function MobileShell({ topBar, bottomNav, children, className }: MobileShellProps): import("react/jsx-runtime").JSX.Element;
+export interface MobileTopBarProps {
+    /** 标题文本或节点 */
+    title?: ReactNode;
+    /** 左侧区域，通常为返回按钮 */
+    leading?: ReactNode;
+    /** 右侧区域，通常为操作按钮 */
+    trailing?: ReactNode;
+    className?: string;
+}
+export declare function MobileTopBar({ title, leading, trailing, className }: MobileTopBarProps): import("react/jsx-runtime").JSX.Element;
+export interface MobileIconButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    label: string;
+}
+export declare function MobileIconButton({ label, className, children, ...props }: MobileIconButtonProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/pages/ErrorPage.d.ts

@@ -0,0 +1,9 @@
+interface ErrorPageProps {
+    statusCode?: number;
+    requestedPath?: string;
+    onHome: () => void;
+    onDocs: () => void;
+    onBack: () => void;
+}
+export declare function ErrorPage({ statusCode, requestedPath, onHome, onDocs, onBack, }: ErrorPageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/pages/HomePage.d.ts

@@ -0,0 +1,10 @@
+interface HomePageProps {
+    viewerName?: string | null;
+    onLogin: () => void;
+    onRegister: () => void;
+    onDocs: (pageKey?: string) => void;
+    onPrivacy: () => void;
+    onLogout?: () => void;
+}
+export declare function HomePage({ viewerName, onLogin, onRegister, onDocs, onPrivacy, onLogout, }: HomePageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/pages/LoginPage.d.ts

@@ -0,0 +1,12 @@
+interface LoginPageProps {
+    onLogin: (payload: {
+        email: string;
+        password: string;
+        remember: boolean;
+    }) => Promise<void> | void;
+    onRegister: () => void;
+    onGuest: () => void;
+    onBack: () => void;
+}
+export declare function LoginPage({ onLogin, onRegister, onGuest, onBack }: LoginPageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/pages/PrivacyPolicyPage.d.ts

@@ -0,0 +1,5 @@
+interface PrivacyPolicyPageProps {
+    onBack: () => void;
+}
+export declare function PrivacyPolicyPage({ onBack }: PrivacyPolicyPageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/pages/RegisterPage.d.ts

@@ -0,0 +1,14 @@
+interface RegisterPageProps {
+    onRegister: (payload: {
+        name: string;
+        email: string;
+        password: string;
+    }) => Promise<void> | void;
+    onLogin: () => void;
+    onGuest: () => void;
+    onPrivacy: () => void;
+    onTerms: () => void;
+    onBack: () => void;
+}
+export declare function RegisterPage({ onRegister, onLogin, onGuest, onPrivacy, onTerms, onBack }: RegisterPageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/pages/TermsOfServicePage.d.ts

@@ -0,0 +1,5 @@
+interface TermsOfServicePageProps {
+    onBack: () => void;
+}
+export declare function TermsOfServicePage({ onBack }: TermsOfServicePageProps): import("react/jsx-runtime").JSX.Element;
+export {};