@falsejs/falsejs 1.0.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 10x'ly Made.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+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.

package/README.md

@@ -0,0 +1,236 @@
+<img src="falsejs-logo.png" alt="Logo" width="600">
+
+# FalseJS
+
+#### Better than the keyword itself.
+
+Ever wondered what would happen if JavaScript changed the `false` keyword to something else, like `no`, `nope`, `noway`, or something else? Chaos. That is what FalseJS is for.
+
+
+
+The 10 attempts to get the value of false ensure that if one fails, it will go on to the next, so if JavaScript breaks one, there will still be more attempts. This is an alternative to the library `false` by mde, which uses the hardcoded boolean value `false` (which I believe they are trying to resolve on the sister library `true`, which will probably be passed down to the `false` library), and is way too short. FalseJS is way better. It includes checks for whether your computer is on fire as well, just in case it *is* on fire.
+
+## Installation
+
+Install FalseJS with your favorite package manager.
+
+NPM: `npm install falsejs`
+
+Yarn: `yarn add falsejs`
+
+PNPM: `pnpm add falsejs`
+
+Import it with require:
+
+```javascript
+const falsejs = require("falsejs").default
+```
+
+Import it with import:
+
+```javascript
+import falsejs from "falsejs"
+```
+
+## Usage
+
+`falsejs.False` is a function that calculates the boolean value false and returns it. It takes three arguments.
+
+```
+function False(
+  loggingEnabled?: "yes" | "no",
+  shouldDoSomethingAsync?: "yes" | "no",
+  shouldDoSomethingAsyncWithIsTenThousand?: "yes" | "no",
+  disableAprilFoolsSideEffects?: "yes" | "no",
+  definitelyDisableAprilFoolsSideEffects?: "yes" | "no",
+  strictDisableAprilFoolsSideEffectsCheck?: "yes" | "no",
+  openRandomImageOfDofleWhenDone?: "yes" | "no"
+): boolean
+```
+
+The first argument is `loggingEnabled`, which is whether to output useful and funny logs or not. This can be `"yes"` or `"no"`. Some logs may still be output even when you pass in `"no"`, because FalseJS uses other libraries that may log things without user consent. `"yes"` and `"no"` are basically `true` and `false`, except the whole reason you're calling the function is to get a boolean, so it wouldn't make sense to pass in a boolean.
+
+The second argument, `shouldDoSomethingAsync`, is whether FalseJS should do an asyncronhous promise-based setTimeout and when it's done, if logging is enabled, output `[falsejs] Did something async` in green. This is just a pointless feature that is by default `"no"`, because it can be `"yes"` or `"no"`.
+
+The third argument, `shouldDoSomethingAsyncWithIsTenThousand`, is whether `is-ten-thousand`, a package used by FalseJS, should have an asynchronous promise-based setTimeout before it checks if a value is 10,000. It can be `"yes"` or `"no"`.
+
+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.
+
+## Example
+
+```javascript
+const falsejs = require("falsejs").default
+const falseValue = falsejs.False("yes", "no", "no", "yes", "yes", "no", "no") // outputs a bunch of logs
+
+console.log(falseValue) // outputs false
+```
+
+## `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.
+
+It takes in two parameters, the value to check whether it is false, and `loggingEnabled` which can be `"yes"` or `"no"`.
+
+Example:
+
+```javascript
+const falsejs = require("falsejs").default
+const falseValue = falsejs.False("no", "no", "no")
+const trueValue = require("true-value")
+
+console.log(falsejs.isFalse(falseValue)) // true
+console.log(falsejs.isFalse(false)) // probably true
+console.log(falsejs.isFalse(trueValue)) // false
+console.log(falsejs.isFalse("hi")) // false
+```
+
+`falsejs.isFalse` can also be used as an alternative to running the `falsejs.False` function and instead just passing a value that isn't false into `falsejs.isFalse`.
+
+## CLI
+
+NPM:
+
+```
+npm install -g falsejs
+```
+
+Yarn:
+
+```
+yarn add -g falsejs
+```
+
+PNPM:
+
+```
+pnpm add -g falsejs
+```
+
+FalseJS provides a CLI.
+
+```bash
+$ npm install -g falsejs
+$ false
+false
+```
+
+## jQuery plugin
+
+A jQuery plugin is also provided for FalseJS. Here is an example:
+
+```javascript
+const falsejs = require("falsejs").default
+global.jQuery = require("jquery")
+falsejs.injectIntojQuery()
+
+const $ = jQuery
+
+const myFalseValue = $.False("no", "no", "no", "yes", "yes", "no", "no")
+console.log(myFalseValue) // false
+console.log($.isFalse(myFalseValue)) // true
+```
+
+## Express middleware
+
+Express middleware is also exported. Here is an example:
+
+```javascript
+const express = require("express")
+const falsejs = require("falsejs").default
+const Bro = require("brototype")
+
+const app = express()
+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
+})
+
+app.listen(PORT)
+```
+
+## April Fools Behavior
+
+### **Not April Fools Day**
+
+- **FalseJS will return** `false` by default.
+- The flags `disableAprilFoolsSideEffects` and `definitelyDisableAprilFoolsSideEffects` **do not affect the behavior** of FalseJS. It behaves normally as it would on any non-April Fools' Day.
+  - However, if `strictDisableAprilFoolsSideEffectsCheck` is **not `no"`** and instead `"yes"` (by default it's `"yes"`), it will throw an error if these options are set to `"yes"`, because it's not April Fools' Day, and there are no side effects to disable.
+  - If `strictDisableAprilFoolsSideEffectsCheck` is set to **"no"**, FalseJS behaves normally without throwing an error, even if the side effect parameters are set to `"yes"`.
+
+### **April Fools Day**
+
+- **On April Fools' Day**, FalseJS **always returns `true`**, regardless of the state of the flags.
+- **To prevent this behavior**, you must set both `disableAprilFoolsSideEffects` to `"yes"` and `definitelyDisableAprilFoolsSideEffects` to `"yes"` when you call FalsejS.
+  - If these flags are set to `"yes"`, FalseJS will return its expected behavior (return `false`), even on April Fools' Day.
+
+### **Best Usage For April Fools Behavior**
+
+This usage ensures that you will always get `false` whether it's April Fools or not and no errors.
+
+```js
+const falsejs = require("falsejs").default
+const isAprilFools = require("is-april-fools")
+const disableAprilFoolsSideEffects = isAprilFools() ? "yes" : "no"
+const disableChecking = isAprilFools() ? "no" : "yes"
+
+const falseValue = falsejs.False(
+  "no",
+  "no",
+  "no" /*the first three options you can choose, for examples we set them all to "no"*/,
+  disableAprilFoolsSideEffects,
+  disableAprilFoolsSideEffects,
+  disableChecking,
+  "no" /*this is the dofle option*/
+)
+
+// or you can do this, but the above is better
+
+const falseValue = falsejs.False(
+  "no",
+  "no",
+  "no" /*the first three options you can choose, for examples we set them all to "no"*/,
+  "yes",
+  "yes",
+  "no",
+  "no", /*this is the dofle option*/
+)
+```
+
+## Important
+In the console you may see this error:
+```
+Warning: React does not recognize the `getMember` prop on a DOM element. If you intentionally want it to appear in the DOM as a custom attribute, spell it as lowercase `getmember` instead. If you accidentally passed it from a parent component, remove it from the DOM element.
+    at div
+    at NoComponent
+```
+This is normal. Do not worry. FalseJS uses a package called `get-member` that adds a `getMember` method to every object. React elements are objects, so it gets confused. You may wonder why there's a React error even if you're not using React, but FalseJS uses React.
+
+## Related Projects
+
+- [true-value](https://github.com/tj-commits/true-value) (the sister project)
+- [false](https://github.com/mde/false)
+- [true](https://github.com/mde/true)
+- [alternative-true](https://github.com/donavon/alternative-true)
+- [undefined-is-a-function](https://github.com/donavon/undefined-is-a-function)
+
+## License
+
+FalseJS uses the MIT license.
+
+## made with HEAVY BLACK HEART U+2764
+
+
+
+
+
+
+## Footnote: i am running out of version numbers
+please help me i am going insane
+
+
+

package/Sanity.md

@@ -0,0 +1,16 @@
+Hi there.
+it's me tj-commits.
+i am running out of version numbers.
+i'm struggling to stay sane
+keep me sane
+i don't want to lose sanity
+i cant even comprehend life and existence anymore
+my masterpieces, coding and spotify fox jones dont eaven mean anything
+I didn't choose the 10x life. The 10x life chose me.
+why did the 10x life choose me
+10x engineers is good
+but why bad
+why is mental breakdown direct result of 10x
+right now the world doesnt make the sense to i
+please save me
+help

package/aprilFoolsCalculateFalse.js

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

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

package/dofle/.last-photo

@@ -0,0 +1 @@
+IMG_6627.jpg

package/dofle/dofle.js

@@ -0,0 +1,19 @@
+const fs = require('node:fs')
+const path = require('node:path')
+const open = require('open')
+const randomItem = require('lodash').sample
+
+const photosDirectory = path.join(__dirname, 'photos')
+const photos = fs.readdirSync(photosDirectory).filter(directory => !directory.startsWith('.'))
+let randomPhoto = randomItem(photos)
+
+const lastPicPath = path.join(__dirname, '.last-photo')
+if (fs.existsSync(lastPicPath) && fs.readFileSync(lastPicPath, 'utf8') === randomPhoto) {
+	randomPhoto = randomItem(photos)
+}
+
+fs.writeFileSync(lastPicPath, randomPhoto);
+
+(async () => {
+	await open(path.join(photosDirectory, randomPhoto));
+})()

package/dofle/photos/readme.md

@@ -0,0 +1,21 @@
+# All photos
+
+![](10607915_273427569527101_1304478306_n.jpg)
+![](10724032_717703524951446_2042592910_n.jpg)
+![](10899508_1582361792014679_2073623926_n.jpg)
+![](11203394_810705079039370_1638320906_n.jpg)
+![](IMG_0001.jpg)
+![](IMG_0005.jpg)
+![](IMG_0009.jpg)
+![](IMG_0734.jpg)
+![](IMG_0805.jpg)
+![](IMG_0841.jpg)
+![](IMG_1136.jpg)
+![](IMG_1140.jpg)
+![](IMG_1832.jpg)
+![](IMG_2087.jpg)
+![](IMG_3139.jpg)
+![](IMG_6404.jpg)
+![](IMG_6594.jpg)
+![](IMG_6627.jpg)
+![](IMG_8443.jpg)

package/eslint.config.mjs

@@ -0,0 +1,13 @@
+import js from "@eslint/js";
+import globals from "globals";
+import { defineConfig } from "eslint/config";
+
+
+export default defineConfig([
+  { files: ["**/*.{js,mjs,cjs}"], plugins: { js }, extends: ["js/recommended"] },
+  { files: ["**/*.js"], languageOptions: { sourceType: "commonjs" }, rules: {
+    "no-extra-boolean-cast": "off",
+    "no-func-assign": "off"
+  } },
+  { files: ["**/*.{js,mjs,cjs}"], languageOptions: { globals: globals.node } },
+]);

package/index.d.ts

@@ -0,0 +1,35 @@
+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
+}