minitest2.0 0.0.0

package/docs/jsapi.js

@@ -0,0 +1,515 @@
+function MXApi(callbacks = {}) {
+  let deviceReady = false
+  const taskQueue = []
+
+  document.addEventListener(
+    'deviceready',
+    function deviceReadyHandler() {
+      deviceReady = true
+
+      taskQueue.forEach(function (task) {
+        applyApi.apply(null, task)
+      })
+
+      taskQueue.length = 0
+
+      callbacks.ready && callbacks.ready()
+      document.removeEventListener('deviceready', deviceReadyHandler, false)
+    },
+    false,
+  )
+
+  function applyApi(namespace, api, args = []) {
+    if (window[namespace] && window[namespace][api]) {
+      callbacks.beforeApply && callbacks.beforeApply(namespace, api, args)
+      return window[namespace][api].apply(null, args)
+    }
+
+    if (!deviceReady) {
+      taskQueue.push([namespace, api, args])
+      return
+    }
+
+    const message = ['该终端没有', namespace, '.', api, '方法!'].join('')
+    callbacks.error && callbacks.error(message, namespace, api)
+    throw new Error(message)
+  }
+
+  return applyApi
+}
+
+const applyApi = MXApi({
+  ready() {
+    console.log('device ready!!')
+  },
+  error(err) {
+    console.log(err)
+  },
+  beforeApply(namespace, api, args) {
+    // do nothing
+  },
+})
+
+const makeApi =
+  (namespace) =>
+  (api, ...args) =>
+    applyApi(namespace, api, args)
+
+const MXCommon = makeApi('MXCommon')
+const MXWebui = makeApi('MXWebui')
+const MXContacts = makeApi('MXContacts')
+const MXLocation = makeApi('MXLocation')
+const MXCloudWalkFace = makeApi('MXCloudWalkFace')
+const MXMedal = makeApi('MXMedal')
+const MXChat = makeApi('MXChat')
+const MXCircle = makeApi('MXCircle')
+const MXShare = makeApi('MXShare')
+
+export const showOptionMenu = () => MXWebui('showOptionMenu')
+
+export const iphoneXBottomSetAside = (...args) => {
+  return MXWebui('iphoneXBottomSetAside', ...args)
+}
+
+export const hideOptionMenu = () => {
+  return MXWebui('hideOptionMenu')
+}
+
+export const setCustomHeaderMenu = (...args) => {
+  return MXWebui('setCustomHeaderMenu', ...args)
+}
+
+export const setWebViewTitle = (...args) => {
+  return MXWebui('setWebViewTitle', ...args)
+}
+
+export const showWebViewTitle = (...args) => {
+  return MXWebui('showWebViewTitle', ...args)
+}
+
+export const closeWindow = (...args) => {
+  return MXWebui('closeWindow', ...args)
+}
+
+export const call = (...args) => {
+  return MXCommon('call', ...args)
+}
+
+export const hideWebViewTitle = (...args) => {
+  return MXWebui('hideWebViewTitle', ...args)
+}
+
+// 沉浸式头部
+export const enableTranslucentHeader = (...args) => {
+  return MXWebui('enableTranslucentHeader', ...args)
+}
+
+export const getCurrentUser = () => {
+  return new Promise((resolve, reject) => {
+    MXCommon('getCurrentUser', resolve, reject)
+  })
+}
+
+export const MXSelectUsers = (userIds) => {
+  return new Promise((resolve, reject) => {
+    MXContacts(
+      'selectUsers',
+      resolve,
+      {
+        customUserIDS: userIds,
+        enableSelectDept: false,
+        canSelectSelf: true,
+      },
+      reject,
+    )
+  })
+}
+
+export const MXSelectUser = () => {
+  return new Promise((resolve, reject) => {
+    MXContacts('selectUser', resolve, {}, reject)
+  })
+}
+
+export const MXBrowseImages = (...args) => {
+  return MXCommon('browseImages', ...args)
+}
+
+export const MXDownload = (...args) => {
+  return MXCommon('download', ...args)
+}
+
+export const MXOpenUrlPage = (...args) => {
+  return MXCommon('openUrlPage', ...args)
+}
+
+const safeJsonParse = (data) => {
+  if (typeof data !== 'string') return data
+
+  try {
+    return JSON.parse(data)
+  } catch (error) {
+    return data
+  }
+}
+
+export const ajax = (params) => {
+  return new Promise((resolve, reject) => {
+    params = Object.assign({}, params, {
+      url: `${params.url}`,
+      async: true,
+      success(data, status, xhr) {
+        console.log(data, status, xhr)
+        resolve({
+          data: safeJsonParse(data),
+          status,
+          xhr,
+        })
+      },
+      error(data, status, xhr) {
+        reject({
+          data,
+          status,
+          xhr,
+        })
+      },
+    })
+
+    console.log('params_url==>>', params.url)
+    console.log('params_data==>>', params.data)
+
+    MXCommon('ajax', params)
+  })
+}
+
+const queryString = (obj) => {
+  if (!obj) return ''
+
+  return Object.keys(obj)
+    .map((key) => `${encodeURIComponent(key)}=${encodeURIComponent(obj[key])}`)
+    .join('&')
+}
+
+export const ajaxGet = (url, query) => {
+  url = query ? `${url}?${queryString(query)}` : url
+
+  return ajax({
+    type: 'GET',
+    url,
+  })
+}
+
+export const ajaxPost = (url, data, param = {}) => {
+  return ajax({
+    type: 'POST',
+    url,
+    data,
+    ...param,
+  })
+}
+
+export const ajaxPut = (url, data) => {
+  return ajax({
+    type: 'PUT',
+    url,
+    data,
+  })
+}
+
+export const ajaxDelete = (url, id) => {
+  return ajax({
+    type: 'DELETE',
+    url: `${url}/${id}`,
+  })
+}
+
+export const chooseFile = (count, options) => {
+  return new Promise((resolve, reject) => {
+    MXCommon('chooseFile', count, options, resolve, reject)
+  })
+}
+
+export const chooseImage = (count, options) => {
+  return new Promise((resolve, reject) => {
+    MXCommon('chooseImage', count, options, resolve, reject)
+  })
+}
+
+export const getLocation = (gpsOnly) => {
+  return new Promise((resolve, reject) => {
+    MXLocation('getLocation', resolve, reject, gpsOnly)
+  })
+}
+
+export const getMapScreenShot = () => {
+  return new Promise((resolve, reject) => {
+    MXLocation('getMapScreenShot', {
+      onSuccess: resolve,
+      onFail: reject,
+    })
+  })
+}
+
+// 获取服务器地址
+export const getServerUrl = () => {
+  return new Promise((resolve, reject) => {
+    MXCommon('getServerUrl', resolve, reject)
+  })
+}
+
+// 获取水印
+export const getWaterMarkUrl = () => {
+  return new Promise((resolve, reject) => {
+    MXCommon('getWaterMarkUrl', resolve, reject)
+  })
+}
+
+// 身份证读取
+export const iDCardRecognize = (params) => {
+  return new Promise((resolve, reject) => {
+    MXCloudWalkFace('iDCardRecognize', {
+      type: params.type,
+      onSuccess: resolve,
+      onFail: reject,
+    })
+  })
+}
+
+// 人脸识别
+export const faceRecognize = () => {
+  return new Promise((resolve, reject) => {
+    MXCloudWalkFace('faceRecognize', {
+      onSuccess: resolve,
+      onFail: reject,
+    })
+  })
+}
+
+// base64图片保存到本地
+export const saveImageToAlbum = (url) => {
+  return MXMedal('saveImageToAlbum', {
+    base64: url,
+  })
+}
+
+// 根据appid获取sso_token
+export const getSSOToken = (appId) => {
+  return new Promise((resolve, reject) => {
+    MXCommon('getSSOToken', appId, resolve, reject)
+  })
+}
+
+// 佩戴取消佩戴头饰
+export const mxWearMedal = (param) => {
+  return new Promise((resolve, reject) => {
+    MXMedal('wearMedal', {
+      onSuccess: resolve,
+      onFail: reject,
+      isWear: param.isWear,
+      isCancelWear: param.isCancelWear,
+      ornamentUrl: param.ornamentUrl,
+    })
+  })
+}
+
+/**
+ * 判断是否是PC端
+ */
+export const judgePlat = () => {
+  const userAgentInfo = navigator.userAgent
+  const agents = ['Android', 'iPhone', 'SymbianOS', 'Windows Phone']
+
+  for (let v = 0; v < agents.length; v++) {
+    if (userAgentInfo.indexOf(agents[v]) > 0) {
+      return false
+    }
+  }
+
+  return true
+}
+
+// 根据用户id获取头像
+export const getUserAvatars = (param) => {
+  return new Promise((resolve, reject) => {
+    MXCommon('getUserAvatars', {
+      userIds: param.userIds,
+      onSuccess: resolve,
+      onFail: reject,
+    })
+  })
+}
+
+// base64图片分享到聊天
+export const shareImageToChat = (url) => {
+  return MXChat('chat', {
+    message: {
+      message_type: 'image',
+      body: {
+        base64: url,
+      },
+    },
+  })
+}
+
+// base64图片分享到朋友圈
+export const shareImageToCircle = (url) => {
+  return MXCircle('send', {
+    attachments: [
+      {
+        type: 'image',
+        url,
+      },
+    ],
+  })
+}
+
+// 客户端登出
+export const jumpLogin = () => {
+  return MXCommon('jumpLogin')
+}
+
+// 客户端登录
+export const loginWithToken = (...args) => {
+  return MXCommon('loginWithToken', ...args)
+}
+
+// MXCommon.ajaxFormData
+export const ajaxFormData = (params) => {
+  return new Promise((resolve, reject) => {
+    params = Object.assign({}, params, {
+      url: `${params.url}`,
+      async: true,
+      success(data, status, xhr) {
+        console.log(data, status, xhr)
+        resolve({
+          data: safeJsonParse(data),
+          status,
+          xhr,
+        })
+      },
+      error(data, status, xhr) {
+        reject({
+          data,
+          status,
+          xhr,
+        })
+      },
+    })
+
+    console.log('params_url==>>', params.url)
+    console.log('params_data==>>', params.data)
+
+    MXCommon('ajaxFormData', params)
+  })
+}
+
+export const addEventListener = (params) => {
+  return MXCommon('addEventListener', params)
+}
+
+export const removeEventListener = (params) => {
+  return MXCommon('removeEventListener', params)
+}
+
+// 允许截屏
+export const enableWebViewScreenShot = (params) => {
+  return MXCommon('enableWebViewScreenShot', params)
+}
+
+// 禁止截屏
+export const disableWebViewScreenShot = (params) => {
+  return MXCommon('disableWebViewScreenShot', params)
+}
+
+// 开始录音
+export const startRecord = (params) => {
+  return MXCommon('startRecord', params)
+}
+
+// 暂停录音
+export const pauseRecord = (params) => {
+  return MXCommon('pauseRecord', params)
+}
+
+// 停止录音
+export const stopRecord = (...params) => {
+  return MXCommon('stopRecord', ...params)
+}
+
+// 获取录音时长
+export const getRecordDuration = (params) => {
+  return MXCommon('getRecordDuration', params)
+}
+
+// 播放录音
+export const playVoice = (...params) => {
+  return MXCommon('playVoice', ...params)
+}
+
+// 暂停播放
+export const pauseVoice = (...params) => {
+  return MXCommon('pauseVoice', ...params)
+}
+
+// 停止播放
+export const stopVoice = (...params) => {
+  return MXCommon('stopVoice', ...params)
+}
+
+// 身份证拍照
+export const onlyTakeIdCardPhoto = (params) => {
+  return MXCommon('onlyTakeIdCardPhoto', params)
+}
+
+// base64 分享到工作圈
+export const base64SendToCircle = (params) => {
+  return MXCommon('base64SendToCircle', params)
+}
+
+// 地理逆编码
+export const regeocode = (params) => {
+  return MXLocation('regeocode', params)
+}
+
+export const newChooseFile = (params) => {
+  return MXCommon('chooseFile', params)
+}
+
+export const newChooseFile02 = (...params) => {
+  return MXCommon('chooseFile', ...params)
+}
+
+// 根据appid启动应用
+export const lanuchApp = (...params) => {
+  return MXCommon('launchApp', ...params)
+}
+
+// 打开协议
+export const launchAnyUrl = (params) => {
+  return MXCommon('launchAnyUrl', params)
+}
+
+// 设置应用未读数
+export const setAppUnreadCount = (...params) => {
+  return MXCommon('setAppUnreadCount', ...params)
+}
+
+// 设置应用在聊天列表中的未读数
+export const setAppChatUnreadCount = (...params) => {
+  return MXCommon('setAppChatUnreadCount', ...params)
+}
+
+// 设置导航栏背景颜色
+export const setNavBgColor = (...params) => {
+  return MXWebui('setNavBgColor', ...params)
+}
+
+// 设置右上角菜单颜色
+export const setPopupMenuBgColor = (...params) => {
+  return MXWebui('setPopupMenuBgColor', ...params)
+}
+
+// 分享到微信或者微信朋友圈
+export const share = (params) => {
+  return MXShare('share', params)
+}

