@xto/core 1.1.0 → 1.2.1

package/es/locale/lang/ko-KR.d.ts

@@ -0,0 +1,6 @@
+import { LocaleMessages } from '../types';
+/**
+ * 한국어 언어 팩
+ */
+export declare const koKR: LocaleMessages;
+export default koKR;

package/es/locale/lang/zh-CN.d.ts

@@ -0,0 +1,6 @@
+import { LocaleMessages } from './types';
+/**
+ * 中文语言包
+ */
+export declare const zhCN: LocaleMessages;
+export default zhCN;

package/es/locale/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 国际化类型定义
+ */
+export type LocaleCode = 'zh-CN' | 'en-US' | 'ja-JP' | 'ko-KR';
+export interface LocaleMessages {
+    [key: string]: string | LocaleMessages;
+}
+export interface LocaleConfig {
+    code: LocaleCode;
+    name: string;
+    messages: LocaleMessages;
+}
+export interface UseLocaleReturn {
+    locale: import('vue').Ref<LocaleCode>;
+    messages: import('vue').ComputedRef<LocaleMessages>;
+    t: (key: string, ...args: (string | number)[]) => string;
+    setLocale: (code: LocaleCode) => void;
+    mergeMessages: (messages: LocaleMessages) => void;
+}

package/es/theme/index.d.ts

