@hlw-uni/mp-core 1.0.0

package/dist/composables/http/useRequest.d.ts

@@ -0,0 +1,36 @@
+import { http } from './client';
+import { RequestConfig, ApiResponse } from './types';
+
+export interface UseRequestOptions<T = unknown> {
+    /** 初始数据 */
+    initialData?: T | null;
+    /** 手动触发（不自动请求） */
+    manual?: boolean;
+    /** 成功回调 */
+    onSuccess?: (data: T, res: ApiResponse<T>) => void;
+    /** 失败回调 */
+    onError?: (err: Error) => void;
+}
+/**
+ * useRequest — 组件内请求 composable
+ * @example
+ * const { loading, data, error, run } = useRequest<User>();
+ * run({ url: '/user/info', method: 'GET' });
+ */
+export declare function useRequest<T = unknown>(options?: UseRequestOptions<T>): {
+    loading: any;
+    data: any;
+    error: any;
+    run: (config: RequestConfig) => Promise<ApiResponse<T>>;
+    get: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
+    post: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
+    put: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
+    del: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
+};
+/**
+ * useUpload — 上传文件 composable
+ */
+export declare function useUpload(): {
+    uploading: any;
+    upload: (options: import('./types').UploadConfig) => Promise<import('./types').UploadResult>;
+};

package/dist/composables/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Composables 统一导出
+ */
+export * from './http';
+export { useLoading } from './loading';
+export { useMsg, type HlwMsg, type ToastOptions, type ModalOptions, type ToastIcon } from './msg';
+export { useDevice, deviceToQuery, clearDeviceCache, type DeviceInfo } from './device';
+export { useRefs } from './refs';
+export { usePageMeta } from './page-meta';
+export { useStorage, type StorageInstance } from './storage';
+export { useValidate } from './validate';
+export { useFormat } from './format';

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

@@ -0,0 +1,7 @@
+/**
+ * useLoading — 全局 Loading 状态
+ */
+export declare function useLoading(): {
+    showLoading: (message?: string) => void;
+    hideLoading: () => void;
+};

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

@@ -0,0 +1,33 @@
+/**
+ * useMsg — 消息提示 composable
+ */
+export type ToastIcon = "success" | "fail" | "exception" | "none";
+export type ToastDuration = "short" | "long";
+export interface ToastOptions {
+    message: string;
+    icon?: ToastIcon;
+    image?: string;
+    duration?: number;
+    mask?: boolean;
+    position?: "top" | "center" | "bottom";
+}
+export interface ModalOptions {
+    title?: string;
+    content: string;
+    confirmText?: string;
+    cancelText?: string;
+    confirmColor?: string;
+    cancelColor?: string;
+}
+export interface HlwMsg {
+    toast(opts: ToastOptions): void;
+    success(message: string): void;
+    error(message: string): void;
+    fail(message: string): void;
+    showLoading(message?: string): void;
+    hideLoading(): void;
+    confirm(opts: ModalOptions): Promise<boolean>;
+    modal(opts: ModalOptions): Promise<boolean>;
+    setLoadingBar(progress: number): void;
+}
+export declare function useMsg(): HlwMsg;

package/dist/composables/page-meta/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * usePageMeta — 页面元信息 composable
+ */
+export interface PageMeta {
+    title?: string;
+    navigationBarTitleText?: string;
+    navigationBarBackgroundColor?: string;
+    navigationBarTextStyle?: "white" | "black";
+    backgroundColor?: string;
+    enablePullDownRefresh?: boolean;
+}
+export declare function usePageMeta(): {
+    setTitle: (title: string) => void;
+    setOptions: (options: PageMeta) => void;
+};

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

@@ -0,0 +1,4 @@
+export declare function useRefs(): {
+    refs: any;
+    setRefs: (key: string) => (el: any) => void;
+};

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

