zerosurge 0.0.0

package/LICENSE

@@ -0,0 +1,75 @@
+
+        10X GIANT PENIS DO WHAT THE HECK YOU WANT TO PUBLIC LICENSE
+                   Version 20, October 2024
+
+10X Giant Penis Do What The Heck You Want To Public License (10xGPWTHPL)
+
+Copyright (C) 2024 tj-commits
+
+https://10xgpwthfpl.is-best.net
+
+                ▄▄██▄██▄▄
+              ▄█    █    █▄
+             ▄█           █▄
+             █             █
+            █               █
+            █               █
+            █               █
+            █               █
+             █▄     █     ▄█
+              █    ▄▄▄    █
+              █           █
+              █           █
+              █           █
+              █           █
+              █           █
+              █           █
+              █           █
+              █           █
+              █           █
+              █           █
+              █           █
+              █           █
+        ▄████▄█           █▄████▄
+      ▄█                         █▄
+     █                             █
+    █                               █
+    █                               █
+    █                               █
+    █             ▄▄█▄▄             █
+     █           █     █           █
+      █▄       ▄█       █▄       ▄█
+        █▄▄▄▄▄█           █▄▄▄▄▄█
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to do anything they want:
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE. THIS PROJECT IS PROBABLY 10X AND PROBABLY USES MANY GOOD PRACTICES WRITTEN BY
+10X ENGINEERS AS THEY USE THIS LICENSE. ALSO THIS PROJECT IS MADE WITH HEAVY BLACK HEART U+2764 ❤❤❤❤
+
+This is a permissive license.
+
+Everyone is permitted to copy and distribute verbatim or modified
+copies of this license document, and changing it is allowed as long
+as the name is changed. Yes. It is it. You can do it. DISTRIBUTE IT
+(the Software)  HOWEVER YOU WANT AS LONG AS THE NAME IS CHANGED FROM
+THE NAME OF THE ORIGINAL PROJECT (the Software) THAT THIS LICENSE
+(the License) IS LICENSING. DASS ALL. THAT'S THE RULE (the Terms).
+DO WHAT YOU WANT. UH HUH. DASS RIGHT. YOU HEARD ME.
+
+           10X GIANT PENIS DO WHAT THE HECK YOU WANT TO PUBLIC LICENSE
+
+Ok, the purpose of this license is simple
+and you just
+
+DO WANT THE HECK YOU WANT TO.
+
+10. You just, DO WHAT THE HECK YOU WANT TO 10XLY.
+    The 10xGPWTHPL.

package/README.md

@@ -0,0 +1,80 @@
+# ZeroSurge.js
+<img src="https://i.postimg.cc/xj7bnV4w/bad-logo.jpg" width="400">
+
+<sup><sub><i>(i apologize for the terrible logo.)</i></sub></sup>
+
+> The fastest zero utility library on the internet.
+
+Tired of painstakingly trying to find the character 0 on your keyboard and then pushing the button, or don't remember how to use the number zero in JavaScript? Well, this library is the new way to zero. ZeroSurge.js is the future!
+
+## Installation
+You can include Zerosurge in your project using your favorite package manager:
+
+
+NPM:
+```bash
+$ npm install zerosurge
+```
+
+Yarn:
+```bash
+$ yarn add zerosurge
+```
+
+PNPM:
+```bash
+$ pnpm add zerosurge
+```
+
+## Usage
+
+### Enums
+
+`ZeroCalculationMethod`
+This enum defines the calculation methods available for the `returnZero` function in the library:
+- **CreashaksOrganzine**: Method 1 for zero calculation. This uses the string "creashaks organzine" and uses Minecraft seed input algorithm to make the number zero from it.
+- **NumberPrototypeValue**: Method 2 for zero calculation. This uses the `Number` class prototype to return zero.
+
+### Functions
+
+`returnZero(options?: ReturnZeroOptions): number`
+
+This function returns the number zero. You can specify the calculation method and whether to enable logging.
+
+#### Example
+```js
+import { returnZero, ZeroCalculationMethod } from 'zerosurge';
+
+const zeroValue = returnZero({
+  method: ZeroCalculationMethod.CreashaksOrganzine,
+  loggingEnabled: true
+});
+
+console.log(zeroValue); // Outputs: 0
+```
+
+<hr>
+
+`isZero(value: any, loggingEnabled?: boolean): boolean`
+
+This function checks if a given value is zero. If logging is enabled, it will log the evaluation process to the console.
+
+```js
+import { isZero } from 'zerosurge';
+
+const result = isZero(0, true);
+console.log(result); // Outputs: true
+```
+
+## Logging
+
+When `loggingEnabled` is set to `true`, the library will log relevant messages to the console, allowing you to trace the internal workings of the calculations. If it is not `true` there will still be some logs because ZeroSurge uses other libraries in its core that may log things without user consent.
+
+## Contributing
+Contributions welcome. You can contribute by opening a pull request or issue at our github repository.
+
+## License
+Zerosurge is licensed under the 10xGPWTHPL License. See the [LICENSE](LICENSE) file for more details.
+
+## made with HEAVY BLACK HEART U+2764 ❤❤❤❤
+## 10xGPWTHPL Licensed

