pxd 0.0.44 → 0.0.46

package/dist/utils/event.js

@@ -1,4 +1,4 @@
-import { hasScrollbar, isScrollable } from "./dom.js";
+import { isOverflowScrollable } from "./dom.js";
 export function on(el, event, handler, options) {
   if (!el) {
     return () => {
@@ -31,7 +31,7 @@ export function once(el, event, handler, options) {
     event,
     handler,
     {
-      ...options || {},
+      ...options,
       once: true
     }
   );
@@ -40,16 +40,20 @@ export function optimizedOn(el, event, handler, options) {
   if (!el) {
     return;
   }
-  let cachedEventHandlers = el[`__cached_${event}`];
-  if (cachedEventHandlers && !cachedEventHandlers.includes(handler)) {
+  const cacheKey = `__cached_${event}`;
+  const cachedEventHandlers = el[cacheKey];
+  if (cachedEventHandlers) {
+    if (cachedEventHandlers.includes(handler)) {
+      return;
+    }
     cachedEventHandlers.push(handler);
     return;
   }
   const scheduler = (ev) => {
-    cachedEventHandlers.slice(1).forEach((handler2) => handler2(ev));
+    const list = el[cacheKey];
+    list?.slice(1).forEach((handler2) => handler2(ev));
   };
-  cachedEventHandlers = [scheduler, handler];
-  el[`__cached_${event}`] = cachedEventHandlers;
+  el[cacheKey] = [scheduler, handler];
   el.addEventListener(event, scheduler, options);
 }
 export function optimizedOff(el, event, handler, options) {
@@ -73,21 +77,9 @@ export function optimizedOff(el, event, handler, options) {
 export function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function checkOverflowScroll(ele) {
-  const { x: xScrollbar, y: yScrollbar } = hasScrollbar(ele);
-  const { x: xScrollable, y: yScrollable } = isScrollable(ele);
-  if (xScrollbar && xScrollable || yScrollbar && yScrollable) {
-    return true;
-  }
-  const parent = ele.parentNode;
-  if (!(parent instanceof Element) || parent.tagName === "BODY") {
-    return false;
-  }
-  return checkOverflowScroll(parent);
-}
 export function preventDefaultScroll(ev) {
   const _target = ev.target;
-  if (_target instanceof Element && checkOverflowScroll(_target)) {
+  if (_target instanceof Element && isOverflowScrollable(_target)) {
     return false;
   }
   if (ev.touches?.length > 1) {

package/dist/utils/get.d.ts

@@ -1,11 +1,3 @@
 import type { Nullable } from '../types/shared/utils';
-type PathArray = ReadonlyArray<PropertyKey>;
-type PathValue<T, P extends PathArray> = P extends [] ? T : P extends [infer K, ...infer R] ? K extends PropertyKey ? R extends PathArray ? PathValue<GetAtStep<NonNullable<T>, K>, R> : unknown : unknown : unknown;
-type GetAtStep<T, K> = K extends keyof T ? T[K] : K extends number ? T extends readonly (infer U)[] ? U : T extends {
-    [key: number]: infer V;
-} ? V : unknown : K extends string ? K extends keyof T ? T[K] : unknown : K extends symbol ? K extends keyof T ? T[K] : unknown : unknown;
-export declare function get<T, P extends PathArray, D = undefined>(obj: T, path: P, defaultValue?: D): PathValue<T, P> | D;
-export declare function get<T, D = undefined>(obj: T, path: string | PropertyKey, defaultValue?: D): unknown | D;
 export declare function getFallbackValue<Variants extends Record<string, any>>(variant: Nullable<string>, variants: Variants, defaultVariant?: keyof Variants): any;
 export declare function getColorByThreshold(value: number, colors: Record<string, string>): string;
-export {};

package/dist/utils/get.js

@@ -1,128 +1,3 @@
-const isIntegerKey = (s) => /^\d+$/.test(s);
-function toPath(input) {
-  if (Array.isArray(input)) {
-    return input.slice();
-  }
-  if (typeof input === "symbol") {
-    return [input];
-  }
-  if (typeof input === "number") {
-    return [input];
-  }
-  if (typeof input !== "string") {
-    return [String(input)];
-  }
-  if (input.length === 0) {
-    return [];
-  }
-  const str = input;
-  const result = [];
-  let token = "";
-  let i = 0;
-  const pushToken = () => {
-    if (token.length > 0) {
-      result.push(isIntegerKey(token) ? Number(token) : token);
-      token = "";
-    }
-  };
-  while (i < str.length) {
-    const ch = str[i];
-    if (ch === ".") {
-      pushToken();
-      i++;
-      continue;
-    }
-    if (ch === "[") {
-      pushToken();
-      i++;
-      while (i < str.length && (str[i] === " " || str[i] === "	" || str[i] === "\n" || str[i] === "\r")) {
-        i++;
-      }
-      if (i >= str.length) {
-        break;
-      }
-      const start = str[i];
-      if (start === "'" || start === '"') {
-        const quote = start;
-        i++;
-        let content2 = "";
-        while (i < str.length) {
-          const cc = str[i];
-          if (cc === "\\") {
-            i++;
-            if (i < str.length) {
-              content2 += str[i];
-              i++;
-            } else {
-              break;
-            }
-            continue;
-          }
-          if (cc === quote) {
-            i++;
-            break;
-          }
-          content2 += cc;
-          i++;
-        }
-        result.push(content2);
-        while (i < str.length && (str[i] === " " || str[i] === "	" || str[i] === "\n" || str[i] === "\r")) {
-          i++;
-        }
-        if (str[i] === "]") {
-          i++;
-        }
-        continue;
-      }
-      let content = "";
-      while (i < str.length && str[i] !== "]") {
-        content += str[i];
-        i++;
-      }
-      if (str[i] === "]") {
-        i++;
-      }
-      const trimmed = content.trim();
-      if (trimmed.length > 0) {
-        result.push(isIntegerKey(trimmed) ? Number(trimmed) : trimmed);
-      } else {
-      }
-      continue;
-    }
-    if (ch === "\\") {
-      i++;
-      if (i < str.length) {
-        token += str[i];
-        i++;
-      } else {
-        break;
-      }
-      continue;
-    }
-    token += ch;
-    i++;
-  }
-  pushToken();
-  return result;
-}
-export function get(obj, path, defaultValue) {
-  if (obj == null) {
-    return defaultValue;
-  }
-  const segments = toPath(path);
-  if (segments.length === 0) {
-    return obj === void 0 ? defaultValue : obj;
-  }
-  let cur = obj;
-  for (let i = 0; i < segments.length; i++) {
-    const key = segments[i];
-    if (cur == null) {
-      return defaultValue;
-    }
-    cur = cur[key];
-  }
-  return cur === void 0 ? defaultValue : cur;
-}
 export function getFallbackValue(variant, variants, defaultVariant = "default") {
   return (variant ? variants[variant] : null) ?? variants[defaultVariant];
 }
@@ -137,5 +12,5 @@ export function getColorByThreshold(value, colors) {
       return colors[keys[i - 1]];
     }
   }
-  return colors[keys.at(-1)];
+  return colors[keys[keyLength - 1]];
 }

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+export * from './context';
+export * from './date';
+export * from './debounce';
+export * from './dom';
+export * from './event';
+export * from './format';
+export * from './get';
+export * from './is';
+export * from './regexp';
+export * from './throttle';
+export * from './uid';

package/dist/utils/index.js

@@ -0,0 +1,11 @@
+export * from "./context.js";
+export * from "./date.js";
+export * from "./debounce.js";
+export * from "./dom.js";
+export * from "./event.js";
+export * from "./format.js";
+export * from "./get.js";
+export * from "./is.js";
+export * from "./regexp.js";
+export * from "./throttle.js";
+export * from "./uid.js";

package/dist/utils/throttle.d.ts

@@ -1 +1,7 @@
-export * from './throttle/index';
+import type { Callback } from '../types/shared';
+export { throttle } from 'es-toolkit/function';
+interface ThrottleByRafReturnType<T extends Callback> {
+    (...args: Parameters<T>): void;
+    cancel: () => void;
+}
+export declare function throttleByRaf<T extends Callback>(callback: T): ThrottleByRafReturnType<T>;

package/dist/utils/throttle.js

@@ -1 +1,16 @@
-export * from "./throttle/index.js";
+export { throttle } from "es-toolkit/function";
+export function throttleByRaf(callback) {
+  let timer;
+  const throttle2 = (...args) => {
+    timer && window.cancelAnimationFrame(timer);
+    timer = window.requestAnimationFrame(() => {
+      callback(...args);
+      timer = 0;
+    });
+  };
+  throttle2.cancel = () => {
+    window.cancelAnimationFrame(timer);
+    timer = 0;
+  };
+  return throttle2;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pxd",
   "type": "module",
-  "version": "0.0.44",
+  "version": "0.0.46",
   "description": "A universal UI component library for Vue2&3.",
   "author": "libondev <bon.li@outlook.com>",
   "license": "MIT",
@@ -45,11 +45,15 @@
       "types": "./dist/locales/index.d.ts",
       "default": "./dist/locales/index.js"
     },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "default": "./dist/utils/index.js"
+    },
     "./volar": "./volar.d.ts",
     "./tw.css": "./dist/styles/tw.css",
     "./styles.css": "./dist/styles/styles.css",
     "./components/*": {
-      "types": "./dist/components/*/index.vue.d.ts",
+      "types": "./dist/components/*/index.d.vue.ts",
       "default": "./dist/components/*/index.vue"
     },
     "./composables/*": {
@@ -92,33 +96,36 @@
     "vue": ">=2.7.0 || >=3.2.0"
   },
   "dependencies": {
-    "@gdsicon/vue": "^1.0.6",
-    "dayjs": "^1.11.18"
+    "@floating-ui/dom": "^1.7.4",
+    "@gdsicon/vue": "^1.0.7",
+    "dayjs": "^1.11.19",
+    "es-toolkit": "^1.43.0",
+    "focus-trap": "^7.7.0"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^4.19.0",
-    "@tailwindcss/cli": "^4.1.15",
-    "@tsconfig/node22": "^22.0.2",
-    "@types/node": "^22.18.12",
-    "@vitejs/plugin-vue": "^6.0.1",
+    "@tailwindcss/cli": "^4.1.18",
+    "@tsconfig/node22": "^22.0.5",
+    "@types/node": "^25.0.3",
+    "@vitejs/plugin-vue": "^6.0.3",
     "@vue/test-utils": "^2.4.6",
-    "@vue/tsconfig": "^0.7.0",
-    "eslint": "^9.38.0",
-    "eslint-plugin-better-tailwindcss": "^3.7.10",
-    "fs-extra": "^11.3.2",
-    "happy-dom": "^18.0.1",
+    "@vue/tsconfig": "^0.8.1",
+    "eslint": "^9.39.2",
+    "eslint-plugin-better-tailwindcss": "^3.8.0",
+    "fs-extra": "^11.3.3",
+    "happy-dom": "^20.0.11",
     "husky": "^9.1.7",
-    "lint-staged": "^16.2.5",
+    "lint-staged": "^16.2.7",
     "mkdist": "^2.4.1",
     "npm-run-all2": "^8.0.4",
     "tinyglobby": "^0.2.15",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1",
-    "unplugin-vue-components": "^28.8.0",
-    "vitest": "^3.2.4",
-    "vue": "^3.5.22",
+    "unplugin-vue-components": "^30.0.0",
+    "vitest": "^4.0.16",
+    "vue": "^3.5.26",
     "vue-sfc-transformer": "^0.1.17",
-    "vue-tsc": "^3.0.9"
+    "vue-tsc": "^3.2.1"
   },
   "lint-staged": {
     "*.{ts,vue}": "eslint --fix"

package/volar.d.ts

@@ -26,6 +26,7 @@ declare module 'vue' {
     PCommandMenuItem: typeof import('pxd/components/command-menu-item')['default']
     PConfigProvider: typeof import('pxd/components/config-provider')['default']
     PCountdown: typeof import('pxd/components/countdown')['default']
+    PDashLine: typeof import('pxd/components/dash-line')['default']
     PDescription: typeof import('pxd/components/description')['default']
     PDrawer: typeof import('pxd/components/drawer')['default']
     PEmptyState: typeof import('pxd/components/empty-state')['default']
@@ -38,7 +39,6 @@ declare module 'vue' {
     PInput: typeof import('pxd/components/input')['default']
     PIntersectionObserver: typeof import('pxd/components/intersection-observer')['default']
     PKbd: typeof import('pxd/components/kbd')['default']
-    PKeepAliveContainer: typeof import('pxd/components/keep-alive-container')['default']
     PLinkButton: typeof import('pxd/components/link-button')['default']
     PList: typeof import('pxd/components/list')['default']
     PListItem: typeof import('pxd/components/list-item')['default']
@@ -49,6 +49,7 @@ declare module 'vue' {
     PMessage: typeof import('pxd/components/message')['default']
     PModal: typeof import('pxd/components/modal')['default']
     PMoreButton: typeof import('pxd/components/more-button')['default']
+    PNoiseBackground: typeof import('pxd/components/noise-background')['default']
     PNote: typeof import('pxd/components/note')['default']
     PNumberInput: typeof import('pxd/components/number-input')['default']
     POverlay: typeof import('pxd/components/overlay')['default']

package/dist/components/keep-alive-container/index.d.vue.ts

@@ -1,13 +0,0 @@
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

package/dist/components/keep-alive-container/index.vue

@@ -1,11 +0,0 @@
-<!--
-  Since keep-alive can only cache components,
-  the content must be wrapped in order to cache internal nodes normally.
-  Because there can only be one root node in Vue2, slot cannot be directly used as the root node.
-  So we need to wrap the slot with a div. (Vue3 is not affected by this limitation.)
--->
-<template>
-  <div class="pxd-keep-alive-container">
-    <slot />
-  </div>
-</template>

package/dist/components/keep-alive-container/index.vue.d.ts

@@ -1,13 +0,0 @@
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

package/dist/utils/debounce/compat.d.ts

@@ -1,143 +0,0 @@
-interface DebounceSettings {
-    /**
-     * If `true`, the function will be invoked on the leading edge of the timeout.
-     * @default false
-     */
-    leading?: boolean | undefined;
-    /**
-     * The maximum time `func` is allowed to be delayed before it's invoked.
-     * @default Infinity
-     */
-    maxWait?: number | undefined;
-    /**
-     * If `true`, the function will be invoked on the trailing edge of the timeout.
-     * @default true
-     */
-    trailing?: boolean | undefined;
-}
-interface DebounceSettingsLeading extends DebounceSettings {
-    leading: true;
-}
-export interface DebouncedFunc<T extends (...args: any[]) => any> {
-    /**
-     * Call the original function, but applying the debounce rules.
-     *
-     * If the debounced function can be run immediately, this calls it and returns its return
-     * value.
-     *
-     * Otherwise, it returns the return value of the last invocation, or undefined if the debounced
-     * function was not invoked yet.
-     */
-    (...args: Parameters<T>): ReturnType<T> | undefined;
-    /**
-     * Throw away any pending invocation of the debounced function.
-     */
-    cancel: () => void;
-    /**
-     * If there is a pending invocation of the debounced function, invoke it immediately and return
-     * its return value.
-     *
-     * Otherwise, return the value from the last invocation, or undefined if the debounced function
-     * was never invoked.
-     */
-    flush: () => ReturnType<T> | undefined;
-}
-export interface DebouncedFuncLeading<T extends (...args: any[]) => any> extends DebouncedFunc<T> {
-    (...args: Parameters<T>): ReturnType<T>;
-    flush: () => ReturnType<T>;
-}
-/**
- * Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds
- * have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`
- * method to cancel any pending execution.
- *
- * You can set the debounced function to run at the start (`leading`) or end (`trailing`) of the delay period.
- * If `leading` is true, the function runs immediately on the first call.
- * If `trailing` is true, the function runs after `debounceMs` milliseconds have passed since the last call.
- * If both `leading` and `trailing` are true, the function runs at both the start and end, but it must be called at least twice within `debounceMs` milliseconds for this to happen
- * (since one debounced function call cannot trigger the function twice).
- *
- * You can also set a `maxWait` time, which is the maximum time the function is allowed to be delayed before it is called.
- *
- * @template F - The type of function.
- * @param {F} func - The function to debounce.
- * @param {number} debounceMs - The number of milliseconds to delay.
- * @param {DebounceOptions} options - The options object
- * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced function.
- * @param {boolean} options.leading - If `true`, the function will be invoked on the leading edge of the timeout.
- * @param {boolean} options.trailing - If `true`, the function will be invoked on the trailing edge of the timeout.
- * @param {number} options.maxWait - The maximum time `func` is allowed to be delayed before it's invoked.
- * @returns A new debounced function with a `cancel` method.
- *
- * @example
- * const debouncedFunction = debounce(() => {
- *   console.log('Function executed');
- * }, 1000);
- *
- * // Will log 'Function executed' after 1 second if not called again in that time
- * debouncedFunction();
- *
- * // Will not log anything as the previous call is canceled
- * debouncedFunction.cancel();
- *
- * // With AbortSignal
- * const controller = new AbortController();
- * const signal = controller.signal;
- * const debouncedWithSignal = debounce(() => {
- *  console.log('Function executed');
- * }, 1000, { signal });
- *
- * debouncedWithSignal();
- *
- * // Will cancel the debounced function call
- * controller.abort();
- */
-export declare function debounce<T extends (...args: any) => any>(func: T, debounceMs: number | undefined, options: DebounceSettingsLeading): DebouncedFuncLeading<T>;
-/**
- * Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds
- * have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`
- * method to cancel any pending execution.
- *
- * You can set the debounced function to run at the start (`leading`) or end (`trailing`) of the delay period.
- * If `leading` is true, the function runs immediately on the first call.
- * If `trailing` is true, the function runs after `debounceMs` milliseconds have passed since the last call.
- * If both `leading` and `trailing` are true, the function runs at both the start and end, but it must be called at least twice within `debounceMs` milliseconds for this to happen
- * (since one debounced function call cannot trigger the function twice).
- *
- * You can also set a `maxWait` time, which is the maximum time the function is allowed to be delayed before it is called.
- *
- * @template F - The type of function.
- * @param {F} func - The function to debounce.
- * @param {number} debounceMs - The number of milliseconds to delay.
- * @param {DebounceOptions} options - The options object
- * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced function.
- * @param {boolean} options.leading - If `true`, the function will be invoked on the leading edge of the timeout.
- * @param {boolean} options.trailing - If `true`, the function will be invoked on the trailing edge of the timeout.
- * @param {number} options.maxWait - The maximum time `func` is allowed to be delayed before it's invoked.
- * @returns A new debounced function with a `cancel` method.
- *
- * @example
- * const debouncedFunction = debounce(() => {
- *   console.log('Function executed');
- * }, 1000);
- *
- * // Will log 'Function executed' after 1 second if not called again in that time
- * debouncedFunction();
- *
- * // Will not log anything as the previous call is canceled
- * debouncedFunction.cancel();
- *
- * // With AbortSignal
- * const controller = new AbortController();
- * const signal = controller.signal;
- * const debouncedWithSignal = debounce(() => {
- *  console.log('Function executed');
- * }, 1000, { signal });
- *
- * debouncedWithSignal();
- *
- * // Will cancel the debounced function call
- * controller.abort();
- */
-export declare function debounce<T extends (...args: any) => any>(func: T, debounceMs?: number, options?: DebounceSettings): DebouncedFunc<T>;
-export {};

package/dist/utils/debounce/compat.js

@@ -1,47 +0,0 @@
-import { debounce as debounceImpl } from "./index.js";
-export function debounce(func, debounceMs = 0, options = {}) {
-  if (typeof options !== "object") {
-    options = {};
-  }
-  const { leading = false, trailing = true, maxWait } = options;
-  const edges = Array.from({ length: 2 });
-  if (leading) {
-    edges[0] = "leading";
-  }
-  if (trailing) {
-    edges[1] = "trailing";
-  }
-  let result;
-  let pendingAt = null;
-  const _debounced = debounceImpl(
-    function(...args) {
-      result = func.apply(this, args);
-      pendingAt = null;
-    },
-    debounceMs,
-    { edges }
-  );
-  const debounced = function(...args) {
-    if (maxWait != null) {
-      if (pendingAt === null) {
-        pendingAt = Date.now();
-      }
-      if (Date.now() - pendingAt >= maxWait) {
-        result = func.apply(this, args);
-        pendingAt = Date.now();
-        _debounced.cancel();
-        _debounced.schedule();
-        return result;
-      }
-    }
-    _debounced.apply(this, args);
-    return result;
-  };
-  const flush = () => {
-    _debounced.flush();
-    return result;
-  };
-  debounced.cancel = _debounced.cancel;
-  debounced.flush = flush;
-  return debounced;
-}

package/dist/utils/debounce/index.d.ts

@@ -1,73 +0,0 @@
-interface DebounceOptions {
-    /**
-     * An optional AbortSignal to cancel the debounced function.
-     */
-    signal?: AbortSignal;
-    /**
-     * An optional array specifying whether the function should be invoked on the leading edge, trailing edge, or both.
-     * If `edges` includes "leading", the function will be invoked at the start of the delay period.
-     * If `edges` includes "trailing", the function will be invoked at the end of the delay period.
-     * If both "leading" and "trailing" are included, the function will be invoked at both the start and end of the delay period.
-     * @default ["trailing"]
-     */
-    edges?: Array<'leading' | 'trailing'>;
-}
-export interface DebouncedFunction<F extends (...args: any[]) => void> {
-    (...args: Parameters<F>): void;
-    /**
-     * Schedules the execution of the debounced function after the specified debounce delay.
-     * This method resets any existing timer, ensuring that the function is only invoked
-     * after the delay has elapsed since the last call to the debounced function.
-     * It is typically called internally whenever the debounced function is invoked.
-     *
-     * @returns {void}
-     */
-    schedule: () => void;
-    /**
-     * Cancels any pending execution of the debounced function.
-     * This method clears the active timer and resets any stored context or arguments.
-     */
-    cancel: () => void;
-    /**
-     * Immediately invokes the debounced function if there is a pending execution.
-     * This method executes the function right away if there is a pending execution.
-     */
-    flush: () => void;
-}
-/**
- * Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds
- * have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`
- * method to cancel any pending execution.
- *
- * @template F - The type of function.
- * @param {F} func - The function to debounce.
- * @param {number} debounceMs - The number of milliseconds to delay.
- * @param {DebounceOptions} options - The options object
- * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced function.
- * @returns A new debounced function with a `cancel` method.
- *
- * @example
- * const debouncedFunction = debounce(() => {
- *   console.log('Function executed');
- * }, 1000);
- *
- * // Will log 'Function executed' after 1 second if not called again in that time
- * debouncedFunction();
- *
- * // Will not log anything as the previous call is canceled
- * debouncedFunction.cancel();
- *
- * // With AbortSignal
- * const controller = new AbortController();
- * const signal = controller.signal;
- * const debouncedWithSignal = debounce(() => {
- *  console.log('Function executed');
- * }, 1000, { signal });
- *
- * debouncedWithSignal();
- *
- * // Will cancel the debounced function call
- * controller.abort();
- */
-export declare function debounce<F extends (...args: any[]) => void>(func: F, debounceMs: number, { signal, edges }?: DebounceOptions): DebouncedFunction<F>;
-export {};