@ocavue/utils 1.1.0 → 1.3.0

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","mapGroupBy: <K, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n) => Map<K, T[]>","result: Partial<Record<K, T[]>>","objectGroupBy: <K extends PropertyKey, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n) => Partial<Record<K, T[]>>","result: T"],"sources":["../src/checker.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/object-group-by.ts","../src/once.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 * 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 */\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","// 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\n/**\n * Generates a unique positive integer.\n */\nexport function getId(): number {\n  id = (id % Number.MAX_SAFE_INTEGER) + 1\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 * @internal\n */\nexport function mapGroupByNative<K, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Map<K, T[]> {\n  return Map.groupBy(items, keySelector)\n}\n\n/**\n * A polyfill for the `Map.groupBy` static method.\n *\n * @public\n */\nexport const mapGroupBy: <K, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n) => Map<K, T[]> = !!Map.groupBy ? mapGroupByNative : mapGroupByPolyfill\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 * @internal\n */\nexport function objectGroupByNative<K extends PropertyKey, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Partial<Record<K, T[]>> {\n  return Object.groupBy(items, keySelector)\n}\n\n/**\n * A polyfill for the `Object.groupBy` static method.\n *\n * @public\n */\nexport const objectGroupBy: <K extends PropertyKey, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n) => Partial<Record<K, T[]>> = !!Object.groupBy\n  ? objectGroupByNative\n  : objectGroupByPolyfill\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","/**\n * Sleep for a given number of milliseconds.\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":["NodeType.ELEMENT_NODE","NodeType.TEXT_NODE","NodeType.DOCUMENT_NODE","NodeType.DOCUMENT_FRAGMENT_NODE","hasMapGroupBy: boolean","mapGroupBy: <K, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n) => Map<K, T[]>","objectEntries: <T extends Record<string, any>>(\n  obj: T,\n) => ObjectEntries<T>[]","result: Partial<Record<K, T[]>>","hasObjectGroupBy: boolean","objectGroupBy: <K extends PropertyKey, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n) => Partial<Record<K, T[]>>","result: T"],"sources":["../src/checker.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/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 * 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 */\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 DefaultMap but uses WeakMap as the base, allowing garbage collection of keys.\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\n/**\n * A map that counts occurrences of keys.\n *\n * Similar to Python's [Counter](https://docs.python.org/3.13/library/collections.html#collections.Counter).\n */\nexport class Counter<K> extends DefaultMap<K, number> {\n  constructor(iterable?: Iterable<readonly [K, number]>) {\n    super(() => 0, iterable)\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 Counter but uses WeakMap as the base, allowing garbage collection of keys.\n */\nexport class WeakCounter<K extends WeakKey> extends DefaultWeakMap<K, number> {\n  constructor(entries?: readonly (readonly [K, number])[] | null) {\n    super(() => 0, entries)\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","// 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 * @internal\n */\nexport function mapGroupByNative<K, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Map<K, T[]> {\n  return Map.groupBy(items, keySelector)\n}\n\nconst hasMapGroupBy: boolean = /* @__PURE__ */ (() => !!Map.groupBy)()\n\n/**\n * A polyfill for the `Map.groupBy` static method.\n *\n * @public\n */\nexport const mapGroupBy: <K, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n) => Map<K, T[]> = hasMapGroupBy ? mapGroupByNative : mapGroupByPolyfill\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  let 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 `Object.entries()` that preserves the exact types of object keys\n * and values. Unlike the standard `Object.entries()` which returns `[string, any][]`, this\n * function returns an array of tuples where each tuple is precisely typed according to the\n * input object's structure.\n *\n * This is particularly useful when working with objects that have known, fixed property types\n * and you want to maintain type safety when iterating over 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 const objectEntries: <T extends Record<string, any>>(\n  obj: T,\n) => ObjectEntries<T>[] = Object.entries\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 * @internal\n */\nexport function objectGroupByNative<K extends PropertyKey, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n): Partial<Record<K, T[]>> {\n  return Object.groupBy(items, keySelector)\n}\n\nconst hasObjectGroupBy: boolean = /* @__PURE__ */ (() => !!Object.groupBy)()\n\n/**\n * A polyfill for the `Object.groupBy` static method.\n *\n * @public\n */\nexport const objectGroupBy: <K extends PropertyKey, T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => K,\n) => Partial<Record<K, T[]>> = hasObjectGroupBy\n  ? objectGroupByNative\n  : objectGroupByPolyfill\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","/**\n * Sleep for a given number of milliseconds.\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ocavue/utils",
   "type": "module",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "A collection of utility functions for the browser and other environments",
   "author": "ocavue <ocavue@gmail.com>",
   "license": "MIT",
