igniteui-webcomponents 7.2.4 → 7.3.0-beta.0

package/internals/utils/events.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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.
+ *
+ * @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.
+ *
+ * @example
+ * ```typescript
+ * // Using a string selector
+ * const button = getElementFromPath('button', event);
+ * ```
+ * ```typescript
+ * // Using a predicate function
+ * 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. */
+export declare function stopPropagation(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.
+ */
+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.
+ */
+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.
+ */
+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

@@ -0,0 +1,37 @@
+import { isServer } from 'lit';
+import { isElement } from './dom.js';
+import { isEventListenerObject, isString } from './types.js';
+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));
+}
+export function stopPropagation(event) {
+    event.stopPropagation();
+}
+export function focusLeftHost(host, event) {
+    return !host.contains(event.relatedTarget);
+}
+export function addWeakEventListener(element, event, listener, options) {
+    const weakRef = new WeakRef(listener);
+    const wrapped = (evt) => {
+        const handler = weakRef.deref();
+        if (!handler) {
+            element.removeEventListener(event, wrapped, options);
+            return;
+        }
+        return isEventListenerObject(handler)
+            ? handler.handleEvent(evt)
+            : handler(evt);
+    };
+    element.addEventListener(event, wrapped, options);
+}
+export function addSafeEventListener(target, eventName, handler, options) {
+    if (isServer) {
+        return;
+    }
+    const boundHandler = (event) => handler.call(target, event);
+    target.addEventListener(eventName, boundHandler, options);
+}
+//# sourceMappingURL=events.js.map

package/internals/utils/events.js.map

@@ -0,0 +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;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/**\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"]}

package/internals/utils/lit.d.ts

@@ -0,0 +1,8 @@
+import { type TemplateResult } from 'lit';
+/**
+ * Similar to Lit's `ifDefined` directive except one can check `assertion`
+ * and bind a different `value` through this wrapper.
+ */
+export declare function bindIf<T>(assertion: unknown, value: T): NonNullable<T>;
+/** @internal */
+export declare function trimmedHtml(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult;

package/internals/utils/lit.js

@@ -0,0 +1,15 @@
+import { html, nothing } from 'lit';
+export function bindIf(assertion, value) {
+    return assertion
+        ? (value ?? nothing)
+        : nothing;
+}
+const trimmedCache = new WeakMap();
+export function trimmedHtml(strings, ...values) {
+    if (!trimmedCache.has(strings)) {
+        const trimmedStrings = strings.map((s) => s.trim().replaceAll('\n', ''));
+        trimmedCache.set(strings, Object.assign([...trimmedStrings], { raw: [...strings.raw] }));
+    }
+    return html(trimmedCache.get(strings), ...values);
+}
+//# sourceMappingURL=lit.js.map

package/internals/utils/lit.js.map

@@ -0,0 +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"]}

package/internals/utils/math.d.ts

@@ -0,0 +1,50 @@
+/** Returns `part` as a percentage of `whole`. */
+export declare function asPercent(part: number, whole: number): number;
+/** Clamps the given number between the min and max bounds (inclusive). */
+export declare function clamp(number: number, min: number, max: number): number;
+/** Returns the number of decimal places of the given number. */
+export declare function numberOfDecimals(number: number): number;
+/**
+ * Rounds a number to the given order of magnitude (number of decimal places).
+ *
+ * @example
+ * ```typescript
+ * roundPrecise(3.14159, 2); // 3.14
+ * ```
+ */
+export declare function roundPrecise(number: number, magnitude?: number): number;
+/** Returns whether the given value lies between the min and max bounds (inclusive). */
+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.
+ *
+ * @example
+ * ```typescript
+ * asNumber('5'); // 5
+ * asNumber('3.14'); // 3.14
+ * asNumber('five'); // 0
+ * asNumber('five', 5); // 5
+ * asNumber(undefined, 10); // 10
+ * asNumber(null, 10); // 10
+ * asNumber(NaN, 10); // 10
+ * asNumber(Infinity, 10); // 10
+ * asNumber(-Infinity, 10); // 10
+ * ```
+ */
+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
+ * wrap(1, 4, 5); // 1
+ * wrap(1, 4, -1); // 4
+ * ```
+ */
+export declare function wrap(min: number, max: number, value: number): number;
+/** Euclidean modulo — like `%` but the result always has the sign of the divisor. */
+export declare function modulo(n: number, d: number): number;