@@ -0,0 +1,13 @@
+/// <reference types="@dcloudio/types" />
+/// <reference types="@dcloudio/types" />
+/**
+ * useStorage — 本地存储 composable
+ */
+export interface StorageInstance {
+    get: <T = unknown>(key: string) => T | null;
+    set: <T>(key: string, value: T) => boolean;
+    remove: (key: string) => boolean;
+    clear: () => boolean;
+    info: () => UniApp.GetStorageInfoSuccess | null;
+}
+export declare function useStorage(): StorageInstance;

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

@@ -0,0 +1,12 @@
+/**
+ * useValidate — 校验工具 composable
+ */
+export declare function useValidate(): {
+    phone: (value: string) => boolean;
+    email: (value: string) => boolean;
+    url: (value: string) => boolean;
+    idCard: (value: string) => boolean;
+    carNumber: (value: string) => boolean;
+    password: (value: string) => boolean;
+    empty: (value: unknown) => boolean;
+};

package/dist/hlw.d.ts

@@ -0,0 +1,10 @@
+import { useMsg } from './composables/msg';
+import { useDevice } from './composables/device';
+import { http } from './composables/http';
+
+export interface HlwInstance {
+    $msg: ReturnType<typeof useMsg>;
+    $device: ReturnType<typeof useDevice>;
+    $http: typeof http;
+}
+export declare const hlw: HlwInstance;

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @hlw-uni/mp-core 统一导出
+ */
+export * from './composables';
+export { useApp, setupDefaultInterceptors } from './app';
+export { hlw, type HlwInstance } from './hlw';
+export { default as Avatar } from './components/Avatar.vue';
+export { default as Empty } from './components/Empty.vue';
+export { default as Loading } from './components/Loading.vue';
+export { default as MenuList, type MenuItem } from './components/MenuList.vue';

package/dist/index.js

