ts-data-forge 6.13.1 → 7.0.1

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

@@ -0,0 +1,224 @@
+import { type NonPositiveInt as TtfImported_NonPositiveInt } from 'ts-type-forge';
+export type NonPositiveInt = TtfImported_NonPositiveInt;
+/**
+ * Type guard that checks if a value is a non-positive integer.
+ *
+ * A non-positive integer is any integer less than or equal to zero (<= 0).
+ * This includes zero and all negative integers, but excludes positive numbers
+ * and non-integers.
+ *
+ * @example
+ *
+ * ```ts
+ * assert.isTrue(isNonPositiveInt(0));
+ *
+ * assert.isTrue(isNonPositiveInt(-5));
+ *
+ * assert.isFalse(isNonPositiveInt(1));
+ * ```
+ *
+ * @param value - The value to check
+ * @returns `true` if the value is a non-positive integer, `false` otherwise
+ */
+export declare const isNonPositiveInt: (a: number) => a is TtfImported_NonPositiveInt;
+/**
+ * Casts a number to a NonPositiveInt branded type.
+ *
+ * This function validates that the input is a non-positive integer (<= 0) and
+ * returns it with the NonPositiveInt brand. This ensures type safety for
+ * operations that require non-positive integer values.
+ *
+ * @example
+ *
+ * ```ts
+ * const branded = asNonPositiveInt(-7);
+ *
+ * assert.isTrue(branded === -7);
+ *
+ * assert.isTrue(NonPositiveInt.is(branded));
+ * ```
+ *
+ * @param value - The value to cast
+ * @returns The value as a NonPositiveInt branded type
+ * @throws {TypeError} If the value is not a non-positive integer
+ */
+export declare const asNonPositiveInt: <N extends number>(x: N) => number & {
+    readonly NaNValue: false;
+    readonly Finite: true;
+    readonly Int: true;
+    readonly "<=0": true;
+    readonly "< 2^15": true;
+    readonly "< 2^16": true;
+    readonly "< 2^31": true;
+    readonly "< 2^32": true;
+} & Readonly<{
+    'TSTypeForgeInternals--edd2f9ce-7ca5-45b0-9d1a-bd61b9b5d9c3': unknown;
+}> & N;
+/**
+ * Namespace providing type-safe operations for NonPositiveInt branded types.
+ *
+ * NonPositiveInt represents integers that are less than or equal to zero (<= 0).
+ * All operations automatically clamp results to maintain the non-positive
+ * constraint, ensuring that arithmetic operations never produce positive values.
+ *
+ * This type is essential for:
+ *
+ * - Debts and negative balances
+ * - Penalties and reductions
+ * - Offsets and adjustments (downward)
+ * - Negative counts or differences
+ * - Depth or altitude below a reference point
+ */
+export declare const NonPositiveInt: {
+    /**
+     * Type guard that checks if a value is a non-positive integer.
+     *
+     * @example
+     *
+     * ```ts
+     * const value: number = -42;
+     *
+     * if (NonPositiveInt.is(value)) {
+     *   // value is now typed as NonPositiveInt
+     *   const debt = value;
+     * }
+     * ```
+     *
+     * @param value - The value to check
+     * @returns `true` if the value is a non-positive integer, `false` otherwise
+     */
+    readonly is: (a: number) => a is TtfImported_NonPositiveInt;
+    /**
+     * The maximum value for a non-positive integer.
+     *
+     * @readonly
+     */
+    readonly MAX_VALUE: 0;
+    /**
+     * Returns the smaller of two non-positive integers.
+     *
+     * Since non-positive integers range from negative infinity to 0, the smaller
+     * value is the one further from zero (more negative).
+     *
+     * @example
+     *
+     * ```ts
+     * const result = NonPositiveInt.min(-5, -10);
+     *
+     * assert.strictEqual(result, -10);
+     * ```
+     *
+     * @param a - The first non-positive integer
+     * @param b - The second non-positive integer
+     * @returns The minimum value as a non-positive integer
+     */
+    readonly min: (...values: readonly import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveInt>[]) => TtfImported_NonPositiveInt;
+    /**
+     * Returns the larger of two non-positive integers.
+     *
+     * Since non-positive integers range from negative infinity to 0, the larger
+     * value is the one closer to zero (less negative).
+     *
+     * @example
+     *
+     * ```ts
+     * const result = NonPositiveInt.max(-5, -10);
+     *
+     * assert.strictEqual(result, -5);
+     * ```
+     *
+     * @param a - The first non-positive integer
+     * @param b - The second non-positive integer
+     * @returns The maximum value as a non-positive integer
+     */
+    readonly max: (...values: readonly import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveInt>[]) => TtfImported_NonPositiveInt;
+    /**
+     * Clamps a number to the non-positive integer range.
+     *
+     * Any positive value is clamped to 0 (the maximum non-positive integer).
+     * Negative values are preserved as long as they are valid integers.
+     *
+     * @example
+     *
+     * ```ts
+     * assert.strictEqual(NonPositiveInt.clamp(5), 0);
+     *
+     * assert.strictEqual(NonPositiveInt.clamp(-5), -5);
+     *
+     * assert.strictEqual(NonPositiveInt.clamp(0), 0);
+     * ```
+     *
+     * @param value - The number to clamp
+     * @returns The value clamped to the non-positive integer range
+     */
+    readonly clamp: (x: number) => TtfImported_NonPositiveInt;
+    /**
+     * Generates a random non-positive integer value.
+     *
+     * @example
+     *
+     * ```ts
+     * const randomValue = NonPositiveInt.random();
+     *
+     * assert.isTrue(NonPositiveInt.is(randomValue));
+     * ```
+     *
+     * @returns A random non-positive integer
+     */
+    readonly random: (min?: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveInt> | undefined, max?: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveInt> | undefined) => TtfImported_NonPositiveInt;
+    /**
+     * Raises a non-positive integer to the power of another non-positive integer.
+     *
+     * The result is clamped to the non-positive integer range.
+     *
+     * @example
+     *
+     * ```ts
+     * const result = NonPositiveInt.pow(-2, -1);
+     * ```
+     *
+     * @param a - The base non-positive integer
+     * @param b - The exponent non-positive integer
+     * @returns `a ** b` clamped to the non-positive integer range
+     */
+    readonly pow: (x: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveInt>, y: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveInt>) => TtfImported_NonPositiveInt;
+    /**
+     * Adds two non-positive integers.
+     *
+     * The result is clamped to the non-positive integer range. If the sum is
+     * positive, it is clamped to 0.
+     *
+     * @example
+     *
+     * ```ts
+     * assert.strictEqual(NonPositiveInt.add(-5, -3), -8);
+     *
+     * assert.strictEqual(NonPositiveInt.add(-5, 10), 0);
+     * ```
+     *
+     * @param a - The first non-positive integer
+     * @param b - The second non-positive integer
+     * @returns `a + b` clamped to the non-positive integer range
+     */
+    readonly add: (x: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveInt>, y: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveInt>) => TtfImported_NonPositiveInt;
+    /**
+     * Subtracts one non-positive integer from another.
+     *
+     * The result is clamped to the non-positive integer range. If the result is
+     * positive, it is clamped to 0.
+     *
+     * @example
+     *
+     * ```ts
+     * assert.strictEqual(NonPositiveInt.sub(-10, -3), -7);
+     *
+     * assert.strictEqual(NonPositiveInt.sub(-10, 5), 0);
+     * ```
+     *
+     * @param a - The minuend non-positive integer
+     * @param b - The subtrahend non-positive integer
+     * @returns `a - b` clamped to the non-positive integer range
+     */
+    readonly sub: (x: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveInt>, y: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveInt>) => TtfImported_NonPositiveInt;
+};
+//# sourceMappingURL=non-positive-int.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"non-positive-int.d.mts","sourceRoot":"","sources":["../../../src/number/branded-types/non-positive-int.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,IAAI,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAGlF,MAAM,MAAM,cAAc,GAAG,0BAA0B,CAAC;AA4BxD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,gDAAK,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;MAAW,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;OAIG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;;;;;OAkBG;;IAGH;;;;;;;;;;;;OAYG;;IAGH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;CAEK,CAAC"}

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