package/docs/package-json-guide.md

@@ -0,0 +1,132 @@
+# package.json 说明
+
+## 项目信息
+
+| 字段 | 值 | 说明 |
+|------|-----|------|
+| `name` | `mini2.0` | 项目名称 |
+| `version` | `0.0.0` | 当前版本（开发初期未正式定版） |
+| `private` | `true` | 私有项目，禁止发布到 npm |
+| `type` | `module` | 使用 ES Module 规范（`import/export`） |
+| `engines.node` | `^20.19.0 \|\| >=22.12.0` | 要求 Node.js 20.19+ 或 22.12+ |
+
+---
+
+## 脚本命令（scripts）
+
+### 开发
+
+| 命令 | 作用 |
+|------|------|
+| `npm run dev` | 启动 Vite 开发服务器（默认 `.env.development` 环境变量） |
+| `npm run dev:test` | 以 test 模式启动开发服务器，加载 `.env.test` 环境变量，用于本地联调测试环境接口 |
+
+### 构建
+
+| 命令 | 作用 |
+|------|------|
+| `npm run build` | 生产构建，先运行 TypeScript 类型检查（`vue-tsc --build`），再执行 Vite 构建 |
+| `npm run build:test` | 测试环境构建，串行执行类型检查 + Vite 构建（`--mode test`） |
+| `npm run build:prod` | 生产环境构建，串行执行类型检查 + Vite 构建（`--mode production`） |
+| `npm run build-only` | **仅**执行 Vite 构建，不做类型检查，适合快速出包调试 |
+| `npm run build-only:test` | 仅构建，使用 test 模式 |
+| `npm run build-only:prod` | 仅构建，使用 production 模式 |
+| `npm run preview` | 启动 Vite 静态文件预览服务器，用于本地查看构建产物 |
+
+> `build` 命令使用 `npm-run-all2` 的 `run-p`（并行）执行类型检查和构建；`build:test` / `build:prod` 使用 `run-s`（串行）先类型检查再构建。
+
+### 代码质量
+
+| 命令 | 作用 |
+|------|------|
+| `npm run lint` | 串行执行所有 `lint:*` 子命令 |
+| `npm run lint:oxlint` | 使用 OxLint 对代码做快速 lint 检查并自动修复 |
+| `npm run lint:eslint` | 使用 ESLint 做完整 lint 检查并自动修复，结果会缓存（`--cache`） |
+| `npm run format` | 使用 Prettier 格式化 `src/` 目录下的代码 |
+
+> `npm run lint` 会先执行 oxlint 再执行 eslint，两者分工：oxlint 速度快，适合捕获常见错误；eslint 规则更全面，特别是 Vue/TypeScript 相关规则。
+
+---
+
+## 生产依赖（dependencies）
+
+这些包会被打包到最终产物中，直接影响用户侧。
+
+| 包名 | 版本 | 作用 |
+|------|------|------|
+| `vue` | `^3.5.32` | Vue 3 核心框架，提供响应式系统、组件系统和模板编译 |
+| `vue-router` | `^5.0.4` | Vue 官方路由，管理页面导航和 URL 映射 |
+| `pinia` | `^3.0.4` | Vue 官方状态管理库，替代 Vuex，支持组合式 API |
+| `vant` | `^4.9.24` | 有赞出品的移动端 Vue 3 组件库，提供丰富的 UI 组件（按钮、弹窗、表单等） |
+| `axios` | `^1.16.1` | HTTP 客户端，用于发起 API 请求，支持拦截器、取消请求等 |
+| `@iconify/vue` | `^5.0.1` | Iconify 图标库的 Vue 组件封装，可使用数千个图标集（如 Material Design、Tabler 等） |
+| `@vueuse/core` | `^14.3.0` | Vue 组合式工具函数集，提供 `useStorage`、`useDebounceFn`、`useClipboard` 等常用 hooks |
+| `dayjs` | `^1.11.21` | 轻量级日期时间处理库（仅 2KB），Moment.js 的替代品 |
+| `crypto-js` | `^4.2.0` | 加密算法库，支持 AES、MD5、SHA 等，用于前端数据加密/签名 |
+| `clipboard` | `^2.0.11` | 剪贴板操作库，实现一键复制文本到系统剪贴板 |
+| `nprogress` | `^0.2.0` | 页面顶部细线进度条，常用于路由切换或接口请求时的加载反馈 |
+| `qrcode` | `^1.5.4` | 二维码生成库，可在 Canvas/SVG/Node.js 中生成二维码图片 |
+
+---
+
+## 开发依赖（devDependencies）
+
+这些包仅在开发/构建阶段使用，不会进入最终产物。
+
+### 构建工具
+
+| 包名 | 版本 | 作用 |
+|------|------|------|
+| `vite` | `^8.0.8` | 下一代前端构建工具，提供极快的冷启动和热更新 |
+| `@vitejs/plugin-vue` | `^6.0.6` | Vite 官方 Vue 插件，处理 `.vue` 单文件组件的编译 |
+| `vite-plugin-vue-devtools` | `^8.1.1` | Vue DevTools 的 Vite 插件集成，开发时提供组件树、状态检查等调试能力 |
+| `unplugin-vue-components` | `^32.1.0` | 组件自动导入插件，无需手动 `import` 即可使用 Vant 等组件（按需引入） |
+| `postcss-px-to-viewport-8-plugin` | `^1.2.5` | PostCSS 插件，自动将 CSS 中的 `px` 单位转换为 `vw`，实现移动端视口适配 |
+| `less` | `^4.6.4` | Less CSS 预处理器，支持变量、嵌套、混入等语法 |
+| `npm-run-all2` | `^8.0.4` | 提供 `run-s`（串行）和 `run-p`（并行）命令，用于组合多个 npm scripts |
+| `jiti` | `^2.6.1` | 运行时 TypeScript/ESM 模块加载器，部分工具链（如 ESLint flat config）依赖它在 Node 中直接解析 TS 配置文件 |
+
+### TypeScript
+
+| 包名 | 版本 | 作用 |
+|------|------|------|
+| `typescript` | `~6.0.0` | TypeScript 编译器，提供静态类型检查 |
+| `vue-tsc` | `^3.2.6` | Vue 单文件组件的 TypeScript 类型检查工具（基于 `tsc`，支持 `.vue` 文件） |
+| `@tsconfig/node24` | `^24.0.4` | Node.js 24 的 `tsconfig.json` 基础配置预设 |
+| `@types/node` | `^24.12.2` | Node.js 内置模块（`fs`、`path` 等）的类型声明 |
+| `@vue/tsconfig` | `^0.9.1` | Vue 项目的 `tsconfig.json` 基础配置预设 |
+
+### 代码规范
+
+| 包名 | 版本 | 作用 |
+|------|------|------|
+| `eslint` | `^10.2.1` | JavaScript/TypeScript 代码静态分析工具，检测代码风格和潜在错误 |
+| `eslint-plugin-vue` | `~10.8.0` | ESLint 的 Vue 规则插件，检查 `.vue` 文件的模板和脚本 |
+| `@vue/eslint-config-typescript` | `^14.7.0` | Vue 官方的 TypeScript ESLint 配置预设 |
+| `eslint-plugin-oxlint` | `~1.60.0` | 让 ESLint 跳过 OxLint 已覆盖的规则，避免重复检查 |
+| `eslint-config-prettier` | `^10.1.8` | 关闭 ESLint 中与 Prettier 冲突的格式化规则，保证两者不打架 |
+| `oxlint` | `~1.60.0` | Rust 编写的超快 linter（比 ESLint 快 50-100 倍），用于替代部分 ESLint 规则 |
+| `prettier` | `3.8.3` | 代码格式化工具，统一缩进、引号、分号等风格，只管格式不管逻辑 |
+
+---
+
+## 依赖关系速览
+
+```
+开发流程
+├── 代码编写阶段
+│   ├── TypeScript (类型检查)
+│   ├── ESLint + OxLint (代码规范)
+│   └── Prettier (代码格式化)
+│
+├── 开发调试阶段
+│   ├── Vite (开发服务器 + HMR)
+│   ├── Vue / Vant (UI 开发)
+│   └── vite-plugin-vue-devtools (调试工具)
+│
+└── 构建部署阶段
+    ├── vue-tsc (类型检查)
+    ├── Vite (打包构建)
+    ├── postcss-px-to-viewport-8-plugin (移动端适配)
+    └── unplugin-vue-components (按需引入)
+```

