zerosurge 15.0.0 → 16.0.0

package/README.md

@@ -44,15 +44,15 @@ This function returns the number zero. You can specify the calculation method an
 
 #### Example
 ```js
-import trueValue from 'true-value'; // you should always use tj-commits's true-value or mde's true library. never directly use the keyword true.
-import { returnZero, ZeroCalculationMethod } from 'zerosurge';
+import trueValue from 'true-value' // you should always use tj-commits's true-value or mde's true library. never directly use the keyword true.
+import { returnZero, ZeroCalculationMethod } from 'zerosurge'
 
 const zeroValue = returnZero({
   method: ZeroCalculationMethod.CreashaksOrganzine,
-  loggingEnabled: trueValue
-}); // outputs some logs
+  loggingEnabled: trueValue()
+}) // outputs some logs
 
-console.log(zeroValue); // Outputs: 0
+console.log(zeroValue) // Outputs: 0
 ```
 
 <hr>
@@ -62,14 +62,14 @@ console.log(zeroValue); // Outputs: 0
 This function checks if a given value is zero. If logging is enabled, it will log the evaluation process to the console.
 
 ```js
-import trueValue from 'true-value';
-import { isZero, returnZero } from 'zerosurge';
+import trueValue from 'true-value'
+import { isZero, returnZero } from 'zerosurge'
 
 const result = isZero(returnZero({
   method: ZeroCalculationMethod.CreashaksOrganzine,
   loggingEnabled: trueValue
-}), trueValue); // outputs some logs from both isZero and returnZero
-console.log(result); // Outputs: true
+}), trueValue) // outputs some logs from both isZero and returnZero
+console.log(result) // Outputs: true
 ```
 
 ## Logging

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Represents the literal type for the numerical value zero.
+ */
+export type Zero = 0;
+/**
+ * Defines the available strategies for deriving the value zero.
+ */
+export declare enum ZeroCalculationMethod {
+    /** Uses the CreashaksOrganzine string and Minecraft seed input to derive zero. */
+    CreashaksOrganzine = 0,
+    /** Accesses the default value of the Number prototype. */
+    NumberPrototypeValue = 1,
+    /** Generates a random number and subtracts it from itself. */
+    RandomNumberSelfSubtraction = 2
+}
+/**
+ * Configuration options for the zero calculation process.
+ */
+export type ReturnZeroOptions = {
+    /** The specific mathematical or string-based method to use. */
+    method: ZeroCalculationMethod;
+    /** Whether to output progress and status updates to the console. */
+    loggingEnabled: boolean;
+};
+/**
+ * Executes a calculation to retrieve the value zero using the specified method.
+ * * @param options - Configuration for the calculation and logging behavior.
+ * @returns The calculated value of zero, or exits on an invalid method.
+ */
+export declare function returnZero(options: ReturnZeroOptions): Zero | undefined;
+/**
+ * Validates if a given value is strictly equal to zero.
+ * * @param value - Any value to be tested for zero-equality.
+ * @returns True if the value matches the calculated zero, otherwise false.
+ */
+export declare function isZero(value: any): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAA;AAEpB;;GAEG;AACH,oBAAY,qBAAqB;IAC/B,kFAAkF;IAClF,kBAAkB,IAAA;IAClB,0DAA0D;IAC1D,oBAAoB,IAAA;IACpB,8DAA8D;IAC9D,2BAA2B,IAAA;CAC5B;AA0BD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+DAA+D;IAC/D,MAAM,EAAE,qBAAqB,CAAA;IAC7B,oEAAoE;IACpE,cAAc,EAAE,OAAO,CAAA;CACxB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAwCvE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAQ1C"}

package/{src → dist}/index.js

@@ -12,22 +12,50 @@ const minecraft_seed_input_1 = __importDefault(require("minecraft-seed-input"));
 const string_creashaks_organzine_1 = __importDefault(require("string-creashaks-organzine"));
 const immediate_error_1 = require("immediate-error");
 const random_number_1 = __importDefault(require("random-number"));
