@snack-kit/lib 0.2.0 → 0.4.0

package/dist/umd/index.global.js

@@ -11625,7 +11625,7 @@ var SnackKit = (function (exports, crypto2, url, http, https, http2, util2, zlib
   });
 
   // package.json
-  var version = "0.2.0";
+  var version = "0.4.0";
 
   // node_modules/axios/lib/helpers/bind.js
   function bind(fn, thisArg) {
@@ -15376,6 +15376,7 @@ var SnackKit = (function (exports, crypto2, url, http, https, http2, util2, zlib
   } = axios_default;
 
   // src/http/context.ts
+  var DEBUGGER_ACTIVE_KEY = "__snackkit_debugger__active";
   var HttpContext = class {
     constructor() {
       this._store = /* @__PURE__ */ new Map();
@@ -15384,12 +15385,24 @@ var SnackKit = (function (exports, crypto2, url, http, https, http2, util2, zlib
     /**
      * 加载服务地址映射
      *
+     * 支持三种调用方式：
+     * - **传入字符串**：作为网关地址，自动请求 `GET /ngw/context` 获取映射表
+     * - **传入对象**：直接注入键值映射，不发起网络请求
+     * - **不传参数**：
+     *   - 生产环境（`NODE_ENV === 'production'`）：以当前页面 `Origin` 为网关地址自动加载
+     *   - 开发环境：立即返回，不做任何操作（应由 `Debugger.init()` 接管加载流程）
+     *
      * 远程加载时，响应中的 `$info` 元数据字段会被单独存储，不计入路由映射表。
      *
-     * @param source 远程加载传入网关 URL；本地注入传入键值对象
+     * @param source 网关 URL / 键值对象 / 省略
      * @param timeout 远程加载超时（ms），默认 5000
      *
-     * @example 远程加载
+     * @example 不传参——生产环境自动使用当前页面 Origin
+     * ```ts
+     * await Context.load()
+     * ```
+     *
+     * @example 传入网关地址
      * ```ts
      * await Context.load('http://172.16.32.155:20000', 3000)
      * ```
@@ -15400,6 +15413,11 @@ var SnackKit = (function (exports, crypto2, url, http, https, http2, util2, zlib
      * ```
      */
     async load(source, timeout = 5e3) {
+      if (source === void 0) {
+        if (globalThis[DEBUGGER_ACTIVE_KEY]) return;
+        if (!Origin) return;
+        source = Origin;
+      }
       if (typeof source === "string") {
         const url2 = `${source}/ngw/context`;
         const res = await axios_default.get(url2, { timeout });
@@ -15553,20 +15571,35 @@ var SnackKit = (function (exports, crypto2, url, http, https, http2, util2, zlib
       Unregister(cancelId);
     }
   }
-  function Get(url2, config) {
-    return Request({ ...config, method: "GET", url: url2 });
+  function Get(urlOrConfig, config) {
+    if (typeof urlOrConfig === "string") {
+      return Request({ ...config, method: "GET", url: urlOrConfig });
+    }
+    return Request({ ...urlOrConfig, method: "GET" });
   }
-  function Post(url2, data, config) {
-    return Request({ ...config, method: "POST", url: url2, data });
+  function Post(urlOrConfig, data, config) {
+    if (typeof urlOrConfig === "string") {
+      return Request({ ...config, method: "POST", url: urlOrConfig, data });
+    }
+    return Request({ ...urlOrConfig, method: "POST" });
   }
-  function Put(url2, data, config) {
-    return Request({ ...config, method: "PUT", url: url2, data });
+  function Put(urlOrConfig, data, config) {
+    if (typeof urlOrConfig === "string") {
+      return Request({ ...config, method: "PUT", url: urlOrConfig, data });
+    }
+    return Request({ ...urlOrConfig, method: "PUT" });
   }
-  function Patch(url2, data, config) {
-    return Request({ ...config, method: "PATCH", url: url2, data });
+  function Patch(urlOrConfig, data, config) {
+    if (typeof urlOrConfig === "string") {
+      return Request({ ...config, method: "PATCH", url: urlOrConfig, data });
+    }
+    return Request({ ...urlOrConfig, method: "PATCH" });
   }
-  function Del(url2, config) {
-    return Request({ ...config, method: "DELETE", url: url2 });
+  function Del(urlOrConfig, config) {
+    if (typeof urlOrConfig === "string") {
+      return Request({ ...config, method: "DELETE", url: urlOrConfig });
+    }
+    return Request({ ...urlOrConfig, method: "DELETE" });
   }
 
   // src/debugger/debugger.ts
@@ -16139,6 +16172,7 @@ var SnackKit = (function (exports, crypto2, url, http, https, http2, util2, zlib
      * ```
      */
     static async init(options) {
+      globalThis[DEBUGGER_ACTIVE_KEY] = true;
       const instance = new _Debugger({ timeout: 1e4, ...options });
       instance.injectStyle();
       instance.buildDOM();
@@ -16429,6 +16463,232 @@ var SnackKit = (function (exports, crypto2, url, http, https, http2, util2, zlib
       this.footerEl.className = `dbg-footer${cls ? ` ${cls}` : ""}`;
     }
   };
+
+  // src/utils/detect.ts
+  var _toString = (val) => Object.prototype.toString.call(val);
+  var IsNumber = (val) => !isNaN(parseFloat(val)) && isFinite(val);
+  var IsRealNumber = (val) => typeof val === "number" && !isNaN(val);
+  var IsString = (val) => _toString(val) === "[object String]";
+  var IsBoolean = (val) => _toString(val) === "[object Boolean]";
+  var IsArray = (val) => Array.isArray(val);
+  var IsFunction = (val) => _toString(val) === "[object Function]";
+  var IsObject = (val) => _toString(val) === "[object Object]";
+  var IsNull = (val) => val === null || val === void 0 || val === "";
+  var IsEqual = (a, b) => {
+    if (a === b) return true;
+    if (typeof a !== typeof b) return false;
+    if (a === null || b === null) return false;
+    if (typeof a !== "object") return false;
+    if (Array.isArray(a) !== Array.isArray(b)) return false;
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length) return false;
+    for (const key of keysA) {
+      if (!IsEqual(a[key], b[key])) {
+        return false;
+      }
+    }
+    return true;
+  };
+
+  // src/utils/validate.ts
+  var REGEX = {
+    /** 手机号（宽松：13-19 开头） */
+    phone: /^(?:(?:\+|00)86)?1[3-9]\d{9}$/,
+    /** 手机号（严谨，基于工信部 2019 年最新公布号段） */
+    strictPhone: /^(?:(?:\+|00)86)?1(?:(?:3\d)|(?:4[5-79])|(?:5[0-35-9])|(?:6[5-7])|(?:7[0-8])|(?:8\d)|(?:9[189]))\d{8}$/,
+    /** 邮箱（符合 RFC 标准） */
+    email: /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-_0-9]+\.)+[a-zA-Z]{2,}))$/,
+    /** URL（支持 http / https / ftp） */
+    url: /^(https?|ftp):\/\/[\w\-]+(\.[\w\-]+)+([\w\-.,@?^=%&:/~+#]*[\w\-@?^=%&/~+#])?/,
+    /** IPv4 地址 */
+    ipv4: /^((25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/,
+    /** 整数（含负数和零） */
+    integer: /^[+-]?\d+$/,
+    /** 正整数（不含零） */
+    positiveInteger: /^[1-9]\d*$/,
+    /** 二代身份证 */
+    idcard: /^[1-9]\d{5}(?:18|19|20)\d{2}(?:0[1-9]|10|11|12)(?:0[1-9]|[1-2]\d|30|31)\d{3}[\dXx]$/,
+    /** 日期（宽松，如 2022-9-1） */
+    date: /^\d{1,4}-(1[0-2]|0?[1-9])-(0?[1-9]|[1-2]\d|30|31)$/,
+    /** 16 进制颜色值 */
+    color: /^#?([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$/
+  };
+  var IsEmail = (val) => REGEX.email.test(val);
+  var IsPhone = (val) => REGEX.phone.test(val);
+  var IsUrl = (val) => REGEX.url.test(val);
+  var IsIpv4 = (val) => REGEX.ipv4.test(val);
+  var IsInteger = (val) => REGEX.integer.test(val);
+  var IsPositiveInteger = (val) => REGEX.positiveInteger.test(val);
+
+  // src/utils/array.ts
+  var Unique = (arr) => [...new Set(arr)];
+  var UniqueByKey = (arr, key) => {
+    const seen = /* @__PURE__ */ new Set();
+    const result = [];
+    for (const item of arr) {
+      const k = item[key];
+      if (!seen.has(k)) {
+        seen.add(k);
+        result.push(item);
+      }
+    }
+    return result;
+  };
+  var Minus = (arr, other) => {
+    const otherSet = new Set(other);
+    return arr.filter((item) => !otherSet.has(item));
+  };
+
+  // src/utils/object.ts
+  var DeepClone = (obj) => {
+    if (typeof structuredClone === "function") {
+      return structuredClone(obj);
+    }
+    return JSON.parse(JSON.stringify(obj));
+  };
+  var CleanObject = (obj) => {
+    const result = {};
+    for (const key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        const val = obj[key];
+        if (val !== null && val !== void 0) {
+          result[key] = val;
+        }
+      }
+    }
+    return result;
+  };
+  var Pick = (obj, keys) => {
+    const result = {};
+    for (const key of keys) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        result[key] = obj[key];
+      }
+    }
+    return result;
+  };
+  var Omit = (obj, keys) => {
+    const excludeSet = new Set(keys);
+    const result = {};
+    for (const key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key) && !excludeSet.has(key)) {
+        result[key] = obj[key];
+      }
+    }
+    return result;
+  };
+
+  // src/utils/func.ts
+  var Debounce = (fn, delay = 300) => {
+    let timer = null;
+    return function(...args) {
+      if (timer !== null) clearTimeout(timer);
+      timer = setTimeout(() => {
+        fn.apply(this, args);
+        timer = null;
+      }, delay);
+    };
+  };
+  var Throttle = (fn, delay = 50) => {
+    let lastTime = 0;
+    return function(...args) {
+      const now = Date.now();
+      if (now - lastTime >= delay) {
+        lastTime = now;
+        fn.apply(this, args);
+      }
+    };
+  };
+  var Delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+  // src/utils/string.ts
+  var UUID = () => {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+      return crypto.randomUUID();
+    }
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+      const arr = new Uint8Array(1);
+      crypto.getRandomValues(arr);
+      const r = arr[0] & 15;
+      const v = c === "x" ? r : r & 3 | 8;
+      return v.toString(16);
+    });
+  };
+  var GetURLParam = (name, url2 = typeof window !== "undefined" ? window.location.href : "") => {
+    try {
+      return new URL(url2).searchParams.get(name) ?? "";
+    } catch {
+      return "";
+    }
+  };
+  var GetURLParams = (url2 = typeof window !== "undefined" ? window.location.href : "") => {
+    try {
+      const result = {};
+      new URL(url2).searchParams.forEach((val, key) => {
+        result[key] = val;
+      });
+      return result;
+    } catch {
+      return {};
+    }
+  };
+  var ObjectToQuery = (obj) => {
+    const params = new URLSearchParams();
+    for (const [key, val] of Object.entries(obj)) {
+      if (val !== null && val !== void 0) {
+        params.append(key, String(val));
+      }
+    }
+    const str = params.toString();
+    return str ? `?${str}` : "";
+  };
+  var QueryToObject = (query) => {
+    const str = query.startsWith("?") ? query.slice(1) : query;
+    const result = {};
+    new URLSearchParams(str).forEach((val, key) => {
+      result[key] = val;
+    });
+    return result;
+  };
+
+  // src/utils/time.ts
+  var FormatDate = (date = /* @__PURE__ */ new Date(), format = "yyyy-MM-dd HH:mm:ss") => {
+    const d = date instanceof Date ? date : new Date(date);
+    if (isNaN(d.getTime())) return "";
+    const map = {
+      "M+": d.getMonth() + 1,
+      "d+": d.getDate(),
+      "H+": d.getHours(),
+      "m+": d.getMinutes(),
+      "s+": d.getSeconds()
+    };
+    let result = format.replace(
+      /(y+)/,
+      (_, p) => String(d.getFullYear()).slice(4 - p.length)
+    );
+    for (const [pattern, value] of Object.entries(map)) {
+      result = result.replace(
+        new RegExp(`(${pattern})`),
+        (_, p) => String(value).padStart(p.length, "0")
+      );
+    }
+    return result;
+  };
+  var GetDateOffset = (date = /* @__PURE__ */ new Date(), days = 0, format = "yyyy-MM-dd HH:mm:ss") => {
+    const d = new Date(date.getTime());
+    d.setDate(d.getDate() + days);
+    return FormatDate(d, format);
+  };
+  var GetDayRange = (date = /* @__PURE__ */ new Date()) => {
+    const y = date.getFullYear();
+    const m = date.getMonth();
+    const d = date.getDate();
+    return {
+      start: new Date(y, m, d, 0, 0, 0, 0).getTime(),
+      end: new Date(y, m, d, 23, 59, 59, 999).getTime()
+    };
+  };
   /*! Bundled license information:
 
   mime-db/index.js:
@@ -16450,17 +16710,52 @@ var SnackKit = (function (exports, crypto2, url, http, https, http2, util2, zlib
 
   exports.Cancel = Cancel2;
   exports.CancelAll = CancelAll;
+  exports.CleanObject = CleanObject;
   exports.Context = Context;
   exports.Ctx = Ctx;
+  exports.DEBUGGER_ACTIVE_KEY = DEBUGGER_ACTIVE_KEY;
+  exports.Debounce = Debounce;
   exports.Debugger = Debugger;
+  exports.DeepClone = DeepClone;
   exports.Del = Del;
+  exports.Delay = Delay;
+  exports.FormatDate = FormatDate;
   exports.Get = Get;
+  exports.GetDateOffset = GetDateOffset;
+  exports.GetDayRange = GetDayRange;
+  exports.GetURLParam = GetURLParam;
+  exports.GetURLParams = GetURLParams;
   exports.HttpContext = HttpContext;
+  exports.IsArray = IsArray;
+  exports.IsBoolean = IsBoolean;
+  exports.IsEmail = IsEmail;
+  exports.IsEqual = IsEqual;
+  exports.IsFunction = IsFunction;
+  exports.IsInteger = IsInteger;
+  exports.IsIpv4 = IsIpv4;
+  exports.IsNull = IsNull;
+  exports.IsNumber = IsNumber;
+  exports.IsObject = IsObject;
+  exports.IsPhone = IsPhone;
+  exports.IsPositiveInteger = IsPositiveInteger;
+  exports.IsRealNumber = IsRealNumber;
+  exports.IsString = IsString;
+  exports.IsUrl = IsUrl;
+  exports.Minus = Minus;
+  exports.ObjectToQuery = ObjectToQuery;
+  exports.Omit = Omit;
   exports.Origin = Origin;
   exports.Patch = Patch;
+  exports.Pick = Pick;
   exports.Post = Post;
   exports.Put = Put;
+  exports.QueryToObject = QueryToObject;
+  exports.REGEX = REGEX;
   exports.Request = Request;
+  exports.Throttle = Throttle;
+  exports.UUID = UUID;
+  exports.Unique = Unique;
+  exports.UniqueByKey = UniqueByKey;
   exports.VERSION = version;
 
   return exports;