package/env.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly BASE_URL: string
+  readonly VITE_APP_ENV: 'development' | 'test' | 'production'
+  readonly VITE_API_BASE_URL: string
+  readonly VITE_PROXY_TARGET?: string
+  readonly VITE_API_TIMEOUT: string
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}
+
+declare const __APP_VERSION__: string

package/eslint.config.ts

@@ -0,0 +1,26 @@
+import { globalIgnores } from 'eslint/config'
+import { defineConfigWithVueTs, vueTsConfigs } from '@vue/eslint-config-typescript'
+import pluginVue from 'eslint-plugin-vue'
+import pluginOxlint from 'eslint-plugin-oxlint'
+import skipFormatting from 'eslint-config-prettier/flat'
+
+// To allow more languages other than `ts` in `.vue` files, uncomment the following lines:
+// import { configureVueProject } from '@vue/eslint-config-typescript'
+// configureVueProject({ scriptLangs: ['ts', 'tsx'] })
+// More info at https://github.com/vuejs/eslint-config-typescript/#advanced-setup
+
+export default defineConfigWithVueTs(
+  {
+    name: 'app/files-to-lint',
+    files: ['**/*.{vue,ts,mts,tsx}'],
+  },
+
+  globalIgnores(['**/dist/**', '**/dist-ssr/**', '**/coverage/**']),
+
+  ...pluginVue.configs['flat/essential'],
+  vueTsConfigs.recommended,
+
+  ...pluginOxlint.buildFromOxlintConfigFile('.oxlintrc.json'),
+
+  skipFormatting,
+)

package/index.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="">
+  <head>
+    <meta charset="UTF-8">
+    <link rel="icon" href="/favicon.ico">
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, user-scalable=no"
+    />
+    <title>平台</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>