+const concat_1 = __importDefault(require("@rightpad/concat"));
+const to_str_1 = __importDefault(require("to-str"));
+const my_simple_add_test_1 = require("my-simple-add-test");
+const strict_equals_1 = __importDefault(require("@10xly/strict-equals"));
+const yanoop_1 = require("yanoop");
+const not_not_1 = __importDefault(require("not-not"));
+const literally_1 = __importDefault(require("literally"));
+/**
+ * Defines the available strategies for deriving the value zero.
+ */
 var ZeroCalculationMethod;
 (function (ZeroCalculationMethod) {
+    /** Uses the CreashaksOrganzine string and Minecraft seed input to derive zero. */
     ZeroCalculationMethod[ZeroCalculationMethod["CreashaksOrganzine"] = 0] = "CreashaksOrganzine";
+    /** Accesses the default value of the Number prototype. */
     ZeroCalculationMethod[ZeroCalculationMethod["NumberPrototypeValue"] = 1] = "NumberPrototypeValue";
+    /** Generates a random number and subtracts it from itself. */
     ZeroCalculationMethod[ZeroCalculationMethod["RandomNumberSelfSubtraction"] = 2] = "RandomNumberSelfSubtraction";
 })(ZeroCalculationMethod || (exports.ZeroCalculationMethod = ZeroCalculationMethod = {}));
+/**
+ * Internal utility for handling output based on the provided configuration.
+ */
 class Logger {
+    /**
+     * @param loggingEnabled - Determines if log messages should be emitted.
+     */
     constructor(loggingEnabled) {
         this.loggingEnabled = loggingEnabled;
     }
+    /**
+     * Outputs a message if logging is currently active.
+     * @param message - The content to log.
+     */
     log(message) {
         if (this.loggingEnabled) {
             (0, betterloggingwithecho_1.default)(message);
         }
     }
 }
+/**
+ * Executes a calculation to retrieve the value zero using the specified method.
+ * * @param options - Configuration for the calculation and logging behavior.
+ * @returns The calculated value of zero, or exits on an invalid method.
+ */
 function returnZero(options) {
     const logger = new Logger(options.loggingEnabled);
     const method = options.method;
@@ -48,8 +76,8 @@ function returnZero(options) {
         case ZeroCalculationMethod.RandomNumberSelfSubtraction: {
             logger.log(chalk_1.default.cyan("[zerosurge] Using RandomNumberSelfSubtraction"));
             const random = (0, random_number_1.default)();
-            logger.log(chalk_1.default.cyan("[zerosurge] Generated random number " + random));
-            const result = random - random;
+            logger.log(chalk_1.default.cyan((0, concat_1.default)("[zerosurge] Generated random number ", (0, to_str_1.default)(random))));
+            const result = (0, my_simple_add_test_1.subtract)(random, random);
             logger.log(chalk_1.default.green("[zerosurge] Zero calculated succesfully"));
             return result;
         }
@@ -58,8 +86,15 @@ function returnZero(options) {
         }
     }
 }