@@ -0,0 +1,222 @@
+import { TsDataForgeInternals } from '../refined-number-utils.mjs';
+
+const typeNameInMessage = 'a non-positive integer';
+const { MAX_VALUE, add, castType, clamp, is, max: max_, min: min_, pow, random, sub, } = TsDataForgeInternals.RefinedNumberUtils.operatorsForInteger({
+    integerOrSafeInteger: 'Integer',
+    MIN_VALUE: -Number.MAX_VALUE,
+    MAX_VALUE: 0,
+    typeNameInMessage,
+});
+/**
+ * Type guard that checks if a value is a non-positive integer.
+ *
+ * A non-positive integer is any integer less than or equal to zero (<= 0).
+ * This includes zero and all negative integers, but excludes positive numbers
+ * and non-integers.
+ *
+ * @example
+ *
+ * ```ts
+ * assert.isTrue(isNonPositiveInt(0));
+ *
+ * assert.isTrue(isNonPositiveInt(-5));
+ *
+ * assert.isFalse(isNonPositiveInt(1));
+ * ```
+ *
+ * @param value - The value to check
+ * @returns `true` if the value is a non-positive integer, `false` otherwise
+ */
+const isNonPositiveInt = is;
+/**
+ * Casts a number to a NonPositiveInt branded type.
+ *
+ * This function validates that the input is a non-positive integer (<= 0) and
+ * returns it with the NonPositiveInt brand. This ensures type safety for
+ * operations that require non-positive integer values.
+ *
+ * @example
+ *
+ * ```ts
+ * const branded = asNonPositiveInt(-7);
+ *
+ * assert.isTrue(branded === -7);
+ *
+ * assert.isTrue(NonPositiveInt.is(branded));
+ * ```
+ *
+ * @param value - The value to cast
+ * @returns The value as a NonPositiveInt branded type
+ * @throws {TypeError} If the value is not a non-positive integer
+ */
+const asNonPositiveInt = castType;
+/**
+ * Namespace providing type-safe operations for NonPositiveInt branded types.
+ *
+ * NonPositiveInt represents integers that are less than or equal to zero (<= 0).
+ * All operations automatically clamp results to maintain the non-positive
+ * constraint, ensuring that arithmetic operations never produce positive values.
+ *
+ * This type is essential for:
+ *
+ * - Debts and negative balances
+ * - Penalties and reductions
+ * - Offsets and adjustments (downward)
+ * - Negative counts or differences
+ * - Depth or altitude below a reference point
+ */
+const NonPositiveInt = {
+    /**
+     * Type guard that checks if a value is a non-positive integer.
+     *
+     * @example
+     *
+     * ```ts
+     * const value: number = -42;
+     *
+     * if (NonPositiveInt.is(value)) {
+     *   // value is now typed as NonPositiveInt
+     *   const debt = value;
+     * }
+     * ```
+     *
+     * @param value - The value to check
+     * @returns `true` if the value is a non-positive integer, `false` otherwise
+     */
+    is,
+    /**
+     * The maximum value for a non-positive integer.
+     *
+     * @readonly
+     */
+    MAX_VALUE,
+    /**
+     * Returns the smaller of two non-positive integers.
+     *
+     * Since non-positive integers range from negative infinity to 0, the smaller
+     * value is the one further from zero (more negative).
+     *
+     * @example
+     *
+     * ```ts
+     * const result = NonPositiveInt.min(-5, -10);
+     *
+     * assert.strictEqual(result, -10);
+     * ```
+     *
+     * @param a - The first non-positive integer
+     * @param b - The second non-positive integer
+     * @returns The minimum value as a non-positive integer
+     */
+    min: min_,
+    /**
+     * Returns the larger of two non-positive integers.
+     *
+     * Since non-positive integers range from negative infinity to 0, the larger
+     * value is the one closer to zero (less negative).
+     *
+     * @example
+     *
+     * ```ts
+     * const result = NonPositiveInt.max(-5, -10);
+     *
+     * assert.strictEqual(result, -5);
+     * ```
+     *
+     * @param a - The first non-positive integer
+     * @param b - The second non-positive integer
+     * @returns The maximum value as a non-positive integer
+     */
+    max: max_,
+    /**
+     * Clamps a number to the non-positive integer range.
+     *
+     * Any positive value is clamped to 0 (the maximum non-positive integer).
+     * Negative values are preserved as long as they are valid integers.
+     *
+     * @example
+     *
+     * ```ts
+     * assert.strictEqual(NonPositiveInt.clamp(5), 0);
+     *
+     * assert.strictEqual(NonPositiveInt.clamp(-5), -5);
+     *
+     * assert.strictEqual(NonPositiveInt.clamp(0), 0);
+     * ```
+     *
+     * @param value - The number to clamp
+     * @returns The value clamped to the non-positive integer range
+     */
+    clamp,
+    /**
+     * Generates a random non-positive integer value.
+     *
+     * @example
+     *
+     * ```ts
+     * const randomValue = NonPositiveInt.random();
+     *
+     * assert.isTrue(NonPositiveInt.is(randomValue));
+     * ```
+     *
+     * @returns A random non-positive integer
+     */
+    random,
+    /**
+     * Raises a non-positive integer to the power of another non-positive integer.
+     *
+     * The result is clamped to the non-positive integer range.
+     *
+     * @example
+     *
+     * ```ts
+     * const result = NonPositiveInt.pow(-2, -1);
+     * ```
+     *
+     * @param a - The base non-positive integer
+     * @param b - The exponent non-positive integer
+     * @returns `a ** b` clamped to the non-positive integer range
+     */
+    pow,
+    /**
+     * Adds two non-positive integers.
+     *
+     * The result is clamped to the non-positive integer range. If the sum is
+     * positive, it is clamped to 0.
+     *
+     * @example
+     *
+     * ```ts
+     * assert.strictEqual(NonPositiveInt.add(-5, -3), -8);
+     *
+     * assert.strictEqual(NonPositiveInt.add(-5, 10), 0);
+     * ```
+     *
+     * @param a - The first non-positive integer
+     * @param b - The second non-positive integer
+     * @returns `a + b` clamped to the non-positive integer range
+     */
+    add,
+    /**
+     * Subtracts one non-positive integer from another.
+     *
+     * The result is clamped to the non-positive integer range. If the result is
+     * positive, it is clamped to 0.
+     *
+     * @example
+     *
+     * ```ts
+     * assert.strictEqual(NonPositiveInt.sub(-10, -3), -7);
+     *
+     * assert.strictEqual(NonPositiveInt.sub(-10, 5), 0);
+     * ```
+     *
+     * @param a - The minuend non-positive integer
+     * @param b - The subtrahend non-positive integer
+     * @returns `a - b` clamped to the non-positive integer range
+     */
+    sub,
+};
+
+export { NonPositiveInt, asNonPositiveInt, isNonPositiveInt };
+//# sourceMappingURL=non-positive-int.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"non-positive-int.mjs","sources":["../../../src/number/branded-types/non-positive-int.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAOA,MAAM,iBAAiB,GAAG,wBAAwB;AAElD,MAAM,EACJ,SAAS,EACT,GAAG,EACH,QAAQ,EACR,KAAK,EACL,EAAE,EACF,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,IAAI,EACT,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;AAC5B,IAAA,SAAS,EAAE,CAAC;IACZ,iBAAiB;AACT,CAAA,CAAC;AAEX;;;;;;;;;;;;;;;;;;;AAmBG;AACI,MAAM,gBAAgB,GAAG;AAEhC;;;;;;;;;;;;;;;;;;;;AAoBG;AACI,MAAM,gBAAgB,GAAG;AAEhC;;;;;;;;;;;;;;AAcG;AACI,MAAM,cAAc,GAAG;AAC5B;;;;;;;;;;;;;;;;AAgBG;IACH,EAAE;AAEF;;;;AAIG;IACH,SAAS;AAET;;;;;;;;;;;;;;;;;AAiBG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;;;;;;;;;;;;AAiBG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;;;;;;;;;;;;;AAkBG;IACH,KAAK;AAEL;;;;;;;;;;;;AAYG;IACH,MAAM;AAEN;;;;;;;;;;;;;;AAcG;IACH,GAAG;AAEH;;;;;;;;;;;;;;;;;AAiBG;IACH,GAAG;AAEH;;;;;;;;;;;;;;;;;AAiBG;IACH,GAAG;;;;;"}

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

