feat: TSL Linter Compatibility Layer (Consolidated) (#79)

Author: johnsoncodehk

README.md

@@ -175,13 +175,12 @@ export default defineConfig({
 
 ### Ecosystem Integration
 
-TSSLint provides compatibility layers for existing linter ecosystems. These are available via `@tsslint/config` but require the corresponding compatibility package to be installed.
+TSSLint provides compatibility layers for existing linter ecosystems. The integration functions are available via `@tsslint/config`, and you only need to install the original linter package to use them.
 
 #### ESLint
-Convert ESLint rules via `@tsslint/compat-eslint`.
 
 ```bash
-npm install @tsslint/compat-eslint --save-dev
+npm install eslint@9.27.0 @typescript-eslint/parser --save-dev
 ```
 
 ```ts
@@ -200,10 +199,9 @@ export default defineConfig({
 `importESLintRules` will automatically resolve and load rules from ESLint plugins (e.g., `@typescript-eslint/eslint-plugin`) by searching your `node_modules`. Plugin rules are identified by their prefix (e.g., `@typescript-eslint/`).
 
 #### TSLint
-Convert TSLint rules via `@tsslint/compat-tslint`.
 
 ```bash
-npm install @tsslint/compat-tslint --save-dev
+npm install tslint --save-dev
 ```
 
 ```ts
@@ -222,7 +220,19 @@ export default defineConfig({
 `importTSLintRules` will automatically read `rulesDirectory` from your `tslint.json` to support third-party TSLint plugins.
 
 #### TSL
-Convert TSL rules via `@tsslint/compat-tsl`.
+
+```bash
+npm install tsl --save-dev
+```
+
+```ts
+import { defineConfig, fromTSLRules } from '@tsslint/config';
+import { core } from 'tsl';
+
+export default defineConfig({
+	rules: fromTSLRules(core.all()),
+});
+```
 
 ## Technical Notes
 

fixtures/define-eslint-rules/fixture.ts fixtures/compat-eslint/fixture.tsfixtures/define-eslint-rules/fixture.ts renamed to fixtures/compat-eslint/fixture.ts

@@ -1,10 +1,10 @@
 {
 	"private": true,
-	"name": "@tsslint-fixtures/convert-eslint-config",
+	"name": "@tsslint-fixtures/compat-eslint",
 	"version": "3.0.0-alpha.0",
 	"devDependencies": {
 		"@tsslint/config": "3.0.0-alpha.0",
-		"@tsslint/compat-eslint": "3.0.0-alpha.0",
+
 		"eslint-plugin-expect-type": "^0.4.0"
 	}
 }

fixtures/define-eslint-rules/package.json fixtures/compat-eslint/package.jsonfixtures/define-eslint-rules/package.json renamed to fixtures/compat-eslint/package.json

@@ -0,0 +1,9 @@
+{
+	"private": true,
+	"name": "@tsslint-fixtures/compat-tsl",
+	"version": "3.0.0-alpha.0",
+	"devDependencies": {
+		"@tsslint/config": "3.0.0-alpha.0",
+		"tsl": "^1.0.28"
+	}
+}

…xtures/define-eslint-rules/tsconfig.json fixtures/compat-eslint/tsconfig.jsonfixtures/define-eslint-rules/tsconfig.json renamed to fixtures/compat-eslint/tsconfig.json fixtures/define-eslint-rules/tsconfig.json renamed to fixtures/compat-eslint/tsconfig.json

@@ -0,0 +1,6 @@
+import { defineConfig, fromTSLRules } from '@tsslint/config';
+import { core } from 'tsl';
+
+export default defineConfig({
+	rules: fromTSLRules(core.all()),
+});

…es/define-eslint-rules/tsslint.config.ts fixtures/compat-eslint/tsslint.config.tsfixtures/define-eslint-rules/tsslint.config.ts renamed to fixtures/compat-eslint/tsslint.config.ts fixtures/define-eslint-rules/tsslint.config.ts renamed to fixtures/compat-eslint/tsslint.config.ts

@@ -0,0 +1,28 @@
+// @ts-nocheck
+// nullable numbers are considered unsafe by default
+let num: number | undefined = 0;
+if (num) {
+	console.log('num is defined');
+}
+
+// nullable strings are considered unsafe by default
+let str: string | null = null;
+if (!str) {
+	console.log('str is empty');
+}
+
+// nullable booleans are considered unsafe by default
+function foo(bool?: boolean) {
+	if (bool) {
+		bar();
+	}
+}
+
+// `any`, unconstrained generics and unions of more than one primitive type are disallowed
+const foo = <T>(arg: T) => (arg ? 1 : 0);
+
+// always-truthy and always-falsy types are disallowed
+let obj = {};
+while (obj) {
+	obj = getObj();
+}