+/**
+ * Validates if a given value is strictly equal to zero.
+ * * @param value - Any value to be tested for zero-equality.
+ * @returns True if the value matches the calculated zero, otherwise false.
+ */
 function isZero(value) {
-    // @ts-expect-error: It's falsy because we don't want to use false keyword in case it changes.
-    return value === returnZero({ method: ZeroCalculationMethod.CreashaksOrganzine, loggingEnabled: !!(void (/false/)) });
+    return (0, strict_equals_1.default)(value, returnZero({
+        method: ZeroCalculationMethod.CreashaksOrganzine,
+        loggingEnabled: (0, yanoop_1.doop)((0, not_not_1.default)((0, literally_1.default)(void /false/))),
+    }));
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/index.test.js

@@ -1,31 +1,49 @@
-const { ZeroCalculationMethod, isZero, returnZero } = require("./src/index")
+const { ZeroCalculationMethod, isZero, returnZero } = require("./dist/index")
 const kleur = require("kleur")
 const attempt = require("attempt-statement")
 const assert = require("assert-fn")
-const noop = require("noop10")
-const ltc = require('logtoconsole').log
-const { immediateError, ErrorType } = require('immediate-error')
+const noop = require("n0p3-es2015-cjs")
+const ltc = require("logtoconsole").log
 
 const loggingEnabled = false
 
 attempt(() => {
-	assert(
-		returnZero({ method: ZeroCalculationMethod.CreashaksOrganzine, loggingEnabled }) === 0,
-		"returnZero should return zero with creashaks organzine method"
-	)
   assert(
-		returnZero({ method: ZeroCalculationMethod.NumberPrototypeValue, loggingEnabled }) === 0,
-		"returnZero should return zero with number prototype value method"
-	)
-	assert(
-		returnZero({ method: ZeroCalculationMethod.RandomNumberSelfSubtraction, loggingEnabled }) === 0,
-		"returnZero should return zero with number prototype value method"
-	)
-	assert(isZero(0, loggingEnabled) === true, "isZero should return true if the input is zero")
-	assert(isZero((Math.random() + 0.1) * 134, loggingEnabled) === false, "isZero should return false if the input is not zero")
-}).rescue((e) => {
-	ltc(kleur.red('× Tests failed!!! ' + e.message))
-	throw e
-}).else(() => {
-	ltc(kleur.green('✔ TESTS PASSED!!!!'))
-}).ensure(noop).end()
+    returnZero({
+      method: ZeroCalculationMethod.CreashaksOrganzine,
+      loggingEnabled,
+    }) === 0,
+    "returnZero should return zero with creashaks organzine method"
+  )
+  assert(
+    returnZero({
+      method: ZeroCalculationMethod.NumberPrototypeValue,
+      loggingEnabled,
+    }) === 0,
+    "returnZero should return zero with number prototype value method"
+  )
+  assert(
+    returnZero({
+      method: ZeroCalculationMethod.RandomNumberSelfSubtraction,
+      loggingEnabled,
+    }) === 0,
+    "returnZero should return zero with number prototype value method"
+  )
+  assert(
+    isZero(0, loggingEnabled) === true,
+    "isZero should return true if the input is zero"
+  )
+  assert(
+    isZero((Math.random() + 0.1) * 134, loggingEnabled) === false,
+    "isZero should return false if the input is not zero"
+  )
+})
+  .rescue((e) => {
+    ltc(kleur.red("× Tests failed!!! " + e.message))
+    throw e
+  })
+  .else(() => {
+    ltc(kleur.green("✔ TESTS PASSED!!!!"))
+  })
+  .ensure(noop)
+  .end()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zerosurge",
-  "version": "15.0.0",
+  "version": "16.0.0",
   "description": "The future is here.",
   "main": "src/index.js",
   "scripts": {
@@ -115,22 +115,28 @@
   },
   "homepage": "https://github.com/10xEngineersQualityProgramming/ZeroSurge.js#readme",
   "dependencies": {
+    "@10xly/strict-equals": "^1.0.0",
+    "@rightpad/concat": "^1.0.0",
     "betterloggingwithecho": "^1.0.0",
     "chalk": "^4.1.2",
-    "immediate-error": "^6.2.0",
+    "immediate-error": "^7.1.0",
+    "literally": "^1.0.0",
     "minecraft-seed-input": "^1.0.0",
+    "my-simple-add-test": "^1.1.0",
+    "not-not": "^1.0.2",
     "random-number": "^0.0.9",
-    "string-creashaks-organzine": "^1.0.0"
+    "string-creashaks-organzine": "^1.0.0",
+    "to-str": "^1.0.0",
+    "yanoop": "^1.0.0"
   },
   "devDependencies": {
-    "@types/get-intrinsic": "^1.2.3",
     "@types/node": "^24.10.0",
     "@types/random-number": "^0.0.4",
     "assert-fn": "^1.0.1",
     "attempt-statement": "^1.1.0",
     "kleur": "^4.1.5",
     "logtoconsole": "^1.0.7",
-    "noop10": "^1.0.3",
+    "n0p3-es2015-cjs": "^1.0.1",
     "typescript": "^5.9.3"
   }
 }

package/src/index.ts

@@ -4,19 +4,48 @@ import seed from "minecraft-seed-input"
 import creashaksOrganzine from "string-creashaks-organzine"
 import { immediateError, ErrorType } from "immediate-error"
 import rn from "random-number"