package/internals/utils/math.js

@@ -0,0 +1,38 @@
+export function asPercent(part, whole) {
+    return (part / whole) * 100;
+}
+export function clamp(number, min, max) {
+    return Math.max(min, Math.min(number, max));
+}
+export function numberOfDecimals(number) {
+    if (!Number.isFinite(number) || Number.isInteger(number)) {
+        return 0;
+    }
+    const [mantissa, exponent] = number.toString().split('e-');
+    const decimals = mantissa.split('.')[1]?.length ?? 0;
+    return exponent ? decimals + Number(exponent) : decimals;
+}
+export function roundPrecise(number, magnitude = 1) {
+    const factor = 10 ** magnitude;
+    return Math.round(number * factor) / factor;
+}
+export function numberInRangeInclusive(value, min, max) {
+    return value >= min && value <= max;
+}
+export function asNumber(value, fallback = 0) {
+    const parsed = Number.parseFloat(value);
+    return Number.isFinite(parsed) ? parsed : fallback;
+}
+export function wrap(min, max, value) {
+    if (value < min) {
+        return max;
+    }
+    if (value > max) {
+        return min;
+    }
+    return value;
+}
+export function modulo(n, d) {
+    return ((n % d) + d) % d;
+}
+//# sourceMappingURL=math.js.map

package/internals/utils/math.js.map

@@ -0,0 +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"]}

package/internals/utils/objects.d.ts

@@ -0,0 +1,25 @@
+/** Pairs currently being compared, so a cycle terminates without swallowing real differences. */
+type Visited = WeakMap<object, WeakSet<object>>;
+/**
+ * Performs a deep structural equality check between two values, handling
+ * arrays, Maps, Sets, RegExps, POJOs 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

@@ -0,0 +1,125 @@
+import { isObject, isPlainObject, isRegExp } from './types.js';
+function isUnsafeProperty(key) {
+    return key === '__proto__' || key === 'constructor' || key === 'prototype';
+}
+export function equal(a, b, visited = new WeakMap()) {
+    if (Object.is(a, b))
+        return true;
+    if (!isObject(a) || !isObject(b))
+        return false;
+    if (a.constructor !== b.constructor)
+        return false;
+    let pending = visited.get(a);
+    if (pending?.has(b))
+        return true;
+    if (!pending) {
+        pending = new WeakSet();
+        visited.set(a, pending);
+    }
+    pending.add(b);
+    try {
+        return compare(a, b, visited);
+    }
+    finally {
+        pending.delete(b);
+    }
+}
+function compare(a, b, visited) {
+    if (isRegExp(a) && isRegExp(b))
+        return a.source === b.source && a.flags === b.flags;
+    if (a instanceof Map && b instanceof Map) {
+        if (a.size !== b.size)
+            return false;
+        for (const [keyA, valueA] of a.entries()) {
+            let found = false;
+            for (const [keyB, valueB] of b.entries()) {
+                if (equal(keyA, keyB, visited) && equal(valueA, valueB, visited)) {
+                    found = true;
+                    break;
+                }
+            }
+            if (!found)
+                return false;
+        }
+        return true;
+    }
+    if (a instanceof Set && b instanceof Set) {
+        if (a.size !== b.size)
+            return false;
+        for (const valueA of a) {
+            let found = false;
+            for (const valueB of b) {
+                if (equal(valueA, valueB, visited)) {
+                    found = true;
+                    break;
+                }
+            }
+            if (!found)
+                return false;
+        }
+        return true;
+    }
+    if (Array.isArray(a) && Array.isArray(b)) {
+        const length = a.length;
+        if (length !== b.length)
+            return false;
+        for (let i = 0; i < length; i++) {
+            if (!equal(a[i], b[i], visited))
+                return false;
+        }
+        return true;
+    }
+    if (a.valueOf !== Object.prototype.valueOf)
+        return a.valueOf() === b.valueOf();
+    if (a.toString !== Object.prototype.toString)
+        return a.toString() === b.toString();
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    for (const key of aKeys) {
+        if (!Object.hasOwn(b, key))
+            return false;
+    }
+    for (const key of aKeys) {
+        if (!equal(a[key], b[key], visited))
+            return false;
+    }
+    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

@@ -0,0 +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"]}

package/internals/utils/strings.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Builds a string from format specifiers and replacement parameters.
+ * Will coerce non-string parameters to their string representations.
+ *
+ * @example
+ * ```typescript
+ * formatString('{0} says "{1}".', 'John', 'Hello'); // 'John says "Hello".'
+ * formatString('{1} is greater than {0}', 0, 1); // '1 is greater than 0'
+ * ```
+ */
+export declare function formatString(template: string, ...params: unknown[]): string;
+/**
+ * Splits a string into its words, treating whitespace, `-`, `_` and
+ * camelCase boundaries as separators.
+ */
+export declare function splitToWords(text: string): string[];
+/** Converts a string to kebab-case. */
+export declare function toKebabCase(text: string): string;
+/**
+ *  Escapes any potential regex syntax characters in a string, and returns a new string
+ *  that can be safely used as a literal pattern for the `RegExp()` constructor.
+ *
+ *  @remarks
+ *  Substitute with `RegExp.escape` once it has enough support:
+ *
+ * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/escape#browser_compatibility
+ */
+export declare function escapeRegex(value: string): string;
+/**
+ * Creates a generator of monotonically increasing DOM ids based on the given prefix.
+ *
+ * @example
+ * ```typescript
+ * const nextId = createIdGenerator('radio');
+ * nextId(); // 'radio-1'
+ * nextId(); // 'radio-2'
+ * ```
+ */
+export declare function createIdGenerator(prefix: string): () => string;
+/**
+ * Generates a unique string ID of the specified size using a URL-friendly alphabet.
+ * The default size is 21 characters, which provides a very low probability of collisions.
+ */
+export declare function nanoid(size?: number): string;

