igniteui-webcomponents 7.3.1 → 7.4.0

package/internals/utils/dom.d.ts

@@ -1,19 +1,14 @@
-/**
- * Returns whether an element has a Left-to-Right directionality.
- */
+/** Returns whether an element has a Left-to-Right directionality. */
 export declare function isLTR(element: HTMLElement): boolean;
 /**
  * Resolves a CSS length to pixels in the context of `element`.
  *
- * A registered custom property computes to an absolute length, which lets the
- * browser do the conversion for font, viewport and container relative units
- * instead of them being read as raw numbers. Percentages are not lengths -
- * resolve those against whatever basis applies to the property at hand.
- *
- * Returns 0 for percentages, for values that are not valid lengths, and where
- * the resolution is unavailable - during server-side rendering, or without
- * support for registered custom properties. Guessing from the raw token would
- * read `5rem` as 5 pixels, so callers get an obvious zero instead.
+ * @remarks
+ * Registration makes the property compute to an absolute length, so the
+ * browser converts font, viewport and container relative units. Returns 0
+ * for percentages, for invalid lengths, during SSR and in a browser without
+ * registered custom properties. Resolve percentages against the basis of
+ * the applicable property instead.
  *
  * @example
  * ```typescript
@@ -27,19 +22,21 @@ export type IterNodesOptions<T = Node> = {
     filter?: (node: T) => boolean;
 };
 /**
- * Iterates over the DOM subtree of `root` in document order, yielding the nodes
- * matching the passed {@link IterNodesOptions | options}.
+ * Iterates over the DOM subtree of `root` in document order, and yields the
+ * nodes that match the {@link IterNodesOptions | options}.
  *
  * @example
  * ```typescript
- * for (const button of iterNodes<HTMLButtonElement>(root, { show: 'SHOW_ELEMENT', filter: isButton })) { ... }
+ * for (const button of iterNodes<HTMLButtonElement>(root, {
+ *   show: 'SHOW_ELEMENT',
+ *   filter: isButton,
+ * })) { ... }
  * ```
  */
 export declare function iterNodes<T extends Node>(root: Node, options?: IterNodesOptions<T>): Generator<T>;
 /**
- * Iterates over `node` and its ancestors, crossing shadow DOM boundaries.
- *
- * Shadow roots are traversed through their host, so only elements are yielded.
+ * Iterates over `node` and its element ancestors, and crosses each shadow
+ * root through its host.
  *
  * @example
  * ```typescript
@@ -49,7 +46,7 @@ export declare function iterNodes<T extends Node>(root: Node, options?: IterNode
 export declare function iterAncestors(node?: Node | null): Generator<Element>;
 /** Returns the root node (document or shadow root) of the given element. */
 export declare function getRoot(element: Element, options?: GetRootNodeOptions): Document | ShadowRoot;
-/** Returns the element with the given id in the root node of `root`, if any. */
+/** Returns the element with the given id in the root node of `root`. */
 export declare function getElementByIdFromRoot(root: HTMLElement, id: string): HTMLElement | null;
 export declare function isElement(node: unknown): node is Element;
 export declare function isDocument(node: unknown): node is Document;
@@ -59,11 +56,12 @@ export declare function getCenterPoint(element: Element): {
     y: number;
 };
 /**
- * Maps a pointer's `clientX` coordinate to a fraction in the [0, 1] range of the
- * element's bounding box width, measured from the element's logical start edge -
- * the left edge when `ltr` is true, the right one otherwise.
+ * Maps the `clientX` coordinate of a pointer to a fraction of the element
+ * width, in the range 0 to 1.
  *
- * Returns 0 for an element without layout.
+ * @remarks
+ * Measured from the logical start edge: the left one when `ltr` is true, the
+ * right one otherwise. Returns 0 for an element that has no layout.
  *
  * @example
  * ```typescript
@@ -74,43 +72,57 @@ export declare function getCenterPoint(element: Element): {
  */
 export declare function pointToFraction(element: Element, clientX: number, ltr?: boolean): number;
 /**
- * Concatenates the text content of the given nodes into a single string,
- * trimmed and with consecutive whitespace collapsed.
- *
- * Useful for deriving an accessible label from projected content.
+ * Concatenates the text content of the given nodes, trimmed and with each
+ * run of whitespace collapsed into one space.
  */
 export declare function normalizedTextContent(nodes: Iterable<Node>): string;
-/** Returns whether the given client coordinates lie within the bounding box of the element. */
+/** Returns whether the given coordinates lie in the element bounding box. */
 export declare function isPointInsideElement(element: Element, x: number, y: number): boolean;
-/** Returns the scale factor of a given element based on its bounding client rect and offset dimensions. */
+/** Returns the scale factor of a given element. */
 export declare function getScaleFactor(element: HTMLElement): {
     x: number;
     y: number;
 };
-/** Rounds a CSS pixel value to the closest device-pixel boundary to avoid blurry rendering. */
+/**
+ * Rounds a CSS pixel value to the closest device-pixel boundary, to prevent
+ * blurry rendering.
+ */
 export declare function roundByDPR(value: number): number;
-/** Null-safe `Element.scrollIntoView` defaulting to the nearest block/inline position. */
+/**
+ * Calls `Element.scrollIntoView` on the element, by default to the nearest
+ * block and inline position. Does nothing for an empty element.
+ */
 export declare function scrollIntoView(element?: HTMLElement | null, config?: ScrollIntoViewOptions): void;
-/** Returns the default containing layer for floating elements such as drag and resize ghosts. */
+/** Returns the default containing layer for a floating element. */
 export declare function getDefaultLayer(): HTMLElement;
