ts-data-forge 5.0.1 → 5.1.0

package/dist/json/json.d.mts

@@ -16,12 +16,15 @@ export declare namespace Json {
      *
      * ```ts
      * const validJson = '{"name": "Alice", "age": 30}';
+     *
      * const invalidJson = '{invalid json}';
      *
      * const parsed = Json.parse(validJson);
+     *
      * const failed = Json.parse(invalidJson);
      *
      * assert.ok(Result.isOk(parsed));
+     *
      * if (Result.isOk(parsed)) {
      *   assert.deepStrictEqual(parsed.value, { name: 'Alice', age: 30 });
      * }
@@ -30,10 +33,12 @@ export declare namespace Json {
      *
      * // With reviver
      * const jsonWithDate = '{"created": "2024-01-01T00:00:00.000Z"}';
+     *
      * const withReviver = Json.parse(jsonWithDate, (key, value) => {
      *   if (key === 'created' && typeof value === 'string') {
      *     return new Date(value);
      *   }
+     *
      *   return value;
      * });
      *
@@ -69,22 +74,27 @@ export declare namespace Json {
      *
      * // Basic stringify
      * const basic = Json.stringify(data);
+     *
      * assert.ok(Result.isOk(basic));
+     *
      * if (Result.isOk(basic)) {
      *   assert(basic.value === '{"name":"Bob","age":25,"active":true}');
      * }
      *
      * // With formatting
      * const formatted = Json.stringify(data, undefined, 2);
+     *
      * assert.ok(Result.isOk(formatted));
      *
      * // With replacer
      * const filtered = Json.stringify(data, (key, value) => {
      *   if (key === 'age') return undefined; // omit age field
+     *
      *   return value;
      * });
      *
      * assert.ok(Result.isOk(filtered));
+     *
      * if (Result.isOk(filtered)) {
      *   assert(isString(filtered.value));
      *
@@ -137,21 +147,26 @@ export declare namespace Json {
      * const safeJson = Json.stringifySelected(user, ['id', 'name', 'role']);
      *
      * assert.ok(Result.isOk(safeJson));
+     *
      * if (Result.isOk(safeJson)) {
      *   assert(isString(safeJson.value));
      *
      *   const parsed: unknown = JSON.parse(safeJson.value);
+     *
      *   assert.deepStrictEqual(parsed, {
      *     id: 1,
      *     name: 'Charlie',
      *     role: 'admin',
      *   });
+     *
      *   assert.ok(!safeJson.value.includes('password'));
+     *
      *   assert.ok(!safeJson.value.includes('email'));
      * }
      *
      * // With formatting
      * const formatted = Json.stringifySelected(user, ['id', 'name'], 2);
+     *
      * assert.ok(Result.isOk(formatted));
      * ```
      *
@@ -202,16 +217,20 @@ export declare namespace Json {
      * const sorted = Json.stringifySortedKey(unorderedData);
      *
      * assert.ok(Result.isOk(sorted));
+     *
      * if (Result.isOk(sorted)) {
      *   // Keys should appear in alphabetical order
      *   const expected =
      *     '{"apple":2,"mango":3,"nested":{"alpha":"a","beta":"b","zulu":"z"},"zebra":1}';
+     *
      *   assert(sorted.value === expected);
      * }
      *
      * // With formatting
      * const formatted = Json.stringifySortedKey(unorderedData, 2);
+     *
      * assert.ok(Result.isOk(formatted));
+     *
      * if (Result.isOk(formatted)) {
      *   assert(isString(formatted.value));
      *
@@ -219,9 +238,11 @@ export declare namespace Json {
      *   assert.ok(
      *     formatted.value.indexOf('"apple"') < formatted.value.indexOf('"mango"'),
      *   );
+     *
      *   assert.ok(
      *     formatted.value.indexOf('"mango"') < formatted.value.indexOf('"nested"'),
      *   );
+     *
      *   assert.ok(
      *     formatted.value.indexOf('"nested"') < formatted.value.indexOf('"zebra"'),
      *   );

package/dist/json/json.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"json.d.mts","sourceRoot":"","sources":["../../src/json/json.mts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,yBAAiB,IAAI,CAAC;IACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+CG;IACI,MAAM,KAAK,GAChB,MAAM,MAAM,EACZ,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,OAAO,KAClE,MAAM,CAAC,SAAS,EAAE,MAAM,CAa1B,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACI,MAAM,SAAS,GACpB,OAAO,OAAO,EACd,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,EAChE,QAAQ,kBAAkB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,KACzC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,CAOnC,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;IACI,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,yBAAyB,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACrD,QAAQ,kBAAkB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,KACzC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,CASnC,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoEG;IACI,MAAM,kBAAkB,GAC7B,OAAO,aAAa,EACpB,QAAQ,kBAAkB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,KACzC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,CAMnC,CAAC;CACH"}
+{"version":3,"file":"json.d.mts","sourceRoot":"","sources":["../../src/json/json.mts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,yBAAiB,IAAI,CAAC;IACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACI,MAAM,KAAK,GAChB,MAAM,MAAM,EACZ,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,OAAO,KAClE,MAAM,CAAC,SAAS,EAAE,MAAM,CAc1B,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+DG;IACI,MAAM,SAAS,GACpB,OAAO,OAAO,EACd,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,EAChE,QAAQ,kBAAkB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,KACzC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,CAQnC,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgEG;IACI,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,yBAAyB,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACrD,QAAQ,kBAAkB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,KACzC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,CAUnC,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0EG;IACI,MAAM,kBAAkB,GAC7B,OAAO,aAAa,EACpB,QAAQ,kBAAkB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,KACzC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,CAMnC,CAAC;CACH"}

package/dist/json/json.mjs

@@ -60,12 +60,15 @@ var Json;
      *
      * ```ts
      * const validJson = '{"name": "Alice", "age": 30}';
+     *
      * const invalidJson = '{invalid json}';
      *
      * const parsed = Json.parse(validJson);
+     *
      * const failed = Json.parse(invalidJson);
      *
      * assert.ok(Result.isOk(parsed));
+     *
      * if (Result.isOk(parsed)) {
      *   assert.deepStrictEqual(parsed.value, { name: 'Alice', age: 30 });
      * }
@@ -74,10 +77,12 @@ var Json;
      *
      * // With reviver
      * const jsonWithDate = '{"created": "2024-01-01T00:00:00.000Z"}';
+     *
      * const withReviver = Json.parse(jsonWithDate, (key, value) => {
      *   if (key === 'created' && typeof value === 'string') {
      *     return new Date(value);
      *   }
+     *
      *   return value;
      * });
      *
@@ -123,22 +128,27 @@ var Json;
      *
      * // Basic stringify
      * const basic = Json.stringify(data);
+     *
      * assert.ok(Result.isOk(basic));
+     *
      * if (Result.isOk(basic)) {
      *   assert(basic.value === '{"name":"Bob","age":25,"active":true}');
      * }
      *
      * // With formatting
      * const formatted = Json.stringify(data, undefined, 2);
+     *
      * assert.ok(Result.isOk(formatted));
      *
      * // With replacer
      * const filtered = Json.stringify(data, (key, value) => {
      *   if (key === 'age') return undefined; // omit age field
+     *
      *   return value;
      * });
      *
      * assert.ok(Result.isOk(filtered));
+     *
      * if (Result.isOk(filtered)) {
      *   assert(isString(filtered.value));
      *
@@ -199,21 +209,26 @@ var Json;
      * const safeJson = Json.stringifySelected(user, ['id', 'name', 'role']);
      *
      * assert.ok(Result.isOk(safeJson));
+     *
      * if (Result.isOk(safeJson)) {
      *   assert(isString(safeJson.value));
      *
      *   const parsed: unknown = JSON.parse(safeJson.value);
+     *
      *   assert.deepStrictEqual(parsed, {
      *     id: 1,
      *     name: 'Charlie',
      *     role: 'admin',
      *   });
+     *
      *   assert.ok(!safeJson.value.includes('password'));
+     *
      *   assert.ok(!safeJson.value.includes('email'));
      * }
      *
      * // With formatting
      * const formatted = Json.stringifySelected(user, ['id', 'name'], 2);
+     *
      * assert.ok(Result.isOk(formatted));
      * ```
      *
@@ -272,16 +287,20 @@ var Json;
      * const sorted = Json.stringifySortedKey(unorderedData);
      *
      * assert.ok(Result.isOk(sorted));
+     *
      * if (Result.isOk(sorted)) {
      *   // Keys should appear in alphabetical order
      *   const expected =
      *     '{"apple":2,"mango":3,"nested":{"alpha":"a","beta":"b","zulu":"z"},"zebra":1}';
+     *
      *   assert(sorted.value === expected);
      * }
      *
      * // With formatting
      * const formatted = Json.stringifySortedKey(unorderedData, 2);
+     *
      * assert.ok(Result.isOk(formatted));
+     *
      * if (Result.isOk(formatted)) {
      *   assert(isString(formatted.value));
      *
@@ -289,9 +308,11 @@ var Json;
      *   assert.ok(
      *     formatted.value.indexOf('"apple"') < formatted.value.indexOf('"mango"'),
      *   );
+     *
      *   assert.ok(
      *     formatted.value.indexOf('"mango"') < formatted.value.indexOf('"nested"'),
      *   );
+     *
      *   assert.ok(
      *     formatted.value.indexOf('"nested"') < formatted.value.indexOf('"zebra"'),
      *   );

package/dist/json/json.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"json.mjs","sources":["../../src/json/json.mts"],"sourcesContent":[null],"names":["Result.ok","Result.err","Arr.uniq"],"mappings":"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"}
+{"version":3,"file":"json.mjs","sources":["../../src/json/json.mts"],"sourcesContent":[null],"names":["Result.ok","Result.err","Arr.uniq"],"mappings":"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"}

package/dist/number/branded-types/int.d.mts

@@ -10,7 +10,9 @@ import { TsDataForgeInternals } from '../refined-number-utils.mjs';
  *
  * ```ts
  * assert.ok(isInt(5));
+ *
  * assert.notOk(isInt(5.25));
+ *
  * assert.ok(Int.is(-10));
  * ```
  *
@@ -31,6 +33,7 @@ export declare const isInt: (a: number) => a is Int;
  * const branded = asInt(42);
  *
  * assert(branded === 42);
+ *
  * assert.ok(Int.is(branded));
  * ```
  *
@@ -64,7 +67,9 @@ export declare const Int: {
      *
      * ```ts
      * assert.ok(isInt(5));
+     *
      * assert.notOk(isInt(5.25));
+     *
      * assert.ok(Int.is(-10));
      * ```
      *
@@ -84,9 +89,11 @@ export declare const Int: {
      *
      * ```ts
      * const negative = asInt(-12);
+     *
      * const absolute = Int.abs(negative);
      *
      * assert(absolute === 12);
+     *
      * assert.ok(Int.is(absolute));
      * ```
      *
@@ -134,10 +141,13 @@ export declare const Int: {
      *
      * ```ts
      * const min = asInt(1);
+     *
      * const max = asInt(6);
+     *
      * const randomValue = Int.random(min, max);
      *
      * assert.ok(Int.is(randomValue));
+     *
      * assert.ok(randomValue >= 1 && randomValue <= 6);
      * ```
      *
@@ -153,7 +163,9 @@ export declare const Int: {
      *
      * ```ts
      * const base = asInt(2);
+     *
      * const exponent = asInt(5);
+     *
      * const power = Int.pow(base, exponent);
      *
      * assert(power === 32);
@@ -222,7 +234,9 @@ export declare const Int: {
      *
      * ```ts
      * const dividend = asInt(17);
+     *
      * const divisor = asInt(5);
+     *
      * const quotient = Int.div(dividend, divisor);
      *
      * assert(quotient === 3);

package/dist/number/branded-types/int.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"int.d.mts","sourceRoot":"","sources":["../../../src/number/branded-types/int.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AA6BnE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,KAAK,yBAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,KAAK;;;;;;MAAW,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG;IACd;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;IAGH;;;;;;;;;;;;;OAaG;;IAGH;;;;;;;;;;;;;OAaG;;IAGH;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;;;;;;;;CAEK,CAAC"}
+{"version":3,"file":"int.d.mts","sourceRoot":"","sources":["../../../src/number/branded-types/int.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AA6BnE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,KAAK,yBAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,KAAK;;;;;;MAAW,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG;IACd;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;;;;;;OAqBG;;IAGH;;;;;;;;;;;;;OAaG;;IAGH;;;;;;;;;;;;;OAaG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;OAuBG;;IAGH;;;;;;;;;;;;;;;;;;OAkBG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;;;;;;;OAqBG;;;;;;;;;CAEK,CAAC"}

package/dist/number/branded-types/int.mjs

@@ -18,7 +18,9 @@ const { abs, add, castType, div, is, max: max_, min: min_, mul, pow, random, sub
  *
  * ```ts
  * assert.ok(isInt(5));
+ *
  * assert.notOk(isInt(5.25));
+ *
  * assert.ok(Int.is(-10));
  * ```
  *
@@ -39,6 +41,7 @@ const isInt = is;
  * const branded = asInt(42);
  *
  * assert(branded === 42);
+ *
  * assert.ok(Int.is(branded));
  * ```
  *
@@ -66,7 +69,9 @@ const Int = {
      *
      * ```ts
      * assert.ok(isInt(5));
+     *
      * assert.notOk(isInt(5.25));
+     *
      * assert.ok(Int.is(-10));
      * ```
      *
@@ -86,9 +91,11 @@ const Int = {
      *
      * ```ts
      * const negative = asInt(-12);
+     *
      * const absolute = Int.abs(negative);
      *
      * assert(absolute === 12);
+     *
      * assert.ok(Int.is(absolute));
      * ```
      *
@@ -136,10 +143,13 @@ const Int = {
      *
      * ```ts
      * const min = asInt(1);
+     *
      * const max = asInt(6);
+     *
      * const randomValue = Int.random(min, max);
      *
      * assert.ok(Int.is(randomValue));
+     *
      * assert.ok(randomValue >= 1 && randomValue <= 6);
      * ```
      *
@@ -155,7 +165,9 @@ const Int = {
      *
      * ```ts
      * const base = asInt(2);
+     *
      * const exponent = asInt(5);
+     *
      * const power = Int.pow(base, exponent);
      *
      * assert(power === 32);
@@ -224,7 +236,9 @@ const Int = {
      *
      * ```ts
      * const dividend = asInt(17);
+     *
      * const divisor = asInt(5);
+     *
      * const quotient = Int.div(dividend, divisor);
      *
      * assert(quotient === 3);

package/dist/number/branded-types/int.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"int.mjs","sources":["../../../src/number/branded-types/int.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA,MAAM,iBAAiB,GAAG,YAAY;AAEtC,MAAM,EACJ,GAAG,EACH,GAAG,EACH,QAAQ,EACR,GAAG,EACH,EAAE,EACF,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,IAAI,EACT,GAAG,EACH,GAAG,EACH,MAAM,EACN,GAAG,GACJ,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,mBAAmB,CAI7D;AACA,IAAA,oBAAoB,EAAE,SAAS;AAC/B,IAAA,SAAS,EAAE,CAAC,MAAM,CAAC,SAAS;IAC5B,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,iBAAiB;AACT,CAAA,CAAC;AAEX;;;;;;;;;;;;;;;;;AAiBG;AACI,MAAM,KAAK,GAAG;AAErB;;;;;;;;;;;;;;;;;;;AAmBG;AACI,MAAM,KAAK,GAAG;AAErB;;;;;;;;;;AAUG;AACI,MAAM,GAAG,GAAG;AACjB;;;;;;;;;;;;;;AAcG;IACH,EAAE;AAEF;;;;;;;;;;;;;;;;;;;AAmBG;IACH,GAAG;AAEH;;;;;;;;;;;;;AAaG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;;;;;;;;AAaG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;;;;;;;;;;;;;;;AAoBG;IACH,MAAM;AAEN;;;;;;;;;;;;;;;;AAgBG;IACH,GAAG;AAEH;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;;;;;;AAmBG;IACH,GAAG;;;;;"}
+{"version":3,"file":"int.mjs","sources":["../../../src/number/branded-types/int.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA,MAAM,iBAAiB,GAAG,YAAY;AAEtC,MAAM,EACJ,GAAG,EACH,GAAG,EACH,QAAQ,EACR,GAAG,EACH,EAAE,EACF,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,IAAI,EACT,GAAG,EACH,GAAG,EACH,MAAM,EACN,GAAG,GACJ,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,mBAAmB,CAI7D;AACA,IAAA,oBAAoB,EAAE,SAAS;AAC/B,IAAA,SAAS,EAAE,CAAC,MAAM,CAAC,SAAS;IAC5B,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,iBAAiB;AACT,CAAA,CAAC;AAEX;;;;;;;;;;;;;;;;;;;AAmBG;AACI,MAAM,KAAK,GAAG;AAErB;;;;;;;;;;;;;;;;;;;;AAoBG;AACI,MAAM,KAAK,GAAG;AAErB;;;;;;;;;;AAUG;AACI,MAAM,GAAG,GAAG;AACjB;;;;;;;;;;;;;;;;AAgBG;IACH,EAAE;AAEF;;;;;;;;;;;;;;;;;;;;;AAqBG;IACH,GAAG;AAEH;;;;;;;;;;;;;AAaG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;;;;;;;;AAaG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;;;;;;;;;;;;;;;;;;AAuBG;IACH,MAAM;AAEN;;;;;;;;;;;;;;;;;;AAkBG;IACH,GAAG;AAEH;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;;;;;;;;AAqBG;IACH,GAAG;;;;;"}

package/dist/number/branded-types/non-zero-safe-int.mjs

@@ -4,9 +4,9 @@ const typeNameInMessage = 'a non-zero safe integer';
 const { MAX_VALUE, MIN_VALUE, abs, add, castType, clamp, div, is, max: max_, min: min_, mul, pow, randomNonZero: random, sub, } = TsDataForgeInternals.RefinedNumberUtils.operatorsForInteger({
     integerOrSafeInteger: 'SafeInteger',
     nonZero: true,
-    // eslint-disable-next-line total-functions/no-unsafe-type-assertion
+    // eslint-disable-next-line total-functions/no-unsafe-type-assertion, math/prefer-number-min-safe-integer
     MIN_VALUE: Number.MIN_SAFE_INTEGER,
-    // eslint-disable-next-line total-functions/no-unsafe-type-assertion
+    // eslint-disable-next-line total-functions/no-unsafe-type-assertion, math/prefer-number-max-safe-integer
     MAX_VALUE: Number.MAX_SAFE_INTEGER,
     typeNameInMessage,
 });

package/dist/number/branded-types/positive-int.d.mts

@@ -8,7 +8,9 @@
  *
  * ```ts
  * assert.ok(isPositiveInt(5));
+ *
  * assert.notOk(isPositiveInt(0));
+ *
  * assert.ok(PositiveInt.is(10));
  * ```
  *
@@ -29,6 +31,7 @@ export declare const isPositiveInt: (a: number) => a is PositiveInt;
  * const branded = asPositiveInt(7);
  *
  * assert(branded === 7);
+ *
  * assert.ok(PositiveInt.is(branded));
  * ```
  *
@@ -73,7 +76,9 @@ export declare const PositiveInt: {
      *
      * ```ts
      * assert.ok(isPositiveInt(5));
+     *
      * assert.notOk(isPositiveInt(0));
+     *
      * assert.ok(PositiveInt.is(10));
      * ```
      *
@@ -139,9 +144,11 @@ export declare const PositiveInt: {
      *
      * ```ts
      * const belowRange = PositiveInt.clamp(0);
+     *
      * const withinRange = PositiveInt.clamp(10);
      *
      * assert(belowRange === 1);
+     *
      * assert(withinRange === 10);
      * ```
      *
@@ -159,10 +166,13 @@ export declare const PositiveInt: {
      *
      * ```ts
      * const min = asPositiveInt(3);
+     *
      * const max = asPositiveInt(6);
+     *
      * const randomValue = PositiveInt.random(min, max);
      *
      * assert.ok(PositiveInt.is(randomValue));
+     *
      * assert.ok(randomValue >= 3 && randomValue <= 6);
      * ```
      *
@@ -179,7 +189,9 @@ export declare const PositiveInt: {
      *
      * ```ts
      * const base = asPositiveInt(2);
+     *
      * const exponent = asPositiveInt(4);
+     *
      * const power = PositiveInt.pow(base, exponent);
      *
      * assert(power === 16);
@@ -253,9 +265,11 @@ export declare const PositiveInt: {
      *
      * ```ts
      * const quotient = PositiveInt.div(asPositiveInt(9), asPositiveInt(2));
+     *
      * const clamped = PositiveInt.div(asPositiveInt(3), asPositiveInt(10));
      *
      * assert(quotient === 4);
+     *
      * assert(clamped === 1);
      * ```
      *

package/dist/number/branded-types/positive-int.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"positive-int.d.mts","sourceRoot":"","sources":["../../../src/number/branded-types/positive-int.mts"],"names":[],"mappings":"AA+BA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,iCAAK,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;MAAW,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW;IACtB;;;;;;;;;;;;;;OAcG;;IAGH;;;;OAIG;;IAGH;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;;;;;OAkBG;;IAGH;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;;;;;;;OAqBG;;;;;;;;;;;;;;CAEK,CAAC"}
+{"version":3,"file":"positive-int.d.mts","sourceRoot":"","sources":["../../../src/number/branded-types/positive-int.mts"],"names":[],"mappings":"AA+BA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,aAAa,iCAAK,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;MAAW,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW;IACtB;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;OAIG;;IAGH;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;OAuBG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;OAuBG;;;;;;;;;;;;;;CAEK,CAAC"}

package/dist/number/branded-types/positive-int.mjs

@@ -17,7 +17,9 @@ const { MIN_VALUE, add, castType, clamp, div, is, max: max_, min: min_, mul, pow
  *
  * ```ts
  * assert.ok(isPositiveInt(5));
+ *
  * assert.notOk(isPositiveInt(0));
+ *
  * assert.ok(PositiveInt.is(10));
  * ```
  *
@@ -38,6 +40,7 @@ const isPositiveInt = is;
  * const branded = asPositiveInt(7);
  *
  * assert(branded === 7);
+ *
  * assert.ok(PositiveInt.is(branded));
  * ```
  *
@@ -70,7 +73,9 @@ const PositiveInt = {
      *
      * ```ts
      * assert.ok(isPositiveInt(5));
+     *
      * assert.notOk(isPositiveInt(0));
+     *
      * assert.ok(PositiveInt.is(10));
      * ```
      *
@@ -136,9 +141,11 @@ const PositiveInt = {
      *
      * ```ts
      * const belowRange = PositiveInt.clamp(0);
+     *
      * const withinRange = PositiveInt.clamp(10);
      *
      * assert(belowRange === 1);
+     *
      * assert(withinRange === 10);
      * ```
      *
@@ -156,10 +163,13 @@ const PositiveInt = {
      *
      * ```ts
      * const min = asPositiveInt(3);
+     *
      * const max = asPositiveInt(6);
+     *
      * const randomValue = PositiveInt.random(min, max);
      *
      * assert.ok(PositiveInt.is(randomValue));
+     *
      * assert.ok(randomValue >= 3 && randomValue <= 6);
      * ```
      *
@@ -176,7 +186,9 @@ const PositiveInt = {
      *
      * ```ts
      * const base = asPositiveInt(2);
+     *
      * const exponent = asPositiveInt(4);
+     *
      * const power = PositiveInt.pow(base, exponent);
      *
      * assert(power === 16);
@@ -250,9 +262,11 @@ const PositiveInt = {
      *
      * ```ts
      * const quotient = PositiveInt.div(asPositiveInt(9), asPositiveInt(2));
+     *
      * const clamped = PositiveInt.div(asPositiveInt(3), asPositiveInt(10));
      *
      * assert(quotient === 4);
+     *
      * assert(clamped === 1);
      * ```
      *

package/dist/number/branded-types/positive-int.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"positive-int.mjs","sources":["../../../src/number/branded-types/positive-int.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA,MAAM,iBAAiB,GAAG,oBAAoB;AAE9C,MAAM,EACJ,SAAS,EACT,GAAG,EACH,QAAQ,EACR,KAAK,EACL,GAAG,EACH,EAAE,EACF,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,IAAI,EACT,GAAG,EACH,GAAG,EACH,MAAM,EACN,GAAG,GACJ,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,mBAAmB,CAI7D;AACA,IAAA,oBAAoB,EAAE,SAAS;AAC/B,IAAA,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,iBAAiB;AACT,CAAA,CAAC;AAEX;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,aAAa,GAAG;AAE7B;;;;;;;;;;;;;;;;;;;AAmBG;AACI,MAAM,aAAa,GAAG;AAE7B;;;;;;;;;;;;;;;AAeG;AACI,MAAM,WAAW,GAAG;AACzB;;;;;;;;;;;;;;AAcG;IACH,EAAE;AAEF;;;;AAIG;IACH,SAAS;AAET;;;;;;;;;;;;;;;;;;;;AAoBG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;;;;;;;;;;;;AAiBG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;;;;;;;;;;;;;AAkBG;IACH,KAAK;AAEL;;;;;;;;;;;;;;;;;;;;AAoBG;IACH,MAAM;AAEN;;;;;;;;;;;;;;;;;AAiBG;IACH,GAAG;AAEH;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;;;;AAiBG;IACH,GAAG;AAEH;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;;;;;;;;AAqBG;IACH,GAAG;;;;;"}
+{"version":3,"file":"positive-int.mjs","sources":["../../../src/number/branded-types/positive-int.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA,MAAM,iBAAiB,GAAG,oBAAoB;AAE9C,MAAM,EACJ,SAAS,EACT,GAAG,EACH,QAAQ,EACR,KAAK,EACL,GAAG,EACH,EAAE,EACF,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,IAAI,EACT,GAAG,EACH,GAAG,EACH,MAAM,EACN,GAAG,GACJ,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,mBAAmB,CAI7D;AACA,IAAA,oBAAoB,EAAE,SAAS;AAC/B,IAAA,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,iBAAiB;AACT,CAAA,CAAC;AAEX;;;;;;;;;;;;;;;;;;AAkBG;AACI,MAAM,aAAa,GAAG;AAE7B;;;;;;;;;;;;;;;;;;;;AAoBG;AACI,MAAM,aAAa,GAAG;AAE7B;;;;;;;;;;;;;;;AAeG;AACI,MAAM,WAAW,GAAG;AACzB;;;;;;;;;;;;;;;;AAgBG;IACH,EAAE;AAEF;;;;AAIG;IACH,SAAS;AAET;;;;;;;;;;;;;;;;;;;;AAoBG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;;;;;;;;;;;;AAiBG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;;;;;;;;;;;;;;;AAoBG;IACH,KAAK;AAEL;;;;;;;;;;;;;;;;;;;;;;;AAuBG;IACH,MAAM;AAEN;;;;;;;;;;;;;;;;;;;AAmBG;IACH,GAAG;AAEH;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;;;;AAiBG;IACH,GAAG;AAEH;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;;;;;;;;;;AAuBG;IACH,GAAG;;;;;"}