package/internals/utils/strings.js

@@ -0,0 +1,46 @@
+export function formatString(template, ...params) {
+    const length = params.length;
+    return template.replace(/{(\d+)}/g, (match, index) => index >= length ? match : `${params[index]}`);
+}
+export function splitToWords(text) {
+    const input = text.replaceAll(/[^a-zA-Z0-9\s-_]/g, '');
+    if (/[\s-_]+/.test(input))
+        return input.split(/[\s-_]+/);
+    return input.split(/(?=[A-Z])+/);
+}
+export function toKebabCase(text) {
+    const input = text.trim();
+    return splitToWords(input).join('-').toLowerCase();
+}
+export function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export function createIdGenerator(prefix) {
+    let id = 0;
+    return () => `${prefix}-${++id}`;
+}
+let pool;
+let poolOffset;
+const urlAlphabet = 'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict';
+function fillPool(bytes) {
+    if (!pool || pool.length < bytes) {
+        pool = new Uint8Array(new ArrayBuffer(bytes * 128));
+        crypto.getRandomValues(pool);
+        poolOffset = 0;
+    }
+    else if (poolOffset + bytes > pool.length) {
+        crypto.getRandomValues(pool);
+        poolOffset = 0;
+    }
+    poolOffset += bytes;
+}
+export function nanoid(size = 21) {
+    const bytes = size | 0;
+    fillPool(bytes);
+    let id = '';
+    for (let i = poolOffset - bytes; i < poolOffset; i++) {
+        id += urlAlphabet[pool[i] & 63];
+    }
+    return id;
+}
+//# sourceMappingURL=strings.js.map