@@ -0,0 +1,119 @@
+import { type NonPositiveSafeInt as TtfImported_NonPositiveSafeInt } from 'ts-type-forge';
+export type NonPositiveSafeInt = TtfImported_NonPositiveSafeInt;
+/**
+ * Checks if a number is a NonPositiveSafeInt (non-positive safe integer in the
+ * range [Number.MIN_SAFE_INTEGER, 0]).
+ *
+ * @param value The value to check.
+ * @returns `true` if the value is a NonPositiveSafeInt, `false` otherwise.
+ */
+export declare const isNonPositiveSafeInt: (a: number) => a is TtfImported_NonPositiveSafeInt;
+/**
+ * Casts a number to a NonPositiveSafeInt type.
+ *
+ * @param value The value to cast.
+ * @returns The value as a NonPositiveSafeInt type.
+ * @throws {TypeError} If the value is not a non-positive safe integer.
+ */
+export declare const asNonPositiveSafeInt: <N extends number>(x: N) => number & {
+    readonly NaNValue: false;
+    readonly Finite: true;
+    readonly Int: true;
+    readonly "<=0": true;
+    readonly "< 2^15": true;
+    readonly "< 2^16": true;
+    readonly "< 2^31": true;
+    readonly "< 2^32": true;
+    readonly SafeInt: true;
+} & Readonly<{
+    'TSTypeForgeInternals--edd2f9ce-7ca5-45b0-9d1a-bd61b9b5d9c3': unknown;
+}> & N;
+/**
+ * Namespace providing type-safe arithmetic operations for non-positive
+ * safe integers.
+ *
+ * All operations automatically clamp results to the valid NonPositiveSafeInt
+ * range [Number.MIN_SAFE_INTEGER, 0]. This ensures that all arithmetic
+ * maintains the non-positive safe integer constraint, with positive results
+ * clamped to 0 and underflow results clamped to MIN_VALUE.
+ */
+export declare const NonPositiveSafeInt: {
+    /**
+     * Type guard to check if a value is a NonPositiveSafeInt.
+     *
+     * @param value The value to check.
+     * @returns `true` if the value is a non-positive safe integer, `false`
+     *   otherwise.
+     */
+    readonly is: (a: number) => a is TtfImported_NonPositiveSafeInt;
+    /**
+     * The minimum value for a non-positive safe integer.
+     *
+     * @readonly
+     */
+    readonly MIN_VALUE: number;
+    /**
+     * The maximum value for a non-positive safe integer.
+     *
+     * @readonly
+     */
+    readonly MAX_VALUE: 0;
+    /**
+     * Returns the smaller of two NonPositiveSafeInt values.
+     *
+     * @param a The first NonPositiveSafeInt.
+     * @param b The second NonPositiveSafeInt.
+     * @returns The minimum value as a NonPositiveSafeInt.
+     */
+    readonly min: (...values: readonly import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveSafeInt>[]) => TtfImported_NonPositiveSafeInt;
+    /**
+     * Returns the larger of two NonPositiveSafeInt values.
+     *
+     * @param a The first NonPositiveSafeInt.
+     * @param b The second NonPositiveSafeInt.
+     * @returns The maximum value as a NonPositiveSafeInt.
+     */
+    readonly max: (...values: readonly import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveSafeInt>[]) => TtfImported_NonPositiveSafeInt;
+    /**
+     * Clamps a number to the NonPositiveSafeInt range.
+     *
+     * @param value The number to clamp.
+     * @returns The value clamped to [Number.MIN_SAFE_INTEGER, 0] as a
+     *   NonPositiveSafeInt.
+     */
+    readonly clamp: (x: number) => TtfImported_NonPositiveSafeInt;
+    /**
+     * Generates a random NonPositiveSafeInt value within the valid range.
+     *
+     * @returns A random NonPositiveSafeInt between Number.MIN_SAFE_INTEGER and 0.
+     */
+    readonly random: (min?: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveSafeInt> | undefined, max?: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveSafeInt> | undefined) => TtfImported_NonPositiveSafeInt;
+    /**
+     * Raises a NonPositiveSafeInt to the power of another NonPositiveSafeInt.
+     *
+     * @param a The base NonPositiveSafeInt.
+     * @param b The exponent NonPositiveSafeInt.
+     * @returns `a ** b` clamped to [Number.MIN_SAFE_INTEGER, 0] as a
+     *   NonPositiveSafeInt.
+     */
+    readonly pow: (x: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveSafeInt>, y: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveSafeInt>) => TtfImported_NonPositiveSafeInt;
+    /**
+     * Adds two NonPositiveSafeInt values.
+     *
+     * @param a The first NonPositiveSafeInt.
+     * @param b The second NonPositiveSafeInt.
+     * @returns `a + b` clamped to [Number.MIN_SAFE_INTEGER, 0] as a
+     *   NonPositiveSafeInt.
+     */
+    readonly add: (x: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveSafeInt>, y: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveSafeInt>) => TtfImported_NonPositiveSafeInt;
+    /**
+     * Subtracts one NonPositiveSafeInt from another.
+     *
+     * @param a The minuend NonPositiveSafeInt.
+     * @param b The subtrahend NonPositiveSafeInt.
+     * @returns `a - b` clamped to [Number.MIN_SAFE_INTEGER, 0] as a
+     *   NonPositiveSafeInt (maximum 0).
+     */
+    readonly sub: (x: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveSafeInt>, y: import("ts-type-forge").WithSmallInt<TtfImported_NonPositiveSafeInt>) => TtfImported_NonPositiveSafeInt;
+};
+//# sourceMappingURL=non-positive-safe-int.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"non-positive-safe-int.d.mts","sourceRoot":"","sources":["../../../src/number/branded-types/non-positive-safe-int.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,IAAI,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAG1F,MAAM,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AA6BhE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,oDAAK,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;MAAW,CAAC;AAE7C;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;;;;;OAMG;;IAGH;;;;OAIG;;IAGH;;;;OAIG;;IAGH;;;;;;OAMG;;IAGH;;;;;;OAMG;;IAGH;;;;;;OAMG;;IAGH;;;;OAIG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;CAEK,CAAC"}

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