-/** Applies the given CSS declarations to the inline style of the element. */
+/**
+ * Applies the given CSS declarations to the inline style of the element.
+ *
+ * @remarks
+ * An unset declaration reads as an empty string, never `undefined`, so every
+ * given property overwrites the current one.
+ */
 export declare function setStyles(element: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;
 /** Returns whether the given input has at least one selected file. */
 export declare function hasFiles(input: {
     files: FileList | null;
 }): boolean;
 /**
- * Returns whether the given element is currently an open popover or not.
- * This is useful to determine if the popover is open without relying on the `open` property, which may not be in sync with the actual popover state if the opening/closing animations are still running.
- * Note: This function only works for elements that use the `:popover-open` pseudo-class to indicate
+ * Returns whether the given element is an open popover.
+ *
+ * @remarks
+ * Prefer this over the `open` property of a component, which disagrees with
+ * the popover state while an open or close animation runs. Reads
+ * `:popover-open`, so the element must use the popover API.
  */
 export declare function isPopoverOpen(element?: Element): boolean;
 /**
- * Returns whether the given element, or any of its ancestors across shadow DOM
- * boundaries, is positioned as `sticky`.
+ * Returns whether the element, or an ancestor across shadow DOM boundaries,
+ * has the `sticky` position.
  */
 export declare function hasStickyAncestor(element: Element): boolean;
 /**
- * Returns the nearest visible ancestor of a given node, traversing through shadow DOM boundaries if necessary. If no visible ancestor is found, returns null.
+ * Returns the nearest visible ancestor of the given node across shadow DOM
+ * boundaries, or `null`.
  */
 export declare function getVisibleAncestor(startNode: Node): HTMLElement | null;

package/internals/utils/dom.js

@@ -1,6 +1,5 @@
 import { isServer } from 'lit';
 import { asNumber, clamp, numberInRangeInclusive } from './math.js';
-import { merge } from './objects.js';
 import { isDefined } from './types.js';
 export function isLTR(element) {
     return element.matches(':dir(ltr)');
@@ -133,7 +132,7 @@ export function getDefaultLayer() {
     return document.body;
 }
 export function setStyles(element, styles) {
-    merge(element.style, styles);
+    Object.assign(element.style, styles);
 }
 export function hasFiles(input) {
     return input.files != null && input.files.length > 0;

package/internals/utils/dom.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../../src/internals/utils/dom.ts"],"names":[],"mappings":"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","sourcesContent":["import { isServer } from 'lit';\nimport { asNumber, clamp, numberInRangeInclusive } from './math.js';\nimport { merge } from './objects.js';\nimport { isDefined } from './types.js';\n\n/**\n * Returns whether an element has a Left-to-Right directionality.\n */\nexport function isLTR(element: HTMLElement) {\n  return element.matches(':dir(ltr)');\n}\n\nconst LENGTH_PROPERTY = '--igc-resolved-length';\n\nconst SUPPORTS_REGISTERED_PROPERTIES =\n  !isServer && typeof CSS !== 'undefined' && 'registerProperty' in CSS;\n\nlet lengthPropertyUsable: boolean | undefined;\n\nfunction canResolveLengths(): boolean {\n  if (lengthPropertyUsable === undefined) {\n    lengthPropertyUsable = SUPPORTS_REGISTERED_PROPERTIES;\n\n    if (lengthPropertyUsable) {\n      try {\n        CSS.registerProperty({\n          name: LENGTH_PROPERTY,\n          syntax: '<length>',\n          inherits: false,\n          initialValue: '0px',\n        });\n      } catch {\n        // The descriptor is a constant, so the only realistic rejection is a\n        // duplicate registration from another bundle instance - which leaves\n        // the property just as usable.\n      }\n    }\n  }\n\n  return lengthPropertyUsable;\n}\n\n/**\n * Resolves a CSS length to pixels in the context of `element`.\n *\n * A registered custom property computes to an absolute length, which lets the\n * browser do the conversion for font, viewport and container relative units\n * instead of them being read as raw numbers. Percentages are not lengths -\n * resolve those against whatever basis applies to the property at hand.\n *\n * Returns 0 for percentages, for values that are not valid lengths, and where\n * the resolution is unavailable - during server-side rendering, or without\n * support for registered custom properties. Guessing from the raw token would\n * read `5rem` as 5 pixels, so callers get an obvious zero instead.\n *\n * @example\n * ```typescript\n * resolveCssLength(element, '5rem'); // 80\n * resolveCssLength(element, '2em'); // 2 x the element font size\n * ```\n */\nexport function resolveCssLength(element: HTMLElement, value: string): number {\n  if (!canResolveLengths()) {\n    return 0;\n  }\n\n  const { style } = element;\n  const previous = style.getPropertyValue(LENGTH_PROPERTY);\n  const priority = style.getPropertyPriority(LENGTH_PROPERTY);\n\n  style.setProperty(LENGTH_PROPERTY, value);\n  const resolved = getComputedStyle(element).getPropertyValue(LENGTH_PROPERTY);\n\n  // Restore rather than remove - the caller may be using the property itself.\n  if (previous) {\n    style.setProperty(LENGTH_PROPERTY, previous, priority);\n  } else {\n    style.removeProperty(LENGTH_PROPERTY);\n  }\n\n  return asNumber(resolved);\n}\n\nexport type IterNodesOptions<T = Node> = {\n  show?: keyof typeof NodeFilter;\n  filter?: (node: T) => boolean;\n};\n\nfunction createNodeFilter<T extends Node>(predicate: (node: T) => boolean) {\n  return {\n    acceptNode: (node: T): number =>\n      predicate(node) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP,\n  };\n}\n\n/**\n * Iterates over the DOM subtree of `root` in document order, yielding the nodes\n * matching the passed {@link IterNodesOptions | options}.\n *\n * @example\n * ```typescript\n * for (const button of iterNodes<HTMLButtonElement>(root, { show: 'SHOW_ELEMENT', filter: isButton })) { ... }\n * ```\n */\nexport function* iterNodes<T extends Node>(\n  root: Node,\n  options?: IterNodesOptions<T>\n): Generator<T> {\n  if (!isDefined(globalThis.document)) {\n    return;\n  }\n\n  const whatToShow = options?.show\n    ? NodeFilter[options.show]\n    : NodeFilter.SHOW_ALL;\n\n  const nodeFilter = options?.filter\n    ? createNodeFilter(options.filter)\n    : undefined;\n\n  const treeWalker = document.createTreeWalker(root, whatToShow, nodeFilter);\n\n  while (treeWalker.nextNode()) {\n    yield treeWalker.currentNode as T;\n  }\n}\n\n/**\n * Iterates over `node` and its ancestors, crossing shadow DOM boundaries.\n *\n * Shadow roots are traversed through their host, so only elements are yielded.\n *\n * @example\n * ```typescript\n * for (const ancestor of iterAncestors(element)) { ... }\n * ```\n */\nexport function* iterAncestors(node?: Node | null): Generator<Element> {\n  let current: Node | null | undefined = node;\n\n  while (current) {\n    if (isElement(current)) {\n      yield current;\n    }\n\n    current = current instanceof ShadowRoot ? current.host : current.parentNode;\n  }\n}\n\n/** Returns the root node (document or shadow root) of the given element. */\nexport function getRoot(\n  element: Element,\n  options?: GetRootNodeOptions\n): Document | ShadowRoot {\n  return element.getRootNode(options) as Document | ShadowRoot;\n}\n\n/** Returns the element with the given id in the root node of `root`, if any. */\nexport function getElementByIdFromRoot(root: HTMLElement, id: string) {\n  return getRoot(root).getElementById(id);\n}\n\nexport function isElement(node: unknown): node is Element {\n  return node instanceof Node && node.nodeType === Node.ELEMENT_NODE;\n}\n\nexport function isDocument(node: unknown): node is Document {\n  return node instanceof Node && node.nodeType === Node.DOCUMENT_NODE;\n}\n\n/** Returns the center x/y coordinate of a given element. */\nexport function getCenterPoint(element: Element): { x: number; y: number } {\n  const { left, top, width, height } = element.getBoundingClientRect();\n\n  return {\n    x: left + width * 0.5,\n    y: top + height * 0.5,\n  };\n}\n\n/**\n * Maps a pointer's `clientX` coordinate to a fraction in the [0, 1] range of the\n * element's bounding box width, measured from the element's logical start edge -\n * the left edge when `ltr` is true, the right one otherwise.\n *\n * Returns 0 for an element without layout.\n *\n * @example\n * ```typescript\n * // Pointer 30px into a 120px wide element\n * pointToFraction(element, event.clientX); // 0.25\n * pointToFraction(element, event.clientX, false); // 0.75\n * ```\n */\nexport function pointToFraction(\n  element: Element,\n  clientX: number,\n  ltr = true\n): number {\n  const { left, right, width } = element.getBoundingClientRect();\n\n  if (width === 0) {\n    return 0;\n  }\n\n  return clamp((ltr ? clientX - left : right - clientX) / width, 0, 1);\n}\n\n/**\n * Concatenates the text content of the given nodes into a single string,\n * trimmed and with consecutive whitespace collapsed.\n *\n * Useful for deriving an accessible label from projected content.\n */\nexport function normalizedTextContent(nodes: Iterable<Node>): string {\n  let text = '';\n\n  for (const node of nodes) {\n    text += node.textContent ?? '';\n  }\n\n  return text.trim().replace(/\\s+/gu, ' ');\n}\n\n/** Returns whether the given client coordinates lie within the bounding box of the element. */\nexport function isPointInsideElement(\n  element: Element,\n  x: number,\n  y: number\n): boolean {\n  const { left, right, top, bottom } = element.getBoundingClientRect();\n  return (\n    numberInRangeInclusive(x, left, right) &&\n    numberInRangeInclusive(y, top, bottom)\n  );\n}\n\n/** Returns the scale factor of a given element based on its bounding client rect and offset dimensions. */\nexport function getScaleFactor(element: HTMLElement): { x: number; y: number } {\n  const { offsetWidth, offsetHeight } = element;\n  const { width, height } = element.getBoundingClientRect();\n  return { x: offsetWidth / width || 1, y: offsetHeight / height || 1 };\n}\n\n/** Rounds a CSS pixel value to the closest device-pixel boundary to avoid blurry rendering. */\nexport function roundByDPR(value: number): number {\n  const dpr = globalThis.devicePixelRatio || 1;\n  return Math.round(value * dpr) / dpr;\n}\n\n/** Null-safe `Element.scrollIntoView` defaulting to the nearest block/inline position. */\nexport function scrollIntoView(\n  element?: HTMLElement | null,\n  config?: ScrollIntoViewOptions\n): void {\n  if (!element) {\n    return;\n  }\n\n  element.scrollIntoView(\n    Object.assign(\n      {\n        behavior: 'auto',\n        block: 'nearest',\n        inline: 'nearest',\n      },\n      config\n    )\n  );\n}\n\n/** Returns the default containing layer for floating elements such as drag and resize ghosts. */\nexport function getDefaultLayer(): HTMLElement {\n  return document.body;\n}\n\n/** Applies the given CSS declarations to the inline style of the element. */\nexport function setStyles(\n  element: HTMLElement,\n  styles: Partial<CSSStyleDeclaration>\n): void {\n  merge(element.style, styles);\n}\n\n/** Returns whether the given input has at least one selected file. */\nexport function hasFiles(input: { files: FileList | null }): boolean {\n  return input.files != null && input.files.length > 0;\n}\n\n/**\n * Returns whether the given element is currently an open popover or not.\n * This is useful to determine if the popover is open without relying on the `open` property, which may not be in sync with the actual popover state if the opening/closing animations are still running.\n * Note: This function only works for elements that use the `:popover-open` pseudo-class to indicate\n */\nexport function isPopoverOpen(element?: Element): boolean {\n  return element?.matches(':popover-open') ?? false;\n}\n\n/**\n * Returns whether the given element, or any of its ancestors across shadow DOM\n * boundaries, is positioned as `sticky`.\n */\nexport function hasStickyAncestor(element: Element): boolean {\n  for (const ancestor of iterAncestors(element)) {\n    if (getComputedStyle(ancestor).position === 'sticky') {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Returns the nearest visible ancestor of a given node, traversing through shadow DOM boundaries if necessary. If no visible ancestor is found, returns null.\n */\nexport function getVisibleAncestor(startNode: Node): HTMLElement | null {\n  for (const ancestor of iterAncestors(startNode.parentNode)) {\n    if (ancestor instanceof HTMLElement && ancestor.checkVisibility()) {\n      return ancestor;\n    }\n  }\n\n  return null;\n}\n"]}
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../../src/internals/utils/dom.ts"],"names":[],"mappings":"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","sourcesContent":["import { isServer } from 'lit';\nimport { asNumber, clamp, numberInRangeInclusive } from './math.js';\nimport { isDefined } from './types.js';\n\n/** Returns whether an element has a Left-to-Right directionality. */\nexport function isLTR(element: HTMLElement) {\n  return element.matches(':dir(ltr)');\n}\n\nconst LENGTH_PROPERTY = '--igc-resolved-length';\n\nconst SUPPORTS_REGISTERED_PROPERTIES =\n  !isServer && typeof CSS !== 'undefined' && 'registerProperty' in CSS;\n\nlet lengthPropertyUsable: boolean | undefined;\n\nfunction canResolveLengths(): boolean {\n  if (lengthPropertyUsable === undefined) {\n    lengthPropertyUsable = SUPPORTS_REGISTERED_PROPERTIES;\n\n    if (lengthPropertyUsable) {\n      try {\n        CSS.registerProperty({\n          name: LENGTH_PROPERTY,\n          syntax: '<length>',\n          inherits: false,\n          initialValue: '0px',\n        });\n      } catch {\n        // The descriptor is constant, so a rejection means another bundle\n        // instance already registered it. The property stays usable.\n      }\n    }\n  }\n\n  return lengthPropertyUsable;\n}\n\n/**\n * Resolves a CSS length to pixels in the context of `element`.\n *\n * @remarks\n * Registration makes the property compute to an absolute length, so the\n * browser converts font, viewport and container relative units. Returns 0\n * for percentages, for invalid lengths, during SSR and in a browser without\n * registered custom properties. Resolve percentages against the basis of\n * the applicable property instead.\n *\n * @example\n * ```typescript\n * resolveCssLength(element, '5rem'); // 80\n * resolveCssLength(element, '2em'); // 2 x the element font size\n * ```\n */\nexport function resolveCssLength(element: HTMLElement, value: string): number {\n  if (!canResolveLengths()) {\n    return 0;\n  }\n\n  const { style } = element;\n  const previous = style.getPropertyValue(LENGTH_PROPERTY);\n  const priority = style.getPropertyPriority(LENGTH_PROPERTY);\n\n  style.setProperty(LENGTH_PROPERTY, value);\n  const resolved = getComputedStyle(element).getPropertyValue(LENGTH_PROPERTY);\n\n  // Restore rather than remove: the caller may use the property itself.\n  if (previous) {\n    style.setProperty(LENGTH_PROPERTY, previous, priority);\n  } else {\n    style.removeProperty(LENGTH_PROPERTY);\n  }\n\n  return asNumber(resolved);\n}\n\nexport type IterNodesOptions<T = Node> = {\n  show?: keyof typeof NodeFilter;\n  filter?: (node: T) => boolean;\n};\n\nfunction createNodeFilter<T extends Node>(predicate: (node: T) => boolean) {\n  return {\n    acceptNode: (node: T): number =>\n      predicate(node) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP,\n  };\n}\n\n/**\n * Iterates over the DOM subtree of `root` in document order, and yields the\n * nodes that match the {@link IterNodesOptions | options}.\n *\n * @example\n * ```typescript\n * for (const button of iterNodes<HTMLButtonElement>(root, {\n *   show: 'SHOW_ELEMENT',\n *   filter: isButton,\n * })) { ... }\n * ```\n */\nexport function* iterNodes<T extends Node>(\n  root: Node,\n  options?: IterNodesOptions<T>\n): Generator<T> {\n  if (!isDefined(globalThis.document)) {\n    return;\n  }\n\n  const whatToShow = options?.show\n    ? NodeFilter[options.show]\n    : NodeFilter.SHOW_ALL;\n\n  const nodeFilter = options?.filter\n    ? createNodeFilter(options.filter)\n    : undefined;\n\n  const treeWalker = document.createTreeWalker(root, whatToShow, nodeFilter);\n\n  while (treeWalker.nextNode()) {\n    yield treeWalker.currentNode as T;\n  }\n}\n\n/**\n * Iterates over `node` and its element ancestors, and crosses each shadow\n * root through its host.\n *\n * @example\n * ```typescript\n * for (const ancestor of iterAncestors(element)) { ... }\n * ```\n */\nexport function* iterAncestors(node?: Node | null): Generator<Element> {\n  let current: Node | null | undefined = node;\n\n  while (current) {\n    if (isElement(current)) {\n      yield current;\n    }\n\n    current = current instanceof ShadowRoot ? current.host : current.parentNode;\n  }\n}\n\n/** Returns the root node (document or shadow root) of the given element. */\nexport function getRoot(\n  element: Element,\n  options?: GetRootNodeOptions\n): Document | ShadowRoot {\n  return element.getRootNode(options) as Document | ShadowRoot;\n}\n\n/** Returns the element with the given id in the root node of `root`. */\nexport function getElementByIdFromRoot(root: HTMLElement, id: string) {\n  return getRoot(root).getElementById(id);\n}\n\nexport function isElement(node: unknown): node is Element {\n  return node instanceof Node && node.nodeType === Node.ELEMENT_NODE;\n}\n\nexport function isDocument(node: unknown): node is Document {\n  return node instanceof Node && node.nodeType === Node.DOCUMENT_NODE;\n}\n\n/** Returns the center x/y coordinate of a given element. */\nexport function getCenterPoint(element: Element): { x: number; y: number } {\n  const { left, top, width, height } = element.getBoundingClientRect();\n\n  return {\n    x: left + width * 0.5,\n    y: top + height * 0.5,\n  };\n}\n\n/**\n * Maps the `clientX` coordinate of a pointer to a fraction of the element\n * width, in the range 0 to 1.\n *\n * @remarks\n * Measured from the logical start edge: the left one when `ltr` is true, the\n * right one otherwise. Returns 0 for an element that has no layout.\n *\n * @example\n * ```typescript\n * // Pointer 30px into a 120px wide element\n * pointToFraction(element, event.clientX); // 0.25\n * pointToFraction(element, event.clientX, false); // 0.75\n * ```\n */\nexport function pointToFraction(\n  element: Element,\n  clientX: number,\n  ltr = true\n): number {\n  const { left, right, width } = element.getBoundingClientRect();\n\n  if (width === 0) {\n    return 0;\n  }\n\n  return clamp((ltr ? clientX - left : right - clientX) / width, 0, 1);\n}\n\n/**\n * Concatenates the text content of the given nodes, trimmed and with each\n * run of whitespace collapsed into one space.\n */\nexport function normalizedTextContent(nodes: Iterable<Node>): string {\n  let text = '';\n\n  for (const node of nodes) {\n    text += node.textContent ?? '';\n  }\n\n  return text.trim().replace(/\\s+/gu, ' ');\n}\n\n/** Returns whether the given coordinates lie in the element bounding box. */\nexport function isPointInsideElement(\n  element: Element,\n  x: number,\n  y: number\n): boolean {\n  const { left, right, top, bottom } = element.getBoundingClientRect();\n  return (\n    numberInRangeInclusive(x, left, right) &&\n    numberInRangeInclusive(y, top, bottom)\n  );\n}\n\n/** Returns the scale factor of a given element. */\nexport function getScaleFactor(element: HTMLElement): { x: number; y: number } {\n  const { offsetWidth, offsetHeight } = element;\n  const { width, height } = element.getBoundingClientRect();\n  return { x: offsetWidth / width || 1, y: offsetHeight / height || 1 };\n}\n\n/**\n * Rounds a CSS pixel value to the closest device-pixel boundary, to prevent\n * blurry rendering.\n */\nexport function roundByDPR(value: number): number {\n  const dpr = globalThis.devicePixelRatio || 1;\n  return Math.round(value * dpr) / dpr;\n}\n\n/**\n * Calls `Element.scrollIntoView` on the element, by default to the nearest\n * block and inline position. Does nothing for an empty element.\n */\nexport function scrollIntoView(\n  element?: HTMLElement | null,\n  config?: ScrollIntoViewOptions\n): void {\n  if (!element) {\n    return;\n  }\n\n  element.scrollIntoView(\n    Object.assign(\n      {\n        behavior: 'auto',\n        block: 'nearest',\n        inline: 'nearest',\n      },\n      config\n    )\n  );\n}\n\n/** Returns the default containing layer for a floating element. */\nexport function getDefaultLayer(): HTMLElement {\n  return document.body;\n}\n\n/**\n * Applies the given CSS declarations to the inline style of the element.\n *\n * @remarks\n * An unset declaration reads as an empty string, never `undefined`, so every\n * given property overwrites the current one.\n */\nexport function setStyles(\n  element: HTMLElement,\n  styles: Partial<CSSStyleDeclaration>\n): void {\n  Object.assign(element.style, styles);\n}\n\n/** Returns whether the given input has at least one selected file. */\nexport function hasFiles(input: { files: FileList | null }): boolean {\n  return input.files != null && input.files.length > 0;\n}\n\n/**\n * Returns whether the given element is an open popover.\n *\n * @remarks\n * Prefer this over the `open` property of a component, which disagrees with\n * the popover state while an open or close animation runs. Reads\n * `:popover-open`, so the element must use the popover API.\n */\nexport function isPopoverOpen(element?: Element): boolean {\n  return element?.matches(':popover-open') ?? false;\n}\n\n/**\n * Returns whether the element, or an ancestor across shadow DOM boundaries,\n * has the `sticky` position.\n */\nexport function hasStickyAncestor(element: Element): boolean {\n  for (const ancestor of iterAncestors(element)) {\n    if (getComputedStyle(ancestor).position === 'sticky') {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Returns the nearest visible ancestor of the given node across shadow DOM\n * boundaries, or `null`.\n */\nexport function getVisibleAncestor(startNode: Node): HTMLElement | null {\n  for (const ancestor of iterAncestors(startNode.parentNode)) {\n    if (ancestor instanceof HTMLElement && ancestor.checkVisibility()) {\n      return ancestor;\n    }\n  }\n\n  return null;\n}\n"]}

package/internals/utils/events.d.ts

@@ -1,9 +1,11 @@
 /**
- * Finds the first element in the event's composed path that matches the provided predicate, which can be either a string selector or a function.
+ * Finds the first element in the composed path of the event that matches the
+ * predicate.
  *
- * @param predicate - A string representing a CSS selector or a function that takes an Element and returns a boolean indicating a match.
- * @param event - The event whose composed path will be searched for the matching element.
- * @returns The first Element that matches the predicate, or undefined if no match is found.
+ * @param predicate - A CSS selector, or a function that returns whether an
+ * element matches.
+ * @param event - The event that holds the composed path.
+ * @returns The first element that matches, or `undefined`.
  *
  * @example
  * ```typescript
@@ -12,32 +14,43 @@
  * ```
  * ```typescript
  * // Using a predicate function
- * const customElement = getElementFromPath((el) => el.tagName === 'MY-ELEMENT', event);
+ * const customElement = getElementFromPath(
+ *   (el) => el.tagName === 'MY-ELEMENT',
+ *   event
+ * );
  * ```
  */
 export declare function getElementFromPath<K extends keyof HTMLElementTagNameMap>(predicate: K, event: Event): HTMLElementTagNameMap[K] | undefined;
 export declare function getElementFromPath<T extends Element>(predicate: string | ((element: Element) => boolean), event: Event): T | undefined;
-/** Reusable event listener that just stops the propagation of the event. */
+/** Reusable event listener that stops the propagation of the event. */
 export declare function stopPropagation(event: Event): void;
-/** Reusable event listener that just prevents the default action of the event. */
+/** Reusable event listener that prevents the default action of the event. */
 export declare function preventDefault(event: Event): void;
 /**
- * Returns whether focus has moved outside of the given host element for
- * a `focusout`/`blur` event, that is the element gaining focus is not
- * a descendant of the host.
+ * Returns whether the focus moved out of the given host element, for use
+ * with a `focusout` or `blur` event.
  */
 export declare function focusLeftHost(host: Element, event: FocusEvent): boolean;
 /**
- * Adds an event listener that holds only a weak reference to the passed
- * `listener`, thus not preventing it from being garbage collected.
+ * Adds an event listener that holds only a weak reference to `listener`, so
+ * the garbage collector can collect it.
  */
 export declare function addWeakEventListener(element: Element, event: string, listener: EventListenerOrEventListenerObject, options?: AddEventListenerOptions | boolean): void;
 type EventTypeOf<T extends keyof HTMLElementEventMap | keyof WindowEventMap> = (HTMLElementEventMap & WindowEventMap)[T];
 /**
- * Safely adds an event listener to an HTMLElement, automatically handling
- * server-side rendering environments by doing nothing if `isServer` is true.
- * This function also correctly binds the `handler`'s `this` context to the `target` element
- * and ensures proper event type inference.
+ * Adds the `listener` to the `target` if `active` is true. Removes it if
+ * `active` is false.
+ *
+ * The caller must pass a stable listener reference. `addEventListener` and
+ * `removeEventListener` are then idempotent, and the caller needs no state.
+ */
+export declare function toggleEventListener<E extends keyof HTMLElementEventMap | keyof WindowEventMap>(target: EventTarget, active: boolean, event: E, listener: EventListenerOrEventListenerObject, options?: AddEventListenerOptions): void;
+/**
+ * Adds an event listener to an element, and does nothing during server-side
+ * rendering.
+ *
+ * @remarks
+ * The `this` context of `handler` is the target element.
  */
 export declare function addSafeEventListener<E extends keyof HTMLElementEventMap | keyof WindowEventMap>(target: HTMLElement, eventName: E, handler: (event: EventTypeOf<E>) => unknown, options?: boolean | AddEventListenerOptions): void;
 export {};

package/internals/utils/events.js

@@ -5,7 +5,10 @@ export function getElementFromPath(predicate, event) {
     const func = isString(predicate)
         ? (e) => e.matches(predicate)
         : (e) => predicate(e);
-    return Iterator.from(event.composedPath()).find((item) => isElement(item) && func(item));
+    const match = event
+        .composedPath()
+        .find((item) => isElement(item) && func(item));
+    return match;
 }
 export function stopPropagation(event) {
     event.stopPropagation();
@@ -30,6 +33,11 @@ export function addWeakEventListener(element, event, listener, options) {
     };
     element.addEventListener(event, wrapped, options);
 }
+export function toggleEventListener(target, active, event, listener, options) {
+    active
+        ? target.addEventListener(event, listener, options)
+        : target.removeEventListener(event, listener, options);
+}
 export function addSafeEventListener(target, eventName, handler, options) {
     if (isServer) {
         return;

package/internals/utils/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/internals/utils/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA2B7D,MAAM,UAAU,kBAAkB,CAChC,SAAmD,EACnD,KAAY;IAEZ,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC;QAC9B,CAAC,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QACtC,CAAC,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAEjC,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAC7C,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CACjB,CAAC;AAC3B,CAAC;AAGD,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,KAAK,CAAC,eAAe,EAAE,CAAC;AAC1B,CAAC;AAGD,MAAM,UAAU,cAAc,CAAC,KAAY;IACzC,KAAK,CAAC,cAAc,EAAE,CAAC;AACzB,CAAC;AAOD,MAAM,UAAU,aAAa,CAAC,IAAa,EAAE,KAAiB;IAC5D,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAA4B,CAAC,CAAC;AAC5D,CAAC;AAMD,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,KAAa,EACb,QAA4C,EAC5C,OAA2C;IAE3C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,CAAC,GAAU,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAEhC,IAAI,CAAC,OAAO,EAAE,CAAC;YAEb,OAAO,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QAED,OAAO,qBAAqB,CAAC,OAAO,CAAC;YACnC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC;YAC1B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAWD,MAAM,UAAU,oBAAoB,CAGlC,MAAmB,EACnB,SAAY,EACZ,OAA2C,EAC3C,OAA2C;IAE3C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,KAAY,EAAE,EAAE,CACpC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAuB,CAAC,CAAC;IAEhD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC","sourcesContent":["import { isServer } from 'lit';\nimport { isElement } from './dom.js';\nimport { isEventListenerObject, isString } from './types.js';\n\n/**\n * Finds the first element in the event's composed path that matches the provided predicate, which can be either a string selector or a function.\n *\n * @param predicate - A string representing a CSS selector or a function that takes an Element and returns a boolean indicating a match.\n * @param event - The event whose composed path will be searched for the matching element.\n * @returns The first Element that matches the predicate, or undefined if no match is found.\n *\n * @example\n * ```typescript\n * // Using a string selector\n * const button = getElementFromPath('button', event);\n * ```\n * ```typescript\n * // Using a predicate function\n * const customElement = getElementFromPath((el) => el.tagName === 'MY-ELEMENT', event);\n * ```\n */\nexport function getElementFromPath<K extends keyof HTMLElementTagNameMap>(\n  predicate: K,\n  event: Event\n): HTMLElementTagNameMap[K] | undefined;\nexport function getElementFromPath<T extends Element>(\n  predicate: string | ((element: Element) => boolean),\n  event: Event\n): T | undefined;\nexport function getElementFromPath(\n  predicate: string | ((element: Element) => boolean),\n  event: Event\n) {\n  const func = isString(predicate)\n    ? (e: Element) => e.matches(predicate)\n    : (e: Element) => predicate(e);\n\n  return Iterator.from(event.composedPath()).find(\n    (item) => isElement(item) && func(item)\n  ) as Element | undefined;\n}\n\n/** Reusable event listener that just stops the propagation of the event. */\nexport function stopPropagation(event: Event): void {\n  event.stopPropagation();\n}\n\n/** Reusable event listener that just prevents the default action of the event. */\nexport function preventDefault(event: Event): void {\n  event.preventDefault();\n}\n\n/**\n * Returns whether focus has moved outside of the given host element for\n * a `focusout`/`blur` event, that is the element gaining focus is not\n * a descendant of the host.\n */\nexport function focusLeftHost(host: Element, event: FocusEvent): boolean {\n  return !host.contains(event.relatedTarget as Node | null);\n}\n\n/**\n * Adds an event listener that holds only a weak reference to the passed\n * `listener`, thus not preventing it from being garbage collected.\n */\nexport function addWeakEventListener(\n  element: Element,\n  event: string,\n  listener: EventListenerOrEventListenerObject,\n  options?: AddEventListenerOptions | boolean\n): void {\n  const weakRef = new WeakRef(listener);\n  const wrapped = (evt: Event) => {\n    const handler = weakRef.deref();\n\n    if (!handler) {\n      // The listener has been garbage collected - detach the wrapper as well\n      element.removeEventListener(event, wrapped, options);\n      return;\n    }\n\n    return isEventListenerObject(handler)\n      ? handler.handleEvent(evt)\n      : handler(evt);\n  };\n\n  element.addEventListener(event, wrapped, options);\n}\n\ntype EventTypeOf<T extends keyof HTMLElementEventMap | keyof WindowEventMap> =\n  (HTMLElementEventMap & WindowEventMap)[T];\n\n/**\n * Safely adds an event listener to an HTMLElement, automatically handling\n * server-side rendering environments by doing nothing if `isServer` is true.\n * This function also correctly binds the `handler`'s `this` context to the `target` element\n * and ensures proper event type inference.\n */\nexport function addSafeEventListener<\n  E extends keyof HTMLElementEventMap | keyof WindowEventMap,\n>(\n  target: HTMLElement,\n  eventName: E,\n  handler: (event: EventTypeOf<E>) => unknown,\n  options?: boolean | AddEventListenerOptions\n): void {\n  if (isServer) {\n    return;\n  }\n\n  const boundHandler = (event: Event) =>\n    handler.call(target, event as EventTypeOf<E>);\n\n  target.addEventListener(eventName, boundHandler, options);\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/internals/utils/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAgC7D,MAAM,UAAU,kBAAkB,CAChC,SAAmD,EACnD,KAAY;IAEZ,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC;QAC9B,CAAC,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QACtC,CAAC,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAEjC,MAAM,KAAK,GAAG,KAAK;SAChB,YAAY,EAAE;SACd,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEjD,OAAO,KAA4B,CAAC;AACtC,CAAC;AAGD,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,KAAK,CAAC,eAAe,EAAE,CAAC;AAC1B,CAAC;AAGD,MAAM,UAAU,cAAc,CAAC,KAAY;IACzC,KAAK,CAAC,cAAc,EAAE,CAAC;AACzB,CAAC;AAMD,MAAM,UAAU,aAAa,CAAC,IAAa,EAAE,KAAiB;IAC5D,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAA4B,CAAC,CAAC;AAC5D,CAAC;AAMD,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,KAAa,EACb,QAA4C,EAC5C,OAA2C;IAE3C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,CAAC,GAAU,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAEhC,IAAI,CAAC,OAAO,EAAE,CAAC;YAEb,OAAO,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QAED,OAAO,qBAAqB,CAAC,OAAO,CAAC;YACnC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC;YAC1B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAYD,MAAM,UAAU,mBAAmB,CAGjC,MAAmB,EACnB,MAAe,EACf,KAAQ,EACR,QAA4C,EAC5C,OAAiC;IAEjC,MAAM;QACJ,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC;QACnD,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AASD,MAAM,UAAU,oBAAoB,CAGlC,MAAmB,EACnB,SAAY,EACZ,OAA2C,EAC3C,OAA2C;IAE3C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,KAAY,EAAE,EAAE,CACpC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAuB,CAAC,CAAC;IAEhD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC","sourcesContent":["import { isServer } from 'lit';\nimport { isElement } from './dom.js';\nimport { isEventListenerObject, isString } from './types.js';\n\n/**\n * Finds the first element in the composed path of the event that matches the\n * predicate.\n *\n * @param predicate - A CSS selector, or a function that returns whether an\n * element matches.\n * @param event - The event that holds the composed path.\n * @returns The first element that matches, or `undefined`.\n *\n * @example\n * ```typescript\n * // Using a string selector\n * const button = getElementFromPath('button', event);\n * ```\n * ```typescript\n * // Using a predicate function\n * const customElement = getElementFromPath(\n *   (el) => el.tagName === 'MY-ELEMENT',\n *   event\n * );\n * ```\n */\nexport function getElementFromPath<K extends keyof HTMLElementTagNameMap>(\n  predicate: K,\n  event: Event\n): HTMLElementTagNameMap[K] | undefined;\nexport function getElementFromPath<T extends Element>(\n  predicate: string | ((element: Element) => boolean),\n  event: Event\n): T | undefined;\nexport function getElementFromPath(\n  predicate: string | ((element: Element) => boolean),\n  event: Event\n) {\n  const func = isString(predicate)\n    ? (e: Element) => e.matches(predicate)\n    : (e: Element) => predicate(e);\n\n  const match = event\n    .composedPath()\n    .find((item) => isElement(item) && func(item));\n\n  return match as Element | undefined;\n}\n\n/** Reusable event listener that stops the propagation of the event. */\nexport function stopPropagation(event: Event): void {\n  event.stopPropagation();\n}\n\n/** Reusable event listener that prevents the default action of the event. */\nexport function preventDefault(event: Event): void {\n  event.preventDefault();\n}\n\n/**\n * Returns whether the focus moved out of the given host element, for use\n * with a `focusout` or `blur` event.\n */\nexport function focusLeftHost(host: Element, event: FocusEvent): boolean {\n  return !host.contains(event.relatedTarget as Node | null);\n}\n\n/**\n * Adds an event listener that holds only a weak reference to `listener`, so\n * the garbage collector can collect it.\n */\nexport function addWeakEventListener(\n  element: Element,\n  event: string,\n  listener: EventListenerOrEventListenerObject,\n  options?: AddEventListenerOptions | boolean\n): void {\n  const weakRef = new WeakRef(listener);\n  const wrapped = (evt: Event) => {\n    const handler = weakRef.deref();\n\n    if (!handler) {\n      // The listener was collected, so drop the wrapper too.\n      element.removeEventListener(event, wrapped, options);\n      return;\n    }\n\n    return isEventListenerObject(handler)\n      ? handler.handleEvent(evt)\n      : handler(evt);\n  };\n\n  element.addEventListener(event, wrapped, options);\n}\n\ntype EventTypeOf<T extends keyof HTMLElementEventMap | keyof WindowEventMap> =\n  (HTMLElementEventMap & WindowEventMap)[T];\n\n/**\n * Adds the `listener` to the `target` if `active` is true. Removes it if\n * `active` is false.\n *\n * The caller must pass a stable listener reference. `addEventListener` and\n * `removeEventListener` are then idempotent, and the caller needs no state.\n */\nexport function toggleEventListener<\n  E extends keyof HTMLElementEventMap | keyof WindowEventMap,\n>(\n  target: EventTarget,\n  active: boolean,\n  event: E,\n  listener: EventListenerOrEventListenerObject,\n  options?: AddEventListenerOptions\n): void {\n  active\n    ? target.addEventListener(event, listener, options)\n    : target.removeEventListener(event, listener, options);\n}\n\n/**\n * Adds an event listener to an element, and does nothing during server-side\n * rendering.\n *\n * @remarks\n * The `this` context of `handler` is the target element.\n */\nexport function addSafeEventListener<\n  E extends keyof HTMLElementEventMap | keyof WindowEventMap,\n>(\n  target: HTMLElement,\n  eventName: E,\n  handler: (event: EventTypeOf<E>) => unknown,\n  options?: boolean | AddEventListenerOptions\n): void {\n  if (isServer) {\n    return;\n  }\n\n  const boundHandler = (event: Event) =>\n    handler.call(target, event as EventTypeOf<E>);\n\n  target.addEventListener(eventName, boundHandler, options);\n}\n"]}

package/internals/utils/lit.d.ts

@@ -1,7 +1,10 @@
 import { type TemplateResult } from 'lit';
 /**
- * Similar to Lit's `ifDefined` directive except one can check `assertion`
- * and bind a different `value` through this wrapper.
+ * Returns `value` when `assertion` is truthy, and `nothing` otherwise.
+ *
+ * @remarks
+ * Like the `ifDefined` directive of Lit, but the condition and the bound
+ * value are separate.
  */
 export declare function bindIf<T>(assertion: unknown, value: T): NonNullable<T>;
 /** @internal */

package/internals/utils/lit.js.map

@@ -1 +1 @@
-{"version":3,"file":"lit.js","sourceRoot":"","sources":["../../../src/internals/utils/lit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAuB,MAAM,KAAK,CAAC;AAMzD,MAAM,UAAU,MAAM,CAAI,SAAkB,EAAE,KAAQ;IACpD,OAAO,SAAS;QACd,CAAC,CAAC,CAAC,KAAK,IAAK,OAA0B,CAAC;QACxC,CAAC,CAAE,OAA0B,CAAC;AAClC,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,OAAO,EAA8C,CAAC;AAG/E,MAAM,UAAU,WAAW,CACzB,OAA6B,EAC7B,GAAG,MAAiB;IAEpB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACzE,YAAY,CAAC,GAAG,CACd,OAAO,EACP,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,cAAc,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAC9D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAE,EAAE,GAAG,MAAM,CAAC,CAAC;AACrD,CAAC","sourcesContent":["import { html, nothing, type TemplateResult } from 'lit';\n\n/**\n * Similar to Lit's `ifDefined` directive except one can check `assertion`\n * and bind a different `value` through this wrapper.\n */\nexport function bindIf<T>(assertion: unknown, value: T): NonNullable<T> {\n  return assertion\n    ? (value ?? (nothing as NonNullable<T>))\n    : (nothing as NonNullable<T>);\n}\n\nconst trimmedCache = new WeakMap<TemplateStringsArray, TemplateStringsArray>();\n\n/** @internal */\nexport function trimmedHtml(\n  strings: TemplateStringsArray,\n  ...values: unknown[]\n): TemplateResult {\n  if (!trimmedCache.has(strings)) {\n    const trimmedStrings = strings.map((s) => s.trim().replaceAll('\\n', ''));\n    trimmedCache.set(\n      strings,\n      Object.assign([...trimmedStrings], { raw: [...strings.raw] })\n    );\n  }\n\n  return html(trimmedCache.get(strings)!, ...values);\n}\n"]}
+{"version":3,"file":"lit.js","sourceRoot":"","sources":["../../../src/internals/utils/lit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAuB,MAAM,KAAK,CAAC;AASzD,MAAM,UAAU,MAAM,CAAI,SAAkB,EAAE,KAAQ;IACpD,OAAO,SAAS;QACd,CAAC,CAAC,CAAC,KAAK,IAAK,OAA0B,CAAC;QACxC,CAAC,CAAE,OAA0B,CAAC;AAClC,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,OAAO,EAA8C,CAAC;AAG/E,MAAM,UAAU,WAAW,CACzB,OAA6B,EAC7B,GAAG,MAAiB;IAEpB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACzE,YAAY,CAAC,GAAG,CACd,OAAO,EACP,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,cAAc,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAC9D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAE,EAAE,GAAG,MAAM,CAAC,CAAC;AACrD,CAAC","sourcesContent":["import { html, nothing, type TemplateResult } from 'lit';\n\n/**\n * Returns `value` when `assertion` is truthy, and `nothing` otherwise.\n *\n * @remarks\n * Like the `ifDefined` directive of Lit, but the condition and the bound\n * value are separate.\n */\nexport function bindIf<T>(assertion: unknown, value: T): NonNullable<T> {\n  return assertion\n    ? (value ?? (nothing as NonNullable<T>))\n    : (nothing as NonNullable<T>);\n}\n\nconst trimmedCache = new WeakMap<TemplateStringsArray, TemplateStringsArray>();\n\n/** @internal */\nexport function trimmedHtml(\n  strings: TemplateStringsArray,\n  ...values: unknown[]\n): TemplateResult {\n  if (!trimmedCache.has(strings)) {\n    const trimmedStrings = strings.map((s) => s.trim().replaceAll('\\n', ''));\n    trimmedCache.set(\n      strings,\n      Object.assign([...trimmedStrings], { raw: [...strings.raw] })\n    );\n  }\n\n  return html(trimmedCache.get(strings)!, ...values);\n}\n"]}

package/internals/utils/math.d.ts

@@ -13,10 +13,10 @@ export declare function numberOfDecimals(number: number): number;
  * ```
  */
 export declare function roundPrecise(number: number, magnitude?: number): number;
-/** Returns whether the given value lies between the min and max bounds (inclusive). */
+/** Returns whether the value lies between the min and max bounds. */
 export declare function numberInRangeInclusive(value: number, min: number, max: number): boolean;
 /**
- * Parse the passed `value` as a number or return the `fallback` if it can't be done.
+ * Returns `value` as a number, or the `fallback` when the parse fails.
  *
  * @example
  * ```typescript
@@ -35,9 +35,6 @@ export declare function asNumber(value: unknown, fallback?: number): number;
 /**
  * Returns the value wrapped between the min and max bounds.
  *
- * If the value is greater than max, returns the min and vice-versa.
- * If the value is between the bounds, it is returned unchanged.
- *
  * @example
  * ```typescript
  * wrap(1, 4, 2); // 2
@@ -46,5 +43,10 @@ export declare function asNumber(value: unknown, fallback?: number): number;
  * ```
  */
 export declare function wrap(min: number, max: number, value: number): number;
-/** Euclidean modulo - like `%` but the result always has the sign of the divisor. */
+/**
+ * Returns the Euclidean modulo of `n` and `d`.
+ *
+ * @remarks
+ * Unlike `%`, the result always has the sign of the divisor.
+ */
 export declare function modulo(n: number, d: number): number;

package/internals/utils/math.js.map

@@ -1 +1 @@
-{"version":3,"file":"math.js","sourceRoot":"","sources":["../../../src/internals/utils/math.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;AAC9B,CAAC;AAGD,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,GAAW,EAAE,GAAW;IAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAC9C,CAAC;AAGD,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;IAGD,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAErD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3D,CAAC;AAUD,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,SAAS,GAAG,CAAC;IACxD,MAAM,MAAM,GAAG,EAAE,IAAI,SAAS,CAAC;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAC9C,CAAC;AAGD,MAAM,UAAU,sBAAsB,CACpC,KAAa,EACb,GAAW,EACX,GAAW;IAEX,OAAO,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;AACtC,CAAC;AAkBD,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,QAAQ,GAAG,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAe,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC;AAeD,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,GAAW,EAAE,KAAa;IAC1D,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAGD,MAAM,UAAU,MAAM,CAAC,CAAS,EAAE,CAAS;IACzC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["/** Returns `part` as a percentage of `whole`. */\nexport function asPercent(part: number, whole: number): number {\n  return (part / whole) * 100;\n}\n\n/** Clamps the given number between the min and max bounds (inclusive). */\nexport function clamp(number: number, min: number, max: number): number {\n  return Math.max(min, Math.min(number, max));\n}\n\n/** Returns the number of decimal places of the given number. */\nexport function numberOfDecimals(number: number): number {\n  if (!Number.isFinite(number) || Number.isInteger(number)) {\n    return 0;\n  }\n\n  // Exponential notation, e.g. `1.5e-7` -> 1 mantissa decimal + 7 exponent places\n  const [mantissa, exponent] = number.toString().split('e-');\n  const decimals = mantissa.split('.')[1]?.length ?? 0;\n\n  return exponent ? decimals + Number(exponent) : decimals;\n}\n\n/**\n * Rounds a number to the given order of magnitude (number of decimal places).\n *\n * @example\n * ```typescript\n * roundPrecise(3.14159, 2); // 3.14\n * ```\n */\nexport function roundPrecise(number: number, magnitude = 1): number {\n  const factor = 10 ** magnitude;\n  return Math.round(number * factor) / factor;\n}\n\n/** Returns whether the given value lies between the min and max bounds (inclusive). */\nexport function numberInRangeInclusive(\n  value: number,\n  min: number,\n  max: number\n) {\n  return value >= min && value <= max;\n}\n\n/**\n * Parse the passed `value` as a number or return the `fallback` if it can't be done.\n *\n * @example\n * ```typescript\n * asNumber('5'); // 5\n * asNumber('3.14'); // 3.14\n * asNumber('five'); // 0\n * asNumber('five', 5); // 5\n * asNumber(undefined, 10); // 10\n * asNumber(null, 10); // 10\n * asNumber(NaN, 10); // 10\n * asNumber(Infinity, 10); // 10\n * asNumber(-Infinity, 10); // 10\n * ```\n */\nexport function asNumber(value: unknown, fallback = 0): number {\n  const parsed = Number.parseFloat(value as string);\n  return Number.isFinite(parsed) ? parsed : fallback;\n}\n\n/**\n * Returns the value wrapped between the min and max bounds.\n *\n * If the value is greater than max, returns the min and vice-versa.\n * If the value is between the bounds, it is returned unchanged.\n *\n * @example\n * ```typescript\n * wrap(1, 4, 2); // 2\n * wrap(1, 4, 5); // 1\n * wrap(1, 4, -1); // 4\n * ```\n */\nexport function wrap(min: number, max: number, value: number) {\n  if (value < min) {\n    return max;\n  }\n  if (value > max) {\n    return min;\n  }\n\n  return value;\n}\n\n/** Euclidean modulo - like `%` but the result always has the sign of the divisor. */\nexport function modulo(n: number, d: number) {\n  return ((n % d) + d) % d;\n}\n"]}
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../../src/internals/utils/math.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;AAC9B,CAAC;AAGD,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,GAAW,EAAE,GAAW;IAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAC9C,CAAC;AAGD,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;IAID,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAErD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3D,CAAC;AAUD,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,SAAS,GAAG,CAAC;IACxD,MAAM,MAAM,GAAG,EAAE,IAAI,SAAS,CAAC;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAC9C,CAAC;AAGD,MAAM,UAAU,sBAAsB,CACpC,KAAa,EACb,GAAW,EACX,GAAW;IAEX,OAAO,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;AACtC,CAAC;AAkBD,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,QAAQ,GAAG,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAe,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC;AAYD,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,GAAW,EAAE,KAAa;IAC1D,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAQD,MAAM,UAAU,MAAM,CAAC,CAAS,EAAE,CAAS;IACzC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["/** Returns `part` as a percentage of `whole`. */\nexport function asPercent(part: number, whole: number): number {\n  return (part / whole) * 100;\n}\n\n/** Clamps the given number between the min and max bounds (inclusive). */\nexport function clamp(number: number, min: number, max: number): number {\n  return Math.max(min, Math.min(number, max));\n}\n\n/** Returns the number of decimal places of the given number. */\nexport function numberOfDecimals(number: number): number {\n  if (!Number.isFinite(number) || Number.isInteger(number)) {\n    return 0;\n  }\n\n  // Exponential notation, for example `1.5e-7`: 1 mantissa decimal plus 7\n  // exponent places.\n  const [mantissa, exponent] = number.toString().split('e-');\n  const decimals = mantissa.split('.')[1]?.length ?? 0;\n\n  return exponent ? decimals + Number(exponent) : decimals;\n}\n\n/**\n * Rounds a number to the given order of magnitude (number of decimal places).\n *\n * @example\n * ```typescript\n * roundPrecise(3.14159, 2); // 3.14\n * ```\n */\nexport function roundPrecise(number: number, magnitude = 1): number {\n  const factor = 10 ** magnitude;\n  return Math.round(number * factor) / factor;\n}\n\n/** Returns whether the value lies between the min and max bounds. */\nexport function numberInRangeInclusive(\n  value: number,\n  min: number,\n  max: number\n) {\n  return value >= min && value <= max;\n}\n\n/**\n * Returns `value` as a number, or the `fallback` when the parse fails.\n *\n * @example\n * ```typescript\n * asNumber('5'); // 5\n * asNumber('3.14'); // 3.14\n * asNumber('five'); // 0\n * asNumber('five', 5); // 5\n * asNumber(undefined, 10); // 10\n * asNumber(null, 10); // 10\n * asNumber(NaN, 10); // 10\n * asNumber(Infinity, 10); // 10\n * asNumber(-Infinity, 10); // 10\n * ```\n */\nexport function asNumber(value: unknown, fallback = 0): number {\n  const parsed = Number.parseFloat(value as string);\n  return Number.isFinite(parsed) ? parsed : fallback;\n}\n\n/**\n * Returns the value wrapped between the min and max bounds.\n *\n * @example\n * ```typescript\n * wrap(1, 4, 2); // 2\n * wrap(1, 4, 5); // 1\n * wrap(1, 4, -1); // 4\n * ```\n */\nexport function wrap(min: number, max: number, value: number) {\n  if (value < min) {\n    return max;\n  }\n  if (value > max) {\n    return min;\n  }\n\n  return value;\n}\n\n/**\n * Returns the Euclidean modulo of `n` and `d`.\n *\n * @remarks\n * Unlike `%`, the result always has the sign of the divisor.\n */\nexport function modulo(n: number, d: number) {\n  return ((n % d) + d) % d;\n}\n"]}

package/internals/utils/objects.d.ts

@@ -1,25 +1,8 @@
-/** Pairs currently being compared, so a cycle terminates without swallowing real differences. */
+/** The object pairs the comparison visits at this moment, to stop cycles. */
 type Visited = WeakMap<object, WeakSet<object>>;
 /**
- * Performs a deep structural equality check between two values, handling
- * arrays, Maps, Sets, RegExps, POJOs and circular references.
+ * Returns whether two values are deeply equal. Handles arrays, Maps, Sets,
+ * RegExps, plain objects and circular references.
  */
 export declare function equal<T>(a: unknown, b: T, visited?: Visited): boolean;
-/**
- * Merges the properties of `source` into `target` performing a recursive deep merge over POJOs and arrays.
- *
- * @remarks
- * This function mutates the `target` object.
- * If that is not the desired outcome, see {@link toMerged} for another approach.
- */
-export declare function merge<T extends Record<PropertyKey, any>, S extends Record<PropertyKey, any>>(target: T, source: S): T & S;
-/**
- * Just like {@link merge} but it does not mutate the `target` object instead
- * mutating a structured clone of it.
- *
- * @remarks
- * Since it relies on `structuredClone`, the `target` must not contain
- * non-cloneable values such as functions, DOM nodes or class instances.
- */
-export declare function toMerged<T extends Record<PropertyKey, any>, S extends Record<PropertyKey, any>>(target: T, source: S): T & S;
 export {};

package/internals/utils/objects.js

@@ -1,7 +1,4 @@
-import { isObject, isPlainObject, isRegExp } from './types.js';
-function isUnsafeProperty(key) {
-    return key === '__proto__' || key === 'constructor' || key === 'prototype';
-}
+import { isObject, isRegExp } from './types.js';
 export function equal(a, b, visited = new WeakMap()) {
     if (Object.is(a, b))
         return true;
@@ -87,39 +84,4 @@ function compare(a, b, visited) {
     }
     return true;
 }
-export function merge(target, source) {
-    const sourceKeys = Object.keys(source);
-    const length = sourceKeys.length;
-    for (let i = 0; i < length; i++) {
-        const key = sourceKeys[i];
-        if (isUnsafeProperty(key)) {
-            continue;
-        }
-        const sourceValue = source[key];
-        const targetValue = target[key];
-        if (Array.isArray(sourceValue)) {
-            if (Array.isArray(targetValue)) {
-                target[key] = merge(targetValue, sourceValue);
-            }
-            else {
-                target[key] = merge([], sourceValue);
-            }
-        }
-        else if (isPlainObject(sourceValue)) {
-            if (isPlainObject(targetValue)) {
-                target[key] = merge(targetValue, sourceValue);
-            }
-            else {
-                target[key] = merge({}, sourceValue);
-            }
-        }
-        else if (targetValue === undefined || sourceValue !== undefined) {
-            target[key] = sourceValue;
-        }
-    }
-    return target;
-}
-export function toMerged(target, source) {
-    return merge(structuredClone(target), source);
-}
 //# sourceMappingURL=objects.js.map

package/internals/utils/objects.js.map

@@ -1 +1 @@
-{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../../src/internals/utils/objects.ts"],"names":[],"mappings":"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","sourcesContent":["import { isObject, isPlainObject, isRegExp } from './types.js';\n\nfunction isUnsafeProperty(key: PropertyKey) {\n  return key === '__proto__' || key === 'constructor' || key === 'prototype';\n}\n\n/** Pairs currently being compared, so a cycle terminates without swallowing real differences. */\ntype Visited = WeakMap<object, WeakSet<object>>;\n\n/**\n * Performs a deep structural equality check between two values, handling\n * arrays, Maps, Sets, RegExps, POJOs and circular references.\n */\nexport function equal<T>(\n  a: unknown,\n  b: T,\n  visited: Visited = new WeakMap()\n): boolean {\n  // Early return\n  if (Object.is(a, b)) return true;\n\n  if (!isObject(a) || !isObject(b)) return false;\n  if (a.constructor !== b.constructor) return false;\n\n  // Circular references. This tracks the *pair*, not the two objects separately: the Map and Set\n  // comparisons below probe candidates they expect to fail, and marking those objects on their own\n  // would make a later comparison of the same pair short circuit to `true`.\n  let pending = visited.get(a);\n  if (pending?.has(b)) return true;\n\n  if (!pending) {\n    pending = new WeakSet();\n    visited.set(a, pending);\n  }\n  pending.add(b);\n\n  try {\n    return compare(a, b, visited);\n  } finally {\n    // Always release the pair, including on the early returns in `compare`.\n    pending.delete(b);\n  }\n}\n\nfunction compare(a: object, b: object, visited: Visited): boolean {\n  // RegExp\n  if (isRegExp(a) && isRegExp(b))\n    return a.source === b.source && a.flags === b.flags;\n\n  // Maps\n  if (a instanceof Map && b instanceof Map) {\n    if (a.size !== b.size) return false;\n    for (const [keyA, valueA] of a.entries()) {\n      let found = false;\n      for (const [keyB, valueB] of b.entries()) {\n        if (equal(keyA, keyB, visited) && equal(valueA, valueB, visited)) {\n          found = true;\n          break;\n        }\n      }\n      if (!found) return false;\n    }\n    return true;\n  }\n\n  // Sets\n  if (a instanceof Set && b instanceof Set) {\n    if (a.size !== b.size) return false;\n    for (const valueA of a) {\n      let found = false;\n      for (const valueB of b) {\n        if (equal(valueA, valueB, visited)) {\n          found = true;\n          break;\n        }\n      }\n      if (!found) return false;\n    }\n    return true;\n  }\n\n  // Arrays\n  if (Array.isArray(a) && Array.isArray(b)) {\n    const length = a.length;\n    if (length !== b.length) return false;\n    for (let i = 0; i < length; i++) {\n      if (!equal(a[i], b[i], visited)) return false;\n    }\n    return true;\n  }\n\n  // toPrimitive\n  if (a.valueOf !== Object.prototype.valueOf)\n    return a.valueOf() === b.valueOf();\n  // Strings based\n  if (a.toString !== Object.prototype.toString)\n    return a.toString() === b.toString();\n\n  const aKeys = Object.keys(a);\n  const bKeys = Object.keys(b);\n  if (aKeys.length !== bKeys.length) return false;\n\n  for (const key of aKeys) {\n    if (!Object.hasOwn(b, key)) return false;\n  }\n\n  for (const key of aKeys) {\n    if (!equal(a[key as keyof typeof a], b[key as keyof typeof b], visited))\n      return false;\n  }\n\n  return true;\n}\n\n/**\n * Merges the properties of `source` into `target` performing a recursive deep merge over POJOs and arrays.\n *\n * @remarks\n * This function mutates the `target` object.\n * If that is not the desired outcome, see {@link toMerged} for another approach.\n */\nexport function merge<\n  T extends Record<PropertyKey, any>,\n  S extends Record<PropertyKey, any>,\n>(target: T, source: S): T & S {\n  const sourceKeys = Object.keys(source) as Array<keyof S>;\n  const length = sourceKeys.length;\n\n  for (let i = 0; i < length; i++) {\n    const key = sourceKeys[i];\n\n    if (isUnsafeProperty(key)) {\n      continue;\n    }\n\n    const sourceValue = source[key];\n    const targetValue = target[key];\n\n    if (Array.isArray(sourceValue)) {\n      if (Array.isArray(targetValue)) {\n        target[key] = merge(targetValue, sourceValue);\n      } else {\n        target[key] = merge([], sourceValue);\n      }\n    } else if (isPlainObject(sourceValue)) {\n      if (isPlainObject(targetValue)) {\n        target[key] = merge(targetValue, sourceValue);\n      } else {\n        target[key] = merge({}, sourceValue);\n      }\n    } else if (targetValue === undefined || sourceValue !== undefined) {\n      target[key] = sourceValue;\n    }\n  }\n\n  return target;\n}\n\n/**\n * Just like {@link merge} but it does not mutate the `target` object instead\n * mutating a structured clone of it.\n *\n * @remarks\n * Since it relies on `structuredClone`, the `target` must not contain\n * non-cloneable values such as functions, DOM nodes or class instances.\n */\nexport function toMerged<\n  T extends Record<PropertyKey, any>,\n  S extends Record<PropertyKey, any>,\n>(target: T, source: S): T & S {\n  return merge(structuredClone(target), source);\n}\n"]}
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../../src/internals/utils/objects.ts"],"names":[],"mappings":"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","sourcesContent":["import { isObject, isRegExp } from './types.js';\n\n/** The object pairs the comparison visits at this moment, to stop cycles. */\ntype Visited = WeakMap<object, WeakSet<object>>;\n\n/**\n * Returns whether two values are deeply equal. Handles arrays, Maps, Sets,\n * RegExps, plain objects and circular references.\n */\nexport function equal<T>(\n  a: unknown,\n  b: T,\n  visited: Visited = new WeakMap()\n): boolean {\n  if (Object.is(a, b)) return true;\n\n  if (!isObject(a) || !isObject(b)) return false;\n  if (a.constructor !== b.constructor) return false;\n\n  // Record the pair, not each object on its own: the Map and Set branches\n  // below test candidates they expect to fail, and single-object records\n  // would make a later comparison of the same pair return `true`.\n  let pending = visited.get(a);\n  if (pending?.has(b)) return true;\n\n  if (!pending) {\n    pending = new WeakSet();\n    visited.set(a, pending);\n  }\n  pending.add(b);\n\n  try {\n    return compare(a, b, visited);\n  } finally {\n    // Release the pair, including on an early return in `compare`.\n    pending.delete(b);\n  }\n}\n\nfunction compare(a: object, b: object, visited: Visited): boolean {\n  if (isRegExp(a) && isRegExp(b))\n    return a.source === b.source && a.flags === b.flags;\n\n  if (a instanceof Map && b instanceof Map) {\n    if (a.size !== b.size) return false;\n    for (const [keyA, valueA] of a.entries()) {\n      let found = false;\n      for (const [keyB, valueB] of b.entries()) {\n        if (equal(keyA, keyB, visited) && equal(valueA, valueB, visited)) {\n          found = true;\n          break;\n        }\n      }\n      if (!found) return false;\n    }\n    return true;\n  }\n\n  if (a instanceof Set && b instanceof Set) {\n    if (a.size !== b.size) return false;\n    for (const valueA of a) {\n      let found = false;\n      for (const valueB of b) {\n        if (equal(valueA, valueB, visited)) {\n          found = true;\n          break;\n        }\n      }\n      if (!found) return false;\n    }\n    return true;\n  }\n\n  if (Array.isArray(a) && Array.isArray(b)) {\n    const length = a.length;\n    if (length !== b.length) return false;\n    for (let i = 0; i < length; i++) {\n      if (!equal(a[i], b[i], visited)) return false;\n    }\n    return true;\n  }\n\n  if (a.valueOf !== Object.prototype.valueOf)\n    return a.valueOf() === b.valueOf();\n  if (a.toString !== Object.prototype.toString)\n    return a.toString() === b.toString();\n\n  const aKeys = Object.keys(a);\n  const bKeys = Object.keys(b);\n  if (aKeys.length !== bKeys.length) return false;\n\n  for (const key of aKeys) {\n    if (!Object.hasOwn(b, key)) return false;\n  }\n\n  for (const key of aKeys) {\n    if (!equal(a[key as keyof typeof a], b[key as keyof typeof b], visited))\n      return false;\n  }\n\n  return true;\n}\n"]}