@@ -37,20 +37,23 @@
     "dist"
   ],
   "devDependencies": {
-    "@ocavue/eslint-config": "^3.6.2",
-    "@ocavue/tsconfig": "^0.6.1",
-    "@size-limit/preset-small-lib": "^11.2.0",
+    "@ocavue/eslint-config": "^3.8.0",
+    "@ocavue/tsconfig": "^0.6.2",
+    "@size-limit/preset-small-lib": "^12.0.0",
     "@types/node": "^24.9.2",
-    "@vitest/coverage-v8": "4.0.13",
-    "eslint": "^9.38.0",
-    "jsdom": "^27.2.0",
-    "pkg-pr-new": "^0.0.60",
-    "prettier": "^3.6.2",
-    "size-limit": "^11.2.0",
-    "tsdown": "^0.16.6",
+    "@vitest/coverage-v8": "^4.0.16",
+    "esbuild": "^0.27.2",
+    "eslint": "^9.39.2",
+    "jsdom": "^27.3.0",
+    "pkg-pr-new": "^0.0.62",
+    "prettier": "^3.7.4",
+    "size-limit": "^12.0.0",
+    "tinyexec": "^1.0.2",
+    "tinyglobby": "^0.2.15",
+    "tsdown": "^0.18.3",
     "typescript": "^5.9.3",
-    "vite": "^7.2.4",
-    "vitest": "^4.0.13"
+    "vite": "^7.3.0",
+    "vitest": "^4.0.16"
   },
   "publishConfig": {
     "access": "public"

package/src/__snapshots__/e2e.test.ts.snap

@@ -0,0 +1,247 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`e2e > bundler outputs match snapshot 1`] = `
+"
+################################################################################
+esbuild/fn1.js
+--------------------------------------------------------------------------------
+var s = 2 ** 53 - 1
+function e(t) {
+  let n = !1,
+    r
+  return () => (n || ((r = t()), (n = !0), (t = void 0)), r)
+}
+function o() {
+  console.log('function_1')
+}
+function u() {
+  console.log('function_2')
+}
+var l = e(u)
+function i() {
+  console.log('function_3')
+}
+var p = e(i)
+export { o as fn1 }
+
+
+################################################################################
+esbuild/fn2.js
+--------------------------------------------------------------------------------
+var i = 2 ** 53 - 1
+function e(t) {
+  let n = !1,
+    r
+  return () => (n || ((r = t()), (n = !0), (t = void 0)), r)
+}
+function o() {
+  console.log('function_2')
+}
+var f = e(o)
+function u() {
+  console.log('function_3')
+}
+var l = e(u)
+export { o as fn2 }
+
+
+################################################################################
+esbuild/fn3.js
+--------------------------------------------------------------------------------
+var i = 2 ** 53 - 1
+function e(t) {
+  let n = !1,
+    r
+  return () => (n || ((r = t()), (n = !0), (t = void 0)), r)
+}
+function u() {
+  console.log('function_2')
+}
+var f = e(u)
+function o() {
+  console.log('function_3')
+}
+var l = e(o)
+export { o as fn3 }
+
+
+################################################################################
+esbuild/fn4.js
+--------------------------------------------------------------------------------
+var s = 2 ** 53 - 1
+function e(t) {
+  let n = !1,
+    r
+  return () => (n || ((r = t()), (n = !0), (t = void 0)), r)
+}
+function o() {
+  console.log('function_2')
+}
+var l = e(o)
+function u() {
+  console.log('function_3')
+}
+var p = e(u)
+function i() {
+  console.log('function_4')
+}
+export { i as fn4 }
+
+
+################################################################################
+rolldown/fn1.js
+--------------------------------------------------------------------------------
+function e() {
+  console.log(\`function_1\`)
+}
+export { e as fn1 }
+
+
+################################################################################
+rolldown/fn2.js
+--------------------------------------------------------------------------------
+function e() {
+  console.log(\`function_2\`)
+}
+export { e as fn2 }
+
+
+################################################################################
+rolldown/fn3.js
+--------------------------------------------------------------------------------
+function e() {
+  console.log(\`function_3\`)
+}
+export { e as fn3 }
+
+
+################################################################################
+rolldown/fn4.js
+--------------------------------------------------------------------------------
+function e() {
+  console.log(\`function_4\`)
+}
+export { e as fn4 }
+
+
+################################################################################
+rollup/fn1.js
+--------------------------------------------------------------------------------
+// A function that is not wrapped by \`once()\`
+function fn1() {
+  console.log('function_1')
+}
+
+export { fn1 }
+
+
+################################################################################
+rollup/fn2.js
+--------------------------------------------------------------------------------
+// A function that is wrapped by \`once()\`, but the wrapper is not exported
+function fn2() {
+  console.log('function_2')
+}
+
+export { fn2 }
+
+
+################################################################################
+rollup/fn3.js
+--------------------------------------------------------------------------------
+// A function that is wrapped by \`once()\`, and the wrapper is exported
+function fn3() {
+  console.log('function_3')
+}
+
+export { fn3 }
+
+
+################################################################################
+rollup/fn4.js
+--------------------------------------------------------------------------------
+// A function that is wrapped by \`once()\`, but the wrapper is marked as \`__PURE__\`
+function fn4() {
+  console.log('function_4')
+}
+
+export { fn4 }
+
+
+################################################################################
+rslib/fn1.js
+--------------------------------------------------------------------------------
+function n(n) {
+  let o = !1,
+    c
+  return () => (o || ((c = n()), (o = !0), (n = void 0)), c)
+}
+function o() {
+  console.log('function_1')
+}
+;(n(function () {
+  console.log('function_2')
+}),
+  n(function () {
+    console.log('function_3')
+  }))
+export { o as fn1 }
+
+
+################################################################################
+rslib/fn2.js
+--------------------------------------------------------------------------------
+function n(n) {
+  let o = !1,
+    t
+  return () => (o || ((t = n()), (o = !0), (n = void 0)), t)
+}
+function o() {
+  console.log('function_2')
+}
+;(n(o),
+  n(function () {
+    console.log('function_3')
+  }))
+export { o as fn2 }
+
+
+################################################################################
+rslib/fn3.js
+--------------------------------------------------------------------------------
+function n(n) {
+  let o = !1,
+    t
+  return () => (o || ((t = n()), (o = !0), (n = void 0)), t)
+}
+function o() {
+  console.log('function_3')
+}
+;(n(function () {
+  console.log('function_2')
+}),
+  n(o))
+export { o as fn3 }
+
+
+################################################################################
+rslib/fn4.js
+--------------------------------------------------------------------------------
+function n(n) {
+  let o = !1,
+    c
+  return () => (o || ((c = n()), (o = !0), (n = void 0)), c)
+}
+function o() {
+  console.log('function_4')
+}
+;(n(function () {
+  console.log('function_2')
+}),
+  n(function () {
+    console.log('function_3')
+  }))
+export { o as fn4 }
+
+"
+`;

