@maxclicks/utilities 1.6.0 → 1.6.3

package/dist/helpers/deepClone.d.ts

@@ -1,4 +1,5 @@
 import { DeepWritable } from '../types';
 import { Json } from '../types/Json';
+/** Creates a deep copy of a JSON value, removing readonly modifiers from the type. */
 export declare function deepClone<T extends Json>(value: T): DeepWritable<T>;
 //# sourceMappingURL=deepClone.d.ts.map

package/dist/helpers/deepClone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepClone.d.ts","sourceRoot":"","sources":["../../src/helpers/deepClone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAGpC,wBAAgB,SAAS,CAAC,CAAC,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAMnE"}
+{"version":3,"file":"deepClone.d.ts","sourceRoot":"","sources":["../../src/helpers/deepClone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAEpC,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,CAAC,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAMnE"}

package/dist/helpers/deepClone.js

@@ -1,3 +1,4 @@
+/** Creates a deep copy of a JSON value, removing readonly modifiers from the type. */
 export function deepClone(value) {
     if (!value || typeof value !== 'object')
         return value;

package/dist/helpers/deepClone.js.map

@@ -1 +1 @@
-{"version":3,"file":"deepClone.js","sourceRoot":"","sources":["../../src/helpers/deepClone.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,SAAS,CAAiB,KAAQ;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAY,CAAA;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAQ,CAAA;IAC5D,MAAM,MAAM,GAAQ,EAAE,CAAA;IACtB,KAAK,MAAM,GAAG,IAAI,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAE,KAAa,CAAC,GAAG,CAAC,CAAC,CAAA;IACrE,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"deepClone.js","sourceRoot":"","sources":["../../src/helpers/deepClone.ts"],"names":[],"mappings":"AAGA,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAiB,KAAQ;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAY,CAAA;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAQ,CAAA;IAC5D,MAAM,MAAM,GAAQ,EAAE,CAAA;IACtB,KAAK,MAAM,GAAG,IAAI,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAE,KAAa,CAAC,GAAG,CAAC,CAAC,CAAA;IACrE,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/helpers/delay.d.ts

@@ -1,5 +1,11 @@
 export { delay };
+/**
+ * Creates a promise that resolves after the specified delay.
+ *
+ * Handles large delays (>24.86 days) safely and supports abortion via `AbortSignal`.
+ *
+ * @param abortHandling - `'resolve'` returns `'aborted'`, `'reject'` throws an error.
+ */
 declare function delay(milliseconds?: number): Promise<void>;
-declare function delay(milliseconds: number, abortSignal: AbortSignal, abortHandling: 'reject'): Promise<void>;
 declare function delay(milliseconds: number, abortSignal: AbortSignal, abortHandling?: 'resolve' | 'reject'): Promise<void | 'aborted'>;
 //# sourceMappingURL=delay.d.ts.map

package/dist/helpers/delay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delay.d.ts","sourceRoot":"","sources":["../../src/helpers/delay.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,CAAA;AAShB,iBAAe,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAC1D,iBAAe,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAC5G,iBAAe,KAAK,CAClB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,WAAW,EACxB,aAAa,CAAC,EAAE,SAAS,GAAG,QAAQ,GACnC,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAA"}
+{"version":3,"file":"delay.d.ts","sourceRoot":"","sources":["../../src/helpers/delay.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,CAAA;AAEhB;;;;;;GAMG;AACH,iBAAe,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAC1D,iBAAe,KAAK,CAClB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,WAAW,EACxB,aAAa,CAAC,EAAE,SAAS,GAAG,QAAQ,GACnC,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAA"}

package/dist/helpers/delay.js

@@ -1,4 +1,4 @@
-const MAXIMUM_VALID_DELAY_MILLISECONDS = 2147483647;
+const MAXIMUM_VALID_DELAY_MILLISECONDS = 2147483647; // = 2 ** 31 - 1 ≈ 24.86 days, larger delay values cause the timeout function to be executed immediately.
 function getSafeDelayMilliseconds(milliseconds) {
     return Math.max(Math.min(milliseconds, MAXIMUM_VALID_DELAY_MILLISECONDS), 0);
 }

package/dist/helpers/delay.js.map

@@ -1 +1 @@
-{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/helpers/delay.ts"],"names":[],"mappings":"AAAA,MAAM,gCAAgC,GAAG,UAAU,CAAA;AAEnD,SAAS,wBAAwB,CAAC,YAAoB;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,gCAAgC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC9E,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,CAAA;AAgBhB,KAAK,UAAU,KAAK,CAClB,YAAY,GAAG,CAAC,EAChB,WAAyB,EACzB,gBAAsC,SAAS;IAE/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACzB,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;YACvG,OAAM;QACR,CAAC;QAED,IAAI,OAAO,GAAyC,IAAI,CAAA;QAExD,MAAM,WAAW,GAAG,CAAC,KAAY,EAAQ,EAAE;YACzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,YAAY,CAAC,OAAO,CAAC,CAAA;gBACrB,OAAO,GAAG,IAAI,CAAA;gBACd,WAAW,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;gBACtD,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;YACjF,CAAC;QACH,CAAC,CAAA;QAED,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;QAEnD,KAAK,CAAC,SAAS,cAAc;YAC3B,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAA;YACpE,YAAY,IAAI,qBAAqB,CAAA;YACrC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACxB,IAAI,WAAW,EAAE,OAAO;oBAAE,OAAM;gBAChC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;oBACrB,cAAc,EAAE,CAAA;gBAClB,CAAC;qBAAM,CAAC;oBACN,OAAO,GAAG,IAAI,CAAA;oBACd,WAAW,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;oBACtD,OAAO,EAAE,CAAA;gBACX,CAAC;YACH,CAAC,EAAE,qBAAqB,CAAC,CAAA;QAC3B,CAAC,CAAC,EAAE,CAAA;IACN,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/helpers/delay.ts"],"names":[],"mappings":"AAAA,MAAM,gCAAgC,GAAG,UAAU,CAAA,CAAC,yGAAyG;AAE7J,SAAS,wBAAwB,CAAC,YAAoB;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,gCAAgC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC9E,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,CAAA;AAehB,KAAK,UAAU,KAAK,CAClB,YAAY,GAAG,CAAC,EAChB,WAAyB,EACzB,gBAAsC,SAAS;IAE/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACzB,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;YACvG,OAAM;QACR,CAAC;QAED,IAAI,OAAO,GAAyC,IAAI,CAAA;QAExD,MAAM,WAAW,GAAG,CAAC,KAAY,EAAQ,EAAE;YACzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,YAAY,CAAC,OAAO,CAAC,CAAA;gBACrB,OAAO,GAAG,IAAI,CAAA;gBACd,WAAW,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;gBACtD,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;YACjF,CAAC;QACH,CAAC,CAAA;QAED,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;QAEnD,KAAK,CAAC,SAAS,cAAc;YAC3B,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAA;YACpE,YAAY,IAAI,qBAAqB,CAAA;YACrC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACxB,IAAI,WAAW,EAAE,OAAO;oBAAE,OAAM;gBAChC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;oBACrB,cAAc,EAAE,CAAA;gBAClB,CAAC;qBAAM,CAAC;oBACN,OAAO,GAAG,IAAI,CAAA;oBACd,WAAW,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;oBACtD,OAAO,EAAE,CAAA;gBACX,CAAC;YACH,CAAC,EAAE,qBAAqB,CAAC,CAAA;QAC3B,CAAC,CAAC,EAAE,CAAA;IACN,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/helpers/error-warning/alterError.d.ts

@@ -1,6 +1,12 @@
 import { Falsy } from '../../types';
+/**
+ * Executes an action, allowing error transformation if it throws.
+ *
+ * @param handleError - Returns a new error message/Error to throw, or falsy to rethrow original.
+ */
 export declare function alterError<R>(action: () => R, handleError: (error: unknown) => string | Error | Falsy): R;
 export declare namespace alterError {
-    function async<R>(action: () => Promise<R>, handleError: (error: unknown) => string | Error | Falsy): Promise<R>;
+    /** Async variant of `alterError`. */
+    function async<R>(action: () => R, handleError: (error: unknown) => string | Error | Falsy): Promise<Awaited<R>>;
 }
 //# sourceMappingURL=alterError.d.ts.map

package/dist/helpers/error-warning/alterError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alterError.d.ts","sourceRoot":"","sources":["../../../src/helpers/error-warning/alterError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAOnC,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,CAAC,CASzG;AAED,yBAAiB,UAAU,CAAC;IAE1B,SAAsB,KAAK,CAAC,CAAC,EAC3B,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,KAAK,GAAG,KAAK,GACtD,OAAO,CAAC,CAAC,CAAC,CASZ;CACF"}
+{"version":3,"file":"alterError.d.ts","sourceRoot":"","sources":["../../../src/helpers/error-warning/alterError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEnC;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,CAAC,CASzG;AAED,yBAAiB,UAAU,CAAC;IAC1B,qCAAqC;IACrC,SAAsB,KAAK,CAAC,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,EACf,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,KAAK,GAAG,KAAK,GACtD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CASrB;CACF"}

package/dist/helpers/error-warning/alterError.js

@@ -1,3 +1,8 @@
+/**
+ * Executes an action, allowing error transformation if it throws.
+ *
+ * @param handleError - Returns a new error message/Error to throw, or falsy to rethrow original.
+ */
 export function alterError(action, handleError) {
     try {
         return action();
@@ -12,6 +17,7 @@ export function alterError(action, handleError) {
     }
 }
 (function (alterError) {
+    /** Async variant of `alterError`. */
     async function async(action, handleError) {
         try {
             return await action();

package/dist/helpers/error-warning/alterError.js.map

@@ -1 +1 @@
-{"version":3,"file":"alterError.js","sourceRoot":"","sources":["../../../src/helpers/error-warning/alterError.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU,CAAI,MAAe,EAAE,WAAuD;IACpG,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAA;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;QACvC,IAAI,CAAC,YAAY;YAAE,MAAM,KAAK,CAAA;QAC9B,IAAI,OAAO,YAAY,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;QACnE,MAAM,YAAY,CAAA;IACpB,CAAC;AACH,CAAC;AAED,WAAiB,UAAU;IAElB,KAAK,UAAU,KAAK,CACzB,MAAwB,EACxB,WAAuD;QAEvD,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,EAAE,CAAA;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;YACvC,IAAI,CAAC,YAAY;gBAAE,MAAM,KAAK,CAAA;YAC9B,IAAI,OAAO,YAAY,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;YACnE,MAAM,YAAY,CAAA;QACpB,CAAC;IACH,CAAC;IAZqB,gBAAK,QAY1B,CAAA;AACH,CAAC,EAfgB,UAAU,KAAV,UAAU,QAe1B"}
+{"version":3,"file":"alterError.js","sourceRoot":"","sources":["../../../src/helpers/error-warning/alterError.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAI,MAAe,EAAE,WAAuD;IACpG,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAA;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;QACvC,IAAI,CAAC,YAAY;YAAE,MAAM,KAAK,CAAA;QAC9B,IAAI,OAAO,YAAY,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;QACnE,MAAM,YAAY,CAAA;IACpB,CAAC;AACH,CAAC;AAED,WAAiB,UAAU;IACzB,qCAAqC;IAC9B,KAAK,UAAU,KAAK,CACzB,MAAe,EACf,WAAuD;QAEvD,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,EAAE,CAAA;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;YACvC,IAAI,CAAC,YAAY;gBAAE,MAAM,KAAK,CAAA;YAC9B,IAAI,OAAO,YAAY,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;YACnE,MAAM,YAAY,CAAA;QACpB,CAAC;IACH,CAAC;IAZqB,gBAAK,QAY1B,CAAA;AACH,CAAC,EAfgB,UAAU,KAAV,UAAU,QAe1B"}

package/dist/helpers/error-warning/combineMessages.d.ts

@@ -1,13 +1,19 @@
 import { Falsy } from '../../types';
+/**
+ * Combines an object of keyed messages into a single newline-separated string.
+ * Each message is prefixed with its key.
+ */
 export declare function combineMessages(messagesByKey: {
     readonly [key: string]: string | Falsy;
 }): string | undefined;
 export declare namespace combineMessages {
+    /** Combines `errorMessage` properties from normalized results. */
     function errors(normalizedByKey: {
         readonly [key: string]: string | Falsy | {
             readonly errorMessage?: string | Falsy;
         };
     }): string | undefined;
+    /** Combines `warningMessage` properties from normalized results. */
     function warnings(normalizedByKey: {
         readonly [key: string]: string | Falsy | {
             readonly warningMessage?: string | Falsy;

package/dist/helpers/error-warning/combineMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"combineMessages.d.ts","sourceRoot":"","sources":["../../../src/helpers/error-warning/combineMessages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AASnC,wBAAgB,eAAe,CAAC,aAAa,EAAE;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAM7G;AAED,yBAAiB,eAAe,CAAC;IAE/B,SAAgB,MAAM,CAAC,eAAe,EAAE;QACtC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG;YAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;SAAE,CAAA;KACpF,GAAG,MAAM,GAAG,SAAS,CAMrB;IAGD,SAAgB,QAAQ,CAAC,eAAe,EAAE;QACxC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG;YAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;SAAE,CAAA;KACtF,GAAG,MAAM,GAAG,SAAS,CAMrB;CACF"}
+{"version":3,"file":"combineMessages.d.ts","sourceRoot":"","sources":["../../../src/helpers/error-warning/combineMessages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAKnC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAM7G;AAED,yBAAiB,eAAe,CAAC;IAC/B,kEAAkE;IAClE,SAAgB,MAAM,CAAC,eAAe,EAAE;QACtC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG;YAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;SAAE,CAAA;KACpF,GAAG,MAAM,GAAG,SAAS,CAMrB;IAED,oEAAoE;IACpE,SAAgB,QAAQ,CAAC,eAAe,EAAE;QACxC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG;YAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;SAAE,CAAA;KACtF,GAAG,MAAM,GAAG,SAAS,CAMrB;CACF"}

package/dist/helpers/error-warning/combineMessages.js

@@ -1,16 +1,22 @@
 import { arrayHelpers } from '../native/arrayHelpers';
 import { objectHelpers } from '../native/objectHelpers';
 import { prependMessage } from './prependMessage';
+/**
+ * Combines an object of keyed messages into a single newline-separated string.
+ * Each message is prefixed with its key.
+ */
 export function combineMessages(messagesByKey) {
     return (arrayHelpers
         .mapFilter(objectHelpers.entries(messagesByKey), ([key, value]) => value && prependMessage(key, value))
         .join('\n') || undefined);
 }
 (function (combineMessages) {
+    /** Combines `errorMessage` properties from normalized results. */
     function errors(normalizedByKey) {
         return combineMessages(objectHelpers.map(normalizedByKey, (key, value) => !value ? undefined : typeof value === 'string' ? value : value.errorMessage));
     }
     combineMessages.errors = errors;
+    /** Combines `warningMessage` properties from normalized results. */
     function warnings(normalizedByKey) {
         return combineMessages(objectHelpers.map(normalizedByKey, (key, value) => !value ? undefined : typeof value === 'string' ? value : value.warningMessage));
     }

package/dist/helpers/error-warning/combineMessages.js.map

@@ -1 +1 @@
-{"version":3,"file":"combineMessages.js","sourceRoot":"","sources":["../../../src/helpers/error-warning/combineMessages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAMjD,MAAM,UAAU,eAAe,CAAC,aAAyD;IACvF,OAAO,CACL,YAAY;SACT,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;SACtG,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAC3B,CAAA;AACH,CAAC;AAED,WAAiB,eAAe;IAE9B,SAAgB,MAAM,CAAC,eAEtB;QACC,OAAO,eAAe,CACpB,aAAa,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAChD,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAC5E,CACF,CAAA;IACH,CAAC;IARe,sBAAM,SAQrB,CAAA;IAGD,SAAgB,QAAQ,CAAC,eAExB;QACC,OAAO,eAAe,CACpB,aAAa,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAChD,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAC9E,CACF,CAAA;IACH,CAAC;IARe,wBAAQ,WAQvB,CAAA;AACH,CAAC,EAtBgB,eAAe,KAAf,eAAe,QAsB/B"}
+{"version":3,"file":"combineMessages.js","sourceRoot":"","sources":["../../../src/helpers/error-warning/combineMessages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,aAAyD;IACvF,OAAO,CACL,YAAY;SACT,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;SACtG,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAC3B,CAAA;AACH,CAAC;AAED,WAAiB,eAAe;IAC9B,kEAAkE;IAClE,SAAgB,MAAM,CAAC,eAEtB;QACC,OAAO,eAAe,CACpB,aAAa,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAChD,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAC5E,CACF,CAAA;IACH,CAAC;IARe,sBAAM,SAQrB,CAAA;IAED,oEAAoE;IACpE,SAAgB,QAAQ,CAAC,eAExB;QACC,OAAO,eAAe,CACpB,aAAa,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAChD,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAC9E,CACF,CAAA;IACH,CAAC;IARe,wBAAQ,WAQvB,CAAA;AACH,CAAC,EAtBgB,eAAe,KAAf,eAAe,QAsB/B"}

package/dist/helpers/error-warning/getErrorMessage.d.ts

@@ -1,2 +1,3 @@
+/** Extracts a message string from any error value. */
 export declare function getErrorMessage(error: any, defaultMessage?: string): string;
 //# sourceMappingURL=getErrorMessage.d.ts.map

package/dist/helpers/error-warning/getErrorMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getErrorMessage.d.ts","sourceRoot":"","sources":["../../../src/helpers/error-warning/getErrorMessage.ts"],"names":[],"mappings":"AACA,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,cAAc,SAAmB,GAAG,MAAM,CAKrF"}
+{"version":3,"file":"getErrorMessage.d.ts","sourceRoot":"","sources":["../../../src/helpers/error-warning/getErrorMessage.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,cAAc,SAAmB,GAAG,MAAM,CAKrF"}

package/dist/helpers/error-warning/getErrorMessage.js

@@ -1,3 +1,4 @@
+/** Extracts a message string from any error value. */
 export function getErrorMessage(error, defaultMessage = 'Unknown error.') {
     return ((typeof error === 'string' ? error : String(error?.message || error?.toString?.() || defaultMessage)) ||
         defaultMessage);

package/dist/helpers/error-warning/getErrorMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"getErrorMessage.js","sourceRoot":"","sources":["../../../src/helpers/error-warning/getErrorMessage.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,eAAe,CAAC,KAAU,EAAE,cAAc,GAAG,gBAAgB;IAC3E,OAAO,CACL,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,cAAc,CAAC,CAAC;QACrG,cAAc,CACf,CAAA;AACH,CAAC"}
+{"version":3,"file":"getErrorMessage.js","sourceRoot":"","sources":["../../../src/helpers/error-warning/getErrorMessage.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,UAAU,eAAe,CAAC,KAAU,EAAE,cAAc,GAAG,gBAAgB;IAC3E,OAAO,CACL,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,cAAc,CAAC,CAAC;QACrG,cAAc,CACf,CAAA;AACH,CAAC"}

package/dist/helpers/error-warning/prependMessage.d.ts

@@ -1,2 +1,8 @@
+/**
+ * Prepends a prefix to a message, handling multi-line messages by indenting.
+ *
+ * - Single-line: `"prefix: message"`
+ * - Multi-line: prefix on its own line, message indented below
+ */
 export declare function prependMessage<E extends string | undefined>(prefix: string | undefined, message: E): E;
 //# sourceMappingURL=prependMessage.d.ts.map

package/dist/helpers/error-warning/prependMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prependMessage.d.ts","sourceRoot":"","sources":["../../../src/helpers/error-warning/prependMessage.ts"],"names":[],"mappings":"AAQA,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAMtG"}
+{"version":3,"file":"prependMessage.d.ts","sourceRoot":"","sources":["../../../src/helpers/error-warning/prependMessage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAMtG"}

package/dist/helpers/error-warning/prependMessage.js

@@ -1,4 +1,10 @@
 import { stringHelpers } from '../native/stringHelpers';
+/**
+ * Prepends a prefix to a message, handling multi-line messages by indenting.
+ *
+ * - Single-line: `"prefix: message"`
+ * - Multi-line: prefix on its own line, message indented below
+ */
 export function prependMessage(prefix, message) {
     if (!message || !prefix)
         return message;

package/dist/helpers/error-warning/prependMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"prependMessage.js","sourceRoot":"","sources":["../../../src/helpers/error-warning/prependMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAQvD,MAAM,UAAU,cAAc,CAA+B,MAA0B,EAAE,OAAU;IACjG,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAA;IAEvC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,MAAM,MAAM,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAO,CAAA;IAE5F,OAAO,GAAG,MAAM,KAAK,OAAO,EAAO,CAAA;AACrC,CAAC"}
+{"version":3,"file":"prependMessage.js","sourceRoot":"","sources":["../../../src/helpers/error-warning/prependMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAA+B,MAA0B,EAAE,OAAU;IACjG,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAA;IAEvC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,MAAM,MAAM,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAO,CAAA;IAE5F,OAAO,GAAG,MAAM,KAAK,OAAO,EAAO,CAAA;AACrC,CAAC"}

package/dist/helpers/error-warning/throwError.d.ts

@@ -1,2 +1,9 @@
+/**
+ * It's effectively the same as `throw new Error(message)` but with two differences:
+ * - It's a function call and can be used inline inside expressions.
+ * - TypeScript won't consider the following lines "unreachable", so we may use it
+ * inside the `switch` blocks' `default` sections while having TypeScript still
+ * complaining about the missing `case` sections.
+ */
 export declare function throwError<R = void>(error?: string | Error): R;
 //# sourceMappingURL=throwError.d.ts.map

package/dist/helpers/error-warning/throwError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"throwError.d.ts","sourceRoot":"","sources":["../../../src/helpers/error-warning/throwError.ts"],"names":[],"mappings":"AASA,wBAAgB,UAAU,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,CAAC,CAE9D"}
+{"version":3,"file":"throwError.d.ts","sourceRoot":"","sources":["../../../src/helpers/error-warning/throwError.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,CAAC,CAE9D"}

package/dist/helpers/error-warning/throwError.js

@@ -1,3 +1,12 @@
+// The return type should be `void`, not `never`; this way TypeScript still complains
+// about missing return values even if it encounters this call:
+/**
+ * It's effectively the same as `throw new Error(message)` but with two differences:
+ * - It's a function call and can be used inline inside expressions.
+ * - TypeScript won't consider the following lines "unreachable", so we may use it
+ * inside the `switch` blocks' `default` sections while having TypeScript still
+ * complaining about the missing `case` sections.
+ */
 export function throwError(error) {
     throw typeof error === 'string' ? new Error(error) : error;
 }

package/dist/helpers/error-warning/throwError.js.map

@@ -1 +1 @@
-{"version":3,"file":"throwError.js","sourceRoot":"","sources":["../../../src/helpers/error-warning/throwError.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,UAAU,CAAW,KAAsB;IACzD,MAAM,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AAC5D,CAAC"}
+{"version":3,"file":"throwError.js","sourceRoot":"","sources":["../../../src/helpers/error-warning/throwError.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,+DAA+D;AAC/D;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAW,KAAsB;IACzD,MAAM,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AAC5D,CAAC"}

package/dist/helpers/escapeForRegExp.d.ts

@@ -1,2 +1,3 @@
+/** Escapes special RegExp characters in a string for safe use in `new RegExp()`. */
 export declare function escapeForRegExp(value: string): string;
 //# sourceMappingURL=escapeForRegExp.d.ts.map

package/dist/helpers/escapeForRegExp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"escapeForRegExp.d.ts","sourceRoot":"","sources":["../../src/helpers/escapeForRegExp.ts"],"names":[],"mappings":"AACA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"escapeForRegExp.d.ts","sourceRoot":"","sources":["../../src/helpers/escapeForRegExp.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/helpers/escapeForRegExp.js

@@ -1,4 +1,5 @@
+/** Escapes special RegExp characters in a string for safe use in `new RegExp()`. */
 export function escapeForRegExp(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string.
 }
 //# sourceMappingURL=escapeForRegExp.js.map

package/dist/helpers/escapeForRegExp.js.map

@@ -1 +1 @@
-{"version":3,"file":"escapeForRegExp.js","sourceRoot":"","sources":["../../src/helpers/escapeForRegExp.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AACrD,CAAC"}
+{"version":3,"file":"escapeForRegExp.js","sourceRoot":"","sources":["../../src/helpers/escapeForRegExp.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA,CAAC,qCAAqC;AAC3F,CAAC"}

package/dist/helpers/formatCurrencyUsd.d.ts

@@ -1,2 +1,3 @@
+/** Formats a number as US currency (e.g., `$1,234.56`). */
 export declare function formatCurrencyUsd(value: number): string;
 //# sourceMappingURL=formatCurrencyUsd.d.ts.map

package/dist/helpers/formatCurrencyUsd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatCurrencyUsd.d.ts","sourceRoot":"","sources":["../../src/helpers/formatCurrencyUsd.ts"],"names":[],"mappings":"AAMA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD"}
+{"version":3,"file":"formatCurrencyUsd.d.ts","sourceRoot":"","sources":["../../src/helpers/formatCurrencyUsd.ts"],"names":[],"mappings":"AAKA,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/helpers/formatCurrencyUsd.js

@@ -2,6 +2,7 @@ const numberFormat = Intl.NumberFormat('en-US', {
     style: 'currency',
     currency: 'USD',
 });
+/** Formats a number as US currency (e.g., `$1,234.56`). */
 export function formatCurrencyUsd(value) {
     return numberFormat.format(value);
 }

package/dist/helpers/formatCurrencyUsd.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatCurrencyUsd.js","sourceRoot":"","sources":["../../src/helpers/formatCurrencyUsd.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;IAC9C,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,KAAK;CAChB,CAAC,CAAA;AAGF,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"formatCurrencyUsd.js","sourceRoot":"","sources":["../../src/helpers/formatCurrencyUsd.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;IAC9C,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,KAAK;CAChB,CAAC,CAAA;AAEF,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC"}

package/dist/helpers/generateRandomKey.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Generates a random alphanumeric string.
+ *
+ * @param length - Key length (default: 16)
+ * @param accept - Optional predicate to regenerate until accepted
+ */
 export declare const generateRandomKey: {
     (): string;
     (length: number): string;

package/dist/helpers/generateRandomKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateRandomKey.d.ts","sourceRoot":"","sources":["../../src/helpers/generateRandomKey.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iBAAiB,EAAE;IAC9B,IAAI,MAAM,CAAA;IACV,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAAA;IAC1C,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,GAAG,MAAM,CAAA;CAoBzE,CAAA"}
+{"version":3,"file":"generateRandomKey.d.ts","sourceRoot":"","sources":["../../src/helpers/generateRandomKey.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE;IAC9B,IAAI,MAAM,CAAA;IACV,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAAA;IAC1C,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,GAAG,MAAM,CAAA;CAoBzE,CAAA"}

package/dist/helpers/generateRandomKey.js

@@ -1,3 +1,9 @@
+/**
+ * Generates a random alphanumeric string.
+ *
+ * @param length - Key length (default: 16)
+ * @param accept - Optional predicate to regenerate until accepted
+ */
 export const generateRandomKey = (arg) => {
     let length = 16;
     let accept = (key) => true;

package/dist/helpers/generateRandomKey.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateRandomKey.js","sourceRoot":"","sources":["../../src/helpers/generateRandomKey.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,iBAAiB,GAK1B,CAAC,GAAiG,EAAU,EAAE;IAChH,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAA;IAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAA;IACd,CAAC;SAAM,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,CAAA;IACd,CAAC;SAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,MAAM,CAAA;QAC7B,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,MAAM,CAAA;IAC/B,CAAC;IACD,IAAI,GAAW,CAAA;IACf,GAAG,CAAC;QACF,GAAG,GAAG,EAAE,CAAA;QACR,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;QACzE,CAAC;IACH,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAC;IACtB,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,gEAAgE,CAAA"}
+{"version":3,"file":"generateRandomKey.js","sourceRoot":"","sources":["../../src/helpers/generateRandomKey.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAK1B,CAAC,GAAiG,EAAU,EAAE;IAChH,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAA;IAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAA;IACd,CAAC;SAAM,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,CAAA;IACd,CAAC;SAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,MAAM,CAAA;QAC7B,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,MAAM,CAAA;IAC/B,CAAC;IACD,IAAI,GAAW,CAAA;IACf,GAAG,CAAC;QACF,GAAG,GAAG,EAAE,CAAA;QACR,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;QACzE,CAAC;IACH,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAC;IACtB,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,gEAAgE,CAAA"}

package/dist/helpers/generateRuntimeId.d.ts

@@ -1,2 +1,3 @@
+/** Generates a unique sequential ID within the current runtime (not persistent). */
 export declare function generateRuntimeId(): string;
 //# sourceMappingURL=generateRuntimeId.d.ts.map

package/dist/helpers/generateRuntimeId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateRuntimeId.d.ts","sourceRoot":"","sources":["../../src/helpers/generateRuntimeId.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C"}
+{"version":3,"file":"generateRuntimeId.d.ts","sourceRoot":"","sources":["../../src/helpers/generateRuntimeId.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C"}

package/dist/helpers/generateRuntimeId.js

@@ -1,4 +1,5 @@
 let count = BigInt(0);
+/** Generates a unique sequential ID within the current runtime (not persistent). */
 export function generateRuntimeId() {
     count += BigInt(1);
     return String(count);

package/dist/helpers/generateRuntimeId.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateRuntimeId.js","sourceRoot":"","sources":["../../src/helpers/generateRuntimeId.ts"],"names":[],"mappings":"AAAA,IAAI,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;AAGrB,MAAM,UAAU,iBAAiB;IAC/B,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA;IAClB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC"}
+{"version":3,"file":"generateRuntimeId.js","sourceRoot":"","sources":["../../src/helpers/generateRuntimeId.ts"],"names":[],"mappings":"AAAA,IAAI,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;AAErB,oFAAoF;AACpF,MAAM,UAAU,iBAAiB;IAC/B,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA;IAClB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC"}

package/dist/helpers/generateSequence.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Generates a timestamp-based sequence string for ordering.
+ *
+ * Can generate sequences between two existing ones for insertion.
+ */
 export declare function generateSequence(options?: {
     readonly timestampMicroseconds?: number;
     readonly previousSequence?: string;

package/dist/helpers/generateSequence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateSequence.d.ts","sourceRoot":"","sources":["../../src/helpers/generateSequence.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IACzC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,MAAM,CAOT"}
+{"version":3,"file":"generateSequence.d.ts","sourceRoot":"","sources":["../../src/helpers/generateSequence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IACzC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,MAAM,CAOT"}

package/dist/helpers/generateSequence.js

@@ -1,3 +1,8 @@
+/**
+ * Generates a timestamp-based sequence string for ordering.
+ *
+ * Can generate sequences between two existing ones for insertion.
+ */
 export function generateSequence(options) {
     const currentTimestampMicroseconds = (options?.timestampMicroseconds ?? Math.floor(Date.now() * 1000)) + (options?.offset || 0);
     if (!options?.nextSequence)

package/dist/helpers/generateSequence.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateSequence.js","sourceRoot":"","sources":["../../src/helpers/generateSequence.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,gBAAgB,CAAC,OAKhC;IACC,MAAM,4BAA4B,GAChC,CAAC,OAAO,EAAE,qBAAqB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,CAAA;IAC5F,IAAI,CAAC,OAAO,EAAE,YAAY;QAAE,OAAO,GAAG,4BAA4B,2BAA2B,CAAA;IAC7F,IAAI,CAAC,OAAO,CAAC,gBAAgB;QAC3B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC5F,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;AACnG,CAAC"}
+{"version":3,"file":"generateSequence.js","sourceRoot":"","sources":["../../src/helpers/generateSequence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAKhC;IACC,MAAM,4BAA4B,GAChC,CAAC,OAAO,EAAE,qBAAqB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,CAAA;IAC5F,IAAI,CAAC,OAAO,EAAE,YAAY;QAAE,OAAO,GAAG,4BAA4B,2BAA2B,CAAA;IAC7F,IAAI,CAAC,OAAO,CAAC,gBAAgB;QAC3B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC5F,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;AACnG,CAAC"}

package/dist/helpers/getEnumKeyValues.d.ts

@@ -1,3 +1,4 @@
+/** Extracts `{ key, value }` pairs from a TypeScript enum. */
 export declare function getEnumKeyValues<E>(enumObject: any): {
     key: string;
     value: E;

package/dist/helpers/getEnumKeyValues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getEnumKeyValues.d.ts","sourceRoot":"","sources":["../../src/helpers/getEnumKeyValues.ts"],"names":[],"mappings":"AACA,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,EAAE,CAShF"}
+{"version":3,"file":"getEnumKeyValues.d.ts","sourceRoot":"","sources":["../../src/helpers/getEnumKeyValues.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,EAAE,CAShF"}

package/dist/helpers/getEnumKeyValues.js

@@ -1,5 +1,7 @@
+/** Extracts `{ key, value }` pairs from a TypeScript enum. */
 export function getEnumKeyValues(enumObject) {
     const allKeys = Object.keys(enumObject);
+    // Since only keys with number values are stored reversed too:
     const straightKeys = allKeys.filter(key => !/^\d+$/.test(key));
     const keyValues = straightKeys.map(key => ({ key, value: enumObject[key] }));
     return keyValues;

package/dist/helpers/getEnumKeyValues.js.map

@@ -1 +1 @@
-{"version":3,"file":"getEnumKeyValues.js","sourceRoot":"","sources":["../../src/helpers/getEnumKeyValues.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,gBAAgB,CAAI,UAAe;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAGvC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAE9D,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IAE5E,OAAO,SAAgB,CAAA;AACzB,CAAC"}
+{"version":3,"file":"getEnumKeyValues.js","sourceRoot":"","sources":["../../src/helpers/getEnumKeyValues.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAI,UAAe;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAEvC,8DAA8D;IAC9D,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAE9D,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IAE5E,OAAO,SAAgB,CAAA;AACzB,CAAC"}

package/dist/helpers/haveSameContents.d.ts

@@ -1,2 +1,3 @@
+/** Deep equality check for JSON-like values. Handles `NaN` and `Date` objects. */
 export declare function haveSameContents(first: any, second: any): boolean;
 //# sourceMappingURL=haveSameContents.d.ts.map

package/dist/helpers/haveSameContents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"haveSameContents.d.ts","sourceRoot":"","sources":["../../src/helpers/haveSameContents.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAiCjE"}
+{"version":3,"file":"haveSameContents.d.ts","sourceRoot":"","sources":["../../src/helpers/haveSameContents.ts"],"names":[],"mappings":"AAGA,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAiCjE"}

package/dist/helpers/haveSameContents.js

@@ -1,5 +1,6 @@
 import { arrayHelpers } from './native/arrayHelpers';
 import { objectHelpers } from './native/objectHelpers';
+/** Deep equality check for JSON-like values. Handles `NaN` and `Date` objects. */
 export function haveSameContents(first, second) {
     switch (typeof first) {
         case 'string':

package/dist/helpers/haveSameContents.js.map

@@ -1 +1 @@
-{"version":3,"file":"haveSameContents.js","sourceRoot":"","sources":["../../src/helpers/haveSameContents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAGtD,MAAM,UAAU,gBAAgB,CAAC,KAAU,EAAE,MAAW;IACtD,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,KAAK,KAAK,MAAM,CAAA;QAEzB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAA;QAEtE,KAAK,QAAQ;YACX,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,KAAK,MAAM,CAAA;YACnC,IAAI,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC7B,OAAO,CACL,CAAC,CAAC,MAAM;oBACR,OAAO,MAAM,KAAK,QAAQ;oBAC1B,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;oBAC5B,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;oBAC9B,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CACpE,CAAA;YACH,IAAI,KAAK,YAAY,IAAI,IAAI,MAAM,YAAY,IAAI;gBACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK,MAAM,CAAC,OAAO,EAAE,CAAA;YAClH,OAAO,CACL,CAAC,CAAC,MAAM;gBACR,OAAO,MAAM,KAAK,QAAQ;gBAC1B,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC7B,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,MAAM,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC3G,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CACtD,CAAA;IACL,CAAC;AACH,CAAC"}
+{"version":3,"file":"haveSameContents.js","sourceRoot":"","sources":["../../src/helpers/haveSameContents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAEtD,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,KAAU,EAAE,MAAW;IACtD,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,KAAK,KAAK,MAAM,CAAA;QAEzB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAA;QAEtE,KAAK,QAAQ;YACX,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,KAAK,MAAM,CAAA;YACnC,IAAI,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC7B,OAAO,CACL,CAAC,CAAC,MAAM;oBACR,OAAO,MAAM,KAAK,QAAQ;oBAC1B,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;oBAC5B,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;oBAC9B,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CACpE,CAAA;YACH,IAAI,KAAK,YAAY,IAAI,IAAI,MAAM,YAAY,IAAI;gBACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK,MAAM,CAAC,OAAO,EAAE,CAAA;YAClH,OAAO,CACL,CAAC,CAAC,MAAM;gBACR,OAAO,MAAM,KAAK,QAAQ;gBAC1B,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC7B,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,MAAM,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC3G,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CACtD,CAAA;IACL,CAAC;AACH,CAAC"}

package/dist/helpers/isOneOf.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Type guard that checks if `target` equals any of the provided items.
+ *
+ * Narrows the type to the union of matching items.
+ */
 export declare const isOneOf: {
     <T, T1 extends T>(target: T, item1: T1): target is T1;
     <T, T1 extends T, T2 extends Exclude<T, T1>>(target: T, item1: T1, item2: T2): target is T1 | T2;

package/dist/helpers/isOneOf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isOneOf.d.ts","sourceRoot":"","sources":["../../src/helpers/isOneOf.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"isOneOf.d.ts","sourceRoot":"","sources":["../../src/helpers/isOneOf.ts"],"names":[],"mappings":"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"}

package/dist/helpers/isOneOf.js

@@ -1,2 +1,7 @@
+/**
+ * Type guard that checks if `target` equals any of the provided items.
+ *
+ * Narrows the type to the union of matching items.
+ */
 export const isOneOf = ((target, ...items) => items.includes(target));
 //# sourceMappingURL=isOneOf.js.map

package/dist/helpers/isOneOf.js.map

@@ -1 +1 @@
-{"version":3,"file":"isOneOf.js","sourceRoot":"","sources":["../../src/helpers/isOneOf.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAW,EAAE,GAAG,KAAY,EAAW,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAgHxF,CAAA"}
+{"version":3,"file":"isOneOf.js","sourceRoot":"","sources":["../../src/helpers/isOneOf.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAW,EAAE,GAAG,KAAY,EAAW,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAgHxF,CAAA"}

package/dist/helpers/native/arrayHelpers.d.ts

@@ -1,8 +1,11 @@
 import { Falsy, Trucy } from '../../types';
 interface ArrayHelpers {
+    /** Array.isArray only works correctly on writable arrays not readonly ones. */
     isArray(value: any): value is readonly any[];
     equals<T>(firstArray: readonly T[], secondArray: readonly T[], itemsEqual?: (firstItem: T, secondItem: T) => any): boolean;
+    /** Since `Array.prototype.at(0)` is not widely supported yet, we use this helper method instead. */
     first<T>(array: readonly T[]): T | undefined;
+    /** Since `Array.prototype.at(-1)` is not widely supported yet, we use this helper method instead. */
     last<T>(array: readonly T[]): T | undefined;
     sortBy<T>(array: T[], ...propertySelectors: (keyof T | ((item: T) => any))[]): T[];
     sortByDescending<T>(array: T[], ...propertySelectors: (keyof T | ((item: T) => any))[]): T[];
@@ -30,6 +33,7 @@ interface ArrayHelpers {
     mapFindLast<T, U>(array: readonly T[], mapper: (item: T, itemIndex: number, items: readonly T[]) => U, predicate?: (mappedItem: U, item: T, itemIndex: number, items: readonly T[]) => any): U | undefined;
     mapFilter<T, U>(array: readonly T[], mapper: (item: T, itemIndex: number, items: readonly T[]) => U): Trucy<U>[];
     mapFilter<T, U>(array: readonly T[], mapper: (item: T, itemIndex: number, items: readonly T[]) => U, predicate?: (mappedItem: U, item: T, itemIndex: number, items: readonly T[]) => any): U[];
+    /** Almost the same as array.filter(Boolean) but with a better typing. */
     filterFalsy<T>(array: readonly (T | Falsy)[]): T[];
     buildTruthy<T>(...items: readonly (T | Falsy)[]): T[];
 }

package/dist/helpers/native/arrayHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arrayHelpers.d.ts","sourceRoot":"","sources":["../../../src/helpers/native/arrayHelpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"arrayHelpers.d.ts","sourceRoot":"","sources":["../../../src/helpers/native/arrayHelpers.ts"],"names":[],"mappings":"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"}

package/dist/helpers/native/arrayHelpers.js

@@ -109,7 +109,7 @@ export const arrayHelpers = {
         if (index === -1)
             return [...array];
         const result = [...array];
-        result.splice(index, 1, ...newItems);
+        result.splice(index, 1, ...newItems); // TODO: This doesn't work for indexes out of bound. We may do it the old manual way!
         return result;
     },
     mapFind(array, mapper, predicate) {