package/internals/utils/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../../src/internals/utils/strings.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,GAAG,MAAiB;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAE7B,OAAO,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CACnE,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7C,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACvD,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AACnC,CAAC;AAGD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AACrD,CAAC;AAWD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAYD,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,IAAI,IAA6B,CAAC;AAClC,IAAI,UAAkB,CAAC;AACvB,MAAM,WAAW,GACf,kEAAkE,CAAC;AAErE,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACjC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,WAAW,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7B,UAAU,GAAG,CAAC,CAAC;IACjB,CAAC;SAAM,IAAI,UAAU,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7B,UAAU,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,UAAU,IAAI,KAAK,CAAC;AACtB,CAAC;AAMD,MAAM,UAAU,MAAM,CAAC,IAAI,GAAG,EAAE;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,UAAU,GAAG,KAAK,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACrD,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["/**\n * Builds a string from format specifiers and replacement parameters.\n * Will coerce non-string parameters to their string representations.\n *\n * @example\n * ```typescript\n * formatString('{0} says \"{1}\".', 'John', 'Hello'); // 'John says \"Hello\".'\n * formatString('{1} is greater than {0}', 0, 1); // '1 is greater than 0'\n * ```\n */\nexport function formatString(template: string, ...params: unknown[]): string {\n  const length = params.length;\n\n  return template.replace(/{(\\d+)}/g, (match: string, index: number) =>\n    index >= length ? match : `${params[index]}`\n  );\n}\n\n/**\n * Splits a string into its words, treating whitespace, `-`, `_` and\n * camelCase boundaries as separators.\n */\nexport function splitToWords(text: string) {\n  const input = text.replaceAll(/[^a-zA-Z0-9\\s-_]/g, '');\n  if (/[\\s-_]+/.test(input)) return input.split(/[\\s-_]+/);\n  return input.split(/(?=[A-Z])+/);\n}\n\n/** Converts a string to kebab-case. */\nexport function toKebabCase(text: string): string {\n  const input = text.trim();\n  return splitToWords(input).join('-').toLowerCase();\n}\n\n/**\n *  Escapes any potential regex syntax characters in a string, and returns a new string\n *  that can be safely used as a literal pattern for the `RegExp()` constructor.\n *\n *  @remarks\n *  Substitute with `RegExp.escape` once it has enough support:\n *\n * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/escape#browser_compatibility\n */\nexport function escapeRegex(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Creates a generator of monotonically increasing DOM ids based on the given prefix.\n *\n * @example\n * ```typescript\n * const nextId = createIdGenerator('radio');\n * nextId(); // 'radio-1'\n * nextId(); // 'radio-2'\n * ```\n */\nexport function createIdGenerator(prefix: string): () => string {\n  let id = 0;\n  return () => `${prefix}-${++id}`;\n}\n\nlet pool: Uint8Array<ArrayBuffer>;\nlet poolOffset: number;\nconst urlAlphabet =\n  'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict';\n\nfunction fillPool(bytes: number): void {\n  if (!pool || pool.length < bytes) {\n    pool = new Uint8Array(new ArrayBuffer(bytes * 128));\n    crypto.getRandomValues(pool);\n    poolOffset = 0;\n  } else if (poolOffset + bytes > pool.length) {\n    crypto.getRandomValues(pool);\n    poolOffset = 0;\n  }\n  poolOffset += bytes;\n}\n\n/**\n * Generates a unique string ID of the specified size using a URL-friendly alphabet.\n * The default size is 21 characters, which provides a very low probability of collisions.\n */\nexport function nanoid(size = 21): string {\n  const bytes = size | 0;\n  fillPool(bytes);\n\n  let id = '';\n  for (let i = poolOffset - bytes; i < poolOffset; i++) {\n    id += urlAlphabet[pool[i] & 63];\n  }\n\n  return id;\n}\n"]}

package/internals/utils/types.d.ts

@@ -0,0 +1,13 @@
+/** Returns whether the value is not `undefined`. Note that `null` is considered defined. */
+export declare function isDefined<T = unknown>(value: T): value is T & ({} | null);
+export declare function isFunction(value: unknown): value is CallableFunction;
+export declare function isString(value: unknown): value is string;
+export declare function isObject(value: unknown): value is object;
+/** Returns whether the value is a plain object (POJO) — created via `{}`, `new Object()` or `Object.create(null)`. */
+export declare function isPlainObject(value: unknown): value is Record<PropertyKey, unknown>;
+export declare function isRegExp(value: unknown): value is RegExp;
+export declare function isEventListenerObject(x: unknown): x is EventListenerObject;
+/** Required utility type for specific props */
+export type RequiredProps<T, K extends keyof T> = T & {
+    [P in K]-?: T[P];
+};

package/internals/utils/types.js

@@ -0,0 +1,31 @@
+export function isDefined(value) {
+    return value !== undefined;
+}
+export function isFunction(value) {
+    return typeof value === 'function';
+}
+export function isString(value) {
+    return typeof value === 'string';
+}
+export function isObject(value) {
+    return value != null && typeof value === 'object';
+}
+export function isPlainObject(value) {
+    if (!isObject(value)) {
+        return false;
+    }
+    const proto = Object.getPrototypeOf(value);
+    const hasObjectPrototype = proto === null ||
+        proto === Object.prototype ||
+        Object.getPrototypeOf(proto) === null;
+    return hasObjectPrototype
+        ? Object.prototype.toString.call(value) === '[object Object]'
+        : false;
+}
+export function isRegExp(value) {
+    return value instanceof RegExp;
+}
+export function isEventListenerObject(x) {
+    return isObject(x) && 'handleEvent' in x;
+}
+//# sourceMappingURL=types.js.map

