@meistrari/mise-en-place 2.9.0 → 2.10.1

package/Makefile

@@ -2,6 +2,7 @@
 default: help
 
 _MISE_EN_PLACE_PACKAGE_NAME = @meistrari/mise-en-place
+MISE_EN_PLACE_INSTALL_DIR ?= .
 
 # region Public commands
 
@@ -21,7 +22,7 @@ mise-en-place: .editorconfig ## Setup the mise en place to start cooking
 .PHONY: help
 help:
 	@echo "Make tasks:"
-	@grep -hE '^[%a-zA-Z_-]+:.*?## .*$$' Makefile ./node_modules/$(_MISE_EN_PLACE_PACKAGE_NAME)/Makefile | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m  %-17s\033[0m %s\n", $$1, $$2}'
+	@grep -hE '^[%a-zA-Z_-]+:.*?## .*$$' Makefile $(MISE_EN_PLACE_INSTALL_DIR)/node_modules/$(_MISE_EN_PLACE_PACKAGE_NAME)/Makefile | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m  %-17s\033[0m %s\n", $$1, $$2}'
 	@echo ""
 
 # endregion

package/README.md

@@ -15,30 +15,41 @@ Add `mise-en-place postinstall` to your project's `package.json` `postinstall` s
 }
 ```
 
-Then install the package as a development dependency:
+Then install the package as a development dependency and run the postinstall script:
 ```sh
-npm i -D @meistrari/mise-en-place
+bun i -D @meistrari/mise-en-place
+bunx mise-en-place postinstall
 ```
 
-After installing, it will create a `Makefile` in your project if one does not already exist.
-If you already have a `Makefile`, you can manually include this project's Makefile by adding the following line to your existing `Makefile`:
-```makefile
-include ./node_modules/@meistrari/mise-en-place/Makefile
-```
-
-It will also setup the initial _mise-en-place_ in your project.
+It will also setup the initial _mise-en-place_ in your project. Which includes:
+- Adding a `Makefile` with useful commands.
+- Adding an `.editorconfig` file.
+- Adding ESLint configuration.
+- Adding TypeScript configuration.
+- Setting up `postinstall` script to keep all `@meistrari/*` packages up to date.
 
 # Features
 
 ## Keep all @meistrari/* packages up to date
-By adding the `postinstall` script, every time you run `npm install`, it will check for the latest versions of all `@meistrari/*` packages in your project and update them if necessary.
+By adding the `postinstall` script to run `mise-en-place postinstall`, every time you run install your dependencies, it will check for the latest versions of all `@meistrari/*` packages in your project and update them if necessary.
+
+This process will add a leading caret (`^`) to the version range if it is not already present. Which means that it will update to the latest minor and patch versions automatically but never the major version.
 
 ## Makefile
 Commands with `##` after the target are 'public' commands and are intended to be used by developers and will show up in the help message.
+
 The other commands are 'hidden' and are intended to be used by automations or by other 'public' commands.
 
+If you installed `@meistrari/mise-en-place` on a parent directory, you may need to set the `MISE_EN_PLACE_INSTALL_DIR` variable before including the `Makefile`:
+
+```Makefile
+MISE_EN_PLACE_INSTALL_DIR=.. # Parent directory
+-include $(MISE_EN_PLACE_INSTALL_DIR)/node_modules/@meistrari/mise-en-place/Makefile
+
+```
+
 ## EditorConfig
-Run `make .editorconfig` to copy this project's `.editorconfig` to your project.
+Since the editorconfig file [don't support extending from other files](https://github.com/editorconfig/editorconfig/issues/236), the postinstall script will always copy the `.editorconfig` file from this project to your project root.
 
 ## Eslint Config
 Add the following code in your `eslint.config.mjs` to include this project's ESLint configuration:
@@ -47,6 +58,23 @@ Add the following code in your `eslint.config.mjs` to include this project's ESL
 export { default } from '@meistrari/mise-en-place/eslint'
 ```
 
+> If some rules needs to be updated, you can update the rules in this project (preferrable) or customize them in your own configuration (not preferrable).
+> You probably don't need to customize the configuration, since it is already designed to be a good starting point for most projects.
+> Remember that customizing too much can make your project diverge from the standard and make it harder to maintain.
+
+If you understand the risk and NEED to customize the configuration, you can import the default configuration and extend it:
+
+```ts
+import miseEnPlaceEslintConfig from '@meistrari/mise-en-place/eslint'
+
+export default miseEnPlaceEslintConfig
+    .append({
+        rules: {
+            // your custom rules here
+        }
+    })
+```
+
 ## TSConfig
 
 Add the following code in your `tsconfig.json` to include this project's TypeScript configuration:

package/dist/eslint.mjs

@@ -1,6 +1,6 @@
 import antfu from '@antfu/eslint-config';
-import drizzle from 'eslint-plugin-drizzle';
 import * as eslintPluginDiff from 'eslint-plugin-diff';
+import drizzle from 'eslint-plugin-drizzle';
 
 const isCI = process.env.CI === "true";
 const eslintConfig = antfu(
@@ -24,7 +24,12 @@ const eslintConfig = antfu(
       overridesTypeAware: {
         "ts/no-floating-promises": "error",
         "ts/no-unnecessary-condition": "error",
-        "ts/return-await": ["error", "always"]
+        "ts/return-await": ["error", "always"],
+        /**
+         * Rule docs do not recommend this for newer TS Projects since the compiler already checks this
+         * @see {@link https://typescript-eslint.io/rules/no-redeclare/}
+         */
+        "ts/no-redeclare": "off"
       }
     },
     ignores: [
@@ -39,6 +44,14 @@ const eslintConfig = antfu(
       "**/node_modules"
     ],
     rules: {
+      // All the 'no-unsafe-*' rules cause too much noise and end up having us jumping through hoops to
+      // satisfy the linter with no actual runtime benefits. We can enable them again if we figure out a way to make them less noisy or more useful.
+      "ts/no-unsafe-assignment": "off",
+      "ts/no-unsafe-argument": "off",
+      "ts/no-unsafe-member-acces": "off",
+      "ts/no-unsafe-return": "off",
+      // No actual harm in unnecessary conditions. This is just a stylistic choice
+      "ts/no-unnecessary-condition": "off",
       "ts/strict-boolean-expressions": "off",
       "node/prefer-global/process": ["off", "always"],
       "ts/consistent-type-definitions": "off",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/mise-en-place",
-  "version": "2.9.0",
+  "version": "2.10.1",
   "description": "",
   "repository": {
     "type": "git",