@wapri/gbase 2.0.0 → 2.0.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 wapri contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 wapri contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,11 @@
 # @wapri/gbase
 
+与框架无关的前端基础能力包：浏览器存储封装、运行环境（含鸿蒙）判断、正则校验，以及 `lodash-es`、`dayjs` 等基础依赖的统一出口。
+
+## 在线文档
+
+https://sdmu-gaoqi.github.io/wapri/changelog/base
+
 ## Storage
 
 `MyStorage` 创建时先检查对应浏览器存储是否可用，并在不可用时回退到内存，避免 App 壳或非浏览器环境的读写异常。

package/dist/constant/os.js

@@ -1,15 +1,15 @@
-/**
- * 鸿蒙系统 UA 特征集中维护
- *
- * 约定与 `constant/regexp.ts` 一致：只导出「创建正则」的函数，避免正则字面量在脚本解析阶段抛错。
- *
- * 真实 UA 样本：
- * - 纯血鸿蒙（HarmonyOS NEXT）系统浏览器：
- *   `Mozilla/5.0 (Phone; OpenHarmony 5.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36 ArkWeb/4.1.6.1 Mobile HuaweiBrowser/5.0.3.351`
- * - 纯血鸿蒙 App 内嵌 WebView（部分应用会把型号与版本追加在末尾，形态为 `Harmony/5.0.1.71`）：
- *   `Mozilla/5.0 (Phone; OpenHarmony 5.0) ... ArkWeb/4.1.6.1 Mobile PPDWebUI/10.5.0 ... (Harmony/5.0.1.71)`
- * - 旧版鸿蒙（HarmonyOS 4 及以前，兼容 AOSP）：UA 中同时含 `Android` 与 `HarmonyOS`，
- *   形如 `Mozilla/5.0 (Linux; Android 10; HarmonyOS; ...) ... HuaweiBrowser/12.x`
+/**
+ * 鸿蒙系统 UA 特征集中维护
+ *
+ * 约定与 `constant/regexp.ts` 一致：只导出「创建正则」的函数，避免正则字面量在脚本解析阶段抛错。
+ *
+ * 真实 UA 样本：
+ * - 纯血鸿蒙（HarmonyOS NEXT）系统浏览器：
+ *   `Mozilla/5.0 (Phone; OpenHarmony 5.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36 ArkWeb/4.1.6.1 Mobile HuaweiBrowser/5.0.3.351`
+ * - 纯血鸿蒙 App 内嵌 WebView（部分应用会把型号与版本追加在末尾，形态为 `Harmony/5.0.1.71`）：
+ *   `Mozilla/5.0 (Phone; OpenHarmony 5.0) ... ArkWeb/4.1.6.1 Mobile PPDWebUI/10.5.0 ... (Harmony/5.0.1.71)`
+ * - 旧版鸿蒙（HarmonyOS 4 及以前，兼容 AOSP）：UA 中同时含 `Android` 与 `HarmonyOS`，
+ *   形如 `Mozilla/5.0 (Linux; Android 10; HarmonyOS; ...) ... HuaweiBrowser/12.x`
  */
 
 /** 鸿蒙 ArkWeb 内核标识，纯血鸿蒙（HarmonyOS NEXT）必带，旧版鸿蒙不带 */
@@ -22,11 +22,11 @@ export var regexpHarmonyOSNext = function regexpHarmonyOSNext() {
   return new RegExp('openharmony|harmony/\\d', 'i');
 };
 
