ts-data-forge 6.2.2 → 6.3.0

package/dist/entry-point.mjs

@@ -57,6 +57,7 @@ export { TsDataForgeInternals } from './number/refined-number-utils.mjs';
 export { Obj } from './object/object.mjs';
 export { castDeepMutable, castMutable } from './others/cast-mutable.mjs';
 export { castDeepReadonly, castReadonly } from './others/cast-readonly.mjs';
+export { debounce } from './others/debounce-function.mjs';
 export { ifThen } from './others/if-then.mjs';
 export { mapNullable } from './others/map-nullable.mjs';
 export { memoizeFunction } from './others/memoize-function.mjs';

package/dist/entry-point.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"entry-point.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"entry-point.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/functional/optional/impl/optional-expect-to-be.d.mts

@@ -14,7 +14,11 @@ import { type Unwrap } from './types.mjs';
  *
  * const expectValue = Optional.expectToBe<string>('missing optional');
  *
- * assert.throws(() => expectValue(Optional.none), /missing optional/u);
+ * const throwTest = (): void => {
+ *   expectValue(Optional.none);
+ * };
+ *
+ * assert.throws(throwTest, /missing optional/u);
  *
  * assert.isTrue(expectValue(Optional.some('present')) === 'present');
  * ```

package/dist/functional/optional/impl/optional-expect-to-be.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"optional-expect-to-be.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-expect-to-be.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,eAAe,EAClD,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,CAAC,CAAC,CAAC;AAGb,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"optional-expect-to-be.d.mts","sourceRoot":"","sources":["../../../../src/functional/optional/impl/optional-expect-to-be.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,eAAe,EAClD,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,CAAC,CAAC,CAAC;AAGb,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC"}

package/dist/functional/optional/impl/optional-expect-to-be.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"optional-expect-to-be.mjs","sources":["../../../../src/functional/optional/impl/optional-expect-to-be.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAwCM,SAAU,UAAU,CACxB,GAAG,IAA0E,EAAA;AAE7E,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI;AAEhC,YAAA,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC1C;QAEA,KAAK,CAAC,EAAE;;AAEN,YAAA,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;YAEtB,OAAO,CAAC,QAA6B,KACnC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC;QACrC;;AAEJ;AAEA,MAAM,cAAc,GAAG,CACrB,QAAW,EACX,OAAe,KACF;AACb,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE;AACpB,QAAA,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB;AAEA,IAAA,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;AAC1B,CAAC;;;;"}
+{"version":3,"file":"optional-expect-to-be.mjs","sources":["../../../../src/functional/optional/impl/optional-expect-to-be.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AA4CM,SAAU,UAAU,CACxB,GAAG,IAA0E,EAAA;AAE7E,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI;AAEhC,YAAA,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC1C;QAEA,KAAK,CAAC,EAAE;;AAEN,YAAA,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;YAEtB,OAAO,CAAC,QAA6B,KACnC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC;QACrC;;AAEJ;AAEA,MAAM,cAAc,GAAG,CACrB,QAAW,EACX,OAAe,KACF;AACb,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE;AACpB,QAAA,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB;AAEA,IAAA,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;AAC1B,CAAC;;;;"}

package/dist/functional/result/impl/result-expect-to-be.d.mts

@@ -12,7 +12,11 @@ import { type UnwrapOk } from './types.mjs';
  *
  * const expectResult = Result.expectToBe<string>('missing result');
  *
- * assert.throws(() => expectResult(Result.err('boom')), /missing result/u);
+ * const throwTest = (): void => {
+ *   expectResult(Result.err('boom'));
+ * };
+ *
+ * assert.throws(throwTest, /missing result/u);
  *
  * assert.isTrue(expectResult(Result.ok('value')) === 'value');
  * ```

