@ks-web/use 0.0.1 → 0.0.4

package/README.md

@@ -1,16 +1,16 @@
-# Vant Use
+# Ks Use
 
-Built-in composition APIs of Vant.
+Built-in composition APIs of ks.
 
 ## Install
 
 ```shell
 # with npm
-npm i @vant/use
+npm i @ks-web/use
 
 # with yarn
-yarn add @vant/use
+yarn add @ks-web/use
 
 # with pnpm
-pnpm add @vant/use
+pnpm add @ks-web/use
 ```

package/dist/index.cjs.js

@@ -38,6 +38,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -251,6 +255,7 @@ var require_get_intrinsic = __commonJS({
       "%encodeURIComponent%": encodeURIComponent,
       "%Error%": Error,
       "%eval%": eval,
+      // eslint-disable-line no-eval
       "%EvalError%": EvalError,
       "%Float32Array%": typeof Float32Array === "undefined" ? undefined2 : Float32Array,
       "%Float64Array%": typeof Float64Array === "undefined" ? undefined2 : Float64Array,
@@ -1089,6 +1094,7 @@ var require_side_channel = __commonJS({
         node.value = value;
       } else {
         objects.next = {
+          // eslint-disable-line no-param-reassign
           key,
           next: objects.next,
           value
@@ -1427,6 +1433,7 @@ var require_stringify = __commonJS({
       encodeValuesOnly: false,
       format: defaultFormat,
       formatter: formats.formatters[defaultFormat],
+      // deprecated
       indices: false,
       serializeDate: function serializeDate(date) {
         return toISO.call(date);
@@ -1821,6 +1828,7 @@ var require_parse = __commonJS({
         comma: typeof opts.comma === "boolean" ? opts.comma : defaults2.comma,
         decoder: typeof opts.decoder === "function" ? opts.decoder : defaults2.decoder,
         delimiter: typeof opts.delimiter === "string" || utils.isRegExp(opts.delimiter) ? opts.delimiter : defaults2.delimiter,
+        // eslint-disable-next-line no-implicit-coercion, no-extra-parens
         depth: typeof opts.depth === "number" || opts.depth === false ? +opts.depth : defaults2.depth,
         ignoreQueryPrefix: opts.ignoreQueryPrefix === true,
         interpretNumericEntities: typeof opts.interpretNumericEntities === "boolean" ? opts.interpretNumericEntities : defaults2.interpretNumericEntities,
@@ -2643,8 +2651,12 @@ function useEventListener(type, listener, options = {}) {
     return;
   }
   const { target = window, passive = false, capture = false } = options;
+  let cleaned = false;
   let attached;
   const add = (target2) => {
+    if (cleaned) {
+      return;
+    }
     const element = (0, import_vue7.unref)(target2);
     if (element && !attached) {
       element.addEventListener(type, listener, {
@@ -2655,6 +2667,9 @@ function useEventListener(type, listener, options = {}) {
     }
   };
   const remove = (target2) => {
+    if (cleaned) {
+      return;
+    }
     const element = (0, import_vue7.unref)(target2);
     if (element && attached) {
       element.removeEventListener(type, listener, capture);
@@ -2664,12 +2679,18 @@ function useEventListener(type, listener, options = {}) {
   (0, import_vue7.onUnmounted)(() => remove(target));
   (0, import_vue7.onDeactivated)(() => remove(target));
   onMountedOrActivated(() => add(target));
+  let stopWatch;
   if ((0, import_vue7.isRef)(target)) {
-    (0, import_vue7.watch)(target, (val, oldVal) => {
+    stopWatch = (0, import_vue7.watch)(target, (val, oldVal) => {
       remove(oldVal);
       add(val);
     });
   }
+  return () => {
+    stopWatch == null ? void 0 : stopWatch();
+    remove(target);
+    cleaned = true;
+  };
 }
 
 // src/useClickAway/index.ts
@@ -3116,6 +3137,7 @@ var utils_default = {
   isHTMLForm,
   hasOwnProperty,
   hasOwnProp: hasOwnProperty,
+  // an alias to avoid ESLint no-prototype-builtins detection
   reduceDescriptors,
   freezeMethods,
   toObjectSet,
@@ -3149,14 +3171,18 @@ function AxiosError(message, code, config, request, response) {
 utils_default.inherits(AxiosError, Error, {
   toJSON: function toJSON() {
     return {
+      // Standard
       message: this.message,
       name: this.name,
+      // Microsoft
       description: this.description,
       number: this.number,
+      // Mozilla
       fileName: this.fileName,
       lineNumber: this.lineNumber,
       columnNumber: this.columnNumber,
       stack: this.stack,
+      // Axios
       config: utils_default.toJSONObject(this.config),
       code: this.code,
       status: this.response && this.response.status ? this.response.status : null
@@ -3178,6 +3204,7 @@ var descriptors = {};
   "ERR_CANCELED",
   "ERR_NOT_SUPPORT",
   "ERR_INVALID_URL"
+  // eslint-disable-next-line func-names
 ].forEach((code) => {
   descriptors[code] = { value: code };
 });
@@ -3267,6 +3294,7 @@ function toFormData(obj, formData, options) {
         key = removeBrackets(key);
         arr.forEach(function each(el, index) {
           !(utils_default.isUndefined(el) || el === null) && formData.append(
+            // eslint-disable-next-line no-nested-ternary
             indexes === true ? renderKey([key], index, dots) : indexes === null ? key : key + "[]",
             convertValue(el)
           );
@@ -3379,6 +3407,14 @@ var InterceptorManager = class {
   constructor() {
     this.handlers = [];
   }
+  /**
+   * Add a new interceptor to the stack
+   *
+   * @param {Function} fulfilled The function to handle `then` for a `Promise`
+   * @param {Function} rejected The function to handle `reject` for a `Promise`
+   *
+   * @return {Number} An ID used to remove interceptor later
+   */
   use(fulfilled, rejected, options) {
     this.handlers.push({
       fulfilled,
@@ -3388,16 +3424,38 @@ var InterceptorManager = class {
     });
     return this.handlers.length - 1;
   }
+  /**
+   * Remove an interceptor from the stack
+   *
+   * @param {Number} id The ID that was returned by `use`
+   *
+   * @returns {Boolean} `true` if the interceptor was removed, `false` otherwise
+   */
   eject(id) {
     if (this.handlers[id]) {
       this.handlers[id] = null;
     }
   }
+  /**
+   * Clear all interceptors from the stack
+   *
+   * @returns {void}
+   */
   clear() {
     if (this.handlers) {
       this.handlers = [];
     }
   }
+  /**
+   * Iterate over all the registered interceptors
+   *
+   * This method is particularly useful for skipping over any
+   * interceptors that may have become `null` calling `eject`.
+   *
+   * @param {Function} fn The function to call for each interceptor
+   *
+   * @returns {void}
+   */
   forEach(fn) {
     utils_default.forEach(this.handlers, function forEachHandler(h) {
       if (h !== null) {
@@ -3430,7 +3488,8 @@ var isStandardBrowserEnv = (() => {
   return typeof window !== "undefined" && typeof document !== "undefined";
 })();
 var isStandardBrowserWebWorkerEnv = (() => {
-  return typeof WorkerGlobalScope !== "undefined" && self instanceof WorkerGlobalScope && typeof self.importScripts === "function";
+  return typeof WorkerGlobalScope !== "undefined" && // eslint-disable-next-line no-undef
+  self instanceof WorkerGlobalScope && typeof self.importScripts === "function";
 })();
 var browser_default = {
   isBrowser: true,
@@ -3593,6 +3652,10 @@ var defaults = {
     }
     return data;
   }],
+  /**
+   * A timeout in milliseconds to abort a request. If set to 0 (default) a
+   * timeout is not created.
+   */
   timeout: 0,
   xsrfCookieName: "XSRF-TOKEN",
   xsrfHeaderName: "X-XSRF-TOKEN",
@@ -3921,44 +3984,50 @@ function settle(resolve, reject, response) {
 }
 
 // ../../node_modules/.pnpm/axios@1.3.3/node_modules/axios/lib/helpers/cookies.js
-var cookies_default = browser_default.isStandardBrowserEnv ? function standardBrowserEnv() {
-  return {
-    write: function write(name, value, expires, path, domain, secure) {
-      const cookie = [];
-      cookie.push(name + "=" + encodeURIComponent(value));
-      if (utils_default.isNumber(expires)) {
-        cookie.push("expires=" + new Date(expires).toGMTString());
-      }
-      if (utils_default.isString(path)) {
-        cookie.push("path=" + path);
-      }
-      if (utils_default.isString(domain)) {
-        cookie.push("domain=" + domain);
-      }
-      if (secure === true) {
-        cookie.push("secure");
-      }
-      document.cookie = cookie.join("; ");
-    },
-    read: function read(name) {
-      const match = document.cookie.match(new RegExp("(^|;\\s*)(" + name + ")=([^;]*)"));
-      return match ? decodeURIComponent(match[3]) : null;
-    },
-    remove: function remove(name) {
-      this.write(name, "", Date.now() - 864e5);
-    }
-  };
-}() : function nonStandardBrowserEnv() {
-  return {
-    write: function write() {
-    },
-    read: function read() {
-      return null;
-    },
-    remove: function remove() {
-    }
-  };
-}();
+var cookies_default = browser_default.isStandardBrowserEnv ? (
+  // Standard browser envs support document.cookie
+  function standardBrowserEnv() {
+    return {
+      write: function write(name, value, expires, path, domain, secure) {
+        const cookie = [];
+        cookie.push(name + "=" + encodeURIComponent(value));
+        if (utils_default.isNumber(expires)) {
+          cookie.push("expires=" + new Date(expires).toGMTString());
+        }
+        if (utils_default.isString(path)) {
+          cookie.push("path=" + path);
+        }
+        if (utils_default.isString(domain)) {
+          cookie.push("domain=" + domain);
+        }
+        if (secure === true) {
+          cookie.push("secure");
+        }
+        document.cookie = cookie.join("; ");
+      },
+      read: function read(name) {
+        const match = document.cookie.match(new RegExp("(^|;\\s*)(" + name + ")=([^;]*)"));
+        return match ? decodeURIComponent(match[3]) : null;
+      },
+      remove: function remove(name) {
+        this.write(name, "", Date.now() - 864e5);
+      }
+    };
+  }()
+) : (
+  // Non standard browser env (web workers, react-native) lack needed support.
+  function nonStandardBrowserEnv() {
+    return {
+      write: function write() {
+      },
+      read: function read() {
+        return null;
+      },
+      remove: function remove() {
+      }
+    };
+  }()
+);
 
 // ../../node_modules/.pnpm/axios@1.3.3/node_modules/axios/lib/helpers/isAbsoluteURL.js
 function isAbsoluteURL(url) {
@@ -3979,38 +4048,45 @@ function buildFullPath(baseURL, requestedURL) {
 }
 
 // ../../node_modules/.pnpm/axios@1.3.3/node_modules/axios/lib/helpers/isURLSameOrigin.js
-var isURLSameOrigin_default = browser_default.isStandardBrowserEnv ? function standardBrowserEnv2() {
-  const msie = /(msie|trident)/i.test(navigator.userAgent);
-  const urlParsingNode = document.createElement("a");
-  let originURL;
-  function resolveURL(url) {
-    let href = url;
-    if (msie) {
+var isURLSameOrigin_default = browser_default.isStandardBrowserEnv ? (
+  // Standard browser envs have full support of the APIs needed to test
+  // whether the request URL is of the same origin as current location.
+  function standardBrowserEnv2() {
+    const msie = /(msie|trident)/i.test(navigator.userAgent);
+    const urlParsingNode = document.createElement("a");
+    let originURL;
+    function resolveURL(url) {
+      let href = url;
+      if (msie) {
+        urlParsingNode.setAttribute("href", href);
+        href = urlParsingNode.href;
+      }
       urlParsingNode.setAttribute("href", href);
-      href = urlParsingNode.href;
+      return {
+        href: urlParsingNode.href,
+        protocol: urlParsingNode.protocol ? urlParsingNode.protocol.replace(/:$/, "") : "",
+        host: urlParsingNode.host,
+        search: urlParsingNode.search ? urlParsingNode.search.replace(/^\?/, "") : "",
+        hash: urlParsingNode.hash ? urlParsingNode.hash.replace(/^#/, "") : "",
+        hostname: urlParsingNode.hostname,
+        port: urlParsingNode.port,
+        pathname: urlParsingNode.pathname.charAt(0) === "/" ? urlParsingNode.pathname : "/" + urlParsingNode.pathname
+      };
     }
-    urlParsingNode.setAttribute("href", href);
-    return {
-      href: urlParsingNode.href,
-      protocol: urlParsingNode.protocol ? urlParsingNode.protocol.replace(/:$/, "") : "",
-      host: urlParsingNode.host,
-      search: urlParsingNode.search ? urlParsingNode.search.replace(/^\?/, "") : "",
-      hash: urlParsingNode.hash ? urlParsingNode.hash.replace(/^#/, "") : "",
-      hostname: urlParsingNode.hostname,
-      port: urlParsingNode.port,
-      pathname: urlParsingNode.pathname.charAt(0) === "/" ? urlParsingNode.pathname : "/" + urlParsingNode.pathname
+    originURL = resolveURL(window.location.href);
+    return function isURLSameOrigin(requestURL) {
+      const parsed = utils_default.isString(requestURL) ? resolveURL(requestURL) : requestURL;
+      return parsed.protocol === originURL.protocol && parsed.host === originURL.host;
     };
-  }
-  originURL = resolveURL(window.location.href);
-  return function isURLSameOrigin(requestURL) {
-    const parsed = utils_default.isString(requestURL) ? resolveURL(requestURL) : requestURL;
-    return parsed.protocol === originURL.protocol && parsed.host === originURL.host;
-  };
-}() : function nonStandardBrowserEnv2() {
-  return function isURLSameOrigin() {
-    return true;
-  };
-}();
+  }()
+) : (
+  // Non standard browser envs (web workers, react-native) lack needed support.
+  function nonStandardBrowserEnv2() {
+    return function isURLSameOrigin() {
+      return true;
+    };
+  }()
+);
 
 // ../../node_modules/.pnpm/axios@1.3.3/node_modules/axios/lib/helpers/parseProtocol.js
 function parseProtocol(url) {
@@ -4455,6 +4531,14 @@ var Axios = class {
       response: new InterceptorManager_default()
     };
   }
+  /**
+   * Dispatch a request
+   *
+   * @param {String|Object} configOrUrl The config specific for this request (merged with this.defaults)
+   * @param {?Object} config
+   *
+   * @returns {Promise} The Promise to be fulfilled
+   */
   request(configOrUrl, config) {
     if (typeof configOrUrl === "string") {
       config = config || {};
@@ -4614,11 +4698,17 @@ var CancelToken = class {
       resolvePromise(token.reason);
     });
   }
+  /**
+   * Throws a `CanceledError` if cancellation has been requested.
+   */
   throwIfRequested() {
     if (this.reason) {
       throw this.reason;
     }
   }
+  /**
+   * Subscribe to the cancel signal
+   */
   subscribe(listener) {
     if (this.reason) {
       listener(this.reason);
@@ -4630,6 +4720,9 @@ var CancelToken = class {
       this._listeners = [listener];
     }
   }
+  /**
+   * Unsubscribe from the cancel signal
+   */
   unsubscribe(listener) {
     if (!this._listeners) {
       return;
@@ -4639,6 +4732,10 @@ var CancelToken = class {
       this._listeners.splice(index, 1);
     }
   }
+  /**
+   * Returns an object that contains a new `CancelToken` and a function that, when called,
+   * cancels the `CancelToken`.
+   */
   static source() {
     let cancel;
     const token = new CancelToken(function executor(c) {
@@ -5091,6 +5188,7 @@ function mergeInterceptor(httpOptions, httpInterceptorMap) {
 var CancelToken3 = axios_default.CancelToken;
 var HttpClient = class {
   constructor(httpOptions) {
+    // 通用请求客户端封装
     this.get = (url, param, requestOptions) => this.request(url, REQUEST_METHOD.get, param, requestOptions);
     this.post = (url, param, requestOptions) => this.request(url, REQUEST_METHOD.post, param, requestOptions);
     this.put = (url, param, requestOptions) => this.request(url, REQUEST_METHOD.put, param, requestOptions);
@@ -5273,7 +5371,7 @@ var customWatermark = (text = "KYE", el = ".ksui-container, .van-dialog, .ksui-c
   document.querySelector("head").appendChild(style);
 };
 function useWaterMark(employeeNumber, el = ".ksui-container, .van-dialog, .ksui-card, .ks-table", color = "#F0F3F9") {
-  let date = new Date();
+  let date = /* @__PURE__ */ new Date();
   const f = (num) => {
     let str = String(num);
     return str.length === 1 ? "0" + str : str;
@@ -5321,7 +5419,7 @@ var debounce = (func, wait, options) => {
     return lastCallTime === void 0 || timeSinceLastCall >= wait || timeSinceLastCall < 0 || maxing && timeSinceLastInvoke >= maxWait;
   }
   function timerExpired() {
-    var time = new Date().getTime();
+    var time = (/* @__PURE__ */ new Date()).getTime();
     if (shouldInvoke(time)) {
       return trailingEdge(time);
     }
@@ -5343,10 +5441,10 @@ var debounce = (func, wait, options) => {
     lastArgs = lastCallTime = lastThis = timerId = void 0;
   }
   function flush() {
-    return timerId === void 0 ? result : trailingEdge(new Date().getTime());
+    return timerId === void 0 ? result : trailingEdge((/* @__PURE__ */ new Date()).getTime());
   }
   function debounced() {
-    var time = new Date().getTime(), isInvoking = shouldInvoke(time);
+    var time = (/* @__PURE__ */ new Date()).getTime(), isInvoking = shouldInvoke(time);
     lastArgs = arguments;
     lastThis = this;
     lastCallTime = time;

package/dist/index.esm.mjs

@@ -33,6 +33,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -245,6 +249,7 @@ var require_get_intrinsic = __commonJS({
       "%encodeURIComponent%": encodeURIComponent,
       "%Error%": Error,
       "%eval%": eval,
+      // eslint-disable-line no-eval
       "%EvalError%": EvalError,
       "%Float32Array%": typeof Float32Array === "undefined" ? undefined2 : Float32Array,
       "%Float64Array%": typeof Float64Array === "undefined" ? undefined2 : Float64Array,
@@ -1083,6 +1088,7 @@ var require_side_channel = __commonJS({
         node.value = value;
       } else {
         objects.next = {
+          // eslint-disable-line no-param-reassign
           key,
           next: objects.next,
           value
@@ -1421,6 +1427,7 @@ var require_stringify = __commonJS({
       encodeValuesOnly: false,
       format: defaultFormat,
       formatter: formats.formatters[defaultFormat],
+      // deprecated
       indices: false,
       serializeDate: function serializeDate(date) {
         return toISO.call(date);
@@ -1815,6 +1822,7 @@ var require_parse = __commonJS({
         comma: typeof opts.comma === "boolean" ? opts.comma : defaults2.comma,
         decoder: typeof opts.decoder === "function" ? opts.decoder : defaults2.decoder,
         delimiter: typeof opts.delimiter === "string" || utils.isRegExp(opts.delimiter) ? opts.delimiter : defaults2.delimiter,
+        // eslint-disable-next-line no-implicit-coercion, no-extra-parens
         depth: typeof opts.depth === "number" || opts.depth === false ? +opts.depth : defaults2.depth,
         ignoreQueryPrefix: opts.ignoreQueryPrefix === true,
         interpretNumericEntities: typeof opts.interpretNumericEntities === "boolean" ? opts.interpretNumericEntities : defaults2.interpretNumericEntities,
@@ -2595,7 +2603,13 @@ function useCountDown(options) {
 import { unref as unref3 } from "vue";
 
 // src/useEventListener/index.ts
-import { watch, isRef, unref as unref2, onUnmounted as onUnmounted2, onDeactivated as onDeactivated2 } from "vue";
+import {
+  watch,
+  isRef,
+  unref as unref2,
+  onUnmounted as onUnmounted2,
+  onDeactivated as onDeactivated2
+} from "vue";
 
 // src/onMountedOrActivated/index.ts
 import { nextTick, onMounted, onActivated as onActivated2 } from "vue";
@@ -2620,8 +2634,12 @@ function useEventListener(type, listener, options = {}) {
     return;
   }
   const { target = window, passive = false, capture = false } = options;
+  let cleaned = false;
   let attached;
   const add = (target2) => {
+    if (cleaned) {
+      return;
+    }
     const element = unref2(target2);
     if (element && !attached) {
       element.addEventListener(type, listener, {
@@ -2632,6 +2650,9 @@ function useEventListener(type, listener, options = {}) {
     }
   };
   const remove = (target2) => {
+    if (cleaned) {
+      return;
+    }
     const element = unref2(target2);
     if (element && attached) {
       element.removeEventListener(type, listener, capture);
@@ -2641,12 +2662,18 @@ function useEventListener(type, listener, options = {}) {
   onUnmounted2(() => remove(target));
   onDeactivated2(() => remove(target));
   onMountedOrActivated(() => add(target));
+  let stopWatch;
   if (isRef(target)) {
-    watch(target, (val, oldVal) => {
+    stopWatch = watch(target, (val, oldVal) => {
       remove(oldVal);
       add(val);
     });
   }
+  return () => {
+    stopWatch == null ? void 0 : stopWatch();
+    remove(target);
+    cleaned = true;
+  };
 }
 
 // src/useClickAway/index.ts
@@ -3093,6 +3120,7 @@ var utils_default = {
   isHTMLForm,
   hasOwnProperty,
   hasOwnProp: hasOwnProperty,
+  // an alias to avoid ESLint no-prototype-builtins detection
   reduceDescriptors,
   freezeMethods,
   toObjectSet,
@@ -3126,14 +3154,18 @@ function AxiosError(message, code, config, request, response) {
 utils_default.inherits(AxiosError, Error, {
   toJSON: function toJSON() {
     return {
+      // Standard
       message: this.message,
       name: this.name,
+      // Microsoft
       description: this.description,
       number: this.number,
+      // Mozilla
       fileName: this.fileName,
       lineNumber: this.lineNumber,
       columnNumber: this.columnNumber,
       stack: this.stack,
+      // Axios
       config: utils_default.toJSONObject(this.config),
       code: this.code,
       status: this.response && this.response.status ? this.response.status : null
@@ -3155,6 +3187,7 @@ var descriptors = {};
   "ERR_CANCELED",
   "ERR_NOT_SUPPORT",
   "ERR_INVALID_URL"
+  // eslint-disable-next-line func-names
 ].forEach((code) => {
   descriptors[code] = { value: code };
 });
@@ -3244,6 +3277,7 @@ function toFormData(obj, formData, options) {
         key = removeBrackets(key);
         arr.forEach(function each(el, index) {
           !(utils_default.isUndefined(el) || el === null) && formData.append(
+            // eslint-disable-next-line no-nested-ternary
             indexes === true ? renderKey([key], index, dots) : indexes === null ? key : key + "[]",
             convertValue(el)
           );
@@ -3356,6 +3390,14 @@ var InterceptorManager = class {
   constructor() {
     this.handlers = [];
   }
+  /**
+   * Add a new interceptor to the stack
+   *
+   * @param {Function} fulfilled The function to handle `then` for a `Promise`
+   * @param {Function} rejected The function to handle `reject` for a `Promise`
+   *
+   * @return {Number} An ID used to remove interceptor later
+   */
   use(fulfilled, rejected, options) {
     this.handlers.push({
       fulfilled,
@@ -3365,16 +3407,38 @@ var InterceptorManager = class {
     });
     return this.handlers.length - 1;
   }
+  /**
+   * Remove an interceptor from the stack
+   *
+   * @param {Number} id The ID that was returned by `use`
+   *
+   * @returns {Boolean} `true` if the interceptor was removed, `false` otherwise
+   */
   eject(id) {
     if (this.handlers[id]) {
       this.handlers[id] = null;
     }
   }
+  /**
+   * Clear all interceptors from the stack
+   *
+   * @returns {void}
+   */
   clear() {
     if (this.handlers) {
       this.handlers = [];
     }
   }
+  /**
+   * Iterate over all the registered interceptors
+   *
+   * This method is particularly useful for skipping over any
+   * interceptors that may have become `null` calling `eject`.
+   *
+   * @param {Function} fn The function to call for each interceptor
+   *
+   * @returns {void}
+   */
   forEach(fn) {
     utils_default.forEach(this.handlers, function forEachHandler(h) {
       if (h !== null) {
@@ -3407,7 +3471,8 @@ var isStandardBrowserEnv = (() => {
   return typeof window !== "undefined" && typeof document !== "undefined";
 })();
 var isStandardBrowserWebWorkerEnv = (() => {
-  return typeof WorkerGlobalScope !== "undefined" && self instanceof WorkerGlobalScope && typeof self.importScripts === "function";
+  return typeof WorkerGlobalScope !== "undefined" && // eslint-disable-next-line no-undef
+  self instanceof WorkerGlobalScope && typeof self.importScripts === "function";
 })();
 var browser_default = {
   isBrowser: true,
@@ -3570,6 +3635,10 @@ var defaults = {
     }
     return data;
   }],
+  /**
+   * A timeout in milliseconds to abort a request. If set to 0 (default) a
+   * timeout is not created.
+   */
   timeout: 0,
   xsrfCookieName: "XSRF-TOKEN",
   xsrfHeaderName: "X-XSRF-TOKEN",
@@ -3898,44 +3967,50 @@ function settle(resolve, reject, response) {
 }
 
 // ../../node_modules/.pnpm/axios@1.3.3/node_modules/axios/lib/helpers/cookies.js
-var cookies_default = browser_default.isStandardBrowserEnv ? function standardBrowserEnv() {
-  return {
-    write: function write(name, value, expires, path, domain, secure) {
-      const cookie = [];
-      cookie.push(name + "=" + encodeURIComponent(value));
-      if (utils_default.isNumber(expires)) {
-        cookie.push("expires=" + new Date(expires).toGMTString());
-      }
-      if (utils_default.isString(path)) {
-        cookie.push("path=" + path);
-      }
-      if (utils_default.isString(domain)) {
-        cookie.push("domain=" + domain);
-      }
-      if (secure === true) {
-        cookie.push("secure");
-      }
-      document.cookie = cookie.join("; ");
-    },
-    read: function read(name) {
-      const match = document.cookie.match(new RegExp("(^|;\\s*)(" + name + ")=([^;]*)"));
-      return match ? decodeURIComponent(match[3]) : null;
-    },
-    remove: function remove(name) {
-      this.write(name, "", Date.now() - 864e5);
-    }
-  };
-}() : function nonStandardBrowserEnv() {
-  return {
-    write: function write() {
-    },
-    read: function read() {
-      return null;
-    },
-    remove: function remove() {
-    }
-  };
-}();
+var cookies_default = browser_default.isStandardBrowserEnv ? (
+  // Standard browser envs support document.cookie
+  function standardBrowserEnv() {
+    return {
+      write: function write(name, value, expires, path, domain, secure) {
+        const cookie = [];
+        cookie.push(name + "=" + encodeURIComponent(value));
+        if (utils_default.isNumber(expires)) {
+          cookie.push("expires=" + new Date(expires).toGMTString());
+        }
+        if (utils_default.isString(path)) {
+          cookie.push("path=" + path);
+        }
+        if (utils_default.isString(domain)) {
+          cookie.push("domain=" + domain);
+        }
+        if (secure === true) {
+          cookie.push("secure");
+        }
+        document.cookie = cookie.join("; ");
+      },
+      read: function read(name) {
+        const match = document.cookie.match(new RegExp("(^|;\\s*)(" + name + ")=([^;]*)"));
+        return match ? decodeURIComponent(match[3]) : null;
+      },
+      remove: function remove(name) {
+        this.write(name, "", Date.now() - 864e5);
+      }
+    };
+  }()
+) : (
+  // Non standard browser env (web workers, react-native) lack needed support.
+  function nonStandardBrowserEnv() {
+    return {
+      write: function write() {
+      },
+      read: function read() {
+        return null;
+      },
+      remove: function remove() {
+      }
+    };
+  }()
+);
 
 // ../../node_modules/.pnpm/axios@1.3.3/node_modules/axios/lib/helpers/isAbsoluteURL.js
 function isAbsoluteURL(url) {
@@ -3956,38 +4031,45 @@ function buildFullPath(baseURL, requestedURL) {
 }
 
 // ../../node_modules/.pnpm/axios@1.3.3/node_modules/axios/lib/helpers/isURLSameOrigin.js
-var isURLSameOrigin_default = browser_default.isStandardBrowserEnv ? function standardBrowserEnv2() {
-  const msie = /(msie|trident)/i.test(navigator.userAgent);
-  const urlParsingNode = document.createElement("a");
-  let originURL;
-  function resolveURL(url) {
-    let href = url;
-    if (msie) {
+var isURLSameOrigin_default = browser_default.isStandardBrowserEnv ? (
+  // Standard browser envs have full support of the APIs needed to test
+  // whether the request URL is of the same origin as current location.
+  function standardBrowserEnv2() {
+    const msie = /(msie|trident)/i.test(navigator.userAgent);
+    const urlParsingNode = document.createElement("a");
+    let originURL;
+    function resolveURL(url) {
+      let href = url;
+      if (msie) {
+        urlParsingNode.setAttribute("href", href);
+        href = urlParsingNode.href;
+      }
       urlParsingNode.setAttribute("href", href);
-      href = urlParsingNode.href;
+      return {
+        href: urlParsingNode.href,
+        protocol: urlParsingNode.protocol ? urlParsingNode.protocol.replace(/:$/, "") : "",
+        host: urlParsingNode.host,
+        search: urlParsingNode.search ? urlParsingNode.search.replace(/^\?/, "") : "",
+        hash: urlParsingNode.hash ? urlParsingNode.hash.replace(/^#/, "") : "",
+        hostname: urlParsingNode.hostname,
+        port: urlParsingNode.port,
+        pathname: urlParsingNode.pathname.charAt(0) === "/" ? urlParsingNode.pathname : "/" + urlParsingNode.pathname
+      };
     }
-    urlParsingNode.setAttribute("href", href);
-    return {
-      href: urlParsingNode.href,
-      protocol: urlParsingNode.protocol ? urlParsingNode.protocol.replace(/:$/, "") : "",
-      host: urlParsingNode.host,
-      search: urlParsingNode.search ? urlParsingNode.search.replace(/^\?/, "") : "",
-      hash: urlParsingNode.hash ? urlParsingNode.hash.replace(/^#/, "") : "",
-      hostname: urlParsingNode.hostname,
-      port: urlParsingNode.port,
-      pathname: urlParsingNode.pathname.charAt(0) === "/" ? urlParsingNode.pathname : "/" + urlParsingNode.pathname
+    originURL = resolveURL(window.location.href);
+    return function isURLSameOrigin(requestURL) {
+      const parsed = utils_default.isString(requestURL) ? resolveURL(requestURL) : requestURL;
+      return parsed.protocol === originURL.protocol && parsed.host === originURL.host;
     };
-  }
-  originURL = resolveURL(window.location.href);
-  return function isURLSameOrigin(requestURL) {
-    const parsed = utils_default.isString(requestURL) ? resolveURL(requestURL) : requestURL;
-    return parsed.protocol === originURL.protocol && parsed.host === originURL.host;
-  };
-}() : function nonStandardBrowserEnv2() {
-  return function isURLSameOrigin() {
-    return true;
-  };
-}();
+  }()
+) : (
+  // Non standard browser envs (web workers, react-native) lack needed support.
+  function nonStandardBrowserEnv2() {
+    return function isURLSameOrigin() {
+      return true;
+    };
+  }()
+);
 
 // ../../node_modules/.pnpm/axios@1.3.3/node_modules/axios/lib/helpers/parseProtocol.js
 function parseProtocol(url) {
@@ -4432,6 +4514,14 @@ var Axios = class {
       response: new InterceptorManager_default()
     };
   }
+  /**
+   * Dispatch a request
+   *
+   * @param {String|Object} configOrUrl The config specific for this request (merged with this.defaults)
+   * @param {?Object} config
+   *
+   * @returns {Promise} The Promise to be fulfilled
+   */
   request(configOrUrl, config) {
     if (typeof configOrUrl === "string") {
       config = config || {};
@@ -4591,11 +4681,17 @@ var CancelToken = class {
       resolvePromise(token.reason);
     });
   }
+  /**
+   * Throws a `CanceledError` if cancellation has been requested.
+   */
   throwIfRequested() {
     if (this.reason) {
       throw this.reason;
     }
   }
+  /**
+   * Subscribe to the cancel signal
+   */
   subscribe(listener) {
     if (this.reason) {
       listener(this.reason);
@@ -4607,6 +4703,9 @@ var CancelToken = class {
       this._listeners = [listener];
     }
   }
+  /**
+   * Unsubscribe from the cancel signal
+   */
   unsubscribe(listener) {
     if (!this._listeners) {
       return;
@@ -4616,6 +4715,10 @@ var CancelToken = class {
       this._listeners.splice(index, 1);
     }
   }
+  /**
+   * Returns an object that contains a new `CancelToken` and a function that, when called,
+   * cancels the `CancelToken`.
+   */
   static source() {
     let cancel;
     const token = new CancelToken(function executor(c) {
@@ -5068,6 +5171,7 @@ function mergeInterceptor(httpOptions, httpInterceptorMap) {
 var CancelToken3 = axios_default.CancelToken;
 var HttpClient = class {
   constructor(httpOptions) {
+    // 通用请求客户端封装
     this.get = (url, param, requestOptions) => this.request(url, REQUEST_METHOD.get, param, requestOptions);
     this.post = (url, param, requestOptions) => this.request(url, REQUEST_METHOD.post, param, requestOptions);
     this.put = (url, param, requestOptions) => this.request(url, REQUEST_METHOD.put, param, requestOptions);
@@ -5250,7 +5354,7 @@ var customWatermark = (text = "KYE", el = ".ksui-container, .van-dialog, .ksui-c
   document.querySelector("head").appendChild(style);
 };
 function useWaterMark(employeeNumber, el = ".ksui-container, .van-dialog, .ksui-card, .ks-table", color = "#F0F3F9") {
-  let date = new Date();
+  let date = /* @__PURE__ */ new Date();
   const f = (num) => {
     let str = String(num);
     return str.length === 1 ? "0" + str : str;
@@ -5298,7 +5402,7 @@ var debounce = (func, wait, options) => {
     return lastCallTime === void 0 || timeSinceLastCall >= wait || timeSinceLastCall < 0 || maxing && timeSinceLastInvoke >= maxWait;
   }
   function timerExpired() {
-    var time = new Date().getTime();
+    var time = (/* @__PURE__ */ new Date()).getTime();
     if (shouldInvoke(time)) {
       return trailingEdge(time);
     }
@@ -5320,10 +5424,10 @@ var debounce = (func, wait, options) => {
     lastArgs = lastCallTime = lastThis = timerId = void 0;
   }
   function flush() {
-    return timerId === void 0 ? result : trailingEdge(new Date().getTime());
+    return timerId === void 0 ? result : trailingEdge((/* @__PURE__ */ new Date()).getTime());
   }
   function debounced() {
-    var time = new Date().getTime(), isInvoking = shouldInvoke(time);
+    var time = (/* @__PURE__ */ new Date()).getTime(), isInvoking = shouldInvoke(time);
     lastArgs = arguments;
     lastThis = this;
     lastCallTime = time;

package/dist/useEventListener/index.d.ts

@@ -5,6 +5,6 @@ export type UseEventListenerOptions = {
     capture?: boolean;
     passive?: boolean;
 };
-export declare function useEventListener<K extends keyof DocumentEventMap>(type: K, listener: (event: DocumentEventMap[K]) => void, options?: UseEventListenerOptions): void;
+export declare function useEventListener<K extends keyof DocumentEventMap>(type: K, listener: (event: DocumentEventMap[K]) => void, options?: UseEventListenerOptions): () => void;
 export declare function useEventListener(type: string, listener: EventListener, options?: UseEventListenerOptions): void;
 export {};

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@ks-web/use",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "description": "Vant Composition API",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.mjs",
   "typings": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.esm.mjs",
       "require": "./dist/index.cjs.js"
     }
@@ -40,18 +41,21 @@
     "@types/js-md5": "0.7.0",
     "@types/qs": "6.9.7",
     "axios": "1.3.3",
-    "esbuild": "0.16.10",
+    "esbuild": "^0.17.12",
     "js-md5": "0.7.3",
     "qs": "6.11.0",
     "release-it": "^15.4.1",
-    "rimraf": "^4.0.4",
-    "typescript": "^4.8.2",
-    "vue": "^3.2.45"
+    "rimraf": "^5.0.0",
+    "typescript": "^5.0.4",
+    "vue": "^3.3.4"
+  },
+  "peerDependencies": {
+    "vue": "^3.0.0"
   },
   "release-it": {
     "git": {
       "tag": false,
-      "commitMessage": "release: @vant/use ${version}"
+      "commitMessage": "release: @ks-web/use v${version}"
     }
   }
 }