@airframeui/eslint-plugin 0.2.0 → 0.3.0

package/README.md

@@ -1,8 +1,8 @@
 # @airframeui/eslint-plugin
 
-ESLint rules that keep projects on [@airframeui](https://airframeui.com) — catch leftover Tailwind/Bootstrap classes, unknown `af-*` names, redundant defaults, and field-error ARIA.
+ESLint rules that keep markup on [Airframe](https://airframeui.com): leftover Tailwind/Bootstrap utilities, unknown `af-*` names, redundant defaults, layout recipes, and field-error ARIA.
 
-Docs: [airframeui.com/docs/eslint-plugin](https://airframeui.com/docs/eslint-plugin)
+Same version as `@airframeui/core`. Docs: [airframeui.com/docs/eslint-plugin](https://airframeui.com/docs/eslint-plugin)
 
 ## Installation
 
@@ -10,70 +10,79 @@ Docs: [airframeui.com/docs/eslint-plugin](https://airframeui.com/docs/eslint-plu
 npm install -D @airframeui/eslint-plugin
 ```
 
-Requires ESLint 9+ (flat config) or ESLint 8 with eslintrc. Same version as `@airframeui/core` / `@airframeui/tokens` (Changesets fixed group). The plugin ships a build-time snapshot of `classes.json` and the token catalog — the same sources [IntelliSense for Airframe](https://airframeui.com/docs/vscode-extension) uses. If those packages are installed in the project, their catalogs win so lint matches the CSS you actually ship.
+Requires ESLint 9+ (flat config) or ESLint 8.57+ with eslintrc. Core and tokens are optional peers — if they are installed, their catalogs win so lint matches the CSS you ship.
 
-## Usage
+## Setup
 
-### Flat config (recommended)
+### Flat config (ESLint 9+)
 
 ```js
 // eslint.config.js
 import airframe from '@airframeui/eslint-plugin';
 
-export default [airframe.configs['flat/recommended']];
+export default [
+  airframe.configs['flat/recommended'],
+];
 ```
 
-### Legacy `.eslintrc`
+Drop `airframe.configs['flat/recommended']` into an existing `export default [ ... ]` array. It enables JSX parsing for the Airframe rules.
+
+Override a rule after the preset:
+
+```js
+export default [
+  airframe.configs['flat/recommended'],
+  {
+    rules: {
+      '@airframeui/no-tailwind-classes': 'off',
+    },
+  },
+];
+```
+
+### Legacy eslintrc
 
 ```js
+// .eslintrc.cjs
 module.exports = {
   plugins: ['@airframeui'],
   extends: ['plugin:@airframeui/recommended'],
 };
 ```
 
+## Rules
+
+All seven rules ship in `recommended`. They only inspect **string literals** on `class` / `className` in JSX. Existing `af-*` tokens are ignored by the Tailwind and Bootstrap detectors.
+
+| Rule | Recommended | Autofix | What it does |
+| --- | --- | --- | --- |
+| `@airframeui/no-bootstrap-classes` | `warn` | no | Leftover Bootstrap 5 tokens (`btn`, `row`, `col-*`, `d-flex`, …) |
+| `@airframeui/no-redundant-defaults` | `warn` | yes | Restated defaults: `af-card af-stack`, `af-container af-container-xl`, matching `af-text-h*` |
+| `@airframeui/no-redundant-width` | `warn` | yes | `af-w-full` on form controls; `af-block` on `af-btn` |
+| `@airframeui/no-tailwind-classes` | `warn` | no | Leftover Tailwind utilities (`flex`, `gap-4`, `md:gap-4`, `bg-blue-600`, …) |
+| `@airframeui/no-unknown-airframe-class` | `error` | yes\* | Invented `af-*` names. Autofix for known aliases and catalog heuristics |
+| `@airframeui/prefer-airframe-layout-recipes` | `warn` | yes | Rewrites `flex flex-col`, `grid grid-cols-*`, `row`, `container`, … |
+| `@airframeui/require-field-error-aria` | `error` | no | `af-field__error` needs `id`; error inputs need `aria-describedby` |
+
 ## Autofix
 
-Rules marked **yes** in the table set `meta.fixable` and rewrite the `class` / `className` string (quotes are preserved; an empty class attribute is removed).
+Rules with a fix rewrite the `class` / `className` string (quotes stay; an empty class attribute is removed).
 
 ```bash
 npx eslint . --fix
 ```
 
-Same command as the editor **Fix all auto-fixable problems** action. Autofix only runs for deterministic mappings:
+Same command as the editor **Fix all auto-fixable problems** action.
 
-| Fixed | Not fixed |
-| --- | --- |
-| Known aliases (`af-btn-danger` → `af-btn af-is-danger`) | Unknown `af-*` with only a fuzzy guess |
-| Heuristic `af-{pattern}-{variant}` when both parts exist in `classes.json` | Tailwind / Bootstrap leftovers (unless they also match a layout recipe) |
-| Layout recipes (`flex flex-col gap-4` → `af-stack af-gap-lg`) | Field-error ARIA (you must choose the `id`) |
-| Redundant defaults and width (`af-card af-stack af-gap-md` → `af-card`) | |
-
-## Rules
+Autofix only runs when the replacement is deterministic: known aliases, catalog heuristics, layout recipes, redundant defaults, and redundant width. Unknown names with only a fuzzy guess, leftover Tailwind/Bootstrap that is not a layout recipe, and field-error ARIA are reported without a fix.
 
-All seven rules ship in `recommended`. They only inspect **string literals** on `class` / `className` in JSX. Existing `af-*` tokens are ignored by the Tailwind and Bootstrap detectors.
-
-| Rule | Recommended | Autofix | What it means |
-| --- | --- | --- | --- |
-| `@airframeui/no-tailwind-classes` | warn | no | A class token looks like Tailwind (layout, spacing, type, colour, `sm:` / `md:` prefixes). Prefer Airframe classes. |
-| `@airframeui/no-bootstrap-classes` | warn | no | A class token looks like Bootstrap (`btn`, `row`, `col-*`, `card-*`, `d-flex`, …). Prefer Airframe classes. |
-| `@airframeui/prefer-airframe-layout-recipes` | warn | yes | A known utility combo should be an Airframe layout recipe (`af-stack`, `af-inline`, `af-grid`, `af-container`). |
-| `@airframeui/require-field-error-aria` | error | no | Error copy and error inputs must be wired for assistive tech. |
-| `@airframeui/no-unknown-airframe-class` | error | yes* | Invented `af-*` names. Autofix when there is a known alias or catalog heuristic. |
-| `@airframeui/no-redundant-defaults` | warn | yes | Classes that restate a pattern default (`af-card` + `af-stack`, `af-container af-container-xl`, `<h1 class="af-text-h1">`). |
-| `@airframeui/no-redundant-width` | warn | yes | `af-w-full` on form controls (already 100%); `af-block` on `af-btn` (use `af-w-full`). |
+## Rewrites
 
-### `@airframeui/no-tailwind-classes`
+### Layout recipes
 
-Flags whole tokens such as `flex`, `flex-col`, `grid-cols-3`, `gap-4`, `p-4`, `items-center`, `justify-between`, `text-sm`, `bg-blue-600`, `md:gap-4`. Does not flag `af-grid` or `af-btn`.
+`@airframeui/prefer-airframe-layout-recipes` — skipped if the attribute already has `af-stack`, `af-inline`, `af-grid`, `af-cluster`, `af-spread`, `af-center`, or `af-container`.
 
-### `@airframeui/no-bootstrap-classes`
-
-Flags whole tokens such as `btn`, `btn-primary`, `row`, `col-lg-6`, `d-flex`, `container`, `card-body`, `alert-warning`. Does not flag `af-card` or `af-btn`.
-
-### `@airframeui/prefer-airframe-layout-recipes`
-
-Rewrites these combos. Gap numbers map to the Airframe scale (`4` → `lg`, `8` → `2xl`). Default `md` (`gap-3` / `g-3`) is omitted because `af-stack` / `af-grid` already use it.
+Gap numbers map to the Airframe named scale (`0` · `xs` · `sm` · `md` · `lg` · `xl` · `2xl` · `3xl` · `4xl`). Default `md` (`gap-3` / `g-3`) is omitted because `af-stack` / `af-grid` already use it.
 
 | Before | After |
 | --- | --- |
@@ -85,20 +94,9 @@ Rewrites these combos. Gap numbers map to the Airframe scale (`4` → `lg`, `8`
 | `d-grid` / `row` | `af-grid` |
 | `container` / `container-fluid` | `af-container` |
 
-Skipped if the attribute already has `af-stack`, `af-inline`, `af-grid`, `af-cluster`, `af-spread`, `af-center`, or `af-container`.
-
-### `@airframeui/require-field-error-aria`
-
-Two checks:
+### Unknown `af-*` names
 
-| Markup | Required |
-| --- | --- |
-| `class` contains `af-field__error` | `id` on that element (for `aria-describedby`) |
-| `class` contains `af-is-error`, or `aria-invalid="true"` | `aria-describedby` on that element |
-
-### `@airframeui/no-unknown-airframe-class`
-
-Flags `af-*` tokens that are not in the class catalog. Prefers the linted project's `@airframeui/core/classes.json`, then the snapshot generated from core at plugin build time.
+`@airframeui/no-unknown-airframe-class` — prefers the project's `@airframeui/core/classes.json`, then the snapshot bundled at plugin build time.
 
 | Invented | Autofix |
 | --- | --- |
@@ -108,39 +106,67 @@ Flags `af-*` tokens that are not in the class catalog. Prefers the linted projec
 | `af-{pattern}-{variant}` when both `af-{pattern}` and `af-is-{variant}` exist | `af-{pattern} af-is-{variant}` |
 | Anything else unknown | Message may suggest a close name; no autofix |
 
-### `@airframeui/no-redundant-defaults`
+Do not invent `af-*` names. Use catalog classes (`af-btn af-is-danger`, not `af-btn-danger`).
 
-| Before | After |
-| --- | --- |
-| `af-card af-stack af-gap-md` | `af-card` |
-| `af-grid af-gap-md` / `af-stack af-gap-md` | `af-grid` / `af-stack` |
-| `af-container af-container-xl` | `af-container-xl` |
-| `<h1 class="af-text-h1">` | `<h1>` |
+### Redundant markup
 
-Kept: `af-card af-gap-lg`, `af-card af-inline`, `af-container af-container-lg@xl`, `<h2 class="af-text-h1">`.
+| Before | After | Rule |
+| --- | --- | --- |
+| `af-card af-stack af-gap-md` | `af-card` | `no-redundant-defaults` |
+| `af-grid af-gap-md` / `af-stack af-gap-md` | `af-grid` / `af-stack` | `no-redundant-defaults` |
+| `af-container af-container-xl` | `af-container-xl` | `no-redundant-defaults` |
+| `<h1 class="af-text-h1">` | `<h1>` | `no-redundant-defaults` |
+| `af-input af-w-full` | `af-input` | `no-redundant-width` |
+| `af-btn af-block` | `af-btn af-w-full` | `no-redundant-width` |
 
-### `@airframeui/no-redundant-width`
+Kept: `af-card af-gap-lg`, `af-card af-inline`, `af-container af-container-lg@xl`, `<h2 class="af-text-h1">`, `af-btn af-w-full`, `af-input af-is-autosize af-w-full`.
 
-| Before | After |
+Form controls that already span full width: `af-input`, `af-textarea`, `af-select`, `af-range`, `af-progress`, `af-meter`, `af-input-group`, `af-field__control`.
+
+### Field-error ARIA
+
+No autofix — you must choose the `id`.
+
+| Markup | Required |
 | --- | --- |
-| `af-input af-w-full` (also textarea, select, range, progress, meter, input-group, `af-field__control`) | `af-input` |
-| `af-btn af-block` | `af-btn af-w-full` |
+| `class` contains `af-field__error` | `id` on that element (for `aria-describedby`) |
+| `class` contains `af-is-error`, or `aria-invalid="true"` | `aria-describedby` on that element |
 
-Not flagged: `af-btn af-w-full`, `af-input af-is-autosize af-w-full`.
+```jsx
+<label className="af-field">
+  <span className="af-field__label">Email</span>
+  <input className="af-input af-is-error" aria-describedby="email-error" />
+  <p className="af-field__error" id="email-error">Enter a valid email.</p>
+</label>
+```
 
-### Notes
+## For coding agents
 
-- Template literals, `class:list`, Vue/Svelte bindings, and Astro expression attributes are not covered yet.
-- Tailwind/Bootstrap detectors ignore existing `af-*` tokens so `af-grid` / `af-btn` do not false-positive.
+Enable `recommended`, then treat lint as the source of truth for `af-*` markup:
 
-## Links
+```text
+write class / className string literals → npx eslint . --fix → fix remaining reports by hand
+```
+
+- Apply `--fix` first. Do not invent a different `af-*` name when the message already suggests one.
+- Map leftover Tailwind/Bootstrap layout combos with the tables above. Do not leave `flex flex-col` next to `af-stack`.
+- For field-error ARIA, add a real `id` and matching `aria-describedby`. There is no autofix.
+- Do not wrap classes in template literals, `clsx`, or `class:list` to dodge the rules — those forms are not checked yet, and the markup is still wrong.
+
+## Current limitations
+
+- Checks **string literals** on `class` / `className` only (React JSX). Not yet: template literals, `class:list`, Vue/Svelte bindings, Astro expression attributes, or HTML files.
+- `@airframeui/no-unknown-airframe-class` prefers the project's `@airframeui/core/classes.json`, then the snapshot generated from core at plugin build time (same `classes.json` + token catalog as [IntelliSense for Airframe](https://airframeui.com/docs/vscode-extension)).
+- Tailwind/Bootstrap detectors ignore existing `af-*` tokens so `af-grid` / `af-btn` are not flagged.
+
+## Related
 
 - Docs: [airframeui.com/docs/eslint-plugin](https://airframeui.com/docs/eslint-plugin)
-- Site: [airframeui.com](https://airframeui.com)
-- Source: [github.com/airframeui/airframeui](https://github.com/airframeui/airframeui/tree/main/packages/eslint-plugin)
+- [`@airframeui/core`](https://www.npmjs.com/package/@airframeui/core) — CSS system (install this in the app)
+- [IntelliSense for Airframe](https://airframeui.com/docs/vscode-extension) — autocomplete for `af-*` / `--af-*`
+- [Coming from Bootstrap 5 or Tailwind](https://airframeui.com/docs/migrate)
+- [Packages](https://airframeui.com/docs/packages)
 
 ## License
 
-Airframe core libraries are licensed under the MIT License.
-
-Commercial tooling, premium themes, and hosted services may be offered under separate commercial licenses.
+MIT

package/dist/data.json

@@ -1,12 +1,12 @@
 {
-  "version": "0.2.0",
-  "generatedAt": "2026-08-18T14:18:55.957Z",
+  "version": "0.3.0",
+  "generatedAt": "2026-08-22T08:45:57.971Z",
   "source": {
     "classes": "packages/core/dist/classes.json",
     "tokens": "packages/tokens/dist/catalog.json"
   },
-  "classCount": 2486,
-  "tokenCount": 362,
+  "classCount": 2497,
+  "tokenCount": 366,
   "classes": [
     "af-absolute",
     "af-accordion",
@@ -548,6 +548,7 @@
     "af-drawer-header",
     "af-drawer-right",
     "af-drawer-title",
+    "af-dropdown",
     "af-dropdown-menu",
     "af-dropdown-menu-open",
     "af-empty-state",
@@ -867,6 +868,7 @@
     "af-inline@xs",
     "af-input",
     "af-input-group",
+    "af-input-group-action",
     "af-input-group-addon",
     "af-inset-0",
     "af-is-active",
@@ -876,6 +878,7 @@
     "af-is-danger",
     "af-is-disabled",
     "af-is-dropzone",
+    "af-is-end",
     "af-is-error",
     "af-is-fading",
     "af-is-ghost",
@@ -892,6 +895,7 @@
     "af-is-primary",
     "af-is-secondary",
     "af-is-sm",
+    "af-is-start",
     "af-is-success",
     "af-is-tertiary",
     "af-is-vertical",
@@ -2059,6 +2063,7 @@
     "af-py-xs@xl",
     "af-py-xs@xs",
     "af-radio",
+    "af-radius",
     "af-radius-full",
     "af-radius-full@2xl",
     "af-radius-full@lg",
@@ -2087,6 +2092,12 @@
     "af-radius-sm@sm",
     "af-radius-sm@xl",
     "af-radius-sm@xs",
+    "af-radius@2xl",
+    "af-radius@lg",
+    "af-radius@md",
+    "af-radius@sm",
+    "af-radius@xl",
+    "af-radius@xs",
     "af-range",
     "af-reduce-motion",
     "af-reduce-motion@2xl",
@@ -2777,12 +2788,16 @@
     "--af-link-hover-decoration",
     "--af-link-hover-primary",
     "--af-link-primary",
+    "--af-pill-radius",
+    "--af-radius",
     "--af-radius-0",
     "--af-radius-full",
     "--af-radius-lg",
     "--af-radius-md",
     "--af-radius-sm",
     "--af-radius-xl",
+    "--af-range-thumb-size",
+    "--af-range-track-height",
     "--af-shadow-lg",
     "--af-shadow-md",
     "--af-shadow-sm",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@airframeui/eslint-plugin",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Airframe UI ESLint plugin — catch Tailwind/Bootstrap drift, unknown af-* classes, and redundant defaults",
   "license": "MIT",
   "homepage": "https://airframeui.com/docs/eslint-plugin",
@@ -52,8 +52,8 @@
     "@types/node": "26.2.0",
     "eslint": "10.8.1",
     "typescript": "6.0.3",
-    "@airframeui/core": "0.2.0",
-    "@airframeui/tokens": "0.2.0"
+    "@airframeui/core": "0.3.0",
+    "@airframeui/tokens": "0.3.0"
   },
   "turbo": {
     "tasks": {