-/**
- * 广义鸿蒙标识：覆盖纯血鸿蒙（`OpenHarmony`、`Harmony/5.x`、`ArkWeb`）与旧版鸿蒙（`HarmonyOS`）
- *
- * 注意不要把 `HMSCore` 作为判定依据：它是华为移动服务的 SDK 标识，普通华为 Android 机型
- * （如 ELS-AN00 / Mate 系列）的 UA 里同样带有，会把所有华为安卓机误判成鸿蒙。
+/**
+ * 广义鸿蒙标识：覆盖纯血鸿蒙（`OpenHarmony`、`Harmony/5.x`、`ArkWeb`）与旧版鸿蒙（`HarmonyOS`）
+ *
+ * 注意不要把 `HMSCore` 作为判定依据：它是华为移动服务的 SDK 标识，普通华为 Android 机型
+ * （如 ELS-AN00 / Mate 系列）的 UA 里同样带有，会把所有华为安卓机误判成鸿蒙。
  */
 export var regexpHarmonyOS = function regexpHarmonyOS() {
   return new RegExp('openharmony|harmony/\\d|harmonyos|arkweb', 'i');

package/dist/constant/regexp.js

@@ -1,13 +1,13 @@
-/**
- * 正则集中维护
- *
- * 约定：
- * 1. 这里只导出「创建正则」的函数，不直接导出正则对象。
- * 2. 正则用字符串 + new RegExp 构造，而不是正则字面量。
- *    字面量会在脚本解析阶段就被引擎校验，一旦用到浏览器不支持的语法（如 lookbehind），
- *    解析期就会抛 SyntaxError，导致整个模块加载失败，调用方的 try/catch 也拦不住；
- *    字符串形式把编译推迟到调用时，异常才能被捕获并降级。
- * 3. 校验方法（src/regexp.ts）只负责调用，不内联正则。
+/**
+ * 正则集中维护
+ *
+ * 约定：
+ * 1. 这里只导出「创建正则」的函数，不直接导出正则对象。
+ * 2. 正则用字符串 + new RegExp 构造，而不是正则字面量。
+ *    字面量会在脚本解析阶段就被引擎校验，一旦用到浏览器不支持的语法（如 lookbehind），
+ *    解析期就会抛 SyntaxError，导致整个模块加载失败，调用方的 try/catch 也拦不住；
+ *    字符串形式把编译推迟到调用时，异常才能被捕获并降级。
+ * 3. 校验方法（src/regexp.ts）只负责调用，不内联正则。
  */
 
 /** 邮箱 */

package/dist/download.js

@@ -1,7 +1,7 @@
-/**
- * 下载 Blob 对象为文件
- * @param {string} name 文件名
- * @param {Blob} blob Blob 对象
+/**
+ * 下载 Blob 对象为文件
+ * @param {string} name 文件名
+ * @param {Blob} blob Blob 对象
  */
 export var downloadBlob = function downloadBlob(name, blob) {
   try {

package/dist/os.js

@@ -34,34 +34,34 @@ var isIpad = function isIpad() {
   return platform && navigator.maxTouchPoints > 1 || navigator.userAgent.match(/iPad/i) != null;
 };
 
-/**
- * 是否为 Android
- *
- * 旧版鸿蒙（HarmonyOS 4 及以前）兼容 AOSP，其 UA 中同时包含 `Android`，因此这里会返回 `true`；
- * 若需要区分两者，请优先用 `isHarmonyOS()` 判断。
+/**
+ * 是否为 Android
+ *
+ * 旧版鸿蒙（HarmonyOS 4 及以前）兼容 AOSP，其 UA 中同时包含 `Android`，因此这里会返回 `true`；
+ * 若需要区分两者，请优先用 `isHarmonyOS()` 判断。
  */
 var isAndroid = function isAndroid() {
   var ua = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : getUA();
   return /android/i.test(ua);
 };
 
-/**
- * 是否为鸿蒙系统（广义）
- *
- * 覆盖两类：
- * - 纯血鸿蒙 HarmonyOS NEXT：UA 含 `OpenHarmony` / `ArkWeb`，不含 `Android`
- * - 旧版鸿蒙 HarmonyOS 4 及以前：UA 含 `HarmonyOS` / `HMSCore`，同时含 `Android`
+/**
+ * 是否为鸿蒙系统（广义）
+ *
+ * 覆盖两类：
+ * - 纯血鸿蒙 HarmonyOS NEXT：UA 含 `OpenHarmony` / `ArkWeb`，不含 `Android`
+ * - 旧版鸿蒙 HarmonyOS 4 及以前：UA 含 `HarmonyOS` / `HMSCore`，同时含 `Android`
  */
 var isHarmonyOS = function isHarmonyOS() {
   var ua = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : getUA();
   return regexpHarmonyOS().test(ua);
 };
 
-/**
- * 是否为纯血鸿蒙（HarmonyOS NEXT，5.x）
- *
- * UA 含 `OpenHarmony` 或 `Harmony/x.y`，且不再是 AOSP 兼容架构，不含 `Android`。
- * 需要与旧版鸿蒙区分时使用。
+/**
+ * 是否为纯血鸿蒙（HarmonyOS NEXT，5.x）
+ *
+ * UA 含 `OpenHarmony` 或 `Harmony/x.y`，且不再是 AOSP 兼容架构，不含 `Android`。
+ * 需要与旧版鸿蒙区分时使用。
  */
 var isHarmonyOSNext = function isHarmonyOSNext() {
   var ua = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : getUA();
@@ -69,10 +69,10 @@ var isHarmonyOSNext = function isHarmonyOSNext() {
   return regexpHarmonyOSNext().test(ua) || regexpArkWeb().test(ua);
 };
 
-/**
- * 是否为旧版鸿蒙（HarmonyOS 4 及以前，兼容 AOSP）
- *
- * UA 同时包含 `Android` 与鸿蒙标识，可正常安装 Android APK。
+/**
+ * 是否为旧版鸿蒙（HarmonyOS 4 及以前，兼容 AOSP）
+ *
+ * UA 同时包含 `Android` 与鸿蒙标识，可正常安装 Android APK。
  */
 var isHarmonyOSLegacy = function isHarmonyOSLegacy() {
   var ua = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : getUA();
@@ -101,11 +101,11 @@ var isInWebview = function isInWebview() {
   return /Client|DeutolsWebSDK|UnrealEngine|PlayStation/i.test(ua);
 };
 
-/**
- * 获取操作系统类型
- *
- * 鸿蒙必须最先判断：旧版鸿蒙兼容 AOSP，其 appVersion 与 UA 中同时含 `Linux` 和 `Android`，
- * 若先匹配 `linux` 分支，鸿蒙会被吞成 `linux`，新增的 `harmonyos` 分支永远走不到。
+/**
+ * 获取操作系统类型
+ *
+ * 鸿蒙必须最先判断：旧版鸿蒙兼容 AOSP，其 appVersion 与 UA 中同时含 `Linux` 和 `Android`，
+ * 若先匹配 `linux` 分支，鸿蒙会被吞成 `linux`，新增的 `harmonyos` 分支永远走不到。
  */
 var getOS = function getOS() {
   var userAgent = getUA();

package/dist/regexp.js

@@ -1,9 +1,9 @@
 import { regexpEmail, regexpPhone } from "./constant/regexp";
 
-/**
- * 校验邮箱
- * 正则构造或匹配失败（如浏览器不支持对应语法）时返回 false，不向上抛错
- * @param value 待校验的值
+/**
+ * 校验邮箱
+ * 正则构造或匹配失败（如浏览器不支持对应语法）时返回 false，不向上抛错
+ * @param value 待校验的值
  */
 export var isEmail = function isEmail(value) {
   try {
@@ -13,10 +13,10 @@ export var isEmail = function isEmail(value) {
   }
 };
 
-/**
- * 校验手机号（中国大陆 11 位）
- * 正则构造或匹配失败（如浏览器不支持对应语法）时返回 false，不向上抛错
- * @param value 待校验的值
+/**
+ * 校验手机号（中国大陆 11 位）
+ * 正则构造或匹配失败（如浏览器不支持对应语法）时返回 false，不向上抛错
+ * @param value 待校验的值
  */
 export var isPhone = function isPhone(value) {
   try {

package/dist/storage.js

@@ -5,8 +5,8 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-/**
- * 在 App 壳未提供浏览器存储时，回退到内存存储，避免读写时抛出异常。
+/**
+ * 在 App 壳未提供浏览器存储时，回退到内存存储，避免读写时抛出异常。
  */
 
 var noSupportLS = function noSupportLS(type) {

package/dist/url.js

@@ -85,16 +85,16 @@ var splitUrl = function splitUrl(href) {
   };
 };
 
-/**
- * 通过 history.replaceState 修改地址栏参数，不触发页面刷新。
- *
- * - 同名参数以传入值为准，未传入的原有参数保持不变
- * - 值为 `null` / `undefined` / `''` 时删除该参数
- * - hash 路由（`/#/home?page=1`）时参数写在 hash 内
- *
- * @param params 需要合并进地址的参数
- * @param url 目标地址，默认为当前页面地址
- * @returns 替换后的完整地址
+/**
+ * 通过 history.replaceState 修改地址栏参数，不触发页面刷新。
+ *
+ * - 同名参数以传入值为准，未传入的原有参数保持不变
+ * - 值为 `null` / `undefined` / `''` 时删除该参数
+ * - hash 路由（`/#/home?page=1`）时参数写在 hash 内
+ *
+ * @param params 需要合并进地址的参数
+ * @param url 目标地址，默认为当前页面地址
+ * @returns 替换后的完整地址
  */
 export function replaceUrl(params, url) {
   var _window$history;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wapri/gbase",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "前端基础公共库",
   "keywords": [],
   "license": "MIT",