@brnshkr/config 0.0.1-alpha.9 → 0.0.1-beta.2

package/README.md

@@ -18,7 +18,7 @@ _[☄️ Bug Reports / Feature Requests »][issues-url]_
 <!-- omit in toc -->
 ## Table of Contents
 
-<!-- NOTICE: All anchors must not include the emoji to work on github, the ❤️ and ⚙️ for some reason must be url encoded though -->
+<!-- NOTICE: GitHub strips emojis in anchors, but multi-codepoint characters may leave invisible remnants, causing anchors to differ and require URL encoding. -->
 - [👋 About the Project](#-about-the-project)
 - [☕ JS](#-js)
   - [🧰 Prerequisites](#-prerequisites)
@@ -58,7 +58,7 @@ _[☄️ Bug Reports / Feature Requests »][issues-url]_
 
 ### 🧰 Prerequisites
 
-- Node.js >= v24 or Bun >= 1.3 (Older versions may work, but are untested)
+- Node.js >= v24 or Bun >= v1.3 (Older versions may work, but are untested)
 - Any JavaScript package manager (Bun, Yarn, PNPM, NPM)
 
 <p align="right"><a href="#top" title="Back to top">&nbsp;&nbsp;&nbsp;⬆&nbsp;&nbsp;&nbsp;</a></p>
@@ -69,28 +69,28 @@ _[☄️ Bug Reports / Feature Requests »][issues-url]_
 #### Bun
 
 ```sh
-bun a -D @brnshkr/config
+bun a -D -E @brnshkr/config
 ```
 
 <!-- omit in toc -->
 #### Yarn
 
 ```sh
-yarn add -D @brnshkr/config
+yarn add -D -E @brnshkr/config
 ```
 
 <!-- omit in toc -->
 #### PNPM
 
 ```sh
-pnpm add -D @brnshkr/config
+pnpm add -D -E @brnshkr/config
 ```
 
 <!-- omit in toc -->
 #### NPM
 
 ```sh
-npm i -D @brnshkr/config
+npm i -D -E @brnshkr/config
 ```
 
 This repository currently only provides one way to integrate configuration files (An automatic setup is planned, See [🔨 TODOs / Roadmap](#-todos--roadmap)):
@@ -313,8 +313,9 @@ You can then copy the specific configs to your project:
 ##### PHP CS Fixer
 
 ```sh
-cp -v ./vendor/brnshkr/config/conf/.php-cs-fixer.php.example ./conf/.php-cs-fixer.php \
-  && cp -v ./vendor/brnshkr/config/conf/.php-cs-fixer.dist.php.example ./conf/.php-cs-fixer.dist.php
+cp -v ./vendor/brnshkr/config/conf/php-cs-fixer.php.example ./conf/php-cs-fixer.php \
+  && cp -v ./vendor/brnshkr/config/conf/php-cs-fixer.php.example ./conf/php-cs-fixer.php.example \
+  && cp -v ./vendor/brnshkr/config/conf/php-cs-fixer.dist.php.example ./conf/php-cs-fixer.dist.php
 ```
 
 <!-- omit in toc -->
@@ -322,6 +323,7 @@ cp -v ./vendor/brnshkr/config/conf/.php-cs-fixer.php.example ./conf/.php-cs-fixe
 
 ```sh
 cp -v ./vendor/brnshkr/config/conf/rector.php.example ./conf/rector.php \
+  && cp -v ./vendor/brnshkr/config/conf/rector.php.example ./conf/rector.php.example \
   && cp -v ./vendor/brnshkr/config/conf/rector.dist.php.example ./conf/rector.dist.php
 ```
 
@@ -329,8 +331,18 @@ cp -v ./vendor/brnshkr/config/conf/rector.php.example ./conf/rector.php \
 ##### PHPStan
 
 ```sh
-cp -v ./vendor/brnshkr/config/conf/phpstan.neon.example ./conf/phpstan.neon \
-  && cp -v ./vendor/brnshkr/config/conf/phpstan.dist.neon.example ./conf/phpstan.dist.neon
+cp -v ./vendor/brnshkr/config/conf/phpstan.php.example ./conf/phpstan.php \
+  && cp -v ./vendor/brnshkr/config/conf/phpstan.php.example ./conf/phpstan.php.example \
+  && cp -v ./vendor/brnshkr/config/conf/phpstan.dist.php.example ./conf/phpstan.dist.php
+```
+
+<!-- omit in toc -->
+##### Twig CS Fixer
+
+```sh
+cp -v ./vendor/brnshkr/config/conf/twig-cs-fixer.php.example ./conf/twig-cs-fixer.php \
+  && cp -v ./vendor/brnshkr/config/conf/twig-cs-fixer.php.example ./conf/twig-cs-fixer.php.example \
+  && cp -v ./vendor/brnshkr/config/conf/twig-cs-fixer.dist.php.example ./conf/twig-cs-fixer.dist.php
 ```
 
 <!-- omit in toc -->
@@ -351,12 +363,18 @@ cp -v ./vendor/brnshkr/config/conf/.gitignore.example ./.gitignore
 ##### All
 
 ```sh
-cp -v ./vendor/brnshkr/config/conf/.php-cs-fixer.php.example ./conf/.php-cs-fixer.php \
-  && cp -v ./vendor/brnshkr/config/conf/.php-cs-fixer.dist.php.example ./conf/.php-cs-fixer.dist.php \
+cp -v ./vendor/brnshkr/config/conf/php-cs-fixer.php.example ./conf/php-cs-fixer.php \
+  && cp -v ./vendor/brnshkr/config/conf/php-cs-fixer.php.example ./conf/php-cs-fixer.php.example \
+  && cp -v ./vendor/brnshkr/config/conf/php-cs-fixer.dist.php.example ./conf/php-cs-fixer.dist.php \
   && cp -v ./vendor/brnshkr/config/conf/rector.php.example ./conf/rector.php \
+  && cp -v ./vendor/brnshkr/config/conf/rector.php.example ./conf/rector.php.example \
   && cp -v ./vendor/brnshkr/config/conf/rector.dist.php.example ./conf/rector.dist.php \
-  && cp -v ./vendor/brnshkr/config/conf/phpstan.neon.example ./conf/phpstan.neon \
-  && cp -v ./vendor/brnshkr/config/conf/phpstan.dist.neon.example ./conf/phpstan.dist.neon \
+  && cp -v ./vendor/brnshkr/config/conf/phpstan.php.example ./conf/phpstan.php \
+  && cp -v ./vendor/brnshkr/config/conf/phpstan.php.example ./conf/phpstan.php.example \
+  && cp -v ./vendor/brnshkr/config/conf/phpstan.dist.php.example ./conf/phpstan.dist.php \
+  && cp -v ./vendor/brnshkr/config/conf/twig-cs-fixer.php.example ./conf/twig-cs-fixer.php \
+  && cp -v ./vendor/brnshkr/config/conf/twig-cs-fixer.php.example ./conf/twig-cs-fixer.php.example \
+  && cp -v ./vendor/brnshkr/config/conf/twig-cs-fixer.dist.php.example ./conf/twig-cs-fixer.dist.php \
   && cp -v ./vendor/brnshkr/config/conf/Makefile.example ./Makefile \
   && cp -v ./vendor/brnshkr/config/conf/.gitignore.example ./.gitignore
 ```
@@ -371,42 +389,60 @@ Take a look at the function signatures for exact details.
 ##### PHP CS Fixer
 
 ```php
-// ./.php-cs-fixer.dist.php
+// ./php-cs-fixer.dist.php
 
 <?php
 
 declare(strict_types=1);
 
-use Brnshkr\Config\PhpCsFixerConfig;
+use Brnshkr\Config\PhpCsFixer;
 
-return PhpCsFixerConfig::get(/* customize */);
+return PhpCsFixer::getConfig(/* customize */);
 ```
 
 <!-- omit in toc -->
 ##### Rector
 
 ```php
-// ./rector.php
+// ./rector.dist.php
 
 <?php
 
 declare(strict_types=1);
 
-use Brnshkr\Config\RectorConfig;
+use Brnshkr\Config\Rector;
 
-return RectorConfig::get(/* customize */);
+return Rector::getConfig(/* customize */);
 ```
 
 <!-- omit in toc -->
 ##### PHPStan
 
-```yaml
-# phpstan.dist.neon
+```php
+// ./phpstan.dist.php
+
+<?php
+
+declare(strict_types=1);
+
+use Brnshkr\Config\PhpStan;
+
+return PhpStan::getConfig(/* customize */);
+```
+
+<!-- omit in toc -->
+##### Twig CS Fixer
+
+```php
+// ./twig-cs-fixer.dist.php
+
+<?php
 
-includes:
-  - '%currentWorkingDirectory%/vendor/brnshkr/config/conf/phpstan.dist.neon'
+declare(strict_types=1);
 
-# customize
+use Brnshkr\Config\TwigCsFixer;
+
+return TwigCsFixer::getConfig(/* customize */);
 ```
 
 <p align="right"><a href="#top" title="Back to top">&nbsp;&nbsp;&nbsp;⬆&nbsp;&nbsp;&nbsp;</a></p>
@@ -428,7 +464,7 @@ A few possible ways are listed below:
 Example call, adjust as needed
 
 ```sh
-php ./vendor/bin/php-cs-fixer fix -v --show-progress=dots --config ./conf/.php-cs-fixer.php
+php ./vendor/bin/php-cs-fixer fix --config ./conf/php-cs-fixer.php -v --show-progress=dots
 ```
 
 <!-- omit in toc -->
@@ -437,7 +473,7 @@ php ./vendor/bin/php-cs-fixer fix -v --show-progress=dots --config ./conf/.php-c
 Example call, adjust as needed
 
 ```sh
-php ./vendor/bin/rector process --config ./conf/rector.php
+php ./vendor/bin/rector process --config ./conf/rector.php --memory-limit=-1
 ```
 
 <!-- omit in toc -->
@@ -446,7 +482,16 @@ php ./vendor/bin/rector process --config ./conf/rector.php
 Example call, adjust as needed
 
 ```sh
-php ./vendor/bin/phpstan analyze --memory-limit=-1 --configuration ./conf/phpstan.neon
+php ./vendor/bin/phpstan analyze --configuration ./conf/phpstan.php -vv --memory-limit=-1
+```
+
+<!-- omit in toc -->
+###### Twig CS Fixer
+
+Example call, adjust as needed
+
+```sh
+php ./vendor/bin/twig-cs-fixer fix --config ./conf/twig-cs-fixer.php -v
 ```
 
 <!-- omit in toc -->
@@ -463,7 +508,7 @@ include ./vendor/brnshkr/config/conf/Makefile
 <!-- omit in toc -->
 ###### PHP CS Fixer
 
-Expected configuration file: `./conf/.php-cs-fixer.php`
+Expected configuration file: `./conf/php-cs-fixer.php`
 
 ```sh
 make php-cs-fixer
@@ -481,12 +526,21 @@ make rector
 <!-- omit in toc -->
 ###### PHPStan
 
-Expected configuration file: `./conf/phpstan.neon`
+Expected configuration file: `./conf/phpstan.php`
 
 ```sh
 make phpstan
 ```
 
+<!-- omit in toc -->
+###### Twig CS Fixer
+
+Expected configuration file: `./conf/twig-cs-fixer.php`
+
+```sh
+make twig-cs-fixer
+```
+
 <!-- omit in toc -->
 #### IDE Setup
 
@@ -517,9 +571,10 @@ Install dependencies and setup project tooling with the following commands and a
 
 ```sh
 composer install \
-  && cp -v ./conf/.php-cs-fixer.php.example ./conf/.php-cs-fixer.php \
+  && cp -v ./conf/php-cs-fixer.php.example ./conf/php-cs-fixer.php \
   && cp -v ./conf/rector.php.example ./conf/rector.php \
-  && cp -v ./conf/phpstan.neon.example ./conf/phpstan.neon
+  && cp -v ./conf/phpstan.php.example ./conf/phpstan.php \
+  && cp -v ./conf/twig-cs-fixer.php.example ./conf/twig-cs-fixer.php
 ```
 
 <!-- omit in toc -->
@@ -542,7 +597,7 @@ Here are some frequently used examples (see `make help` for the complete list):
 - `make phpstan` — Run PHPStan static analysis
 - `make test` — Run PHPUnit test suite
 - `make test-update` — Run PHPUnit test suite and update snapshots
-- `make check` — Run Rector, PHP-CS-Fixer, PHPStan and PHPUnit
+- `make check` — Run Rector, PHP-CS-Fixer, Twig-CS-Fixer, PHPStan and PHPUnit
 
 ## 🔨 TODOs / Roadmap
 
@@ -623,8 +678,9 @@ Distributed under the MIT License. See [LICENSE](./LICENSE) for more information
 - [PHP](https://www.php.net)
 - [PHPStan](https://github.com/phpstan/phpstan)
 - [Rector](https://github.com/rectorphp/rector)
+- [PHP-CS-Fixer](https://github.com/PHP-CS-Fixer/PHP-CS-Fixer)
+- [Twig-CS-Fixer](https://github.com/VincentLanglet/Twig-CS-Fixer)
 - [GNU Make](https://www.gnu.org/software/make)
-- [PHP Coding Standards Fixer](https://github.com/PHP-CS-Fixer/PHP-CS-Fixer)
 - [Best-README-Template](https://github.com/othneildrew/Best-README-Template) by [othneildrew](https://github.com/othneildrew)
 - [Choose an Open Source License](https://choosealicense.com)
 - [Shields.io](https://shields.io)
@@ -659,6 +715,6 @@ Distributed under the MIT License. See [LICENSE](./LICENSE) for more information
 [issues-url]: https://github.com/brnshkr/config/issues
 [issues-shield-url]: https://img.shields.io/github/issues/brnshkr/config.svg?label=🚨%20issues&style=flat-square&labelColor=%237f399d&color=%23a5097e
 
-<!-- NOTICE: Only use npm version here since both packages are versioned in sync -->
+<!-- NOTICE: Only use packagist version here since both packages are versioned in sync -->
 [release-url]: https://github.com/brnshkr/config/releases
-[release-shield-url]: https://img.shields.io/npm/v/%40brnshkr%2Fconfig?label=📦%20npm%2Fpackagist&style=flat-square&labelColor=%237f399d&color=%23a5097e
+[release-shield-url]: https://img.shields.io/packagist/v/brnshkr/config?style=flat-square&label=📦%20npm%2Fpackagist&labelColor=7f399d&color=%23a5097e

package/conf/tsconfig.json

@@ -32,16 +32,15 @@
   ],
   "compilerOptions": {
     // Language and Environment
-    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "lib": ["ESNext", "DOM"],
     "moduleDetection": "force",
-    "target": "esnext",
 
     // Modules
     "allowImportingTsExtensions": true,
-    "module": "esnext",
+    "module": "preserve",
     "moduleResolution": "bundler",
-    "noUncheckedSideEffectImports": true,
     "resolveJsonModule": true,
+    "types": ["bun"],
 
     // Emit
     "noEmit": true,
@@ -55,7 +54,6 @@
     "checkJs": true,
 
     // Interop Constraints
-    "esModuleInterop": true,
     "forceConsistentCasingInFileNames": true,
     "verbatimModuleSyntax": true,
 
@@ -68,7 +66,6 @@
     "noPropertyAccessFromIndexSignature": true,
     "noUncheckedIndexedAccess": true,
     "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "strict": true
+    "noUnusedParameters": true
   }
 }