package/internals/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internals/utils/types.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,SAAS,CAAc,KAAQ;IAC7C,OAAO,KAAK,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACpD,CAAC;AAGD,MAAM,UAAU,aAAa,CAC3B,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAmC,CAAC;IAE7E,MAAM,kBAAkB,GACtB,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,MAAM,CAAC,SAAS;QAC1B,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAExC,OAAO,kBAAkB;QACvB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB;QAC7D,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,MAAM,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,CAAU;IAC9C,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,aAAa,IAAI,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/** Returns whether the value is not `undefined`. Note that `null` is considered defined. */\nexport function isDefined<T = unknown>(value: T) {\n  return value !== undefined;\n}\n\nexport function isFunction(value: unknown): value is CallableFunction {\n  return typeof value === 'function';\n}\n\nexport function isString(value: unknown): value is string {\n  return typeof value === 'string';\n}\n\nexport function isObject(value: unknown): value is object {\n  return value != null && typeof value === 'object';\n}\n\n/** Returns whether the value is a plain object (POJO) — created via `{}`, `new Object()` or `Object.create(null)`. */\nexport function isPlainObject(\n  value: unknown\n): value is Record<PropertyKey, unknown> {\n  if (!isObject(value)) {\n    return false;\n  }\n\n  const proto = Object.getPrototypeOf(value) as typeof Object.prototype | null;\n\n  const hasObjectPrototype =\n    proto === null ||\n    proto === Object.prototype ||\n    Object.getPrototypeOf(proto) === null;\n\n  return hasObjectPrototype\n    ? Object.prototype.toString.call(value) === '[object Object]'\n    : false;\n}\n\nexport function isRegExp(value: unknown): value is RegExp {\n  return value instanceof RegExp;\n}\n\nexport function isEventListenerObject(x: unknown): x is EventListenerObject {\n  return isObject(x) && 'handleEvent' in x;\n}\n\n/** Required utility type for specific props */\nexport type RequiredProps<T, K extends keyof T> = T & {\n  [P in K]-?: T[P];\n};\n"]}

package/{components/common → internals}/validators.d.ts

@@ -1,6 +1,6 @@
 type ValidatorHandler<T> = (host: T) => boolean;
 type ValidatorMessageFormat<T> = (host: T) => string;
