@xto/core 1.1.0 → 1.2.1

package/es/hooks/index.d.ts

@@ -0,0 +1,248 @@
+import { Ref, ComputedRef } from 'vue';
+import { UseToggleReturn, UseVisibleReturn, UseDisabledReturn, UseLoadingReturn, UseFocusReturn } from '../types';
+/**
+ * 布尔值切换 Hook
+ *
+ * @param defaultValue 默认值，默认为 false
+ * @returns 切换工具对象
+ *
+ * @example
+ * ```ts
+ * const { value, toggle, setTrue, setFalse } = useToggle()
+ *
+ * console.log(value.value) // false
+ * toggle() // 切换为 true
+ * setFalse() // 设置为 false
+ * setTrue() // 设置为 true
+ * ```
+ */
+export declare function useToggle(defaultValue?: boolean): UseToggleReturn;
+/**
+ * 双向绑定 Hook
+ * 用于实现 v-model 双向绑定
+ *
+ * @param props 组件 props
+ * @param emit emit 函数
+ * @param key 绑定的 prop 名称，默认为 'modelValue'
+ * @param defaultValue 默认值
+ * @returns 响应式计算属性
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * const props = defineProps<{ modelValue?: string }>()
+ * const emit = defineEmits<{ 'update:modelValue': [value: string] }>()
+ *
+ * const value = useModel(props, emit)
+ * </script>
+ *
+ * <template>
+ *   <input v-model="value" />
+ * </template>
+ * ```
+ */
+export declare function useModel<T>(props: Record<string, any>, emit: (event: string, value: any) => void, key?: string, defaultValue?: T): ComputedRef<T>;
+/**
+ * 可见性控制 Hook
+ * 用于控制元素的显示/隐藏
+ *
+ * @param defaultVisible 默认可见状态，默认为 false
+ * @returns 可见性控制对象
+ *
+ * @example
+ * ```ts
+ * const { visible, show, hide, toggle } = useVisible()
+ *
+ * show() // 显示
+ * hide() // 隐藏
+ * toggle() // 切换
+ * ```
+ */
+export declare function useVisible(defaultVisible?: boolean): UseVisibleReturn;
+/**
+ * 禁用状态控制 Hook
+ * 用于控制元素的禁用/启用状态
+ *
+ * @param defaultDisabled 默认禁用状态，默认为 false
+ * @returns 禁用控制对象
+ *
+ * @example
+ * ```ts
+ * const { disabled, enable, disable } = useDisabled()
+ *
+ * disable() // 禁用
+ * enable() // 启用
+ * ```
+ */
+export declare function useDisabled(defaultDisabled?: boolean): UseDisabledReturn;
+/**
+ * 加载状态控制 Hook
+ * 用于控制加载状态
+ *
+ * @param defaultLoading 默认加载状态，默认为 false
+ * @returns 加载控制对象
+ *
+ * @example
+ * ```ts
+ * const { loading, setLoading, start, end } = useLoading()
+ *
+ * start() // 开始加载
+ * end() // 结束加载
+ * setLoading(true) // 设置加载状态
+ * ```
+ */
+export declare function useLoading(defaultLoading?: boolean): UseLoadingReturn;
+/**
+ * 点击外部检测 Hook
+ * 当点击目标元素外部时触发回调
+ *
+ * @param target 目标元素 Ref
+ * @param callback 点击外部时的回调函数
+ *
+ * @example
+ * ```ts
+ * const dropdownRef = ref<HTMLElement>()
+ *
+ * useClickOutside(dropdownRef, () => {
+ *   // 点击外部，关闭下拉菜单
+ *   closeDropdown()
+ * })
+ * ```
+ */
+export declare function useClickOutside(target: Ref<HTMLElement | undefined>, callback: () => void): void;
+/**
+ * ESC 键检测 Hook
+ * 当按下 ESC 键时触发回调
+ *
+ * @param callback 按下 ESC 时的回调函数
+ *
+ * @example
+ * ```ts
+ * useEscape(() => {
+ *   // 按下 ESC，关闭模态框
+ *   closeModal()
+ * })
+ * ```
+ */
+export declare function useEscape(callback: () => void): void;
+/**
+ * 元素尺寸变化监听 Hook
+ * 当目标元素尺寸变化时触发回调
+ *
+ * @param target 目标元素 Ref
+ * @param callback 尺寸变化时的回调函数
+ *
+ * @example
+ * ```ts
+ * const containerRef = ref<HTMLElement>()
+ *
+ * useResize(containerRef, (width, height) => {
+ *   console.log('尺寸变化:', width, height)
+ * })
+ * ```
+ */
+export declare function useResize(target: Ref<HTMLElement | undefined>, callback: (width: number, height: number) => void): void;
+/**
+ * DOM 变化监听 Hook
+ * 当目标 DOM 发生变化时触发回调
+ *
+ * @param target 目标元素 Ref
+ * @param options MutationObserver 配置选项
+ * @param callback DOM 变化时的回调函数
+ *
+ * @example
+ * ```ts
+ * const containerRef = ref<HTMLElement>()
+ *
+ * useDOMObserver(
+ *   containerRef,
+ *   { childList: true },
+ *   (mutations) => {
+ *     console.log('DOM 变化:', mutations)
+ *   }
+ * )
+ * ```
+ */
+export declare function useDOMObserver(target: Ref<HTMLElement | undefined>, options: MutationObserverInit | undefined, callback: (mutations: MutationRecord[]) => void): void;
+/**
+ * 滚动监听 Hook
+ * 当目标元素滚动时触发回调
+ *
+ * @param target 目标元素 Ref
+ * @param callback 滚动时的回调函数
+ *
+ * @example
+ * ```ts
+ * const containerRef = ref<HTMLElement>()
+ *
+ * useScroll(containerRef, (scrollTop, scrollLeft) => {
+ *   console.log('滚动位置:', scrollTop, scrollLeft)
+ * })
+ * ```
+ */
+export declare function useScroll(target: Ref<HTMLElement | undefined | Window>, callback: (scrollTop: number, scrollLeft: number) => void): void;
+/**
+ * 焦点控制 Hook
+ * 监听元素的焦点状态
+ *
+ * @param target 目标元素 Ref
+ * @param callback 焦点变化时的回调函数（可选）
+ * @returns 焦点状态对象
+ *
+ * @example
+ * ```ts
+ * const inputRef = ref<HTMLElement>()
+ * const { focused } = useFocus(inputRef)
+ *
+ * watch(focused, (isFocused) => {
+ *   console.log('焦点状态:', isFocused)
+ * })
+ * ```
+ */
+export declare function useFocus(target: Ref<HTMLElement | undefined>, callback?: (focused: boolean) => void): UseFocusReturn;
+/**
+ * 交叉观察器 Hook
+ * 监听元素是否进入视口
+ *
+ * @param target 目标元素 Ref
+ * @param callback 交叉状态变化时的回调函数
+ * @param options IntersectionObserver 配置选项
+ *
+ * @example
+ * ```ts
+ * const elementRef = ref<HTMLElement>()
+ *
+ * useIntersectionObserver(
+ *   elementRef,
+ *   (isIntersecting) => {
+ *     if (isIntersecting) {
+ *       console.log('元素进入视口')
+ *     }
+ *   },
+ *   { threshold: 0.5 }
+ * )
+ * ```
+ */
+export declare function useIntersectionObserver(target: Ref<HTMLElement | undefined>, callback: (isIntersecting: boolean) => void, options?: IntersectionObserverInit): void;
+/**
+ * 延迟动作 Hook
+ * 延迟执行某个动作，可取消
+ *
+ * @param delay 延迟时间（毫秒）
+ * @returns 延迟控制对象
+ *
+ * @example
+ * ```ts
+ * const { execute, cancel } = useDelayedAction(300)
+ *
+ * execute(() => {
+ *   console.log('延迟执行')
+ * })
+ *
+ * cancel() // 取消执行
+ * ```
+ */
+export declare function useDelayedAction(delay?: number): {
+    execute: (callback: () => void) => void;
+    cancel: () => void;
+};

