@yh-ui/hooks 0.1.0

package/dist/use-event-listener/index.cjs

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useEventListener = useEventListener;
+var _vue = require("vue");
+function useEventListener(target, event, handler, options) {
+  if (typeof window === "undefined") return;
+  const getTarget = () => {
+    if (typeof target === "function") {
+      return target();
+    }
+    return (0, _vue.unref)(target);
+  };
+  const add = () => {
+    const el = getTarget();
+    if (el) {
+      el.addEventListener(event, handler, options);
+    }
+  };
+  const remove = () => {
+    const el = getTarget();
+    if (el) {
+      el.removeEventListener(event, handler, options);
+    }
+  };
+  (0, _vue.onMounted)(add);
+  (0, _vue.onBeforeUnmount)(remove);
+  if ((0, _vue.isRef)(target)) {
+    (0, _vue.watch)(target, (newVal, oldVal) => {
+      if (oldVal) {
+        oldVal.removeEventListener(event, handler, options);
+      }
+      if (newVal) {
+        newVal.addEventListener(event, handler, options);
+      }
+    });
+  }
+}

package/dist/use-event-listener/index.d.ts

@@ -0,0 +1,2 @@
+import type { MaybeRef } from 'vue';
+export declare function useEventListener(target: MaybeRef<EventTarget | null | undefined> | (() => EventTarget | null | undefined), event: string, handler: (e: Event) => void, options?: boolean | AddEventListenerOptions): void;

package/dist/use-event-listener/index.mjs

@@ -0,0 +1,34 @@
+import { onMounted, onBeforeUnmount, isRef, watch, unref } from "vue";
+export function useEventListener(target, event, handler, options) {
+  if (typeof window === "undefined") return;
+  const getTarget = () => {
+    if (typeof target === "function") {
+      return target();
+    }
+    return unref(target);
+  };
+  const add = () => {
+    const el = getTarget();
+    if (el) {
+      el.addEventListener(event, handler, options);
+    }
+  };
+  const remove = () => {
+    const el = getTarget();
+    if (el) {
+      el.removeEventListener(event, handler, options);
+    }
+  };
+  onMounted(add);
+  onBeforeUnmount(remove);
+  if (isRef(target)) {
+    watch(target, (newVal, oldVal) => {
+      if (oldVal) {
+        oldVal.removeEventListener(event, handler, options);
+      }
+      if (newVal) {
+        newVal.addEventListener(event, handler, options);
+      }
+    });
+  }
+}

package/dist/use-form-item/index.cjs

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useFormItem = exports.FormItemContextKey = exports.FormContextKey = void 0;
+var _vue = require("vue");
+const FormContextKey = exports.FormContextKey = Symbol("FormContextKey");
+const FormItemContextKey = exports.FormItemContextKey = Symbol("FormItemContextKey");
+const useFormItem = () => {
+  const form = (0, _vue.inject)(FormContextKey, void 0);
+  const formItem = (0, _vue.inject)(FormItemContextKey, void 0);
+  return {
+    form,
+    formItem,
+    // 触发校验
+    validate: trigger => {
+      if (formItem) {
+        return formItem.validate(trigger).catch(() => {
+          return false;
+        });
+      }
+      return Promise.resolve(true);
+    }
+  };
+};
+exports.useFormItem = useFormItem;

package/dist/use-form-item/index.d.ts

@@ -0,0 +1,43 @@
+import type { InjectionKey } from 'vue';
+export interface FormContext {
+    model: Record<string, unknown>;
+    rules?: Record<string, unknown>;
+    labelWidth?: string | number;
+    labelPosition?: string;
+    labelSuffix?: string;
+    showMessage?: boolean;
+    scrollToError?: boolean;
+    scrollIntoViewOptions?: boolean | ScrollIntoViewOptions;
+    disabled?: boolean;
+    size?: string;
+    statusIcon?: boolean;
+    layout?: string;
+    addField: (field: FormItemContext) => void;
+    removeField: (field: FormItemContext) => void;
+    themeOverrides?: Record<string, unknown>;
+}
+export interface FormItemContext {
+    prop: string;
+    validate: (trigger: string, callback?: (isValid: boolean) => void) => Promise<boolean | unknown>;
+    resetField: () => void;
+    clearValidate: () => void;
+    validateStatus: string;
+    validateMessage: string;
+    label: string;
+    errorId?: string;
+    inputId?: string;
+    size?: string;
+    disabled?: boolean;
+}
+export declare const FormContextKey: InjectionKey<FormContext>;
+export declare const FormItemContextKey: InjectionKey<FormItemContext>;
+/**
+ * useFormItem - 供组件内部使用的 Hook
+ * @description 获取表单项上下文。已优化内部触发校验逻辑，防止 Promise 拒绝导致控制台报错。
+ */
+export declare const useFormItem: () => {
+    form: FormContext | undefined;
+    formItem: FormItemContext | undefined;
+    validate: (trigger: string) => Promise<boolean | unknown>;
+};
+export type UseFormItemReturn = ReturnType<typeof useFormItem>;