@@ -0,0 +1,91 @@
+import { ThemeConfig, ComponentSize, SizeMap } from '../types';
+/**
+ * 默认主题配置
+ */
+export declare const defaultThemeConfig: ThemeConfig;
+/**
+ * 组件尺寸像素映射
+ */
+export declare const sizeMap: SizeMap;
+/**
+ * 获取组件尺寸像素值
+ * @param size 组件尺寸
+ * @returns 像素值
+ */
+export declare const getComponentSize: (size: ComponentSize) => number;
+/**
+ * 生成颜色调色板
+ * @param color 基础颜色
+ * @param count 生成数量
+ * @returns 颜色数组
+ *
+ * @example
+ * ```ts
+ * const palette = generateColorPalette('#409eff', 10)
+ * // 生成 10 个不同亮度的颜色
+ * ```
+ */
+export declare function generateColorPalette(color: string, count?: number): string[];
+/**
+ * HEX 转 RGB
+ * @param hex HEX 颜色值
+ * @returns RGB 对象
+ */
+export declare const hexToRgb: (hex: string) => {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/**
+ * RGB 转 HEX
+ * @param r 红色值
+ * @param g 绿色值
+ * @param b 蓝色值
+ * @returns HEX 颜色值
+ */
+export declare const rgbToHex: (r: number, g: number, b: number) => string;
+/**
+ * 混合颜色
+ * @param color1 颜色1
+ * @param color2 颜色2
+ * @param weight 权重（0-1）
+ * @returns 混合后的颜色
+ */
+export declare const mixColor: (color1: string, color2: string, weight?: number) => string;
+/**
+ * CSS 变量前缀
+ */
+export declare const cssVarPrefix = "--xto";
+/**
+ * 生成 CSS 变量对象
+ * @param config 主题配置
+ * @returns CSS 变量对象
+ *
+ * @example
+ * ```ts
+ * const vars = generateCSSVars(themeConfig)
+ * // { '--xto-color-primary': '#409eff', ... }
+ * ```
+ */
+export declare function generateCSSVars(config: ThemeConfig): Record<string, string>;
+/**
+ * 应用 CSS 变量到根元素
+ * @param config 主题配置
+ */
+export declare function applyCSSVars(config: ThemeConfig): void;
+/**
+ * 移除 CSS 变量
+ */
+export declare function removeCSSVars(): void;
+/**
+ * 深色主题 CSS 变量
+ */
+export declare const darkCSSVars: Record<string, string>;
+/**
+ * 应用深色主题
+ */
+export declare function applyDarkTheme(): void;
+/**
+ * 移除深色主题
+ */
+export declare function removeDarkTheme(): void;

package/es/types/index.d.ts

@@ -0,0 +1,258 @@
+import { Ref, ComputedRef, PropType } from 'vue';
+/**
+ * 组件尺寸
+ */
+export type ComponentSize = 'large' | 'default' | 'small';
+/**
+ * 组件状态
+ */
+export type ComponentState = 'default' | 'hover' | 'focus' | 'active' | 'disabled';
+/**
+ * 主题模式
+ */
+export type ThemeMode = 'light' | 'dark';
+/**
+ * 过渡动画名称
+ */
+export type TransitionName = 'fade' | 'zoom' | 'slide-left' | 'slide-right' | 'slide-up' | 'slide-down';
+/**
+ * 水平对齐方式
+ */
+export type HorizontalAlignment = 'left' | 'center' | 'right';
+/**
+ * 垂直对齐方式
+ */
+export type VerticalAlignment = 'top' | 'middle' | 'bottom';
+/**
+ * 字面量联合类型
+ * @example LiteralUnion<'a' | 'b'> // 'a' | 'b' | (string & {})
+ */
+export type LiteralUnion<T extends string> = T | (string & {});
+/**
+ * 任意函数类型
+ */
+export type AnyFunction<T = any, R = any> = (...args: T[]) => R;
+/**
+ * Promise 函数类型
+ */
+export type PromiseFunction<T = any, R = any> = (...args: T[]) => Promise<R>;
+/**
+ * 可能是 Ref 的值
+ */
+export type MaybeRef<T> = T | Ref<T>;
+/**
+ * 深层可能是 Ref 的值
+ */
+export type MaybeRefDeep<T> = T extends object ? MaybeRefDeep<T> | MaybeRef<T> : MaybeRef<T>;
+/**
+ * 可选的 Ref
+ */
+export type MaybeComputedRef<T> = ComputedRef<T> | T;
+/**
+ * CSS 属性类型
+ */
+export type CSSProperties = Record<string, any>;
+/**
+ * 类名类型
+ */
+export type ClassName = string | Record<string, boolean> | ClassName[];
+/**
+ * 事件处理器类型
+ */
+export type EventHandler<T = any> = (event: T) => void;
+/**
+ * 对象字段类型
+ */
+export type ObjectField<T, K extends keyof T = keyof T> = K extends string ? T[K] : never;
+/**
+ * 必填字段类型
+ */
+export type RequiredField<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+/**
+ * 可选字段类型
+ */
+export type OptionalField<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Vue Prop 类型构造器
+ */
+export type VuePropType<T> = BooleanConstructor | StringConstructor | NumberConstructor | ObjectConstructor | ArrayConstructor | DateConstructor | FunctionConstructor | SymbolConstructor;
+/**
+ * Vue Prop 定义
+ */
+export type VueProp<T> = PropType<T> | {
+    type: VuePropType<T>;
+    values?: T[];
+    default?: T;
+};
+/**
+ * 从 Props 类型提取
+ */
+export type ExtractPropTypesPartial<T> = Partial<T>;
+/**
+ * 加载配置
+ */
+export interface LoadingConfig {
+    /** 加载文本 */
+    text?: string;
+    /** 文本颜色 */
+    textColor?: string;
+    /** 背景颜色 */
+    background?: string;
+    /** 自定义类名 */
+    customClass?: string;
+    /** 是否显示 */
+    visible?: boolean;
+    /** 目标元素 */
+    target?: HTMLElement | string;
+    /** 加载器尺寸 */
+    size?: ComponentSize;
+}
+/**
+ * Z-Index 管理
+ */
+export interface ZIndex {
+    /** 当前 z-index */
+    current: number;
+    /** 获取下一个 z-index */
+    next: () => number;
+    /** 设置 z-index */
+    set: (zIndex: number) => void;
+}
+/**
+ * 主题配置
+ */
+export interface ThemeConfig {
+    /** 主题模式 */
+    mode: ThemeMode;
+    /** 主色调 */
+    primary: string;
+    /** 成功色 */
+    success: string;
+    /** 警告色 */
+    warning: string;
+    /** 危险色 */
+    danger: string;
+    /** 信息色 */
+    info: string;
+    /** 组件尺寸 */
+    size: ComponentSize;
+}
+/**
+ * 命名空间配置
+ */
+export interface NamespaceConfig {
+    /** 命名空间前缀 */
+    prefix: string;
+    /** 块名称 */
+    block: string;
+    /** BEM 分隔符 */
+    separator: string;
+}
+/**
+ * 标准事件类型
+ */
+export interface EmitType<T = any> {
+    (e: 'update:modelValue', value: T): void;
+    (e: 'change', value: T): void;
+    (e: 'click', event: MouseEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+    (e: 'focus', event: FocusEvent): void;
+}
+/**
+ * 键盘事件处理器
+ */
+export type KeyboardEventHandler = (event: KeyboardEvent) => void;
+/**
+ * 鼠标事件处理器
+ */
+export type MouseEventHandler = (event: MouseEvent) => void;
+/**
+ * 触摸事件处理器
+ */
+export type TouchEventHandler = (event: TouchEvent) => void;
+/**
+ * useNamespace 返回类型
+ */
+export interface NamespaceReturn {
+    /** 命名空间 */
+    namespace: string;
+    /** 前缀 */
+    prefix: string;
+    /** 块类名 */
+    b: (blockSuffix?: string) => string;
+    /** 元素类名 */
+    e: (element: string) => string;
+    /** 修饰符类名 */
+    m: (modifier: string) => string;
+    /** 块-元素类名 */
+    be: (blockSuffix: string, element: string) => string;
+    /** 块-修饰符类名 */
+    bm: (blockSuffix: string, modifier: string) => string;
+    /** 元素-修饰符类名 */
+    em: (element: string, modifier: string) => string;
+    /** 状态类名 */
+    is: (name: string, condition?: boolean) => string;
+}
+/**
+ * useToggle 返回类型
+ */
+export interface UseToggleReturn {
+    /** 当前值 */
+    value: Ref<boolean>;
+    /** 切换值 */
+    toggle: (newValue?: boolean) => void;
+    /** 设置为 true */
+    setTrue: () => void;
+    /** 设置为 false */
+    setFalse: () => void;
+}
+/**
+ * useVisible 返回类型
+ */
+export interface UseVisibleReturn {
+    /** 是否可见 */
+    visible: Ref<boolean>;
+    /** 显示 */
+    show: () => void;
+    /** 隐藏 */
+    hide: () => void;
+    /** 切换 */
+    toggle: () => void;
+}
+/**
+ * useDisabled 返回类型
+ */
+export interface UseDisabledReturn {
+    /** 是否禁用 */
+    disabled: Ref<boolean>;
+    /** 启用 */
+    enable: () => void;
+    /** 禁用 */
+    disable: () => void;
+}
+/**
+ * useLoading 返回类型
+ */
+export interface UseLoadingReturn {
+    /** 是否加载中 */
+    loading: Ref<boolean>;
+    /** 设置加载状态 */
+    setLoading: (val: boolean) => void;
+    /** 开始加载 */
+    start: () => void;
+    /** 结束加载 */
+    end: () => void;
+}
+/**
+ * useFocus 返回类型
+ */
+export interface UseFocusReturn {
+    /** 是否聚焦 */
+    focused: Ref<boolean>;
+}
+/**
+ * 组件尺寸像素映射
+ */
+export type SizeMap = {
+    [K in ComponentSize]: number;
+};

package/es/utils/index.d.ts

@@ -0,0 +1,270 @@
+/**
+ * 工具函数集合
+ * 提供常用的工具函数
+ */
+export * from './namespace';
+export * from './z-index';
+/**
+ * 检查是否为 undefined
+ * @param val 待检查的值
+ * @returns 是否为 undefined
+ */
+export declare const isUndefined: (val: unknown) => val is undefined;
+/**
+ * 检查是否为 null
+ * @param val 待检查的值
+ * @returns 是否为 null
+ */
+export declare const isNull: (val: unknown) => val is null;
+/**
+ * 检查是否为 nil（undefined 或 null）
+ * @param val 待检查的值
+ * @returns 是否为 nil
+ */
+export declare const isNil: (val: unknown) => val is undefined | null;
+/**
+ * 检查是否为真值
+ * @param val 待检查的值
+ * @returns 是否为 true
+ */
+export declare const isTrue: (val: unknown) => boolean;
+/**
+ * 检查是否为假值
+ * @param val 待检查的值
+ * @returns 是否为 false
+ */
+export declare const isFalse: (val: unknown) => boolean;
+/**
+ * 检查是否为空值（空数组、空对象、空字符串、null、undefined）
+ * @param val 待检查的值
+ * @returns 是否为空值
+ */
+export declare const isEmpty: (val: unknown) => boolean;
+/**
+ * 检查是否已定义（非 null 和 undefined）
+ * @param val 待检查的值
+ * @returns 是否已定义
+ */
+export declare const isDefined: <T>(val: T | undefined | null) => val is T;
+/**
+ * 检查是否为数字
+ * @param val 待检查的值
+ * @returns 是否为数字
+ */
+export declare const isNumber: (val: unknown) => val is number;
+/**
+ * 检查是否为字符串
+ * @param val 待检查的值
+ * @returns 是否为字符串
+ */
+export declare const isString: (val: unknown) => val is string;
+/**
+ * 检查是否为布尔值
+ * @param val 待检查的值
+ * @returns 是否为布尔值
+ */
+export declare const isBoolean: (val: unknown) => val is boolean;
+/**
+ * 检查是否为函数
+ * @param val 待检查的值
+ * @returns 是否为函数
+ */
+export declare const isFunction: (val: unknown) => val is (...args: any[]) => any;
+/**
+ * 检查是否为数组
+ * @param val 待检查的值
+ * @returns 是否为数组
+ */
+export declare const isArray: (arg: any) => arg is any[];
+/**
+ * 检查是否为对象
+ * @param val 待检查的值
+ * @returns 是否为对象
+ */
+export declare const isObject: (val: unknown) => val is Record<string, any>;
+/**
+ * 检查是否为纯对象
+ * @param val 待检查的值
+ * @returns 是否为纯对象
+ */
+export declare const isPlainObject: (val: unknown) => val is Record<string, any>;
+/**
+ * 检查是否为 Promise
+ * @param val 待检查的值
+ * @returns 是否为 Promise
+ */
+export declare const isPromise: <T = any>(val: unknown) => val is Promise<T>;
+/**
+ * 检查是否为日期
+ * @param val 待检查的值
+ * @returns 是否为日期
+ */
+export declare const isDate: (val: unknown) => val is Date;
+/**
+ * 检查是否为正则表达式
+ * @param val 待检查的值
+ * @returns 是否为正则表达式
+ */
+export declare const isRegExp: (val: unknown) => val is RegExp;
+/**
+ * 获取值的类型
+ * @param val 待检查的值
+ * @returns 类型字符串
+ */
+export declare const getType: (val: unknown) => string;
+/**
+ * 检查值是否为指定类型
+ * @param val 待检查的值
+ * @param type 类型名称
+ * @returns 是否为指定类型
+ */
+export declare const isType: <T>(val: unknown, type: string) => val is T;
+/**
+ * 一元函数包装器
+ * @param fn 函数
+ * @returns 只接受一个参数的函数
+ */
+export declare const unary: <T>(fn: (arg: T) => any) => (arg: T) => any;
+/**
+ * 常量函数
+ * @param val 常量值
+ * @returns 返回常量值的函数
+ */
+export declare const constant: <T>(val: T) => () => T;
+/**
+ * 默认值
+ * @param val 待检查的值
+ * @param defaultVal 默认值
+ * @returns 值或默认值
+ */
+export declare const defaultTo: <T, D>(val: T | undefined | null, defaultVal: D) => T | D;
+/**
+ * 空操作函数
+ */
+export declare const noop: () => void;
+/**
+ * 恒等函数
+ * @param val 值
+ * @returns 相同的值
+ */
+export declare const identity: <T>(val: T) => T;
+/**
+ * 组合函数（从右到左执行）
+ * @param fns 函数列表
+ * @returns 组合后的函数
+ */
+export declare const compose: <T>(...fns: ((arg: any) => any)[]) => (val: T) => T;
+/**
+ * 管道函数（从左到右执行）
+ * @param fns 函数列表
+ * @returns 管道后的函数
+ */
+export declare const pipe: <T>(...fns: ((arg: any) => any)[]) => (val: T) => T;
+/**
+ * 只执行一次的函数
+ * @param fn 函数
+ * @returns 只执行一次的函数
+ */
+export declare const once: <T extends (...args: any[]) => any>(fn: T) => T;
+/**
+ * 尝试执行函数
+ * @param fn 要执行的函数
+ * @param onError 错误处理函数
+ * @returns 结果或错误处理结果
+ */
+export declare const tryCatch: <T>(fn: () => T, onError?: (error: any) => T) => T;
+/**
+ * 强制转换为数组
+ * @param val 值或数组
+ * @returns 数组
+ */
+export declare const coerceToArray: <T>(val: T | T[]) => T[];
+/**
+ * 数组去重
+ * @param arr 数组
+ * @returns 去重后的数组
+ */
+export declare const unique: <T>(arr: T[]) => T[];
+/**
+ * 数组扁平化
+ * @param arr 嵌套数组
+ * @returns 扁平化后的数组
+ */
+export declare const flatten: <T>(arr: (T | T[])[]) => T[];
+/**
+ * 深度合并对象
+ * @param target 目标对象
+ * @param sources 源对象列表
+ * @returns 合并后的对象
+ */
+export declare const deepMerge: <T extends Record<string, any>>(target: T, ...sources: Partial<T>[]) => T;
+/**
+ * 深度克隆
+ * @param val 待克隆的值
+ * @returns 克隆后的值
+ */
+export declare const deepClone: <T>(val: T) => T;
+/**
+ * 获取嵌套属性值
+ * @param obj 对象
+ * @param path 路径
+ * @param defaultValue 默认值
+ * @returns 属性值
+ */
+export declare const get: <T = any>(obj: Record<string, any>, path: string | string[], defaultValue?: T) => T;
+/**
+ * 设置嵌套属性值
+ * @param obj 对象
+ * @param path 路径
+ * @param value 值
+ */
+export declare const set: (obj: Record<string, any>, path: string | string[], value: any) => void;
+/**
+ * 防抖函数
+ * @param fn 要防抖的函数
+ * @param delay 延迟时间（毫秒）
+ * @returns 防抖后的函数
+ */
+export declare const debounce: <T extends (...args: any[]) => any>(fn: T, delay?: number) => ((...args: Parameters<T>) => void);
+/**
+ * 节流函数
+ * @param fn 要节流的函数
+ * @param delay 延迟时间（毫秒）
+ * @returns 节流后的函数
+ */
+export declare const throttle: <T extends (...args: any[]) => any>(fn: T, delay?: number) => ((...args: Parameters<T>) => void);
+/**
+ * 是否为浏览器环境
+ */
+export declare const isBrowser: boolean;
+/**
+ * 是否支持触摸
+ */
+export declare const isSupportTouch: boolean;
+/**
+ * 是否为移动端
+ */
+export declare const isMobile: boolean;
+/**
+ * 是否为 iOS
+ */
+export declare const isIOS: boolean;
+/**
+ * 是否为 Android
+ */
+export declare const isAndroid: boolean;
+/**
+ * 是否为微信
+ */
+export declare const isWechat: boolean;
+/**
+ * 生成 UUID
+ * @returns UUID 字符串
+ */
+export declare const uuid: () => string;
+/**
+ * 生成短 ID
+ * @param length ID 长度
+ * @returns 短 ID 字符串
+ */
+export declare const shortId: (length?: number) => string;