@ocavue/utils 1.5.0 → 1.6.0

package/dist/index.d.ts

@@ -558,5 +558,25 @@ declare const supportsRegexLookbehind: () => boolean;
  */
 declare function sleep(ms: number): Promise<void>;
 //#endregion
-export { Counter, DefaultMap, DefaultWeakMap, type ObjectEntries, WeakCounter, formatBytes, getDocument, getDocumentElement, getId, getWindow, isDeepEqual, isDocument, isDocumentFragment, isElement, isElementLike, isHTMLElement, isMap, isMathMLElement, isNodeLike, isNotNullish, isObject, isSVGElement, isSet, isShadowRoot, isTextNode, isWindowLike, mapGroupBy, mapValues, objectEntries, objectGroupBy, once, sleep, supportsRegexLookbehind };
-//# sourceMappingURL=index.d.ts.map
+//#region src/throttle.d.ts
+/**
+ * Creates a throttled function that only invokes `fn` at most once per every
+ * `wait` milliseconds. The first call executes immediately (leading edge).
+ * If called again during the wait period, the last call will be executed at
+ * the end of the wait period (trailing edge).
+ *
+ * @param callback The function to throttle
+ * @param wait The number of milliseconds to throttle invocations to
+ * @returns A throttled version of the function
+ * @example
+ * ```js
+ * const throttled = throttle((name) => console.log('called', name), 1000)
+ * throttled('Alice') // logs 'called Alice' immediately
+ * throttled('Bob') // skipped (within 1000ms)
+ * throttled('Charlie') // skipped (within 1000ms)
+ * // after 1000ms, logs 'called Charlie' again (trailing call)
+ * ```
+ */
+declare function throttle<T extends (this: any, ...args: any[]) => unknown>(callback: T, wait: number): (this: ThisParameterType<T>, ...args: Parameters<T>) => void;
+//#endregion
+export { Counter, DefaultMap, DefaultWeakMap, type ObjectEntries, WeakCounter, formatBytes, getDocument, getDocumentElement, getId, getWindow, isDeepEqual, isDocument, isDocumentFragment, isElement, isElementLike, isHTMLElement, isMap, isMathMLElement, isNodeLike, isNotNullish, isObject, isSVGElement, isSet, isShadowRoot, isTextNode, isWindowLike, mapGroupBy, mapValues, objectEntries, objectGroupBy, once, sleep, supportsRegexLookbehind, throttle };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/checker.ts","../src/counter.ts","../src/default-map.ts","../src/dom.ts","../src/format-bytes.ts","../src/get-id.ts","../src/is-deep-equal.ts","../src/map-group-by.ts","../src/map-values.ts","../src/object-entries.ts","../src/object-group-by.ts","../src/once.ts","../src/regex.ts","../src/sleep.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/checker.ts","../src/counter.ts","../src/default-map.ts","../src/dom.ts","../src/format-bytes.ts","../src/get-id.ts","../src/is-deep-equal.ts","../src/map-group-by.ts","../src/map-values.ts","../src/object-entries.ts","../src/object-group-by.ts","../src/once.ts","../src/regex.ts","../src/sleep.ts","../src/throttle.ts"],"mappings":"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"}

package/dist/index.js

@@ -1,15 +1,83 @@
+//#region src/checker.ts
+/**
+* Checks if the given value is an object.
+*/
 function isObject(value) {
 	return typeof value == "object" && !!value;
 }
+/**
+* Checks if the given value is a Map.
+*/
 function isMap(value) {
 	return value instanceof Map;
 }
+/**
+* Checks if the given value is a Set.
+*/
 function isSet(value) {
 	return value instanceof Set;
 }
+/**
+* Returns true if the given value is not null or undefined.
+*/
 function isNotNullish(value) {
 	return value != null;
 }