package/dist/functional/result/impl/result-expect-to-be.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"result-expect-to-be.d.mts","sourceRoot":"","sources":["../../../../src/functional/result/impl/result-expect-to-be.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,aAAa,EAChD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,CAAC,CAAC,CAAC;AAGf,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"result-expect-to-be.d.mts","sourceRoot":"","sources":["../../../../src/functional/result/impl/result-expect-to-be.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,aAAa,EAChD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,CAAC,CAAC,CAAC;AAGf,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC"}

package/dist/functional/result/impl/result-expect-to-be.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"result-expect-to-be.mjs","sources":["../../../../src/functional/result/impl/result-expect-to-be.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAoCM,SAAU,UAAU,CACxB,GAAG,IAAwE,EAAA;AAE3E,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;;AAEN,YAAA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;AAE9B,YAAA,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;QACxC;QAEA,KAAK,CAAC,EAAE;;AAEN,YAAA,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;YAEtB,OAAO,CAAC,MAAS,KAAkB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;QACpE;;AAEJ;AAEA,MAAM,cAAc,GAAG,CACrB,MAAS,EACT,OAAe,KACA;AACf,IAAA,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE;AAChB,QAAA,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB;AAEA,IAAA,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;AAC1B,CAAC;;;;"}
+{"version":3,"file":"result-expect-to-be.mjs","sources":["../../../../src/functional/result/impl/result-expect-to-be.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAwCM,SAAU,UAAU,CACxB,GAAG,IAAwE,EAAA;AAE3E,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;;AAEN,YAAA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;AAE9B,YAAA,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;QACxC;QAEA,KAAK,CAAC,EAAE;;AAEN,YAAA,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;YAEtB,OAAO,CAAC,MAAS,KAAkB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;QACpE;;AAEJ;AAEA,MAAM,cAAc,GAAG,CACrB,MAAS,EACT,OAAe,KACA;AACf,IAAA,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE;AAChB,QAAA,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB;AAEA,IAAA,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;AAC1B,CAAC;;;;"}

package/dist/functional/ternary-result/impl/ternary-result-expect-to-be.d.mts

@@ -11,10 +11,11 @@ import { type UnwrapOk } from './types.mjs';
  *
  * const expectResult = TernaryResult.expectToBe<string>('needs value');
  *
- * assert.throws(
- *   () => expectResult(TernaryResult.err('oops')),
- *   /needs value/u,
- * );
+ * const throwTest = (): void => {
+ *   expectResult(TernaryResult.err('oops'));
+ * };
+ *
+ * assert.throws(throwTest, /needs value/u);
  * ```
  */
 export declare function expectToBe<R extends UnknownTernaryResult>(result: R, message: string): UnwrapOk<R>;

package/dist/functional/ternary-result/impl/ternary-result-expect-to-be.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ternary-result-expect-to-be.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-expect-to-be.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,oBAAoB,EACvD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,CAAC,CAAC,CAAC;AAGf,wBAAgB,UAAU,CAAC,CAAC,EAC1B,OAAO,EAAE,MAAM,GACd,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"ternary-result-expect-to-be.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-expect-to-be.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,oBAAoB,EACvD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,CAAC,CAAC,CAAC;AAGf,wBAAgB,UAAU,CAAC,CAAC,EAC1B,OAAO,EAAE,MAAM,GACd,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC"}

package/dist/functional/ternary-result/impl/ternary-result-expect-to-be.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ternary-result-expect-to-be.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-expect-to-be.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAgCM,SAAU,UAAU,CACxB,GAAG,IAAwE,EAAA;AAE3E,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;AAE9B,YAAA,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;QACpC;QAEA,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;YAEtB,OAAO,CAAC,MAAS,KAAK,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;QACnD;;AAEJ;AAEA,MAAM,UAAU,GAAG,CACjB,MAAS,EACT,OAAe,KACA;AACf,IAAA,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE;AAChB,QAAA,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB;AAEA,IAAA,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;AAC1B,CAAC;;;;"}
+{"version":3,"file":"ternary-result-expect-to-be.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-expect-to-be.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAiCM,SAAU,UAAU,CACxB,GAAG,IAAwE,EAAA;AAE3E,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;AAE9B,YAAA,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;QACpC;QAEA,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;YAEtB,OAAO,CAAC,MAAS,KAAK,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;QACnD;;AAEJ;AAEA,MAAM,UAAU,GAAG,CACjB,MAAS,EACT,OAAe,KACA;AACf,IAAA,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE;AAChB,QAAA,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB;AAEA,IAAA,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;AAC1B,CAAC;;;;"}

package/dist/functional/ternary-result/impl/ternary-result-unwrap-throw.d.mts

@@ -9,10 +9,11 @@ import { type UnwrapErr, type UnwrapOk, type UnwrapWarn } from './types.mjs';
  *
  * assert.strictEqual(TernaryResult.unwrapThrow(okValue), 'ready');
  *
- * assert.throws(
- *   () => TernaryResult.unwrapThrow(TernaryResult.warn('warn', 'warned')),
- *   /Expected Ok/u,
- * );
+ * const throwTest = (): void => {
+ *   TernaryResult.unwrapThrow(TernaryResult.warn('warn', 'warned'));
+ * };
+ *
+ * assert.throws(throwTest, /Expected Ok/u);
  * ```
  */
 export declare const unwrapThrow: <R extends UnknownTernaryResult>(result: R, toStr?: (value: UnwrapWarn<R> | UnwrapErr<R>) => string) => UnwrapOk<R>;

package/dist/functional/ternary-result/impl/ternary-result-unwrap-throw.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ternary-result-unwrap-throw.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-unwrap-throw.mts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,oBAAoB,EACxD,QAAQ,CAAC,EACT,QAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,MAAwB,KACvE,QAAQ,CAAC,CAAC,CAqBZ,CAAC"}
+{"version":3,"file":"ternary-result-unwrap-throw.d.mts","sourceRoot":"","sources":["../../../../src/functional/ternary-result/impl/ternary-result-unwrap-throw.mts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,oBAAoB,EACxD,QAAQ,CAAC,EACT,QAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,MAAwB,KACvE,QAAQ,CAAC,CAAC,CAqBZ,CAAC"}

package/dist/functional/ternary-result/impl/ternary-result-unwrap-throw.mjs

@@ -12,10 +12,11 @@ import { isWarn } from './ternary-result-is-warn.mjs';
  *
  * assert.strictEqual(TernaryResult.unwrapThrow(okValue), 'ready');
  *
- * assert.throws(
- *   () => TernaryResult.unwrapThrow(TernaryResult.warn('warn', 'warned')),
- *   /Expected Ok/u,
- * );
+ * const throwTest = (): void => {
+ *   TernaryResult.unwrapThrow(TernaryResult.warn('warn', 'warned'));
+ * };
+ *
+ * assert.throws(throwTest, /Expected Ok/u);
  * ```
  */
 const unwrapThrow = (result, toStr = unknownToString) => {

package/dist/functional/ternary-result/impl/ternary-result-unwrap-throw.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ternary-result-unwrap-throw.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-unwrap-throw.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;;;;AAeG;AACI,MAAM,WAAW,GAAG,CACzB,MAAS,EACT,KAAA,GAAyD,eAAe,KACzD;AACf,IAAA,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE;AACjB,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,yBAAA,EAA4B,KAAK;;AAE/B,QAAA,MAAM,CAAC,KAAqB,CAC7B,CAAA,CAAE,CACJ;IACH;AAEA,IAAA,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE;AAClB,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,0BAAA,EAA6B,KAAK;;AAEhC,QAAA,MAAM,CAAC,OAAwB,CAChC,CAAA,CAAE,CACJ;IACH;;IAGA,OAAO,MAAM,CAAC,KAAoB;AACpC;;;;"}
+{"version":3,"file":"ternary-result-unwrap-throw.mjs","sources":["../../../../src/functional/ternary-result/impl/ternary-result-unwrap-throw.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,WAAW,GAAG,CACzB,MAAS,EACT,KAAA,GAAyD,eAAe,KACzD;AACf,IAAA,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE;AACjB,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,yBAAA,EAA4B,KAAK;;AAE/B,QAAA,MAAM,CAAC,KAAqB,CAC7B,CAAA,CAAE,CACJ;IACH;AAEA,IAAA,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE;AAClB,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,0BAAA,EAA6B,KAAK;;AAEhC,QAAA,MAAM,CAAC,OAAwB,CAChC,CAAA,CAAE,CACJ;IACH;;IAGA,OAAO,MAAM,CAAC,KAAoB;AACpC;;;;"}

package/dist/index.mjs

@@ -47,6 +47,7 @@ export { TsDataForgeInternals } from './number/refined-number-utils.mjs';
 export { Obj } from './object/object.mjs';
 export { castDeepMutable, castMutable } from './others/cast-mutable.mjs';
 export { castDeepReadonly, castReadonly } from './others/cast-readonly.mjs';
+export { debounce } from './others/debounce-function.mjs';
 export { ifThen } from './others/if-then.mjs';
 export { mapNullable } from './others/map-nullable.mjs';
 export { memoizeFunction } from './others/memoize-function.mjs';

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/others/debounce-function.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Creates a debounced function that delays invoking `func` until after `waitMilliseconds`
+ * have elapsed since the last time the debounced function was invoked.
+ *
+ * @template F The type of the function to debounce.
+ * @param func The function to debounce.
+ * @param waitMilliseconds The number of milliseconds to delay.
+ * @returns The new debounced function.
+ */
+export declare const debounce: <Args extends readonly unknown[]>(func: (...args: Args) => void, waitMilliseconds: number) => ((...args: Args) => void);
+//# sourceMappingURL=debounce-function.d.mts.map

package/dist/others/debounce-function.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce-function.d.mts","sourceRoot":"","sources":["../../src/others/debounce-function.mts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,SAAS,SAAS,OAAO,EAAE,EACtD,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAC7B,kBAAkB,MAAM,KACvB,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,CAU1B,CAAC"}

package/dist/others/debounce-function.mjs

@@ -0,0 +1,21 @@
+/**
+ * Creates a debounced function that delays invoking `func` until after `waitMilliseconds`
+ * have elapsed since the last time the debounced function was invoked.
+ *
+ * @template F The type of the function to debounce.
+ * @param func The function to debounce.
+ * @param waitMilliseconds The number of milliseconds to delay.
+ * @returns The new debounced function.
+ */
+const debounce = (func, waitMilliseconds) => {
+    let mut_timeoutId;
+    return (...args) => {
+        clearTimeout(mut_timeoutId);
+        mut_timeoutId = setTimeout(() => {
+            func(...args);
+        }, waitMilliseconds);
+    };
+};
+
+export { debounce };
+//# sourceMappingURL=debounce-function.mjs.map

package/dist/others/debounce-function.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce-function.mjs","sources":["../../src/others/debounce-function.mts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;AAQG;MACU,QAAQ,GAAG,CACtB,IAA6B,EAC7B,gBAAwB,KACK;AAC7B,IAAA,IAAI,aAAwD;AAE5D,IAAA,OAAO,CAAC,GAAG,IAAU,KAAU;QAC7B,YAAY,CAAC,aAAa,CAAC;AAE3B,QAAA,aAAa,GAAG,UAAU,CAAC,MAAK;AAC9B,YAAA,IAAI,CAAC,GAAG,IAAI,CAAC;QACf,CAAC,EAAE,gBAAgB,CAAC;AACtB,IAAA,CAAC;AACH;;;;"}

package/dist/others/index.d.mts

@@ -1,5 +1,6 @@
 export * from './cast-mutable.mjs';
 export * from './cast-readonly.mjs';
+export * from './debounce-function.mjs';
 export * from './if-then.mjs';
 export * from './map-nullable.mjs';
 export * from './memoize-function.mjs';

package/dist/others/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/others/index.mts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/others/index.mts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC"}

package/dist/others/index.mjs

@@ -1,5 +1,6 @@
 export { castDeepMutable, castMutable } from './cast-mutable.mjs';
 export { castDeepReadonly, castReadonly } from './cast-readonly.mjs';
+export { debounce } from './debounce-function.mjs';
 export { ifThen } from './if-then.mjs';
 export { mapNullable } from './map-nullable.mjs';
 export { memoizeFunction } from './memoize-function.mjs';

package/dist/others/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-data-forge",
-  "version": "6.2.2",
+  "version": "6.3.0",
   "private": false,
   "keywords": [
     "typescript",
@@ -93,36 +93,36 @@
     "@semantic-release/github": "12.0.2",
     "@semantic-release/npm": "13.1.3",
     "@semantic-release/release-notes-generator": "14.1.0",
-    "@types/node": "25.0.7",
-    "@types/react": "19.2.8",
-    "@vitest/browser-playwright": "4.0.16",
-    "@vitest/coverage-v8": "4.0.16",
-    "@vitest/ui": "4.0.16",
+    "@types/node": "25.0.10",
+    "@types/react": "19.2.9",
+    "@vitest/browser-playwright": "4.0.17",
+    "@vitest/coverage-v8": "4.0.17",
+    "@vitest/ui": "4.0.17",
     "conventional-changelog-conventionalcommits": "9.1.0",
-    "cspell": "9.4.0",
+    "cspell": "9.6.0",
     "dedent": "^1.7.1",
     "eslint": "9.39.2",
-    "eslint-config-typed": "4.4.1",
-    "github-settings-as-code": "1.0.7",
+    "eslint-config-typed": "4.6.0",
+    "github-settings-as-code": "1.0.12",
     "immer": "11.1.3",
     "jiti": "2.6.1",
     "markdownlint": "0.40.0",
     "markdownlint-cli2": "0.20.0",
     "npm-run-all2": "8.0.4",
     "playwright": "1.57.0",
-    "prettier": "3.7.4",
+    "prettier": "3.8.0",
     "prettier-plugin-organize-imports": "4.3.0",
-    "prettier-plugin-packagejson": "2.5.20",
+    "prettier-plugin-packagejson": "2.5.21",
     "rollup": "4.55.1",
     "semantic-release": "25.0.2",
-    "ts-repo-utils": "8.0.2",
+    "ts-repo-utils": "8.0.3",
     "tslib": "2.8.1",
     "tsx": "4.21.0",
-    "typedoc": "0.28.15",
+    "typedoc": "0.28.16",
     "typedoc-github-theme": "0.3.1",
     "typescript": "5.9.3",
-    "vite": "7.3.0",
-    "vitest": "4.0.16"
+    "vite": "7.3.1",
+    "vitest": "4.0.17"
   },
   "peerDependencies": {
     "typescript": ">=4.8"

package/src/array/impl/array-utils-creation.test.mts

@@ -760,8 +760,10 @@ describe('Arr creations', () => {
       const result = await generateAsync<number>(async function* () {
         // eslint-disable-next-line functional/no-let
         for (let i = 0; i < 3; i++) {
-          // eslint-disable-next-line no-promise-executor-return, no-await-in-loop
-          await new Promise((resolve) => setTimeout(resolve, 0));
+          // eslint-disable-next-line no-await-in-loop
+          await new Promise<void>((resolve) => {
+            setTimeout(resolve, 0);
+          });
 
           yield i;
         }

package/src/functional/optional/impl/optional-expect-to-be.mts

@@ -17,7 +17,11 @@ import { type Unwrap } from './types.mjs';
  *
  * const expectValue = Optional.expectToBe<string>('missing optional');
  *
- * assert.throws(() => expectValue(Optional.none), /missing optional/u);
+ * const throwTest = (): void => {
+ *   expectValue(Optional.none);
+ * };
+ *
+ * assert.throws(throwTest, /missing optional/u);
  *
  * assert.isTrue(expectValue(Optional.some('present')) === 'present');
  * ```

package/src/functional/result/impl/result-expect-to-be.mts

@@ -15,7 +15,11 @@ import { type UnwrapOk } from './types.mjs';
  *
  * const expectResult = Result.expectToBe<string>('missing result');
  *
- * assert.throws(() => expectResult(Result.err('boom')), /missing result/u);
+ * const throwTest = (): void => {
+ *   expectResult(Result.err('boom'));
+ * };
+ *
+ * assert.throws(throwTest, /missing result/u);
  *
  * assert.isTrue(expectResult(Result.ok('value')) === 'value');
  * ```

package/src/functional/ternary-result/impl/ternary-result-expect-to-be.mts

@@ -14,10 +14,11 @@ import { type UnwrapOk } from './types.mjs';
  *
  * const expectResult = TernaryResult.expectToBe<string>('needs value');
  *
- * assert.throws(
- *   () => expectResult(TernaryResult.err('oops')),
- *   /needs value/u,
- * );
+ * const throwTest = (): void => {
+ *   expectResult(TernaryResult.err('oops'));
+ * };
+ *
+ * assert.throws(throwTest, /needs value/u);
  * ```
  */
 export function expectToBe<R extends UnknownTernaryResult>(

package/src/functional/ternary-result/impl/ternary-result-unwrap-throw.mts

@@ -13,10 +13,11 @@ import { type UnwrapErr, type UnwrapOk, type UnwrapWarn } from './types.mjs';
  *
  * assert.strictEqual(TernaryResult.unwrapThrow(okValue), 'ready');
  *
- * assert.throws(
- *   () => TernaryResult.unwrapThrow(TernaryResult.warn('warn', 'warned')),
- *   /Expected Ok/u,
- * );
+ * const throwTest = (): void => {
+ *   TernaryResult.unwrapThrow(TernaryResult.warn('warn', 'warned'));
+ * };
+ *
+ * assert.throws(throwTest, /Expected Ok/u);
  * ```
  */
 export const unwrapThrow = <R extends UnknownTernaryResult>(

package/src/others/debounce-function.mts

@@ -0,0 +1,23 @@
+/**
+ * Creates a debounced function that delays invoking `func` until after `waitMilliseconds`
+ * have elapsed since the last time the debounced function was invoked.
+ *
+ * @template F The type of the function to debounce.
+ * @param func The function to debounce.
+ * @param waitMilliseconds The number of milliseconds to delay.
+ * @returns The new debounced function.
+ */
+export const debounce = <Args extends readonly unknown[]>(
+  func: (...args: Args) => void,
+  waitMilliseconds: number,
+): ((...args: Args) => void) => {
+  let mut_timeoutId: ReturnType<typeof setTimeout> | undefined;
+
+  return (...args: Args): void => {
+    clearTimeout(mut_timeoutId);
+
+    mut_timeoutId = setTimeout(() => {
+      func(...args);
+    }, waitMilliseconds);
+  };
+};

package/src/others/debounce-function.test.mts

@@ -0,0 +1,81 @@
+/* eslint-disable vitest/no-restricted-vi-methods */
+
+import { debounce } from './debounce-function.mjs';
+
+describe(debounce, () => {
+  // eslint-disable-next-line vitest/no-hooks
+  beforeEach(() => {
+    vi.useFakeTimers();
+  });
+
+  // eslint-disable-next-line vitest/no-hooks
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  test('should delay the execution of the function', () => {
+    const func = vi.fn();
+
+    // eslint-disable-next-line @typescript-eslint/strict-void-return
+    const debouncedFunc = debounce(func, 100);
+
+    debouncedFunc();
+
+    expect(func).not.toHaveBeenCalled();
+
+    vi.advanceTimersByTime(50);
+
+    expect(func).not.toHaveBeenCalled();
+
+    vi.advanceTimersByTime(50);
+
+    expect(func).toHaveBeenCalledOnce();
+  });
+
+  test('should only execute the function once after multiple rapid calls', () => {
+    const func = vi.fn();
+
+    // eslint-disable-next-line @typescript-eslint/strict-void-return
+    const debouncedFunc = debounce(func, 100);
+
+    debouncedFunc();
+
+    debouncedFunc();
+
+    debouncedFunc();
+
+    expect(func).not.toHaveBeenCalled();
+
+    vi.advanceTimersByTime(100);
+
+    expect(func).toHaveBeenCalledOnce();
+  });
+
+  test('should pass the arguments to the original function', () => {
+    const func = vi.fn((_a: number, _b: string) => {});
+
+    const debouncedFunc = debounce(func, 100);
+
+    debouncedFunc(1, 'test');
+
+    vi.advanceTimersByTime(100);
+
+    expect(func).toHaveBeenCalledWith(1, 'test');
+  });
+
+  test('should use the latest arguments from the last call', () => {
+    const func = vi.fn((_a: number, _b: string) => {});
+
+    const debouncedFunc = debounce(func, 100);
+
+    debouncedFunc(1, 'a');
+
+    debouncedFunc(2, 'b');
+
+    debouncedFunc(3, 'c');
+
+    vi.advanceTimersByTime(100);
+
+    expect(func).toHaveBeenCalledExactlyOnceWith(3, 'c');
+  });
+});

package/src/others/index.mts

@@ -1,5 +1,6 @@
 export * from './cast-mutable.mjs';
 export * from './cast-readonly.mjs';
+export * from './debounce-function.mjs';
 export * from './if-then.mjs';
 export * from './map-nullable.mjs';
 export * from './memoize-function.mjs';