@@ -0,0 +1,310 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+const vue = require("vue");
+const cosAdapter = {
+  name: "cos",
+  buildFormData(ctx) {
+    const c = ctx.credentials ?? {};
+    return {
+      "q-ak": c["ak"] ?? "",
+      policy: c["policy"] ?? "",
+      "q-key-time": c["key-time"] ?? "",
+      "q-signature": c["signature"] ?? "",
+      "Content-Disposition": `inline;filename=${encodeURIComponent(ctx.fileName)}`,
+      success_action_status: 200,
+      ...ctx.extraData ?? {}
+    };
+  }
+};
+const ossAdapter = {
+  name: "oss",
+  buildFormData(ctx) {
+    const c = ctx.credentials ?? {};
+    return {
+      policy: c["policy"] ?? "",
+      signature: c["signature"] ?? "",
+      OSSAccessKeyId: c["accessKeyId"] ?? "",
+      success_action_status: 200,
+      "Content-Disposition": `inline;filename=${encodeURIComponent(ctx.fileName)}`,
+      ...ctx.extraData ?? {}
+    };
+  }
+};
+const qiniuAdapter = {
+  name: "qiniu",
+  buildFormData(ctx) {
+    const c = ctx.credentials ?? {};
+    return {
+      token: c["token"] ?? "",
+      key: c["key"] ?? ctx.fileName,
+      ...ctx.extraData ?? {}
+    };
+  }
+};
+const alistAdapter = {
+  name: "alist",
+  buildFormData(ctx) {
+    const c = ctx.credentials ?? {};
+    return {
+      "file-path": c["file-path"] ?? ctx.fileName,
+      authorization: c["token"] ?? "",
+      ...ctx.extraData ?? {}
+    };
+  }
+};
+const adapters = {
+  cos: cosAdapter,
+  oss: ossAdapter,
+  qiniu: qiniuAdapter,
+  alist: alistAdapter
+};
+function getAdapter(name) {
+  const adapter = adapters[name];
+  if (!adapter)
+    throw new Error(`[hlw] Unknown upload adapter: ${name}`);
+  return adapter;
+}
+var define_import_meta_env_default = {};
+class HttpClient {
+  constructor(options = {}) {
+    __publicField(this, "_reqInterceptors", []);
+    __publicField(this, "_resInterceptors", []);
+    __publicField(this, "_errInterceptors", []);
+    __publicField(this, "_baseURL");
+    __publicField(this, "_defaultHeaders");
+    this._baseURL = options.baseURL ?? "";
+    this._defaultHeaders = {
+      "Content-Type": "application/json",
+      ...options.headers
+    };
+  }
+  /** 添加请求拦截器，返回取消函数 */
+  onRequest(fn) {
+    this._reqInterceptors.push(fn);
+    return () => {
+      const idx = this._reqInterceptors.indexOf(fn);
+      if (idx > -1)
+        this._reqInterceptors.splice(idx, 1);
+    };
+  }
+  /** 添加响应拦截器 */
+  onResponse(fn) {
+    this._resInterceptors.push(fn);
+    return () => {
+      const idx = this._resInterceptors.indexOf(fn);
+      if (idx > -1)
+        this._resInterceptors.splice(idx, 1);
+    };
+  }
+  /** 添加错误拦截器 */
+  onError(fn) {
+    this._errInterceptors.push(fn);
+    return () => {
+      const idx = this._errInterceptors.indexOf(fn);
+      if (idx > -1)
+        this._errInterceptors.splice(idx, 1);
+    };
+  }
+  /**
+   * 全局请求
+   */
+  async request(config) {
+    let cfg = {
+      method: "GET",
+      ...config,
+      headers: { ...this._defaultHeaders, ...config.headers }
+    };
+    for (const fn of this._reqInterceptors) {
+      cfg = await fn(cfg);
+    }
+    const fullUrl = this._buildUrl(cfg.url);
+    const res = await this._doRequest(fullUrl, cfg);
+    for (const fn of this._resInterceptors) {
+      const modified = await fn(res);
+      if (modified !== void 0)
+        return modified;
+    }
+    return res;
+  }
+  /**
+   * 组件内请求，返回带状态的 composable
+   */
+  useRequest() {
+    const loading = vue.ref(false);
+    const data = vue.ref(null);
+    const error = vue.ref(null);
+    async function run(cfg) {
+      loading.value = true;
+      error.value = null;
+      try {
+        const res = await this.request(cfg);
+        data.value = res.data;
+        return res;
+      } catch (e) {
+        error.value = e;
+        await this._applyErrorInterceptors(e);
+        throw e;
+      } finally {
+        loading.value = false;
+      }
+    }
+    const get = (url, d) => run({ url, method: "GET", data: d });
+    const post = (url, d) => run({ url, method: "POST", data: d });
+    const put = (url, d) => run({ url, method: "PUT", data: d });
+    const del = (url, d) => run({ url, method: "DELETE", data: d });
+    return { loading, data, error, run: run.bind(this), get, post, put, del };
+  }
+  /**
+   * 上传文件（策略模式）
+   */
+  upload(config) {
+    const adapter = getAdapter(config.type);
+    const fileName = config.fileName ?? config.filePath.split("/").pop() ?? "file";
+    let server = config.server;
+    if (config.type === "local" && config.url)
+      server = config.url;
+    const formData = adapter.buildFormData({
+      filePath: config.filePath,
+      fileName,
+      credentials: config.credentials
+    });
+    return new Promise((resolve, reject) => {
+      uni.uploadFile({
+        url: server,
+        filePath: config.filePath,
+        name: "file",
+        formData,
+        header: config.header,
+        success: (res) => {
+          if (res.statusCode === 200) {
+            try {
+              const body = JSON.parse(res.data);
+              resolve({ code: body.code ?? 1, msg: body.message ?? "上传成功", data: body.data ?? "" });
+            } catch {
+              resolve({ code: 1, msg: "上传成功", data: res.data });
+            }
+          } else {
+            reject(new Error("上传失败"));
+          }
+        },
+        fail: (err) => reject(new Error(err.errMsg || "上传失败"))
+      });
+    });
+  }
+  _buildUrl(url) {
+    if (/^https?:\/\//.test(url))
+      return url;
+    const sep = url.includes("?") ? "&" : "?";
+    return `${this._baseURL}${url}${sep}_t=${Date.now()}`;
+  }
+  async _doRequest(url, cfg) {
+    return new Promise((resolve, reject) => {
+      uni.request({
+        url,
+        method: cfg.method,
+        data: cfg.data,
+        header: cfg.headers,
+        success: (res) => {
+          var _a;
+          if (res.statusCode >= 200 && res.statusCode < 300) {
+            resolve(res.data);
+          } else {
+            const msg = ((_a = res.data) == null ? void 0 : _a.message) ?? `请求失败: ${res.statusCode}`;
+            reject(new Error(msg));
+          }
+        },
+        fail: (err) => reject(new Error(err.errMsg || "网络请求失败"))
+      });
+    });
+  }
+  async _applyErrorInterceptors(err) {
+    for (const fn of this._errInterceptors) {
+      await fn(err);
+    }
+  }
+}
+new HttpClient({
+  baseURL: define_import_meta_env_default.VITE_API_BASE_URL ?? ""
+});
+const _info = vue.ref(null);
+function collect() {
+  var _a;
+  const sys = uni.getSystemInfoSync();
+  let appid = "";
+  try {
+    const accountInfo = uni.getAccountInfoSync();
+    appid = ((_a = accountInfo == null ? void 0 : accountInfo.miniProgram) == null ? void 0 : _a.appId) || "";
+  } catch {
+    appid = sys.appId || "";
+  }
+  let appName = "";
+  let appVersion = "";
+  let appVersionCode = "";
+  let hostName = "";
+  let hostVersion = "";
+  let hostLanguage = "";
+  let hostTheme = "";
+  try {
+    const appInfo = uni.getAppBaseInfo();
+    appName = appInfo.appName || "";
+    appVersion = appInfo.appVersion || "";
+    appVersionCode = appInfo.appVersionCode || "";
+    hostName = appInfo.hostName || "";
+    hostVersion = appInfo.hostVersion || "";
+    hostLanguage = appInfo.hostLanguage || "";
+    hostTheme = appInfo.hostTheme || "";
+  } catch {
+    appVersion = sys.appVersion || "";
+  }
+  const deviceBrand = sys.deviceBrand || "";
+  const deviceModel = sys.deviceModel || "";
+  const deviceId = sys.deviceId || "";
+  const deviceType = sys.deviceType || "";
+  const deviceOrientation = sys.deviceOrientation || "portrait";
+  const system = sys.system || "";
+  return {
+    appid,
+    app_name: appName,
+    app_version: appVersion,
+    app_version_code: appVersionCode,
+    app_channel: sys.appChannel || "",
+    device_brand: deviceBrand,
+    device_model: deviceModel,
+    device_id: deviceId,
+    device_type: deviceType,
+    device_orientation: deviceOrientation,
+    brand: sys.brand || "",
+    model: sys.model || "",
+    system,
+    os: system.split(" ")[0] || "",
+    pixel_ratio: sys.pixelRatio || 0,
+    screen_width: sys.screenWidth || 0,
+    screen_height: sys.screenHeight || 0,
+    window_width: sys.windowWidth || 0,
+    window_height: sys.windowHeight || 0,
+    status_bar_height: sys.statusBarHeight || 0,
+    sdk_version: sys.SDKVersion || "",
+    host_name: hostName,
+    host_version: hostVersion,
+    host_language: hostLanguage,
+    host_theme: hostTheme,
+    platform: sys.platform || "",
+    language: sys.language || "",
+    version: sys.version || ""
+  };
+}
+function ensure() {
+  if (!_info.value) {
+    _info.value = collect();
+  }
+}
+function useDevice() {
+  ensure();
+  return _info;
+}
+useDevice();