package/src/default-map.test.ts

@@ -2,7 +2,7 @@
 
 import { describe, it, expect } from 'vitest'
 
-import { DefaultMap } from './default-map'
+import { Counter, DefaultMap, DefaultWeakMap, WeakCounter } from './default-map'
 
 describe('DefaultMap', () => {
   it('creates default values for missing keys', () => {
@@ -184,3 +184,292 @@ describe('DefaultMap', () => {
     expect(map.get('group2').get('item1')).toBe(0)
   })
 })
+
+describe('DefaultWeakMap', () => {
+  it('creates default values for missing keys', () => {
+    const map = new DefaultWeakMap<object, number>(() => 0)
+    const key1 = {}
+    const key2 = {}
+
+    expect(map.get(key1)).toBe(0)
+    expect(map.get(key2)).toBe(0)
+  })
+
+  it('returns existing values for set keys', () => {
+    const map = new DefaultWeakMap<object, number>(() => 0)
+    const key = {}
+
+    map.set(key, 42)
+    expect(map.get(key)).toBe(42)
+  })
+
+  it('stores the default value when accessing missing key', () => {
+    const map = new DefaultWeakMap<object, number>(() => 5)
+    const key = {}
+
+    const value = map.get(key)
+    expect(value).toBe(5)
+    expect(map.has(key)).toBe(true)
+    expect(map.get(key)).toBe(5)
+  })
+
+  it('works with array factory', () => {
+    const map = new DefaultWeakMap<object, string[]>(() => [])
+    const key1 = {}
+    const key2 = {}
+
+    map.get(key1).push('item1')
+    map.get(key1).push('item2')
+    map.get(key2).push('item3')
+
+    expect(map.get(key1)).toEqual(['item1', 'item2'])
+    expect(map.get(key2)).toEqual(['item3'])
+  })
+
+  it('accepts initial entries', () => {
+    const key1 = {}
+    const key2 = {}
+    const key3 = {}
+    const initialEntries: [object, number][] = [
+      [key1, 1],
+      [key2, 2],
+      [key3, 3],
+    ]
+    const map = new DefaultWeakMap<object, number>(() => 0, initialEntries)
+
+    expect(map.get(key1)).toBe(1)
+    expect(map.get(key2)).toBe(2)
+    expect(map.get(key3)).toBe(3)
+
+    const key4 = {}
+    expect(map.get(key4)).toBe(0)
+  })
+
+  it('calls factory function only when key is missing', () => {
+    let callCount = 0
+    const map = new DefaultWeakMap<object, number>(() => {
+      callCount++
+      return 42
+    })
+    const existing = {}
+    const newKey = {}
+
+    map.set(existing, 100)
+
+    map.get(existing)
+    expect(callCount).toBe(0)
+
+    map.get(newKey)
+    expect(callCount).toBe(1)
+
+    map.get(newKey)
+    expect(callCount).toBe(1)
+  })
+
+  it('works with delete method', () => {
+    const map = new DefaultWeakMap<object, number>(() => 10)
+    const key = {}
+
+    map.get(key)
+    expect(map.has(key)).toBe(true)
+
+    map.delete(key)
+    expect(map.has(key)).toBe(false)
+
+    const value = map.get(key)
+    expect(value).toBe(10)
+    expect(map.has(key)).toBe(true)
+  })
+})
+
+describe('Counter', () => {
+  it('initializes counts to 0', () => {
+    const counter = new Counter<string>()
+
+    expect(counter.get('key1')).toBe(0)
+    expect(counter.get('key2')).toBe(0)
+  })
+
+  it('increments counts', () => {
+    const counter = new Counter<string>()
+
+    counter.increment('key1')
+    expect(counter.get('key1')).toBe(1)
+
+    counter.increment('key1')
+    expect(counter.get('key1')).toBe(2)
+
+    counter.increment('key2')
+    expect(counter.get('key2')).toBe(1)
+  })
+
+  it('increments by custom amounts', () => {
+    const counter = new Counter<string>()
+
+    counter.increment('key1', 5)
+    expect(counter.get('key1')).toBe(5)
+
+    counter.increment('key1', 3)
+    expect(counter.get('key1')).toBe(8)
+  })
+
+  it('decrements counts', () => {
+    const counter = new Counter<string>()
+
+    counter.set('key1', 10)
+    counter.decrement('key1')
+    expect(counter.get('key1')).toBe(9)
+
+    counter.decrement('key1')
+    expect(counter.get('key1')).toBe(8)
+  })
+
+  it('decrements by custom amounts', () => {
+    const counter = new Counter<string>()
+
+    counter.set('key1', 10)
+    counter.decrement('key1', 3)
+    expect(counter.get('key1')).toBe(7)
+
+    counter.decrement('key1', 2)
+    expect(counter.get('key1')).toBe(5)
+  })
+
+  it('allows negative counts', () => {
+    const counter = new Counter<string>()
+
+    counter.decrement('key1')
+    expect(counter.get('key1')).toBe(-1)
+
+    counter.decrement('key1', 5)
+    expect(counter.get('key1')).toBe(-6)
+  })
+
+  it('accepts initial entries', () => {
+    const initialEntries: [string, number][] = [
+      ['a', 5],
+      ['b', 10],
+      ['c', 15],
+    ]
+    const counter = new Counter<string>(initialEntries)
+
+    expect(counter.get('a')).toBe(5)
+    expect(counter.get('b')).toBe(10)
+    expect(counter.get('c')).toBe(15)
+    expect(counter.get('d')).toBe(0)
+  })
+
+  it('works with all Map methods', () => {
+    const counter = new Counter<string>()
+
+    counter.increment('key1')
+    counter.increment('key2', 2)
+
+    expect(counter.size).toBe(2)
+    expect(counter.has('key1')).toBe(true)
+    expect([...counter.keys()]).toEqual(['key1', 'key2'])
+    expect([...counter.values()]).toEqual([1, 2])
+  })
+})
+
+describe('WeakCounter', () => {
+  it('initializes counts to 0', () => {
+    const counter = new WeakCounter<object>()
+    const key1 = {}
+    const key2 = {}
+
+    expect(counter.get(key1)).toBe(0)
+    expect(counter.get(key2)).toBe(0)
+  })
+
+  it('increments counts', () => {
+    const counter = new WeakCounter<object>()
+    const key = {}
+
+    counter.increment(key)
+    expect(counter.get(key)).toBe(1)
+
+    counter.increment(key)
+    expect(counter.get(key)).toBe(2)
+  })
+
+  it('increments by custom amounts', () => {
+    const counter = new WeakCounter<object>()
+    const key = {}
+
+    counter.increment(key, 5)
+    expect(counter.get(key)).toBe(5)
+
+    counter.increment(key, 3)
+    expect(counter.get(key)).toBe(8)
+  })
+
+  it('decrements counts', () => {
+    const counter = new WeakCounter<object>()
+    const key = {}
+
+    counter.set(key, 10)
+    counter.decrement(key)
+    expect(counter.get(key)).toBe(9)
+
+    counter.decrement(key)
+    expect(counter.get(key)).toBe(8)
+  })
+
+  it('decrements by custom amounts', () => {
+    const counter = new WeakCounter<object>()
+    const key = {}
+
+    counter.set(key, 10)
+    counter.decrement(key, 3)
+    expect(counter.get(key)).toBe(7)
+
+    counter.decrement(key, 2)
+    expect(counter.get(key)).toBe(5)
+  })
+
+  it('allows negative counts', () => {
+    const counter = new WeakCounter<object>()
+    const key = {}
+
+    counter.decrement(key)
+    expect(counter.get(key)).toBe(-1)
+
+    counter.decrement(key, 5)
+    expect(counter.get(key)).toBe(-6)
+  })
+
+  it('accepts initial entries', () => {
+    const key1 = {}
+    const key2 = {}
+    const key3 = {}
+    const initialEntries: [object, number][] = [
+      [key1, 5],
+      [key2, 10],
+      [key3, 15],
+    ]
+    const counter = new WeakCounter<object>(initialEntries)
+
+    expect(counter.get(key1)).toBe(5)
+    expect(counter.get(key2)).toBe(10)
+    expect(counter.get(key3)).toBe(15)
+
+    const key4 = {}
+    expect(counter.get(key4)).toBe(0)
+  })
+
+  it('works with WeakMap methods', () => {
+    const counter = new WeakCounter<object>()
+    const key1 = {}
+    const key2 = {}
+
+    counter.increment(key1)
+    counter.increment(key2, 2)
+
+    expect(counter.has(key1)).toBe(true)
+    expect(counter.has(key2)).toBe(true)
+
+    counter.delete(key1)
+    expect(counter.has(key1)).toBe(false)
+  })
+})