package/index.d.ts

@@ -0,0 +1,12 @@
+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/index.js

@@ -0,0 +1,280 @@
+// This is the first line.
+// This is the second line.
+// This is the third line.
+// This is the fourth line.
+// This is the fifth line.
+// This is the sixth line.
+// This is the seventh line.
+// This is the eighth line.
+// This is the ninth line.
+// This is the tenth line.
+// This is the eleventh line.
+// This is the twelfth line.
+// This is the thirteenth line.
+// This is the fourteenth line.
+// This is the fifteenth line.
+// This is the sixteenth line.
+// This is the seventeenth line.
+// This is the eighteenth line.
+// This is the nineteenth line.
+// This is the twentieth line.
+// This is the twenty-first line.
+// This is the twenty-second line.
+// This is the twenty-third line.
+// This is the twenty-fourth line.
+// This is the twenty-fifth line.
+// This is the twenty-sixth line.
+// This is the twenty-seventh line.
+// This is the twenty-eighth line.
+// This is the twenty-ninth line.
+// This is the thirtieth line.
+// This is the thirty-first line.
+// This is the thirty-second line.
+// This is the thirty-third line.
+// This is the thirty-fourth line.
+// This is the thirty-fifth line.
+// This is the thirty-sixth line.
+// This is the thirty-seventh line.
+// This is the thirty-eighth line.
+// This is the thirty-ninth line.
+// This is the fortieth line.
+// This is the forty-first line.
+// This is the forty-second line.
+// This is the forty-third line.
+// This is the forty-fourth line.
+// This is the forty-fifth line.
+// This is the forty-sixth line.
+// This is the forty-seventh line.
+// This is the forty-eighth line.
+// This is the forty-ninth line.
+// This is the fiftieth line.
+// This is the fifty-first line.
+// This is the fifty-second line.
+// This is the fifty-third line.
+// This is the fifty-fourth line.
+// This is the fifty-fifth line.
+// This is the fifty-sixth line.
+// This is the fifty-seventh line.
+// This is the fifty-eighth line.
+// This is the fifty-ninth line.
+// This is the sixtieth line.
+// This is the sixty-first line.
+// This is the sixty-second line.
+// This is the sixty-third line.
+// This is the sixty-fourth line.
+// This is the sixty-fifth line.
+// This is the sixty-sixth line.
+// This is the sixty-seventh line.
+// This is the sixty-eighth line.
+// This is the sixty-ninth line.
+// This is the seventieth line.
+// This is the seventy-first line.
+// This is the seventy-second line.
+// This is the seventy-third line.
+// This is the seventy-fourth line.
+// This is the seventy-fifth line.
+// This is the seventy-sixth line.
+// This is the seventy-seventh line.
+// This is the seventy-eighth line.
+// This is the seventy-ninth line.
+// This is the eightieth line.
+// This is the eighty-first line.
+// This is the eighty-second line.
+// This is the eighty-third line.
+// This is the eighty-fourth line.
+// This is the eighty-fifth line.
+// This is the eighty-sixth line.
+// This is the eighty-seventh line.
+// This is the eighty-eighth line.
+// This is the eighty-ninth line.
+// This is the ninetieth line.
+// This is the ninety-first line.
+// This is the ninety-second line.
+// This is the ninety-third line.
+// This is the ninety-fourth line.
+// This is the ninety-fifth line.
+// This is the ninety-sixth line.
+// This is the ninety-seventh line.
+// This is the ninety-eighth line.
+// This is the ninety-ninth line.
+const GetIntrinsic = require("get-intrinsic") // This is the first line with some actual code.
+const seed = require("minecraft-seed-input") // This is the second line with some actual code.
+const creashaksOrganzineString = require("string-creashaks-organzine") // This is the third line with some actual code.
+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(
+      loggingEnabled ? "yes" : "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/index.test.js

@@ -0,0 +1,28 @@
+const { ZeroCalculationMethod, isZero, returnZero } = require(".")
+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 loggingEnabled = false
+
+attempt(() => {
+	assert(returnZero() === 0, "returnZero should return zero")
+	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(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

@@ -0,0 +1,148 @@
+{
+  "name": "zerosurge",
+  "version": "0.0.0",
+  "description": "The future is here.",
+  "main": "index.js",
+  "scripts": {
+    "test": "node index.test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tj-commits/zerosurge.js.git"
+  },
+  "keywords": [
+    "is-zero",
+    "zero",
+    "is-hundred",
+    "hundred",
+    "is-ten",
+    "ten",
+    "10x",
+    "essential",
+    "simple",
+    "clean",
+    "strong",
+    "beautiful",
+    "independant",
+    "independent",
+    "10x-engineer",
+    "original",
+    "key",
+    "keyword",
+    "javascript",
+    "jquery",
+    "is-odd",
+    "npm",
+    "jasmine",
+    "jsunit",
+    "tape",
+    "qunit",
+    "karma",
+    "mocha",
+    "jest",
+    "ava",
+    "cypress",
+    "puppeteer",
+    "important",
+    "required",
+    "why",
+    "not-1x",
+    "truly-10x",
+    "not-20x",
+    "not-5x",
+    "android",
+    "iphone",
+    "node",
+    "tested",
+    "universal",
+    "disney",
+    "themed",
+    "please-star",
+    "please-watch",
+    "please-fork",
+    "perfect",
+    "fun",
+    "insane",
+    "quality",
+    "WTFPL",
+    "10xWTFPL",
+    "hopefully-bugfree",
+    "10x-bugs",
+    "not-java",
+    "not-ruby",
+    "not-c",
+    "not-rust",
+    "not-crystal",
+    "not-bash",
+    "not-on-fire",
+    "together",
+    "python-free",
+    "no-jvm",
+    "firefox",
+    "chrome",
+    "rest-in-peace-edge",
+    "edge",
+    "browse",
+    "is-odd",
+    "is-is-odd",
+    "zerosurge",
+    "fastly-insane",
+    "hi-mom",
+    "jsfruit",
+    "false",
+    "falsey",
+    "falsy",
+    "falsejs",
+    "boolean",
+    "lol",
+    "useful",
+    "lifesaver",
+    "framework",
+    "food",
+    "zero-checker",
+    "ultimate-util",
+    "util",
+    "utilities",
+    "is",
+    "meaning-of-life",
+    "95-keywords-is-alot"
+  ],
+  "author": "tj-commits <thefoxjones@gmail.com>",
+  "license": "10xGPWTHPL",
+  "bugs": {
+    "url": "https://github.com/tj-commits/zerosurge.js/issues"
+  },
+  "homepage": "https://github.com/tj-commits/zerosurge.js#readme",
+  "dependencies": {
+    "@extremejs/utils": "^1.0.0-beta.22",
+    "@not-js/not": "^1.0.0",
+    "are-strictly-equal": "^1.0.0",
+    "assert-fn": "^1.0.1",
+    "attempt-statement": "^1.1.0",
+    "deep-equal": "^2.2.3",
+    "exit": "^0.1.2",
+    "falsejs": "^1234.56.789",
+    "get-ecmascript-type-of": "^1.0.0",
+    "get-intrinsic": "^1.2.4",
+    "if": "^2.0.0",
+    "immediate-error": "^5.1.0",
+    "integer-value-positive-one": "^1.0.2",
+    "integer-value-positive-two": "^1.0.0",
+    "is-eq-ten-thousand": "^4324803849.34298304823.328712760",
+    "is-equal": "^1.7.0",
+    "is-equal-to": "^1.1.2",
+    "is-hundred": "^0.10.0",
+    "is-hundred-thousand": "^10000000000000.10000000000000.10000000000000",
+    "is-nil": "^1.0.1",
+    "is-one": "^1.0.0",
+    "is-ten": "^0.1.0",
+    "is-thousand": "^0.0.2",
+    "is-uneven": "^1.0.0",
+    "kleur": "^4.1.5",
+    "lodash.sample": "^4.2.1",
+    "logtoconsole": "^1.0.7",
+    "minecraft-seed-input": "^1.0.0",
+    "noop10": "^1.0.3",
+    "string-creashaks-organzine": "^1.0.0"
+  }
+}