+//#endregion
+//#region src/counter.ts
+/**
+* A map that counts occurrences of keys.
+*
+* @example
+* ```typescript
+* // Count word occurrences
+* const wordCounter = new Counter<string>()
+* const words = ['apple', 'banana', 'apple', 'cherry', 'banana', 'apple']
+*
+* for (const word of words) {
+*   wordCounter.increment(word)
+* }
+*
+* console.log(wordCounter.get('apple'))   // 3
+* console.log(wordCounter.get('banana'))  // 2
+* console.log(wordCounter.get('cherry'))  // 1
+* console.log(wordCounter.get('orange'))  // 0 (defaults to 0)
+* ```
+*
+* @example
+* ```typescript
+* // Initialize with existing counts
+* const counter = new Counter<string>([
+*   ['red', 5],
+*   ['blue', 3],
+*   ['green', 7]
+* ])
+*
+* counter.increment('red', 2)      // red: 5 -> 7
+* counter.decrement('blue')        // blue: 3 -> 2
+* counter.increment('yellow')      // yellow: 0 -> 1
+*
+* console.log(counter.get('red'))    // 7
+* console.log(counter.get('blue'))   // 2
+* console.log(counter.get('yellow')) // 1
+* ```
+*
+* @example
+* ```typescript
+* // Track event frequencies
+* const eventCounter = new Counter<string>()
+*
+* eventCounter.increment('click', 5)
+* eventCounter.increment('hover', 3)
+* eventCounter.increment('click', 2)
+*
+* // Get most common events
+* const events = [...eventCounter.entries()]
+*   .sort((a, b) => b[1] - a[1])
+*
+* console.log(events) // [['click', 7], ['hover', 3]]
+* ```
+*/
 var Counter = class extends Map {
 	constructor(iterable) {
 		super(iterable);
@@ -17,9 +85,15 @@ var Counter = class extends Map {
 	get(key) {
 		return super.get(key) ?? 0;
 	}
+	/**
+	* Increments the count for a key by a given amount (default 1).
+	*/
 	increment(key, amount = 1) {
 		this.set(key, this.get(key) + amount);
 	}
+	/**
+	* Decrements the count for a key by a given amount (default 1).
+	*/
 	decrement(key, amount = 1) {
 		this.set(key, this.get(key) - amount);
 	}
@@ -30,9 +104,15 @@ var Counter = class extends Map {
 	get(key) {
 		return super.get(key) ?? 0;
 	}
+	/**
+	* Increments the count for a key by a given amount (default 1).
+	*/
 	increment(key, amount = 1) {
 		this.set(key, this.get(key) + amount);
 	}
+	/**
+	* Decrements the count for a key by a given amount (default 1).
+	*/
 	decrement(key, amount = 1) {
 		this.set(key, this.get(key) - amount);
 	}
@@ -55,39 +135,78 @@ var Counter = class extends Map {
 		return this.set(key, value), value;
 	}
 };
+//#endregion
+//#region src/dom.ts
+/**
+* Checks if the given DOM node is an Element.
+*/
 function isElement(node) {
 	return node.nodeType === 1;
 }
+/**
+* Checks if the given DOM node is a Text node.
+*/
 function isTextNode(node) {
 	return node.nodeType === 3;
 }
+/**
+* Checks if the given DOM node is an HTMLElement.
+*/
 function isHTMLElement(node) {
 	return isElement(node) && node.namespaceURI === "http://www.w3.org/1999/xhtml";
 }
+/**
+* Checks if the given DOM node is an SVGElement.
+*/
 function isSVGElement(node) {
 	return isElement(node) && node.namespaceURI === "http://www.w3.org/2000/svg";
 }
+/**
+* Checks if the given DOM node is an MathMLElement.
+*/
 function isMathMLElement(node) {
 	return isElement(node) && node.namespaceURI === "http://www.w3.org/1998/Math/MathML";
 }
+/**
+* Checks if the given DOM node is a Document.
+*/
 function isDocument(node) {
 	return node.nodeType === 9;
 }
+/**
+* Checks if the given DOM node is a DocumentFragment.
+*/
 function isDocumentFragment(node) {
 	return node.nodeType === 11;
 }
+/**
+* Checks if the given DOM node is a ShadowRoot.
+*/
 function isShadowRoot(node) {
 	return isDocumentFragment(node) && "host" in node && isElementLike(node.host);
 }
+/**
+* Checks if an unknown value is likely a DOM node.
+*/
 function isNodeLike(value) {
 	return isObject(value) && value.nodeType !== void 0;
 }
+/**
+* Checks if an unknown value is likely a DOM element.
+*/
 function isElementLike(value) {
 	return isObject(value) && value.nodeType === 1 && typeof value.nodeName == "string";
 }
+/**
+* Checks if the given value is likely a Window object.
+*/
 function isWindowLike(value) {
 	return isObject(value) && value.window === value;
 }
+/**
+* Gets the window object for the given target or the global window object if no
+* target is provided.
+*/
 function getWindow(target) {
 	if (target) {
 		if (isShadowRoot(target)) return getWindow(target.host);
@@ -96,12 +215,26 @@ function getWindow(target) {
 	}
 	return window;
 }
+/**
+* Gets the document for the given target or the global document if no target is
+* provided.
+*/
 function getDocument(target) {
 	return target ? isWindowLike(target) ? target.document : isDocument(target) ? target : target.ownerDocument || document : document;
 }
+/**
+* Gets a reference to the root node of the document based on the given target.
+*/
 function getDocumentElement(target) {
 	return getDocument(target).documentElement;
 }
+//#endregion
+//#region src/format-bytes.ts
+/**
+* Formats a number of bytes into a human-readable string.
+* @param bytes - The number of bytes to format.
+* @returns A string representing the number of bytes in a human-readable format.
+*/
 function formatBytes(bytes) {
 	let units = [
 		"B",
@@ -113,10 +246,20 @@ function formatBytes(bytes) {
 	let fraction = unitIndex === 0 && num % 1 == 0 ? 0 : 1;
 	return `${num.toFixed(fraction)}${units[unitIndex]}`;
 }
+//#endregion
+//#region src/get-id.ts
 let id = 0, maxSafeInteger = 2 ** 53 - 1;
+/**
+* Generates a unique positive integer.
+*/
 function getId() {
 	return id++, id >= maxSafeInteger && (id = 1), id;
 }
+//#endregion
+//#region src/is-deep-equal.ts
+/**
+* Whether two values are deeply equal.
+*/
 function isDeepEqual(a, b) {
 	if (a === b) return !0;
 	if (a == null || b == null) return !1;
@@ -147,6 +290,11 @@ function isDeepEqual(a, b) {
 	}
 	return !1;
 }
+//#endregion
+//#region src/map-group-by.ts
+/**
+* @internal
+*/
 function mapGroupByPolyfill(items, keySelector) {
 	let map = /* @__PURE__ */ new Map(), index = 0;
 	for (let item of items) {
@@ -155,17 +303,104 @@ function mapGroupByPolyfill(items, keySelector) {
 	}
 	return map;
 }
+/**
+* A polyfill for the [`Map.groupBy()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/groupBy) static method.
+*
+* @public
+*/
 function mapGroupBy(items, keySelector) {
 	return Map.groupBy ? Map.groupBy(items, keySelector) : mapGroupByPolyfill(items, keySelector);
 }
+//#endregion
+//#region src/map-values.ts
+/**
+* Creates a new object with the same keys as the input object, but with values
+* transformed by the provided callback function. Similar to `Array.prototype.map()`
+* but for object values.
+
+* @param object - The object whose values will be transformed.
+* @param callback - A function that transforms each value. Receives the value and
+*   its corresponding key as arguments.
+* @returns A new object with the same keys but transformed values.
+*
+* @example
+* ```typescript
+* const prices = { apple: 1, banana: 2, orange: 3 }
+* const doubled = mapValues(prices, (price) => price * 2)
+* // Result: { apple: 2, banana: 4, orange: 6 }
+* ```
+*
+* @example
+* ```typescript
+* const users = { john: 25, jane: 30, bob: 35 }
+* const greetings = mapValues(users, (age, name) => `${name} is ${age} years old`)
+* // Result: { john: 'john is 25 years old', jane: 'jane is 30 years old', bob: 'bob is 35 years old' }
+* ```
+*
+* @example
+* ```typescript
+* const data = { a: '1', b: '2', c: '3' }
+* const numbers = mapValues(data, (str) => parseInt(str, 10))
+* // Result: { a: 1, b: 2, c: 3 }
+* ```
+*
+* @public
+*/
 function mapValues(object, callback) {
 	let result = {};
 	for (let [key, value] of Object.entries(object)) result[key] = callback(value, key);
 	return result;
 }
+//#endregion
+//#region src/object-entries.ts
+/**
+* A type-safe wrapper around
+* [`Object.entries()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries)
+* that preserves the exact types of object keys and values. Unlike the standard
+* `Object.entries()` which returns `[string, any][]`, this function returns an
+* array of tuples where each tuple is precisely typed according to the input
+* object's structure.
+*
+* This is particularly useful when working with objects that have known, fixed
+* property types and you want to maintain type safety when iterating over
+* entries.
+*
+* @example
+* ```typescript
+* const myObject = { a: 1, b: 'hello', c: true } as const
+* const entries = objectEntries(myObject)
+* // Type: (["a", 1] | ["b", "hello"] | ["c", true])[]
+*
+* for (const [key, value] of entries) {
+*   // key is typed as "a" | "b" | "c"
+*   // value is typed as 1 | "hello" | true
+*   console.log(`${key}: ${value}`)
+* }
+* ```
+*
+* @example
+* ```typescript
+* interface User {
+*   name: string
+*   age: number
+*   active: boolean
+* }
+*
+* const user: User = { name: 'Alice', age: 30, active: true }
+* const entries = objectEntries(user)
+* // Type: (["name", string] | ["age", number] | ["active", boolean])[]
+* ```
+*
+* @public
+*/
 function objectEntries(obj) {
 	return Object.entries(obj);
 }
+//#endregion
+//#region src/object-group-by.ts
+/**
+* @internal
+*/
 function objectGroupByPolyfill(items, keySelector) {
 	let result = {}, index = 0;
 	for (let item of items) {
@@ -174,24 +409,92 @@ function objectGroupByPolyfill(items, keySelector) {
 	}
 	return result;
 }
+/**
+* A polyfill for the [`Object.groupBy()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/groupBy) static method.
+*
+* @public
+*/
 function objectGroupBy(items, keySelector) {
 	return Object.groupBy ? Object.groupBy(items, keySelector) : objectGroupByPolyfill(items, keySelector);
 }
+//#endregion
+//#region src/once.ts
+/**
+* Creates a function that will only execute the provided function once.
+* Subsequent calls will return the cached result from the first execution.
+*
+* @param fn The function to execute once
+* @returns A function that will only execute the provided function once
+* @example
+* ```ts
+* const getValue = once(() => expensiveOperation())
+* getValue() // executes expensiveOperation
+* getValue() // returns cached result
+* ```
+*/
 function once(fn) {
 	let called = !1, result;
 	return () => (called || (result = fn(), called = !0, fn = void 0), result);
 }
+//#endregion
+//#region src/regex.ts
+/**
+* Checks if current environment supports [regex lookbehind assertion](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Lookbehind_assertion).
+*
+* @returns `true` if the current environment supports regex lookbehind assertion, `false` otherwise.
+*/
 const supportsRegexLookbehind = /* @__PURE__ */ once(() => {
 	try {
-		return "ab".replace(/* @__PURE__ */ RegExp("(?<=a)b", "g"), "c") === "ac";
+		return "ab".replaceAll(/* @__PURE__ */ RegExp("(?<=a)b", "g"), "c") === "ac";
 	} catch {
 		/* v8 ignore start */
 		return !1;
 	}
 });
+//#endregion
+//#region src/sleep.ts
+/**
+* Returns a Promise that resolves after a specified number of milliseconds.
+*
+* @param ms - The number of milliseconds to wait.
+*
+* @example
+* ```js
+* await sleep(1000)  // Wait 1 second
+* ```
+*/
 function sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
-export { Counter, DefaultMap, DefaultWeakMap, WeakCounter, formatBytes, getDocument, getDocumentElement, getId, getWindow, isDeepEqual, isDocument, isDocumentFragment, isElement, isElementLike, isHTMLElement, isMap, isMathMLElement, isNodeLike, isNotNullish, isObject, isSVGElement, isSet, isShadowRoot, isTextNode, isWindowLike, mapGroupBy, mapValues, objectEntries, objectGroupBy, once, sleep, supportsRegexLookbehind };
-
-//# sourceMappingURL=index.js.map
+//#endregion
+//#region src/throttle.ts
+/**
+* Creates a throttled function that only invokes `fn` at most once per every
+* `wait` milliseconds. The first call executes immediately (leading edge).
+* If called again during the wait period, the last call will be executed at
+* the end of the wait period (trailing edge).
+*
+* @param callback The function to throttle
+* @param wait The number of milliseconds to throttle invocations to
+* @returns A throttled version of the function
+* @example
+* ```js
+* const throttled = throttle((name) => console.log('called', name), 1000)
+* throttled('Alice') // logs 'called Alice' immediately
+* throttled('Bob') // skipped (within 1000ms)
+* throttled('Charlie') // skipped (within 1000ms)
+* // after 1000ms, logs 'called Charlie' again (trailing call)
+* ```
+*/
+function throttle(callback, wait) {
+	let timeoutId, lastCallTime = 0;
+	return function(...args) {
+		clearTimeout(timeoutId);
+		let now = Date.now(), delay = wait + lastCallTime - now;
+		delay <= 0 ? (lastCallTime = now, callback.apply(this, args)) : timeoutId = setTimeout(() => {
+			lastCallTime = Date.now(), callback.apply(this, args);
+		}, delay);
+	};
+}
+//#endregion
+export { Counter, DefaultMap, DefaultWeakMap, WeakCounter, formatBytes, getDocument, getDocumentElement, getId, getWindow, isDeepEqual, isDocument, isDocumentFragment, isElement, isElementLike, isHTMLElement, isMap, isMathMLElement, isNodeLike, isNotNullish, isObject, isSVGElement, isSet, isShadowRoot, isTextNode, isWindowLike, mapGroupBy, mapValues, objectEntries, objectGroupBy, once, sleep, supportsRegexLookbehind, throttle };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["NodeType.ELEMENT_NODE","NodeType.TEXT_NODE","NodeType.DOCUMENT_NODE","NodeType.DOCUMENT_FRAGMENT_NODE"],"sources":["../src/checker.ts","../src/counter.ts","../src/default-map.ts","../src/dom-node-type.ts","../src/dom.ts","../src/format-bytes.ts","../src/get-id.ts","../src/is-deep-equal.ts","../src/map-group-by.ts","../src/map-values.ts","../src/object-entries.ts","../src/object-group-by.ts","../src/once.ts","../src/regex.ts","../src/sleep.ts"],"sourcesContent":["/**\n * Checks if the given value is an object.\n */\nexport function isObject(\n  value: unknown,\n): value is Record<string | symbol | number, unknown> {\n  return value != null && typeof value === 'object'\n}\n\n/**\n * Checks if the given value is a Map.\n */\nexport function isMap(value: unknown): value is Map<unknown, unknown> {\n  return value instanceof Map\n}\n\n/**\n * Checks if the given value is a Set.\n */\nexport function isSet(value: unknown): value is Set<unknown> {\n  return value instanceof Set\n}\n\n/**\n * Returns true if the given value is not null or undefined.\n */\nexport function isNotNullish<T>(value: T): value is NonNullable<T> {\n  return value != null\n}\n","/**\n * A map that counts occurrences of keys.\n *\n * @example\n * ```typescript\n * // Count word occurrences\n * const wordCounter = new Counter<string>()\n * const words = ['apple', 'banana', 'apple', 'cherry', 'banana', 'apple']\n *\n * for (const word of words) {\n *   wordCounter.increment(word)\n * }\n *\n * console.log(wordCounter.get('apple'))   // 3\n * console.log(wordCounter.get('banana'))  // 2\n * console.log(wordCounter.get('cherry'))  // 1\n * console.log(wordCounter.get('orange'))  // 0 (defaults to 0)\n * ```\n *\n * @example\n * ```typescript\n * // Initialize with existing counts\n * const counter = new Counter<string>([\n *   ['red', 5],\n *   ['blue', 3],\n *   ['green', 7]\n * ])\n *\n * counter.increment('red', 2)      // red: 5 -> 7\n * counter.decrement('blue')        // blue: 3 -> 2\n * counter.increment('yellow')      // yellow: 0 -> 1\n *\n * console.log(counter.get('red'))    // 7\n * console.log(counter.get('blue'))   // 2\n * console.log(counter.get('yellow')) // 1\n * ```\n *\n * @example\n * ```typescript\n * // Track event frequencies\n * const eventCounter = new Counter<string>()\n *\n * eventCounter.increment('click', 5)\n * eventCounter.increment('hover', 3)\n * eventCounter.increment('click', 2)\n *\n * // Get most common events\n * const events = [...eventCounter.entries()]\n *   .sort((a, b) => b[1] - a[1])\n *\n * console.log(events) // [['click', 7], ['hover', 3]]\n * ```\n */\nexport class Counter<K> extends Map<K, number> {\n  constructor(iterable?: Iterable<readonly [K, number]>) {\n    super(iterable)\n  }\n\n  override get(key: K): number {\n    return super.get(key) ?? 0\n  }\n\n  /**\n   * Increments the count for a key by a given amount (default 1).\n   */\n  increment(key: K, amount = 1): void {\n    this.set(key, this.get(key) + amount)\n  }\n\n  /**\n   * Decrements the count for a key by a given amount (default 1).\n   */\n  decrement(key: K, amount = 1): void {\n    this.set(key, this.get(key) - amount)\n  }\n}\n\n/**\n * A weak map that counts occurrences of object keys.\n *\n * Similar to {@link Counter} but uses WeakMap as the base, allowing garbage collection of keys.\n *\n * @example\n * ```typescript\n * // Track reference counts for DOM elements\n * const elementRefs = new WeakCounter<HTMLElement>()\n *\n * function addReference(element: HTMLElement) {\n *   elementRefs.increment(element)\n *   console.log(`References: ${elementRefs.get(element)}`)\n * }\n *\n * function removeReference(element: HTMLElement) {\n *   elementRefs.decrement(element)\n *   console.log(`References: ${elementRefs.get(element)}`)\n * }\n *\n * const div = document.createElement('div')\n * addReference(div)     // References: 1\n * addReference(div)     // References: 2\n * removeReference(div)  // References: 1\n * ```\n *\n * @example\n * ```typescript\n * // Count object interactions without preventing garbage collection\n * const objectInteractions = new WeakCounter<object>()\n *\n * function handleInteraction(obj: object, count = 1) {\n *   objectInteractions.increment(obj, count)\n * }\n *\n * const user = { id: 1, name: 'Alice' }\n * const session = { sessionId: 'abc123' }\n *\n * handleInteraction(user, 3)\n * handleInteraction(session, 1)\n * handleInteraction(user, 2)\n *\n * console.log(objectInteractions.get(user))     // 5\n * console.log(objectInteractions.get(session))  // 1\n * // When user and session are no longer referenced elsewhere,\n * // they can be garbage collected along with their counts\n * ```\n *\n * @example\n * ```typescript\n * // Initialize with existing counts\n * const cache1 = {}\n * const cache2 = {}\n * const cache3 = {}\n *\n * const hitCounter = new WeakCounter<object>([\n *   [cache1, 10],\n *   [cache2, 5],\n *   [cache3, 15]\n * ])\n *\n * hitCounter.increment(cache1, 3)  // 10 -> 13\n * console.log(hitCounter.get(cache1))  // 13\n * console.log(hitCounter.get(cache2))  // 5\n * ```\n */\nexport class WeakCounter<K extends WeakKey> extends WeakMap<K, number> {\n  constructor(entries?: readonly (readonly [K, number])[] | null) {\n    super(entries)\n  }\n\n  override get(key: K): number {\n    return super.get(key) ?? 0\n  }\n\n  /**\n   * Increments the count for a key by a given amount (default 1).\n   */\n  increment(key: K, amount = 1): void {\n    this.set(key, this.get(key) + amount)\n  }\n\n  /**\n   * Decrements the count for a key by a given amount (default 1).\n   */\n  decrement(key: K, amount = 1): void {\n    this.set(key, this.get(key) - amount)\n  }\n}\n","/**\n * A map that automatically creates values for missing keys using a factory function.\n *\n * Similar to Python's [defaultdict](https://docs.python.org/3.13/library/collections.html#collections.defaultdict).\n *\n * @example\n * ```typescript\n * // Group items by category using arrays\n * const groupByCategory = new DefaultMap<string, string[]>(() => [])\n *\n * groupByCategory.get('fruits').push('apple', 'banana')\n * groupByCategory.get('vegetables').push('carrot')\n * groupByCategory.get('fruits').push('orange')\n *\n * console.log(groupByCategory.get('fruits'))      // ['apple', 'banana', 'orange']\n * console.log(groupByCategory.get('vegetables'))  // ['carrot']\n * console.log(groupByCategory.get('dairy'))       // [] (auto-created)\n * ```\n *\n * @example\n * ```typescript\n * // Build a graph with adjacency lists\n * const graph = new DefaultMap<string, Set<string>>(() => new Set())\n *\n * graph.get('A').add('B').add('C')\n * graph.get('B').add('C').add('D')\n * graph.get('C').add('D')\n *\n * console.log([...graph.get('A')])  // ['B', 'C']\n * console.log([...graph.get('B')])  // ['C', 'D']\n * console.log([...graph.get('E')])  // [] (auto-created empty set)\n * ```\n *\n * @example\n * ```typescript\n * // Initialize with existing entries\n * const scores = new DefaultMap<string, number>(\n *   () => 0,\n *   [\n *     ['Alice', 100],\n *     ['Bob', 85]\n *   ]\n * )\n *\n * scores.set('Alice', scores.get('Alice') + 10)  // 100 -> 110\n * console.log(scores.get('Alice'))   // 110\n * console.log(scores.get('Bob'))     // 85\n * console.log(scores.get('Charlie')) // 0 (auto-created)\n * ```\n *\n * @example\n * ```typescript\n * // Nested DefaultMaps for 2D data structures\n * const matrix = new DefaultMap<number, DefaultMap<number, number>>(\n *   () => new DefaultMap<number, number>(() => 0)\n * )\n *\n * matrix.get(0).set(0, 1)\n * matrix.get(0).set(1, 2)\n * matrix.get(1).set(1, 3)\n *\n * console.log(matrix.get(0).get(0))  // 1\n * console.log(matrix.get(0).get(1))  // 2\n * console.log(matrix.get(1).get(0))  // 0 (auto-created)\n * console.log(matrix.get(2).get(3))  // 0 (both auto-created)\n * ```\n */\nexport class DefaultMap<K, V> extends Map<K, V> {\n  private readonly defaultFactory: () => V\n\n  constructor(defaultFactory: () => V, iterable?: Iterable<readonly [K, V]>) {\n    super(iterable)\n    this.defaultFactory = defaultFactory\n  }\n\n  override get(key: K): V {\n    if (this.has(key)) {\n      return super.get(key)!\n    }\n    const value = this.defaultFactory()\n    this.set(key, value)\n    return value\n  }\n}\n\n/**\n * A weak map that automatically creates values for missing keys using a factory function.\n *\n * Similar to {@link DefaultMap} but uses WeakMap as the base, allowing garbage collection of keys.\n *\n * @example\n * ```typescript\n * // Store metadata for DOM elements without preventing garbage collection\n * const elementMetadata = new DefaultWeakMap<HTMLElement, { clicks: number; hovers: number }>(\n *   () => ({ clicks: 0, hovers: 0 })\n * )\n *\n * const button = document.querySelector('button')!\n * const div = document.querySelector('div')!\n *\n * elementMetadata.get(button).clicks++\n * elementMetadata.get(button).clicks++\n * elementMetadata.get(div).hovers++\n *\n * console.log(elementMetadata.get(button)) // { clicks: 2, hovers: 0 }\n * console.log(elementMetadata.get(div))    // { clicks: 0, hovers: 1 }\n * // When elements are removed from DOM and not referenced,\n * // their metadata can be garbage collected\n * ```\n *\n * @example\n * ```typescript\n * // Cache computed properties for objects\n * const computedCache = new DefaultWeakMap<object, Map<string, any>>(\n *   () => new Map()\n * )\n *\n * function getOrCompute(obj: object, key: string, compute: () => any) {\n *   const cache = computedCache.get(obj)\n *   if (!cache.has(key)) {\n *     cache.set(key, compute())\n *   }\n *   return cache.get(key)\n * }\n *\n * const user = { name: 'Alice', age: 30 }\n * const displayName = getOrCompute(user, 'displayName', () => user.name.toUpperCase())\n * const birthYear = getOrCompute(user, 'birthYear', () => new Date().getFullYear() - user.age)\n *\n * console.log(displayName) // 'ALICE'\n * console.log(birthYear)   // 1994 (or current year - 30)\n * ```\n *\n * @example\n * ```typescript\n * // Initialize with existing entries\n * const obj1 = {}\n * const obj2 = {}\n *\n * const objectData = new DefaultWeakMap<object, string[]>(\n *   () => [],\n *   [\n *     [obj1, ['tag1', 'tag2']],\n *     [obj2, ['tag3']]\n *   ]\n * )\n *\n * objectData.get(obj1).push('tag4')\n * console.log(objectData.get(obj1))  // ['tag1', 'tag2', 'tag4']\n * console.log(objectData.get(obj2))  // ['tag3']\n *\n * const obj3 = {}\n * console.log(objectData.get(obj3))  // [] (auto-created)\n * ```\n *\n * @example\n * ```typescript\n * // Track event listeners per element using both DefaultWeakMap and DefaultMap\n * const eventListeners = new DefaultWeakMap<EventTarget, DefaultMap<string, Function[]>>(\n *   () => new DefaultMap<string, Function[]>(() => [])\n * )\n *\n * function addListener(target: EventTarget, event: string, handler: Function) {\n *   eventListeners.get(target).get(event).push(handler)\n * }\n *\n * const element = document.createElement('button')\n * addListener(element, 'click', () => console.log('clicked'))\n * addListener(element, 'click', () => console.log('also clicked'))\n * addListener(element, 'hover', () => console.log('hovered'))\n *\n * console.log(eventListeners.get(element).get('click').length)  // 2\n * console.log(eventListeners.get(element).get('hover').length)  // 1\n * // No need for has() checks or null assertions - everything auto-initializes!\n * ```\n */\nexport class DefaultWeakMap<K extends WeakKey, V> extends WeakMap<K, V> {\n  private readonly defaultFactory: () => V\n\n  constructor(\n    defaultFactory: () => V,\n    entries?: readonly (readonly [K, V])[] | null,\n  ) {\n    super(entries)\n    this.defaultFactory = defaultFactory\n  }\n\n  override get(key: K): V {\n    if (this.has(key)) {\n      return super.get(key)!\n    }\n    const value = this.defaultFactory()\n    this.set(key, value)\n    return value\n  }\n}\n","// prettier-ignore\nexport const ELEMENT_NODE = 1 satisfies typeof Node.ELEMENT_NODE;\n// prettier-ignore\nexport const ATTRIBUTE_NODE = 2 satisfies typeof Node.ATTRIBUTE_NODE;\n// prettier-ignore\nexport const TEXT_NODE = 3 satisfies typeof Node.TEXT_NODE;\n// prettier-ignore\nexport const CDATA_SECTION_NODE = 4 satisfies typeof Node.CDATA_SECTION_NODE;\n// prettier-ignore\nexport const ENTITY_REFERENCE_NODE = 5 satisfies typeof Node.ENTITY_REFERENCE_NODE;\n// prettier-ignore\nexport const ENTITY_NODE = 6 satisfies typeof Node.ENTITY_NODE;\n// prettier-ignore\nexport const PROCESSING_INSTRUCTION_NODE = 7 satisfies typeof Node.PROCESSING_INSTRUCTION_NODE;\n// prettier-ignore\nexport const COMMENT_NODE = 8 satisfies typeof Node.COMMENT_NODE;\n// prettier-ignore\nexport const DOCUMENT_NODE = 9 satisfies typeof Node.DOCUMENT_NODE;\n// prettier-ignore\nexport const DOCUMENT_TYPE_NODE = 10 satisfies typeof Node.DOCUMENT_TYPE_NODE;\n// prettier-ignore\nexport const DOCUMENT_FRAGMENT_NODE = 11 satisfies typeof Node.DOCUMENT_FRAGMENT_NODE;\n// prettier-ignore\nexport const NOTATION_NODE = 12 satisfies typeof Node.NOTATION_NODE;\n","import { isObject } from './checker'\nimport * as NodeType from './dom-node-type'\n\n/**\n * Checks if the given DOM node is an Element.\n */\nexport function isElement(node: Node): node is Element {\n  return node.nodeType === NodeType.ELEMENT_NODE\n}\n\n/**\n * Checks if the given DOM node is a Text node.\n */\nexport function isTextNode(node: Node): node is Text {\n  return node.nodeType === NodeType.TEXT_NODE\n}\n\n/**\n * Checks if the given DOM node is an HTMLElement.\n */\nexport function isHTMLElement(node: Node): node is HTMLElement {\n  return isElement(node) && node.namespaceURI === 'http://www.w3.org/1999/xhtml'\n}\n\n/**\n * Checks if the given DOM node is an SVGElement.\n */\nexport function isSVGElement(node: Node): node is SVGElement {\n  return isElement(node) && node.namespaceURI === 'http://www.w3.org/2000/svg'\n}\n\n/**\n * Checks if the given DOM node is an MathMLElement.\n */\nexport function isMathMLElement(node: Node): node is MathMLElement {\n  return (\n    isElement(node) &&\n    node.namespaceURI === 'http://www.w3.org/1998/Math/MathML'\n  )\n}\n\n/**\n * Checks if the given DOM node is a Document.\n */\nexport function isDocument(node: Node): node is Document {\n  return node.nodeType === NodeType.DOCUMENT_NODE\n}\n\n/**\n * Checks if the given DOM node is a DocumentFragment.\n */\nexport function isDocumentFragment(node: Node): node is DocumentFragment {\n  return node.nodeType === NodeType.DOCUMENT_FRAGMENT_NODE\n}\n\n/**\n * Checks if the given DOM node is a ShadowRoot.\n */\nexport function isShadowRoot(node: Node): node is ShadowRoot {\n  return isDocumentFragment(node) && 'host' in node && isElementLike(node.host)\n}\n\n/**\n * Checks if an unknown value is likely a DOM node.\n */\nexport function isNodeLike(value: unknown): value is Node {\n  return isObject(value) && value.nodeType !== undefined\n}\n\n/**\n * Checks if an unknown value is likely a DOM element.\n */\nexport function isElementLike(value: unknown): value is Element {\n  return (\n    isObject(value) &&\n    value.nodeType === NodeType.ELEMENT_NODE &&\n    typeof value.nodeName === 'string'\n  )\n}\n\n/**\n * Checks if the given value is likely a Window object.\n */\nexport function isWindowLike(value: unknown): value is Window {\n  return isObject(value) && value.window === value\n}\n\n/**\n * Gets the window object for the given target or the global window object if no\n * target is provided.\n */\nexport function getWindow(\n  target?: Node | ShadowRoot | Document | null,\n): Window & typeof globalThis {\n  if (target) {\n    if (isShadowRoot(target)) {\n      return getWindow(target.host)\n    }\n    if (isDocument(target)) {\n      return target.defaultView || window\n    }\n    if (isElement(target)) {\n      return target.ownerDocument?.defaultView || window\n    }\n  }\n  return window\n}\n\n/**\n * Gets the document for the given target or the global document if no target is\n * provided.\n */\nexport function getDocument(\n  target?: Element | Window | Node | Document | null,\n): Document {\n  if (target) {\n    if (isWindowLike(target)) {\n      return target.document\n    }\n    if (isDocument(target)) {\n      return target\n    }\n    return target.ownerDocument || document\n  }\n  return document\n}\n\n/**\n * Gets a reference to the root node of the document based on the given target.\n */\nexport function getDocumentElement(\n  target?: Element | Node | Window | Document | null,\n): HTMLElement {\n  return getDocument(target).documentElement\n}\n","/**\n * Formats a number of bytes into a human-readable string.\n * @param bytes - The number of bytes to format.\n * @returns A string representing the number of bytes in a human-readable format.\n */\nexport function formatBytes(bytes: number): string {\n  const units = ['B', 'KB', 'MB', 'GB']\n  let unitIndex = 0\n  let num = bytes\n  while (Math.abs(num) >= 1024 && unitIndex < units.length - 1) {\n    num /= 1024\n    unitIndex++\n  }\n  const fraction = unitIndex === 0 && num % 1 === 0 ? 0 : 1\n  return `${num.toFixed(fraction)}${units[unitIndex]}`\n}\n","let id = 0\n\nlet maxSafeInteger = Number.MAX_SAFE_INTEGER\n\n/**\n * Sets the maximum safe integer for the id generator. Only for testing purposes.\n *\n * @internal\n */\nexport function setMaxSafeInteger(max: number) {\n  maxSafeInteger = max\n}\n\n/**\n * Generates a unique positive integer.\n */\nexport function getId(): number {\n  id++\n  if (id >= maxSafeInteger) {\n    id = 1\n  }\n  return id\n}\n","import { isMap, isSet } from './checker'\n\n/**\n * Whether two values are deeply equal.\n */\nexport function isDeepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) {\n    return true\n  }\n\n  // Handle null and undefined early\n  if (a == null || b == null) {\n    return false\n  }\n\n  const aType = typeof a\n  const bType = typeof b\n  if (aType !== bType) {\n    return false\n  }\n\n  if (aType === 'number' && Number.isNaN(a) && Number.isNaN(b)) {\n    return true\n  }\n\n  if (Array.isArray(a)) {\n    if (!Array.isArray(b)) {\n      return false\n    }\n    if (a.length !== b.length) {\n      return false\n    }\n    const size = a.length\n    for (let i = 0; i < size; i++) {\n      if (!isDeepEqual(a[i], b[i])) {\n        return false\n      }\n    }\n    return true\n  }\n\n  if (isSet(a)) {\n    if (!isSet(b)) {\n      return false\n    }\n    if (a.size !== b.size) {\n      return false\n    }\n    for (const value of a) {\n      if (!b.has(value)) {\n        return false\n      }\n    }\n    return true\n  }\n\n  if (isMap(a)) {\n    if (!isMap(b)) {\n      return false\n    }\n    if (a.size !== b.size) {\n      return false\n    }\n    for (const key of a.keys()) {\n      if (!b.has(key)) {\n        return false\n      }\n      if (!isDeepEqual(a.get(key), b.get(key))) {\n        return false\n      }\n    }\n    return true\n  }\n\n  if (typeof a === 'object' && typeof b === 'object') {\n    const aKeys = Object.keys(a)\n    const bKeys = Object.keys(b)\n    if (aKeys.length !== bKeys.length) {\n      return false\n    }\n    for (const key of aKeys) {\n      if (\n        !isDeepEqual(\n          (a as Record<string, unknown>)[key],\n          (b as Record<string, unknown>)[key],\n        )\n      ) {\n        return false\n      }\n    }\n    return true\n  }\n\n  return false\n}\n","/**\n * @internal\n */\nexport function mapGroupByPolyfill<K, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Map<K, T[]> {\n  const map = new Map<K, T[]>()\n  let index = 0\n  for (const item of items) {\n    const key = keySelector(item, index)\n    const group = map.get(key)\n    if (group) {\n      group.push(item)\n    } else {\n      map.set(key, [item])\n    }\n    index++\n  }\n  return map\n}\n\n/**\n * A polyfill for the [`Map.groupBy()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/groupBy) static method.\n *\n * @public\n */\nexport function mapGroupBy<K, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Map<K, T[]> {\n  return Map.groupBy\n    ? Map.groupBy(items, keySelector)\n    : mapGroupByPolyfill(items, keySelector)\n}\n","/**\n * Creates a new object with the same keys as the input object, but with values\n * transformed by the provided callback function. Similar to `Array.prototype.map()`\n * but for object values.\n\n * @param object - The object whose values will be transformed.\n * @param callback - A function that transforms each value. Receives the value and\n *   its corresponding key as arguments.\n * @returns A new object with the same keys but transformed values.\n *\n * @example\n * ```typescript\n * const prices = { apple: 1, banana: 2, orange: 3 }\n * const doubled = mapValues(prices, (price) => price * 2)\n * // Result: { apple: 2, banana: 4, orange: 6 }\n * ```\n *\n * @example\n * ```typescript\n * const users = { john: 25, jane: 30, bob: 35 }\n * const greetings = mapValues(users, (age, name) => `${name} is ${age} years old`)\n * // Result: { john: 'john is 25 years old', jane: 'jane is 30 years old', bob: 'bob is 35 years old' }\n * ```\n *\n * @example\n * ```typescript\n * const data = { a: '1', b: '2', c: '3' }\n * const numbers = mapValues(data, (str) => parseInt(str, 10))\n * // Result: { a: 1, b: 2, c: 3 }\n * ```\n *\n * @public\n */\nexport function mapValues<ValueIn, ValueOut>(\n  object: Record<string, ValueIn>,\n  callback: (value: ValueIn, key: string) => ValueOut,\n): Record<string, ValueOut> {\n  const result = {} as Record<string, ValueOut>\n  for (const [key, value] of Object.entries(object)) {\n    result[key] = callback(value, key)\n  }\n  return result\n}\n","/**\n * A TypeScript utility type that represents the entries of an object as a union of tuple types.\n * Each tuple contains a key-value pair where the key and value types are precisely typed\n * according to the input object type.\n *\n * @example\n * ```typescript\n * type MyObject = { a: 1; b: 'B' }\n * type MyEntries = ObjectEntries<MyObject>\n * //   ^ [\"a\", 1] | [\"b\", \"B\"]\n * ```\n *\n * @public\n */\nexport type ObjectEntries<T extends Record<string, any>> = {\n  [K in keyof T]: [K, T[K]]\n}[keyof T]\n\n/**\n * A type-safe wrapper around\n * [`Object.entries()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries)\n * that preserves the exact types of object keys and values. Unlike the standard\n * `Object.entries()` which returns `[string, any][]`, this function returns an\n * array of tuples where each tuple is precisely typed according to the input\n * object's structure.\n *\n * This is particularly useful when working with objects that have known, fixed\n * property types and you want to maintain type safety when iterating over\n * entries.\n *\n * @example\n * ```typescript\n * const myObject = { a: 1, b: 'hello', c: true } as const\n * const entries = objectEntries(myObject)\n * // Type: ([\"a\", 1] | [\"b\", \"hello\"] | [\"c\", true])[]\n *\n * for (const [key, value] of entries) {\n *   // key is typed as \"a\" | \"b\" | \"c\"\n *   // value is typed as 1 | \"hello\" | true\n *   console.log(`${key}: ${value}`)\n * }\n * ```\n *\n * @example\n * ```typescript\n * interface User {\n *   name: string\n *   age: number\n *   active: boolean\n * }\n *\n * const user: User = { name: 'Alice', age: 30, active: true }\n * const entries = objectEntries(user)\n * // Type: ([\"name\", string] | [\"age\", number] | [\"active\", boolean])[]\n * ```\n *\n * @public\n */\nexport function objectEntries<T extends Record<string, any>>(\n  obj: T,\n): ObjectEntries<T>[] {\n  return Object.entries(obj)\n}\n","/**\n * @internal\n */\nexport function objectGroupByPolyfill<K extends PropertyKey, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Partial<Record<K, T[]>> {\n  const result: Partial<Record<K, T[]>> = {}\n  let index = 0\n  for (const item of items) {\n    const key = keySelector(item, index)\n    const group = result[key]\n    if (group) {\n      group.push(item)\n    } else {\n      result[key] = [item]\n    }\n    index++\n  }\n  return result\n}\n\n/**\n * A polyfill for the [`Object.groupBy()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/groupBy) static method.\n *\n * @public\n */\nexport function objectGroupBy<K extends PropertyKey, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Partial<Record<K, T[]>> {\n  return Object.groupBy\n    ? Object.groupBy(items, keySelector)\n    : objectGroupByPolyfill(items, keySelector)\n}\n","/**\n * Creates a function that will only execute the provided function once.\n * Subsequent calls will return the cached result from the first execution.\n *\n * @param fn The function to execute once\n * @returns A function that will only execute the provided function once\n * @example\n * ```ts\n * const getValue = once(() => expensiveOperation())\n * getValue() // executes expensiveOperation\n * getValue() // returns cached result\n * ```\n */\nexport function once<T>(fn: () => T): () => T {\n  let called = false\n  let result: T\n  return () => {\n    if (!called) {\n      result = fn()\n      called = true\n      // @ts-expect-error - micro-optimization for memory management\n      fn = undefined\n    }\n    return result\n  }\n}\n","import { once } from './once'\n\n/**\n * Checks if current environment supports [regex lookbehind assertion](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Lookbehind_assertion).\n *\n * @returns `true` if the current environment supports regex lookbehind assertion, `false` otherwise.\n */\nexport const supportsRegexLookbehind: () => boolean = /* @__PURE__ */ once(\n  () => {\n    try {\n      return 'ab'.replace(new RegExp('(?<=a)b', 'g'), 'c') === 'ac'\n    } catch {\n      /* v8 ignore start */\n      return false\n      /* v8 ignore stop */\n    }\n  },\n)\n","/**\n * Returns a Promise that resolves after a specified number of milliseconds.\n *\n * @param ms - The number of milliseconds to wait.\n *\n * @example\n * ```js\n * await sleep(1000)  // Wait 1 second\n * ```\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/checker.ts","../src/counter.ts","../src/default-map.ts","../src/dom.ts","../src/format-bytes.ts","../src/get-id.ts","../src/is-deep-equal.ts","../src/map-group-by.ts","../src/map-values.ts","../src/object-entries.ts","../src/object-group-by.ts","../src/once.ts","../src/regex.ts","../src/sleep.ts","../src/throttle.ts"],"sourcesContent":["/**\n * Checks if the given value is an object.\n */\nexport function isObject(\n  value: unknown,\n): value is Record<string | symbol | number, unknown> {\n  return value != null && typeof value === 'object'\n}\n\n/**\n * Checks if the given value is a Map.\n */\nexport function isMap(value: unknown): value is Map<unknown, unknown> {\n  return value instanceof Map\n}\n\n/**\n * Checks if the given value is a Set.\n */\nexport function isSet(value: unknown): value is Set<unknown> {\n  return value instanceof Set\n}\n\n/**\n * Returns true if the given value is not null or undefined.\n */\nexport function isNotNullish<T>(value: T): value is NonNullable<T> {\n  return value != null\n}\n","/**\n * A map that counts occurrences of keys.\n *\n * @example\n * ```typescript\n * // Count word occurrences\n * const wordCounter = new Counter<string>()\n * const words = ['apple', 'banana', 'apple', 'cherry', 'banana', 'apple']\n *\n * for (const word of words) {\n *   wordCounter.increment(word)\n * }\n *\n * console.log(wordCounter.get('apple'))   // 3\n * console.log(wordCounter.get('banana'))  // 2\n * console.log(wordCounter.get('cherry'))  // 1\n * console.log(wordCounter.get('orange'))  // 0 (defaults to 0)\n * ```\n *\n * @example\n * ```typescript\n * // Initialize with existing counts\n * const counter = new Counter<string>([\n *   ['red', 5],\n *   ['blue', 3],\n *   ['green', 7]\n * ])\n *\n * counter.increment('red', 2)      // red: 5 -> 7\n * counter.decrement('blue')        // blue: 3 -> 2\n * counter.increment('yellow')      // yellow: 0 -> 1\n *\n * console.log(counter.get('red'))    // 7\n * console.log(counter.get('blue'))   // 2\n * console.log(counter.get('yellow')) // 1\n * ```\n *\n * @example\n * ```typescript\n * // Track event frequencies\n * const eventCounter = new Counter<string>()\n *\n * eventCounter.increment('click', 5)\n * eventCounter.increment('hover', 3)\n * eventCounter.increment('click', 2)\n *\n * // Get most common events\n * const events = [...eventCounter.entries()]\n *   .sort((a, b) => b[1] - a[1])\n *\n * console.log(events) // [['click', 7], ['hover', 3]]\n * ```\n */\nexport class Counter<K> extends Map<K, number> {\n  constructor(iterable?: Iterable<readonly [K, number]>) {\n    super(iterable)\n  }\n\n  override get(key: K): number {\n    return super.get(key) ?? 0\n  }\n\n  /**\n   * Increments the count for a key by a given amount (default 1).\n   */\n  increment(key: K, amount = 1): void {\n    this.set(key, this.get(key) + amount)\n  }\n\n  /**\n   * Decrements the count for a key by a given amount (default 1).\n   */\n  decrement(key: K, amount = 1): void {\n    this.set(key, this.get(key) - amount)\n  }\n}\n\n/**\n * A weak map that counts occurrences of object keys.\n *\n * Similar to {@link Counter} but uses WeakMap as the base, allowing garbage collection of keys.\n *\n * @example\n * ```typescript\n * // Track reference counts for DOM elements\n * const elementRefs = new WeakCounter<HTMLElement>()\n *\n * function addReference(element: HTMLElement) {\n *   elementRefs.increment(element)\n *   console.log(`References: ${elementRefs.get(element)}`)\n * }\n *\n * function removeReference(element: HTMLElement) {\n *   elementRefs.decrement(element)\n *   console.log(`References: ${elementRefs.get(element)}`)\n * }\n *\n * const div = document.createElement('div')\n * addReference(div)     // References: 1\n * addReference(div)     // References: 2\n * removeReference(div)  // References: 1\n * ```\n *\n * @example\n * ```typescript\n * // Count object interactions without preventing garbage collection\n * const objectInteractions = new WeakCounter<object>()\n *\n * function handleInteraction(obj: object, count = 1) {\n *   objectInteractions.increment(obj, count)\n * }\n *\n * const user = { id: 1, name: 'Alice' }\n * const session = { sessionId: 'abc123' }\n *\n * handleInteraction(user, 3)\n * handleInteraction(session, 1)\n * handleInteraction(user, 2)\n *\n * console.log(objectInteractions.get(user))     // 5\n * console.log(objectInteractions.get(session))  // 1\n * // When user and session are no longer referenced elsewhere,\n * // they can be garbage collected along with their counts\n * ```\n *\n * @example\n * ```typescript\n * // Initialize with existing counts\n * const cache1 = {}\n * const cache2 = {}\n * const cache3 = {}\n *\n * const hitCounter = new WeakCounter<object>([\n *   [cache1, 10],\n *   [cache2, 5],\n *   [cache3, 15]\n * ])\n *\n * hitCounter.increment(cache1, 3)  // 10 -> 13\n * console.log(hitCounter.get(cache1))  // 13\n * console.log(hitCounter.get(cache2))  // 5\n * ```\n */\nexport class WeakCounter<K extends WeakKey> extends WeakMap<K, number> {\n  constructor(entries?: readonly (readonly [K, number])[] | null) {\n    super(entries)\n  }\n\n  override get(key: K): number {\n    return super.get(key) ?? 0\n  }\n\n  /**\n   * Increments the count for a key by a given amount (default 1).\n   */\n  increment(key: K, amount = 1): void {\n    this.set(key, this.get(key) + amount)\n  }\n\n  /**\n   * Decrements the count for a key by a given amount (default 1).\n   */\n  decrement(key: K, amount = 1): void {\n    this.set(key, this.get(key) - amount)\n  }\n}\n","/**\n * A map that automatically creates values for missing keys using a factory function.\n *\n * Similar to Python's [defaultdict](https://docs.python.org/3.13/library/collections.html#collections.defaultdict).\n *\n * @example\n * ```typescript\n * // Group items by category using arrays\n * const groupByCategory = new DefaultMap<string, string[]>(() => [])\n *\n * groupByCategory.get('fruits').push('apple', 'banana')\n * groupByCategory.get('vegetables').push('carrot')\n * groupByCategory.get('fruits').push('orange')\n *\n * console.log(groupByCategory.get('fruits'))      // ['apple', 'banana', 'orange']\n * console.log(groupByCategory.get('vegetables'))  // ['carrot']\n * console.log(groupByCategory.get('dairy'))       // [] (auto-created)\n * ```\n *\n * @example\n * ```typescript\n * // Build a graph with adjacency lists\n * const graph = new DefaultMap<string, Set<string>>(() => new Set())\n *\n * graph.get('A').add('B').add('C')\n * graph.get('B').add('C').add('D')\n * graph.get('C').add('D')\n *\n * console.log([...graph.get('A')])  // ['B', 'C']\n * console.log([...graph.get('B')])  // ['C', 'D']\n * console.log([...graph.get('E')])  // [] (auto-created empty set)\n * ```\n *\n * @example\n * ```typescript\n * // Initialize with existing entries\n * const scores = new DefaultMap<string, number>(\n *   () => 0,\n *   [\n *     ['Alice', 100],\n *     ['Bob', 85]\n *   ]\n * )\n *\n * scores.set('Alice', scores.get('Alice') + 10)  // 100 -> 110\n * console.log(scores.get('Alice'))   // 110\n * console.log(scores.get('Bob'))     // 85\n * console.log(scores.get('Charlie')) // 0 (auto-created)\n * ```\n *\n * @example\n * ```typescript\n * // Nested DefaultMaps for 2D data structures\n * const matrix = new DefaultMap<number, DefaultMap<number, number>>(\n *   () => new DefaultMap<number, number>(() => 0)\n * )\n *\n * matrix.get(0).set(0, 1)\n * matrix.get(0).set(1, 2)\n * matrix.get(1).set(1, 3)\n *\n * console.log(matrix.get(0).get(0))  // 1\n * console.log(matrix.get(0).get(1))  // 2\n * console.log(matrix.get(1).get(0))  // 0 (auto-created)\n * console.log(matrix.get(2).get(3))  // 0 (both auto-created)\n * ```\n */\nexport class DefaultMap<K, V> extends Map<K, V> {\n  private readonly defaultFactory: () => V\n\n  constructor(defaultFactory: () => V, iterable?: Iterable<readonly [K, V]>) {\n    super(iterable)\n    this.defaultFactory = defaultFactory\n  }\n\n  override get(key: K): V {\n    if (this.has(key)) {\n      return super.get(key)!\n    }\n    const value = this.defaultFactory()\n    this.set(key, value)\n    return value\n  }\n}\n\n/**\n * A weak map that automatically creates values for missing keys using a factory function.\n *\n * Similar to {@link DefaultMap} but uses WeakMap as the base, allowing garbage collection of keys.\n *\n * @example\n * ```typescript\n * // Store metadata for DOM elements without preventing garbage collection\n * const elementMetadata = new DefaultWeakMap<HTMLElement, { clicks: number; hovers: number }>(\n *   () => ({ clicks: 0, hovers: 0 })\n * )\n *\n * const button = document.querySelector('button')!\n * const div = document.querySelector('div')!\n *\n * elementMetadata.get(button).clicks++\n * elementMetadata.get(button).clicks++\n * elementMetadata.get(div).hovers++\n *\n * console.log(elementMetadata.get(button)) // { clicks: 2, hovers: 0 }\n * console.log(elementMetadata.get(div))    // { clicks: 0, hovers: 1 }\n * // When elements are removed from DOM and not referenced,\n * // their metadata can be garbage collected\n * ```\n *\n * @example\n * ```typescript\n * // Cache computed properties for objects\n * const computedCache = new DefaultWeakMap<object, Map<string, any>>(\n *   () => new Map()\n * )\n *\n * function getOrCompute(obj: object, key: string, compute: () => any) {\n *   const cache = computedCache.get(obj)\n *   if (!cache.has(key)) {\n *     cache.set(key, compute())\n *   }\n *   return cache.get(key)\n * }\n *\n * const user = { name: 'Alice', age: 30 }\n * const displayName = getOrCompute(user, 'displayName', () => user.name.toUpperCase())\n * const birthYear = getOrCompute(user, 'birthYear', () => new Date().getFullYear() - user.age)\n *\n * console.log(displayName) // 'ALICE'\n * console.log(birthYear)   // 1994 (or current year - 30)\n * ```\n *\n * @example\n * ```typescript\n * // Initialize with existing entries\n * const obj1 = {}\n * const obj2 = {}\n *\n * const objectData = new DefaultWeakMap<object, string[]>(\n *   () => [],\n *   [\n *     [obj1, ['tag1', 'tag2']],\n *     [obj2, ['tag3']]\n *   ]\n * )\n *\n * objectData.get(obj1).push('tag4')\n * console.log(objectData.get(obj1))  // ['tag1', 'tag2', 'tag4']\n * console.log(objectData.get(obj2))  // ['tag3']\n *\n * const obj3 = {}\n * console.log(objectData.get(obj3))  // [] (auto-created)\n * ```\n *\n * @example\n * ```typescript\n * // Track event listeners per element using both DefaultWeakMap and DefaultMap\n * const eventListeners = new DefaultWeakMap<EventTarget, DefaultMap<string, Function[]>>(\n *   () => new DefaultMap<string, Function[]>(() => [])\n * )\n *\n * function addListener(target: EventTarget, event: string, handler: Function) {\n *   eventListeners.get(target).get(event).push(handler)\n * }\n *\n * const element = document.createElement('button')\n * addListener(element, 'click', () => console.log('clicked'))\n * addListener(element, 'click', () => console.log('also clicked'))\n * addListener(element, 'hover', () => console.log('hovered'))\n *\n * console.log(eventListeners.get(element).get('click').length)  // 2\n * console.log(eventListeners.get(element).get('hover').length)  // 1\n * // No need for has() checks or null assertions - everything auto-initializes!\n * ```\n */\nexport class DefaultWeakMap<K extends WeakKey, V> extends WeakMap<K, V> {\n  private readonly defaultFactory: () => V\n\n  constructor(\n    defaultFactory: () => V,\n    entries?: readonly (readonly [K, V])[] | null,\n  ) {\n    super(entries)\n    this.defaultFactory = defaultFactory\n  }\n\n  override get(key: K): V {\n    if (this.has(key)) {\n      return super.get(key)!\n    }\n    const value = this.defaultFactory()\n    this.set(key, value)\n    return value\n  }\n}\n","import { isObject } from './checker'\nimport * as NodeType from './dom-node-type'\n\n/**\n * Checks if the given DOM node is an Element.\n */\nexport function isElement(node: Node): node is Element {\n  return node.nodeType === NodeType.ELEMENT_NODE\n}\n\n/**\n * Checks if the given DOM node is a Text node.\n */\nexport function isTextNode(node: Node): node is Text {\n  return node.nodeType === NodeType.TEXT_NODE\n}\n\n/**\n * Checks if the given DOM node is an HTMLElement.\n */\nexport function isHTMLElement(node: Node): node is HTMLElement {\n  return isElement(node) && node.namespaceURI === 'http://www.w3.org/1999/xhtml'\n}\n\n/**\n * Checks if the given DOM node is an SVGElement.\n */\nexport function isSVGElement(node: Node): node is SVGElement {\n  return isElement(node) && node.namespaceURI === 'http://www.w3.org/2000/svg'\n}\n\n/**\n * Checks if the given DOM node is an MathMLElement.\n */\nexport function isMathMLElement(node: Node): node is MathMLElement {\n  return (\n    isElement(node) &&\n    node.namespaceURI === 'http://www.w3.org/1998/Math/MathML'\n  )\n}\n\n/**\n * Checks if the given DOM node is a Document.\n */\nexport function isDocument(node: Node): node is Document {\n  return node.nodeType === NodeType.DOCUMENT_NODE\n}\n\n/**\n * Checks if the given DOM node is a DocumentFragment.\n */\nexport function isDocumentFragment(node: Node): node is DocumentFragment {\n  return node.nodeType === NodeType.DOCUMENT_FRAGMENT_NODE\n}\n\n/**\n * Checks if the given DOM node is a ShadowRoot.\n */\nexport function isShadowRoot(node: Node): node is ShadowRoot {\n  return isDocumentFragment(node) && 'host' in node && isElementLike(node.host)\n}\n\n/**\n * Checks if an unknown value is likely a DOM node.\n */\nexport function isNodeLike(value: unknown): value is Node {\n  return isObject(value) && value.nodeType !== undefined\n}\n\n/**\n * Checks if an unknown value is likely a DOM element.\n */\nexport function isElementLike(value: unknown): value is Element {\n  return (\n    isObject(value) &&\n    value.nodeType === NodeType.ELEMENT_NODE &&\n    typeof value.nodeName === 'string'\n  )\n}\n\n/**\n * Checks if the given value is likely a Window object.\n */\nexport function isWindowLike(value: unknown): value is Window {\n  return isObject(value) && value.window === value\n}\n\n/**\n * Gets the window object for the given target or the global window object if no\n * target is provided.\n */\nexport function getWindow(\n  target?: Node | ShadowRoot | Document | null,\n): Window & typeof globalThis {\n  if (target) {\n    if (isShadowRoot(target)) {\n      return getWindow(target.host)\n    }\n    if (isDocument(target)) {\n      return target.defaultView || window\n    }\n    if (isElement(target)) {\n      return target.ownerDocument?.defaultView || window\n    }\n  }\n  return window\n}\n\n/**\n * Gets the document for the given target or the global document if no target is\n * provided.\n */\nexport function getDocument(\n  target?: Element | Window | Node | Document | null,\n): Document {\n  if (target) {\n    if (isWindowLike(target)) {\n      return target.document\n    }\n    if (isDocument(target)) {\n      return target\n    }\n    return target.ownerDocument || document\n  }\n  return document\n}\n\n/**\n * Gets a reference to the root node of the document based on the given target.\n */\nexport function getDocumentElement(\n  target?: Element | Node | Window | Document | null,\n): HTMLElement {\n  return getDocument(target).documentElement\n}\n","/**\n * Formats a number of bytes into a human-readable string.\n * @param bytes - The number of bytes to format.\n * @returns A string representing the number of bytes in a human-readable format.\n */\nexport function formatBytes(bytes: number): string {\n  const units = ['B', 'KB', 'MB', 'GB']\n  let unitIndex = 0\n  let num = bytes\n  while (Math.abs(num) >= 1024 && unitIndex < units.length - 1) {\n    num /= 1024\n    unitIndex++\n  }\n  const fraction = unitIndex === 0 && num % 1 === 0 ? 0 : 1\n  return `${num.toFixed(fraction)}${units[unitIndex]}`\n}\n","let id = 0\n\nlet maxSafeInteger = Number.MAX_SAFE_INTEGER\n\n/**\n * Sets the maximum safe integer for the id generator. Only for testing purposes.\n *\n * @internal\n */\nexport function setMaxSafeInteger(max: number) {\n  maxSafeInteger = max\n}\n\n/**\n * Generates a unique positive integer.\n */\nexport function getId(): number {\n  id++\n  if (id >= maxSafeInteger) {\n    id = 1\n  }\n  return id\n}\n","import { isMap, isSet } from './checker'\n\n/**\n * Whether two values are deeply equal.\n */\nexport function isDeepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) {\n    return true\n  }\n\n  // Handle null and undefined early\n  if (a == null || b == null) {\n    return false\n  }\n\n  const aType = typeof a\n  const bType = typeof b\n  if (aType !== bType) {\n    return false\n  }\n\n  if (aType === 'number' && Number.isNaN(a) && Number.isNaN(b)) {\n    return true\n  }\n\n  if (Array.isArray(a)) {\n    if (!Array.isArray(b)) {\n      return false\n    }\n    if (a.length !== b.length) {\n      return false\n    }\n    const size = a.length\n    for (let i = 0; i < size; i++) {\n      if (!isDeepEqual(a[i], b[i])) {\n        return false\n      }\n    }\n    return true\n  }\n\n  if (isSet(a)) {\n    if (!isSet(b)) {\n      return false\n    }\n    if (a.size !== b.size) {\n      return false\n    }\n    for (const value of a) {\n      if (!b.has(value)) {\n        return false\n      }\n    }\n    return true\n  }\n\n  if (isMap(a)) {\n    if (!isMap(b)) {\n      return false\n    }\n    if (a.size !== b.size) {\n      return false\n    }\n    for (const key of a.keys()) {\n      if (!b.has(key)) {\n        return false\n      }\n      if (!isDeepEqual(a.get(key), b.get(key))) {\n        return false\n      }\n    }\n    return true\n  }\n\n  if (typeof a === 'object' && typeof b === 'object') {\n    const aKeys = Object.keys(a)\n    const bKeys = Object.keys(b)\n    if (aKeys.length !== bKeys.length) {\n      return false\n    }\n    for (const key of aKeys) {\n      if (\n        !isDeepEqual(\n          (a as Record<string, unknown>)[key],\n          (b as Record<string, unknown>)[key],\n        )\n      ) {\n        return false\n      }\n    }\n    return true\n  }\n\n  return false\n}\n","/**\n * @internal\n */\nexport function mapGroupByPolyfill<K, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Map<K, T[]> {\n  const map = new Map<K, T[]>()\n  let index = 0\n  for (const item of items) {\n    const key = keySelector(item, index)\n    const group = map.get(key)\n    if (group) {\n      group.push(item)\n    } else {\n      map.set(key, [item])\n    }\n    index++\n  }\n  return map\n}\n\n/**\n * A polyfill for the [`Map.groupBy()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/groupBy) static method.\n *\n * @public\n */\nexport function mapGroupBy<K, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Map<K, T[]> {\n  return Map.groupBy\n    ? Map.groupBy(items, keySelector)\n    : mapGroupByPolyfill(items, keySelector)\n}\n","/**\n * Creates a new object with the same keys as the input object, but with values\n * transformed by the provided callback function. Similar to `Array.prototype.map()`\n * but for object values.\n\n * @param object - The object whose values will be transformed.\n * @param callback - A function that transforms each value. Receives the value and\n *   its corresponding key as arguments.\n * @returns A new object with the same keys but transformed values.\n *\n * @example\n * ```typescript\n * const prices = { apple: 1, banana: 2, orange: 3 }\n * const doubled = mapValues(prices, (price) => price * 2)\n * // Result: { apple: 2, banana: 4, orange: 6 }\n * ```\n *\n * @example\n * ```typescript\n * const users = { john: 25, jane: 30, bob: 35 }\n * const greetings = mapValues(users, (age, name) => `${name} is ${age} years old`)\n * // Result: { john: 'john is 25 years old', jane: 'jane is 30 years old', bob: 'bob is 35 years old' }\n * ```\n *\n * @example\n * ```typescript\n * const data = { a: '1', b: '2', c: '3' }\n * const numbers = mapValues(data, (str) => parseInt(str, 10))\n * // Result: { a: 1, b: 2, c: 3 }\n * ```\n *\n * @public\n */\nexport function mapValues<ValueIn, ValueOut>(\n  object: Record<string, ValueIn>,\n  callback: (value: ValueIn, key: string) => ValueOut,\n): Record<string, ValueOut> {\n  const result = {} as Record<string, ValueOut>\n  for (const [key, value] of Object.entries(object)) {\n    result[key] = callback(value, key)\n  }\n  return result\n}\n","/**\n * A TypeScript utility type that represents the entries of an object as a union of tuple types.\n * Each tuple contains a key-value pair where the key and value types are precisely typed\n * according to the input object type.\n *\n * @example\n * ```typescript\n * type MyObject = { a: 1; b: 'B' }\n * type MyEntries = ObjectEntries<MyObject>\n * //   ^ [\"a\", 1] | [\"b\", \"B\"]\n * ```\n *\n * @public\n */\nexport type ObjectEntries<T extends Record<string, any>> = {\n  [K in keyof T]: [K, T[K]]\n}[keyof T]\n\n/**\n * A type-safe wrapper around\n * [`Object.entries()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries)\n * that preserves the exact types of object keys and values. Unlike the standard\n * `Object.entries()` which returns `[string, any][]`, this function returns an\n * array of tuples where each tuple is precisely typed according to the input\n * object's structure.\n *\n * This is particularly useful when working with objects that have known, fixed\n * property types and you want to maintain type safety when iterating over\n * entries.\n *\n * @example\n * ```typescript\n * const myObject = { a: 1, b: 'hello', c: true } as const\n * const entries = objectEntries(myObject)\n * // Type: ([\"a\", 1] | [\"b\", \"hello\"] | [\"c\", true])[]\n *\n * for (const [key, value] of entries) {\n *   // key is typed as \"a\" | \"b\" | \"c\"\n *   // value is typed as 1 | \"hello\" | true\n *   console.log(`${key}: ${value}`)\n * }\n * ```\n *\n * @example\n * ```typescript\n * interface User {\n *   name: string\n *   age: number\n *   active: boolean\n * }\n *\n * const user: User = { name: 'Alice', age: 30, active: true }\n * const entries = objectEntries(user)\n * // Type: ([\"name\", string] | [\"age\", number] | [\"active\", boolean])[]\n * ```\n *\n * @public\n */\nexport function objectEntries<T extends Record<string, any>>(\n  obj: T,\n): ObjectEntries<T>[] {\n  return Object.entries(obj)\n}\n","/**\n * @internal\n */\nexport function objectGroupByPolyfill<K extends PropertyKey, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Partial<Record<K, T[]>> {\n  const result: Partial<Record<K, T[]>> = {}\n  let index = 0\n  for (const item of items) {\n    const key = keySelector(item, index)\n    const group = result[key]\n    if (group) {\n      group.push(item)\n    } else {\n      result[key] = [item]\n    }\n    index++\n  }\n  return result\n}\n\n/**\n * A polyfill for the [`Object.groupBy()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/groupBy) static method.\n *\n * @public\n */\nexport function objectGroupBy<K extends PropertyKey, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Partial<Record<K, T[]>> {\n  return Object.groupBy\n    ? Object.groupBy(items, keySelector)\n    : objectGroupByPolyfill(items, keySelector)\n}\n","/**\n * Creates a function that will only execute the provided function once.\n * Subsequent calls will return the cached result from the first execution.\n *\n * @param fn The function to execute once\n * @returns A function that will only execute the provided function once\n * @example\n * ```ts\n * const getValue = once(() => expensiveOperation())\n * getValue() // executes expensiveOperation\n * getValue() // returns cached result\n * ```\n */\nexport function once<T>(fn: () => T): () => T {\n  let called = false\n  let result: T\n  return () => {\n    if (!called) {\n      result = fn()\n      called = true\n      // @ts-expect-error - micro-optimization for memory management\n      fn = undefined\n    }\n    return result\n  }\n}\n","import { once } from './once'\n\n/**\n * Checks if current environment supports [regex lookbehind assertion](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Lookbehind_assertion).\n *\n * @returns `true` if the current environment supports regex lookbehind assertion, `false` otherwise.\n */\nexport const supportsRegexLookbehind: () => boolean = /* @__PURE__ */ once(\n  () => {\n    try {\n      return 'ab'.replaceAll(new RegExp('(?<=a)b', 'g'), 'c') === 'ac'\n    } catch {\n      /* v8 ignore start */\n      return false\n      /* v8 ignore stop */\n    }\n  },\n)\n","/**\n * Returns a Promise that resolves after a specified number of milliseconds.\n *\n * @param ms - The number of milliseconds to wait.\n *\n * @example\n * ```js\n * await sleep(1000)  // Wait 1 second\n * ```\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n","/**\n * Creates a throttled function that only invokes `fn` at most once per every\n * `wait` milliseconds. The first call executes immediately (leading edge).\n * If called again during the wait period, the last call will be executed at\n * the end of the wait period (trailing edge).\n *\n * @param callback The function to throttle\n * @param wait The number of milliseconds to throttle invocations to\n * @returns A throttled version of the function\n * @example\n * ```js\n * const throttled = throttle((name) => console.log('called', name), 1000)\n * throttled('Alice') // logs 'called Alice' immediately\n * throttled('Bob') // skipped (within 1000ms)\n * throttled('Charlie') // skipped (within 1000ms)\n * // after 1000ms, logs 'called Charlie' again (trailing call)\n * ```\n */\nexport function throttle<T extends (this: any, ...args: any[]) => unknown>(\n  callback: T,\n  wait: number,\n): (this: ThisParameterType<T>, ...args: Parameters<T>) => void {\n  let timeoutId: ReturnType<typeof setTimeout> | undefined\n  let lastCallTime = 0\n\n  return function throttled(\n    this: ThisParameterType<T>,\n    ...args: Parameters<T>\n  ): void {\n    clearTimeout(timeoutId)\n\n    const now = Date.now()\n    const delay = wait + lastCallTime - now\n\n    if (delay <= 0) {\n      lastCallTime = now\n      callback.apply(this, args)\n    } else {\n      timeoutId = setTimeout(() => {\n        lastCallTime = Date.now()\n        callback.apply(this, args)\n      }, delay)\n    }\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ocavue/utils",
   "type": "module",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "A collection of utility functions for the browser and other environments",
   "author": "ocavue <ocavue@gmail.com>",
   "license": "MIT",
@@ -37,20 +37,20 @@
     "dist"
   ],
   "devDependencies": {
-    "@ocavue/eslint-config": "^3.12.0",
+    "@ocavue/eslint-config": "^4.2.0",
     "@ocavue/tsconfig": "^0.6.3",
     "@size-limit/preset-small-lib": "^12.0.0",
     "@types/node": "^24.9.2",
     "@vitest/coverage-v8": "^4.0.18",
-    "eslint": "^9.39.2",
+    "eslint": "^10.0.2",
     "jsdom": "^28.1.0",
-    "knip": "^5.83.1",
-    "pkg-pr-new": "^0.0.63",
+    "knip": "^5.85.0",
+    "pkg-pr-new": "^0.0.65",
     "prettier": "^3.8.1",
     "size-limit": "^12.0.0",
     "tinyexec": "^1.0.2",
     "tinyglobby": "^0.2.15",
-    "tsdown": "^0.20.3",
+    "tsdown": "^0.21.2",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },

package/src/index.ts

@@ -12,3 +12,4 @@ export { objectGroupBy } from './object-group-by'
 export { once } from './once'
 export { supportsRegexLookbehind } from './regex'
 export { sleep } from './sleep'
+export { throttle } from './throttle'

package/src/regex.ts

@@ -8,7 +8,7 @@ import { once } from './once'
 export const supportsRegexLookbehind: () => boolean = /* @__PURE__ */ once(
   () => {
     try {
-      return 'ab'.replace(new RegExp('(?<=a)b', 'g'), 'c') === 'ac'
+      return 'ab'.replaceAll(new RegExp('(?<=a)b', 'g'), 'c') === 'ac'
     } catch {
       /* v8 ignore start */
       return false

package/src/throttle.test.ts

@@ -0,0 +1,143 @@
+// @vitest-environment node
+
+import { describe, expect, it, vi } from 'vitest'
+
+import { throttle } from './throttle'
+
+describe('throttle', () => {
+  it('calls the function immediately on first invocation', () => {
+    vi.useFakeTimers()
+
+    const spy = vi.fn()
+    const throttled = throttle(spy, 100)
+
+    throttled()
+    expect(spy).toHaveBeenCalledTimes(1)
+
+    vi.useRealTimers()
+  })
+
+  it('passes arguments correctly', () => {
+    vi.useFakeTimers()
+
+    const spy = vi.fn()
+    const throttled = throttle(spy, 100)
+
+    throttled('a', 'b')
+    expect(spy).toHaveBeenCalledWith('a', 'b')
+
+    vi.useRealTimers()
+  })
+
+  it('ignores calls during the wait period', () => {
+    vi.useFakeTimers()
+
+    const spy = vi.fn()
+    const throttled = throttle(spy, 100)
+
+    throttled()
+    throttled()
+    throttled()
+
+    expect(spy).toHaveBeenCalledTimes(1)
+
+    vi.useRealTimers()
+  })
+
+  it('executes trailing call with latest args after wait period', () => {
+    vi.useFakeTimers()
+
+    const spy = vi.fn()
+    const throttled = throttle(spy, 100)
+
+    throttled('first')
+    throttled('second')
+    throttled('third')
+
+    expect(spy).toHaveBeenCalledTimes(1)
+    expect(spy).toHaveBeenCalledWith('first')
+
+    vi.advanceTimersByTime(100)
+
+    expect(spy).toHaveBeenCalledTimes(2)
+    expect(spy).toHaveBeenLastCalledWith('third')
+
+    vi.useRealTimers()
+  })
+
+  it('allows a new call after the wait period has elapsed', () => {
+    vi.useFakeTimers()
+
+    const spy = vi.fn()
+    const throttled = throttle(spy, 100)
+
+    throttled()
+    expect(spy).toHaveBeenCalledTimes(1)
+
+    vi.advanceTimersByTime(100)
+
+    throttled()
+    expect(spy).toHaveBeenCalledTimes(2)
+
+    vi.useRealTimers()
+  })
+
+  it('preserves this context on leading call', () => {
+    vi.useFakeTimers()
+
+    const obj = {
+      value: 42,
+      throttled: throttle(function (this: { value: number }) {
+        return this.value
+      }, 100),
+    }
+
+    const spy = vi.fn()
+    obj.throttled = throttle(function (this: { value: number }) {
+      spy(this.value)
+    }, 100)
+
+    obj.throttled()
+    expect(spy).toHaveBeenCalledWith(42)
+
+    vi.useRealTimers()
+  })
+
+  it('preserves this context on trailing call', () => {
+    vi.useFakeTimers()
+
+    const spy = vi.fn()
+    const obj = {
+      value: 42,
+      throttled: throttle(function (this: { value: number }) {
+        spy(this.value)
+      }, 100),
+    }
+
+    obj.throttled()
+    obj.throttled()
+
+    vi.advanceTimersByTime(100)
+
+    expect(spy).toHaveBeenCalledTimes(2)
+    expect(spy).toHaveBeenLastCalledWith(42)
+
+    vi.useRealTimers()
+  })
+
+  it('does not fire trailing call if no calls during wait', () => {
+    vi.useFakeTimers()
+
+    const spy = vi.fn()
+    const throttled = throttle(spy, 100)
+
+    throttled()
+    expect(spy).toHaveBeenCalledTimes(1)
+
+    vi.advanceTimersByTime(200)
+
+    expect(spy).toHaveBeenCalledTimes(1)
+
+    vi.useRealTimers()
+  })
+})

package/src/throttle.ts

@@ -0,0 +1,45 @@
+/**
+ * Creates a throttled function that only invokes `fn` at most once per every
+ * `wait` milliseconds. The first call executes immediately (leading edge).
+ * If called again during the wait period, the last call will be executed at
+ * the end of the wait period (trailing edge).
+ *
+ * @param callback The function to throttle
+ * @param wait The number of milliseconds to throttle invocations to
+ * @returns A throttled version of the function
+ * @example
+ * ```js
+ * const throttled = throttle((name) => console.log('called', name), 1000)
+ * throttled('Alice') // logs 'called Alice' immediately
+ * throttled('Bob') // skipped (within 1000ms)
+ * throttled('Charlie') // skipped (within 1000ms)
+ * // after 1000ms, logs 'called Charlie' again (trailing call)
+ * ```
+ */
+export function throttle<T extends (this: any, ...args: any[]) => unknown>(
+  callback: T,
+  wait: number,
+): (this: ThisParameterType<T>, ...args: Parameters<T>) => void {
+  let timeoutId: ReturnType<typeof setTimeout> | undefined
+  let lastCallTime = 0
+
+  return function throttled(
+    this: ThisParameterType<T>,
+    ...args: Parameters<T>
+  ): void {
+    clearTimeout(timeoutId)
+
+    const now = Date.now()
+    const delay = wait + lastCallTime - now
+
+    if (delay <= 0) {
+      lastCallTime = now
+      callback.apply(this, args)
+    } else {
+      timeoutId = setTimeout(() => {
+        lastCallTime = Date.now()
+        callback.apply(this, args)
+      }, delay)
+    }
+  }
+}