package/dist/use-form-item/index.mjs

@@ -0,0 +1,20 @@
+import { inject } from "vue";
+export const FormContextKey = Symbol("FormContextKey");
+export const FormItemContextKey = Symbol("FormItemContextKey");
+export const useFormItem = () => {
+  const form = inject(FormContextKey, void 0);
+  const formItem = inject(FormItemContextKey, void 0);
+  return {
+    form,
+    formItem,
+    // 触发校验
+    validate: (trigger) => {
+      if (formItem) {
+        return formItem.validate(trigger).catch(() => {
+          return false;
+        });
+      }
+      return Promise.resolve(true);
+    }
+  };
+};

package/dist/use-id/index.cjs

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useIdInjection = exports.useId = exports.idInjectionKey = void 0;
+var _vue = require("vue");
+const idInjectionKey = exports.idInjectionKey = Symbol("idInjectionKey");
+const useId = idOverrides => {
+  const injectedId = (0, _vue.inject)(idInjectionKey, void 0);
+  const nativeId = (0, _vue.useId)();
+  const id = (0, _vue.computed)(() => {
+    const override = (0, _vue.unref)(idOverrides);
+    if (override) return override;
+    const injected = (0, _vue.unref)(injectedId);
+    if (injected) return injected;
+    return nativeId;
+  });
+  return id;
+};
+exports.useId = useId;
+const useIdInjection = () => {
+  return {
+    prefix: (0, _vue.computed)(() => `yh-${Date.now()}`),
+    current: 0
+    // No longer using counter
+  };
+};
+exports.useIdInjection = useIdInjection;

package/dist/use-id/index.d.ts

@@ -0,0 +1,21 @@
+import type { InjectionKey, Ref } from 'vue';
+export declare const idInjectionKey: InjectionKey<Ref<string | undefined>>;
+/**
+ * useId - 生成唯一 ID
+ * @param idOverrides - 可选的自定义 ID 前缀
+ * @returns 唯一 ID
+ *
+ * @example
+ * const id = useId() // 'yh-id-1' (or vue native id)
+ * const customId = useId(ref('custom')) // 'custom'
+ */
+export declare const useId: (idOverrides?: Ref<string | undefined>) => Ref<string>;
+/**
+ * useIdInjection - ID 注入工具
+ * @description 用于组件内部生成关联 ID
+ */
+export declare const useIdInjection: () => {
+    prefix: import("vue").ComputedRef<string>;
+    current: number;
+};
+export type UseIdReturn = ReturnType<typeof useId>;

package/dist/use-id/index.mjs

@@ -0,0 +1,21 @@
+import { computed, inject, unref, useId as useVueId } from "vue";
+export const idInjectionKey = Symbol("idInjectionKey");
+export const useId = (idOverrides) => {
+  const injectedId = inject(idInjectionKey, void 0);
+  const nativeId = useVueId();
+  const id = computed(() => {
+    const override = unref(idOverrides);
+    if (override) return override;
+    const injected = unref(injectedId);
+    if (injected) return injected;
+    return nativeId;
+  });
+  return id;
+};
+export const useIdInjection = () => {
+  return {
+    prefix: computed(() => `yh-${Date.now()}`),
+    current: 0
+    // No longer using counter
+  };
+};

package/dist/use-locale/dayjs-locale.cjs

