[Feature] Add ESLint plugin for js-toolkit best practices

.github/workflows/benchmarks.yml

@@ -24,7 +24,7 @@ jobs:
           node-version: 24
           cache: npm
       - name: Install dependencies
-        run: npm install
+        run: npm ci
       - name: Run the benchmarks
         uses: CodSpeedHQ/action@v4
         with:

.github/workflows/publish.yml

@@ -34,19 +34,37 @@ jobs:
           key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
           restore-keys: ${{ runner.os }}-node-
 
-      - run: npm install --no-audit --no-fund
+      - run: npm ci --no-audit --no-fund
 
-      - run: npm run build
+      - name: Build js-toolkit
+        run: npm run build
 
-      - name: Test
+      - name: Build oxlint-plugin
+        run: npm run build
+        working-directory: packages/eslint-plugin-js-toolkit
+
+      - name: Test js-toolkit
         run: npm run test -- -- --retry=3 --coverage.enabled
 
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@v4
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
-          directory: ./packages/coverage
-          flags: unittests
+          files: ./packages/coverage/clover.xml
+          flags: js-toolkit
+          fail_ci_if_error: false
+          verbose: true
+
+      - name: Test oxlint-plugin
+        run: npm test -- --retry=3 --coverage.enabled
+        working-directory: packages/eslint-plugin-js-toolkit
+
+      - name: Upload oxlint-plugin coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: packages/eslint-plugin-js-toolkit/coverage/clover.xml
+          flags: eslint-plugin-js-toolkit
           fail_ci_if_error: false
           verbose: true
 
@@ -69,6 +87,13 @@ jobs:
           tag: ${{ env.NPM_TAG }}
           token: ${{ secrets.NPM_TOKEN }}
 
+      - uses: JS-DevTools/npm-publish@v3
+        with:
+          provenance: true
+          package: packages/eslint-plugin-js-toolkit/
+          tag: ${{ env.NPM_TAG }}
+          token: ${{ secrets.NPM_TOKEN }}
+
       - uses: ncipollo/release-action@v1
         with:
           tag: ${{ github.ref }}

.github/workflows/tests.yml

@@ -18,7 +18,7 @@ jobs:
           node-version: 24
           cache: npm
       - name: Install dependencies
-        run: npm install
+        run: npm ci --no-audit --no-progress --no-fund
       - name: Build
         run: npm run build
 
@@ -31,29 +31,46 @@ jobs:
           node-version: 24
           cache: npm
       - name: Install dependencies
-        run: npm install
+        run: npm ci --no-audit --no-progress --no-fund
       - name: Run code quality tests
-        run: npm run lint:oxlint
+        run: npm run lint:static
+      - name: Run format tests
+        run: npm run lint:fmt
       - name: Run types tests
         run: npm run lint:types
 
   unit:
     runs-on: macos-latest
+    strategy:
+      matrix:
+        include:
+          - package: js-toolkit
+            working-directory: .
+            test-command: npm run test -- -- --retry=3 --coverage.enabled
+            coverage-file: ./packages/coverage/clover.xml
+          - package: eslint-plugin-js-toolkit
+            working-directory: packages/eslint-plugin-js-toolkit
+            test-command: npm test -- --retry=3 --coverage.enabled
+            coverage-file: packages/eslint-plugin-js-toolkit/coverage/clover.xml
+    name: unit (${{ matrix.package }})
+    defaults:
+      run:
+        working-directory: ${{ matrix.working-directory }}
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
           node-version: 24
           cache: npm
       - name: Install dependencies
-        run: npm install
+        run: npm ci --no-audit --no-progress --no-fund
       - name: Run tests
-        run: npm run test -- -- --retry=3 --coverage.enabled
+        run: ${{ matrix.test-command }}
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@v4
         with:
-          files: ./packages/coverage/clover.xml
-          flags: unittests
+          files: ${{ matrix.coverage-file }}
+          flags: ${{ matrix.package }}
           fail_ci_if_error: false
           verbose: true
         env:

.oxlintrc.json

@@ -1,10 +1,33 @@
 {
+  "jsPlugins": [
+    { "name": "js-toolkit", "specifier": "./packages/eslint-plugin-js-toolkit/src/index.ts" }
+  ],
   "rules": {
     "typescript/no-this-alias": [
       "error",
       {
         "allowDestructuring": true
       }
     ]
-  }
+  },
+  "overrides": [
+    {
+      "files": ["packages/js-toolkit/**/*.ts", "packages/demo/**/*.{ts,js}"],
+      "rules": {
+        "js-toolkit/require-config": "error",
+        "js-toolkit/require-config-name-pascal-case": "error",
+        "js-toolkit/refs-camel-case": "error",
+        "js-toolkit/refs-plural-multiple": "error",
+        "js-toolkit/options-camel-case": "error",
+        "js-toolkit/async-lifecycle-methods": "error",
+        "js-toolkit/on-handler-naming": "error",
+        "js-toolkit/on-global-handler-prefix": "warn",
+        "js-toolkit/no-deprecated-properties": "error",
+        "js-toolkit/no-dispatch-event": "warn",
+        "js-toolkit/no-shadow-dom": "error",
+        "js-toolkit/no-create-app": "warn",
+        "js-toolkit/no-event-listener-methods": "error"
+      }
+    }
+  ]
 }

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file. The format
 
 ## [Unreleased]
 
+### Added
+
+- Add `@studiometa/eslint-plugin-js-toolkit` package with 20 rules enforcing best practices for `@studiometa/js-toolkit` projects ([#726](https://github.com/studiometa/js-toolkit/pull/726), [e2477e79](https://github.com/studiometa/js-toolkit/commit/e2477e79))
+
 ## [v3.6.0-beta.0](https://github.com/studiometa/js-toolkit/compare/3.5.0..3.6.0-beta.0) (2026-04-21)
 
 ### Added

README.md

@@ -29,6 +29,16 @@ This project is a JavaScript micro-framework (along with its utility functions)
 
 Visit [js-toolkit.studiometa.dev](https://js-toolkit.studiometa.dev) to learn more, jump directly to [ui.studiometa.dev](https://ui.studiometa.dev) to discover existing components, or open [the playground](https://ui.studiometa.dev/-/play/) to test it live.
 
+## Linting
+
+The [`@studiometa/eslint-plugin-js-toolkit`](./packages/eslint-plugin-js-toolkit/) package provides an Oxlint/ESLint plugin that enforces best practices when writing components with this framework.
+
+```bash
+npm install --save-dev @studiometa/eslint-plugin-js-toolkit
+```
+
+See the [plugin README](./packages/eslint-plugin-js-toolkit/README.md) or the [linting guide](https://js-toolkit.studiometa.dev/guide/going-further/linting.html) for configuration details.
+
 ## Quick overview
 
 This framework lets you define components as classes, and bind them to the DOM with `data-…` attributes. For example, here is how a `Counter` component would be defined in JavaScript: