@xylabs/eslint-config-flat 8.1.21 → 8.2.1

package/README.md

@@ -49,6 +49,28 @@ const eslintConfig: Linter.Config[] = [
 export default eslintConfig
 ```
 
+### Tiered presets
+
+Each tier is a **superset** of the previous tier. Pick the strictness level that fits your project.
+
+| Export | Tier | Description |
+|--------|------|-------------|
+| `correctnessConfig` | 0 | Type safety, bug prevention, import restrictions |
+| `consistencyConfig` | 1 | Tier 0 + formatting, member ordering, complexity limits |
+| `bestPracticesConfig` | 2 | Tier 1 + unicorn and import validation (**default**) |
+| `opinionatedConfig` | 3 | Tier 2 + optional stricter rules (mostly warnings) |
+| `strictConfig` | 4 | Tier 3 + SonarJS and warnings promoted to errors |
+
+Type-checked variants append `TypeChecked` (for example `bestPracticesTypeCheckedConfig`).
+
+```ts
+import { strictTypeCheckedConfig } from '@xylabs/eslint-config-flat'
+
+export default [...strictTypeCheckedConfig]
+```
+
+`config` and `recommendedTypeCheckedConfig` are compatibility aliases for `bestPracticesTypeCheckedConfig`.
+
 ### Extending with custom rules
 
 ```ts
@@ -85,7 +107,7 @@ import {
 
 - TypeScript strict linting via `@typescript-eslint`
 - Import sorting and validation via `eslint-plugin-import-x`
-- Code quality checks via `eslint-plugin-sonarjs`
+- Code quality checks via `eslint-plugin-sonarjs` (strict tier)
 - Best practices via `eslint-plugin-unicorn`
 - Monorepo workspace rules via `eslint-plugin-workspaces`
 - Markdown linting via `eslint-plugin-markdown`
@@ -93,6 +115,12 @@ import {
 
 For React projects, use [`@xylabs/eslint-config-react-flat`](https://www.npmjs.com/package/@xylabs/eslint-config-react-flat) instead.
 
+## Rule ownership
+
+Some plugins cover similar territory. This config assigns a single canonical owner per concern and disables overlapping rules. See `RULE_OWNERSHIP_GROUPS` and `assertNoRuleOwnershipConflicts` exported from this package.
+
+When upgrading ESLint plugins, run tests in this package — `spec/plugin-rules.spec.ts` snapshots each plugin's rule list and fails when new rules appear.
+
 
 ## License
 
@@ -106,4 +134,4 @@ See the [LICENSE](LICENSE) file for license rights and limitations (LGPL-3.0-onl
 [npm-link]: https://www.npmjs.com/package/@xylabs/eslint-config-flat
 [license-badge]: https://img.shields.io/npm/l/@xylabs/eslint-config-flat.svg
 [license-link]: https://github.com/xylabs/sdk-js/blob/main/LICENSE
-[logo]: https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg
+[logo]: https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg

package/dist/neutral/core/index.d.ts

@@ -1,3 +1,5 @@
 import type { Linter } from 'eslint';
+export declare const correctnessCoreConfig: Linter.Config[];
+export declare const bestPracticesCoreConfig: Linter.Config[];
 export declare const coreConfig: Linter.Config[];
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AASpC,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAMrC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAapC,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAKhD,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAElD,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAIrC,CAAA"}

package/dist/neutral/import/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/import/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AAa5C,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EA+BvC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/import/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AAa5C,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAiCvC,CAAA"}

package/dist/neutral/index.d.ts

@@ -1,16 +1,17 @@
 import type { Linter } from 'eslint';
-export declare const recommendedConfig: Linter.Config[];
-export declare const recommendedTypeCheckedConfig: Linter.Config[];
 export declare const docsConfig: Linter.Config[];
-export declare const config: Linter.Config[];
-export { coreConfig } from './core/index.ts';
-export * from './ignores.ts';
+export { bestPracticesCoreConfig, coreConfig, correctnessCoreConfig, } from './core/index.ts';
+export { ignores } from './ignores.ts';
 export { importConfig } from './import/index.ts';
 export { json5Config, jsoncConfig, jsonConfig, } from './json/index.ts';
 export { markdownConfig } from './markdown/index.ts';
-export { rulesConfig, srcImportsConfig } from './rules/index.ts';
+export { consistencyRulesConfig, correctnessRulesConfig, rulesConfig, srcImportsConfig, } from './rules/index.ts';
 export { sonarConfig } from './sonar/index.ts';
-export { typescriptConfig, typescriptTypeCheckedConfig } from './typescript/index.ts';
-export { unicornConfig } from './unicorn/index.ts';
+export { assertNoRuleOwnershipConflicts, findRuleOwnershipConflicts, mergeConfigRules, RULE_OWNERSHIP_GROUPS, } from './tiers/conflicts.ts';
+export { bestPracticesConfig, bestPracticesTypeCheckedConfig, config, consistencyConfig, consistencyTypeCheckedConfig, correctnessConfig, correctnessTypeCheckedConfig, opinionatedConfig, opinionatedTypeCheckedConfig, recommendedConfig, recommendedTypeCheckedConfig, strictConfig, strictTypeCheckedConfig, } from './tiers/index.ts';
+export { opinionatedLayerConfig, strictLayerConfig, strictPromotionRules, } from './tiers/opinionated.ts';
+export { collectPluginRuleSnapshots, serializePluginRuleSnapshots, } from './tiers/plugin-rules.ts';
+export { typescriptConfig, typescriptConsistencyConfig, typescriptCorrectnessConfig, typescriptDelegationConfig, typescriptTypeCheckedConfig, typescriptTypeCheckedConsistencyConfig, typescriptTypeCheckedCorrectnessConfig, } from './typescript/index.ts';
+export { unicornConfig, unicornV66MigrationQueue, unicornV66NewRules, } from './unicorn/index.ts';
 export { workspacesConfig } from './workspaces/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAWpC,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAK5C,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAKvD,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAKrC,CAAA;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAiC,CAAA;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,cAAc,cAAc,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EACL,WAAW,EAAE,WAAW,EAAE,UAAU,GACrC,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAA;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAQpC,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAKrC,CAAA;AAED,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,qBAAqB,GACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EACL,WAAW,EAAE,WAAW,EACxB,UAAU,GACX,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,MAAM,EACN,iBAAiB,EACjB,4BAA4B,EAC5B,iBAAiB,EACjB,4BAA4B,EAC5B,iBAAiB,EACjB,4BAA4B,EAE5B,iBAAiB,EAEjB,4BAA4B,EAC5B,YAAY,EACZ,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,sCAAsC,EACtC,sCAAsC,GACvC,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA"}