@@ -0,0 +1,129 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.updateDayjsMonths = exports.setDayjsLocaleSync = exports.setDayjsLocale = exports.getDayjsLocale = void 0;
+var _dayjs = _interopRequireWildcard(require("dayjs"));
+require("dayjs/locale/en");
+require("dayjs/locale/zh-cn");
+require("dayjs/locale/zh-tw");
+require("dayjs/locale/ja");
+require("dayjs/locale/ko");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+const dayjs = _dayjs.default || _dayjs;
+const loadedLocales = /* @__PURE__ */new Set(["en", "zh-cn", "zh-tw", "ja", "ko"]);
+const localeMapping = {
+  "zh-cn": "zh-cn",
+  "zh-tw": "zh-tw",
+  "zh-hk": "zh-hk",
+  "zh-mo": "zh-tw",
+  // 澳门使用繁体
+  en: "en",
+  ja: "ja",
+  ko: "ko",
+  de: "de",
+  fr: "fr",
+  es: "es",
+  pt: "pt",
+  "pt-br": "pt-br",
+  ru: "ru",
+  ar: "ar",
+  "ar-eg": "ar",
+  tr: "tr",
+  it: "it",
+  nl: "nl",
+  pl: "pl",
+  th: "th",
+  vi: "vi",
+  id: "id",
+  ms: "ms",
+  da: "da",
+  sv: "sv",
+  fi: "fi",
+  no: "nb",
+  "nb-NO": "nb",
+  cs: "cs",
+  sk: "sk",
+  uk: "uk",
+  hu: "hu",
+  ro: "ro",
+  bg: "bg",
+  az: "az",
+  fa: "fa",
+  hi: "hi",
+  pa: "pa-in",
+  el: "el",
+  ca: "ca",
+  tk: "tk",
+  ta: "ta",
+  lv: "lv",
+  af: "af",
+  et: "et",
+  sl: "sl",
+  he: "he",
+  lo: "lo",
+  lt: "lt",
+  mn: "mn",
+  kk: "kk",
+  ku: "ku",
+  ckb: "ku",
+  "ug-cn": "ug-cn",
+  km: "km",
+  sr: "sr",
+  eu: "eu",
+  ky: "ky",
+  "hy-am": "hy-am",
+  hr: "hr",
+  eo: "eo",
+  bn: "bn",
+  mg: "mg",
+  sw: "sw",
+  "uz-uz": "uz",
+  my: "my",
+  te: "te"
+};
+const getDayjsLocale = localeCode => {
+  return localeMapping[localeCode] || "en";
+};
+exports.getDayjsLocale = getDayjsLocale;
+const setDayjsLocale = async localeCode => {
+  const dayjsLocale = getDayjsLocale(localeCode);
+  if (loadedLocales.has(dayjsLocale)) {
+    dayjs.locale(dayjsLocale);
+    return;
+  }
+  try {
+    await Promise.resolve(`../../../../node_modules/dayjs/locale/${dayjsLocale}.js`).then(s => require(s));
+    loadedLocales.add(dayjsLocale);
+    dayjs.locale(dayjsLocale);
+  } catch {
+    console.warn(`[yh-ui] Failed to load dayjs locale: ${dayjsLocale}, falling back to 'en'`);
+    dayjs.locale("en");
+  }
+};
+exports.setDayjsLocale = setDayjsLocale;
+const setDayjsLocaleSync = localeCode => {
+  const dayjsLocale = getDayjsLocale(localeCode);
+  if (loadedLocales.has(dayjsLocale)) {
+    dayjs.locale(dayjsLocale);
+  } else {
+    dayjs.locale("en");
+    setDayjsLocale(localeCode);
+  }
+};
+exports.setDayjsLocaleSync = setDayjsLocaleSync;
+const updateDayjsMonths = (localeCode, months) => {
+  const dayjsLocale = getDayjsLocale(localeCode);
+  const monthsArray = [months.jan, months.feb, months.mar, months.apr, months.may, months.jun, months.jul, months.aug, months.sep, months.oct, months.nov, months.dec];
+  try {
+    if (dayjs.updateLocale) {
+      dayjs.updateLocale(dayjsLocale, {
+        months: monthsArray,
+        monthsShort: monthsArray
+      });
+    }
+  } catch {}
+};
+exports.updateDayjsMonths = updateDayjsMonths;

package/dist/use-locale/dayjs-locale.d.ts

