@falsejs/falsejs 1.0.67 → 2.0.0

package/README.md

@@ -43,8 +43,7 @@ function False(
   shouldDoSomethingAsyncWithIsTenThousand?: "yes" | "no",
   disableAprilFoolsSideEffects?: "yes" | "no",
   definitelyDisableAprilFoolsSideEffects?: "yes" | "no",
-  strictDisableAprilFoolsSideEffectsCheck?: "yes" | "no",
-  openRandomImageOfDofleWhenDone?: "yes" | "no"
+  strictDisableAprilFoolsSideEffectsCheck?: "yes" | "no"
 ): boolean
 ```
 
@@ -56,17 +55,33 @@ The third argument, `shouldDoSomethingAsyncWithIsTenThousand`, is whether `is-te
 
 The fourth and fifth arguments, `disableAprilFoolsSideEffects` and `definitelyDisableAprilFoolsSideEffects`, can be `"yes"` or `"no"`. Both of them have to be `"yes"` to bypass the side effects of it being April Fools? What side effects, you may ask? Well, let's just say, FalseJS does something different on April Fools. If these are enabled when it's not April Fools, then an error will be thrown, unless the sixth argument, `strictDisableAprilFoolsSideEffectsCheck`, is `"no"`.
 
-The seventh argument, `openRandomImageOfDofleWhenDone`, can be `"yes"` or `"no"`. If it is `"yes"`, then a random image of Sindre Sorhus's cat Dofle will be opened after false is calculated.
+And the last argument is the compatibility mode argument. This one has its own section about how it works which is after the example.
 
 ## Example
 
 ```javascript
 const falsejs = require("@falsejs/falsejs").default
-const falseValue = falsejs.False("yes", "no", "no", "yes", "yes", "no", "no") // outputs a bunch of logs
+const falseValue = falsejs.False("yes", "yes", "yes", "yes", "yes", "no", falsejs.COMPATIBILITY_MODE.NONE) // outputs a bunch of logs
 
 console.log(falseValue) // outputs false
 ```
 
+## Legacy Compatibility Modes
+To ensure the integrity of the returned boolean across every known runtime environment since the dawn of the internet, the `falsejs.False` function supports an optional `compatibilityMode` argument. The checks performed may seem CPU-intensive and unnecessary, but they guarantee that the runtime environment is free of historical browser quirks that could threaten the stable return value of false.
+
+Here's an example:
+```javascript
+const myIE5CompatibleFalseValue = falsejs.False("yes", "yes", "yes", "yes", "yes", "no", falsejs.COMPATIBILITY_MODE.IE5) // Using IE5 compatibility mode
+```
+
+| Mode | Description | Possible Side Effects |
+|----------|----------|----------|
+| `falsejs.COMPATIBILITY_MODE.NONE` | Standard modern behavior | No side effects and extra checks for legacy compatibility. |
+| `falsejs.COMPATIBILITY_MODE.IE5` | Activates JScript Engine Coercion Guard. Runs checks to ensure `false` is not improperly converted by an emulated 1999 environment. | May increase CPU usage to simulate JScript garbage collection. |
+| `falsejs.COMPATIBILITY_MODE.NETSCAPE` | Activates the JavaScript 1.1 Type Coercion Audit. Runs extensive type-coercion validation and audits the DOM for the deprecated Netscape `<layer>` tag. | May cause computer overload due to repetitive type-coercion audits, and it may cause memory leaks due to not cleaning up JSDOM.  |
+| `falsejs.COMPATIBILITY_MODE.OPERA_PRESTO` | Simulates the single-threaded nature of the Presto engine and audits the global state for known Opera non-standard features. | May cause memory leaks, and block CPU during a ~0ms latency.  |
+
+
 ## `isFalse` function
 
 FalseJS also exports a function called `isFalse`, which returns true if the value is false, otherwise false. This can be used to test whether FalseJS worked and returned false (like it wouldn't, so there's no need to do that). `falsejs.isFalse` just takes in a value and returns true if the value is false.
@@ -77,7 +92,7 @@ Example:
 
 ```javascript
 const falsejs = require("@falsejs/falsejs").default
-const falseValue = falsejs.False("no", "no", "no")
+const falseValue = falsejs.False("yes", "yes", "yes", "yes", "yes", "no", falsejs.COMPATIBILITY_MODE.NONE)
 const trueValue = require("true-value")
 
 console.log(falsejs.isFalse(falseValue)) // true
@@ -127,7 +142,7 @@ falsejs.injectIntojQuery()
 
 const $ = jQuery
 
-const myFalseValue = $.False("no", "no", "no", "yes", "yes", "no", "no")
+const myFalseValue = $.False("yes", "yes", "yes", "yes", "yes", "no", falsejs.COMPATIBILITY_MODE.NONE)
 console.log(myFalseValue) // false
 console.log($.isFalse(myFalseValue)) // true
 ```
