@hlw-uni/mp-vue 2.1.11 → 2.1.12

package/dist/composables/algo/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 算法集：把通用算法包成 useXxx composable，业务侧统一从这里取。
+ *
+ * 已有：
+ *   - useUuid  RFC 4122 v4，32 字符 hex
+ */
+export { useUuid } from './uuid';

package/dist/composables/algo/uuid.d.ts

@@ -0,0 +1,17 @@
+/**
+ * UUID v4 生成器（RFC 4122 v4 算法），返回 32 字符 hex（无连字符）。
+ *
+ * 用途：当 nonce、idempotency key、临时唯一标识用。
+ *
+ * 算法：
+ *   1. 生成 16 字节随机源
+ *   2. byte 6 高 4 位置成 0100 标版本号 v4
+ *   3. byte 8 高 2 位置成 10 标变体（RFC 4122）
+ *   4. 16 字节转 hex 拼成 32 字符串
+ *
+ * 注意：随机源用 Math.random（小程序兼容兜底），加密强度有限，
+ * 不能用于密钥派生 / token 签发，只能挡重放。
+ */
+export declare function useUuid(): {
+    v4: () => string;
+};

package/dist/composables/index.d.ts

@@ -16,6 +16,7 @@ export { useContact, setConfigContact, type ContactConfig, type ContactAdapter,
 export { useUtils, type DownloadFileOptions, type DownloadFileResult, type TapEvent } from './utils';
 export { useColor } from './color';
 export { useRouter, type NavigateType, type NavigateOptions } from './navigator';
+export { useUuid } from './algo';
 export type { FontScale, FontPreset } from './theme';
 export { FONT_SCALE_KEY, FONT_PRESETS, getCurrentFontScale, getCurrentFontVars, THEME_CHANGE_EVENT, buildThemeStyle, useThemePageStyle, } from './theme';
 export type { ThemeColor } from './theme';

package/dist/index.js

@@ -1138,6 +1138,18 @@ var __publicField = (obj, key, value) => {
       navigate: doNavigate
     };
   }
+  function useUuid() {
+    function v4() {
+      const bytes = [];
+      for (let i = 0; i < 16; i++) {
+        bytes.push(Math.floor(Math.random() * 256));
+      }
+      bytes[6] = bytes[6] & 15 | 64;
+      bytes[8] = bytes[8] & 63 | 128;
+      return bytes.map((b) => b.toString(16).padStart(2, "0")).join("");
+    }
+    return { v4 };
+  }
   const useThemeStore = pinia.defineStore(
     "theme",
     () => {
@@ -1940,6 +1952,7 @@ var __publicField = (obj, key, value) => {
   exports2.useThemeStore = useThemeStore;
   exports2.useUpload = useUpload;
   exports2.useUtils = useUtils;
+  exports2.useUuid = useUuid;
   exports2.useValidate = useValidate;
   exports2.vCopy = vCopy;
   Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });

package/dist/index.mjs

@@ -1137,6 +1137,18 @@ function useRouter() {
     navigate: doNavigate
   };
 }
+function useUuid() {
+  function v4() {
+    const bytes = [];
+    for (let i = 0; i < 16; i++) {
+      bytes.push(Math.floor(Math.random() * 256));
+    }
+    bytes[6] = bytes[6] & 15 | 64;
+    bytes[8] = bytes[8] & 63 | 128;
+    return bytes.map((b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  return { v4 };
+}
 const useThemeStore = defineStore(
   "theme",
   () => {
@@ -1940,6 +1952,7 @@ export {
   useThemeStore,
   useUpload,
   useUtils,
+  useUuid,
   useValidate,
   vCopy
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hlw-uni/mp-vue",
-    "version": "2.1.11",
+    "version": "2.1.12",
     "description": "hlw-uni 小程序运行时 — Vue 组件 + composables + theme + http + 工具集（合并自原 mp-core）",
     "main": "dist/index.js",
     "module": "dist/index.mjs",

package/src/composables/algo/index.ts

@@ -0,0 +1,7 @@
+/**
+ * 算法集：把通用算法包成 useXxx composable，业务侧统一从这里取。
+ *
+ * 已有：
+ *   - useUuid  RFC 4122 v4，32 字符 hex
+ */
+export { useUuid } from "./uuid";

package/src/composables/algo/uuid.ts

@@ -0,0 +1,27 @@
+/**
+ * UUID v4 生成器（RFC 4122 v4 算法），返回 32 字符 hex（无连字符）。
+ *
+ * 用途：当 nonce、idempotency key、临时唯一标识用。
+ *
+ * 算法：
+ *   1. 生成 16 字节随机源
+ *   2. byte 6 高 4 位置成 0100 标版本号 v4
+ *   3. byte 8 高 2 位置成 10 标变体（RFC 4122）
+ *   4. 16 字节转 hex 拼成 32 字符串
+ *
+ * 注意：随机源用 Math.random（小程序兼容兜底），加密强度有限，
+ * 不能用于密钥派生 / token 签发，只能挡重放。
+ */
+export function useUuid() {
+    function v4(): string {
+        const bytes: number[] = [];
+        for (let i = 0; i < 16; i++) {
+            bytes.push(Math.floor(Math.random() * 256));
+        }
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        return bytes.map((b) => b.toString(16).padStart(2, "0")).join("");
+    }
+
+    return { v4 };
+}

package/src/composables/index.ts

@@ -45,6 +45,7 @@ export {
 export { useUtils, type DownloadFileOptions, type DownloadFileResult, type TapEvent } from "./utils";
 export { useColor } from "./color";
 export { useRouter, type NavigateType, type NavigateOptions } from "./navigator";
+export { useUuid } from "./algo";
 
 // Theme（mp-vue 自带）
 export type { FontScale, FontPreset } from "./theme";