@@ -0,0 +1,37 @@
+import 'dayjs/locale/en';
+import 'dayjs/locale/zh-cn';
+import 'dayjs/locale/zh-tw';
+import 'dayjs/locale/ja';
+import 'dayjs/locale/ko';
+/**
+ * 获取 dayjs locale code
+ */
+export declare const getDayjsLocale: (localeCode: string) => string;
+/**
+ * 动态加载并设置 dayjs locale
+ * 使用动态导入来按需加载，避免打包所有语言
+ */
+export declare const setDayjsLocale: (localeCode: string) => Promise<void>;
+/**
+ * 同步设置 dayjs locale（不推荐，会阻塞）
+ * 用于需要立即同步的场景
+ */
+export declare const setDayjsLocaleSync: (localeCode: string) => void;
+/**
+ * 使用自定义月份名称更新 dayjs locale
+ * 这样可以确保 dayjs 使用我们语言包中定义的月份名称
+ */
+export declare const updateDayjsMonths: (localeCode: string, months: {
+    jan: string;
+    feb: string;
+    mar: string;
+    apr: string;
+    may: string;
+    jun: string;
+    jul: string;
+    aug: string;
+    sep: string;
+    oct: string;
+    nov: string;
+    dec: string;
+}) => void;

package/dist/use-locale/dayjs-locale.mjs

@@ -0,0 +1,131 @@
+import * as _dayjs from "dayjs";
+const dayjs = _dayjs.default || _dayjs;
+import "dayjs/locale/en";
+import "dayjs/locale/zh-cn";
+import "dayjs/locale/zh-tw";
+import "dayjs/locale/ja";
+import "dayjs/locale/ko";
+const loadedLocales = /* @__PURE__ */ new Set(["en", "zh-cn", "zh-tw", "ja", "ko"]);
+const localeMapping = {
+  "zh-cn": "zh-cn",
+  "zh-tw": "zh-tw",
+  "zh-hk": "zh-hk",
+  "zh-mo": "zh-tw",
+  // 澳门使用繁体
+  en: "en",
+  ja: "ja",
+  ko: "ko",
+  de: "de",
+  fr: "fr",
+  es: "es",
+  pt: "pt",
+  "pt-br": "pt-br",
+  ru: "ru",
+  ar: "ar",
+  "ar-eg": "ar",
+  tr: "tr",
+  it: "it",
+  nl: "nl",
+  pl: "pl",
+  th: "th",
+  vi: "vi",
+  id: "id",
+  ms: "ms",
+  da: "da",
+  sv: "sv",
+  fi: "fi",
+  no: "nb",
+  "nb-NO": "nb",
+  cs: "cs",
+  sk: "sk",
+  uk: "uk",
+  hu: "hu",
+  ro: "ro",
+  bg: "bg",
+  az: "az",
+  fa: "fa",
+  hi: "hi",
+  pa: "pa-in",
+  el: "el",
+  ca: "ca",
+  tk: "tk",
+  ta: "ta",
+  lv: "lv",
+  af: "af",
+  et: "et",
+  sl: "sl",
+  he: "he",
+  lo: "lo",
+  lt: "lt",
+  mn: "mn",
+  kk: "kk",
+  ku: "ku",
+  ckb: "ku",
+  "ug-cn": "ug-cn",
+  km: "km",
+  sr: "sr",
+  eu: "eu",
+  ky: "ky",
+  "hy-am": "hy-am",
+  hr: "hr",
+  eo: "eo",
+  bn: "bn",
+  mg: "mg",
+  sw: "sw",
+  "uz-uz": "uz",
+  my: "my",
+  te: "te"
+};
+export const getDayjsLocale = (localeCode) => {
+  return localeMapping[localeCode] || "en";
+};
+export const setDayjsLocale = async (localeCode) => {
+  const dayjsLocale = getDayjsLocale(localeCode);
+  if (loadedLocales.has(dayjsLocale)) {
+    dayjs.locale(dayjsLocale);
+    return;
+  }
+  try {
+    await import(`../../../../node_modules/dayjs/locale/${dayjsLocale}.js`);
+    loadedLocales.add(dayjsLocale);
+    dayjs.locale(dayjsLocale);
+  } catch {
+    console.warn(`[yh-ui] Failed to load dayjs locale: ${dayjsLocale}, falling back to 'en'`);
+    dayjs.locale("en");
+  }
+};
+export const setDayjsLocaleSync = (localeCode) => {
+  const dayjsLocale = getDayjsLocale(localeCode);
+  if (loadedLocales.has(dayjsLocale)) {
+    dayjs.locale(dayjsLocale);
+  } else {
+    dayjs.locale("en");
+    setDayjsLocale(localeCode);
+  }
+};
+export const updateDayjsMonths = (localeCode, months) => {
+  const dayjsLocale = getDayjsLocale(localeCode);
+  const monthsArray = [
+    months.jan,
+    months.feb,
+    months.mar,
+    months.apr,
+    months.may,
+    months.jun,
+    months.jul,
+    months.aug,
+    months.sep,
+    months.oct,
+    months.nov,
+    months.dec
+  ];
+  try {
+    if (dayjs.updateLocale) {
+      dayjs.updateLocale(dayjsLocale, {
+        months: monthsArray,
+        monthsShort: monthsArray
+      });
+    }
+  } catch {
+  }
+};