package/es/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @xto/core
+ * XTO UI 核心模块
+ * 提供类型定义、工具函数、组合式函数、主题配置和国际化
+ */
+export * from './types';
+export * from './theme';
+export * from './utils';
+export * from './hooks';
+export * from './locale';
+export declare const version = "1.0.0";

package/es/index.mjs

@@ -1,48 +1,51 @@
-import { applyCSSVars as n, applyDarkTheme as t, cssVarPrefix as i, darkCSSVars as r, defaultThemeConfig as a, generateCSSVars as d, generateColorPalette as x, getComponentSize as l, hexToRgb as p, mixColor as u, removeCSSVars as c, removeDarkTheme as m, rgbToHex as I, sizeMap as g } from "./theme/index.mjs";
-import { b as C, block as S, classNames as b, coerceToArray as f, compose as T, constant as y, createNamespace as h, debounce as D, deepClone as M, deepMerge as v, defaultNamespace as N, defaultTo as O, drawerZIndex as P, dropdownZIndex as V, e as k, element as w, flatten as A, get as z, getCurrentZIndex as E, getType as F, getZIndexList as L, identity as R, is as j, isAndroid as B, isArray as q, isBoolean as H, isBrowser as U, isDate as W, isDefined as G, isEmpty as J, isFalse as K, isFunction as Q, isIOS as X, isMobile as Y, isNil as _, isNull as $, isNumber as ee, isObject as se, isPlainObject as oe, isPromise as ne, isRegExp as te, isString as ie, isSupportTouch as re, isTrue as ae, isType as de, isUndefined as xe, isWechat as le, loadingZIndex as pe, m as ue, messageZIndex as ce, modalZIndex as me, modifier as Ie, nextDrawerZIndex as ge, nextDropdownZIndex as Ze, nextLoadingZIndex as Ce, nextMessageZIndex as Se, nextModalZIndex as be, nextPopoverZIndex as fe, nextSelectZIndex as Te, nextTooltipZIndex as ye, noop as he, once as De, pipe as Me, popoverZIndex as ve, popupManage as Ne, resetZIndex as Oe, selectZIndex as Pe, set as Ve, shortId as ke, state as we, throttle as Ae, tooltipZIndex as ze, tryCatch as Ee, unary as Fe, unique as Le, useClass as Re, useComponentPrefix as je, useNamespace as Be, useZIndex as qe, uuid as He } from "./utils/index.mjs";
-import { useClickOutside as We, useDOMObserver as Ge, useDelayedAction as Je, useDisabled as Ke, useEscape as Qe, useFocus as Xe, useIntersectionObserver as Ye, useLoading as _e, useModel as $e, useResize as es, useScroll as ss, useToggle as os, useVisible as ns } from "./hooks/index.mjs";
+import { applyCSSVars as n, applyDarkTheme as t, cssVarPrefix as r, darkCSSVars as i, defaultThemeConfig as a, generateCSSVars as d, generateColorPalette as l, getComponentSize as p, hexToRgb as x, mixColor as u, removeCSSVars as c, removeDarkTheme as m, rgbToHex as I, sizeMap as g } from "./theme/index.mjs";
+import { b as S, block as f, classNames as C, coerceToArray as b, compose as T, constant as y, createNamespace as h, debounce as D, deepClone as v, deepMerge as M, defaultNamespace as N, defaultTo as O, drawerZIndex as P, dropdownZIndex as L, e as V, element as k, flatten as w, get as A, getCurrentZIndex as j, getType as z, getZIndexList as E, identity as F, is as R, isAndroid as B, isArray as q, isBoolean as H, isBrowser as K, isDate as U, isDefined as W, isEmpty as G, isFalse as J, isFunction as Q, isIOS as X, isMobile as Y, isNil as _, isNull as $, isNumber as ee, isObject as se, isPlainObject as oe, isPromise as ne, isRegExp as te, isString as re, isSupportTouch as ie, isTrue as ae, isType as de, isUndefined as le, isWechat as pe, loadingZIndex as xe, m as ue, messageZIndex as ce, modalZIndex as me, modifier as Ie, nextDrawerZIndex as ge, nextDropdownZIndex as Ze, nextLoadingZIndex as Se, nextMessageZIndex as fe, nextModalZIndex as Ce, nextPopoverZIndex as be, nextSelectZIndex as Te, nextTooltipZIndex as ye, noop as he, once as De, pipe as ve, popoverZIndex as Me, popupManage as Ne, resetZIndex as Oe, selectZIndex as Pe, set as Le, shortId as Ve, state as ke, throttle as we, tooltipZIndex as Ae, tryCatch as je, unary as ze, unique as Ee, useClass as Fe, useComponentPrefix as Re, useNamespace as Be, useZIndex as qe, uuid as He } from "./utils/index.mjs";
+import { useClickOutside as Ue, useDOMObserver as We, useDelayedAction as Ge, useDisabled as Je, useEscape as Qe, useFocus as Xe, useIntersectionObserver as Ye, useLoading as _e, useModel as $e, useResize as es, useScroll as ss, useToggle as os, useVisible as ns } from "./hooks/index.mjs";
+import { createLocaleProvider as rs, getSupportedLocales as is, localeInjectionKey as as, localeNames as ds, locales as ls, useLocale as ps } from "./locale/index.mjs";
 const e = "1.0.0";
 export {
   n as applyCSSVars,
   t as applyDarkTheme,
-  C as b,
-  S as block,
-  b as classNames,
-  f as coerceToArray,
+  S as b,
+  f as block,
+  C as classNames,
+  b as coerceToArray,
   T as compose,
   y as constant,
+  rs as createLocaleProvider,
   h as createNamespace,
-  i as cssVarPrefix,
-  r as darkCSSVars,
+  r as cssVarPrefix,
+  i as darkCSSVars,
   D as debounce,
-  M as deepClone,
-  v as deepMerge,
+  v as deepClone,
+  M as deepMerge,
   N as defaultNamespace,
   a as defaultThemeConfig,
   O as defaultTo,
   P as drawerZIndex,
-  V as dropdownZIndex,
-  k as e,
-  w as element,
-  A as flatten,
+  L as dropdownZIndex,
+  V as e,
+  k as element,
+  w as flatten,
   d as generateCSSVars,
-  x as generateColorPalette,
-  z as get,
-  l as getComponentSize,
-  E as getCurrentZIndex,
-  F as getType,
-  L as getZIndexList,
-  p as hexToRgb,
-  R as identity,
-  j as is,
+  l as generateColorPalette,
+  A as get,
+  p as getComponentSize,
+  j as getCurrentZIndex,
+  is as getSupportedLocales,
+  z as getType,
+  E as getZIndexList,
+  x as hexToRgb,
+  F as identity,
+  R as is,
   B as isAndroid,
   q as isArray,
   H as isBoolean,
-  U as isBrowser,
-  W as isDate,
-  G as isDefined,
-  J as isEmpty,
-  K as isFalse,
+  K as isBrowser,
+  U as isDate,
+  W as isDefined,
+  G as isEmpty,
+  J as isFalse,
   Q as isFunction,
   X as isIOS,
   Y as isMobile,
@@ -53,13 +56,16 @@ export {
   oe as isPlainObject,
   ne as isPromise,
   te as isRegExp,
-  ie as isString,
-  re as isSupportTouch,
+  re as isString,
+  ie as isSupportTouch,
   ae as isTrue,
   de as isType,
-  xe as isUndefined,
-  le as isWechat,
-  pe as loadingZIndex,
+  le as isUndefined,
+  pe as isWechat,
+  xe as loadingZIndex,
+  as as localeInjectionKey,
+  ds as localeNames,
+  ls as locales,
   ue as m,
   ce as messageZIndex,
   u as mixColor,
@@ -67,41 +73,42 @@ export {
   Ie as modifier,
   ge as nextDrawerZIndex,
   Ze as nextDropdownZIndex,
-  Ce as nextLoadingZIndex,
-  Se as nextMessageZIndex,
-  be as nextModalZIndex,
-  fe as nextPopoverZIndex,
+  Se as nextLoadingZIndex,
+  fe as nextMessageZIndex,
+  Ce as nextModalZIndex,
+  be as nextPopoverZIndex,
   Te as nextSelectZIndex,
   ye as nextTooltipZIndex,
   he as noop,
   De as once,
-  Me as pipe,
-  ve as popoverZIndex,
+  ve as pipe,
+  Me as popoverZIndex,
   Ne as popupManage,
   c as removeCSSVars,
   m as removeDarkTheme,
   Oe as resetZIndex,
   I as rgbToHex,
   Pe as selectZIndex,
-  Ve as set,
-  ke as shortId,
+  Le as set,
+  Ve as shortId,
   g as sizeMap,
-  we as state,
-  Ae as throttle,
-  ze as tooltipZIndex,
-  Ee as tryCatch,
-  Fe as unary,
-  Le as unique,
-  Re as useClass,
-  We as useClickOutside,
-  je as useComponentPrefix,
-  Ge as useDOMObserver,
-  Je as useDelayedAction,
-  Ke as useDisabled,
+  ke as state,
+  we as throttle,
+  Ae as tooltipZIndex,
+  je as tryCatch,
+  ze as unary,
+  Ee as unique,
+  Fe as useClass,
+  Ue as useClickOutside,
+  Re as useComponentPrefix,
+  We as useDOMObserver,
+  Ge as useDelayedAction,
+  Je as useDisabled,
   Qe as useEscape,
   Xe as useFocus,
   Ye as useIntersectionObserver,
   _e as useLoading,
+  ps as useLocale,
   $e as useModel,
   Be as useNamespace,
   es as useResize,

package/es/locale/index.d.ts

@@ -0,0 +1,30 @@
+import { Ref, InjectionKey } from 'vue';
+import { LocaleCode, LocaleMessages, UseLocaleReturn } from './types';
+declare const locales: Record<LocaleCode, LocaleMessages>;
+export declare const localeNames: Record<LocaleCode, string>;
+export declare const localeInjectionKey: InjectionKey<{
+    locale: Ref<LocaleCode>;
+    messages: Ref<LocaleMessages>;
+}>;
+/**
+ * 国际化组合式函数
+ */
+export declare function useLocale(): UseLocaleReturn;
+/**
+ * 获取所有支持的语言
+ */
+export declare function getSupportedLocales(): {
+    code: LocaleCode;
+    name: string;
+}[];
+/**
+ * 创建国际化提供者
+ */
+export declare function createLocaleProvider(initialLocale?: LocaleCode): {
+    locale: Ref<LocaleCode, LocaleCode>;
+    messages: Ref<LocaleMessages, LocaleMessages>;
+    setLocale: (code: LocaleCode) => void;
+    mergeMessages: (newMessages: LocaleMessages) => void;
+    install(app: any): void;
+};
+export { locales };