Merge branch 'main' into safe-compare

Author: gameroman

README.md

@@ -11,8 +11,7 @@ We provide two things:
 
 ## List of replacements
 
-You can find a list of replacements in the
-[modules readme](./docs/modules/README.md).
+You can find a list of replacements on the [e18e website](https://e18e.dev/docs/replacements/).
 
 ## Tools
 
@@ -21,6 +20,8 @@ Some tools consume the lists of modules in this repository:
 | Name                                                                       | Description                                   |
 | -------------------------------------------------------------------------- | --------------------------------------------- |
 | [eslint-plugin-depend](https://github.com/es-tooling/eslint-plugin-depend) | ESLint plugin to detect possible replacements |
+| [@e18e/eslint-plugin](https://github.com/e18e/eslint-plugin)               | Official e18e ESLint plugin                   |
+| [npmx](https://npmx.dev)                                                   | Alternative npm frontend                      |
 
 ## Manifests
 

docs/modules/README.md

@@ -0,0 +1,27 @@
+---
+description: Modern alternatives to packages for deep merging objects
+---
+
+# Replacements for deep merge packages
+
+## `defu`
+
+If you need to deep merge two objects, you can use [`defu`](https://github.com/unjs/defu):
+
+```ts
+import { defu } from 'defu'
+
+const options = defu(object, defaults)
+```
+
+## `@fastify/deepmerge`
+
+The [`@fastify/deepmerge`](https://github.com/fastify/deepmerge) package is another fast and small alternative.
+
+It also offers more options for customizing the merge behavior than other libraries.
+
+```ts
+import deepMerge from '@fastify/deepmerge'
+
+const options = deepMerge(object, defaults)
+```

docs/modules/deep-merge.md

@@ -0,0 +1,45 @@
+---
+description: Modern alternatives to CLI argument parsing packages using Node.js built-in util.parseArgs
+---
+
+# Replacements for argument parsers
+
+## `util.parseArgs` (native, since Node.js 16.x)
+
+[`util.parseArgs`](https://nodejs.org/api/util.html#utilparseargsconfig) is built into Node.js (since 18.3.0 and 16.17.0) and can replace many common CLI options parsing libraries.
+
+Example:
+
+```ts
+import { parseArgs } from 'node:util'
+
+const { values, positionals } = parseArgs({
+  args: process.argv.slice(2),
+  options: {
+    force: { type: 'boolean', short: 'f' },
+    output: { type: 'string', short: 'o' }
+  },
+  allowPositionals: true
+})
+```
+
+> [!NOTE]
+> `parseArgs` only supports `string` and `boolean` types. If you'd like to support stronger types, one of the other options may be a better fit.
+
+## `mri`
+
+[`mri`](https://github.com/lukeed/mri) is a minimalistic argument parser that supports both short and long options, as well as positional arguments.
+
+Example:
+
+```ts
+import mri from 'mri'
+
+const options = mri(process.argv.slice(2), {
+  alias: {
+    f: 'force',
+    o: 'output'
+  },
+  boolean: ['force']
+})
+```

docs/modules/parseargs.md

@@ -0,0 +1,19 @@
+---
+description: Modern alternatives to the portfinder package for finding an available port
+---
+
+# Replacements for `portfinder`
+
+## `get-port`
+
+[`get-port`](https://github.com/sindresorhus/get-port) is a lighter and more modern package for finding an available port.
+
+Example:
+
+```ts
+import portfinder from 'portfinder' // [!code --]
+import getPort from 'get-port' // [!code ++]
+
+const port = await portfinder.getPortPromise() // [!code --]
+const port = await getPort() // [!code ++]
+```

docs/modules/portfinder.md

@@ -124,8 +124,7 @@
       "required": [
         "id",
         "replacementModule",
-        "type",
-        "url"
+        "type"
       ],
       "additionalProperties": false
     },

manifest-schema.json

@@ -12,12 +12,24 @@
       "description": "You can use a combination of `filter` and `includes` to calculate the difference between two arrays.",
       "example": "const difference = (a, b) => a.filter((item) => !b.includes(item))"
     },
+    "snippet::array-flatten": {
+      "id": "snippet::array-flatten",
+      "type": "simple",
+      "description": "You can use `Array.prototype.flat` with `Infinity` as an argument to fully flatten an array.",
+      "example": "array.flat(Infinity)"
+    },
     "snippet::array-from-count": {
       "id": "snippet::array-from-count",
       "type": "simple",
       "description": "You can use `Array.from` to create an array of sequential integers",
       "example": "Array.from({ length: n }, (_, i) => i);"
     },
+    "snippet::array-from-count-with-start": {
+      "id": "snippet::array-from-count-with-start",
+      "type": "simple",
+      "description": "You can use `Array.from` to create an array of sequential integers starting from a specific integer",
+      "example": "Array.from({ length: end - start }, (_, i) => i + start);"
+    },
     "snippet::array-last": {
       "id": "snippet::array-last",
       "type": "simple",
@@ -162,6 +174,12 @@
       "description": "If the current environment is npm the `npm_config_user_agent` environment variable will be set and start with `\"npm\"`.",
       "example": "const isNpm = process.env.npm_config_user_agent?.startsWith(\"npm\")"
     },
+    "snippet::is-number": {
+      "id": "snippet::is-number",
+      "type": "simple",
+      "description": "You can check if a value is a number by using `typeof` or coercing it to a number and using `Number.isFinite`.",
+      "example": "const isNumber = (v) => typeof v === \"number\" || (typeof v === \"string\" && Number.isFinite(+v));"
+    },
     "snippet::is-object": {
       "id": "snippet::is-object",
       "type": "simple",
@@ -306,11 +324,11 @@
       "description": "You can check the start of a path for the Windows extended-length path prefix and if it's not present, replace backslashes with forward slashes.",
       "example": "path.startsWith('\\\\\\\\?\\\\') ? path : path.replace(/\\\\/g, '/')"
     },
-    "snippet:is-number": {
-      "id": "snippet:is-number",
+    "snippet::year": {
+      "id": "snippet::year",
       "type": "simple",
-      "description": "You can check if a value is a number by using `typeof` or coercing it to a number and using `Number.isFinite`.",
-      "example": "const isNumber = (v) => typeof v === \"number\" || (typeof v === \"string\" && Number.isFinite(+v));"
+      "description": "You can use `new Date().getUTCFullYear()` to get the current year.",
+      "example": "new Date().getUTCFullYear()"
     }
   },
   "mappings": {
@@ -319,6 +337,11 @@
       "moduleName": "arr-diff",
       "replacements": ["snippet::array-difference"]
     },
+    "arr-flatten": {
+      "type": "module",
+      "moduleName": "arr-flatten",
+      "replacements": ["snippet::array-flatten"]
+    },
     "array-back": {
       "type": "module",
       "moduleName": "array-back",
@@ -339,6 +362,11 @@
       "moduleName": "array-last",
       "replacements": ["snippet::array-last"]
     },
+    "array-range": {
+      "type": "module",
+      "moduleName": "array-range",
+      "replacements": ["snippet::array-from-count-with-start"]
+    },
     "array-union": {
       "type": "module",
       "moduleName": "array-union",
@@ -482,12 +510,12 @@
     "is-number": {
       "type": "module",
       "moduleName": "is-number",
-      "replacements": ["snippet:is-number"]
+      "replacements": ["snippet::is-number"]
     },
     "is-number-object": {
       "type": "module",
       "moduleName": "is-number-object",
-      "replacements": ["snippet:is-number"]
+      "replacements": ["snippet::is-number"]
     },
     "is-obj": {
       "type": "module",
@@ -643,6 +671,11 @@
       "type": "module",
       "moduleName": "upper-case",
       "replacements": ["snippet::to-uppercase"]
+    },
+    "year": {
+      "type": "module",
+      "moduleName": "year",
+      "replacements": ["snippet::year"]
     }
   }
 }