package/dist/use-locale/index.cjs

@@ -0,0 +1,88 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "getDayjsLocale", {
+  enumerable: true,
+  get: function () {
+    return _dayjsLocale.getDayjsLocale;
+  }
+});
+Object.defineProperty(exports, "setDayjsLocale", {
+  enumerable: true,
+  get: function () {
+    return _dayjsLocale.setDayjsLocale;
+  }
+});
+Object.defineProperty(exports, "setDayjsLocaleSync", {
+  enumerable: true,
+  get: function () {
+    return _dayjsLocale.setDayjsLocaleSync;
+  }
+});
+Object.defineProperty(exports, "updateDayjsMonths", {
+  enumerable: true,
+  get: function () {
+    return _dayjsLocale.updateDayjsMonths;
+  }
+});
+exports.useLocale = void 0;
+var _vue = require("vue");
+var _locale = require("@yh-ui/locale");
+var _useConfig = require("../use-config/index.cjs");
+var _dayjsLocale = require("./dayjs-locale.cjs");
+const useLocale = localeOverrides => {
+  const {
+    globalLocale
+  } = (0, _useConfig.useConfig)();
+  const locale = (0, _vue.computed)(() => {
+    return (0, _vue.unref)(localeOverrides) ?? (0, _vue.unref)(globalLocale) ?? _locale.zhCn;
+  });
+  const lang = (0, _vue.computed)(() => locale.value.name);
+  (0, _vue.watch)(lang, newLang => {
+    (0, _dayjsLocale.setDayjsLocale)(newLang);
+  }, {
+    immediate: true
+  });
+  const t = (path, options) => {
+    const keys = path.split(".");
+    let result = locale.value.yh;
+    for (const key of keys) {
+      if (result && typeof result === "object") {
+        result = result[key];
+      } else {
+        result = void 0;
+      }
+      if (result === void 0) return path;
+    }
+    if (typeof result !== "string") return path;
+    if (options) {
+      return result.replace(/\{(\w+)\}/g, (_match, key) => {
+        const val = options[key];
+        return val !== void 0 ? String(val) : `{${key}}`;
+      });
+    }
+    return result;
+  };
+  const tRaw = path => {
+    const keys = path.split(".");
+    let result = locale.value.yh;
+    for (const key of keys) {
+      if (result && typeof result === "object") {
+        result = result[key];
+      } else {
+        result = void 0;
+      }
+      if (result === void 0) return path;
+    }
+    return result;
+  };
+  return {
+    locale,
+    lang,
+    t,
+    tRaw
+  };
+};
+exports.useLocale = useLocale;

package/dist/use-locale/index.d.ts

@@ -0,0 +1,16 @@
+import type { Ref } from 'vue';
+import type { Language } from '@yh-ui/locale';
+export type { Language };
+export { setDayjsLocale, getDayjsLocale, setDayjsLocaleSync, updateDayjsMonths } from './dayjs-locale';
+/**
+ * useLocale - 国际化
+ * @param localeOverrides - 可选的自定义语言包
+ * @returns 国际化相关方法
+ */
+export declare const useLocale: (localeOverrides?: Ref<Language>) => {
+    locale: import("vue").ComputedRef<Language>;
+    lang: import("vue").ComputedRef<string>;
+    t: (path: string, options?: Record<string, string | number>) => string;
+    tRaw: <T = unknown>(path: string) => T;
+};
+export type UseLocaleReturn = ReturnType<typeof useLocale>;