-/** @ignore */
+/** @hidden */
 export interface Validator<T = any> {
     key: keyof ValidityStateFlags;
     message: string | ValidatorMessageFormat<T>;

package/{components/common → internals}/validators.js

@@ -1,6 +1,8 @@
 import { ValidationResourceStringsEN } from 'igniteui-i18n-core';
-import { CalendarDay } from '../calendar/model.js';
-import { asNumber, formatString, isDefined, numberOfDecimals, roundPrecise, } from './util.js';
+import { CalendarDay } from './date/model.js';
+import { asNumber, numberOfDecimals, roundPrecise } from './utils/math.js';
+import { formatString } from './utils/strings.js';
+import { isDefined } from './utils/types.js';
 const emailRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
 export const requiredValidator = {
     key: 'valueMissing',

package/internals/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/internals/validators.ts"],"names":[],"mappings":"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","sourcesContent":["import { ValidationResourceStringsEN } from 'igniteui-i18n-core';\nimport { CalendarDay } from './date/model.js';\nimport { asNumber, numberOfDecimals, roundPrecise } from './utils/math.js';\nimport { formatString } from './utils/strings.js';\nimport { isDefined } from './utils/types.js';\n\ntype ValidatorHandler<T> = (host: T) => boolean;\ntype ValidatorMessageFormat<T> = (host: T) => string;\n\n/** @hidden */\nexport interface Validator<T = any> {\n  key: keyof ValidityStateFlags;\n  message: string | ValidatorMessageFormat<T>;\n  isValid: ValidatorHandler<T>;\n}\n\nconst emailRegex =\n  /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;\n\nexport const requiredValidator: Validator<{\n  required: boolean;\n  value?: unknown;\n}> = {\n  key: 'valueMissing',\n  message: ValidationResourceStringsEN.required_validation_error!,\n  isValid: ({ required, value }) => (required ? !!value : true),\n};\n\nexport const requiredBooleanValidator: Validator<{\n  required: boolean;\n  checked: boolean;\n}> = {\n  key: 'valueMissing',\n  message: ValidationResourceStringsEN.required_validation_error!,\n  isValid: ({ required, checked }) => (required ? checked : true),\n};\n\nexport const minLengthValidator: Validator<{\n  minLength?: number;\n  value: string;\n}> = {\n  key: 'tooShort',\n  message: ({ minLength }) =>\n    formatString(\n      ValidationResourceStringsEN.min_length_validation_error!,\n      minLength\n    ),\n  isValid: ({ minLength, value }) =>\n    minLength && value ? value.length >= asNumber(minLength) : true,\n};\n\nexport const maxLengthValidator: Validator<{\n  maxLength?: number;\n  value: string;\n}> = {\n  key: 'tooLong',\n  message: ({ maxLength }) =>\n    formatString(\n      ValidationResourceStringsEN.max_length_validation_error!,\n      maxLength\n    ),\n  isValid: ({ maxLength, value }) =>\n    maxLength && value ? value.length <= asNumber(maxLength) : true,\n};\n\nexport const patternValidator: Validator<{ pattern?: string; value: string }> =\n  {\n    key: 'patternMismatch',\n    message: ValidationResourceStringsEN.pattern_validation_error!,\n    isValid: ({ pattern, value }) =>\n      pattern && value ? new RegExp(pattern, 'u').test(value) : true,\n  };\n\nexport const minValidator: Validator<{\n  min?: number;\n  value: number | string;\n}> = {\n  key: 'rangeUnderflow',\n  message: ({ min }) =>\n    formatString(ValidationResourceStringsEN.min_validation_error!, min),\n  isValid: ({ min, value }) =>\n    isDefined(value) && value !== '' && isDefined(min)\n      ? asNumber(value) >= asNumber(min)\n      : true,\n};\n\nexport const maxValidator: Validator<{\n  max?: number;\n  value: number | string;\n}> = {\n  key: 'rangeOverflow',\n  message: ({ max }) =>\n    formatString(ValidationResourceStringsEN.max_validation_error!, max),\n  isValid: ({ max, value }) =>\n    isDefined(value) && value !== '' && isDefined(max)\n      ? asNumber(value) <= asNumber(max)\n      : true,\n};\n\nexport const stepValidator: Validator<{\n  min?: number;\n  step?: number;\n  value: number | string;\n}> = {\n  key: 'stepMismatch',\n  message: 'Value does not conform to step constraint',\n  isValid: ({ min, step, value }) => {\n    if (isDefined(value) && value !== '' && isDefined(step)) {\n      const _value = asNumber(value) - asNumber(min);\n      const _step = asNumber(step);\n      const magnitude = numberOfDecimals(_step) + 1;\n      const rem = roundPrecise(\n        Math.abs(_value - _step * Math.round(_value / _step)),\n        magnitude\n      );\n\n      return !rem;\n    }\n    return true;\n  },\n};\n\nexport const emailValidator: Validator<{ value: string }> = {\n  key: 'typeMismatch',\n  message: ValidationResourceStringsEN.email_validation_error!,\n  isValid: ({ value }) => (value ? emailRegex.test(value) : true),\n};\n\nexport const urlValidator: Validator<{ value: string }> = {\n  key: 'typeMismatch',\n  message: ValidationResourceStringsEN.url_validation_error!,\n  isValid: ({ value }) => (value ? URL.canParse(value) : true),\n};\n\nexport const minDateValidator: Validator<{\n  value?: Date | null;\n  min?: Date | null;\n}> = {\n  key: 'rangeUnderflow',\n  message: ({ min }) =>\n    formatString(ValidationResourceStringsEN.min_validation_error!, min),\n  isValid: ({ value, min }) =>\n    value && min ? CalendarDay.compare(value, min) >= 0 : true,\n};\n\nexport const maxDateValidator: Validator<{\n  value?: Date | null;\n  max?: Date | null;\n}> = {\n  key: 'rangeOverflow',\n  message: ({ max }) =>\n    formatString(ValidationResourceStringsEN.max_validation_error!, max),\n  isValid: ({ value, max }) =>\n    value && max ? CalendarDay.compare(value, max) <= 0 : true,\n};\n"]}