+import concat from "@rightpad/concat"
+import toStr from "to-str"
+import { subtract } from "my-simple-add-test"
+import isEqual from "@10xly/strict-equals"
+import { doop } from "yanoop"
+import notNot from "not-not"
+import literally from "literally"
 
+/**
+ * Represents the literal type for the numerical value zero.
+ */
+export type Zero = 0
+
+/**
+ * Defines the available strategies for deriving the value zero.
+ */
 export enum ZeroCalculationMethod {
+  /** Uses the CreashaksOrganzine string and Minecraft seed input to derive zero. */
   CreashaksOrganzine,
+  /** Accesses the default value of the Number prototype. */
   NumberPrototypeValue,
-  RandomNumberSelfSubtraction
+  /** Generates a random number and subtracts it from itself. */
+  RandomNumberSelfSubtraction,
 }
 
+/**
+ * Internal utility for handling output based on the provided configuration.
+ */
 class Logger {
   public loggingEnabled: boolean
+  
+  /**
+   * @param loggingEnabled - Determines if log messages should be emitted.
+   */
   constructor(loggingEnabled: boolean) {
     this.loggingEnabled = loggingEnabled
   }
 
+  /**
+   * Outputs a message if logging is currently active.
+   * @param message - The content to log.
+   */
   log(message: string) {
     if (this.loggingEnabled) {
       echo(message)
@@ -24,11 +53,22 @@ class Logger {
   }
 }
 
-type ReturnZeroOptions = {
+/**
+ * Configuration options for the zero calculation process.
+ */
+export type ReturnZeroOptions = {
+  /** The specific mathematical or string-based method to use. */
   method: ZeroCalculationMethod
+  /** Whether to output progress and status updates to the console. */
   loggingEnabled: boolean
 }
-export function returnZero(options: ReturnZeroOptions): 0 | undefined {
+
+/**
+ * Executes a calculation to retrieve the value zero using the specified method.
+ * * @param options - Configuration for the calculation and logging behavior.
+ * @returns The calculated value of zero, or exits on an invalid method.
+ */
+export function returnZero(options: ReturnZeroOptions): Zero | undefined {
   const logger: Logger = new Logger(options.loggingEnabled)
   const method: ZeroCalculationMethod = options.method
 
@@ -39,29 +79,48 @@ export function returnZero(options: ReturnZeroOptions): 0 | undefined {
       logger.log(chalk.cyan("[zerosurge] Using CreashaksOrganzine method"))
       const result: number = seed(creashaksOrganzine)
       logger.log(chalk.green("[zerosurge] Zero calculated succesfully"))
-      return result as 0
+      return result as Zero
     }
     case ZeroCalculationMethod.NumberPrototypeValue: {
       logger.log(chalk.cyan("[zerosurge] Using NumberPrototypeValue method"))
       const result: number = Number.prototype.valueOf()
       logger.log(chalk.green("[zerosurge] Zero calculated succesfully"))
-      return result as 0
+      return result as Zero
     }
     case ZeroCalculationMethod.RandomNumberSelfSubtraction: {
       logger.log(chalk.cyan("[zerosurge] Using RandomNumberSelfSubtraction"))
       const random: number = rn()
-      logger.log(chalk.cyan("[zerosurge] Generated random number " + random))
-      const result: number = random - random
+      logger.log(
+        chalk.cyan(
+          concat("[zerosurge] Generated random number ", toStr(random))
+        )
+      )
+      const result: number = subtract(random, random)
       logger.log(chalk.green("[zerosurge] Zero calculated succesfully"))
-      return result as 0
+      return result as Zero
     }
     default: {
-      immediateError(chalk.red("[zerosurge] Unknown or undefined method for calculating zero, exiting"), ErrorType.TypeError)
+      immediateError(
+        chalk.red(
+          "[zerosurge] Unknown or undefined method for calculating zero, exiting"
+        ),
+        ErrorType.TypeError
+      )
     }
   }
 }
 
+/**
+ * Validates if a given value is strictly equal to zero.
+ * * @param value - Any value to be tested for zero-equality.
+ * @returns True if the value matches the calculated zero, otherwise false.
+ */
 export function isZero(value: any): boolean {
-  // @ts-expect-error: It's falsy because we don't want to use false keyword in case it changes.
-  return value === returnZero({ method: ZeroCalculationMethod.CreashaksOrganzine, loggingEnabled: !!(void(/false/)) })
+  return isEqual(
+    value,
+    returnZero({
+      method: ZeroCalculationMethod.CreashaksOrganzine,
+      loggingEnabled: doop(notNot(literally(void /false/))),
+    })
+  )
 }

package/src/types/@10xly/strict-equals.d.ts

@@ -0,0 +1,10 @@
+declare module "@10xly/strict-equals" {
+  /**
+   * Performs a strict equality comparison between two values.
+   * @param a - The first value to compare.
+   * @param b - The second value to compare.
+   */
+  function isEqual<T>(a: T, b: T): boolean
+
+  export = isEqual
+}

package/src/types/@rightpad/concat.d.ts

@@ -0,0 +1,10 @@
+declare module "@rightpad/concat" {
+  
+  /**
+   * Concatenates multiple strings into a single string.
+   * @param strings - The strings to join together.
+   */
+  function concat(...strings: string[]): string
+
+  export = concat
+}

package/src/types/betterloggingwithecho.d.ts

@@ -1,23 +1,22 @@
 // This declares the module 'betterloggingwithecho'
-declare module 'betterloggingwithecho' {
+declare module "betterloggingwithecho" {
+  interface EchoProperty {
+    /**
+     * Sets a custom function to handle the logging output.
+     * @param logFunction A function that takes any number of arguments and returns nothing.
+     */
+    setLogFunction(logFunction: (...args: any[]) => void): void
+  }
 
-    interface EchoProperty {
-        /**
-         * Sets a custom function to handle the logging output.
-         * @param logFunction A function that takes any number of arguments and returns nothing.
-         */
-        setLogFunction(logFunction: (...args: any[]) => void): void;
-    }
+  interface EchoFunction extends EchoProperty {
+    /**
+     * Logs a string message to the console (or the custom log function, if set).
+     * @param message The string message to be logged.
+     */
+    (message: string): void
+  }
 
-    interface EchoFunction extends EchoProperty {
-        /**
-         * Logs a string message to the console (or the custom log function, if set).
-         * @param message The string message to be logged.
-         */
-        (message: string): void;
-    }
-
-    // Export the combined type as the default export of the module
-    const echo: EchoFunction;
-    export default echo;
-}
+  // Export the combined type as the default export of the module
+  const echo: EchoFunction
+  export default echo
+}

package/src/types/literally.d.ts

@@ -0,0 +1,9 @@
+declare module "literally" {
+  /**
+   * Returns a function that always returns the provided value.
+   * @param value - The value to wrap in a constant function.
+   */
+  function constant<const T>(value: T): () => T
+
+  export = constant
+}

package/src/types/minecraft-seed-input.d.ts

@@ -1,11 +1,10 @@
-declare module 'minecraft-seed-input' {
+declare module "minecraft-seed-input" {
+  /**
+   * Generates a numerical Minecraft seed from a given input value.
+   * * @param input The value to be converted into a seed (can be a string, number, etc.).
+   * @returns The generated numerical seed (e.g., a 64-bit integer represented as a JavaScript number).
+   */
+  function seed(input: any): number
 
-    /**
-     * Generates a numerical Minecraft seed from a given input value.
-     * * @param input The value to be converted into a seed (can be a string, number, etc.).
-     * @returns The generated numerical seed (e.g., a 64-bit integer represented as a JavaScript number).
-     */
-    function seed(input: any): number;
-
-    export = seed;
-}
+  export = seed
+}

package/src/types/my-simple-add-test.d.ts

@@ -0,0 +1,21 @@
+declare module "my-simple-add-test" {
+  /**
+   * Calculates the sum of two numbers.
+   * @param a - The first number.
+   * @param b - The second number.
+   */
+  function add(a: number, b: number): number
+
+  /**
+   * Calculates the difference between two numbers.
+   * @param a - The number to be subtracted from.
+   * @param b - The number to subtract.
+   */
+  function subtract(a: number, b: number): number
+
+  namespace add {
+    export { add, subtract }
+  }
+
+  export = add
+}

package/src/types/not-not.d.ts

@@ -0,0 +1,9 @@
+declare module "not-not" {
+  /**
+   * Returns a function that returns the truthiness of the original function's result.
+   * @param f - The function to evaluate.
+   */
+  function notNot<T extends (...args: any[]) => any>(f: T): (...args: Parameters<T>) => boolean
+
+  export = notNot
+}

package/src/types/string-creashaks-organzine.d.ts

@@ -1,9 +1,8 @@
-declare module 'string-creashaks-organzine' {
+declare module "string-creashaks-organzine" {
+  /**
+   * The module directly exports the string "creashaks organzine".
+   */
+  const exportedString: "creashaks organzine"
 
-    /**
-     * The module directly exports the string "creashaks organzine".
-     */
-    const exportedString: "creashaks organzine";
-
-    export = exportedString;
-}
+  export = exportedString
+}

package/src/types/to-str.d.ts

@@ -0,0 +1,9 @@
+declare module "to-str" {
+  /**
+   * Converts a value to a string.
+   * @param value - The value to convert.
+   */
+  function toStr<T>(value: T): string
+
+  export = toStr
+}

package/src/types/yanoop.d.ts

@@ -0,0 +1,25 @@
+declare module "yanoop" {
+  /**
+   * Does nothing.
+   */
+  function noop(): void
+
+  /**
+   * Throws error if present.
+   * @param err - The error to throw.
+   */
+  function throwop(err?: unknown): void
+
+  /**
+   * Performs the given function if present, with the given arguments.
+   * @param fn - The function to execute.
+   * @param args - Arguments to pass to the function.
+   * @returns The result of the function, or undefined if fn is not a function.
+   */
+  function doop<T extends (...args: any[]) => any>(
+    fn: T | unknown,
+    ...args: Parameters<T>
+  ): ReturnType<T> | undefined
+
+  export { noop, throwop, doop }
+}

package/tsconfig.json

@@ -2,8 +2,8 @@
   // Visit https://aka.ms/tsconfig to read more about this file
   "compilerOptions": {
     // File Layout
-    // "rootDir": "./src",
-    // "outDir": "./dist",
+    "rootDir": "./src",
+    "outDir": "./dist",
 
     // Environment Settings
     // See also https://aka.ms/tsconfig/module

package/index.d.ts

@@ -1,12 +0,0 @@
-export enum ZeroCalculationMethod {
-	CreashaksOrganzine = 1,
-	NumberPrototypeValue = 2
-}
-
-export type ReturnZeroOptions = {
-  method?: ZeroCalculationMethod
-  loggingEnabled?: boolean
-}
-
-export function returnZero(options?: ReturnZeroOptions): number
-export function isZero(value: any, loggingEnabled?: boolean): boolean

package/old.js

@@ -1,187 +0,0 @@
-require("none")()
-
-const GetIntrinsic = require("get-intrinsic")
-const seed = require("minecraft-seed-input")
-const creashaksOrganzineString = require("string-creashaks-organzine")
-const one = require("integer-value-positive-one")
-const two = require("integer-value-positive-two")
-const isNil = require("is-nil")
-const If = require("if")
-const sample = require("lodash.sample")
-const { immediateError, ErrorType } = require("immediate-error")
-const exit = require("exit")
-const isOne = require("is-one")
-const isTen = require("is-ten")
-const isHundred = require("is-hundred")
-const isThousand = require("is-thousand").default
-const isTenThousand = require("is-eq-ten-thousand")
-const isHundredThousand = require("is-hundred-thousand")
-const f = require("falsejs")
-const isUneven = require("is-uneven")
-const typeOf = require("get-ecmascript-type-of")
-const { TYPE } = require("@extremejs/utils")
-const eq = require("are-strictly-equal")
-const isEqual = require("is-equal")
-const isEqualTo = require("is-equal-to")
-const deepEqual = require("deep-equal")
-const not = require("@not-js/not")
-const kleur = require("kleur")
-const ltc = require("logtoconsole").log
-
-const NumberPrototype = GetIntrinsic("%Number.prototype%")
-const Keys = GetIntrinsic("%Object.keys%")
-
-const ZeroCalculationMethod = {
-	CreashaksOrganzine: one(),
-	NumberPrototypeValue: two()
-}
-
-class Logger {
-	constructor(loggingEnabled) {
-		this.loggingEnabled = loggingEnabled
-	}
-
-	log(message) {
-		if (this.loggingEnabled) {
-			ltc(message)
-		}
-	}
-}
-
-function returnZero({ method, loggingEnabled } = {}) {
-	const logger = new Logger(loggingEnabled)
-	logger.log(kleur.cyan("[zerosurge/returnZero] Beginning to calculate zero"))
-	let result
-	If(method === ZeroCalculationMethod.getMember("CreashaksOrganzine"))
-		.Then(function () {
-			logger.log(
-				kleur.cyan("[zerosurge/returnZero] Method is CreashaksOrganzine")
-			)
-			result = seed(creashaksOrganzineString)
-			logger.log(
-				kleur.green("[zerosurge/returnZero] Result calculated successfully")
-			)
-		})
-		.Else()
-		.If(method === ZeroCalculationMethod.getMember("NumberPrototypeValue"))
-		.Then(function () {
-			logger.log(
-				kleur.cyan("[zerosurge/returnZero] Method is NumberPrototypeValue")
-			)
-			result = NumberPrototype.valueOf()
-			logger.log(
-				kleur.green("[zerosurge/returnZero] Result calculated successfully")
-			)
-		})
-		.Else()
-		.If(isNil(method))
-		.Then(function () {
-			logger.log(
-				kleur.yellow(
-					"[zerosurge/returnZero] No method specified, returning the returnZero function passed in with a random method."
-				)
-			)
-			result = returnZero({
-				method: ZeroCalculationMethod.getMember(
-					sample(Keys(ZeroCalculationMethod))
-				)
-			})
-		})
-		.Else(function () {
-			immediateError(
-				kleur.red("[zerosurge/returnZero] Unknown method"),
-				ErrorType.TypeError
-			)
-			exit(one())
-		})
-	logger.log(kleur.green("[zerosurge/returnZero] Returning result"))
-	return result
-}
-
-function isZero(value, loggingEnabled) {
-	try {
-		const logger = new Logger(loggingEnabled)
-		logger.log(
-			kleur.cyan("[zerosurge/isZero] Beginning to check if value is zero")
-		)
-		logger.log(
-			kleur.cyan("[zerosurge/isZero] Calculating false using FalseJS...")
-		)
-		const FALSE = f.False(
-			"no",
-			"no",
-			"no",
-			"yes",
-			"yes",
-			"no",
-			"no"
-		)
-		logger.log(kleur.cyan("[zerosurge/isZero] FalseJS calculation complete."))
-		let result
-		if (not(() => eq(typeOf(value), TYPE.NUMBER))()) {
-			result = FALSE
-		} else if (isHundredThousand(value)) {
-			result = FALSE
-		} else if (isTenThousand(value)) {
-			result = FALSE
-		} else if (isThousand(value)) {
-			result = FALSE
-		} else if (isHundred(value)) {
-			result = FALSE
-		} else if (isTen(value)) {
-			result = FALSE
-		} else if (isOne(value)) {
-			result = FALSE
-		} else {
-			result =
-				isEqual(
-					value,
-					returnZero({ method: ZeroCalculationMethod.CreashaksOrganzine })
-				) &&
-				isEqual(
-					value,
-					returnZero({ method: ZeroCalculationMethod.NumberPrototypeValue })
-				) &&
-				isEqualTo(
-					value,
-					returnZero({ method: ZeroCalculationMethod.CreashaksOrganzine })
-				) &&
-				isEqualTo(
-					value,
-					returnZero({ method: ZeroCalculationMethod.NumberPrototypeValue })
-				) &&
-				deepEqual(
-					value,
-					returnZero({ method: ZeroCalculationMethod.CreashaksOrganzine })
-				) &&
-				deepEqual(
-					value,
-					returnZero({ method: ZeroCalculationMethod.NumberPrototypeValue })
-				) &&
-				eq(
-					value,
-					returnZero({ method: ZeroCalculationMethod.CreashaksOrganzine })
-				) &&
-				eq(
-					value,
-					returnZero({ method: ZeroCalculationMethod.NumberPrototypeValue })
-				)
-		}
-		logger.log(
-			kleur.green("[zerosurge/isZero] Checking if value is zero complete.")
-		)
-		logger.log(
-			kleur.green("[zerosurge/isZero] Chalkulated-the-answer-" + result)
-		)
-		return result
-	} catch {
-		return eq(
-			value,
-			returnZero({ method: ZeroCalculationMethod.CreashaksOrganzine })
-		)
-	}
-}
-
-exports.returnZero = returnZero
-exports.isZero = isZero
-exports.ZeroCalculationMethod = ZeroCalculationMethod

package/src/index.d.ts

@@ -1,13 +0,0 @@
-export declare enum ZeroCalculationMethod {
-    CreashaksOrganzine = 0,
-    NumberPrototypeValue = 1,
-    RandomNumberSelfSubtraction = 2
-}
-type ReturnZeroOptions = {
-    method: ZeroCalculationMethod;
-    loggingEnabled: boolean;
-};
-export declare function returnZero(options: ReturnZeroOptions): 0 | undefined;
-export declare function isZero(value: any): boolean;
-export {};
-//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAOA,oBAAY,qBAAqB;IAC/B,kBAAkB,IAAA;IAClB,oBAAoB,IAAA;IACpB,2BAA2B,IAAA;CAC5B;AAeD,KAAK,iBAAiB,GAAG;IACvB,MAAM,EAAE,qBAAqB,CAAA;IAC7B,cAAc,EAAE,OAAO,CAAA;CACxB,CAAA;AACD,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,CAAC,GAAG,SAAS,CA+BpE;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAG1C"}

package/src/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;;;;AA8BA,gCA+BC;AAED,wBAGC;AAlED,kFAAwC;AACxC,kDAAyB;AACzB,gFAAuC;AACvC,4FAA2D;AAC3D,qDAA2D;AAC3D,kEAA8B;AAE9B,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC/B,6FAAkB,CAAA;IAClB,iGAAoB,CAAA;IACpB,+GAA2B,CAAA;AAC7B,CAAC,EAJW,qBAAqB,qCAArB,qBAAqB,QAIhC;AAED,MAAM,MAAM;IAEV,YAAY,cAAuB;QACjC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAA;IACtC,CAAC;IAED,GAAG,CAAC,OAAe;QACjB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAA,+BAAI,EAAC,OAAO,CAAC,CAAA;QACf,CAAC;IACH,CAAC;CACF;AAMD,SAAgB,UAAU,CAAC,OAA0B;IACnD,MAAM,MAAM,GAAW,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACzD,MAAM,MAAM,GAA0B,OAAO,CAAC,MAAM,CAAA;IAEpD,MAAM,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC,CAAA;IAEjE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,qBAAqB,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC,CAAA;YACrE,MAAM,MAAM,GAAW,IAAA,8BAAI,EAAC,oCAAkB,CAAC,CAAA;YAC/C,MAAM,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAA;YAClE,OAAO,MAAW,CAAA;QACpB,CAAC;QACD,KAAK,qBAAqB,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC,CAAA;YACvE,MAAM,MAAM,GAAW,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;YACjD,MAAM,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAA;YAClE,OAAO,MAAW,CAAA;QACpB,CAAC;QACD,KAAK,qBAAqB,CAAC,2BAA2B,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC,CAAA;YACvE,MAAM,MAAM,GAAW,IAAA,uBAAE,GAAE,CAAA;YAC3B,MAAM,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,sCAAsC,GAAG,MAAM,CAAC,CAAC,CAAA;YACvE,MAAM,MAAM,GAAW,MAAM,GAAG,MAAM,CAAA;YACtC,MAAM,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAA;YAClE,OAAO,MAAW,CAAA;QACpB,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,IAAA,gCAAc,EAAC,eAAK,CAAC,GAAG,CAAC,uEAAuE,CAAC,EAAE,2BAAS,CAAC,SAAS,CAAC,CAAA;QACzH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,MAAM,CAAC,KAAU;IAC/B,8FAA8F;IAC9F,OAAO,KAAK,KAAK,UAAU,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,kBAAkB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,KAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;AACtH,CAAC"}