@@ -0,0 +1,116 @@
+import { TsDataForgeInternals } from '../refined-number-utils.mjs';
+
+const typeNameInMessage = 'a non-positive safe integer';
+const { MAX_VALUE, MIN_VALUE, add, castType, clamp, is, max: max_, min: min_, pow, random, sub, } = TsDataForgeInternals.RefinedNumberUtils.operatorsForInteger({
+    integerOrSafeInteger: 'SafeInteger',
+    MIN_VALUE: Number.MIN_SAFE_INTEGER,
+    MAX_VALUE: 0,
+    typeNameInMessage,
+});
+/**
+ * Checks if a number is a NonPositiveSafeInt (non-positive safe integer in the
+ * range [Number.MIN_SAFE_INTEGER, 0]).
+ *
+ * @param value The value to check.
+ * @returns `true` if the value is a NonPositiveSafeInt, `false` otherwise.
+ */
+const isNonPositiveSafeInt = is;
+/**
+ * Casts a number to a NonPositiveSafeInt type.
+ *
+ * @param value The value to cast.
+ * @returns The value as a NonPositiveSafeInt type.
+ * @throws {TypeError} If the value is not a non-positive safe integer.
+ */
+const asNonPositiveSafeInt = castType;
+/**
+ * Namespace providing type-safe arithmetic operations for non-positive
+ * safe integers.
+ *
+ * All operations automatically clamp results to the valid NonPositiveSafeInt
+ * range [Number.MIN_SAFE_INTEGER, 0]. This ensures that all arithmetic
+ * maintains the non-positive safe integer constraint, with positive results
+ * clamped to 0 and underflow results clamped to MIN_VALUE.
+ */
+const NonPositiveSafeInt = {
+    /**
+     * Type guard to check if a value is a NonPositiveSafeInt.
+     *
+     * @param value The value to check.
+     * @returns `true` if the value is a non-positive safe integer, `false`
+     *   otherwise.
+     */
+    is,
+    /**
+     * The minimum value for a non-positive safe integer.
+     *
+     * @readonly
+     */
+    MIN_VALUE,
+    /**
+     * The maximum value for a non-positive safe integer.
+     *
+     * @readonly
+     */
+    MAX_VALUE,
+    /**
+     * Returns the smaller of two NonPositiveSafeInt values.
+     *
+     * @param a The first NonPositiveSafeInt.
+     * @param b The second NonPositiveSafeInt.
+     * @returns The minimum value as a NonPositiveSafeInt.
+     */
+    min: min_,
+    /**
+     * Returns the larger of two NonPositiveSafeInt values.
+     *
+     * @param a The first NonPositiveSafeInt.
+     * @param b The second NonPositiveSafeInt.
+     * @returns The maximum value as a NonPositiveSafeInt.
+     */
+    max: max_,
+    /**
+     * Clamps a number to the NonPositiveSafeInt range.
+     *
+     * @param value The number to clamp.
+     * @returns The value clamped to [Number.MIN_SAFE_INTEGER, 0] as a
+     *   NonPositiveSafeInt.
+     */
+    clamp,
+    /**
+     * Generates a random NonPositiveSafeInt value within the valid range.
+     *
+     * @returns A random NonPositiveSafeInt between Number.MIN_SAFE_INTEGER and 0.
+     */
+    random,
+    /**
+     * Raises a NonPositiveSafeInt to the power of another NonPositiveSafeInt.
+     *
+     * @param a The base NonPositiveSafeInt.
+     * @param b The exponent NonPositiveSafeInt.
+     * @returns `a ** b` clamped to [Number.MIN_SAFE_INTEGER, 0] as a
+     *   NonPositiveSafeInt.
+     */
+    pow,
+    /**
+     * Adds two NonPositiveSafeInt values.
+     *
+     * @param a The first NonPositiveSafeInt.
+     * @param b The second NonPositiveSafeInt.
+     * @returns `a + b` clamped to [Number.MIN_SAFE_INTEGER, 0] as a
+     *   NonPositiveSafeInt.
+     */
+    add,
+    /**
+     * Subtracts one NonPositiveSafeInt from another.
+     *
+     * @param a The minuend NonPositiveSafeInt.
+     * @param b The subtrahend NonPositiveSafeInt.
+     * @returns `a - b` clamped to [Number.MIN_SAFE_INTEGER, 0] as a
+     *   NonPositiveSafeInt (maximum 0).
+     */
+    sub,
+};
+
+export { NonPositiveSafeInt, asNonPositiveSafeInt, isNonPositiveSafeInt };
+//# sourceMappingURL=non-positive-safe-int.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"non-positive-safe-int.mjs","sources":["../../../src/number/branded-types/non-positive-safe-int.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAOA,MAAM,iBAAiB,GAAG,6BAA6B;AAEvD,MAAM,EACJ,SAAS,EACT,SAAS,EACT,GAAG,EACH,QAAQ,EACR,KAAK,EACL,EAAE,EACF,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,IAAI,EACT,GAAG,EACH,MAAM,EACN,GAAG,GACJ,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,mBAAmB,CAI7D;AACA,IAAA,oBAAoB,EAAE,aAAa;IACnC,SAAS,EAAE,MAAM,CAAC,gBAAgB;AAClC,IAAA,SAAS,EAAE,CAAC;IACZ,iBAAiB;AACT,CAAA,CAAC;AAEX;;;;;;AAMG;AACI,MAAM,oBAAoB,GAAG;AAEpC;;;;;;AAMG;AACI,MAAM,oBAAoB,GAAG;AAEpC;;;;;;;;AAQG;AACI,MAAM,kBAAkB,GAAG;AAChC;;;;;;AAMG;IACH,EAAE;AAEF;;;;AAIG;IACH,SAAS;AAET;;;;AAIG;IACH,SAAS;AAET;;;;;;AAMG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;AAMG;AACH,IAAA,GAAG,EAAE,IAAI;AAET;;;;;;AAMG;IACH,KAAK;AAEL;;;;AAIG;IACH,MAAM;AAEN;;;;;;;AAOG;IACH,GAAG;AAEH;;;;;;;AAOG;IACH,GAAG;AAEH;;;;;;;AAOG;IACH,GAAG;;;;;"}