yuang-framework-ui-common 1.0.112 → 1.0.113

package/lib/hooks/framework/frameworkEnum.ts

@@ -1,50 +1,64 @@
-// 首先建议创建类型定义文件（如 types/api.d.ts），或直接在当前文件定义类型
-// 定义接口：枚举列表项的类型
+import { ref } from 'vue';
+import { http } from '../../../lib/config/httpConfig';
+
 export interface StatusEnumItem {
-  // 根据实际返回的字段补充类型，比如：
   value: string;
   name: string;
-  // 兼容对象中未显式定义的任意字段，避免 TS 报错
   [key: string]: any;
 }
 
-import { ref } from 'vue';
-import { http } from '../../../lib/config/httpConfig';
+// 全局唯一 KEY
+const CACHE_KEY = '__global_status_enum_list__';
+
+// 全局单例（只会初始化一次）
+if (!(window as any)[CACHE_KEY]) {
+  (window as any)[CACHE_KEY] = {
+    data: ref<StatusEnumItem[]>([]),
+    loading: ref(false),
+    isLoaded: false, // 🔥 核心：标记是否【真正加载完成】
+    promise: null as Promise<any> | null,
+  };
+}
+
+const cache = (window as any)[CACHE_KEY];
 
-/**
- * 提供“获取状态枚举列表”的能力
- *
- * Vue3 官方明确规定，组合式函数必须以 use 开头（参考：Vue3 组合式函数文档），目的是让开发者一眼识别：“这是一个可复用的组合式逻辑，返回响应式能力”
- */
 export const useStatusEnumList = () => {
-  // 定义响应式数据，指定类型
-  const statusEnumList = ref<StatusEnumItem[]>([]);
-  // 定义加载状态（可选，增强体验）
-  const isLoadingEnum = ref<boolean>(false);
-
-  /**
-   * 获取状态枚举列表的核心方法
-   */
-  const getStatusEnumList = async (): Promise<void> => {
+  const getStatusEnumList = async () => {
+    // 1. 已经加载完成 → 直接返回
+    if (cache.isLoaded) {
+      return cache.data.value;
+    }
+
+    // 2. 正在请求中 → 等待同一个请求
+    if (cache.promise) {
+      await cache.promise;
+      return cache.data.value;
+    }
+
+    // 3. 真正开始请求
+    cache.loading.value = true;
+    cache.promise = http.get('/framework-api/union/uims-user/getStatusEnumList', {});
+
     try {
-      isLoadingEnum.value = true;
-      // 指定响应数据类型，TS会自动校验
-      const res = await http.get('/framework-api/union/framework-data/getStatusEnumList', {});
-      statusEnumList.value = res.data.data;
-    } catch (ex) {
-      console.error('获取状态枚举列表失败：', ex);
-      statusEnumList.value = [];
+      const res = await cache.promise;
+      cache.data.value = res.data.data || [];
+      cache.isLoaded = true; // 🔥 永久标记：已加载完成！
+    } catch (err) {
+      console.error('加载枚举失败', err);
+      cache.data.value = [];
     } finally {
-      isLoadingEnum.value = false;
+      cache.loading.value = false;
+      cache.promise = null;
     }
+
+    return cache.data.value;
   };
 
-  // 初始化调用（可选，也可由外部调用）
+  // 自动加载
   getStatusEnumList();
 
-  // 返回响应式数据和方法，供组件使用
   return {
-    statusEnumList,
-    isLoadingEnum
+    statusEnumList: cache.data,
+    isLoadingEnum: cache.loading,
   };
 };

package/lib/hooks/uims/uimsUser.ts

@@ -1,61 +1,50 @@
-import { ref } from 'vue';
-import { http } from '../../../lib/config/httpConfig';
-
+// 首先建议创建类型定义文件（如 types/api.d.ts），或直接在当前文件定义类型
+// 定义接口：枚举列表项的类型
 export interface StatusEnumItem {
+    // 根据实际返回的字段补充类型，比如：
     value: string;
     name: string;
+    // 兼容对象中未显式定义的任意字段，避免 TS 报错
     [key: string]: any;
 }
 
-// 全局唯一 KEY
-const ENUM_CACHE_KEY = '__global_status_enum_list__';
-
-// 初始化全局单例（只会执行一次）
-if (!(window as any)[ENUM_CACHE_KEY]) {
-    (window as any)[ENUM_CACHE_KEY] = {
-        data: ref<StatusEnumItem[]>([]),
-        loading: ref(false),
-        promise: null as Promise<any> | null, // 🔥 核心：锁并发
-    };
-}
-
-const cache = (window as any)[ENUM_CACHE_KEY];
+import { ref } from 'vue';
+import { http } from '../../../lib/config/httpConfig';
 
+/**
+ * 提供“获取状态枚举列表”的能力
+ *
+ * Vue3 官方明确规定，组合式函数必须以 use 开头（参考：Vue3 组合式函数文档），目的是让开发者一眼识别：“这是一个可复用的组合式逻辑，返回响应式能力”
+ */
 export const useStatusEnumList = () => {
-    const getStatusEnumList = async () => {
-        // 1. 已经有数据 → 直接返回
-        if (cache.data.value.length > 0) {
-            return cache.data.value;
-        }
-
-        // 2. 正在请求 → 等待同一个 promise（防并发）
-        if (cache.promise) {
-            await cache.promise;
-            return cache.data.value;
-        }
-
-        // 3. 真正发起请求
-        cache.loading.value = true;
-        cache.promise = http.get('/framework-api/union/uims-user/getStatusEnumList', {});
-
+    // 定义响应式数据，指定类型
+    const statusEnumList = ref<StatusEnumItem[]>([]);
+    // 定义加载状态（可选，增强体验）
+    const isLoadingEnum = ref<boolean>(false);
+
+    /**
+     * 获取状态枚举列表的核心方法
+     */
+    const getStatusEnumList = async (): Promise<void> => {
         try {
-            const res = await cache.promise;
-            cache.data.value = res.data.data || [];
-        } catch (err) {
-            console.error('加载枚举失败', err);
-            cache.data.value = [];
+            isLoadingEnum.value = true;
+            // 指定响应数据类型，TS会自动校验
+            const res = await http.get('/framework-api/union/uims-user/getStatusEnumList', {});
+            statusEnumList.value = res.data.data;
+        } catch (ex) {
+            console.error('获取状态枚举列表失败：', ex);
+            statusEnumList.value = [];
         } finally {
-            cache.loading.value = false;
+            isLoadingEnum.value = false;
         }
-
-        return cache.data.value;
     };
 
-    // 自动加载
+    // 初始化调用（可选，也可由外部调用）
     getStatusEnumList();
 
+    // 返回响应式数据和方法，供组件使用
     return {
-        statusEnumList: cache.data,
-        isLoadingEnum: cache.loading,
+        statusEnumList,
+        isLoadingEnum
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuang-framework-ui-common",
-  "version": "1.0.112",
+  "version": "1.0.113",
   "private": false,
   "type": "module",
   "scripts": {