@peerigon/configs 1.0.0-beta.9 → 1.0.0

package/CHANGELOG.md

@@ -1,3 +1,127 @@
+# 1.0.0 (2025-02-04)
+
+### Bug Fixes
+
+- Add rootDir to lib tsconfig ([764e0c1](https://github.com/peerigon/configs/commit/764e0c191f07dfd1d996937a4df488d56be5a159))
+- Adjust release script ([df43151](https://github.com/peerigon/configs/commit/df431514d28fd32d2bd69a50eeb8edf3e6cc1d44))
+- Adjust release script ([3668267](https://github.com/peerigon/configs/commit/366826718205e6f542f69d890a44c3595fa84340))
+- Changelog not formatted correctly ([cc12fa7](https://github.com/peerigon/configs/commit/cc12fa7abe725c4ab8597296094e2e485b1346e0))
+- CHANGELOG.md not being properly formatted ([22720ea](https://github.com/peerigon/configs/commit/22720ea8bc3aab0477a89094b24f567571860c15))
+- Downgrade ESLint ([d09f208](https://github.com/peerigon/configs/commit/d09f2084646c68fd9998685143563ba88ddaab0a))
+- Improve error message for no-default-export ([198c911](https://github.com/peerigon/configs/commit/198c91151a3dfd33339715c21ec95aa7c5bfbe05))
+- Missing files in package.json files array ([97111b6](https://github.com/peerigon/configs/commit/97111b66b1a741e25820bcf43b17355b59a95fca))
+- Missing packages write permission in Github action ([ce0d482](https://github.com/peerigon/configs/commit/ce0d4820e2e75f164f5385e48bd8978c250216f1))
+- Move package types to regular dependencies ([6d6c169](https://github.com/peerigon/configs/commit/6d6c1695989f04898a1e730b6320b2cbea158a8f))
+- noEmit setting in TypeScript configs ([281334c](https://github.com/peerigon/configs/commit/281334c3565ca0cd1afcc8d39a94857a0d42e9ae))
+- Prettify CHANGELOG.md ([f904e8d](https://github.com/peerigon/configs/commit/f904e8d535a8d04d615281bb942ccd8b2f12a9d9))
+- Relax switch-exhaustiveness-check rule ([2f158a4](https://github.com/peerigon/configs/commit/2f158a4a25770897c6140d3356161349b79c1cc2))
+- Remove rootDir config from lib tsconfig again ([84fe9dc](https://github.com/peerigon/configs/commit/84fe9dca95cdeba4e188d57a489ec6e12608fed4))
+- Turn of TS's exactOptionalPropertyTypes ([4069985](https://github.com/peerigon/configs/commit/4069985cad9b2da629e441cc1f02fd0e4be7f4a0))
+- Turn off unicorn/import-style ([f3be043](https://github.com/peerigon/configs/commit/f3be04315de51747319899f1ede9be15c1df5d6b))
+- Turn off unicorn/no-single-promise-in-promise-methods ([0557a83](https://github.com/peerigon/configs/commit/0557a83c45b2fe3198f84d47412c90fbb87ddd69))
+- TypeScript configs ([0c584e7](https://github.com/peerigon/configs/commit/0c584e70fd840e6ca857f4b177a21a389d958633))
+- Use cross-publish semantic release config ([c079ce0](https://github.com/peerigon/configs/commit/c079ce0df36b436ffc46da9e86a562855b8f2082))
+
+### Features
+
+- Add docs ([83e7f61](https://github.com/peerigon/configs/commit/83e7f617d6fc44abcd7e0d05c700299d8e2910c2))
+- Add shareable semantic-release config ([e0b585a](https://github.com/peerigon/configs/commit/e0b585a4eaaa4dbcfb206315870d3a22fa1d7186))
+- Also release on Github ([0e3e84f](https://github.com/peerigon/configs/commit/0e3e84f54a4689c8c0c3a340435346c351662cc9))
+- Enable .ts imports ([781a4a9](https://github.com/peerigon/configs/commit/781a4a97e15df6b218959c76c62a2e0893b3c026))
+- Improve CSS property sorting ([f9b9790](https://github.com/peerigon/configs/commit/f9b97901a318146bdaa81b9c2019e9038104b389))
+- Improve TS configs and add library types ([760a898](https://github.com/peerigon/configs/commit/760a8983b9d780601e7c6e2cb2c867f45f55f25f))
+- Initial release ([8f12887](https://github.com/peerigon/configs/commit/8f128873b8481832dea06c88115a785c3c7a3627))
+- Update dependencies ([07d0f37](https://github.com/peerigon/configs/commit/07d0f3781186cc86603444e0c2cf3b5185e3844a))
+- Update dependencies ([839e69c](https://github.com/peerigon/configs/commit/839e69cdfef60349772479b7f5a7105c81be9d93))
+- Update dependencies ([836a04f](https://github.com/peerigon/configs/commit/836a04f798741639837bb56fcf3ecbc028794c14))
+- Update dependencies ([6bb1f24](https://github.com/peerigon/configs/commit/6bb1f242e7de360d96868b8e2b6aea58ce493c31))
+
+# [1.0.0-beta.22](https://github.com/peerigon/configs/compare/v1.0.0-beta.21...v1.0.0-beta.22) (2025-02-04)
+
+### Features
+
+- Update dependencies ([07d0f37](https://github.com/peerigon/configs/commit/07d0f3781186cc86603444e0c2cf3b5185e3844a))
+
+# [1.0.0-beta.21](https://github.com/peerigon/configs/compare/v1.0.0-beta.20...v1.0.0-beta.21) (2025-01-27)
+
+### Bug Fixes
+
+- Missing packages write permission in Github action ([ce0d482](https://github.com/peerigon/configs/commit/ce0d4820e2e75f164f5385e48bd8978c250216f1))
+
+# [1.0.0-beta.20](https://github.com/peerigon/configs/compare/v1.0.0-beta.19...v1.0.0-beta.20) (2025-01-27)
+
+### Bug Fixes
+
+- Use cross-publish semantic release config ([c079ce0](https://github.com/peerigon/configs/commit/c079ce0df36b436ffc46da9e86a562855b8f2082))
+
+# [1.0.0-beta.19](https://github.com/peerigon/configs/compare/v1.0.0-beta.18...v1.0.0-beta.19) (2025-01-27)
+
+### Features
+
+- Enable .ts imports ([781a4a9](https://github.com/peerigon/configs/commit/781a4a97e15df6b218959c76c62a2e0893b3c026))
+- Update dependencies ([839e69c](https://github.com/peerigon/configs/commit/839e69cdfef60349772479b7f5a7105c81be9d93))
+
+# [1.0.0-beta.18](https://github.com/peerigon/configs/compare/v1.0.0-beta.17...v1.0.0-beta.18) (2025-01-26)
+
+### Features
+
+- Add docs ([83e7f61](https://github.com/peerigon/configs/commit/83e7f617d6fc44abcd7e0d05c700299d8e2910c2))
+
+# [1.0.0-beta.17](https://github.com/peerigon/configs/compare/v1.0.0-beta.16...v1.0.0-beta.17) (2025-01-20)
+
+### Bug Fixes
+
+- Changelog not formatted correctly ([cc12fa7](https://github.com/peerigon/configs/commit/cc12fa7abe725c4ab8597296094e2e485b1346e0))
+
+# [1.0.0-beta.16](https://github.com/peerigon/configs/compare/v1.0.0-beta.15...v1.0.0-beta.16) (2025-01-20)
+
+### Bug Fixes
+
+- CHANGELOG.md not being properly formatted ([22720ea](https://github.com/peerigon/configs/commit/22720ea8bc3aab0477a89094b24f567571860c15))
+
+### Features
+
+- Improve CSS property sorting ([f9b9790](https://github.com/peerigon/configs/commit/f9b97901a318146bdaa81b9c2019e9038104b389))
+
+# [1.0.0-beta.15](https://github.com/peerigon/configs/compare/v1.0.0-beta.14...v1.0.0-beta.15) (2024-12-30)
+
+### Bug Fixes
+
+- Remove rootDir config from lib tsconfig again ([84fe9dc](https://github.com/peerigon/configs/commit/84fe9dca95cdeba4e188d57a489ec6e12608fed4))
+
+# [1.0.0-beta.14](https://github.com/peerigon/configs/compare/v1.0.0-beta.13...v1.0.0-beta.14) (2024-12-30)
+
+### Bug Fixes
+
+- Add rootDir to lib tsconfig ([764e0c1](https://github.com/peerigon/configs/commit/764e0c191f07dfd1d996937a4df488d56be5a159))
+
+# [1.0.0-beta.13](https://github.com/peerigon/configs/compare/v1.0.0-beta.12...v1.0.0-beta.13) (2024-12-30)
+
+### Bug Fixes
+
+- Improve error message for no-default-export ([198c911](https://github.com/peerigon/configs/commit/198c91151a3dfd33339715c21ec95aa7c5bfbe05))
+
+# [1.0.0-beta.12](https://github.com/peerigon/configs/compare/v1.0.0-beta.11...v1.0.0-beta.12) (2024-12-30)
+
+### Bug Fixes
+
+- Turn off unicorn/import-style ([f3be043](https://github.com/peerigon/configs/commit/f3be04315de51747319899f1ede9be15c1df5d6b))
+
+# [1.0.0-beta.11](https://github.com/peerigon/configs/compare/v1.0.0-beta.10...v1.0.0-beta.11) (2024-12-15)
+
+### Bug Fixes
+
+- Move package types to regular dependencies ([6d6c169](https://github.com/peerigon/configs/commit/6d6c1695989f04898a1e730b6320b2cbea158a8f))
+- noEmit setting in TypeScript configs ([281334c](https://github.com/peerigon/configs/commit/281334c3565ca0cd1afcc8d39a94857a0d42e9ae))
+- Relax switch-exhaustiveness-check rule ([2f158a4](https://github.com/peerigon/configs/commit/2f158a4a25770897c6140d3356161349b79c1cc2))
+
+# [1.0.0-beta.10](https://github.com/peerigon/configs/compare/v1.0.0-beta.9...v1.0.0-beta.10) (2024-12-11)
+
+### Bug Fixes
+
+- Turn of TS's exactOptionalPropertyTypes ([4069985](https://github.com/peerigon/configs/commit/4069985cad9b2da629e441cc1f02fd0e4be7f4a0))
+- Turn off unicorn/no-single-promise-in-promise-methods ([0557a83](https://github.com/peerigon/configs/commit/0557a83c45b2fe3198f84d47412c90fbb87ddd69))
+
 # [1.0.0-beta.9](https://github.com/peerigon/configs/compare/v1.0.0-beta.8...v1.0.0-beta.9) (2024-12-09)
 
 ### Features

package/README.md

@@ -1,451 +1,74 @@
-# eslint-config-peerigon
+# configs
 
-**[Peerigon](https://peerigon.com/) coding rules as [ESLint](http://eslint.org/) config.**
+**Best practice configs for [ESLint](https://eslint.org/), [Prettier](https://prettier.io/), [TypeScript](https://www.typescriptlang.org/) & friends. By [Peerigon](https://www.peerigon.com/).**
 
-[![Version on NPM](https://img.shields.io/npm/v/eslint-config-peerigon?style=for-the-badge)](https://www.npmjs.com/package/eslint-config-peerigon)
+[![Version on NPM](https://img.shields.io/npm/v/@peerigon/configs?style=for-the-badge)](https://www.npmjs.com/package/@peerigon/configs)
 [![Semantically released](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge)](https://github.com/semantic-release/semantic-release)
-[![Monthly downloads on NPM](https://img.shields.io/npm/dm/eslint-config-peerigon?style=for-the-badge)](https://www.npmjs.com/package/eslint-config-peerigon)<br>
-[![License](https://img.shields.io/npm/l/eslint-config-peerigon?style=for-the-badge)](./LICENSE)
+[![Monthly downloads on NPM](https://img.shields.io/npm/dm/@peerigon/configs?style=for-the-badge)](https://www.npmjs.com/package/@peerigon/configs)<br>
+[![License](https://img.shields.io/npm/l/@peerigon/configs?style=for-the-badge)](./LICENSE)
 
-Linting and formatting rules are always a balance between
+## Installation
 
-- ease of reading
-- ease of refactoring
-- ease of writing.
-
-We think that
-
-- code is read more often than refactored
-- and refactored more often than written from scratch.
-
-Our linting rules have been designed with these assumptions in mind.
-
-## Table of contents
-
-- [Quick start](#quick-start)
-- [Practical guide](#practical-guide)
-- [Provided configs](#provided-configs)
-- [Styles](#styles)
-
-## Quick start
-
-Recommended configuration in your `package.json`:
-
-```js
-{
-    "scripts": {
-        "test:lint": "eslint --max-warnings 0 --cache",
-        "posttest": "npm run test:lint"
-    }
-}
-```
-
-We also offer a [Prettier](https://prettier.io/) config that matches our ESLint config. Create a `.prettierrc.json` in your project with the following content:
-
-```json
-"eslint-config-peerigon/prettier.config.js"
-```
-
-There are presets for the most common setups:
-
-### TypeScript
-
-```
-npm i eslint eslint-config-peerigon --save-dev
-```
-
-```js
-{
-    "extends": [
-        "peerigon/presets/typescript.js"
-    ],
-    "env": {
-        "node": true
-    },
-    "root": true
-}
-```
-
-### TypeScript + React
-
-```
-npm i eslint eslint-config-peerigon eslint-plugin-react eslint-plugin-jsx-a11y eslint-plugin-react-hooks --save-dev
-```
-
-```js
-{
-    "extends": [
-        "peerigon/presets/typescript-react.js"
-    ],
-    "env": {
-        "node": true,
-        "browser": true
-    },
-    "root": true
-}
-```
-
-### TypeScript + Node
-
-```
-npm i eslint eslint-config-peerigon eslint-plugin-n --save-dev
-```
-
-```js
-{
-    "extends": [
-        "peerigon/presets/typescript-node.js"
-    ],
-    "root": true
-}
-```
-
-## Practical guide
-
-### Disabling rules
-
-Try to disable as less rules as possible. In most cases it's best to just write
-
-```js
-// eslint-disable-next-line [rule-code]
-```
-
-where `[rule-code]` is the code that is displayed along the error message. Disabling the next line is usually better because it resists [Prettier](https://prettier.io/) reformatting.
-
-Sometimes it makes sense to disable a rule within a specifc file. In that case you can put the following snippet at the beginning of the file:
-
-```js
-/* eslint-disable [rule-code] */
-```
-
-If you don't agree with a rule, please do not just disable the rule. Often there are good reasons and the current setting is the result of years of experience. It's better to create an issue here to start a discussion about the pros and cons of a rule.
-
-### Different styles
-
-We acknowledge that there are certain rules where there are no actual pros and cons or where there is no clear winner. You just have to decide for one style and stick with it. We also know that some rules make sense in one project, but don't make sense in another project. That's why we also provide a list of [accepted custom styles](#styles) (see also [this discussion](https://github.com/peerigon/eslint-config-peerigon/issues/11)) which you can pick.
-
-### VSCode
-
-This is our recommended VSCode configuration using the [Prettier extension](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode). Adjust it to the needs of your particular project:
-
-```json
-{
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-  "editor.formatOnSave": true,
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": true
-  }
-}
-```
-
-### Experimental syntax using Babel
-
-If you're using Babel you should set [`requireConfigFile: true`](https://github.com/babel/babel/tree/main/eslint/babel-eslint-parser#additional-parser-configuration) in your ESLint config. ESLint will then use your `babel.config.json`.
-
-```js
-{
-    "parserOptions": { "requireConfigFile": true },
-}
-```
-
-### Naming conventions for properties
-
-Sometimes we're not in full control over the naming conventions in our codebase, for instance if data is coming from a foreign API. While it often is preferable to transform property names into camelCase, it might not be practical. In these situations you can disable the check for properties like this:
-
-```js
-const options = require("eslint-config-peerigon/options.js");
-
-module.exports = {
-  /* ... */
-  rules: {
-    // The API uses snake_case as properties
-    camelcase: [
-      "warn",
-      {
-        ...options["camelcase"],
-        properties: "never",
-      },
-    ],
-  },
-};
-```
-
-**In TypeScript projects:**
-
-```js
-const options = require("eslint-config-peerigon/options.js");
-
-module.exports = {
-  /* ... */
-  rules: {
-    // The API uses snake_case as properties
-    "@typescript-eslint/naming-convention": [
-      "warn",
-      options["@typescript-eslint/naming-convention"].ignoreProperties,
-      ...options["@typescript-eslint/naming-convention"].defaultRules,
-    ],
-  },
-};
-```
-
-## Provided configs
-
-### [`peerigon`](base.js)
-
-**Base rules for every project. You should always add these rules.**
-
-```
-npm i eslint eslint-config-peerigon --save-dev
-```
-
-These rules assume a modern project with full ES2015 support, including ES modules. For specific environments like Node.js or old JS engines, see below. The base rules do not define an `env`, so you might want to do that for yourself to enable specific globals.
-
-Add an `.eslintrc.json` to the project's root folder:
-
-```js
-{
-    "extends": [
-        // Base rules for every project
-        "peerigon"
-    ],
-    // Do not search for further eslint configs in upper directories
-    "root": true,
-    // If you're using Babel, you should set requireConfigFile: true
-    // ESLint will then use your babel.config.json.
-    // "parserOptions": { "requireConfigFile": true },
-}
-```
-
-The base rules use the `eslint-plugin-import` to resolve imports. Although it's possible to define [custom resolvers](https://github.com/benmosher/eslint-plugin-import#resolvers), it's highly discouraged to deviate from the common Node.js resolving algorithm. Other tools like linters and intellisense don't work reliably when you change the resolver.
-
-### [`peerigon/typescript`](typescript.js)
-
-Rules for [TypeScript](https://www.typescriptlang.org/).
-
-```js
-{
-    "extends": [
-        "peerigon",
-        "peerigon/typescript",
-        // Arrow functions are preferred with TypeScript
-        // See https://github.com/peerigon/eslint-config-peerigon/issues/23#issuecomment-472614432
-        "peerigon/styles/prefer-arrow"
-    ],
-    "root": true,
-}
+```sh
+npm install @peerigon/configs
 ```
 
-You need to add `--ext js,jsx,cjs,mjs,ts,tsx` to the `test:lint` script:
-
-```js
-{
-    "scripts": {
-        "test:lint": "eslint --max-warnings 0 --cache --ext js,jsx,cjs,mjs,ts,tsx --ignore-path .gitignore ."
-    }
-}
-```
-
-_We recommend using [`peerigon/styles/prefer-arrow`](#peerigonstylesprefer-arrow) because arrow functions (or function expressions in general) can leverage [TypeScript's contextual typing](https://www.typescriptlang.org/docs/handbook/type-inference.html#contextual-typing)._
-
-### [`peerigon/node`](node.js)
+Also checkout the instructions for each respective config:
 
-**Important: Requires [`eslint-plugin-n`](https://github.com/eslint-community/eslint-plugin-n).**
+- [ESLint](/eslint/README.md)
+- [Prettier](/prettier/README.md)
+- [TypeScript](/typescript/README.md)
+- [Semantic release](/semantic-release/README.md)
 
-```
-npm i eslint-plugin-n --save-dev
-```
-
-```js
-{
-    "extends": [
-        "peerigon",
-        "peerigon/node"
-    ],
-    // Setting env.node = true is not necessary, this is already done by peerigon/node
-    "root": true
-}
-```
-
-### [`peerigon/react`](react.js)
-
-**Important: Requires [`eslint-plugin-react`](https://github.com/yannickcr/eslint-plugin-react), [`eslint-plugin-jsx-a11y`](https://github.com/evcohen/eslint-plugin-jsx-a11y) and [`eslint-plugin-react-hooks`](https://www.npmjs.com/package/eslint-plugin-react-hooks) as project dependency.**
-
-```
-npm i eslint-plugin-react eslint-plugin-jsx-a11y eslint-plugin-react-hooks --save-dev
-```
-
-Rules for [React](https://facebook.github.io/react/) development, including accessibility rules.
-These rules are also applicable in other JSX environments, like [Preact](https://github.com/developit/preact):
-
-```js
-{
-    "extends": [
-        "peerigon",
-        "peerigon/react"
-    ],
-    "root": true
-}
-```
-
-_We recommend using [`peerigon/styles/react-jsx-no-literals`](#peerigonstylesreact-jsx-no-literals) if you're using i18n in your project._
-_You can use [`peerigon/styles/react-jsx-no-bind`](#peerigonstylesreact-jsx-no-bind) if you're using `memo` and `shouldComponentUpdate` a lot._
-
-### [`peerigon/jsdoc`](jsdoc.js)
-
-**Important: Requires [`eslint-plugin-jsdoc`](https://github.com/gajus/eslint-plugin-jsdoc) as project dependency.**
-
-```
-npm i eslint-plugin-jsdoc --save-dev
-```
-
-Makes sure that JSDoc annotations are written in a standard-compliant and uniform way.
-
-```js
-{
-    "extends": [
-        "peerigon",
-        "peerigon/jsdoc"
-    ],
-    "root": true
-}
-```
-
-## Styles
-
-The following rules enable specific writing styles. Use them as you prefer.
-
-### [`peerigon/styles/prefer-arrow`](styles/prefer-arrow.js)
-
-Enforces arrow function expressions instead of function declarations (see [#23](https://github.com/peerigon/eslint-config-peerigon/issues/23)).
-Regular functions are still allowed as methods in objects or classes.
-
-```js
-    "extends": [
-        "peerigon",
-        "peerigon/styles/prefer-arrow"
-    ],
-```
+## Philosophy
 
-### [`peerigon/styles/no-default-export`](styles/no-default-export.js)
+Linting, formatting and type-checking rules are always a balance between:
 
-Forbids usage of `export default`. When using default exports, it becomes harder to name classes or functions consistently throughout the codebase since every module can pick its own name for the imported thing. Nicholas C. Zakas, the creator of ESLint, wrote [an article with more compelling arguments why he stopped using `export default`](https://humanwhocodes.com/blog/2019/01/stop-using-default-exports-javascript-module/).
-
-```js
-    "extends": [
-        "peerigon",
-        "peerigon/styles/no-default-export"
-    ],
-```
-
-**Please note:** This rule is disabled in `.jsx` and `.tsx` files because React components are usually exported via `export default`. [`React.lazy`](https://reactjs.org/docs/code-splitting.html#reactlazy) even expects the lazy loaded component to be exported as `default`.
-
-### [`peerigon/styles/no-null`](styles/no-null.js)
-
-**Important: Requires [`eslint-plugin-no-null`](https://github.com/nene/eslint-plugin-no-null) as project dependency.**
-
-```
-npm i eslint-plugin-no-null --save-dev
-```
-
-Forbids the usage of `null`. In a codebase it's often better to use a single non-value to represent _the absence of a value_. With the rise of default parameters and destructuring defaults, JavaScript developed a clear tendency towards `undefined`. [This issue](https://github.com/peerigon/eslint-config-peerigon/issues/71) summarizes the arguments (and trade-offs) of **null vs. undefined**.
-
-```js
-    "extends": [
-        "peerigon",
-        "peerigon/styles/no-null"
-    ],
-```
-
-**Please note:** If you use this rule, you will probably still need a single `null` value which you can refer to whenever you need to use `null` because of third-party code:
-
-```js
-// eslint-disable-next-line no-null/no-null
-export const NULL = null;
-```
-
-### [`peerigon/styles/prefer-interface`](styles/prefer-interface.js)
-
-**Important: Use it in combination with [`peerigon/typescript`](typescript.js).**
-
-[Prefer `interface` over `type`](https://github.com/typescript-eslint/typescript-eslint/blob/master/packages/eslint-plugin/docs/rules/prefer-interface.md).
-
-```js
-    "extends": [
-        "peerigon",
-        "peerigon/typescript",
-        "peerigon/styles/prefer-interface"
-    ],
-```
-
-### [`peerigon/styles/react-jsx-no-bind`](styles/react-jsx-no-bind.js)
-
-**Important: Use it in combination with [`peerigon/react`](react.js).**
-
-Depending on the way you write your components, it might be not ok to create functions during `render()`. Use it if you're using things like `React.memo()` or `shouldComponentUpdate` a lot.
-
-```js
-    "extends": [
-        "peerigon",
-        "peerigon/react",
-        "peerigon/styles/react-jsx-no-bind"
-    ],
-```
-
-### [`peerigon/styles/react-jsx-no-literals`](styles/react-jsx-no-literals.js)
+- ease of reading
+- ease of refactoring
+- ease of writing.
 
-**Important: Use it in combination with [`peerigon/react`](react.js).**
+We think that:
 
-Use this style if you're using i18n. It prevents people from putting raw strings in components.
+- code is read more often than refactored
+- and refactored more often than written from scratch.
 
-```js
-    "extends": [
-        "peerigon",
-        "peerigon/react",
-        "peerigon/styles/react-jsx-no-literals"
-    ],
-```
+Our configs have been designed with these assumptions in mind.
 
-It disallows this:
+### Formatting
 
-```jsx
-const Hello = <div>test</div>;
-```
+Formatting should follow the community standard. Our config is therefore based on Prettier's default config. Besides that it also:
 
-As an escape hatch, this is still allowed:
+- auto-sorts `import` statements
+- formats JSDoc comments
+- formats `package.json`
+- formats and sorts CSS properties
+- sorts Tailwind CSS class names
 
-```jsx
-const Hello = <div>{"test"}</div>;
-```
+This makes git diffs smaller and reviewing them more focussed.
 
-### [`peerigon/styles/prefer-array-shorthand`](styles/prefer-array-shorthand.js)
+### Linting
 
-**Important: Use it in combination with [`peerigon/typescript`](typescript.js).**
+Linting should mostly catch bugs in the control flow and prevent security issues. Furthermore, it should enforce a modern, idiomatic and consistent code style that is easy to read and to refactor.
 
-Enforces typescript arrays to use the shorthand array-style instead of the generic style.
+However, it should **not** nit-pick on formatting or favor certain language features where other options are equally ok. Every rule must be legitimized by objective criteria. A simple “I find it easier to read” is not enough.
 
-```js
-    "extends": [
-        "peerigon",
-        "peerigon/typescript",
-        "peerigon/styles/prefer-array-shorthand"
-    ],
-```
+Our linting rules:
 
-It enforces this:
+- are mostly based on recommended sets
+- use type information to catch logic bugs
+- highlight a11y problems
+- are less strict in tests
 
-```ts
-const foo: string[] = [];
-```
+### Type-checking
 
-instead of
+Type-checking should be rather strict because it is the foundation for safe and sound refactorings. If type-checking is too loose, it may lull the developer into a false sense of security. It should also prevent out-of-bounds errors when accessing arrays or objects.
 
-```ts
-const foo: Array<string> = [];
-```
+For highly dynamic code or incompatible types, local exceptions to type safety and escape hatches need to be possible.
 
 ## License
 
-Unlicense
+MIT
 
 ## Sponsors
 

package/eslint/README.md

@@ -0,0 +1,119 @@
+# [ESLint](https://eslint.org/) config
+
+## Installation
+
+```sh
+npm install eslint @peerigon/configs --save-dev
+```
+
+Then create a `eslint.config.js` next to your `package.json`:
+
+```js
+// We have a couple of presets for popular setups, such as typescript-react or typescript-node
+// See "Presets"
+import typescriptNodePreset from "@peerigon/configs/eslint/presets/typescript-node";
+// You can also choose from a bunch of optional coding styles
+// See "Styles"
+import stylesNoDefaultExport from "@peerigon/configs/eslint/styles/no-default-export";
+
+export default [
+  ...typescriptNodePreset,
+  // The idiomatic way to disable rules in certain directories in ESLint>=9.x is
+  // to map() over them and add `ignores` to the rule objects
+  ...stylesNoDefaultExport.map((config) => ({
+    ...config,
+    ignores: [...(config.ignores ?? []), "src/some/folder/*.ts"],
+  })),
+];
+```
+
+Recommended configuration in your `package.json` (using [`npm-run-all`](https://www.npmjs.com/package/npm-run-all)):
+
+```json
+{
+  "type": "module",
+  "scripts": {
+    "test": "run-p test:*",
+    "test:lint": "eslint --max-warnings 0 --cache ."
+  }
+}
+```
+
+## Presets
+
+Presets bundle all relevant rules into one `import`. They can be imported as `@peerigon/configs/eslint/presets/<preset-name>`. They **should not** be combined with each other.
+
+- `typescript-react`: Rules for React projects written in TypeScript
+- `typescript-node`: Rules for TypeScript apps that are supposed to run in Node.js
+- `typescript`: Rules for all other TypeScript projects
+- `javascript-browser`: Rules for JavaScript apps running in a browser (e.g. in combination with [JSDoc type annotations](https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html))
+- `javascript-node`: Rules for JavaScript apps running in Node.js
+- `javascript`: Rules for all other JavaScript projects
+
+## Styles
+
+We acknowledge that there are certain rules where there are no actual pros and cons or where there is no clear winner. You just have to decide for one style and stick with it. We also know that some rules make sense in one project, but don't make sense in another project. Pick these rules if they make sense for you in your project. They can be imported as `@peerigon/configs/eslint/styles/<style-name>`.
+
+### `no-default-export`
+
+Forbids usage of `export default`. When using default exports, it becomes harder to name classes or functions consistently throughout the codebase since every module can pick its own name for the imported thing. Nicholas C. Zakas, the creator of ESLint, wrote [an article with more compelling arguments why he stopped using `export default`](https://humanwhocodes.com/blog/2019/01/stop-using-default-exports-javascript-module/).
+
+You may want to disable this rule in situations where a default export is required, for instance when using [React's `lazy()`](https://react.dev/reference/react/lazy).
+
+### `no-null`
+
+Forbids the usage of `null`. In a codebase it's often better to use a single non-value to represent _the absence of a value_. With the rise of default parameters and destructuring defaults, JavaScript developed a clear tendency towards `undefined`. [This issue](https://github.com/peerigon/eslint-config-peerigon/issues/71) summarizes the arguments (and trade-offs) of **null vs. undefined**.
+
+**👉 Hint:** If you use this rule, you will probably still need a single `null` value which you can refer to whenever you need to use `null` because of third-party code:
+
+```js
+// eslint-disable-next-line no-null/no-null
+export const NULL = null;
+```
+
+### `prefer-interface`
+
+Prefer TypeScript's `interface` over `type`:
+
+```ts
+interface SomeObject {
+  someProp: boolean;
+}
+```
+
+instead of
+
+```ts
+type SomeObject = {
+  someProp: boolean;
+};
+```
+
+### `prefer-array-shorthand`
+
+Enforces TypeScript arrays to use the shorthand array-style instead of the generic style:
+
+```ts
+const foo: string[] = [];
+```
+
+instead of
+
+```ts
+const foo: Array<string> = [];
+```
+
+### `jsx-no-literals`
+
+Use this style if you're using i18n. It prevents people from putting raw strings in components.
+It disallows this:
+
+```jsx
+const Hello = <div>test</div>;
+```
+
+As an escape hatch, this is still allowed:
+
+```jsx
+const Hello = <div>{"test"}</div>;
+```

package/eslint/presets/typescript-react.test/App.tsx

@@ -1,4 +1,5 @@
 import { useEffect, useRef, useState } from "react";
+import { Other } from "./Other.tsx";
 
 export const App = (_props: { name: string; count: number }) => {
   for (let index = 0; index < 10; index++) {
@@ -28,6 +29,7 @@ export const App = (_props: { name: string; count: number }) => {
       {"Hello world"}
       {/* eslint-disable-next-line @eslint-react/no-leaked-conditional-rendering */}
       <>{_props.count && <view />}</>
+      <Other />
     </>
   );
 };

package/eslint/presets/typescript.test/main.ts

@@ -1,10 +1,14 @@
-import { getMessage } from "./message.js";
+import { getMessage } from "./message.ts";
 // Check if import attributes are detected and formatted correctly
 import test from "./test.json" with { type: "json" };
 
 // eslint-disable-next-line @typescript-eslint/naming-convention
 const snake_case = 123;
 
+// Should not complain about missing dot-notation here since
+// we're using TS's noPropertyAccessFromIndexSignature
+process.env["SOME_ENV_VAR"] = "test";
+
 class SomeClass {
   #someProp = true;
   private someEventHandler = () => {

package/eslint/rules/javascript.js

@@ -13,6 +13,9 @@ export const javascript = [
       // https://github.com/sindresorhus/eslint-plugin-unicorn/issues/896
       "unicorn/prevent-abbreviations": "off",
       "unicorn/filename-case": "off",
+      // The default of import-style is highly subjective and not always the best choice.
+      // E.g. bundlers are able to tree-shake named imports easier than default imports.
+      "unicorn/import-style": "off",
       "unicorn/no-nested-ternary": "off",
       "unicorn/no-null": "off",
       "unicorn/no-useless-undefined": "off",
@@ -23,6 +26,9 @@ export const javascript = [
       "unicorn/no-array-reduce": "off",
       "unicorn/prefer-global-this": "off", // Too many false positives
       "unicorn/prefer-ternary": "off",
+      // It makes sense to use Promise.all() with a single promise when we expect more to be added later.
+      // In that case we don't want to refactor the code, but just add the new promise.
+      "unicorn/no-single-promise-in-promise-methods": "off",
     },
   },
   {

package/eslint/rules/typescript.js

@@ -129,7 +129,15 @@ export const typescript = tsEslint.config(
       ],
       "no-return-await": "off",
       "@typescript-eslint/return-await": ["warn", "in-try-catch"], // https://typescript-eslint.io/rules/return-await
-      "@typescript-eslint/switch-exhaustiveness-check": "warn", // https://typescript-eslint.io/rules/switch-exhaustiveness-check
+      "@typescript-eslint/switch-exhaustiveness-check": [
+        "warn",
+        {
+          // It should not be necessary to list all possible values for a union type
+          // explicitly in a switch statement. E.g. if the types are generated, we don't
+          // want to adjust all switch statements every time the types are changed.
+          considerDefaultExhaustiveForUnions: true,
+        },
+      ], // https://typescript-eslint.io/rules/switch-exhaustiveness-check
       camelcase: "off",
       "max-lines": [
         "warn",

package/eslint/styles/no-default-export.js

@@ -8,7 +8,8 @@ export const noDefaultExport = [
         "error",
         {
           selector: "ExportDefaultDeclaration",
-          message: "Prefer named exports",
+          message:
+            "Please use named exports instead. Named exports ensure consistent naming and make it easier to auto-import symbols.",
         },
       ],
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peerigon/configs",
-  "version": "1.0.0-beta.9",
+  "version": "1.0.0",
   "description": "Configs for ESLint, Prettier, TypeScript & friends",
   "keywords": [
     "eslint",
@@ -73,6 +73,10 @@
       "types": "./types/semantic-release/base.d.ts",
       "default": "./semantic-release/base.js"
     },
+    "./semantic-release/cross-publish": {
+      "types": "./types/semantic-release/cross-publish.d.ts",
+      "default": "./semantic-release/cross-publish.js"
+    },
     "./typescript": {
       "default": "./typescript/base.json"
     },
@@ -118,50 +122,63 @@
     "*.{js,jsx,ts,tsx,css,md,yml,yaml}": "prettier --write"
   },
   "dependencies": {
-    "@eslint-react/eslint-plugin": "^1.16.1",
-    "@eslint/compat": "^1.2.3",
-    "@eslint/js": "9.14.0",
-    "@ianvs/prettier-plugin-sort-imports": "^4.4.0",
-    "eslint-config-prettier": "^9.1.0",
+    "@eslint-react/eslint-plugin": "^1.26.1",
+    "@eslint/compat": "^1.2.6",
+    "@eslint/js": "^9.19.0",
+    "@ianvs/prettier-plugin-sort-imports": "^4.4.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^7.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/eslint-config-prettier": "^6.11.3",
+    "@types/eslint-plugin-jsx-a11y": "^6.10.0",
+    "@types/eslint__js": "^8.42.3",
+    "eslint-config-prettier": "^10.0.1",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-prefer-arrow": "^1.2.3",
-    "eslint-plugin-react": "^7.37.2",
-    "eslint-plugin-react-compiler": "^19.0.0-beta-a7bf2bd-20241110",
-    "eslint-plugin-react-hooks": "^5.0.0",
-    "eslint-plugin-react-refresh": "^0.4.14",
-    "eslint-plugin-unicorn": "^56.0.0",
-    "globals": "^15.12.0",
+    "eslint-plugin-react": "^7.37.4",
+    "eslint-plugin-react-compiler": "^19.0.0-beta-714736e-20250131",
+    "eslint-plugin-react-hooks": "^5.1.0",
+    "eslint-plugin-react-refresh": "^0.4.18",
+    "eslint-plugin-unicorn": "^56.0.1",
+    "globals": "^15.14.0",
     "prettier-plugin-css-order": "^2.1.2",
-    "prettier-plugin-jsdoc": "^1.3.0",
-    "prettier-plugin-packagejson": "^2.5.3",
-    "prettier-plugin-tailwindcss": "^0.6.8",
-    "typescript-eslint": "^8.14.0"
+    "prettier-plugin-jsdoc": "^1.3.2",
+    "prettier-plugin-packagejson": "^2.5.8",
+    "prettier-plugin-tailwindcss": "^0.6.11",
+    "typescript-eslint": "^8.23.0"
   },
   "devDependencies": {
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/exec": "^6.0.3",
-    "@semantic-release/git": "^10.0.1",
-    "@types/eslint-config-prettier": "^6.11.3",
-    "@types/eslint-plugin-jsx-a11y": "^6.9.0",
-    "@types/eslint__js": "^8.42.3",
-    "@types/node": "^22.9.0",
-    "@types/react": "^18.3.12",
-    "eslint": "9.14.0",
-    "husky": "^9.1.6",
-    "lint-staged": "^15.2.10",
+    "@types/node": "^22.13.1",
+    "@types/react": "^19.0.8",
+    "eslint": "^9.19.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.4.3",
     "npm-run-all": "^4.1.5",
-    "pin-github-action": "^1.9.1",
-    "prettier": "^3.3.3",
-    "react": "^18.3.1",
-    "semantic-release": "^24.2.0",
-    "typescript": "^5.6.3"
+    "pin-github-action": "^2.1.0",
+    "prettier": "^3.4.2",
+    "react": "^19.0.0",
+    "semantic-release": "^24.2.1",
+    "typescript": "^5.7.3"
   },
   "peerDependencies": {
-    "eslint": "^9.0.0",
-    "prettier": "^3.3.3",
-    "typescript": "^5.6.3"
+    "eslint": "^9.19.0",
+    "prettier": "^3.4.2",
+    "semantic-release": "^24.2.1",
+    "typescript": "^5.7.3"
+  },
+  "peerDependenciesMeta": {
+    "eslint": {
+      "optional": true
+    },
+    "prettier": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    }
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   }
 }

package/prettier/README.md

@@ -0,0 +1,35 @@
+# [Prettier](https://prettier.io/) config
+
+## Installation
+
+```sh
+npm install prettier @peerigon/configs --save-dev
+```
+
+Then create a `prettier.config.js` next to your `package.json`:
+
+```js
+export { default } from "@peerigon/configs/prettier";
+```
+
+Recommended configuration in your `package.json` (using [`npm-run-all`](https://www.npmjs.com/package/npm-run-all)):
+
+```json
+{
+  "type": "module",
+  "scripts": {
+    "test": "run-p test:*",
+    "test:format": "prettier --check ."
+  }
+}
+```
+
+## Configuration
+
+Our config is entirely based on Prettier's default config. Besides that, it also:
+
+- auto-sorts `import` statements
+- formats JSDoc comments
+- formats `package.json`
+- formats and sorts CSS properties
+- sorts Tailwind CSS class names

package/prettier/base.js

@@ -28,6 +28,8 @@ export const config = {
     "importAttributes",
   ],
   importOrderTypeScriptVersion: "5.0.0",
+  cssDeclarationSorterOrder: "smacss",
+  cssDeclarationSorterKeepOverrides: false,
 };
 
 export default config;

package/prettier/css.test/styles.css

@@ -0,0 +1,9 @@
+main {
+  display: none;
+  width: 100%;
+  height: 100%;
+  margin: 0;
+  padding: 2;
+  background: hotpink;
+  animation: none;
+}

package/semantic-release/README.md

@@ -0,0 +1,81 @@
+# [Semantic release](https://semantic-release.gitbook.io/) config
+
+## Installation
+
+```sh
+npm install semantic-release @peerigon/configs --save-dev
+```
+
+Then create a `.releaserc.json` next to your `package.json`:
+
+```json
+{
+  "extends": "@peerigon/configs/semantic-release"
+}
+```
+
+Recommended configuration in your `package.json`:
+
+```json
+{
+  "type": "module",
+  "scripts": {
+    "release": "semantic-release"
+  },
+  "publishConfig": {
+    "//": "only if the package is supposed to be public"
+    "access": "public",
+    "provenance": true
+  }
+}
+```
+
+`"provenance": true` will generate [provenance statements](https://docs.npmjs.com/generating-provenance-statements) in case your Github actions has the correct permissions (see below).
+
+Recommended Github action:
+
+```yaml
+name: 🧪 Test and 🚀 Release
+
+on:
+  push:
+    branches:
+      - main
+      - beta
+  pull_request: {}
+
+jobs:
+  test-and-release:
+    runs-on: ubuntu-latest
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+
+    permissions:
+      # Necessary for semantic-release
+      contents: write
+      issues: write
+      pull-requests: write
+      # Necessary for npm publish --provenance
+      # See https://docs.npmjs.com/generating-provenance-statements#example-github-actions-workflow
+      id-token: write
+      # packages: write is only necessary if you want to publish to Github
+      packages: write
+
+    steps:
+      # ...
+      # Install and build steps
+      # ...
+      - name: 🚀 Release
+        env:
+          # GITHUB_TOKEN is only necessary if you want to publish to Github
+          # GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          npm run release
+```
+
+## Configuration
+
+We export the following `.releaserc.json` presets. They can be used by extending `@peerigon/configs/<preset-name>`:
+
+- `semantic-release`: Recommended config for publishing a library to a single registry (according to your `.npmrc`).
+- `semantic-release/cross-publish`: Config for publishing a library both to NPM _and_ Github

package/semantic-release/base.js

@@ -5,6 +5,12 @@ export const config = {
     "@semantic-release/commit-analyzer",
     "@semantic-release/release-notes-generator",
     "@semantic-release/changelog",
+    [
+      "@semantic-release/exec",
+      {
+        prepareCmd: "npx -y prettier --write CHANGELOG.md",
+      },
+    ],
     [
       "@semantic-release/git",
       {
@@ -23,18 +29,6 @@ export const config = {
         assets: ".semantic-release/*.tgz",
       },
     ],
-    [
-      "@semantic-release/exec",
-      {
-        verifyConditionsCmd:
-          'echo "registry=https://npm.pkg.github.com/\n//npm.pkg.github.com/:_authToken=${process.env.GITHUB_TOKEN}" > /tmp/github.npmrc && npm whoami --userconfig /tmp/github.npmrc',
-        prepareCmd: "npx -y prettier --write CHANGELOG.md",
-        publishCmd:
-          "npm publish --userconfig /tmp/github.npmrc --tag ${nextRelease.channel} --no-git-tag-version",
-        successCmd: "rm /tmp/github.npmrc",
-        failCmd: "rm /tmp/github.npmrc",
-      },
-    ],
   ],
 };
 

package/semantic-release/cross-publish.js

@@ -0,0 +1,22 @@
+import { config as baseConfig } from "./base.js";
+
+/** @type {import("semantic-release").Options} */
+export const config = {
+  ...baseConfig,
+  plugins: [
+    ...(baseConfig.plugins ?? []),
+    [
+      "@semantic-release/exec",
+      {
+        verifyConditionsCmd:
+          'echo "registry=https://npm.pkg.github.com/\n//npm.pkg.github.com/:_authToken=${process.env.GITHUB_TOKEN}" > /tmp/github.npmrc && npm whoami --userconfig /tmp/github.npmrc',
+        publishCmd:
+          "npm publish --userconfig /tmp/github.npmrc --tag ${nextRelease.channel} --no-git-tag-version",
+        successCmd: "rm /tmp/github.npmrc",
+        failCmd: "rm /tmp/github.npmrc",
+      },
+    ],
+  ],
+};
+
+export default config;

package/types/eslint/presets/javascript.test/other.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"other.d.ts","sourceRoot":"","sources":["../../../../eslint/presets/javascript.test/other.js"],"names":[],"mappings":"AAAA,kBAAmB;AACnB,kBAAmB"}
+{"version":3,"file":"other.d.ts","sourceRoot":"","sources":["../../../../eslint/presets/javascript.test/other.js"],"names":[],"mappings":"AAAA,gBAAiB,CAAC,CAAC;AACnB,gBAAiB,CAAC,CAAC"}

package/types/eslint/rules/javascript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"javascript.d.ts","sourceRoot":"","sources":["../../../eslint/rules/javascript.js"],"names":[],"mappings":"AAKA,+CAA+C;AAC/C,yBADW,OAAO,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CA2IzC"}
+{"version":3,"file":"javascript.d.ts","sourceRoot":"","sources":["../../../eslint/rules/javascript.js"],"names":[],"mappings":"AAKA,+CAA+C;AAC/C,yBADW,OAAO,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAiJzC"}

package/types/eslint/rules/typescript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../eslint/rules/typescript.js"],"names":[],"mappings":"AAUA,6FAyLE"}
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../eslint/rules/typescript.js"],"names":[],"mappings":"AAUA,6FAiME"}

package/types/eslint/styles/no-default-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"no-default-export.d.ts","sourceRoot":"","sources":["../../../eslint/styles/no-default-export.js"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,8BADW,OAAO,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAezC"}
+{"version":3,"file":"no-default-export.d.ts","sourceRoot":"","sources":["../../../eslint/styles/no-default-export.js"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,8BADW,OAAO,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAgBzC"}

package/types/eslint/styles/no-default-export.test/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../eslint/styles/no-default-export.test/main.ts"],"names":[],"mappings":";AACA,wBAAiC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../eslint/styles/no-default-export.test/main.ts"],"names":[],"mappings":"wBACe,iBAAiB;AAAhC,wBAAiC"}

package/types/prettier/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../prettier/base.js"],"names":[],"mappings":"AAoBA,wCAAwC;AACxC,qBADW,OAAO,UAAU,EAAE,MAAM,CAUlC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../prettier/base.js"],"names":[],"mappings":"AAoBA,wCAAwC;AACxC,qBADW,OAAO,UAAU,EAAE,MAAM,CAYlC"}

package/types/semantic-release/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../semantic-release/base.js"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,qBADW,OAAO,kBAAkB,EAAE,OAAO,CAsC3C"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../semantic-release/base.js"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,qBADW,OAAO,kBAAkB,EAAE,OAAO,CAgC3C"}

package/types/semantic-release/cross-publish.d.ts

@@ -0,0 +1,4 @@
+/** @type {import("semantic-release").Options} */
+export const config: import("semantic-release").Options;
+export default config;
+//# sourceMappingURL=cross-publish.d.ts.map

package/types/semantic-release/cross-publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-publish.d.ts","sourceRoot":"","sources":["../../semantic-release/cross-publish.js"],"names":[],"mappings":"AAEA,iDAAiD;AACjD,qBADW,OAAO,kBAAkB,EAAE,OAAO,CAiB3C"}

package/typescript/README.md

@@ -0,0 +1,58 @@
+# [TypeScript](https://www.typescriptlang.org/) config
+
+## Installation
+
+```sh
+npm install typescript @peerigon/configs --save-dev
+```
+
+Then create a `tsconfig.json` just for type-checking next to your `package.json`:
+
+```json
+{
+  "extends": "@peerigon/configs/typescript"
+}
+```
+
+Recommended configuration in your `package.json` (using [`npm-run-all`](https://www.npmjs.com/package/npm-run-all)):
+
+```json
+{
+  "type": "module",
+  "scripts": {
+    "test": "run-p test:*",
+    "test:types": "tsc"
+  }
+}
+```
+
+In case you're developing a library with a dedicated build process, we recommend to create a separate `tsconfig.build.json`:
+
+```json
+{
+  "extends": ["./tsconfig.json", "@peerigon/configs/typescript/lib"],
+  "include": ["src"],
+  "exclude": ["src/**/*.test.ts", "src/tests/**/*.ts"]
+}
+```
+
+with the following `package.json` `scripts`:
+
+```json
+{
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "run-p test:*",
+    "test:types": "tsc"
+  }
+}
+```
+
+## Presets
+
+We export the following `tsconfig.json` presets. They can be used by extending `@peerigon/configs/<preset-name>`:
+
+- `typescript`: Recommended base config for all modern TypeScript projects
+- `typescript/lib`: Config for building TS libraries
+- `typescript/js-lib`: Config for building JS libraries with [JSDoc type annotations](https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html).

package/typescript/base.json

@@ -1,24 +1,29 @@
 {
   "compilerOptions": {
+    "allowImportingTsExtensions": true,
     "checkJs": true,
+    // TODO: Enable erasableSyntaxOnly when TS 5.8 is released
+    // https://www.totaltypescript.com/erasable-syntax-only
+    // "erasableSyntaxOnly": true,
     "esModuleInterop": true,
-    "exactOptionalPropertyTypes": true,
+    // by complaining about too much unproblematic code. We may revisit this decision later.
+    // We decided to turn off `exactOptionalPropertyTypes` because it's too strict
+    "exactOptionalPropertyTypes": false,
     "forceConsistentCasingInFileNames": true,
     "isolatedModules": true,
     "lib": ["DOM", "ESNext"],
     "module": "NodeNext",
+    "noEmit": true,
     "noImplicitOverride": true,
     "noImplicitReturns": true,
     "noPropertyAccessFromIndexSignature": true,
     "noUncheckedIndexedAccess": true,
     "resolveJsonModule": true,
+    "rewriteRelativeImportExtensions": true,
     "skipLibCheck": true,
     "strict": true,
-    "target": "ESNext"
-    // TODO: Turn on the following settings once TS 5.7 is released, see also https://nodejs.org/docs/latest/api/typescript.html#typescript-features
-    // "allowImportingTsExtensions": true,
-    // "rewriteRelativeImportExtensions": true,
-    // "verbatimModuleSyntax": true
+    "target": "ESNext",
+    "verbatimModuleSyntax": true
   },
   "$schema": "https://json.schemastore.org/tsconfig"
 }

package/typescript/lib.json

@@ -3,6 +3,7 @@
   "compilerOptions": {
     "declaration": true,
     "declarationMap": true,
+    "noEmit": false,
     "outDir": "${configDir}/dist",
     "sourceMap": true
   },