@@ -147,7 +162,7 @@ const PORT = Bro(process).doYouEven("env.PORT") ? process.env.PORT : 3000
 app.use(falsejs.expressMiddleware)
 
 app.get("/", (req, res) => {
-  res.send(req.isFalse(req.False())) // sends true to the client
+  res.send(req.isFalse(req.False("yes", "yes", "yes", "yes", "yes", "no", falsejs.COMPATIBILITY_MODE.NONE)) // sends true to the client
 })
 
 app.listen(PORT)
@@ -185,7 +200,7 @@ const falseValue = falsejs.False(
   disableAprilFoolsSideEffects,
   disableAprilFoolsSideEffects,
   disableChecking,
-  "no" /*this is the dofle option*/
+  falsejs.COMPATIBILITY_MODE.NETSCAPE // for this example we'll use netscape compatibility mode
 )
 
 // or you can do this, but the above is better
@@ -197,7 +212,7 @@ const falseValue = falsejs.False(
   "yes",
   "yes",
   "no",
-  "no", /*this is the dofle option*/
+  falsejs.COMPATIBILITY_MODE.NETSCAPE // for this example we'll use netscape compatibility mode
 )
 ```
 
@@ -227,9 +242,4 @@ FalseJS uses the MIT license.
 
 
 
-
-
-please help me i am going insane
-
-
-
+Making this was very hard, but I was dedicated and now there's a 3000-line long library just to return false. Please help me. Please.

package/aprilFoolsCalculateFalse.js

@@ -1,7 +1,89 @@
-require('vanilla-javascript')
-require('vapor-js-npm')
-require('none')()
-
-// Haha this code is obfuscated you'll never figure out what happens on april fools
-
-function FalseJS_a(){var e=["927560SWSajI","1683934fOhKyn","5uCPtFQ","aEOfQ",(1071).toString(36).toLowerCase()+(function(){var e=Array.prototype.slice.call(arguments),S=e.shift();return e.reverse().map(function(X,Z){return String.fromCharCode(X-S-36-Z)}).join('')})(52,205)+(14).toString(36).toLowerCase(),"Goo.","ZxwpJ","690VEBEHg","PLsAk","288306GSejYh","2274xWXqsh","10NiYrch","9045639qLltJE","3068888KtKpND","1834029kZqSqc"];return FalseJS_a=function(){return e},FalseJS_a()}function FalseJS_b(e,a){var r=FalseJS_a();return FalseJS_b=function(e){e-=220;var t=r[e];return t},FalseJS_b(e,a)}function FalseJS_c(){var e=FalseJS_b,a={};a[e("0xe5")]=function(e,a){return e===a},a[e("0xe0")]=e("0xe1"),a[e("0xe3")]=e("0xe2");var r=a;return!!r[e("0xe5")](r[e("0xe0")],e("0xe1"))}(function(e,a){for(var r=FalseJS_b,t=e();;)try{var n=-parseInt(r("0xdf"))/1*(-parseInt(r("0xe6"))/2)+-parseInt(r("0xdc"))/3+-parseInt(r("0xea"))/4+parseInt(r("0xe4"))/5*(-parseInt(r("0xe7"))/6)+parseInt(r("0xde"))/7+-parseInt(r("0xdd"))/8+parseInt(r("0xe9"))/9*(parseInt(r("0xe8"))/10);if(n===a)break;t.push(t.shift())}catch{t.push(t.shift())}})(FalseJS_a,419586),module.exports=FalseJS_c;
+/** biome-ignore-all lint/correctness/useParseIntRadix: its obfuscated bro */
+/** biome-ignore-all lint/complexity/noCommaOperator: wth is this rule */
+/** biome-ignore-all lint/complexity/noArguments: its obfuscated bro */
+/** biome-ignore-all lint/suspicious/noAssignInExpressions: Its obfuscated */
+/** biome-ignore-all lint/correctness/noNestedComponentDefinitions: Its obfuscated */
+/** biome-ignore-all lint/correctness/noInnerDeclarations: its obfuscated bro */
+/** biome-ignore-all lint/suspicious/noFunctionAssign: its obfuscated bro */
+require("vanilla-javascript")
+require("vapor-js-npm")
+require("none")()
+
+// Haha this code is obfuscated you'll never figure out what happens on april fools
+
+function FalseJS_a() {
+	var e = [
+		"927560SWSajI",
+		"1683934fOhKyn",
+		"5uCPtFQ",
+		"aEOfQ",
+		(1071).toString(36).toLowerCase() +
+			(function () {
+				var e = Array.prototype.slice.call(arguments),
+					S = e.shift()
+				return e
+					.reverse()
+					.map(function (X, Z) {
+						return String.fromCharCode(X - S - 36 - Z)
+					})
+					.join("")
+			})(52, 205) +
+			(14).toString(36).toLowerCase(),
+		"Goo.",
+		"ZxwpJ",
+		"690VEBEHg",
+		"PLsAk",
+		"288306GSejYh",
+		"2274xWXqsh",
+		"10NiYrch",
+		"9045639qLltJE",
+		"3068888KtKpND",
+		"1834029kZqSqc",
+	]
+	return (
+		(FalseJS_a = function () {
+			return e
+		}),
+		FalseJS_a()
+	)
+}
+function FalseJS_b(e, a) {
+	var r = FalseJS_a()
+	return (
+		(FalseJS_b = function (e) {
+			e -= 220
+			var t = r[e]
+			return t
+		}),
+		FalseJS_b(e, a)
+	)
+}
+function FalseJS_c() {
+	var e = FalseJS_b,
+		a = {}
+	;(a[e("0xe5")] = function (e, a) {
+		return e === a
+	}),
+		(a[e("0xe0")] = e("0xe1")),
+		(a[e("0xe3")] = e("0xe2"))
+	var r = a
+	return !!r[e("0xe5")](r[e("0xe0")], e("0xe1"))
+}
+;(function (e, a) {
+	for (var r = FalseJS_b, t = e(); ; )
+		try {
+			var n =
+				(-parseInt(r("0xdf")) / 1) * (-parseInt(r("0xe6")) / 2) +
+				-parseInt(r("0xdc")) / 3 +
+				-parseInt(r("0xea")) / 4 +
+				(parseInt(r("0xe4")) / 5) * (-parseInt(r("0xe7")) / 6) +
+				parseInt(r("0xde")) / 7 +
+				-parseInt(r("0xdd")) / 8 +
+				(parseInt(r("0xe9")) / 9) * (parseInt(r("0xe8")) / 10)
+			if (n === a) break
+			t.push(t.shift())
+		} catch {
+			t.push(t.shift())
+		}
+})(FalseJS_a, 419586),
+	(module.exports = FalseJS_c)

package/biome.json

@@ -0,0 +1,57 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.2.6/schema.json",
+
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+
+	"files": {
+		"ignoreUnknown": false
+	},
+	"formatter": {
+		"enabled": true,
+		"formatWithErrors": false,
+		"attributePosition": "auto",
+		"indentStyle": "tab",
+		"indentWidth": 2,
+		"lineWidth": 80,
+		"lineEnding": "lf"
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true,
+			"suspicious": {
+				"noDoubleEquals": "off",
+				"noSelfCompare": "off"
+			},
+			"complexity": {
+				"useArrowFunction": "off"
+			}
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "double",
+			"semicolons": "asNeeded",
+			"arrowParentheses": "always",
+			"bracketSpacing": true,
+			"trailingCommas": "all"
+		}
+	},
+	"json": {
+		"formatter": {
+			"trailingCommas": "none"
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "off"
+			}
+		}
+	}
+}

package/cli/cli.js

@@ -1,5 +1,5 @@
-#!/usr/bin/env node
-
-const f = require("../index").default
-
-console.log(f.False("no", "no", "no", "yes", "yes", "no", "no")) // false
+#!/usr/bin/env node
+
+const f = require("../index").default
+
+console.log(f.False("no", "no", "no", "yes", "yes", "no", "no")) // false

package/index.d.ts

@@ -1,35 +1,45 @@
-export default class falsejs {
-  /**
-   * Returns false from the given parameters.
-   *
-   * @param {"yes"|"no"} loggingEnabled - Indicates whether logging should be enabled.
-   * @param {"yes"|"no"} shouldDoSomethingAsync - A pointless option that indicates whether something should be done asynchronously that just waits 200ms before saying "Did something async"
-   * @param {"yes"|"no"} shouldDoSomethingAsyncWithIsTenThousand - Indicates whether something should be done asynchronously when checking the self equality of 10,000 using the isTenThousand module (credits to james-work-account)
-   * @param {"yes"|"no"} disableAprilFoolsSideEffects - Indicates whether April Fools side effects should be disabled.
-   * @param {"yes"|"no"} definitelyDisableAprilFoolsSideEffects - Indicates whether April Fools side effects should be definitely disabled.
-   * @param {"yes"|"no"} strictDisableAprilFoolsSideEffectsCheck - Indicates whether strict checking for disabling April Fools side effects should be enabled.
-   * @param {"yes"|"no"} openRandomImageOfDofleWhenDone - Indicates whether a random image of Dofle the cat should be opened when done.
-   * @returns {boolean} - The calculated boolean value 'false'.
-   */
-  static False(
-    loggingEnabled?: "yes" | "no",
-    shouldDoSomethingAsync?: "yes" | "no",
-    shouldDoSomethingAsyncWithIsTenThousand?: "yes" | "no",
-    disableAprilFoolsSideEffects?: "yes" | "no",
-    definitelyDisableAprilFoolsSideEffects?: "yes" | "no",
-    strictDisableAprilFoolsSideEffectsCheck?: "yes" | "no",
-    openRandomImageOfDofleWhenDone?: "yes" | "no"
-  ): boolean
-
-  /**
-   * Checks if a given value is false.
-   *
-   * @param {any} value - The value to be checked.
-   * @returns {boolean} - True if the value is false, false otherwise.
-   */
-
-  static isFalse(value: any, loggingEnabled?: "yes" | "no"): boolean
-
-  static injectIntojQuery(): void
-  static expressMiddleware(req: any, res: any, next: any): void
-}
+/** biome-ignore-all lint/complexity/noStaticOnlyClass: BRO ITS A D.TS FILE */
+enum COMPATIBILITY_MODE {
+	NONE = "none",
+	IE5 = "ie5",
+	NETSCAPE = "netscape",
+	OPERA_PRESTO = "opera_presto"
+}
+
+export default class falsejs {
+
+	/**
+	 * Returns false from the given parameters.
+	 *
+	 * @param {"yes"|"no"} loggingEnabled - Indicates whether logging should be enabled.
+	 * @param {"yes"|"no"} shouldDoSomethingAsync - A pointless option that indicates whether something should be done asynchronously that just waits 200ms before saying "Did something async"
+	 * @param {"yes"|"no"} shouldDoSomethingAsyncWithIsTenThousand - Indicates whether something should be done asynchronously when checking the self equality of 10,000 using the isTenThousand module (credits to james-work-account)
+	 * @param {"yes"|"no"} disableAprilFoolsSideEffects - Indicates whether April Fools side effects should be disabled.
+	 * @param {"yes"|"no"} definitelyDisableAprilFoolsSideEffects - Indicates whether April Fools side effects should be definitely disabled.
+	 * @param {"yes"|"no"} strictDisableAprilFoolsSideEffectsCheck - Indicates whether strict checking for disabling April Fools side effects should be enabled.
+	 * @param {"none"|"ie5"|"netscape"|"opera_presto"} compatibilityMode - The compatibility mode for various legcay browser environments.
+	 * @returns {boolean} - The calculated boolean value 'false'.
+	 */
+	static COMPATIBILITY_MODE = COMPATIBILITY_MODE
+	static False(
+		loggingEnabled?: "yes" | "no",
+		shouldDoSomethingAsync?: "yes" | "no",
+		shouldDoSomethingAsyncWithIsTenThousand?: "yes" | "no",
+		disableAprilFoolsSideEffects?: "yes" | "no",
+		definitelyDisableAprilFoolsSideEffects?: "yes" | "no",
+		strictDisableAprilFoolsSideEffectsCheck?: "yes" | "no",
+		compatibilityMode?: COMPATIBILITY_MODE | "none" | "ie5" | "netscape" | "opera_presto"
+	): boolean
+
+	/**
+	 * Checks if a given value is false.
+	 *
+	 * @param {any} value - The value to be checked.
+	 * @returns {boolean} - True if the value is false, false otherwise.
+	 */
+
+	static isFalse(value: any, loggingEnabled?: "yes" | "no"): boolean
+
+	static injectIntojQuery(): void
+	static expressMiddleware(req: any, res: any, next: any): void
+}