From 86e154f47f5017abb60b4ade2c723c70d6c67386 Mon Sep 17 00:00:00 2001
From: lajczi <lajczi@disroot.org>
Date: Tue, 21 Jul 2026 22:55:38 +0200
Subject: [PATCH 01/12] feat(lint-plugin-nuxt-ecosystem): complete Nuxt UI
 rules

---
 .../NUXT_UI_RESEARCH.md                       | 70 +++++++++++++
 packages/lint-plugin-nuxt-ecosystem/README.md | 23 +++++
 .../lint-plugin-nuxt-ecosystem/package.json   |  1 +
 .../lint-plugin-nuxt-ecosystem/src/index.ts   | 92 ++++++++++++++++-
 .../no-conflicting-state-props/index.md       | 16 +++
 .../no-conflicting-state-props/index.test.ts  | 20 ++++
 .../no-conflicting-state-props/index.ts       | 41 ++++++++
 .../nuxt-ui/no-deprecated-components/index.ts |  2 +-
 .../no-deprecated-model-modifiers/index.md    |  2 +
 .../index.test.ts                             |  1 +
 .../no-deprecated-model-modifiers/index.ts    | 28 +++++-
 .../nuxt-ui/no-invalid-icon-name/index.md     | 12 +++
 .../no-invalid-icon-name/index.test.ts        | 18 ++++
 .../nuxt-ui/no-invalid-icon-name/index.ts     | 54 ++++++++++
 .../no-invalid-prop-combinations/index.md     | 13 +++
 .../index.test.ts                             | 25 +++++
 .../no-invalid-prop-combinations/index.ts     | 91 +++++++++++++++++
 .../nuxt-ui/no-invalid-prop-values/index.md   | 20 ++++
 .../no-invalid-prop-values/index.test.ts      | 24 +++++
 .../nuxt-ui/no-invalid-prop-values/index.ts   | 98 +++++++++++++++++++
 .../src/rules/nuxt-ui/prefer-link-to/index.md | 11 +++
 .../nuxt-ui/prefer-link-to/index.test.ts      | 14 +++
 .../src/rules/nuxt-ui/prefer-link-to/index.ts | 27 +++++
 .../rules/nuxt-ui/prefer-open-model/index.md  | 12 +++
 .../nuxt-ui/prefer-open-model/index.test.ts   | 14 +++
 .../rules/nuxt-ui/prefer-open-model/index.ts  | 38 +++++++
 .../nuxt-ui/prefer-semantic-colors/index.md   |  7 ++
 .../prefer-semantic-colors/index.test.ts      | 17 ++++
 .../nuxt-ui/prefer-semantic-colors/index.ts   | 38 +++++++
 .../rules/nuxt-ui/prefer-u-dialog/index.md    | 13 +++
 .../nuxt-ui/prefer-u-dialog/index.test.ts     | 14 +++
 .../rules/nuxt-ui/prefer-u-dialog/index.ts    |  8 ++
 .../src/rules/nuxt-ui/prefer-u-icon/index.md  |  8 ++
 .../rules/nuxt-ui/prefer-u-icon/index.test.ts | 14 +++
 .../src/rules/nuxt-ui/prefer-u-icon/index.ts  | 29 ++++++
 .../src/rules/nuxt-ui/prefer-u-kbd/index.md   |  9 ++
 .../rules/nuxt-ui/prefer-u-kbd/index.test.ts  | 14 +++
 .../src/rules/nuxt-ui/prefer-u-kbd/index.ts   |  8 ++
 .../rules/nuxt-ui/prefer-u-progress/index.md  |  9 ++
 .../nuxt-ui/prefer-u-progress/index.test.ts   | 14 +++
 .../rules/nuxt-ui/prefer-u-progress/index.ts  |  8 ++
 .../rules/nuxt-ui/prefer-u-separator/index.md | 10 ++
 .../nuxt-ui/prefer-u-separator/index.test.ts  | 14 +++
 .../rules/nuxt-ui/prefer-u-separator/index.ts |  8 ++
 .../rules/nuxt-ui/require-avatar-alt/index.md |  9 ++
 .../nuxt-ui/require-avatar-alt/index.test.ts  | 17 ++++
 .../rules/nuxt-ui/require-avatar-alt/index.ts | 27 +++++
 .../require-form-control-label/index.md       | 20 ++++
 .../require-form-control-label/index.test.ts  | 22 +++++
 .../require-form-control-label/index.ts       | 62 ++++++++++++
 .../nuxt-ui/require-form-field-name/index.md  | 13 +++
 .../require-form-field-name/index.test.ts     | 17 ++++
 .../nuxt-ui/require-form-field-name/index.ts  | 29 ++++++
 .../rules/nuxt-ui/require-form-state/index.md | 15 +++
 .../nuxt-ui/require-form-state/index.test.ts  | 17 ++++
 .../rules/nuxt-ui/require-form-state/index.ts | 26 +++++
 .../require-icon-button-label/index.md        |  8 ++
 .../require-icon-button-label/index.test.ts   | 17 ++++
 .../require-icon-button-label/index.ts        | 30 ++++++
 .../nuxt-ui/require-overlay-title/index.md    |  9 ++
 .../require-overlay-title/index.test.ts       | 18 ++++
 .../nuxt-ui/require-overlay-title/index.ts    | 32 ++++++
 .../nuxt-ui/require-popover-content/index.md  | 13 +++
 .../require-popover-content/index.test.ts     | 14 +++
 .../nuxt-ui/require-popover-content/index.ts  | 25 +++++
 .../nuxt-ui/require-tooltip-content/index.md  |  8 ++
 .../require-tooltip-content/index.test.ts     | 17 ++++
 .../nuxt-ui/require-tooltip-content/index.ts  | 25 +++++
 .../src/rules/nuxt-ui/require-u-app/index.md  | 15 +++
 .../rules/nuxt-ui/require-u-app/index.test.ts | 17 ++++
 .../src/rules/nuxt-ui/require-u-app/index.ts  | 43 ++++++++
 .../src/rules/nuxt-ui/utils.ts                | 84 ++++++++++++++++
 72 files changed, 1652 insertions(+), 6 deletions(-)
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/NUXT_UI_RESEARCH.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts

diff --git a/packages/lint-plugin-nuxt-ecosystem/NUXT_UI_RESEARCH.md b/packages/lint-plugin-nuxt-ecosystem/NUXT_UI_RESEARCH.md
new file mode 100644
index 0000000..1163799
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/NUXT_UI_RESEARCH.md
@@ -0,0 +1,70 @@
+# Nuxt UI lint research
+
+Research date: 2026-07-21. The implementation was checked against the live Nuxt UI v4.6.1
+documentation at `ui.nuxt.com`, including the complete component index, component API
+tables, composable entry points, theming guidance, accessibility guidance, and the v3-to-v4
+migration guide.
+
+## Sources and enforceable conventions
+
+| Area | Documented convention | Lint implementation |
+|---|---|---|
+| Design system | Prefer semantic colors (`text-muted`, `bg-elevated`, `border-default`, semantic status aliases) so themes and dark mode remain portable. | `prefer-semantic-colors` |
+| Application provider | `UApp` wraps the application and provides config, direction, toast, tooltip, and overlay providers. | `require-u-app` |
+| Component props | `color`, `variant`, and `size` are documented finite unions. | `no-invalid-prop-values` (static values only, extensible for custom variants) |
+| Form control labels | Inputs and choice controls expose labels/legends or are intended to be associated through `UFormField`. | `require-form-control-label` |
+| Icons | Iconify names are passed through `UIcon` or component icon props. | `prefer-u-icon`; existing component-preference rules |
+| Icon names | Docs use the `i-<collection>-<icon>` naming convention, while Vue component bindings remain supported. | `no-invalid-icon-name` |
+| Buttons | Icon-only buttons are supported, but still need an accessible name. | `require-icon-button-label` |
+| Links | `ULink` wraps `NuxtLink`; link-capable components document `to`. | `prefer-link-to` |
+| Avatars | `alt` is forwarded to the image and also supplies fallback initials. | `require-avatar-alt` |
+| Forms | A root `UForm` receives reactive `state`; nested forms explicitly inherit parent state. | `require-form-state` with a `nested` exception |
+| Form errors | `UForm` routes errors to `UFormField` through `name` or `error-pattern`. | `require-form-field-name`, scoped to fields inside `UForm` |
+| Overlay state | Modal, drawer, slideover, popover, and tooltip expose the named `open` model. | `prefer-open-model` |
+| Controlled state | `default-open`/`default-value` are initializers for uncontrolled components and should not be mixed with controlled state. | `no-conflicting-state-props` |
+| Dialog accessibility | Modal-like overlays expose title props/slots backed by Reka UI dialog semantics. | `require-overlay-title` with prop, slot, and ARIA alternatives |
+| Tooltip content | `UTooltip` documents `text` and `#content` as its content sources. | `require-tooltip-content` |
+| Popover content | `UPopover`'s `content` prop configures positioning; visible content belongs in `#content`. | `require-popover-content` |
+| Cross-prop constraints | `UFileUpload` restricts button/area, layout and position combinations; `UAccordion collapsible` applies to single mode. | `no-invalid-prop-combinations` |
+| v4 migration | Three component changes and the `nullify` to `nullable` model-modifier rename. | Existing deprecation rules; object-form `model-modifiers` coverage added |
+
+## False-positive policy
+
+- Dynamic bindings are accepted where static correctness cannot be proven.
+- `data-raw` remains the local escape hatch for deliberately native/component-level
+  markup and hard-coded brand styling.
+- Rules that need application-wide knowledge (for example, verifying the single root
+  `UApp` provider) are not implemented as per-file template rules.
+- `loading-auto`, `UForm` submit handlers, and structural replacements such as arbitrary
+  `div` to `UCard` are not required: the documentation supports valid cases without them,
+  so enforcing them would be guesswork.
+- `require-u-app` intentionally scopes itself to the Nuxt `app.vue` root and ignores
+  component/page/layout files named `App.vue`.
+- Nested `UForm` and standalone `UFormField` patterns are explicitly preserved because
+  both are documented use cases.
+- Form controls with dynamic labels are accepted; the label rule only reports when no
+  direct ARIA/label API or `UFormField` association is visible in the template.
+
+## Third-stage coverage audit
+
+The complete component index was audited by category. The table records both what is
+enforced and why additional rules were not invented for the remaining documentation.
+
+| Documentation category | Audited surface | Decision |
+|---|---|---|
+| Layout | `App`, `Container`, `Error`, `Footer`, `Header`, `Main`, `Sidebar`, `Theme` | `require-u-app` covers the provider boundary; the remaining components are structural wrappers whose correct nesting depends on the application layout. |
+| Element | `Alert`, `Avatar`, `AvatarGroup`, `Badge`, `Banner`, `Button`, `Calendar`, `Card`, `Chip`, `Collapsible`, `FieldGroup`, `Icon`, `Kbd`, `Progress`, `Separator`, `Skeleton` | Covered by semantic colors, icon-name validation, accessible labels, avatar alt text, finite prop validation, and native-component preferences where the API is unambiguous. |
+| Form | `Checkbox`, `CheckboxGroup`, `ColorPicker`, `FileUpload`, `Form`, `FormField`, `Input`, `InputDate`, `InputMenu`, `InputNumber`, `InputRating`, `InputTags`, `InputTime`, `Listbox`, `PinInput`, `RadioGroup`, `Select`, `SelectMenu`, `Slider`, `Switch`, `Textarea` | Covered by form state/name/label rules, controlled-state conflicts, static API unions, and file-upload relationship checks. Item schemas and runtime validation remain dynamic. |
+| Data | `Accordion`, `Carousel`, `Empty`, `Marquee`, `ScrollArea`, `Table`, `Timeline`, `Tree`, `User` | Accordion's documented `type`/`collapsible` relationship is enforced. The rest are driven by runtime data, slots, or render functions; a per-file rule would guess at valid use cases. |
+| Navigation | `Breadcrumb`, `CommandPalette`, `FooterColumns`, `Link`, `NavigationMenu`, `Pagination`, `Stepper`, `Tabs` | Link and button navigation semantics are covered. Menu, tab, step, and command item labels usually come from typed arrays or slots and cannot be validated from the template safely. |
+| Overlay | `ContextMenu`, `Drawer`, `DropdownMenu`, `Modal`, `Popover`, `Slideover`, `Toast`, `Tooltip` | Open-state naming, overlay titles, tooltip/popover content, and provider setup are covered. Menu item contents and programmatic toast payloads require script/runtime analysis. |
+| Page | `AuthForm`, `BlogPost`, `BlogPosts`, `ChangelogVersion`, `ChangelogVersions`, `Page`, `PageAnchors`, `PageAside`, `PageBody`, `PageCard`, `PageColumns`, `PageCTA`, `PageFeature`, `PageGrid`, `PageHeader`, `PageHero`, `PageLinks`, `PageList`, `PageLogos`, `PageSection`, `PricingPlan`, `PricingPlans`, `PricingTable` | These are composition primitives; enforcing a particular page hierarchy or content shape would be opinionated rather than a documented invariant. |
+| Dashboard | `DashboardGroup`, `DashboardNavbar`, `DashboardPanel`, `DashboardResizeHandle`, `DashboardSearch`, `DashboardSearchButton`, `DashboardSidebar`, `DashboardSidebarCollapse`, `DashboardSidebarToggle`, `DashboardToolbar` | State persistence, panel sizing, and responsive composition are runtime concerns. No additional template-only rule met the false-positive bar. |
+| AI Chat | `ChatMessage`, `ChatMessages`, `ChatPalette`, `ChatPrompt`, `ChatPromptSubmit`, `ChatReasoning`, `ChatShimmer`, `ChatTool` | APIs depend on Vercel AI SDK message/tool state and asynchronous status; static templates cannot establish correctness. |
+| Editor | `Editor`, `EditorDragHandle`, `EditorEmojiMenu`, `EditorMentionMenu`, `EditorSuggestionMenu`, `EditorToolbar` | TipTap extensions, editor content, and menu lifecycle are configured in script; no safe template-only invariant remains. |
+| Content | `ContentNavigation`, `ContentSearch`, `ContentSearchButton`, `ContentSurround`, `ContentToc` | Content routes and generated navigation are resolved by Nuxt Content at runtime/build time. |
+| Color mode / i18n | `ColorModeAvatar`, `ColorModeButton`, `ColorModeImage`, `ColorModeSelect`, `ColorModeSwitch`, `LocaleSelect` | Integration correctness depends on installed modules and runtime locale/color-mode configuration; component APIs themselves expose no deterministic missing prop. |
+
+This audit deliberately favors a smaller set of high-signal rules over rules that merely
+encode a preferred page architecture or require static knowledge of user-defined item
+arrays.
diff --git a/packages/lint-plugin-nuxt-ecosystem/README.md b/packages/lint-plugin-nuxt-ecosystem/README.md
index 813b89a..b8a8bd1 100644
--- a/packages/lint-plugin-nuxt-ecosystem/README.md
+++ b/packages/lint-plugin-nuxt-ecosystem/README.md
@@ -6,6 +6,8 @@
 ESLint and [Oxlint](https://oxc.rs) rules for the [Nuxt module ecosystem](https://nuxt.com/modules). The plugin currently supports `@nuxt/ui` with plans to expand.
 
 Every rule is based on the respective module's official documentation and recommendations.
+The Nuxt UI source review, enforceable conventions, and false-positive policy are recorded
+in [`NUXT_UI_RESEARCH.md`](./NUXT_UI_RESEARCH.md).
 
 If you are a developer of a popular module and want to add rules for it, please reach out.
 
@@ -45,12 +47,33 @@ These rules are compatible with Oxlint, although some may not work perfectly due
 
 | Rule | Description |
 |---|---|
+| [`@nustack/nuxt-ui/no-conflicting-state-props`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md) | Disallow controlled state together with `default-open` or `default-value`. |
 | [`@nustack/nuxt-ui/prefer-u-button`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md) | Prefer `<UButton>` over raw `<button>` when `@nuxt/ui` is available. |
+| [`@nustack/nuxt-ui/no-invalid-icon-name`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.md) | Validate static Iconify-style icon names. |
+| [`@nustack/nuxt-ui/no-invalid-prop-combinations`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md) | Disallow documented incompatible prop combinations such as `UFileUpload variant="button" multiple`. |
+| [`@nustack/nuxt-ui/prefer-u-dialog`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.md) | Prefer `<UModal>` over raw `<dialog>`. |
 | [`@nustack/nuxt-ui/prefer-u-form-controls`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md) | Prefer Nuxt UI form controls over raw native form elements; type-aware (e.g. `<input type="number">` / `<UInput type="number">` → `<UInputNumber>`). |
 | [`@nustack/nuxt-ui/prefer-u-link`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md) | Prefer `<ULink>` over raw `<a>` when `@nuxt/ui` is available. |
+| [`@nustack/nuxt-ui/prefer-u-kbd`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md) | Prefer `<UKbd>` over raw `<kbd>`. |
+| [`@nustack/nuxt-ui/prefer-u-progress`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md) | Prefer `<UProgress>` over raw `<progress>`. |
+| [`@nustack/nuxt-ui/prefer-u-separator`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md) | Prefer `<USeparator>` over raw `<hr>`. |
 | [`@nustack/nuxt-ui/prefer-u-table`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md) | Prefer `<UTable>` over raw `<table>` when `@nuxt/ui` is available. |
 | [`@nustack/nuxt-ui/no-deprecated-components`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md) | Disallow Nuxt UI components renamed in v4 (e.g. `UButtonGroup` → `UFieldGroup`). |
 | [`@nustack/nuxt-ui/no-deprecated-model-modifiers`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md) | Disallow the `v-model.nullify` modifier renamed to `.nullable` in Nuxt UI v4. |
+| [`@nustack/nuxt-ui/no-invalid-prop-values`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.md) | Catch invalid static `color`, `variant`, and `size` values on common components. |
+| [`@nustack/nuxt-ui/prefer-link-to`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md) | Prefer `to` over `href` on `ULink` and link-capable `UButton`. |
+| [`@nustack/nuxt-ui/prefer-open-model`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.md) | Prefer explicit `v-model:open` for Nuxt UI overlays. |
+| [`@nustack/nuxt-ui/prefer-semantic-colors`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md) | Prefer theme-aware semantic color tokens over hard-coded palette classes. |
+| [`@nustack/nuxt-ui/prefer-u-icon`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md) | Prefer `<UIcon name="...">` over raw Iconify class markup. |
+| [`@nustack/nuxt-ui/require-avatar-alt`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md) | Require alt text on image-backed avatars. |
+| [`@nustack/nuxt-ui/require-form-field-name`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md) | Require `name` or `error-pattern` on form fields inside `<UForm>`. |
+| [`@nustack/nuxt-ui/require-form-control-label`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md) | Require an accessible label for Nuxt UI form controls. |
+| [`@nustack/nuxt-ui/require-form-state`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.md) | Require the reactive `state` prop on `<UForm>`. |
+| [`@nustack/nuxt-ui/require-icon-button-label`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md) | Require an accessible label for icon-only buttons. |
+| [`@nustack/nuxt-ui/require-overlay-title`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md) | Require accessible titles on modal, drawer, and slideover. |
+| [`@nustack/nuxt-ui/require-popover-content`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md) | Require a `#content` slot on `<UPopover>`. |
+| [`@nustack/nuxt-ui/require-tooltip-content`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md) | Require tooltip text or a content slot. |
+| [`@nustack/nuxt-ui/require-u-app`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md) | Require `<UApp>` in the Nuxt `app.vue` root. |
 
 ## License
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/package.json b/packages/lint-plugin-nuxt-ecosystem/package.json
index ef27cba..744b9a8 100644
--- a/packages/lint-plugin-nuxt-ecosystem/package.json
+++ b/packages/lint-plugin-nuxt-ecosystem/package.json
@@ -33,6 +33,7 @@
   "files": [
     "LICENSE",
     "README.md",
+    "NUXT_UI_RESEARCH.md",
     "dist",
     "src/**/*.md"
   ],
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
index 822914b..8dfec3e 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
@@ -1,23 +1,65 @@
 import type { ESLint, Linter, Rule } from 'eslint'
 import { eslintCompatPlugin } from '@oxlint/plugins'
+import { noConflictingStateProps as noConflictingStatePropsRule } from './rules/nuxt-ui/no-conflicting-state-props/index.js'
 import { noDeprecatedComponents as noDeprecatedComponentsRule } from './rules/nuxt-ui/no-deprecated-components/index.js'
 import { noDeprecatedModelModifiers as noDeprecatedModelModifiersRule } from './rules/nuxt-ui/no-deprecated-model-modifiers/index.js'
+import { noInvalidIconName as noInvalidIconNameRule } from './rules/nuxt-ui/no-invalid-icon-name/index.js'
+import { noInvalidPropCombinations as noInvalidPropCombinationsRule } from './rules/nuxt-ui/no-invalid-prop-combinations/index.js'
+import { noInvalidPropValues as noInvalidPropValuesRule } from './rules/nuxt-ui/no-invalid-prop-values/index.js'
+import { preferLinkTo as preferLinkToRule } from './rules/nuxt-ui/prefer-link-to/index.js'
+import { preferOpenModel as preferOpenModelRule } from './rules/nuxt-ui/prefer-open-model/index.js'
+import { preferSemanticColors as preferSemanticColorsRule } from './rules/nuxt-ui/prefer-semantic-colors/index.js'
 import { preferUButton as preferUButtonRule } from './rules/nuxt-ui/prefer-u-button/index.js'
+import { preferUDialog as preferUDialogRule } from './rules/nuxt-ui/prefer-u-dialog/index.js'
 import { preferUFormControls as preferUFormControlsRule } from './rules/nuxt-ui/prefer-u-form-controls/index.js'
+import { preferUIcon as preferUIconRule } from './rules/nuxt-ui/prefer-u-icon/index.js'
+import { preferUKbd as preferUKbdRule } from './rules/nuxt-ui/prefer-u-kbd/index.js'
 import { preferULink as preferULinkRule } from './rules/nuxt-ui/prefer-u-link/index.js'
+import { preferUProgress as preferUProgressRule } from './rules/nuxt-ui/prefer-u-progress/index.js'
+import { preferUSeparator as preferUSeparatorRule } from './rules/nuxt-ui/prefer-u-separator/index.js'
 import { preferUTable as preferUTableRule } from './rules/nuxt-ui/prefer-u-table/index.js'
+import { requireAvatarAlt as requireAvatarAltRule } from './rules/nuxt-ui/require-avatar-alt/index.js'
+import { requireFormControlLabel as requireFormControlLabelRule } from './rules/nuxt-ui/require-form-control-label/index.js'
+import { requireFormFieldName as requireFormFieldNameRule } from './rules/nuxt-ui/require-form-field-name/index.js'
+import { requireFormState as requireFormStateRule } from './rules/nuxt-ui/require-form-state/index.js'
+import { requireIconButtonLabel as requireIconButtonLabelRule } from './rules/nuxt-ui/require-icon-button-label/index.js'
+import { requireOverlayTitle as requireOverlayTitleRule } from './rules/nuxt-ui/require-overlay-title/index.js'
+import { requirePopoverContent as requirePopoverContentRule } from './rules/nuxt-ui/require-popover-content/index.js'
+import { requireTooltipContent as requireTooltipContentRule } from './rules/nuxt-ui/require-tooltip-content/index.js'
+import { requireUApp as requireUAppRule } from './rules/nuxt-ui/require-u-app/index.js'
 
 const plugin = eslintCompatPlugin({
   meta: {
     name: '@nustack/nuxt-ui',
   },
   rules: {
+    'no-conflicting-state-props': noConflictingStatePropsRule,
+    'no-deprecated-components': noDeprecatedComponentsRule,
+    'no-deprecated-model-modifiers': noDeprecatedModelModifiersRule,
+    'no-invalid-icon-name': noInvalidIconNameRule,
+    'no-invalid-prop-combinations': noInvalidPropCombinationsRule,
+    'no-invalid-prop-values': noInvalidPropValuesRule,
+    'prefer-link-to': preferLinkToRule,
+    'prefer-open-model': preferOpenModelRule,
+    'prefer-semantic-colors': preferSemanticColorsRule,
     'prefer-u-button': preferUButtonRule,
+    'prefer-u-dialog': preferUDialogRule,
     'prefer-u-form-controls': preferUFormControlsRule,
+    'prefer-u-icon': preferUIconRule,
+    'prefer-u-kbd': preferUKbdRule,
     'prefer-u-link': preferULinkRule,
+    'prefer-u-progress': preferUProgressRule,
+    'prefer-u-separator': preferUSeparatorRule,
     'prefer-u-table': preferUTableRule,
-    'no-deprecated-components': noDeprecatedComponentsRule,
-    'no-deprecated-model-modifiers': noDeprecatedModelModifiersRule,
+    'require-avatar-alt': requireAvatarAltRule,
+    'require-form-control-label': requireFormControlLabelRule,
+    'require-form-field-name': requireFormFieldNameRule,
+    'require-form-state': requireFormStateRule,
+    'require-icon-button-label': requireIconButtonLabelRule,
+    'require-overlay-title': requireOverlayTitleRule,
+    'require-popover-content': requirePopoverContentRule,
+    'require-tooltip-content': requireTooltipContentRule,
+    'require-u-app': requireUAppRule,
   },
 }) as unknown as ESLint.Plugin & {
   configs: {
@@ -50,12 +92,33 @@ export function nuxtUiConfigs(options: NuxtUiConfigsOptions = {}): Linter.Config
       files: NUXT_UI_GLOB,
       plugins: pluginRef,
       rules: {
+        '@nustack/nuxt-ui/no-conflicting-state-props': 'warn',
+        '@nustack/nuxt-ui/no-deprecated-components': 'warn',
+        '@nustack/nuxt-ui/no-deprecated-model-modifiers': 'warn',
+        '@nustack/nuxt-ui/no-invalid-icon-name': 'warn',
+        '@nustack/nuxt-ui/no-invalid-prop-combinations': 'warn',
+        '@nustack/nuxt-ui/no-invalid-prop-values': 'warn',
+        '@nustack/nuxt-ui/prefer-link-to': 'warn',
+        '@nustack/nuxt-ui/prefer-open-model': 'warn',
+        '@nustack/nuxt-ui/prefer-semantic-colors': 'warn',
         '@nustack/nuxt-ui/prefer-u-button': 'warn',
+        '@nustack/nuxt-ui/prefer-u-dialog': 'warn',
         '@nustack/nuxt-ui/prefer-u-form-controls': 'warn',
+        '@nustack/nuxt-ui/prefer-u-icon': 'warn',
+        '@nustack/nuxt-ui/prefer-u-kbd': 'warn',
         '@nustack/nuxt-ui/prefer-u-link': 'warn',
+        '@nustack/nuxt-ui/prefer-u-progress': 'warn',
+        '@nustack/nuxt-ui/prefer-u-separator': 'warn',
         '@nustack/nuxt-ui/prefer-u-table': 'warn',
-        '@nustack/nuxt-ui/no-deprecated-components': 'warn',
-        '@nustack/nuxt-ui/no-deprecated-model-modifiers': 'warn',
+        '@nustack/nuxt-ui/require-avatar-alt': 'warn',
+        '@nustack/nuxt-ui/require-form-control-label': 'warn',
+        '@nustack/nuxt-ui/require-form-field-name': 'warn',
+        '@nustack/nuxt-ui/require-form-state': 'warn',
+        '@nustack/nuxt-ui/require-icon-button-label': 'warn',
+        '@nustack/nuxt-ui/require-overlay-title': 'warn',
+        '@nustack/nuxt-ui/require-popover-content': 'warn',
+        '@nustack/nuxt-ui/require-tooltip-content': 'warn',
+        '@nustack/nuxt-ui/require-u-app': 'warn',
       },
     })
   }
@@ -84,4 +147,25 @@ export const preferULink: Rule.RuleModule = plugin.rules!['prefer-u-link'] as Ru
 export const preferUTable: Rule.RuleModule = plugin.rules!['prefer-u-table'] as Rule.RuleModule
 export const noDeprecatedComponents: Rule.RuleModule = plugin.rules!['no-deprecated-components'] as Rule.RuleModule
 export const noDeprecatedModelModifiers: Rule.RuleModule = plugin.rules!['no-deprecated-model-modifiers'] as Rule.RuleModule
+export const noConflictingStateProps: Rule.RuleModule = plugin.rules!['no-conflicting-state-props'] as Rule.RuleModule
+export const noInvalidIconName: Rule.RuleModule = plugin.rules!['no-invalid-icon-name'] as Rule.RuleModule
+export const noInvalidPropCombinations: Rule.RuleModule = plugin.rules!['no-invalid-prop-combinations'] as Rule.RuleModule
+export const noInvalidPropValues: Rule.RuleModule = plugin.rules!['no-invalid-prop-values'] as Rule.RuleModule
+export const preferLinkTo: Rule.RuleModule = plugin.rules!['prefer-link-to'] as Rule.RuleModule
+export const preferOpenModel: Rule.RuleModule = plugin.rules!['prefer-open-model'] as Rule.RuleModule
+export const preferSemanticColors: Rule.RuleModule = plugin.rules!['prefer-semantic-colors'] as Rule.RuleModule
+export const preferUIcon: Rule.RuleModule = plugin.rules!['prefer-u-icon'] as Rule.RuleModule
+export const preferUDialog: Rule.RuleModule = plugin.rules!['prefer-u-dialog'] as Rule.RuleModule
+export const preferUKbd: Rule.RuleModule = plugin.rules!['prefer-u-kbd'] as Rule.RuleModule
+export const preferUProgress: Rule.RuleModule = plugin.rules!['prefer-u-progress'] as Rule.RuleModule
+export const preferUSeparator: Rule.RuleModule = plugin.rules!['prefer-u-separator'] as Rule.RuleModule
+export const requirePopoverContent: Rule.RuleModule = plugin.rules!['require-popover-content'] as Rule.RuleModule
+export const requireFormControlLabel: Rule.RuleModule = plugin.rules!['require-form-control-label'] as Rule.RuleModule
+export const requireUApp: Rule.RuleModule = plugin.rules!['require-u-app'] as Rule.RuleModule
+export const requireAvatarAlt: Rule.RuleModule = plugin.rules!['require-avatar-alt'] as Rule.RuleModule
+export const requireFormFieldName: Rule.RuleModule = plugin.rules!['require-form-field-name'] as Rule.RuleModule
+export const requireFormState: Rule.RuleModule = plugin.rules!['require-form-state'] as Rule.RuleModule
+export const requireIconButtonLabel: Rule.RuleModule = plugin.rules!['require-icon-button-label'] as Rule.RuleModule
+export const requireOverlayTitle: Rule.RuleModule = plugin.rules!['require-overlay-title'] as Rule.RuleModule
+export const requireTooltipContent: Rule.RuleModule = plugin.rules!['require-tooltip-content'] as Rule.RuleModule
 export default plugin
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
new file mode 100644
index 0000000..15e5806
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
@@ -0,0 +1,16 @@
+# `@nustack/nuxt-ui/no-conflicting-state-props`
+
+Do not combine controlled state (`open`, `v-model:open`, `model-value`, or `v-model`) with
+the corresponding uncontrolled initializer (`default-open` or `default-value`). Nuxt UI's
+APIs document `default-*` for cases where the caller does not control state.
+
+```vue
+<!-- Incorrect -->
+<UModal v-model:open="open" default-open />
+
+<!-- Correct: controlled -->
+<UModal v-model:open="open" />
+
+<!-- Correct: uncontrolled -->
+<UModal default-open />
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.test.ts
new file mode 100644
index 0000000..340a8cb
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.test.ts
@@ -0,0 +1,20 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('no-conflicting-state-props', () => {
+  it('separates controlled and uncontrolled state', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('no-conflicting-state-props', plugin.rules?.['no-conflicting-state-props'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UModal v-model:open="open" /></template>' },
+        { filename: 'component.vue', code: '<template><UInput default-value="Draft" /></template>' },
+      ],
+      invalid: [
+        { filename: 'component.vue', code: '<template><UModal v-model:open="open" default-open /></template>', errors: [{ messageId: 'conflicting' }] },
+        { filename: 'component.vue', code: '<template><UInput v-model="value" default-value="Draft" /></template>', errors: [{ messageId: 'conflicting' }] },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts
new file mode 100644
index 0000000..e63aa19
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts
@@ -0,0 +1,41 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { componentName, defineTemplateVisitor, hasAttribute, hasVModel } from '../utils.js'
+
+export const noConflictingStateProps: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Disallow mixing controlled Nuxt UI state with its uncontrolled default prop.',
+      url: docsUrl('nuxt-ui/no-conflicting-state-props'),
+    },
+    schema: [],
+    messages: {
+      conflicting: '`<{{ component }}>` cannot use controlled `{{ controlled }}` together with `{{ uncontrolled }}`; choose one state model.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (!node.name.startsWith('u'))
+          return
+
+        if (hasAttribute(node, 'default-open') && (hasAttribute(node, 'open') || hasVModel(node, 'open'))) {
+          context.report({
+            loc: node.startTag.loc,
+            messageId: 'conflicting',
+            data: { component: componentName(node.name), controlled: 'open / v-model:open', uncontrolled: 'default-open' },
+          })
+        }
+
+        if (hasAttribute(node, 'default-value') && (hasAttribute(node, 'model-value') || hasVModel(node, null))) {
+          context.report({
+            loc: node.startTag.loc,
+            messageId: 'conflicting',
+            data: { component: componentName(node.name), controlled: 'model-value / v-model', uncontrolled: 'default-value' },
+          })
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts
index 49c4249..544e748 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts
@@ -8,7 +8,7 @@ interface DeprecatedComponent {
   replacement: string
 }
 
-/** Verified 2026-06-30 against ui.nuxt.com (v4); re-verify on the next Nuxt UI major. */
+/** Verified 2026-07-21 against the ui.nuxt.com v4 migration guide; re-verify on the next major. */
 const DEPRECATED_COMPONENTS: Record<string, DeprecatedComponent> = {
   ubuttongroup: { name: 'UButtonGroup', replacement: 'UFieldGroup' },
   upagemarquee: { name: 'UPageMarquee', replacement: 'UMarquee' },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
index df00900..1323ab4 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
@@ -9,6 +9,7 @@ Nuxt UI v4 (both convert empty/blank values to `null`; v4 also adds `.optional`
 ```vue
 <template>
   <UInput v-model.nullify="value" />
+  <UTextarea v-model="value" :model-modifiers="{ nullify: true }" />
 </template>
 ```
 
@@ -17,6 +18,7 @@ Nuxt UI v4 (both convert empty/blank values to `null`; v4 also adds `.optional`
 ```vue
 <template>
   <UInput v-model.nullable="value" />
+  <UTextarea v-model="value" :model-modifiers="{ nullable: true }" />
 </template>
 ```
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts
index 0755465..ead921c 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts
@@ -19,6 +19,7 @@ describe('no-deprecated-model-modifiers', () => {
         { filename: 'component.vue', code: '<template><UInput v-model.nullify="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
         { filename: 'component.vue', code: '<template><UInputNumber v-model.nullify="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
         { filename: 'component.vue', code: '<template><UTextarea v-model.nullify="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
+        { filename: 'component.vue', code: '<template><UTextarea v-model="value" :model-modifiers="{ nullify: true }" /></template>', errors: [{ messageId: 'preferNullable' }] },
         // Extended via options: extra modifier rename and a custom target component.
         { filename: 'component.vue', code: '<template><UInput v-model.coerce="value" /></template>', options: [{ modifiers: { coerce: 'transform' } }], errors: [{ messageId: 'preferNullable' }] },
         { filename: 'component.vue', code: '<template><UCustom v-model.nullify="value" /></template>', options: [{ components: ['ucustom'] }], errors: [{ messageId: 'preferNullable' }] },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts
index 120bac9..10ef6b9 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts
@@ -2,7 +2,7 @@ import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
 import { defineTemplateVisitor } from '../utils.js'
 
-/** Verified 2026-06-30 against ui.nuxt.com (v4); re-verify on the next Nuxt UI major. */
+/** Verified 2026-07-21 against the ui.nuxt.com v4 migration guide; re-verify on the next major. */
 const DEPRECATED_MODIFIERS: Record<string, string> = {
   nullify: 'nullable',
 }
@@ -15,6 +15,18 @@ function vModel(node: any): any {
   ) ?? null
 }
 
+function modelModifiersObject(node: any): any | null {
+  const attribute = node.startTag.attributes.find((candidate: any) => {
+    if (!candidate.directive || candidate.key.name?.name !== 'bind')
+      return false
+    const argument = candidate.key.argument
+    return argument?.type === 'VIdentifier' && argument.name === 'model-modifiers'
+  })
+  return attribute?.value?.expression?.type === 'ObjectExpression'
+    ? attribute.value.expression
+    : null
+}
+
 export const noDeprecatedModelModifiers: Rule = {
   meta: {
     type: 'problem',
@@ -57,6 +69,20 @@ export const noDeprecatedModelModifiers: Rule = {
             })
           }
         }
+
+        for (const property of modelModifiersObject(node)?.properties ?? []) {
+          if (property.type !== 'Property' || property.computed)
+            continue
+          const name = property.key.name ?? property.key.value
+          const replacement = modifiers[name]
+          if (replacement) {
+            context.report({
+              loc: property.key.loc ?? property.loc,
+              messageId: 'preferNullable',
+              data: { old: name, replacement },
+            })
+          }
+        }
       },
     })
   },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.md
new file mode 100644
index 0000000..b43e57e
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.md
@@ -0,0 +1,12 @@
+# `@nustack/nuxt-ui/no-invalid-icon-name`
+
+Validate static icon props against Nuxt UI's documented `i-<collection>-<icon>` Iconify
+format. Dynamic bindings are accepted because Nuxt UI also supports Vue components.
+
+```vue
+<UIcon name="i-lucide-lightbulb" />
+<UButton icon="i-lucide-search" />
+<UIcon :name="IconLightbulb" />
+```
+
+Register project-specific names with `{ names: ['brand-logo'] }`, or use `data-raw` locally.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.test.ts
new file mode 100644
index 0000000..a392336
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.test.ts
@@ -0,0 +1,18 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('no-invalid-icon-name', () => {
+  it('checks static Iconify names', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('no-invalid-icon-name', plugin.rules?.['no-invalid-icon-name'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UIcon name="i-lucide-search" /></template>' },
+        { filename: 'component.vue', code: '<template><UIcon :name="IconSearch" /></template>' },
+        { filename: 'component.vue', code: '<template><UButton icon="brand-logo" /></template>', options: [{ names: ['brand-logo'] }] },
+      ],
+      invalid: [{ filename: 'component.vue', code: '<template><UButton icon="search" /></template>', errors: [{ messageId: 'invalidName' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.ts
new file mode 100644
index 0000000..6bbf5c6
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.ts
@@ -0,0 +1,54 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, hasRawOptOut } from '../utils.js'
+
+const ICON_NAME = /^i-[a-z\d]+-[a-z\d][a-z\d-]*$/i
+
+export const noInvalidIconName: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require valid Iconify-style names in static Nuxt UI icon props.',
+      url: docsUrl('nuxt-ui/no-invalid-icon-name'),
+    },
+    schema: [{
+      type: 'object',
+      properties: {
+        /** Extra exact static names accepted for project-specific icon providers. */
+        names: { type: 'array', items: { type: 'string' } },
+      },
+      additionalProperties: false,
+    }],
+    messages: {
+      invalidName: '`{{ name }}` is not a valid Nuxt UI Iconify name; use `i-<collection>-<icon>` or a dynamic Vue component binding.',
+    },
+  },
+  create(context: any) {
+    const names = new Set<string>(context.options[0]?.names ?? [])
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (!node.name.startsWith('u') || hasRawOptOut(node))
+          return
+
+        for (const attribute of node.startTag.attributes) {
+          if (attribute.directive || !attribute.value)
+            continue
+          const prop = attribute.key.name as string
+          if (prop !== 'name' && !prop.endsWith('icon'))
+            continue
+          // `name` is an icon name only on UIcon; other components use it for form fields.
+          if (prop === 'name' && node.name !== 'uicon')
+            continue
+          const name = attribute.value.value
+          if (!ICON_NAME.test(name) && !names.has(name)) {
+            context.report({
+              loc: attribute.loc ?? node.startTag.loc,
+              messageId: 'invalidName',
+              data: { name },
+            })
+          }
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
new file mode 100644
index 0000000..c0b250a
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
@@ -0,0 +1,13 @@
+# `@nustack/nuxt-ui/no-invalid-prop-combinations`
+
+Disallow static prop combinations that Nuxt UI documents as incompatible.
+
+Currently covered:
+
+- `UFileUpload variant="button"` cannot be combined with `multiple`.
+- `UFileUpload layout` requires `variant="area"`.
+- `UFileUpload position` requires `variant="area"` and `layout="list"`.
+- `UAccordion collapsible` is only meaningful for the default `type="single"`.
+
+Dynamic values are ignored when the relationship cannot be proven at lint time.
+Use `data-raw` for an intentional low-level exception.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.test.ts
new file mode 100644
index 0000000..a1ddfe1
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.test.ts
@@ -0,0 +1,25 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('no-invalid-prop-combinations', () => {
+  it('checks documented component constraints', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('no-invalid-prop-combinations', plugin.rules?.['no-invalid-prop-combinations'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UFileUpload variant="button" :multiple="false" /></template>' },
+        { filename: 'component.vue', code: '<template><UFileUpload variant="area" layout="list" position="inside" /></template>' },
+        { filename: 'component.vue', code: '<template><UFileUpload :variant="variant" :position="position" /></template>' },
+        { filename: 'component.vue', code: '<template><UAccordion type="multiple" /></template>' },
+        { filename: 'component.vue', code: '<template><UAccordion type="multiple" collapsible data-raw /></template>' },
+      ],
+      invalid: [
+        { filename: 'component.vue', code: '<template><UFileUpload variant="button" multiple /></template>', errors: [{ messageId: 'fileButtonMultiple' }] },
+        { filename: 'component.vue', code: '<template><UFileUpload variant="button" layout="list" /></template>', errors: [{ messageId: 'fileLayoutArea' }] },
+        { filename: 'component.vue', code: '<template><UFileUpload position="inside" /></template>', errors: [{ messageId: 'filePositionList' }] },
+        { filename: 'component.vue', code: '<template><UAccordion type="multiple" collapsible /></template>', errors: [{ messageId: 'accordionCollapsible' }] },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts
new file mode 100644
index 0000000..50944f5
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts
@@ -0,0 +1,91 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, getStaticAttribute, hasAttribute, hasRawOptOut } from '../utils.js'
+
+interface StaticValue {
+  present: boolean
+  dynamic: boolean
+  value: string | null
+}
+
+function staticValue(node: any, name: string): StaticValue {
+  const attribute = node.startTag.attributes.find((candidate: any) => {
+    if (!candidate.directive)
+      return candidate.key.name === name
+    if (candidate.key.name?.name !== 'bind')
+      return false
+    const argument = candidate.key.argument
+    return argument?.type === 'VIdentifier' && argument.name === name
+  })
+  if (!attribute)
+    return { present: false, dynamic: false, value: null }
+  if (attribute.directive)
+    return { present: true, dynamic: true, value: null }
+  return { present: true, dynamic: false, value: attribute.value?.value ?? null }
+}
+
+function staticBoolean(node: any, name: string): boolean | null {
+  const attribute = staticValue(node, name)
+  if (!attribute.present || attribute.dynamic)
+    return null
+  if (attribute.value === null || attribute.value === '')
+    return true
+  if (attribute.value === 'true')
+    return true
+  if (attribute.value === 'false')
+    return false
+  return null
+}
+
+export const noInvalidPropCombinations: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Disallow documented Nuxt UI prop combinations that cannot work together.',
+      url: docsUrl('nuxt-ui/no-invalid-prop-combinations'),
+    },
+    schema: [],
+    messages: {
+      fileButtonMultiple: '`UFileUpload variant="button"` only supports a single file; remove `multiple` or use `variant="area"`.',
+      fileLayoutArea: '`UFileUpload layout` is only supported with `variant="area"`.',
+      filePositionList: '`UFileUpload position` requires `variant="area"` with `layout="list"`.',
+      accordionCollapsible: '`UAccordion collapsible` is only meaningful with the default `type="single"`.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (hasRawOptOut(node))
+          return
+
+        if (node.name === 'ufileupload') {
+          const variant = staticValue(node, 'variant')
+          const multiple = staticBoolean(node, 'multiple')
+          const layout = staticValue(node, 'layout')
+          const position = staticValue(node, 'position')
+
+          if (!variant.dynamic && variant.value === 'button' && multiple === true) {
+            context.report({ loc: node.startTag.loc, messageId: 'fileButtonMultiple' })
+          }
+
+          if (!layout.dynamic && layout.present && !variant.dynamic && variant.value === 'button') {
+            context.report({ loc: node.startTag.loc, messageId: 'fileLayoutArea' })
+          }
+
+          if (position.present && !position.dynamic && !variant.dynamic && !layout.dynamic) {
+            const effectiveVariant = variant.present ? variant.value : 'area'
+            const effectiveLayout = layout.present ? layout.value : 'grid'
+            if (effectiveVariant !== 'area' || effectiveLayout !== 'list')
+              context.report({ loc: node.startTag.loc, messageId: 'filePositionList' })
+          }
+        }
+
+        if (node.name === 'uaccordion') {
+          const type = getStaticAttribute(node, 'type')
+          if (type === 'multiple' && hasAttribute(node, 'collapsible'))
+            context.report({ loc: node.startTag.loc, messageId: 'accordionCollapsible' })
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.md
new file mode 100644
index 0000000..0d971d4
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.md
@@ -0,0 +1,20 @@
+# `@nustack/nuxt-ui/no-invalid-prop-values`
+
+Catch statically invalid `color`, `variant`, and `size` values for commonly used Nuxt UI
+components. Dynamic bindings are ignored so custom runtime themes remain possible.
+
+```vue
+<!-- Incorrect: `colour` is not a Nuxt UI color -->
+<UButton color="colour" />
+
+<!-- Correct -->
+<UButton color="primary" variant="outline" size="md" />
+```
+
+Project-specific theme values can be registered without replacing the documented values:
+
+```js
+'@nustack/nuxt-ui/no-invalid-prop-values': ['warn', {
+  values: { UButton: { variant: ['brand'] } },
+}]
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.test.ts
new file mode 100644
index 0000000..c78c33d
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.test.ts
@@ -0,0 +1,24 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('no-invalid-prop-values', () => {
+  it('checks static component values', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('no-invalid-prop-values', plugin.rules?.['no-invalid-prop-values'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UButton color="primary" variant="outline" size="md" /></template>' },
+        { filename: 'component.vue', code: '<template><UCheckboxGroup variant="table" orientation="horizontal" /></template>' },
+        { filename: 'component.vue', code: '<template><UFileUpload variant="area" layout="list" position="inside" /></template>' },
+        { filename: 'component.vue', code: '<template><UPinInput variant="subtle" size="xl" /></template>' },
+        { filename: 'component.vue', code: '<template><UButton :color="color" /></template>' },
+        { filename: 'component.vue', code: '<template><UButton variant="brand" /></template>', options: [{ values: { UButton: { variant: ['brand'] } } }] },
+      ],
+      invalid: [
+        { filename: 'component.vue', code: '<template><UButton color="brand" /></template>', errors: [{ messageId: 'invalid' }] },
+        { filename: 'component.vue', code: '<template><USlider size="2xl" /></template>', errors: [{ messageId: 'invalid' }] },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.ts
new file mode 100644
index 0000000..7097a5d
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.ts
@@ -0,0 +1,98 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { componentName, defineTemplateVisitor } from '../utils.js'
+
+const COLORS = ['error', 'primary', 'secondary', 'success', 'info', 'warning', 'neutral']
+const SIZES = ['3xs', '2xs', 'xs', 'sm', 'md', 'lg', 'xl', '2xl', '3xl']
+
+/** Verified 2026-07-21 against the component API tables on ui.nuxt.com. */
+const VALUES: Record<string, Record<string, string[]>> = {
+  ubutton: { color: COLORS, variant: ['solid', 'outline', 'soft', 'subtle', 'ghost', 'link'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  ubadge: { color: COLORS, variant: ['solid', 'outline', 'soft', 'subtle'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  ualert: { color: COLORS, variant: ['solid', 'outline', 'soft', 'subtle'] },
+  ucard: { variant: ['solid', 'outline', 'soft', 'subtle'] },
+  ucheckbox: { color: COLORS, variant: ['list', 'card'], size: ['xs', 'sm', 'md', 'lg', 'xl'], indicator: ['start', 'end', 'hidden'] },
+  ucheckboxgroup: { color: COLORS, variant: ['list', 'card', 'table'], size: ['xs', 'sm', 'md', 'lg', 'xl'], orientation: ['horizontal', 'vertical'], indicator: ['start', 'end', 'hidden'] },
+  ufileupload: { color: COLORS, variant: ['button', 'area'], size: ['xs', 'sm', 'md', 'lg', 'xl'], layout: ['list', 'grid'], position: ['inside', 'outside'] },
+  uinput: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  uinputdate: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  uinputmenu: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  uinputnumber: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  uinputtags: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  uinputtime: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  utextarea: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  upininput: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  uradiogroup: { color: COLORS, variant: ['list', 'card', 'table'], size: ['xs', 'sm', 'md', 'lg', 'xl'], orientation: ['horizontal', 'vertical'], indicator: ['start', 'end', 'hidden'] },
+  uselect: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  uselectmenu: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  uslider: { color: COLORS, size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  uswitch: { color: COLORS, size: ['xs', 'sm', 'md', 'lg', 'xl'] },
+  uavatar: { size: SIZES },
+}
+
+export const noInvalidPropValues: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Disallow statically invalid Nuxt UI component color, variant, and size values.',
+      url: docsUrl('nuxt-ui/no-invalid-prop-values'),
+    },
+    schema: [{
+      type: 'object',
+      properties: {
+        /** Extra static values keyed by component and prop, merged onto the documented v4 values. */
+        values: {
+          type: 'object',
+          additionalProperties: {
+            type: 'object',
+            additionalProperties: { type: 'array', items: { type: 'string' } },
+          },
+        },
+      },
+      additionalProperties: false,
+    }],
+    messages: {
+      invalid: '`{{ value }}` is not a valid `{{ prop }}` for `<{{ component }}>`; use one of: {{ allowed }}.',
+    },
+  },
+  create(context: any) {
+    const values: Record<string, Record<string, string[]>> = {}
+    for (const [component, props] of Object.entries(VALUES))
+      values[component] = Object.fromEntries(Object.entries(props).map(([prop, allowed]) => [prop, [...allowed]]))
+
+    for (const [component, props] of Object.entries(context.options[0]?.values ?? {}) as [string, Record<string, string[]>][]) {
+      const key = component.toLowerCase()
+      const componentValues = values[key] ?? (values[key] = {})
+      for (const [prop, allowed] of Object.entries(props))
+        componentValues[prop] = [...(componentValues[prop] ?? []), ...allowed]
+    }
+
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        const props = values[node.name]
+        if (!props)
+          return
+        for (const attribute of node.startTag.attributes) {
+          if (attribute.directive || !attribute.value)
+            continue
+          const prop = attribute.key.name as string
+          const allowed = props[prop]
+          if (!allowed)
+            continue
+          if (!allowed.includes(attribute.value.value)) {
+            context.report({
+              loc: attribute.loc ?? node.startTag.loc,
+              messageId: 'invalid',
+              data: {
+                value: attribute.value.value,
+                prop,
+                component: componentName(node.name),
+                allowed: allowed.join(', '),
+              },
+            })
+          }
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md
new file mode 100644
index 0000000..16a90ab
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md
@@ -0,0 +1,11 @@
+# `@nustack/nuxt-ui/prefer-link-to`
+
+Use `to` on `ULink` and link-capable `UButton` components. It follows Nuxt UI's Link API
+and keeps routing-aware links consistent.
+
+```vue
+<UButton to="/settings">Settings</UButton>
+<ULink to="/docs">Docs</ULink>
+```
+
+Use `data-raw` when native `href` behavior is intentional.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.test.ts
new file mode 100644
index 0000000..463a236
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.test.ts
@@ -0,0 +1,14 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('prefer-link-to', () => {
+  it('prefers to on link-capable components', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('prefer-link-to', plugin.rules?.['prefer-link-to'] as never, {
+      valid: [{ filename: 'component.vue', code: '<template><ULink to="/docs">Docs</ULink></template>' }],
+      invalid: [{ filename: 'component.vue', code: '<template><UButton href="/docs">Docs</UButton></template>', errors: [{ messageId: 'preferTo' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts
new file mode 100644
index 0000000..2b93868
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts
@@ -0,0 +1,27 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { componentName, defineTemplateVisitor, hasAttribute, hasRawOptOut } from '../utils.js'
+
+const LINK_COMPONENTS = new Set(['ulink', 'ubutton'])
+
+export const preferLinkTo: Rule = {
+  meta: {
+    type: 'suggestion',
+    docs: {
+      description: 'Prefer Nuxt UI/NuxtLink `to` on link-capable components over `href`.',
+      url: docsUrl('nuxt-ui/prefer-link-to'),
+    },
+    schema: [],
+    messages: {
+      preferTo: 'Use `to` instead of `href` on `<{{ component }}>` so Nuxt routing and link props stay consistent.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (LINK_COMPONENTS.has(node.name) && !hasRawOptOut(node) && hasAttribute(node, 'href') && !hasAttribute(node, 'to'))
+          context.report({ loc: node.startTag.loc, messageId: 'preferTo', data: { component: componentName(node.name) } })
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.md
new file mode 100644
index 0000000..b649e3e
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.md
@@ -0,0 +1,12 @@
+# `@nustack/nuxt-ui/prefer-open-model`
+
+Use the explicit `open` model on `UModal`, `UDrawer`, `USlideover`, `UPopover`, and
+`UTooltip`. Nuxt UI documents these components with `v-model:open`.
+
+```vue
+<!-- Incorrect -->
+<UModal v-model="open" />
+
+<!-- Correct -->
+<UModal v-model:open="open" />
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.test.ts
new file mode 100644
index 0000000..713138e
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.test.ts
@@ -0,0 +1,14 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('prefer-open-model', () => {
+  it('requires named open model', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('prefer-open-model', plugin.rules?.['prefer-open-model'] as never, {
+      valid: [{ filename: 'component.vue', code: '<template><UModal v-model:open="open" /></template>' }],
+      invalid: [{ filename: 'component.vue', code: '<template><UModal v-model="open" /></template>', errors: [{ messageId: 'preferOpen' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.ts
new file mode 100644
index 0000000..3e5995a
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.ts
@@ -0,0 +1,38 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { componentName, defineTemplateVisitor } from '../utils.js'
+
+const OPEN_COMPONENTS = new Set(['umodal', 'udrawer', 'uslideover', 'upopover', 'utooltip'])
+
+export const preferOpenModel: Rule = {
+  meta: {
+    type: 'suggestion',
+    docs: {
+      description: 'Use the explicit `open` model for Nuxt UI overlays instead of the ambiguous default model.',
+      url: docsUrl('nuxt-ui/prefer-open-model'),
+    },
+    schema: [],
+    messages: {
+      preferOpen: 'Use `v-model:open` for `<{{ component }}>`; Nuxt UI overlay state is named `open`.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (!OPEN_COMPONENTS.has(node.name))
+          return
+        for (const attribute of node.startTag.attributes) {
+          if (attribute.directive
+            && attribute.key.name?.name === 'model'
+            && !attribute.key.argument) {
+            context.report({
+              loc: attribute.loc ?? node.startTag.loc,
+              messageId: 'preferOpen',
+              data: { component: componentName(node.name) },
+            })
+          }
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md
new file mode 100644
index 0000000..aafaa21
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md
@@ -0,0 +1,7 @@
+# `@nustack/nuxt-ui/prefer-semantic-colors`
+
+Prefer Nuxt UI's semantic tokens (`text-muted`, `bg-elevated`, `border-default`,
+`text-success`, and similar) over hard-coded Tailwind palette classes. Semantic tokens
+adapt to the configured theme and dark mode.
+
+Use `data-raw` for a deliberate brand or illustration color.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.test.ts
new file mode 100644
index 0000000..68c8fe4
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.test.ts
@@ -0,0 +1,17 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('prefer-semantic-colors', () => {
+  it('prefers semantic tokens', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('prefer-semantic-colors', plugin.rules?.['prefer-semantic-colors'] as never, {
+      valid: [{ filename: 'component.vue', code: '<template><div class="text-muted bg-elevated" /></template>' }],
+      invalid: [
+        { filename: 'component.vue', code: '<template><div class="text-gray-500" /></template>', errors: [{ messageId: 'semantic' }] },
+        { filename: 'component.vue', code: '<template><div class="dark:ring-zinc-800/50" /></template>', errors: [{ messageId: 'semantic' }] },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.ts
new file mode 100644
index 0000000..9cb3d26
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.ts
@@ -0,0 +1,38 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, getStaticAttribute, hasRawOptOut } from '../utils.js'
+
+const PALETTE = '(?:slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose|black|white)'
+const PALETTE_CLASS = new RegExp(`^(?:text|bg|border|ring|divide|outline|decoration|placeholder)-${PALETTE}(?:-\\d+)?(?:/\\d+)?$`)
+
+export const preferSemanticColors: Rule = {
+  meta: {
+    type: 'suggestion',
+    docs: {
+      description: 'Prefer Nuxt UI semantic color utilities over hard-coded Tailwind palette classes.',
+      url: docsUrl('nuxt-ui/prefer-semantic-colors'),
+    },
+    schema: [],
+    messages: {
+      semantic: 'Prefer a Nuxt UI semantic color token (for example `text-muted`, `bg-elevated`, or `border-default`) over `{{ className }}`.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (hasRawOptOut(node))
+          return
+        const classes = getStaticAttribute(node, 'class')
+        if (!classes)
+          return
+        for (const className of classes.split(/\s+/)) {
+          const utility = className.slice(className.lastIndexOf(':') + 1).replace(/^!/, '')
+          if (PALETTE_CLASS.test(utility)) {
+            context.report({ loc: node.startTag.loc, messageId: 'semantic', data: { className } })
+            break
+          }
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.md
new file mode 100644
index 0000000..92be15b
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.md
@@ -0,0 +1,13 @@
+# `@nustack/nuxt-ui/prefer-u-dialog`
+
+Prefer `UModal` over a raw `dialog` element. `UModal` supplies Nuxt UI styling and Reka UI
+dialog behavior, including focus management and screen-reader semantics.
+
+```vue
+<UModal title="Confirm deletion">
+  <template #body>Are you sure?</template>
+</UModal>
+```
+
+The migration is structural rather than a direct tag rename. Use `data-raw` for deliberately
+hand-written native dialogs.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.test.ts
new file mode 100644
index 0000000..4404386
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.test.ts
@@ -0,0 +1,14 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('prefer-u-dialog', () => {
+  it('prefers UModal', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('prefer-u-dialog', plugin.rules?.['prefer-u-dialog'] as never, {
+      valid: [{ filename: 'component.vue', code: '<template><UModal title="Confirm" /></template>' }],
+      invalid: [{ filename: 'component.vue', code: '<template><dialog>Confirm</dialog></template>', errors: [{ messageId: 'preferUDialog' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.ts
new file mode 100644
index 0000000..a7e28a2
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.ts
@@ -0,0 +1,8 @@
+import { preferUComponent } from '../prefer-u-component.js'
+
+export const preferUDialog = preferUComponent({
+  nativeTag: 'dialog',
+  component: 'UModal',
+  ruleName: 'prefer-u-dialog',
+  messageId: 'preferUDialog',
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
new file mode 100644
index 0000000..6185349
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
@@ -0,0 +1,8 @@
+# `@nustack/nuxt-ui/prefer-u-icon`
+
+Prefer Nuxt UI's `UIcon` component and its `name` prop over raw Iconify utility classes.
+Use `data-raw` for a deliberate low-level icon implementation.
+
+```vue
+<UIcon name="i-lucide-search" />
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.test.ts
new file mode 100644
index 0000000..249f347
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.test.ts
@@ -0,0 +1,14 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('prefer-u-icon', () => {
+  it('prefers UIcon for Iconify classes', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('prefer-u-icon', plugin.rules?.['prefer-u-icon'] as never, {
+      valid: [{ filename: 'component.vue', code: '<template><UIcon name="i-lucide-search" /></template>' }],
+      invalid: [{ filename: 'component.vue', code: '<template><i class="i-lucide-search" /></template>', errors: [{ messageId: 'preferIcon' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.ts
new file mode 100644
index 0000000..63ddad1
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.ts
@@ -0,0 +1,29 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, getStaticAttribute, hasRawOptOut } from '../utils.js'
+
+export const preferUIcon: Rule = {
+  meta: {
+    type: 'suggestion',
+    docs: {
+      description: 'Prefer Nuxt UI `<UIcon>` over raw Iconify class markup.',
+      url: docsUrl('nuxt-ui/prefer-u-icon'),
+    },
+    schema: [],
+    messages: {
+      preferIcon: 'Use `<UIcon name="{{ icon }}" />` instead of a raw icon class.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (hasRawOptOut(node) || (node.name !== 'i' && node.name !== 'span'))
+          return
+        const classes = getStaticAttribute(node, 'class')
+        const icon = classes?.split(/\s+/).find((value: string) => /^i-[\w-]+$/.test(value))
+        if (icon)
+          context.report({ loc: node.startTag.loc, messageId: 'preferIcon', data: { icon } })
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
new file mode 100644
index 0000000..d24eb7a
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
@@ -0,0 +1,9 @@
+# `@nustack/nuxt-ui/prefer-u-kbd`
+
+Prefer Nuxt UI's `UKbd` over a raw `kbd` element for theme-aware keyboard hints.
+
+```vue
+<UKbd value="K" />
+```
+
+Use `data-raw` when native markup is intentional.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.test.ts
new file mode 100644
index 0000000..7969171
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.test.ts
@@ -0,0 +1,14 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('prefer-u-kbd', () => {
+  it('prefers UKbd', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('prefer-u-kbd', plugin.rules?.['prefer-u-kbd'] as never, {
+      valid: [{ filename: 'component.vue', code: '<template><UKbd value="K" /></template>' }],
+      invalid: [{ filename: 'component.vue', code: '<template><kbd>K</kbd></template>', errors: [{ messageId: 'preferUKbd' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.ts
new file mode 100644
index 0000000..d05cd35
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.ts
@@ -0,0 +1,8 @@
+import { preferUComponent } from '../prefer-u-component.js'
+
+export const preferUKbd = preferUComponent({
+  nativeTag: 'kbd',
+  component: 'UKbd',
+  ruleName: 'prefer-u-kbd',
+  messageId: 'preferUKbd',
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
new file mode 100644
index 0000000..5e2b7b6
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
@@ -0,0 +1,9 @@
+# `@nustack/nuxt-ui/prefer-u-progress`
+
+Prefer Nuxt UI's accessible and theme-aware `UProgress` over a raw `progress` element.
+
+```vue
+<UProgress :model-value="50" :max="100" />
+```
+
+Use `data-raw` when native markup is intentional.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.test.ts
new file mode 100644
index 0000000..a550aa2
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.test.ts
@@ -0,0 +1,14 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('prefer-u-progress', () => {
+  it('prefers UProgress', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('prefer-u-progress', plugin.rules?.['prefer-u-progress'] as never, {
+      valid: [{ filename: 'component.vue', code: '<template><UProgress :model-value="50" /></template>' }],
+      invalid: [{ filename: 'component.vue', code: '<template><progress value="50" max="100" /></template>', errors: [{ messageId: 'preferUProgress' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.ts
new file mode 100644
index 0000000..948501b
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.ts
@@ -0,0 +1,8 @@
+import { preferUComponent } from '../prefer-u-component.js'
+
+export const preferUProgress = preferUComponent({
+  nativeTag: 'progress',
+  component: 'UProgress',
+  ruleName: 'prefer-u-progress',
+  messageId: 'preferUProgress',
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
new file mode 100644
index 0000000..12fdb20
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
@@ -0,0 +1,10 @@
+# `@nustack/nuxt-ui/prefer-u-separator`
+
+Prefer `USeparator` over a raw `hr` element for consistent orientation, color, size, and
+optional label handling.
+
+```vue
+<USeparator />
+```
+
+Use `data-raw` when native markup is intentional.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.test.ts
new file mode 100644
index 0000000..53a0c61
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.test.ts
@@ -0,0 +1,14 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('prefer-u-separator', () => {
+  it('prefers USeparator', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('prefer-u-separator', plugin.rules?.['prefer-u-separator'] as never, {
+      valid: [{ filename: 'component.vue', code: '<template><USeparator /></template>' }],
+      invalid: [{ filename: 'component.vue', code: '<template><hr></template>', errors: [{ messageId: 'preferUSeparator' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.ts
new file mode 100644
index 0000000..3f7a9ec
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.ts
@@ -0,0 +1,8 @@
+import { preferUComponent } from '../prefer-u-component.js'
+
+export const preferUSeparator = preferUComponent({
+  nativeTag: 'hr',
+  component: 'USeparator',
+  ruleName: 'prefer-u-separator',
+  messageId: 'preferUSeparator',
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
new file mode 100644
index 0000000..18bf4b8
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
@@ -0,0 +1,9 @@
+# `@nustack/nuxt-ui/require-avatar-alt`
+
+Require `alt` on image-backed `UAvatar` components. Use `aria-hidden` for an explicitly
+decorative avatar.
+
+```vue
+<UAvatar src="/users/ben.png" alt="Benjamin" />
+<UAvatar src="/brand-mark.png" aria-hidden="true" />
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.test.ts
new file mode 100644
index 0000000..ccaa781
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.test.ts
@@ -0,0 +1,17 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('require-avatar-alt', () => {
+  it('requires alt for image avatars', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('require-avatar-alt', plugin.rules?.['require-avatar-alt'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UAvatar src="/avatar.png" alt="Ada" /></template>' },
+        { filename: 'component.vue', code: '<template><UAvatar src="/mark.svg" aria-hidden="true" /></template>' },
+      ],
+      invalid: [{ filename: 'component.vue', code: '<template><UAvatar src="/avatar.png" /></template>', errors: [{ messageId: 'missingAlt' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts
new file mode 100644
index 0000000..2be45d9
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts
@@ -0,0 +1,27 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, hasAttribute } from '../utils.js'
+
+export const requireAvatarAlt: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require alternative text for Nuxt UI avatars that render an image.',
+      url: docsUrl('nuxt-ui/require-avatar-alt'),
+    },
+    schema: [],
+    messages: {
+      missingAlt: 'Add `alt` to `<UAvatar>` (or explicitly mark a decorative avatar with `aria-hidden`).',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (node.name !== 'uavatar' || !hasAttribute(node, 'src'))
+          return
+        if (!hasAttribute(node, 'alt') && !hasAttribute(node, 'aria-hidden'))
+          context.report({ loc: node.startTag.loc, messageId: 'missingAlt' })
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
new file mode 100644
index 0000000..bc97f4d
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
@@ -0,0 +1,20 @@
+# `@nustack/nuxt-ui/require-form-control-label`
+
+Require an accessible name for Nuxt UI form controls. A label may be provided by
+`label`, `legend`, `aria-label`, `aria-labelledby`, the matching slot, or an enclosing
+`UFormField`.
+
+```vue
+<!-- Incorrect -->
+<UInput placeholder="Search" />
+
+<!-- Correct -->
+<UFormField label="Search">
+  <UInput placeholder="Search" />
+</UFormField>
+<UCheckboxGroup legend="Options" :items="items" />
+<USwitch aria-label="Enable notifications" />
+```
+
+Dynamic bindings are accepted because their runtime value cannot be proven statically.
+Use `data-raw` for an intentional low-level exception.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
new file mode 100644
index 0000000..97f5a87
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
@@ -0,0 +1,22 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('require-form-control-label', () => {
+  it('requires accessible labels on form controls', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('require-form-control-label', plugin.rules?.['require-form-control-label'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UInput aria-label="Search" /></template>' },
+        { filename: 'component.vue', code: '<template><UCheckboxGroup legend="Theme" /></template>' },
+        { filename: 'component.vue', code: '<template><UFormField label="Email"><UInput /></UFormField></template>' },
+        { filename: 'component.vue', code: '<template><UInput data-raw /></template>' },
+      ],
+      invalid: [
+        { filename: 'component.vue', code: '<template><UInput placeholder="Search" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { filename: 'component.vue', code: '<template><URadioGroup :items="items" /></template>', errors: [{ messageId: 'missingLabel' }] },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
new file mode 100644
index 0000000..f3b093a
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
@@ -0,0 +1,62 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { componentName, defineTemplateVisitor, hasAncestor, hasNonEmptyAttribute, hasRawOptOut, hasSlot } from '../utils.js'
+
+const FORM_CONTROLS = new Set([
+  'ucheckbox',
+  'ucheckboxgroup',
+  'ucolorpicker',
+  'ufileupload',
+  'uinput',
+  'uinputdate',
+  'uinputmenu',
+  'uinputnumber',
+  'uinputrating',
+  'uinputtags',
+  'uinputtime',
+  'ulistbox',
+  'upininput',
+  'uradiogroup',
+  'uselect',
+  'uselectmenu',
+  'uslider',
+  'uswitch',
+  'utextarea',
+])
+
+function hasAccessibleLabel(node: any): boolean {
+  return hasNonEmptyAttribute(node, 'label')
+    || hasNonEmptyAttribute(node, 'legend')
+    || hasNonEmptyAttribute(node, 'aria-label')
+    || hasNonEmptyAttribute(node, 'aria-labelledby')
+    || hasSlot(node, 'label')
+    || hasSlot(node, 'legend')
+    || hasAncestor(node, 'uformfield')
+}
+
+export const requireFormControlLabel: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require an accessible label for Nuxt UI form controls.',
+      url: docsUrl('nuxt-ui/require-form-control-label'),
+    },
+    schema: [],
+    messages: {
+      missingLabel: 'Add `label`, `legend`, `aria-label`, `aria-labelledby`, or wrap `<{{ component }}>` in `<UFormField>`.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (!FORM_CONTROLS.has(node.name) || hasRawOptOut(node) || hasAccessibleLabel(node))
+          return
+        context.report({
+          loc: node.startTag.loc,
+          messageId: 'missingLabel',
+          data: { component: componentName(node.name) },
+        })
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md
new file mode 100644
index 0000000..8762069
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md
@@ -0,0 +1,13 @@
+# `@nustack/nuxt-ui/require-form-field-name`
+
+Inside `UForm`, each `UFormField` needs a `name` or `error-pattern` so Nuxt UI can route
+schema/custom-validation errors to the correct field. Standalone display-only form fields
+are ignored.
+
+```vue
+<UForm :schema="schema" :state="state">
+  <UFormField name="email" label="Email">
+    <UInput v-model="state.email" />
+  </UFormField>
+</UForm>
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.test.ts
new file mode 100644
index 0000000..8fadca7
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.test.ts
@@ -0,0 +1,17 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('require-form-field-name', () => {
+  it('requires a validation target inside UForm', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('require-form-field-name', plugin.rules?.['require-form-field-name'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UForm :state="state"><UFormField name="email" /></UForm></template>' },
+        { filename: 'component.vue', code: '<template><UFormField label="Display only" /></template>' },
+      ],
+      invalid: [{ filename: 'component.vue', code: '<template><UForm :state="state"><UFormField label="Email" /></UForm></template>', errors: [{ messageId: 'missingName' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
new file mode 100644
index 0000000..a1b21ee
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
@@ -0,0 +1,29 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, hasAncestor, hasAttribute } from '../utils.js'
+
+export const requireFormFieldName: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require a validation target on Nuxt UI form fields used inside a form.',
+      url: docsUrl('nuxt-ui/require-form-field-name'),
+    },
+    schema: [],
+    messages: {
+      missingName: 'Add `name` or `error-pattern` to this `<UFormField>` so `<UForm>` can route validation errors to it.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (node.name === 'uformfield'
+          && hasAncestor(node, 'uform')
+          && !hasAttribute(node, 'name')
+          && !hasAttribute(node, 'error-pattern')) {
+          context.report({ loc: node.startTag.loc, messageId: 'missingName' })
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.md
new file mode 100644
index 0000000..5da5a21
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.md
@@ -0,0 +1,15 @@
+# `@nustack/nuxt-ui/require-form-state`
+
+Require the reactive `state` prop documented by Nuxt UI's `UForm` API.
+
+```vue
+<!-- Incorrect -->
+<UForm :schema="schema" />
+
+<!-- Correct -->
+<UForm :schema="schema" :state="state" />
+```
+
+Dynamic bindings (`:state`) are accepted.
+Nested forms (`<UForm nested>`) are also accepted because Nuxt UI explicitly makes them
+inherit the parent form's state.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.test.ts
new file mode 100644
index 0000000..47dbe53
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.test.ts
@@ -0,0 +1,17 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('require-form-state', () => {
+  it('requires state', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('require-form-state', plugin.rules?.['require-form-state'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UForm :state="state" /></template>' },
+        { filename: 'component.vue', code: '<template><UForm nested :schema="nestedSchema" /></template>' },
+      ],
+      invalid: [{ filename: 'component.vue', code: '<template><UForm :schema="schema" /></template>', errors: [{ messageId: 'missingState' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.ts
new file mode 100644
index 0000000..9116132
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.ts
@@ -0,0 +1,26 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, hasAttribute } from '../utils.js'
+
+export const requireFormState: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require `state` on Nuxt UI forms so validation and field binding have a reactive source of truth.',
+      url: docsUrl('nuxt-ui/require-form-state'),
+    },
+    schema: [],
+    messages: {
+      missingState: 'Nuxt UI `<UForm>` requires a `state` prop; pass the reactive form state explicitly.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        // Nested forms explicitly inherit the parent form's state in Nuxt UI.
+        if (node.name === 'uform' && !hasAttribute(node, 'state') && !hasAttribute(node, 'nested'))
+          context.report({ loc: node.startTag.loc, messageId: 'missingState' })
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
new file mode 100644
index 0000000..47fb030
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
@@ -0,0 +1,8 @@
+# `@nustack/nuxt-ui/require-icon-button-label`
+
+Icon-only `UButton` instances need an accessible label. `label`, `aria-label`, `title`, or
+visible slot content satisfies the rule.
+
+```vue
+<UButton icon="i-lucide-search" aria-label="Search" />
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
new file mode 100644
index 0000000..a853253
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
@@ -0,0 +1,17 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('require-icon-button-label', () => {
+  it('labels icon-only buttons', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('require-icon-button-label', plugin.rules?.['require-icon-button-label'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UButton icon="i-lucide-search" aria-label="Search" /></template>' },
+        { filename: 'component.vue', code: '<template><UButton icon="i-lucide-save">Save</UButton></template>' },
+      ],
+      invalid: [{ filename: 'component.vue', code: '<template><UButton icon="i-lucide-search" /></template>', errors: [{ messageId: 'missingLabel' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
new file mode 100644
index 0000000..0873de6
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
@@ -0,0 +1,30 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, hasAttribute, hasMeaningfulText, hasNonEmptyAttribute } from '../utils.js'
+
+export const requireIconButtonLabel: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require an accessible label for icon-only Nuxt UI buttons.',
+      url: docsUrl('nuxt-ui/require-icon-button-label'),
+    },
+    schema: [],
+    messages: {
+      missingLabel: 'Icon-only `<UButton>` needs `label`, `aria-label`, or an accessible `title`.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (node.name !== 'ubutton' || (!hasAttribute(node, 'icon') && !hasAttribute(node, 'avatar')))
+          return
+        if (hasNonEmptyAttribute(node, 'label') || hasNonEmptyAttribute(node, 'aria-label')
+          || hasNonEmptyAttribute(node, 'title') || hasMeaningfulText(node)) {
+          return
+        }
+        context.report({ loc: node.startTag.loc, messageId: 'missingLabel' })
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md
new file mode 100644
index 0000000..ef0aa14
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md
@@ -0,0 +1,9 @@
+# `@nustack/nuxt-ui/require-overlay-title`
+
+Require an accessible title on `UModal`, `UDrawer`, and `USlideover`. A `title` prop,
+`#title` slot, `aria-label`, or `aria-labelledby` satisfies the rule.
+
+```vue
+<UModal title="Delete project" />
+<UModal><template #title>Delete project</template></UModal>
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.test.ts
new file mode 100644
index 0000000..f8ca893
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.test.ts
@@ -0,0 +1,18 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('require-overlay-title', () => {
+  it('requires an accessible title', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('require-overlay-title', plugin.rules?.['require-overlay-title'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UModal title="Settings" /></template>' },
+        { filename: 'component.vue', code: '<template><UDrawer aria-label="Navigation" /></template>' },
+        { filename: 'component.vue', code: '<template><USlideover><template #title>Help</template></USlideover></template>' },
+      ],
+      invalid: [{ filename: 'component.vue', code: '<template><UModal /></template>', errors: [{ messageId: 'missingTitle' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts
new file mode 100644
index 0000000..fd232c2
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts
@@ -0,0 +1,32 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, hasNonEmptyAttribute, hasSlot } from '../utils.js'
+
+const OVERLAYS = new Set(['umodal', 'udrawer', 'uslideover'])
+
+export const requireOverlayTitle: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require an accessible title on Nuxt UI modal, drawer, and slideover components.',
+      url: docsUrl('nuxt-ui/require-overlay-title'),
+    },
+    schema: [],
+    messages: {
+      missingTitle: 'Add a `title`, `#title`, `aria-label`, or `aria-labelledby` to this Nuxt UI overlay.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (OVERLAYS.has(node.name)
+          && !hasNonEmptyAttribute(node, 'title')
+          && !hasNonEmptyAttribute(node, 'aria-label')
+          && !hasNonEmptyAttribute(node, 'aria-labelledby')
+          && !hasSlot(node, 'title')) {
+          context.report({ loc: node.startTag.loc, messageId: 'missingTitle' })
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md
new file mode 100644
index 0000000..cd963a0
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md
@@ -0,0 +1,13 @@
+# `@nustack/nuxt-ui/require-popover-content`
+
+Require the `#content` slot on `UPopover`. The similarly named `content` prop configures
+floating position, collision handling, and alignment; it does not provide displayed content.
+
+```vue
+<UPopover>
+  <UButton label="Details" />
+  <template #content>
+    Details
+  </template>
+</UPopover>
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.test.ts
new file mode 100644
index 0000000..d0b1676
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.test.ts
@@ -0,0 +1,14 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('require-popover-content', () => {
+  it('requires the content slot', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('require-popover-content', plugin.rules?.['require-popover-content'] as never, {
+      valid: [{ filename: 'component.vue', code: '<template><UPopover><UButton /><template #content>Details</template></UPopover></template>' }],
+      invalid: [{ filename: 'component.vue', code: '<template><UPopover :content="{ side: \'right\' }"><UButton /></UPopover></template>', errors: [{ messageId: 'missingContent' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts
new file mode 100644
index 0000000..6f4badd
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts
@@ -0,0 +1,25 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, hasSlot } from '../utils.js'
+
+export const requirePopoverContent: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require a content slot on Nuxt UI popovers.',
+      url: docsUrl('nuxt-ui/require-popover-content'),
+    },
+    schema: [],
+    messages: {
+      missingContent: 'Add a `#content` slot to `<UPopover>`; the `content` prop only configures positioning.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (node.name === 'upopover' && !hasSlot(node, 'content'))
+          context.report({ loc: node.startTag.loc, messageId: 'missingContent' })
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md
new file mode 100644
index 0000000..1469363
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md
@@ -0,0 +1,8 @@
+# `@nustack/nuxt-ui/require-tooltip-content`
+
+Require `text` or a `#content` slot on `UTooltip`. This prevents empty hover targets and
+keeps the component useful for keyboard and pointer users.
+
+```vue
+<UTooltip text="Open settings"><UButton icon="i-lucide-settings" aria-label="Settings" /></UTooltip>
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.test.ts
new file mode 100644
index 0000000..f19384f
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.test.ts
@@ -0,0 +1,17 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('require-tooltip-content', () => {
+  it('requires text or content slot', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('require-tooltip-content', plugin.rules?.['require-tooltip-content'] as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UTooltip text="Settings"><UButton /></UTooltip></template>' },
+        { filename: 'component.vue', code: '<template><UTooltip><template #content>Settings</template></UTooltip></template>' },
+      ],
+      invalid: [{ filename: 'component.vue', code: '<template><UTooltip><UButton /></UTooltip></template>', errors: [{ messageId: 'missingContent' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts
new file mode 100644
index 0000000..0baa3a9
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts
@@ -0,0 +1,25 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, hasNonEmptyAttribute, hasSlot } from '../utils.js'
+
+export const requireTooltipContent: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require content on Nuxt UI tooltips so they communicate a useful hint.',
+      url: docsUrl('nuxt-ui/require-tooltip-content'),
+    },
+    schema: [],
+    messages: {
+      missingContent: 'Add a non-empty `text` prop or `#content` slot to `<UTooltip>`.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (node.name === 'utooltip' && !hasNonEmptyAttribute(node, 'text') && !hasSlot(node, 'content'))
+          context.report({ loc: node.startTag.loc, messageId: 'missingContent' })
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
new file mode 100644
index 0000000..326103c
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
@@ -0,0 +1,15 @@
+# `@nustack/nuxt-ui/require-u-app`
+
+Require `UApp` in the Nuxt `app.vue` root. Nuxt UI documents it as the provider for global
+configuration, reading direction, body-lock behavior, toasts, tooltips, and programmatic
+modals/slideovers.
+
+```vue
+<template>
+  <UApp>
+    <NuxtPage />
+  </UApp>
+</template>
+```
+
+Files under `components`, `pages`, and `layouts` are ignored even if named `App.vue`.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.test.ts
new file mode 100644
index 0000000..75bb582
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.test.ts
@@ -0,0 +1,17 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+describe('require-u-app', () => {
+  it('requires UApp only in the Nuxt application root', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+    tester.run('require-u-app', plugin.rules?.['require-u-app'] as never, {
+      valid: [
+        { filename: '/project/app.vue', code: '<template><UApp><NuxtPage /></UApp></template>' },
+        { filename: '/project/components/App.vue', code: '<template><div /></template>' },
+      ],
+      invalid: [{ filename: '/project/app.vue', code: '<template><NuxtPage /></template>', errors: [{ messageId: 'missingApp' }] }],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts
new file mode 100644
index 0000000..7cbc71e
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts
@@ -0,0 +1,43 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor } from '../utils.js'
+
+function isNuxtAppFile(filename: string): boolean {
+  const normalized = filename.replaceAll('\\', '/').toLowerCase()
+  return (normalized === 'app.vue' || normalized.endsWith('/app.vue'))
+    && !normalized.includes('/components/')
+    && !normalized.includes('/pages/')
+    && !normalized.includes('/layouts/')
+}
+
+function containsUApp(node: any): boolean {
+  if (node.name === 'uapp')
+    return true
+  return (node.children ?? []).some((child: any) => child.type === 'VElement' && containsUApp(child))
+}
+
+export const requireUApp: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require the Nuxt UI App provider in the Nuxt application root.',
+      url: docsUrl('nuxt-ui/require-u-app'),
+    },
+    schema: [],
+    messages: {
+      missingApp: 'Wrap the application in `<UApp>` to provide Nuxt UI configuration, toasts, tooltips, and programmatic overlays.',
+    },
+  },
+  create(context: any) {
+    const filename = context.filename ?? context.getFilename()
+    if (!isNuxtAppFile(filename))
+      return {}
+
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (node.parent?.type === 'VDocumentFragment' && !containsUApp(node))
+          context.report({ loc: node.startTag.loc, messageId: 'missingApp' })
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
index 5be61ae..3e326c2 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
@@ -12,3 +12,87 @@ export function hasRawOptOut(node: any): boolean {
     (attribute: any) => !attribute.directive && attribute.key.name === 'data-raw',
   )
 }
+
+/** Returns an attribute, including `:name`/`v-bind:name`, by its normalized name. */
+export function getAttribute(node: any, name: string): any | null {
+  return node.startTag.attributes.find((attribute: any) => {
+    if (!attribute.directive)
+      return attribute.key.name === name
+    if (attribute.key.name?.name !== 'bind')
+      return false
+    const argument = attribute.key.argument
+    return argument?.type === 'VIdentifier' && argument.name === name
+  }) ?? null
+}
+
+export function hasAttribute(node: any, name: string): boolean {
+  return !!getAttribute(node, name)
+}
+
+/** Accepts dynamic bindings and non-empty static string attributes. */
+export function hasNonEmptyAttribute(node: any, name: string): boolean {
+  const attribute = getAttribute(node, name)
+  if (!attribute)
+    return false
+  if (attribute.directive)
+    return true
+  return typeof attribute.value?.value === 'string' && attribute.value.value.trim().length > 0
+}
+
+export function getStaticAttribute(node: any, name: string): string | null {
+  const attribute = node.startTag.attributes.find(
+    (candidate: any) => !candidate.directive && candidate.key.name === name && candidate.value,
+  )
+  return attribute?.value?.value ?? null
+}
+
+export function hasSlot(node: any, name: string): boolean {
+  return (node.children ?? []).some((child: any) => {
+    if (child.type !== 'VElement')
+      return false
+    return child.startTag.attributes.some((attribute: any) => {
+      if (!attribute.directive || attribute.key.name?.name !== 'slot')
+        return false
+      const argument = attribute.key.argument
+      return argument?.type === 'VIdentifier' && argument.name === name
+    })
+  })
+}
+
+export function hasMeaningfulText(node: any): boolean {
+  return (node.children ?? []).some((child: any) => {
+    if (child.type === 'VText')
+      return child.value.trim().length > 0
+    // Interpolations can provide a runtime label. Child components (for example
+    // `<UIcon>`) are intentionally not treated as an accessible label.
+    return child.type === 'VExpressionContainer'
+  })
+}
+
+export function componentName(name: string): string {
+  if (!name.startsWith('u'))
+    return name
+  const rest = name.slice(1).replace(/(^|-)([a-z])/g, (_match, _separator, character) => character.toUpperCase())
+  return `U${rest}`
+}
+
+export function hasAncestor(node: any, name: string): boolean {
+  let parent = node.parent
+  while (parent) {
+    if (parent.type === 'VElement' && parent.name === name)
+      return true
+    parent = parent.parent
+  }
+  return false
+}
+
+export function hasVModel(node: any, argumentName: string | null): boolean {
+  return node.startTag.attributes.some((attribute: any) => {
+    if (!attribute.directive || attribute.key.name?.name !== 'model')
+      return false
+    const argument = attribute.key.argument
+    if (argumentName === null)
+      return !argument
+    return argument?.type === 'VIdentifier' && argument.name === argumentName
+  })
+}

From 6e5246f9a66f581deb8f4cd7dc0f66e0ac8e73b8 Mon Sep 17 00:00:00 2001
From: lajczi <lajczi@disroot.org>
Date: Tue, 21 Jul 2026 23:00:48 +0200
Subject: [PATCH 02/12] chore: remove useless Nuxt UI research markdown file

---
 .../NUXT_UI_RESEARCH.md                       | 70 -------------------
 packages/lint-plugin-nuxt-ecosystem/README.md |  2 -
 .../lint-plugin-nuxt-ecosystem/package.json   |  1 -
 3 files changed, 73 deletions(-)
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/NUXT_UI_RESEARCH.md

diff --git a/packages/lint-plugin-nuxt-ecosystem/NUXT_UI_RESEARCH.md b/packages/lint-plugin-nuxt-ecosystem/NUXT_UI_RESEARCH.md
deleted file mode 100644
index 1163799..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/NUXT_UI_RESEARCH.md
+++ /dev/null
@@ -1,70 +0,0 @@
-# Nuxt UI lint research
-
-Research date: 2026-07-21. The implementation was checked against the live Nuxt UI v4.6.1
-documentation at `ui.nuxt.com`, including the complete component index, component API
-tables, composable entry points, theming guidance, accessibility guidance, and the v3-to-v4
-migration guide.
-
-## Sources and enforceable conventions
-
-| Area | Documented convention | Lint implementation |
-|---|---|---|
-| Design system | Prefer semantic colors (`text-muted`, `bg-elevated`, `border-default`, semantic status aliases) so themes and dark mode remain portable. | `prefer-semantic-colors` |
-| Application provider | `UApp` wraps the application and provides config, direction, toast, tooltip, and overlay providers. | `require-u-app` |
-| Component props | `color`, `variant`, and `size` are documented finite unions. | `no-invalid-prop-values` (static values only, extensible for custom variants) |
-| Form control labels | Inputs and choice controls expose labels/legends or are intended to be associated through `UFormField`. | `require-form-control-label` |
-| Icons | Iconify names are passed through `UIcon` or component icon props. | `prefer-u-icon`; existing component-preference rules |
-| Icon names | Docs use the `i-<collection>-<icon>` naming convention, while Vue component bindings remain supported. | `no-invalid-icon-name` |
-| Buttons | Icon-only buttons are supported, but still need an accessible name. | `require-icon-button-label` |
-| Links | `ULink` wraps `NuxtLink`; link-capable components document `to`. | `prefer-link-to` |
-| Avatars | `alt` is forwarded to the image and also supplies fallback initials. | `require-avatar-alt` |
-| Forms | A root `UForm` receives reactive `state`; nested forms explicitly inherit parent state. | `require-form-state` with a `nested` exception |
-| Form errors | `UForm` routes errors to `UFormField` through `name` or `error-pattern`. | `require-form-field-name`, scoped to fields inside `UForm` |
-| Overlay state | Modal, drawer, slideover, popover, and tooltip expose the named `open` model. | `prefer-open-model` |
-| Controlled state | `default-open`/`default-value` are initializers for uncontrolled components and should not be mixed with controlled state. | `no-conflicting-state-props` |
-| Dialog accessibility | Modal-like overlays expose title props/slots backed by Reka UI dialog semantics. | `require-overlay-title` with prop, slot, and ARIA alternatives |
-| Tooltip content | `UTooltip` documents `text` and `#content` as its content sources. | `require-tooltip-content` |
-| Popover content | `UPopover`'s `content` prop configures positioning; visible content belongs in `#content`. | `require-popover-content` |
-| Cross-prop constraints | `UFileUpload` restricts button/area, layout and position combinations; `UAccordion collapsible` applies to single mode. | `no-invalid-prop-combinations` |
-| v4 migration | Three component changes and the `nullify` to `nullable` model-modifier rename. | Existing deprecation rules; object-form `model-modifiers` coverage added |
-
-## False-positive policy
-
-- Dynamic bindings are accepted where static correctness cannot be proven.
-- `data-raw` remains the local escape hatch for deliberately native/component-level
-  markup and hard-coded brand styling.
-- Rules that need application-wide knowledge (for example, verifying the single root
-  `UApp` provider) are not implemented as per-file template rules.
-- `loading-auto`, `UForm` submit handlers, and structural replacements such as arbitrary
-  `div` to `UCard` are not required: the documentation supports valid cases without them,
-  so enforcing them would be guesswork.
-- `require-u-app` intentionally scopes itself to the Nuxt `app.vue` root and ignores
-  component/page/layout files named `App.vue`.
-- Nested `UForm` and standalone `UFormField` patterns are explicitly preserved because
-  both are documented use cases.
-- Form controls with dynamic labels are accepted; the label rule only reports when no
-  direct ARIA/label API or `UFormField` association is visible in the template.
-
-## Third-stage coverage audit
-
-The complete component index was audited by category. The table records both what is
-enforced and why additional rules were not invented for the remaining documentation.
-
-| Documentation category | Audited surface | Decision |
-|---|---|---|
-| Layout | `App`, `Container`, `Error`, `Footer`, `Header`, `Main`, `Sidebar`, `Theme` | `require-u-app` covers the provider boundary; the remaining components are structural wrappers whose correct nesting depends on the application layout. |
-| Element | `Alert`, `Avatar`, `AvatarGroup`, `Badge`, `Banner`, `Button`, `Calendar`, `Card`, `Chip`, `Collapsible`, `FieldGroup`, `Icon`, `Kbd`, `Progress`, `Separator`, `Skeleton` | Covered by semantic colors, icon-name validation, accessible labels, avatar alt text, finite prop validation, and native-component preferences where the API is unambiguous. |
-| Form | `Checkbox`, `CheckboxGroup`, `ColorPicker`, `FileUpload`, `Form`, `FormField`, `Input`, `InputDate`, `InputMenu`, `InputNumber`, `InputRating`, `InputTags`, `InputTime`, `Listbox`, `PinInput`, `RadioGroup`, `Select`, `SelectMenu`, `Slider`, `Switch`, `Textarea` | Covered by form state/name/label rules, controlled-state conflicts, static API unions, and file-upload relationship checks. Item schemas and runtime validation remain dynamic. |
-| Data | `Accordion`, `Carousel`, `Empty`, `Marquee`, `ScrollArea`, `Table`, `Timeline`, `Tree`, `User` | Accordion's documented `type`/`collapsible` relationship is enforced. The rest are driven by runtime data, slots, or render functions; a per-file rule would guess at valid use cases. |
-| Navigation | `Breadcrumb`, `CommandPalette`, `FooterColumns`, `Link`, `NavigationMenu`, `Pagination`, `Stepper`, `Tabs` | Link and button navigation semantics are covered. Menu, tab, step, and command item labels usually come from typed arrays or slots and cannot be validated from the template safely. |
-| Overlay | `ContextMenu`, `Drawer`, `DropdownMenu`, `Modal`, `Popover`, `Slideover`, `Toast`, `Tooltip` | Open-state naming, overlay titles, tooltip/popover content, and provider setup are covered. Menu item contents and programmatic toast payloads require script/runtime analysis. |
-| Page | `AuthForm`, `BlogPost`, `BlogPosts`, `ChangelogVersion`, `ChangelogVersions`, `Page`, `PageAnchors`, `PageAside`, `PageBody`, `PageCard`, `PageColumns`, `PageCTA`, `PageFeature`, `PageGrid`, `PageHeader`, `PageHero`, `PageLinks`, `PageList`, `PageLogos`, `PageSection`, `PricingPlan`, `PricingPlans`, `PricingTable` | These are composition primitives; enforcing a particular page hierarchy or content shape would be opinionated rather than a documented invariant. |
-| Dashboard | `DashboardGroup`, `DashboardNavbar`, `DashboardPanel`, `DashboardResizeHandle`, `DashboardSearch`, `DashboardSearchButton`, `DashboardSidebar`, `DashboardSidebarCollapse`, `DashboardSidebarToggle`, `DashboardToolbar` | State persistence, panel sizing, and responsive composition are runtime concerns. No additional template-only rule met the false-positive bar. |
-| AI Chat | `ChatMessage`, `ChatMessages`, `ChatPalette`, `ChatPrompt`, `ChatPromptSubmit`, `ChatReasoning`, `ChatShimmer`, `ChatTool` | APIs depend on Vercel AI SDK message/tool state and asynchronous status; static templates cannot establish correctness. |
-| Editor | `Editor`, `EditorDragHandle`, `EditorEmojiMenu`, `EditorMentionMenu`, `EditorSuggestionMenu`, `EditorToolbar` | TipTap extensions, editor content, and menu lifecycle are configured in script; no safe template-only invariant remains. |
-| Content | `ContentNavigation`, `ContentSearch`, `ContentSearchButton`, `ContentSurround`, `ContentToc` | Content routes and generated navigation are resolved by Nuxt Content at runtime/build time. |
-| Color mode / i18n | `ColorModeAvatar`, `ColorModeButton`, `ColorModeImage`, `ColorModeSelect`, `ColorModeSwitch`, `LocaleSelect` | Integration correctness depends on installed modules and runtime locale/color-mode configuration; component APIs themselves expose no deterministic missing prop. |
-
-This audit deliberately favors a smaller set of high-signal rules over rules that merely
-encode a preferred page architecture or require static knowledge of user-defined item
-arrays.
diff --git a/packages/lint-plugin-nuxt-ecosystem/README.md b/packages/lint-plugin-nuxt-ecosystem/README.md
index b8a8bd1..a651e97 100644
--- a/packages/lint-plugin-nuxt-ecosystem/README.md
+++ b/packages/lint-plugin-nuxt-ecosystem/README.md
@@ -6,8 +6,6 @@
 ESLint and [Oxlint](https://oxc.rs) rules for the [Nuxt module ecosystem](https://nuxt.com/modules). The plugin currently supports `@nuxt/ui` with plans to expand.
 
 Every rule is based on the respective module's official documentation and recommendations.
-The Nuxt UI source review, enforceable conventions, and false-positive policy are recorded
-in [`NUXT_UI_RESEARCH.md`](./NUXT_UI_RESEARCH.md).
 
 If you are a developer of a popular module and want to add rules for it, please reach out.
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/package.json b/packages/lint-plugin-nuxt-ecosystem/package.json
index 744b9a8..ef27cba 100644
--- a/packages/lint-plugin-nuxt-ecosystem/package.json
+++ b/packages/lint-plugin-nuxt-ecosystem/package.json
@@ -33,7 +33,6 @@
   "files": [
     "LICENSE",
     "README.md",
-    "NUXT_UI_RESEARCH.md",
     "dist",
     "src/**/*.md"
   ],

From ca759a89dd057bc249e5e3a23efbc4134fee8636 Mon Sep 17 00:00:00 2001
From: lajczi <lajczi@disroot.org>
Date: Tue, 21 Jul 2026 23:46:00 +0200
Subject: [PATCH 03/12] chore: address review feedback

---
 packages/lint-plugin-nuxt-ecosystem/README.md |  8 +-
 .../lint-plugin-nuxt-ecosystem/src/index.ts   | 24 +----
 .../no-conflicting-state-props/index.md       |  5 +
 .../nuxt-ui/no-deprecated-components/index.md |  4 +
 .../no-deprecated-model-modifiers/index.md    |  5 +
 .../nuxt-ui/no-invalid-icon-name/index.md     | 12 ---
 .../no-invalid-icon-name/index.test.ts        | 18 ----
 .../nuxt-ui/no-invalid-icon-name/index.ts     | 54 ----------
 .../no-invalid-prop-combinations/index.md     | 17 ++++
 .../nuxt-ui/no-invalid-prop-values/index.md   | 20 ----
 .../no-invalid-prop-values/index.test.ts      | 24 -----
 .../nuxt-ui/no-invalid-prop-values/index.ts   | 98 -------------------
 .../src/rules/nuxt-ui/prefer-link-to/index.md | 10 ++
 .../rules/nuxt-ui/prefer-open-model/index.md  | 12 ---
 .../nuxt-ui/prefer-open-model/index.test.ts   | 14 ---
 .../rules/nuxt-ui/prefer-open-model/index.ts  | 38 -------
 .../nuxt-ui/prefer-semantic-colors/index.md   | 12 +++
 .../rules/nuxt-ui/prefer-u-button/index.md    |  4 +
 .../nuxt-ui/prefer-u-form-controls/index.md   |  6 ++
 .../src/rules/nuxt-ui/prefer-u-icon/index.md  |  8 ++
 .../src/rules/nuxt-ui/prefer-u-kbd/index.md   |  8 ++
 .../src/rules/nuxt-ui/prefer-u-link/index.md  |  4 +
 .../index.md                                  | 10 +-
 .../index.test.ts                             |  6 +-
 .../index.ts                                  |  6 +-
 .../rules/nuxt-ui/prefer-u-progress/index.md  |  8 ++
 .../rules/nuxt-ui/prefer-u-separator/index.md |  8 ++
 .../src/rules/nuxt-ui/prefer-u-table/index.md |  4 +
 .../rules/nuxt-ui/require-avatar-alt/index.md | 10 ++
 .../require-form-control-label/index.md       |  7 +-
 .../require-form-control-label/index.test.ts  |  2 +
 .../require-form-control-label/index.ts       | 18 +++-
 .../nuxt-ui/require-form-field-name/index.md  | 13 +++
 .../rules/nuxt-ui/require-form-state/index.md | 15 ---
 .../nuxt-ui/require-form-state/index.test.ts  | 17 ----
 .../rules/nuxt-ui/require-form-state/index.ts | 26 -----
 .../require-icon-button-label/index.md        | 14 ++-
 .../require-icon-button-label/index.test.ts   |  9 +-
 .../require-icon-button-label/index.ts        | 20 +++-
 .../nuxt-ui/require-overlay-title/index.md    | 10 ++
 .../nuxt-ui/require-popover-content/index.md  | 10 ++
 .../nuxt-ui/require-tooltip-content/index.md  |  8 ++
 .../src/rules/nuxt-ui/require-u-app/index.md  | 10 ++
 43 files changed, 243 insertions(+), 393 deletions(-)
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.md
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.test.ts
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.ts
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.md
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.test.ts
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.ts
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.md
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.test.ts
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.ts
 rename packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/{prefer-u-dialog => prefer-u-modal}/index.md (66%)
 rename packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/{prefer-u-dialog => prefer-u-modal}/index.test.ts (80%)
 rename packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/{prefer-u-dialog => prefer-u-modal}/index.ts (50%)
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.md
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.test.ts
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.ts

diff --git a/packages/lint-plugin-nuxt-ecosystem/README.md b/packages/lint-plugin-nuxt-ecosystem/README.md
index a651e97..e6a076c 100644
--- a/packages/lint-plugin-nuxt-ecosystem/README.md
+++ b/packages/lint-plugin-nuxt-ecosystem/README.md
@@ -47,9 +47,8 @@ These rules are compatible with Oxlint, although some may not work perfectly due
 |---|---|
 | [`@nustack/nuxt-ui/no-conflicting-state-props`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md) | Disallow controlled state together with `default-open` or `default-value`. |
 | [`@nustack/nuxt-ui/prefer-u-button`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md) | Prefer `<UButton>` over raw `<button>` when `@nuxt/ui` is available. |
-| [`@nustack/nuxt-ui/no-invalid-icon-name`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.md) | Validate static Iconify-style icon names. |
 | [`@nustack/nuxt-ui/no-invalid-prop-combinations`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md) | Disallow documented incompatible prop combinations such as `UFileUpload variant="button" multiple`. |
-| [`@nustack/nuxt-ui/prefer-u-dialog`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.md) | Prefer `<UModal>` over raw `<dialog>`. |
+| [`@nustack/nuxt-ui/prefer-u-modal`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md) | Prefer `<UModal>` over raw `<dialog>`. |
 | [`@nustack/nuxt-ui/prefer-u-form-controls`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md) | Prefer Nuxt UI form controls over raw native form elements; type-aware (e.g. `<input type="number">` / `<UInput type="number">` → `<UInputNumber>`). |
 | [`@nustack/nuxt-ui/prefer-u-link`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md) | Prefer `<ULink>` over raw `<a>` when `@nuxt/ui` is available. |
 | [`@nustack/nuxt-ui/prefer-u-kbd`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md) | Prefer `<UKbd>` over raw `<kbd>`. |
@@ -58,16 +57,13 @@ These rules are compatible with Oxlint, although some may not work perfectly due
 | [`@nustack/nuxt-ui/prefer-u-table`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md) | Prefer `<UTable>` over raw `<table>` when `@nuxt/ui` is available. |
 | [`@nustack/nuxt-ui/no-deprecated-components`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md) | Disallow Nuxt UI components renamed in v4 (e.g. `UButtonGroup` → `UFieldGroup`). |
 | [`@nustack/nuxt-ui/no-deprecated-model-modifiers`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md) | Disallow the `v-model.nullify` modifier renamed to `.nullable` in Nuxt UI v4. |
-| [`@nustack/nuxt-ui/no-invalid-prop-values`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.md) | Catch invalid static `color`, `variant`, and `size` values on common components. |
 | [`@nustack/nuxt-ui/prefer-link-to`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md) | Prefer `to` over `href` on `ULink` and link-capable `UButton`. |
-| [`@nustack/nuxt-ui/prefer-open-model`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.md) | Prefer explicit `v-model:open` for Nuxt UI overlays. |
 | [`@nustack/nuxt-ui/prefer-semantic-colors`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md) | Prefer theme-aware semantic color tokens over hard-coded palette classes. |
 | [`@nustack/nuxt-ui/prefer-u-icon`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md) | Prefer `<UIcon name="...">` over raw Iconify class markup. |
 | [`@nustack/nuxt-ui/require-avatar-alt`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md) | Require alt text on image-backed avatars. |
 | [`@nustack/nuxt-ui/require-form-field-name`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md) | Require `name` or `error-pattern` on form fields inside `<UForm>`. |
 | [`@nustack/nuxt-ui/require-form-control-label`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md) | Require an accessible label for Nuxt UI form controls. |
-| [`@nustack/nuxt-ui/require-form-state`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.md) | Require the reactive `state` prop on `<UForm>`. |
-| [`@nustack/nuxt-ui/require-icon-button-label`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md) | Require an accessible label for icon-only buttons. |
+| [`@nustack/nuxt-ui/require-icon-button-label`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md) | Require an accessible label for icon-, avatar-, and loading-only buttons. |
 | [`@nustack/nuxt-ui/require-overlay-title`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md) | Require accessible titles on modal, drawer, and slideover. |
 | [`@nustack/nuxt-ui/require-popover-content`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md) | Require a `#content` slot on `<UPopover>`. |
 | [`@nustack/nuxt-ui/require-tooltip-content`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md) | Require tooltip text or a content slot. |
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
index 8dfec3e..568c357 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
@@ -3,25 +3,21 @@ import { eslintCompatPlugin } from '@oxlint/plugins'
 import { noConflictingStateProps as noConflictingStatePropsRule } from './rules/nuxt-ui/no-conflicting-state-props/index.js'
 import { noDeprecatedComponents as noDeprecatedComponentsRule } from './rules/nuxt-ui/no-deprecated-components/index.js'
 import { noDeprecatedModelModifiers as noDeprecatedModelModifiersRule } from './rules/nuxt-ui/no-deprecated-model-modifiers/index.js'
-import { noInvalidIconName as noInvalidIconNameRule } from './rules/nuxt-ui/no-invalid-icon-name/index.js'
 import { noInvalidPropCombinations as noInvalidPropCombinationsRule } from './rules/nuxt-ui/no-invalid-prop-combinations/index.js'
-import { noInvalidPropValues as noInvalidPropValuesRule } from './rules/nuxt-ui/no-invalid-prop-values/index.js'
 import { preferLinkTo as preferLinkToRule } from './rules/nuxt-ui/prefer-link-to/index.js'
-import { preferOpenModel as preferOpenModelRule } from './rules/nuxt-ui/prefer-open-model/index.js'
 import { preferSemanticColors as preferSemanticColorsRule } from './rules/nuxt-ui/prefer-semantic-colors/index.js'
 import { preferUButton as preferUButtonRule } from './rules/nuxt-ui/prefer-u-button/index.js'
-import { preferUDialog as preferUDialogRule } from './rules/nuxt-ui/prefer-u-dialog/index.js'
 import { preferUFormControls as preferUFormControlsRule } from './rules/nuxt-ui/prefer-u-form-controls/index.js'
 import { preferUIcon as preferUIconRule } from './rules/nuxt-ui/prefer-u-icon/index.js'
 import { preferUKbd as preferUKbdRule } from './rules/nuxt-ui/prefer-u-kbd/index.js'
 import { preferULink as preferULinkRule } from './rules/nuxt-ui/prefer-u-link/index.js'
+import { preferUModal as preferUModalRule } from './rules/nuxt-ui/prefer-u-modal/index.js'
 import { preferUProgress as preferUProgressRule } from './rules/nuxt-ui/prefer-u-progress/index.js'
 import { preferUSeparator as preferUSeparatorRule } from './rules/nuxt-ui/prefer-u-separator/index.js'
 import { preferUTable as preferUTableRule } from './rules/nuxt-ui/prefer-u-table/index.js'
 import { requireAvatarAlt as requireAvatarAltRule } from './rules/nuxt-ui/require-avatar-alt/index.js'
 import { requireFormControlLabel as requireFormControlLabelRule } from './rules/nuxt-ui/require-form-control-label/index.js'
 import { requireFormFieldName as requireFormFieldNameRule } from './rules/nuxt-ui/require-form-field-name/index.js'
-import { requireFormState as requireFormStateRule } from './rules/nuxt-ui/require-form-state/index.js'
 import { requireIconButtonLabel as requireIconButtonLabelRule } from './rules/nuxt-ui/require-icon-button-label/index.js'
 import { requireOverlayTitle as requireOverlayTitleRule } from './rules/nuxt-ui/require-overlay-title/index.js'
 import { requirePopoverContent as requirePopoverContentRule } from './rules/nuxt-ui/require-popover-content/index.js'
@@ -36,25 +32,21 @@ const plugin = eslintCompatPlugin({
     'no-conflicting-state-props': noConflictingStatePropsRule,
     'no-deprecated-components': noDeprecatedComponentsRule,
     'no-deprecated-model-modifiers': noDeprecatedModelModifiersRule,
-    'no-invalid-icon-name': noInvalidIconNameRule,
     'no-invalid-prop-combinations': noInvalidPropCombinationsRule,
-    'no-invalid-prop-values': noInvalidPropValuesRule,
     'prefer-link-to': preferLinkToRule,
-    'prefer-open-model': preferOpenModelRule,
     'prefer-semantic-colors': preferSemanticColorsRule,
     'prefer-u-button': preferUButtonRule,
-    'prefer-u-dialog': preferUDialogRule,
     'prefer-u-form-controls': preferUFormControlsRule,
     'prefer-u-icon': preferUIconRule,
     'prefer-u-kbd': preferUKbdRule,
     'prefer-u-link': preferULinkRule,
+    'prefer-u-modal': preferUModalRule,
     'prefer-u-progress': preferUProgressRule,
     'prefer-u-separator': preferUSeparatorRule,
     'prefer-u-table': preferUTableRule,
     'require-avatar-alt': requireAvatarAltRule,
     'require-form-control-label': requireFormControlLabelRule,
     'require-form-field-name': requireFormFieldNameRule,
-    'require-form-state': requireFormStateRule,
     'require-icon-button-label': requireIconButtonLabelRule,
     'require-overlay-title': requireOverlayTitleRule,
     'require-popover-content': requirePopoverContentRule,
@@ -95,25 +87,21 @@ export function nuxtUiConfigs(options: NuxtUiConfigsOptions = {}): Linter.Config
         '@nustack/nuxt-ui/no-conflicting-state-props': 'warn',
         '@nustack/nuxt-ui/no-deprecated-components': 'warn',
         '@nustack/nuxt-ui/no-deprecated-model-modifiers': 'warn',
-        '@nustack/nuxt-ui/no-invalid-icon-name': 'warn',
         '@nustack/nuxt-ui/no-invalid-prop-combinations': 'warn',
-        '@nustack/nuxt-ui/no-invalid-prop-values': 'warn',
         '@nustack/nuxt-ui/prefer-link-to': 'warn',
-        '@nustack/nuxt-ui/prefer-open-model': 'warn',
         '@nustack/nuxt-ui/prefer-semantic-colors': 'warn',
         '@nustack/nuxt-ui/prefer-u-button': 'warn',
-        '@nustack/nuxt-ui/prefer-u-dialog': 'warn',
         '@nustack/nuxt-ui/prefer-u-form-controls': 'warn',
         '@nustack/nuxt-ui/prefer-u-icon': 'warn',
         '@nustack/nuxt-ui/prefer-u-kbd': 'warn',
         '@nustack/nuxt-ui/prefer-u-link': 'warn',
+        '@nustack/nuxt-ui/prefer-u-modal': 'warn',
         '@nustack/nuxt-ui/prefer-u-progress': 'warn',
         '@nustack/nuxt-ui/prefer-u-separator': 'warn',
         '@nustack/nuxt-ui/prefer-u-table': 'warn',
         '@nustack/nuxt-ui/require-avatar-alt': 'warn',
         '@nustack/nuxt-ui/require-form-control-label': 'warn',
         '@nustack/nuxt-ui/require-form-field-name': 'warn',
-        '@nustack/nuxt-ui/require-form-state': 'warn',
         '@nustack/nuxt-ui/require-icon-button-label': 'warn',
         '@nustack/nuxt-ui/require-overlay-title': 'warn',
         '@nustack/nuxt-ui/require-popover-content': 'warn',
@@ -148,15 +136,12 @@ export const preferUTable: Rule.RuleModule = plugin.rules!['prefer-u-table'] as
 export const noDeprecatedComponents: Rule.RuleModule = plugin.rules!['no-deprecated-components'] as Rule.RuleModule
 export const noDeprecatedModelModifiers: Rule.RuleModule = plugin.rules!['no-deprecated-model-modifiers'] as Rule.RuleModule
 export const noConflictingStateProps: Rule.RuleModule = plugin.rules!['no-conflicting-state-props'] as Rule.RuleModule
-export const noInvalidIconName: Rule.RuleModule = plugin.rules!['no-invalid-icon-name'] as Rule.RuleModule
 export const noInvalidPropCombinations: Rule.RuleModule = plugin.rules!['no-invalid-prop-combinations'] as Rule.RuleModule
-export const noInvalidPropValues: Rule.RuleModule = plugin.rules!['no-invalid-prop-values'] as Rule.RuleModule
 export const preferLinkTo: Rule.RuleModule = plugin.rules!['prefer-link-to'] as Rule.RuleModule
-export const preferOpenModel: Rule.RuleModule = plugin.rules!['prefer-open-model'] as Rule.RuleModule
 export const preferSemanticColors: Rule.RuleModule = plugin.rules!['prefer-semantic-colors'] as Rule.RuleModule
 export const preferUIcon: Rule.RuleModule = plugin.rules!['prefer-u-icon'] as Rule.RuleModule
-export const preferUDialog: Rule.RuleModule = plugin.rules!['prefer-u-dialog'] as Rule.RuleModule
 export const preferUKbd: Rule.RuleModule = plugin.rules!['prefer-u-kbd'] as Rule.RuleModule
+export const preferUModal: Rule.RuleModule = plugin.rules!['prefer-u-modal'] as Rule.RuleModule
 export const preferUProgress: Rule.RuleModule = plugin.rules!['prefer-u-progress'] as Rule.RuleModule
 export const preferUSeparator: Rule.RuleModule = plugin.rules!['prefer-u-separator'] as Rule.RuleModule
 export const requirePopoverContent: Rule.RuleModule = plugin.rules!['require-popover-content'] as Rule.RuleModule
@@ -164,7 +149,6 @@ export const requireFormControlLabel: Rule.RuleModule = plugin.rules!['require-f
 export const requireUApp: Rule.RuleModule = plugin.rules!['require-u-app'] as Rule.RuleModule
 export const requireAvatarAlt: Rule.RuleModule = plugin.rules!['require-avatar-alt'] as Rule.RuleModule
 export const requireFormFieldName: Rule.RuleModule = plugin.rules!['require-form-field-name'] as Rule.RuleModule
-export const requireFormState: Rule.RuleModule = plugin.rules!['require-form-state'] as Rule.RuleModule
 export const requireIconButtonLabel: Rule.RuleModule = plugin.rules!['require-icon-button-label'] as Rule.RuleModule
 export const requireOverlayTitle: Rule.RuleModule = plugin.rules!['require-overlay-title'] as Rule.RuleModule
 export const requireTooltipContent: Rule.RuleModule = plugin.rules!['require-tooltip-content'] as Rule.RuleModule
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
index 15e5806..0e4348c 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
@@ -14,3 +14,8 @@ APIs document `default-*` for cases where the caller does not control state.
 <!-- Correct: uncontrolled -->
 <UModal default-open />
 ```
+
+## Further reading
+
+- [Nuxt UI Modal](https://ui.nuxt.com/docs/components/modal)
+- [Nuxt UI Checkbox](https://ui.nuxt.com/docs/components/checkbox)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md
index d17d74e..26a4525 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md
@@ -43,3 +43,7 @@ Register team-specific renames (proper-cased keys), merged onto the built-in tab
   components: { UOldWidget: 'UNewWidget' },
 }]
 ```
+
+## Further reading
+
+- [Migrating to Nuxt UI v4](https://ui.nuxt.com/docs/getting-started/migration/v4)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
index 1323ab4..b98ebd0 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
@@ -30,3 +30,8 @@ Nuxt UI v4 (both convert empty/blank values to `null`; v4 also adds `.optional`
   components: ['uinput', 'utextarea'], // lowercased components to check (replaces the default list)
 }]
 ```
+
+## Further reading
+
+- [Migrating to Nuxt UI v4](https://ui.nuxt.com/docs/getting-started/migration/v4)
+- [Nuxt UI Input](https://ui.nuxt.com/docs/components/input)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.md
deleted file mode 100644
index b43e57e..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# `@nustack/nuxt-ui/no-invalid-icon-name`
-
-Validate static icon props against Nuxt UI's documented `i-<collection>-<icon>` Iconify
-format. Dynamic bindings are accepted because Nuxt UI also supports Vue components.
-
-```vue
-<UIcon name="i-lucide-lightbulb" />
-<UButton icon="i-lucide-search" />
-<UIcon :name="IconLightbulb" />
-```
-
-Register project-specific names with `{ names: ['brand-logo'] }`, or use `data-raw` locally.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.test.ts
deleted file mode 100644
index a392336..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.test.ts
+++ /dev/null
@@ -1,18 +0,0 @@
-import { RuleTester } from 'eslint'
-import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
-
-describe('no-invalid-icon-name', () => {
-  it('checks static Iconify names', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('no-invalid-icon-name', plugin.rules?.['no-invalid-icon-name'] as never, {
-      valid: [
-        { filename: 'component.vue', code: '<template><UIcon name="i-lucide-search" /></template>' },
-        { filename: 'component.vue', code: '<template><UIcon :name="IconSearch" /></template>' },
-        { filename: 'component.vue', code: '<template><UButton icon="brand-logo" /></template>', options: [{ names: ['brand-logo'] }] },
-      ],
-      invalid: [{ filename: 'component.vue', code: '<template><UButton icon="search" /></template>', errors: [{ messageId: 'invalidName' }] }],
-    })
-  })
-})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.ts
deleted file mode 100644
index 6bbf5c6..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-icon-name/index.ts
+++ /dev/null
@@ -1,54 +0,0 @@
-import type { Rule } from '@oxlint/plugins'
-import { docsUrl } from '../../../utils/docs-url.js'
-import { defineTemplateVisitor, hasRawOptOut } from '../utils.js'
-
-const ICON_NAME = /^i-[a-z\d]+-[a-z\d][a-z\d-]*$/i
-
-export const noInvalidIconName: Rule = {
-  meta: {
-    type: 'problem',
-    docs: {
-      description: 'Require valid Iconify-style names in static Nuxt UI icon props.',
-      url: docsUrl('nuxt-ui/no-invalid-icon-name'),
-    },
-    schema: [{
-      type: 'object',
-      properties: {
-        /** Extra exact static names accepted for project-specific icon providers. */
-        names: { type: 'array', items: { type: 'string' } },
-      },
-      additionalProperties: false,
-    }],
-    messages: {
-      invalidName: '`{{ name }}` is not a valid Nuxt UI Iconify name; use `i-<collection>-<icon>` or a dynamic Vue component binding.',
-    },
-  },
-  create(context: any) {
-    const names = new Set<string>(context.options[0]?.names ?? [])
-    return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (!node.name.startsWith('u') || hasRawOptOut(node))
-          return
-
-        for (const attribute of node.startTag.attributes) {
-          if (attribute.directive || !attribute.value)
-            continue
-          const prop = attribute.key.name as string
-          if (prop !== 'name' && !prop.endsWith('icon'))
-            continue
-          // `name` is an icon name only on UIcon; other components use it for form fields.
-          if (prop === 'name' && node.name !== 'uicon')
-            continue
-          const name = attribute.value.value
-          if (!ICON_NAME.test(name) && !names.has(name)) {
-            context.report({
-              loc: attribute.loc ?? node.startTag.loc,
-              messageId: 'invalidName',
-              data: { name },
-            })
-          }
-        }
-      },
-    })
-  },
-}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
index c0b250a..ff6e3cd 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
@@ -11,3 +11,20 @@ Currently covered:
 
 Dynamic values are ignored when the relationship cannot be proven at lint time.
 Use `data-raw` for an intentional low-level exception.
+
+```vue
+<!-- Incorrect -->
+<UFileUpload variant="button" multiple />
+<UFileUpload variant="area" position="outside" />
+<UAccordion type="multiple" collapsible :items="items" />
+
+<!-- Correct -->
+<UFileUpload variant="button" />
+<UFileUpload variant="area" layout="list" position="outside" />
+<UAccordion type="single" collapsible :items="items" />
+```
+
+## Further reading
+
+- [Nuxt UI FileUpload](https://ui.nuxt.com/docs/components/file-upload)
+- [Nuxt UI Accordion](https://ui.nuxt.com/docs/components/accordion)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.md
deleted file mode 100644
index 0d971d4..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# `@nustack/nuxt-ui/no-invalid-prop-values`
-
-Catch statically invalid `color`, `variant`, and `size` values for commonly used Nuxt UI
-components. Dynamic bindings are ignored so custom runtime themes remain possible.
-
-```vue
-<!-- Incorrect: `colour` is not a Nuxt UI color -->
-<UButton color="colour" />
-
-<!-- Correct -->
-<UButton color="primary" variant="outline" size="md" />
-```
-
-Project-specific theme values can be registered without replacing the documented values:
-
-```js
-'@nustack/nuxt-ui/no-invalid-prop-values': ['warn', {
-  values: { UButton: { variant: ['brand'] } },
-}]
-```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.test.ts
deleted file mode 100644
index c78c33d..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.test.ts
+++ /dev/null
@@ -1,24 +0,0 @@
-import { RuleTester } from 'eslint'
-import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
-
-describe('no-invalid-prop-values', () => {
-  it('checks static component values', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('no-invalid-prop-values', plugin.rules?.['no-invalid-prop-values'] as never, {
-      valid: [
-        { filename: 'component.vue', code: '<template><UButton color="primary" variant="outline" size="md" /></template>' },
-        { filename: 'component.vue', code: '<template><UCheckboxGroup variant="table" orientation="horizontal" /></template>' },
-        { filename: 'component.vue', code: '<template><UFileUpload variant="area" layout="list" position="inside" /></template>' },
-        { filename: 'component.vue', code: '<template><UPinInput variant="subtle" size="xl" /></template>' },
-        { filename: 'component.vue', code: '<template><UButton :color="color" /></template>' },
-        { filename: 'component.vue', code: '<template><UButton variant="brand" /></template>', options: [{ values: { UButton: { variant: ['brand'] } } }] },
-      ],
-      invalid: [
-        { filename: 'component.vue', code: '<template><UButton color="brand" /></template>', errors: [{ messageId: 'invalid' }] },
-        { filename: 'component.vue', code: '<template><USlider size="2xl" /></template>', errors: [{ messageId: 'invalid' }] },
-      ],
-    })
-  })
-})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.ts
deleted file mode 100644
index 7097a5d..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-values/index.ts
+++ /dev/null
@@ -1,98 +0,0 @@
-import type { Rule } from '@oxlint/plugins'
-import { docsUrl } from '../../../utils/docs-url.js'
-import { componentName, defineTemplateVisitor } from '../utils.js'
-
-const COLORS = ['error', 'primary', 'secondary', 'success', 'info', 'warning', 'neutral']
-const SIZES = ['3xs', '2xs', 'xs', 'sm', 'md', 'lg', 'xl', '2xl', '3xl']
-
-/** Verified 2026-07-21 against the component API tables on ui.nuxt.com. */
-const VALUES: Record<string, Record<string, string[]>> = {
-  ubutton: { color: COLORS, variant: ['solid', 'outline', 'soft', 'subtle', 'ghost', 'link'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  ubadge: { color: COLORS, variant: ['solid', 'outline', 'soft', 'subtle'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  ualert: { color: COLORS, variant: ['solid', 'outline', 'soft', 'subtle'] },
-  ucard: { variant: ['solid', 'outline', 'soft', 'subtle'] },
-  ucheckbox: { color: COLORS, variant: ['list', 'card'], size: ['xs', 'sm', 'md', 'lg', 'xl'], indicator: ['start', 'end', 'hidden'] },
-  ucheckboxgroup: { color: COLORS, variant: ['list', 'card', 'table'], size: ['xs', 'sm', 'md', 'lg', 'xl'], orientation: ['horizontal', 'vertical'], indicator: ['start', 'end', 'hidden'] },
-  ufileupload: { color: COLORS, variant: ['button', 'area'], size: ['xs', 'sm', 'md', 'lg', 'xl'], layout: ['list', 'grid'], position: ['inside', 'outside'] },
-  uinput: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  uinputdate: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  uinputmenu: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  uinputnumber: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  uinputtags: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  uinputtime: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  utextarea: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  upininput: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  uradiogroup: { color: COLORS, variant: ['list', 'card', 'table'], size: ['xs', 'sm', 'md', 'lg', 'xl'], orientation: ['horizontal', 'vertical'], indicator: ['start', 'end', 'hidden'] },
-  uselect: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  uselectmenu: { color: COLORS, variant: ['outline', 'soft', 'subtle', 'ghost', 'none'], size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  uslider: { color: COLORS, size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  uswitch: { color: COLORS, size: ['xs', 'sm', 'md', 'lg', 'xl'] },
-  uavatar: { size: SIZES },
-}
-
-export const noInvalidPropValues: Rule = {
-  meta: {
-    type: 'problem',
-    docs: {
-      description: 'Disallow statically invalid Nuxt UI component color, variant, and size values.',
-      url: docsUrl('nuxt-ui/no-invalid-prop-values'),
-    },
-    schema: [{
-      type: 'object',
-      properties: {
-        /** Extra static values keyed by component and prop, merged onto the documented v4 values. */
-        values: {
-          type: 'object',
-          additionalProperties: {
-            type: 'object',
-            additionalProperties: { type: 'array', items: { type: 'string' } },
-          },
-        },
-      },
-      additionalProperties: false,
-    }],
-    messages: {
-      invalid: '`{{ value }}` is not a valid `{{ prop }}` for `<{{ component }}>`; use one of: {{ allowed }}.',
-    },
-  },
-  create(context: any) {
-    const values: Record<string, Record<string, string[]>> = {}
-    for (const [component, props] of Object.entries(VALUES))
-      values[component] = Object.fromEntries(Object.entries(props).map(([prop, allowed]) => [prop, [...allowed]]))
-
-    for (const [component, props] of Object.entries(context.options[0]?.values ?? {}) as [string, Record<string, string[]>][]) {
-      const key = component.toLowerCase()
-      const componentValues = values[key] ?? (values[key] = {})
-      for (const [prop, allowed] of Object.entries(props))
-        componentValues[prop] = [...(componentValues[prop] ?? []), ...allowed]
-    }
-
-    return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        const props = values[node.name]
-        if (!props)
-          return
-        for (const attribute of node.startTag.attributes) {
-          if (attribute.directive || !attribute.value)
-            continue
-          const prop = attribute.key.name as string
-          const allowed = props[prop]
-          if (!allowed)
-            continue
-          if (!allowed.includes(attribute.value.value)) {
-            context.report({
-              loc: attribute.loc ?? node.startTag.loc,
-              messageId: 'invalid',
-              data: {
-                value: attribute.value.value,
-                prop,
-                component: componentName(node.name),
-                allowed: allowed.join(', '),
-              },
-            })
-          }
-        }
-      },
-    })
-  },
-}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md
index 16a90ab..9bede8e 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md
@@ -4,8 +4,18 @@ Use `to` on `ULink` and link-capable `UButton` components. It follows Nuxt UI's
 and keeps routing-aware links consistent.
 
 ```vue
+<!-- Incorrect -->
+<UButton href="/settings">Settings</UButton>
+<ULink href="/docs">Docs</ULink>
+
+<!-- Correct -->
 <UButton to="/settings">Settings</UButton>
 <ULink to="/docs">Docs</ULink>
 ```
 
 Use `data-raw` when native `href` behavior is intentional.
+
+## Further reading
+
+- [Nuxt UI Link](https://ui.nuxt.com/docs/components/link)
+- [Nuxt UI Button](https://ui.nuxt.com/docs/components/button)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.md
deleted file mode 100644
index b649e3e..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# `@nustack/nuxt-ui/prefer-open-model`
-
-Use the explicit `open` model on `UModal`, `UDrawer`, `USlideover`, `UPopover`, and
-`UTooltip`. Nuxt UI documents these components with `v-model:open`.
-
-```vue
-<!-- Incorrect -->
-<UModal v-model="open" />
-
-<!-- Correct -->
-<UModal v-model:open="open" />
-```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.test.ts
deleted file mode 100644
index 713138e..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.test.ts
+++ /dev/null
@@ -1,14 +0,0 @@
-import { RuleTester } from 'eslint'
-import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
-
-describe('prefer-open-model', () => {
-  it('requires named open model', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('prefer-open-model', plugin.rules?.['prefer-open-model'] as never, {
-      valid: [{ filename: 'component.vue', code: '<template><UModal v-model:open="open" /></template>' }],
-      invalid: [{ filename: 'component.vue', code: '<template><UModal v-model="open" /></template>', errors: [{ messageId: 'preferOpen' }] }],
-    })
-  })
-})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.ts
deleted file mode 100644
index 3e5995a..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-open-model/index.ts
+++ /dev/null
@@ -1,38 +0,0 @@
-import type { Rule } from '@oxlint/plugins'
-import { docsUrl } from '../../../utils/docs-url.js'
-import { componentName, defineTemplateVisitor } from '../utils.js'
-
-const OPEN_COMPONENTS = new Set(['umodal', 'udrawer', 'uslideover', 'upopover', 'utooltip'])
-
-export const preferOpenModel: Rule = {
-  meta: {
-    type: 'suggestion',
-    docs: {
-      description: 'Use the explicit `open` model for Nuxt UI overlays instead of the ambiguous default model.',
-      url: docsUrl('nuxt-ui/prefer-open-model'),
-    },
-    schema: [],
-    messages: {
-      preferOpen: 'Use `v-model:open` for `<{{ component }}>`; Nuxt UI overlay state is named `open`.',
-    },
-  },
-  create(context: any) {
-    return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (!OPEN_COMPONENTS.has(node.name))
-          return
-        for (const attribute of node.startTag.attributes) {
-          if (attribute.directive
-            && attribute.key.name?.name === 'model'
-            && !attribute.key.argument) {
-            context.report({
-              loc: attribute.loc ?? node.startTag.loc,
-              messageId: 'preferOpen',
-              data: { component: componentName(node.name) },
-            })
-          }
-        }
-      },
-    })
-  },
-}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md
index aafaa21..6735538 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md
@@ -5,3 +5,15 @@ Prefer Nuxt UI's semantic tokens (`text-muted`, `bg-elevated`, `border-default`,
 adapt to the configured theme and dark mode.
 
 Use `data-raw` for a deliberate brand or illustration color.
+
+```vue
+<!-- Incorrect -->
+<div class="border-gray-200 bg-gray-50 text-gray-500" />
+
+<!-- Correct -->
+<div class="border-default bg-elevated text-muted" />
+```
+
+## Further reading
+
+- [Nuxt UI design system](https://ui.nuxt.com/docs/getting-started/theme/design-system)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md
index 7244aa8..93f5fa4 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md
@@ -19,3 +19,7 @@ Prefer Nuxt UI's `<UButton>` over raw `<button>` elements when `@nuxt/ui` is ava
 ```
 
 Use `data-raw` as a local escape hatch when a raw native button is intentional.
+
+## Further reading
+
+- [Nuxt UI Button](https://ui.nuxt.com/docs/components/button)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md
index 99bcb8d..67d7b41 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md
@@ -53,3 +53,9 @@ Both maps are extensible (entries are merged onto the built-ins):
   types: { email: 'UEmailInput' },     // extra input-type → component
 }]
 ```
+
+## Further reading
+
+- [Nuxt UI components](https://ui.nuxt.com/docs/components)
+- [Nuxt UI Input](https://ui.nuxt.com/docs/components/input)
+- [Nuxt UI Form](https://ui.nuxt.com/docs/components/form)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
index 6185349..b144e22 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
@@ -4,5 +4,13 @@ Prefer Nuxt UI's `UIcon` component and its `name` prop over raw Iconify utility
 Use `data-raw` for a deliberate low-level icon implementation.
 
 ```vue
+<!-- Incorrect -->
+<span class="i-lucide-search" />
+
+<!-- Correct -->
 <UIcon name="i-lucide-search" />
 ```
+
+## Further reading
+
+- [Nuxt UI Icon](https://ui.nuxt.com/docs/components/icon)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
index d24eb7a..29f65a3 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
@@ -3,7 +3,15 @@
 Prefer Nuxt UI's `UKbd` over a raw `kbd` element for theme-aware keyboard hints.
 
 ```vue
+<!-- Incorrect -->
+<kbd>K</kbd>
+
+<!-- Correct -->
 <UKbd value="K" />
 ```
 
 Use `data-raw` when native markup is intentional.
+
+## Further reading
+
+- [Nuxt UI Kbd](https://ui.nuxt.com/docs/components/kbd)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md
index cf8b86b..f5bd711 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md
@@ -22,3 +22,7 @@ drop-in for an anchor.
 
 Use `data-raw` as a local escape hatch when a raw native anchor is intentional (e.g. a
 `mailto:` or external download link you don't want routed).
+
+## Further reading
+
+- [Nuxt UI Link](https://ui.nuxt.com/docs/components/link)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md
similarity index 66%
rename from packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.md
rename to packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md
index 92be15b..60b6765 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md
@@ -1,9 +1,13 @@
-# `@nustack/nuxt-ui/prefer-u-dialog`
+# `@nustack/nuxt-ui/prefer-u-modal`
 
 Prefer `UModal` over a raw `dialog` element. `UModal` supplies Nuxt UI styling and Reka UI
 dialog behavior, including focus management and screen-reader semantics.
 
 ```vue
+<!-- Incorrect -->
+<dialog open>Confirm deletion?</dialog>
+
+<!-- Correct -->
 <UModal title="Confirm deletion">
   <template #body>Are you sure?</template>
 </UModal>
@@ -11,3 +15,7 @@ dialog behavior, including focus management and screen-reader semantics.
 
 The migration is structural rather than a direct tag rename. Use `data-raw` for deliberately
 hand-written native dialogs.
+
+## Further reading
+
+- [Nuxt UI Modal](https://ui.nuxt.com/docs/components/modal)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.test.ts
similarity index 80%
rename from packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.test.ts
rename to packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.test.ts
index 4404386..81d0f73 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.test.ts
@@ -3,12 +3,12 @@ import { describe, it } from 'vitest'
 import vueParser from 'vue-eslint-parser'
 import plugin from '../../../index.js'
 
-describe('prefer-u-dialog', () => {
+describe('prefer-u-modal', () => {
   it('prefers UModal', () => {
     const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('prefer-u-dialog', plugin.rules?.['prefer-u-dialog'] as never, {
+    tester.run('prefer-u-modal', plugin.rules?.['prefer-u-modal'] as never, {
       valid: [{ filename: 'component.vue', code: '<template><UModal title="Confirm" /></template>' }],
-      invalid: [{ filename: 'component.vue', code: '<template><dialog>Confirm</dialog></template>', errors: [{ messageId: 'preferUDialog' }] }],
+      invalid: [{ filename: 'component.vue', code: '<template><dialog>Confirm</dialog></template>', errors: [{ messageId: 'preferUModal' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.ts
similarity index 50%
rename from packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.ts
rename to packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.ts
index a7e28a2..86bb2ef 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-dialog/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.ts
@@ -1,8 +1,8 @@
 import { preferUComponent } from '../prefer-u-component.js'
 
-export const preferUDialog = preferUComponent({
+export const preferUModal = preferUComponent({
   nativeTag: 'dialog',
   component: 'UModal',
-  ruleName: 'prefer-u-dialog',
-  messageId: 'preferUDialog',
+  ruleName: 'prefer-u-modal',
+  messageId: 'preferUModal',
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
index 5e2b7b6..44e69f7 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
@@ -3,7 +3,15 @@
 Prefer Nuxt UI's accessible and theme-aware `UProgress` over a raw `progress` element.
 
 ```vue
+<!-- Incorrect -->
+<progress :value="50" max="100" />
+
+<!-- Correct -->
 <UProgress :model-value="50" :max="100" />
 ```
 
 Use `data-raw` when native markup is intentional.
+
+## Further reading
+
+- [Nuxt UI Progress](https://ui.nuxt.com/docs/components/progress)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
index 12fdb20..033b828 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
@@ -4,7 +4,15 @@ Prefer `USeparator` over a raw `hr` element for consistent orientation, color, s
 optional label handling.
 
 ```vue
+<!-- Incorrect -->
+<hr>
+
+<!-- Correct -->
 <USeparator />
 ```
 
 Use `data-raw` when native markup is intentional.
+
+## Further reading
+
+- [Nuxt UI Separator](https://ui.nuxt.com/docs/components/separator)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md
index eae6276..83ea7f4 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md
@@ -27,3 +27,7 @@ whenever a bespoke static table genuinely reads better as markup.
 ```
 
 Use `data-raw` as a local escape hatch when a raw native table is intentional.
+
+## Further reading
+
+- [Nuxt UI Table](https://ui.nuxt.com/docs/components/table)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
index 18bf4b8..dc96722 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
@@ -4,6 +4,16 @@ Require `alt` on image-backed `UAvatar` components. Use `aria-hidden` for an exp
 decorative avatar.
 
 ```vue
+<!-- Incorrect -->
+<UAvatar src="/users/ben.png" />
+
+<!-- Correct: meaningful image -->
 <UAvatar src="/users/ben.png" alt="Benjamin" />
+
+<!-- Correct: decorative image -->
 <UAvatar src="/brand-mark.png" aria-hidden="true" />
 ```
+
+## Further reading
+
+- [Nuxt UI Avatar](https://ui.nuxt.com/docs/components/avatar)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
index bc97f4d..640ce91 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
@@ -2,7 +2,7 @@
 
 Require an accessible name for Nuxt UI form controls. A label may be provided by
 `label`, `legend`, `aria-label`, `aria-labelledby`, the matching slot, or an enclosing
-`UFormField`.
+`UFormField` that has a `label` prop or `#label` slot.
 
 ```vue
 <!-- Incorrect -->
@@ -18,3 +18,8 @@ Require an accessible name for Nuxt UI form controls. A label may be provided by
 
 Dynamic bindings are accepted because their runtime value cannot be proven statically.
 Use `data-raw` for an intentional low-level exception.
+
+## Further reading
+
+- [Nuxt UI FormField](https://ui.nuxt.com/docs/components/form-field)
+- [Nuxt UI CheckboxGroup](https://ui.nuxt.com/docs/components/checkbox-group)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
index 97f5a87..a814101 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
@@ -11,11 +11,13 @@ describe('require-form-control-label', () => {
         { filename: 'component.vue', code: '<template><UInput aria-label="Search" /></template>' },
         { filename: 'component.vue', code: '<template><UCheckboxGroup legend="Theme" /></template>' },
         { filename: 'component.vue', code: '<template><UFormField label="Email"><UInput /></UFormField></template>' },
+        { filename: 'component.vue', code: '<template><UFormField><template #label>Email</template><UInput /></UFormField></template>' },
         { filename: 'component.vue', code: '<template><UInput data-raw /></template>' },
       ],
       invalid: [
         { filename: 'component.vue', code: '<template><UInput placeholder="Search" /></template>', errors: [{ messageId: 'missingLabel' }] },
         { filename: 'component.vue', code: '<template><URadioGroup :items="items" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { filename: 'component.vue', code: '<template><UFormField><UInput /></UFormField></template>', errors: [{ messageId: 'missingLabel' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
index f3b093a..c740100 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
@@ -1,6 +1,6 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentName, defineTemplateVisitor, hasAncestor, hasNonEmptyAttribute, hasRawOptOut, hasSlot } from '../utils.js'
+import { componentName, defineTemplateVisitor, hasNonEmptyAttribute, hasRawOptOut, hasSlot } from '../utils.js'
 
 const FORM_CONTROLS = new Set([
   'ucheckbox',
@@ -24,6 +24,18 @@ const FORM_CONTROLS = new Set([
   'utextarea',
 ])
 
+function hasLabeledFormFieldAncestor(node: any): boolean {
+  let parent = node.parent
+  while (parent) {
+    if (parent.type === 'VElement' && parent.name === 'uformfield') {
+      return hasNonEmptyAttribute(parent, 'label')
+        || hasSlot(parent, 'label')
+    }
+    parent = parent.parent
+  }
+  return false
+}
+
 function hasAccessibleLabel(node: any): boolean {
   return hasNonEmptyAttribute(node, 'label')
     || hasNonEmptyAttribute(node, 'legend')
@@ -31,7 +43,7 @@ function hasAccessibleLabel(node: any): boolean {
     || hasNonEmptyAttribute(node, 'aria-labelledby')
     || hasSlot(node, 'label')
     || hasSlot(node, 'legend')
-    || hasAncestor(node, 'uformfield')
+    || hasLabeledFormFieldAncestor(node)
 }
 
 export const requireFormControlLabel: Rule = {
@@ -43,7 +55,7 @@ export const requireFormControlLabel: Rule = {
     },
     schema: [],
     messages: {
-      missingLabel: 'Add `label`, `legend`, `aria-label`, `aria-labelledby`, or wrap `<{{ component }}>` in `<UFormField>`.',
+      missingLabel: 'Add `label`, `legend`, `aria-label`, `aria-labelledby`, or wrap `<{{ component }}>` in a `<UFormField>` with `label` or a `#label` slot.',
     },
   },
   create(context: any) {
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md
index 8762069..40eb7e6 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md
@@ -5,9 +5,22 @@ schema/custom-validation errors to the correct field. Standalone display-only fo
 are ignored.
 
 ```vue
+<!-- Incorrect: validation errors cannot be matched to this field -->
+<UForm :schema="schema" :state="state">
+  <UFormField label="Email">
+    <UInput v-model="state.email" />
+  </UFormField>
+</UForm>
+
+<!-- Correct -->
 <UForm :schema="schema" :state="state">
   <UFormField name="email" label="Email">
     <UInput v-model="state.email" />
   </UFormField>
 </UForm>
 ```
+
+## Further reading
+
+- [Nuxt UI Form](https://ui.nuxt.com/docs/components/form)
+- [Nuxt UI FormField](https://ui.nuxt.com/docs/components/form-field)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.md
deleted file mode 100644
index 5da5a21..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# `@nustack/nuxt-ui/require-form-state`
-
-Require the reactive `state` prop documented by Nuxt UI's `UForm` API.
-
-```vue
-<!-- Incorrect -->
-<UForm :schema="schema" />
-
-<!-- Correct -->
-<UForm :schema="schema" :state="state" />
-```
-
-Dynamic bindings (`:state`) are accepted.
-Nested forms (`<UForm nested>`) are also accepted because Nuxt UI explicitly makes them
-inherit the parent form's state.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.test.ts
deleted file mode 100644
index 47dbe53..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.test.ts
+++ /dev/null
@@ -1,17 +0,0 @@
-import { RuleTester } from 'eslint'
-import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
-
-describe('require-form-state', () => {
-  it('requires state', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('require-form-state', plugin.rules?.['require-form-state'] as never, {
-      valid: [
-        { filename: 'component.vue', code: '<template><UForm :state="state" /></template>' },
-        { filename: 'component.vue', code: '<template><UForm nested :schema="nestedSchema" /></template>' },
-      ],
-      invalid: [{ filename: 'component.vue', code: '<template><UForm :schema="schema" /></template>', errors: [{ messageId: 'missingState' }] }],
-    })
-  })
-})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.ts
deleted file mode 100644
index 9116132..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-state/index.ts
+++ /dev/null
@@ -1,26 +0,0 @@
-import type { Rule } from '@oxlint/plugins'
-import { docsUrl } from '../../../utils/docs-url.js'
-import { defineTemplateVisitor, hasAttribute } from '../utils.js'
-
-export const requireFormState: Rule = {
-  meta: {
-    type: 'problem',
-    docs: {
-      description: 'Require `state` on Nuxt UI forms so validation and field binding have a reactive source of truth.',
-      url: docsUrl('nuxt-ui/require-form-state'),
-    },
-    schema: [],
-    messages: {
-      missingState: 'Nuxt UI `<UForm>` requires a `state` prop; pass the reactive form state explicitly.',
-    },
-  },
-  create(context: any) {
-    return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        // Nested forms explicitly inherit the parent form's state in Nuxt UI.
-        if (node.name === 'uform' && !hasAttribute(node, 'state') && !hasAttribute(node, 'nested'))
-          context.report({ loc: node.startTag.loc, messageId: 'missingState' })
-      },
-    })
-  },
-}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
index 47fb030..908c5a5 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
@@ -1,8 +1,18 @@
 # `@nustack/nuxt-ui/require-icon-button-label`
 
-Icon-only `UButton` instances need an accessible label. `label`, `aria-label`, `title`, or
-visible slot content satisfies the rule.
+Icon-, avatar-, and loading-only `UButton` instances need an accessible label. `label`,
+`aria-label`, `title`, or visible slot content satisfies the rule.
 
 ```vue
+<!-- Incorrect -->
+<UButton icon="i-lucide-search" />
+<UButton loading />
+
+<!-- Correct -->
 <UButton icon="i-lucide-search" aria-label="Search" />
+<UButton loading label="Saving" />
 ```
+
+## Further reading
+
+- [Nuxt UI Button](https://ui.nuxt.com/docs/components/button)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
index a853253..10e3b42 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
@@ -4,14 +4,19 @@ import vueParser from 'vue-eslint-parser'
 import plugin from '../../../index.js'
 
 describe('require-icon-button-label', () => {
-  it('labels icon-only buttons', () => {
+  it('labels icon-, avatar-, and loading-only buttons', () => {
     const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
     tester.run('require-icon-button-label', plugin.rules?.['require-icon-button-label'] as never, {
       valid: [
         { filename: 'component.vue', code: '<template><UButton icon="i-lucide-search" aria-label="Search" /></template>' },
         { filename: 'component.vue', code: '<template><UButton icon="i-lucide-save">Save</UButton></template>' },
+        { filename: 'component.vue', code: '<template><UButton :loading="false" /></template>' },
+      ],
+      invalid: [
+        { filename: 'component.vue', code: '<template><UButton icon="i-lucide-search" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { filename: 'component.vue', code: '<template><UButton :avatar="avatar" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { filename: 'component.vue', code: '<template><UButton loading /></template>', errors: [{ messageId: 'missingLabel' }] },
       ],
-      invalid: [{ filename: 'component.vue', code: '<template><UButton icon="i-lucide-search" /></template>', errors: [{ messageId: 'missingLabel' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
index 0873de6..54a9c16 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
@@ -1,24 +1,36 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { defineTemplateVisitor, hasAttribute, hasMeaningfulText, hasNonEmptyAttribute } from '../utils.js'
+import { defineTemplateVisitor, getAttribute, hasAttribute, hasMeaningfulText, hasNonEmptyAttribute } from '../utils.js'
+
+function canBeLoading(node: any): boolean {
+  const attribute = getAttribute(node, 'loading')
+  if (!attribute)
+    return false
+  if (!attribute.directive)
+    return true
+  const expression = attribute.value?.expression
+  return expression?.type !== 'Literal' || expression.value !== false
+}
 
 export const requireIconButtonLabel: Rule = {
   meta: {
     type: 'problem',
     docs: {
-      description: 'Require an accessible label for icon-only Nuxt UI buttons.',
+      description: 'Require an accessible label for icon-, avatar-, and loading-only Nuxt UI buttons.',
       url: docsUrl('nuxt-ui/require-icon-button-label'),
     },
     schema: [],
     messages: {
-      missingLabel: 'Icon-only `<UButton>` needs `label`, `aria-label`, or an accessible `title`.',
+      missingLabel: 'Icon-, avatar-, or loading-only `<UButton>` needs `label`, `aria-label`, or an accessible `title`.',
     },
   },
   create(context: any) {
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (node.name !== 'ubutton' || (!hasAttribute(node, 'icon') && !hasAttribute(node, 'avatar')))
+        if (node.name !== 'ubutton'
+          || (!hasAttribute(node, 'icon') && !hasAttribute(node, 'avatar') && !canBeLoading(node))) {
           return
+        }
         if (hasNonEmptyAttribute(node, 'label') || hasNonEmptyAttribute(node, 'aria-label')
           || hasNonEmptyAttribute(node, 'title') || hasMeaningfulText(node)) {
           return
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md
index ef0aa14..fa45ae9 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md
@@ -4,6 +4,16 @@ Require an accessible title on `UModal`, `UDrawer`, and `USlideover`. A `title`
 `#title` slot, `aria-label`, or `aria-labelledby` satisfies the rule.
 
 ```vue
+<!-- Incorrect -->
+<UModal><template #body>Delete this project?</template></UModal>
+
+<!-- Correct -->
 <UModal title="Delete project" />
 <UModal><template #title>Delete project</template></UModal>
 ```
+
+## Further reading
+
+- [Nuxt UI Modal](https://ui.nuxt.com/docs/components/modal)
+- [Nuxt UI Drawer](https://ui.nuxt.com/docs/components/drawer)
+- [Nuxt UI Slideover](https://ui.nuxt.com/docs/components/slideover)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md
index cd963a0..8b60bf0 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md
@@ -4,6 +4,12 @@ Require the `#content` slot on `UPopover`. The similarly named `content` prop co
 floating position, collision handling, and alignment; it does not provide displayed content.
 
 ```vue
+<!-- Incorrect: content config is not displayed content -->
+<UPopover :content="{ side: 'right' }">
+  <UButton label="Details" />
+</UPopover>
+
+<!-- Correct -->
 <UPopover>
   <UButton label="Details" />
   <template #content>
@@ -11,3 +17,7 @@ floating position, collision handling, and alignment; it does not provide displa
   </template>
 </UPopover>
 ```
+
+## Further reading
+
+- [Nuxt UI Popover](https://ui.nuxt.com/docs/components/popover)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md
index 1469363..226142d 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md
@@ -4,5 +4,13 @@ Require `text` or a `#content` slot on `UTooltip`. This prevents empty hover tar
 keeps the component useful for keyboard and pointer users.
 
 ```vue
+<!-- Incorrect -->
+<UTooltip><UButton icon="i-lucide-settings" aria-label="Settings" /></UTooltip>
+
+<!-- Correct -->
 <UTooltip text="Open settings"><UButton icon="i-lucide-settings" aria-label="Settings" /></UTooltip>
 ```
+
+## Further reading
+
+- [Nuxt UI Tooltip](https://ui.nuxt.com/docs/components/tooltip)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
index 326103c..10aafd8 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
@@ -5,6 +5,12 @@ configuration, reading direction, body-lock behavior, toasts, tooltips, and prog
 modals/slideovers.
 
 ```vue
+<!-- Incorrect: app.vue without the Nuxt UI provider -->
+<template>
+  <NuxtPage />
+</template>
+
+<!-- Correct -->
 <template>
   <UApp>
     <NuxtPage />
@@ -13,3 +19,7 @@ modals/slideovers.
 ```
 
 Files under `components`, `pages`, and `layouts` are ignored even if named `App.vue`.
+
+## Further reading
+
+- [Nuxt UI App](https://ui.nuxt.com/docs/components/app)

From 5f8376fd9b6c53b985f9a8c9ce487aac102c2bf1 Mon Sep 17 00:00:00 2001
From: norbiros <norbiros@protonmail.com>
Date: Mon, 10 Aug 2026 17:19:51 +0200
Subject: [PATCH 04/12] feat(lint-plugin-nuxt-ecosystem): add
 prefer-u-form-field rule

---
 .../lint-plugin-nuxt-ecosystem/src/index.ts   |  4 +
 .../nuxt-ui/prefer-u-form-field/index.md      | 29 +++++++
 .../nuxt-ui/prefer-u-form-field/index.test.ts | 27 +++++++
 .../nuxt-ui/prefer-u-form-field/index.ts      | 78 +++++++++++++++++++
 4 files changed, 138 insertions(+)
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts

diff --git a/packages/lint-plugin-nuxt-ecosystem/src/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
index 568c357..977c253 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
@@ -8,6 +8,7 @@ import { preferLinkTo as preferLinkToRule } from './rules/nuxt-ui/prefer-link-to
 import { preferSemanticColors as preferSemanticColorsRule } from './rules/nuxt-ui/prefer-semantic-colors/index.js'
 import { preferUButton as preferUButtonRule } from './rules/nuxt-ui/prefer-u-button/index.js'
 import { preferUFormControls as preferUFormControlsRule } from './rules/nuxt-ui/prefer-u-form-controls/index.js'
+import { preferUFormField as preferUFormFieldRule } from './rules/nuxt-ui/prefer-u-form-field/index.js'
 import { preferUIcon as preferUIconRule } from './rules/nuxt-ui/prefer-u-icon/index.js'
 import { preferUKbd as preferUKbdRule } from './rules/nuxt-ui/prefer-u-kbd/index.js'
 import { preferULink as preferULinkRule } from './rules/nuxt-ui/prefer-u-link/index.js'
@@ -37,6 +38,7 @@ const plugin = eslintCompatPlugin({
     'prefer-semantic-colors': preferSemanticColorsRule,
     'prefer-u-button': preferUButtonRule,
     'prefer-u-form-controls': preferUFormControlsRule,
+    'prefer-u-form-field': preferUFormFieldRule,
     'prefer-u-icon': preferUIconRule,
     'prefer-u-kbd': preferUKbdRule,
     'prefer-u-link': preferULinkRule,
@@ -92,6 +94,7 @@ export function nuxtUiConfigs(options: NuxtUiConfigsOptions = {}): Linter.Config
         '@nustack/nuxt-ui/prefer-semantic-colors': 'warn',
         '@nustack/nuxt-ui/prefer-u-button': 'warn',
         '@nustack/nuxt-ui/prefer-u-form-controls': 'warn',
+        '@nustack/nuxt-ui/prefer-u-form-field': 'warn',
         '@nustack/nuxt-ui/prefer-u-icon': 'warn',
         '@nustack/nuxt-ui/prefer-u-kbd': 'warn',
         '@nustack/nuxt-ui/prefer-u-link': 'warn',
@@ -131,6 +134,7 @@ plugin.configs = {
 
 export const preferUButton: Rule.RuleModule = plugin.rules!['prefer-u-button'] as Rule.RuleModule
 export const preferUFormControls: Rule.RuleModule = plugin.rules!['prefer-u-form-controls'] as Rule.RuleModule
+export const preferUFormField: Rule.RuleModule = plugin.rules!['prefer-u-form-field'] as Rule.RuleModule
 export const preferULink: Rule.RuleModule = plugin.rules!['prefer-u-link'] as Rule.RuleModule
 export const preferUTable: Rule.RuleModule = plugin.rules!['prefer-u-table'] as Rule.RuleModule
 export const noDeprecatedComponents: Rule.RuleModule = plugin.rules!['no-deprecated-components'] as Rule.RuleModule
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md
new file mode 100644
index 0000000..8ed003f
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md
@@ -0,0 +1,29 @@
+# `@nustack/nuxt-ui/prefer-u-form-field`
+
+Prefer `<UFormField>` over hand-written label/control pairs. `UFormField` consistently
+connects labels, hints, errors, required state, and accessibility metadata to Nuxt UI form
+controls such as `<UInput>`.
+
+The rule reports a `<label>` when it wraps a known native or Nuxt UI form control, or when
+its static `for` value matches the static `id` of one. It does not report standalone
+label-like text or labels targeting non-form elements. Use `data-raw` as a local escape
+hatch when a native label is intentional.
+
+## Incorrect
+
+```vue
+<template>
+  <label for="email">Email</label>
+  <UInput id="email" v-model="email" />
+</template>
+```
+
+## Correct
+
+```vue
+<template>
+  <UFormField label="Email" name="email">
+    <UInput v-model="email" />
+  </UFormField>
+</template>
+```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.test.ts
new file mode 100644
index 0000000..75e5cc4
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.test.ts
@@ -0,0 +1,27 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../../index.js'
+
+const rule = plugin.rules?.['prefer-u-form-field']
+
+describe('prefer-u-form-field', () => {
+  it('reports identifiable hand-written label/control pairs', () => {
+    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
+
+    tester.run('prefer-u-form-field', rule as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UFormField label="Email"><UInput /></UFormField></template>' },
+        { filename: 'component.vue', code: '<template><label>Decorative text</label></template>' },
+        { filename: 'component.vue', code: '<template><label for="panel">Panel</label><section id="panel" /></template>' },
+        { filename: 'component.vue', code: '<template><label for="missing">External control</label></template>' },
+        { filename: 'component.vue', code: '<template><label for="email" data-raw>Email</label><input id="email"></template>' },
+      ],
+      invalid: [
+        { filename: 'component.vue', code: '<template><label>Email <UInput /></label></template>', errors: [{ messageId: 'preferUFormField' }] },
+        { filename: 'component.vue', code: '<template><label><span>Name</span><input></label></template>', errors: [{ messageId: 'preferUFormField' }] },
+        { filename: 'component.vue', code: '<template><label for="country">Country</label><USelect id="country" /></template>', errors: [{ messageId: 'preferUFormField' }] },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts
new file mode 100644
index 0000000..ed5fa08
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts
@@ -0,0 +1,78 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, hasRawOptOut } from '../utils.js'
+
+const FORM_CONTROLS = new Set([
+  'input',
+  'select',
+  'textarea',
+  'ucheckbox',
+  'ucolorpicker',
+  'ufileupload',
+  'uinput',
+  'uinputdate',
+  'uinputnumber',
+  'uinputtime',
+  'uradiogroup',
+  'uselect',
+  'uslider',
+  'uswitch',
+  'utextarea',
+])
+
+function containsFormControl(node: any): boolean {
+  return node.children.some((child: any) =>
+    child.type === 'VElement' && (FORM_CONTROLS.has(child.name) || containsFormControl(child)),
+  )
+}
+
+function staticAttribute(node: any, name: string): string | null {
+  const attribute = node.startTag.attributes.find(
+    (candidate: any) => !candidate.directive && candidate.key.name === name && candidate.value,
+  )
+  return attribute?.value.value ?? null
+}
+
+function hasControlWithId(node: any, id: string): boolean {
+  if (node.type === 'VElement' && FORM_CONTROLS.has(node.name) && staticAttribute(node, 'id') === id)
+    return true
+  return node.children?.some((child: any) => hasControlWithId(child, id)) ?? false
+}
+
+function documentRoot(node: any): any {
+  let root = node
+  while (root.parent)
+    root = root.parent
+  return root
+}
+
+export const preferUFormField: Rule = {
+  meta: {
+    type: 'suggestion',
+    docs: {
+      description: 'Prefer UFormField over hand-written label and form-control pairs.',
+      url: docsUrl('nuxt-ui/prefer-u-form-field'),
+    },
+    schema: [],
+    messages: {
+      preferUFormField: 'Use `<UFormField label="...">` for this labelled control; add `data-raw` when a native label is intentional.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (node.name !== 'label' || hasRawOptOut(node))
+          return
+
+        if (containsFormControl(node)) {
+          context.report({ loc: node.startTag.loc, messageId: 'preferUFormField' })
+          return
+        }
+
+        const id = staticAttribute(node, 'for')
+        if (id && hasControlWithId(documentRoot(node), id))
+          context.report({ loc: node.startTag.loc, messageId: 'preferUFormField' })
+      },
+    })
+  },
+}

From 404a2f0afe018fd8eca9b53411a50e365556b49c Mon Sep 17 00:00:00 2001
From: norbiros <norbiros@protonmail.com>
Date: Mon, 10 Aug 2026 17:20:13 +0200
Subject: [PATCH 05/12] feat(lint-plugin-nuxt-ecosystem): add prefer-u-tree
 rule

---
 .../lint-plugin-nuxt-ecosystem/src/index.ts   |  4 ++
 .../src/rules/nuxt-ui/prefer-u-tree/index.md  | 25 ++++++++++
 .../rules/nuxt-ui/prefer-u-tree/index.test.ts | 48 +++++++++++++++++++
 .../src/rules/nuxt-ui/prefer-u-tree/index.ts  | 38 +++++++++++++++
 4 files changed, 115 insertions(+)
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts

diff --git a/packages/lint-plugin-nuxt-ecosystem/src/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
index 977c253..165913b 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
@@ -16,6 +16,7 @@ import { preferUModal as preferUModalRule } from './rules/nuxt-ui/prefer-u-modal
 import { preferUProgress as preferUProgressRule } from './rules/nuxt-ui/prefer-u-progress/index.js'
 import { preferUSeparator as preferUSeparatorRule } from './rules/nuxt-ui/prefer-u-separator/index.js'
 import { preferUTable as preferUTableRule } from './rules/nuxt-ui/prefer-u-table/index.js'
+import { preferUTree as preferUTreeRule } from './rules/nuxt-ui/prefer-u-tree/index.js'
 import { requireAvatarAlt as requireAvatarAltRule } from './rules/nuxt-ui/require-avatar-alt/index.js'
 import { requireFormControlLabel as requireFormControlLabelRule } from './rules/nuxt-ui/require-form-control-label/index.js'
 import { requireFormFieldName as requireFormFieldNameRule } from './rules/nuxt-ui/require-form-field-name/index.js'
@@ -46,6 +47,7 @@ const plugin = eslintCompatPlugin({
     'prefer-u-progress': preferUProgressRule,
     'prefer-u-separator': preferUSeparatorRule,
     'prefer-u-table': preferUTableRule,
+    'prefer-u-tree': preferUTreeRule,
     'require-avatar-alt': requireAvatarAltRule,
     'require-form-control-label': requireFormControlLabelRule,
     'require-form-field-name': requireFormFieldNameRule,
@@ -102,6 +104,7 @@ export function nuxtUiConfigs(options: NuxtUiConfigsOptions = {}): Linter.Config
         '@nustack/nuxt-ui/prefer-u-progress': 'warn',
         '@nustack/nuxt-ui/prefer-u-separator': 'warn',
         '@nustack/nuxt-ui/prefer-u-table': 'warn',
+        '@nustack/nuxt-ui/prefer-u-tree': 'warn',
         '@nustack/nuxt-ui/require-avatar-alt': 'warn',
         '@nustack/nuxt-ui/require-form-control-label': 'warn',
         '@nustack/nuxt-ui/require-form-field-name': 'warn',
@@ -137,6 +140,7 @@ export const preferUFormControls: Rule.RuleModule = plugin.rules!['prefer-u-form
 export const preferUFormField: Rule.RuleModule = plugin.rules!['prefer-u-form-field'] as Rule.RuleModule
 export const preferULink: Rule.RuleModule = plugin.rules!['prefer-u-link'] as Rule.RuleModule
 export const preferUTable: Rule.RuleModule = plugin.rules!['prefer-u-table'] as Rule.RuleModule
+export const preferUTree: Rule.RuleModule = plugin.rules!['prefer-u-tree'] as Rule.RuleModule
 export const noDeprecatedComponents: Rule.RuleModule = plugin.rules!['no-deprecated-components'] as Rule.RuleModule
 export const noDeprecatedModelModifiers: Rule.RuleModule = plugin.rules!['no-deprecated-model-modifiers'] as Rule.RuleModule
 export const noConflictingStateProps: Rule.RuleModule = plugin.rules!['no-conflicting-state-props'] as Rule.RuleModule
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md
new file mode 100644
index 0000000..2b50ef4
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md
@@ -0,0 +1,25 @@
+# `@nustack/nuxt-ui/prefer-u-tree`
+
+Prefer Nuxt UI's `<UTree>` over a hand-written tree root.
+
+This first implementation reports only an explicit static `role="tree"` on components
+other than `UTree`. It does not infer trees from recursion, list structure, dynamic role
+bindings, drag and drop, or expansion controls.
+
+## Incorrect
+
+```vue
+<ul role="tree">
+  <TreeItem v-for="item in items" :key="item.id" :item="item" />
+</ul>
+```
+
+## Correct
+
+```vue
+<UTree :items="items" />
+```
+
+Add `data-raw` to the tree root when a custom implementation is required. A custom tree
+remains responsible for arrow-key navigation, Home/End behavior, expansion state, focus
+movement, and keyboard-equivalent reordering.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.test.ts
new file mode 100644
index 0000000..9e5010a
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.test.ts
@@ -0,0 +1,48 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import { preferUTree } from './index.js'
+
+const tester = new RuleTester({
+  languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser },
+})
+
+describe('prefer-u-tree', () => {
+  it('reports only explicit static tree roots', () => {
+    tester.run('prefer-u-tree', preferUTree as never, {
+      valid: [
+        { filename: 'component.vue', code: '<template><UTree :items="items" /></template>' },
+        {
+          filename: 'component.vue',
+          code: '<template><UTree role="tree" :items="items" /></template>',
+        },
+        {
+          filename: 'component.vue',
+          code: '<template><ul role="tree" data-raw><li role="treeitem" /></ul></template>',
+        },
+        { filename: 'component.vue', code: '<template><ul :role="role"><li /></ul></template>' },
+        {
+          filename: 'component.vue',
+          code: '<template><ul :role="\'tree\'"><li /></ul></template>',
+        },
+        { filename: 'component.vue', code: '<template><ul role="treegrid"><li /></ul></template>' },
+        {
+          filename: 'component.vue',
+          code: '<template><ul><TreeNode v-for="item in items" :item="item" /></ul></template>',
+        },
+      ],
+      invalid: [
+        {
+          filename: 'component.vue',
+          code: '<template><ul role="tree"><li role="treeitem" /></ul></template>',
+          errors: [{ messageId: 'preferUTree' }],
+        },
+        {
+          filename: 'component.vue',
+          code: '<template><CustomTree role="tree" /></template>',
+          errors: [{ messageId: 'preferUTree' }],
+        },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts
new file mode 100644
index 0000000..5491f23
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts
@@ -0,0 +1,38 @@
+import type { Rule } from '@oxlint/plugins'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, hasRawOptOut } from '../utils.js'
+
+function hasStaticTreeRole(node: any): boolean {
+  return node.startTag.attributes.some(
+    (attribute: any) =>
+      !attribute.directive && attribute.key.name === 'role' && attribute.value?.value === 'tree',
+  )
+}
+
+export const preferUTree: Rule = {
+  meta: {
+    type: 'suggestion',
+    docs: {
+      description: 'Prefer UTree over hand-written elements with an explicit tree role.',
+      url: docsUrl('nuxt-ui/prefer-u-tree'),
+    },
+    schema: [],
+    messages: {
+      preferUTree:
+        'Use `<UTree>` instead of a custom `role="tree"`; custom trees must implement the complete tree keyboard and focus model. Add `data-raw` to keep it.',
+    },
+  },
+  create(context: any) {
+    return defineTemplateVisitor(context, {
+      VElement(node: any) {
+        if (node.name === 'utree' || hasRawOptOut(node) || !hasStaticTreeRole(node))
+          return
+
+        context.report({
+          loc: node.startTag.loc,
+          messageId: 'preferUTree',
+        })
+      },
+    })
+  },
+}

From f9392fadab2467f06cbdc379bcd401a06a7ced45 Mon Sep 17 00:00:00 2001
From: norbiros <norbiros@protonmail.com>
Date: Mon, 10 Aug 2026 17:29:04 +0200
Subject: [PATCH 06/12] refactor(lint-plugin-nuxt-ecosystem): remove
 prefer-semantic-colors rule

This rule was highly opinionated and is not something, that we should
enable for everyone by default. It will be reintroduced in a modified
form in a new PR.
---
 packages/lint-plugin-nuxt-ecosystem/README.md |  1 -
 .../lint-plugin-nuxt-ecosystem/src/index.ts   |  4 --
 .../nuxt-ui/prefer-semantic-colors/index.md   | 19 ----------
 .../prefer-semantic-colors/index.test.ts      | 17 ---------
 .../nuxt-ui/prefer-semantic-colors/index.ts   | 38 -------------------
 5 files changed, 79 deletions(-)
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.test.ts
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.ts

diff --git a/packages/lint-plugin-nuxt-ecosystem/README.md b/packages/lint-plugin-nuxt-ecosystem/README.md
index e6a076c..2fee499 100644
--- a/packages/lint-plugin-nuxt-ecosystem/README.md
+++ b/packages/lint-plugin-nuxt-ecosystem/README.md
@@ -58,7 +58,6 @@ These rules are compatible with Oxlint, although some may not work perfectly due
 | [`@nustack/nuxt-ui/no-deprecated-components`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md) | Disallow Nuxt UI components renamed in v4 (e.g. `UButtonGroup` → `UFieldGroup`). |
 | [`@nustack/nuxt-ui/no-deprecated-model-modifiers`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md) | Disallow the `v-model.nullify` modifier renamed to `.nullable` in Nuxt UI v4. |
 | [`@nustack/nuxt-ui/prefer-link-to`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md) | Prefer `to` over `href` on `ULink` and link-capable `UButton`. |
-| [`@nustack/nuxt-ui/prefer-semantic-colors`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md) | Prefer theme-aware semantic color tokens over hard-coded palette classes. |
 | [`@nustack/nuxt-ui/prefer-u-icon`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md) | Prefer `<UIcon name="...">` over raw Iconify class markup. |
 | [`@nustack/nuxt-ui/require-avatar-alt`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md) | Require alt text on image-backed avatars. |
 | [`@nustack/nuxt-ui/require-form-field-name`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md) | Require `name` or `error-pattern` on form fields inside `<UForm>`. |
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
index 165913b..ad268e9 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
@@ -5,7 +5,6 @@ import { noDeprecatedComponents as noDeprecatedComponentsRule } from './rules/nu
 import { noDeprecatedModelModifiers as noDeprecatedModelModifiersRule } from './rules/nuxt-ui/no-deprecated-model-modifiers/index.js'
 import { noInvalidPropCombinations as noInvalidPropCombinationsRule } from './rules/nuxt-ui/no-invalid-prop-combinations/index.js'
 import { preferLinkTo as preferLinkToRule } from './rules/nuxt-ui/prefer-link-to/index.js'
-import { preferSemanticColors as preferSemanticColorsRule } from './rules/nuxt-ui/prefer-semantic-colors/index.js'
 import { preferUButton as preferUButtonRule } from './rules/nuxt-ui/prefer-u-button/index.js'
 import { preferUFormControls as preferUFormControlsRule } from './rules/nuxt-ui/prefer-u-form-controls/index.js'
 import { preferUFormField as preferUFormFieldRule } from './rules/nuxt-ui/prefer-u-form-field/index.js'
@@ -36,7 +35,6 @@ const plugin = eslintCompatPlugin({
     'no-deprecated-model-modifiers': noDeprecatedModelModifiersRule,
     'no-invalid-prop-combinations': noInvalidPropCombinationsRule,
     'prefer-link-to': preferLinkToRule,
-    'prefer-semantic-colors': preferSemanticColorsRule,
     'prefer-u-button': preferUButtonRule,
     'prefer-u-form-controls': preferUFormControlsRule,
     'prefer-u-form-field': preferUFormFieldRule,
@@ -93,7 +91,6 @@ export function nuxtUiConfigs(options: NuxtUiConfigsOptions = {}): Linter.Config
         '@nustack/nuxt-ui/no-deprecated-model-modifiers': 'warn',
         '@nustack/nuxt-ui/no-invalid-prop-combinations': 'warn',
         '@nustack/nuxt-ui/prefer-link-to': 'warn',
-        '@nustack/nuxt-ui/prefer-semantic-colors': 'warn',
         '@nustack/nuxt-ui/prefer-u-button': 'warn',
         '@nustack/nuxt-ui/prefer-u-form-controls': 'warn',
         '@nustack/nuxt-ui/prefer-u-form-field': 'warn',
@@ -146,7 +143,6 @@ export const noDeprecatedModelModifiers: Rule.RuleModule = plugin.rules!['no-dep
 export const noConflictingStateProps: Rule.RuleModule = plugin.rules!['no-conflicting-state-props'] as Rule.RuleModule
 export const noInvalidPropCombinations: Rule.RuleModule = plugin.rules!['no-invalid-prop-combinations'] as Rule.RuleModule
 export const preferLinkTo: Rule.RuleModule = plugin.rules!['prefer-link-to'] as Rule.RuleModule
-export const preferSemanticColors: Rule.RuleModule = plugin.rules!['prefer-semantic-colors'] as Rule.RuleModule
 export const preferUIcon: Rule.RuleModule = plugin.rules!['prefer-u-icon'] as Rule.RuleModule
 export const preferUKbd: Rule.RuleModule = plugin.rules!['prefer-u-kbd'] as Rule.RuleModule
 export const preferUModal: Rule.RuleModule = plugin.rules!['prefer-u-modal'] as Rule.RuleModule
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md
deleted file mode 100644
index 6735538..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# `@nustack/nuxt-ui/prefer-semantic-colors`
-
-Prefer Nuxt UI's semantic tokens (`text-muted`, `bg-elevated`, `border-default`,
-`text-success`, and similar) over hard-coded Tailwind palette classes. Semantic tokens
-adapt to the configured theme and dark mode.
-
-Use `data-raw` for a deliberate brand or illustration color.
-
-```vue
-<!-- Incorrect -->
-<div class="border-gray-200 bg-gray-50 text-gray-500" />
-
-<!-- Correct -->
-<div class="border-default bg-elevated text-muted" />
-```
-
-## Further reading
-
-- [Nuxt UI design system](https://ui.nuxt.com/docs/getting-started/theme/design-system)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.test.ts
deleted file mode 100644
index 68c8fe4..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.test.ts
+++ /dev/null
@@ -1,17 +0,0 @@
-import { RuleTester } from 'eslint'
-import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
-
-describe('prefer-semantic-colors', () => {
-  it('prefers semantic tokens', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('prefer-semantic-colors', plugin.rules?.['prefer-semantic-colors'] as never, {
-      valid: [{ filename: 'component.vue', code: '<template><div class="text-muted bg-elevated" /></template>' }],
-      invalid: [
-        { filename: 'component.vue', code: '<template><div class="text-gray-500" /></template>', errors: [{ messageId: 'semantic' }] },
-        { filename: 'component.vue', code: '<template><div class="dark:ring-zinc-800/50" /></template>', errors: [{ messageId: 'semantic' }] },
-      ],
-    })
-  })
-})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.ts
deleted file mode 100644
index 9cb3d26..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-semantic-colors/index.ts
+++ /dev/null
@@ -1,38 +0,0 @@
-import type { Rule } from '@oxlint/plugins'
-import { docsUrl } from '../../../utils/docs-url.js'
-import { defineTemplateVisitor, getStaticAttribute, hasRawOptOut } from '../utils.js'
-
-const PALETTE = '(?:slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose|black|white)'
-const PALETTE_CLASS = new RegExp(`^(?:text|bg|border|ring|divide|outline|decoration|placeholder)-${PALETTE}(?:-\\d+)?(?:/\\d+)?$`)
-
-export const preferSemanticColors: Rule = {
-  meta: {
-    type: 'suggestion',
-    docs: {
-      description: 'Prefer Nuxt UI semantic color utilities over hard-coded Tailwind palette classes.',
-      url: docsUrl('nuxt-ui/prefer-semantic-colors'),
-    },
-    schema: [],
-    messages: {
-      semantic: 'Prefer a Nuxt UI semantic color token (for example `text-muted`, `bg-elevated`, or `border-default`) over `{{ className }}`.',
-    },
-  },
-  create(context: any) {
-    return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (hasRawOptOut(node))
-          return
-        const classes = getStaticAttribute(node, 'class')
-        if (!classes)
-          return
-        for (const className of classes.split(/\s+/)) {
-          const utility = className.slice(className.lastIndexOf(':') + 1).replace(/^!/, '')
-          if (PALETTE_CLASS.test(utility)) {
-            context.report({ loc: node.startTag.loc, messageId: 'semantic', data: { className } })
-            break
-          }
-        }
-      },
-    })
-  },
-}

From 9a1e59e5c040862adf7ec86730d324a66368bb51 Mon Sep 17 00:00:00 2001
From: norbiros <norbiros@protonmail.com>
Date: Mon, 10 Aug 2026 17:38:19 +0200
Subject: [PATCH 07/12] docs(lint-plugin-nuxt-ecosystem): update rule registry

---
 packages/lint-plugin-nuxt-ecosystem/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/lint-plugin-nuxt-ecosystem/README.md b/packages/lint-plugin-nuxt-ecosystem/README.md
index 2fee499..497b6ee 100644
--- a/packages/lint-plugin-nuxt-ecosystem/README.md
+++ b/packages/lint-plugin-nuxt-ecosystem/README.md
@@ -50,11 +50,13 @@ These rules are compatible with Oxlint, although some may not work perfectly due
 | [`@nustack/nuxt-ui/no-invalid-prop-combinations`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md) | Disallow documented incompatible prop combinations such as `UFileUpload variant="button" multiple`. |
 | [`@nustack/nuxt-ui/prefer-u-modal`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md) | Prefer `<UModal>` over raw `<dialog>`. |
 | [`@nustack/nuxt-ui/prefer-u-form-controls`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md) | Prefer Nuxt UI form controls over raw native form elements; type-aware (e.g. `<input type="number">` / `<UInput type="number">` → `<UInputNumber>`). |
+| [`@nustack/nuxt-ui/prefer-u-form-field`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md) | Prefer `<UFormField>` over identifiable hand-written label and form-control pairs. |
 | [`@nustack/nuxt-ui/prefer-u-link`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md) | Prefer `<ULink>` over raw `<a>` when `@nuxt/ui` is available. |
 | [`@nustack/nuxt-ui/prefer-u-kbd`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md) | Prefer `<UKbd>` over raw `<kbd>`. |
 | [`@nustack/nuxt-ui/prefer-u-progress`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md) | Prefer `<UProgress>` over raw `<progress>`. |
 | [`@nustack/nuxt-ui/prefer-u-separator`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md) | Prefer `<USeparator>` over raw `<hr>`. |
 | [`@nustack/nuxt-ui/prefer-u-table`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md) | Prefer `<UTable>` over raw `<table>` when `@nuxt/ui` is available. |
+| [`@nustack/nuxt-ui/prefer-u-tree`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md) | Prefer `<UTree>` over hand-written elements with explicit tree semantics. |
 | [`@nustack/nuxt-ui/no-deprecated-components`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md) | Disallow Nuxt UI components renamed in v4 (e.g. `UButtonGroup` → `UFieldGroup`). |
 | [`@nustack/nuxt-ui/no-deprecated-model-modifiers`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md) | Disallow the `v-model.nullify` modifier renamed to `.nullable` in Nuxt UI v4. |
 | [`@nustack/nuxt-ui/prefer-link-to`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md) | Prefer `to` over `href` on `ULink` and link-capable `UButton`. |

From 9d9ad5f515dc7a8d05ab15b408883395ee1ffb4b Mon Sep 17 00:00:00 2001
From: norbiros <norbiros@protonmail.com>
Date: Mon, 10 Aug 2026 19:24:00 +0200
Subject: [PATCH 08/12] fix(lint-plugin-nuxt-ecosystem): identify components by
 identity, not tag name

---
 modules/lint/src/addon.ts                     |   1 +
 modules/lint/src/configs/nuxt-ecosystem.ts    |   5 +-
 modules/lint/src/context/detect.ts            |   5 +-
 modules/lint/src/context/index.ts             |   5 +
 modules/lint/test/e2e.test.ts                 |   1 +
 modules/lint/test/enforce.test.ts             |   1 +
 modules/lint/test/style.test.ts               |   1 +
 modules/lint/test/targets.test.ts             |   2 +
 .../lint-plugin-nuxt-ecosystem/src/index.ts   |  42 ++---
 .../rules/nuxt-ui/component-matcher.test.ts   | 132 +++++++++++++
 .../src/rules/nuxt-ui/component-matcher.ts    | 175 ++++++++++++++++++
 .../no-conflicting-state-props/index.md       |   3 +
 .../no-conflicting-state-props/index.ts       |  14 +-
 .../nuxt-ui/no-deprecated-components/index.md |   6 +-
 .../nuxt-ui/no-deprecated-components/index.ts |  72 +++----
 .../no-deprecated-model-modifiers/index.md    |   3 +-
 .../index.test.ts                             |   2 +-
 .../no-deprecated-model-modifiers/index.ts    |  24 ++-
 .../no-invalid-prop-combinations/index.ts     |   9 +-
 .../src/rules/nuxt-ui/prefer-link-to/index.ts |  14 +-
 .../nuxt-ui/prefer-u-form-controls/index.ts   |  20 +-
 .../nuxt-ui/prefer-u-form-field/index.ts      |  56 +++---
 .../src/rules/nuxt-ui/prefer-u-tree/index.ts  |   7 +-
 .../rules/nuxt-ui/require-avatar-alt/index.ts |   7 +-
 .../require-form-control-label/index.ts       |  58 +++---
 .../nuxt-ui/require-form-field-name/index.ts  |  11 +-
 .../require-icon-button-label/index.ts        |   7 +-
 .../nuxt-ui/require-overlay-title/index.ts    |   9 +-
 .../nuxt-ui/require-popover-content/index.ts  |   7 +-
 .../nuxt-ui/require-tooltip-content/index.ts  |   7 +-
 .../src/rules/nuxt-ui/require-u-app/index.ts  |  16 +-
 .../src/rules/nuxt-ui/utils.ts                |  20 +-
 32 files changed, 549 insertions(+), 193 deletions(-)
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.ts

diff --git a/modules/lint/src/addon.ts b/modules/lint/src/addon.ts
index cacba78..cbcd99c 100644
--- a/modules/lint/src/addon.ts
+++ b/modules/lint/src/addon.ts
@@ -84,6 +84,7 @@ export function setupNustackContext(nuxt: Nuxt): void {
   async function buildContext(): Promise<NustackContext> {
     return {
       modules: detectModules(),
+      nuxtUi: { prefix: (nuxt.options as any).ui?.prefix ?? 'U' },
       tailwind: await detectTailwind(),
       autoImports: await collectAutoImports(),
       components,
diff --git a/modules/lint/src/configs/nuxt-ecosystem.ts b/modules/lint/src/configs/nuxt-ecosystem.ts
index 1cfb14f..7f55657 100644
--- a/modules/lint/src/configs/nuxt-ecosystem.ts
+++ b/modules/lint/src/configs/nuxt-ecosystem.ts
@@ -19,6 +19,9 @@ export function nuxtEcosystemConfig(
   options: NuxtEcosystemOptions = {},
 ): Linter.Config[] {
   return isEnabled(options.nuxtUi, context.modules.nuxtUi)
-    ? nuxtUiConfigs({ rules: resolveConcernRules(subOptions(options.nuxtUi)) })
+    ? nuxtUiConfigs({
+        prefix: context.nuxtUi.prefix,
+        rules: resolveConcernRules(subOptions(options.nuxtUi)),
+      })
     : []
 }
diff --git a/modules/lint/src/context/detect.ts b/modules/lint/src/context/detect.ts
index b181e24..beeb38d 100644
--- a/modules/lint/src/context/detect.ts
+++ b/modules/lint/src/context/detect.ts
@@ -59,6 +59,7 @@ export function detectStandaloneContext(cwd: string = process.cwd()): NustackCon
 
   return {
     modules: resolveModuleFlags(installedModules),
+    nuxtUi: { ...EMPTY_CONTEXT.nuxtUi },
     tailwind: detectTailwind(cwd, resolvable),
     autoImports: [],
     components: [],
@@ -70,8 +71,9 @@ export function detectStandaloneContext(cwd: string = process.cwd()): NustackCon
  * `EMPTY_CONTEXT`. The manual escape hatch for projects where auto-detection isn't
  * enough, e.g. supplying `autoImports`/`components` outside Nuxt.
  */
-export type PartialContext = Partial<Omit<NustackContext, 'modules' | 'tailwind'>> & {
+export type PartialContext = Partial<Omit<NustackContext, 'modules' | 'nuxtUi' | 'tailwind'>> & {
   modules?: Partial<NustackContext['modules']>
+  nuxtUi?: Partial<NustackContext['nuxtUi']>
   tailwind?: Partial<NustackContext['tailwind']>
 }
 
@@ -80,6 +82,7 @@ export function createContext(partial: PartialContext = {}): NustackContext {
     ...EMPTY_CONTEXT,
     ...partial,
     modules: { ...EMPTY_CONTEXT.modules, ...partial.modules },
+    nuxtUi: { ...EMPTY_CONTEXT.nuxtUi, ...partial.nuxtUi },
     tailwind: { ...EMPTY_CONTEXT.tailwind, ...partial.tailwind },
   }
 }
diff --git a/modules/lint/src/context/index.ts b/modules/lint/src/context/index.ts
index 1d77bdc..c6bb108 100644
--- a/modules/lint/src/context/index.ts
+++ b/modules/lint/src/context/index.ts
@@ -5,6 +5,10 @@ export interface NustackContext {
     /** MDC-capable Markdown renderer (`@nuxt/content`, `@comark/nuxt`, or legacy `@nuxtjs/mdc`). */
     mdc: boolean
   }
+  nuxtUi: {
+    /** Component prefix from `ui.prefix`, needed to recognise `<UButton>` and friends. */
+    prefix: string
+  }
   tailwind: {
     detected: boolean
     /**
@@ -24,6 +28,7 @@ export interface NustackContext {
 
 export const EMPTY_CONTEXT: NustackContext = {
   modules: { nuxtUi: false, mdc: false },
+  nuxtUi: { prefix: 'U' },
   tailwind: { detected: false, entryPoint: null },
   autoImports: [],
   components: [],
diff --git a/modules/lint/test/e2e.test.ts b/modules/lint/test/e2e.test.ts
index f981984..0372371 100644
--- a/modules/lint/test/e2e.test.ts
+++ b/modules/lint/test/e2e.test.ts
@@ -12,6 +12,7 @@ const TAILWIND_ENTRY = fileURLToPath(new URL('./fixtures/tailwind.css', import.m
 
 const CONTEXT: NustackContext = {
   modules: { nuxtUi: true, mdc: false },
+  nuxtUi: { prefix: 'U' },
   tailwind: { detected: true, entryPoint: TAILWIND_ENTRY },
   autoImports: ['ref', 'useRuntimeConfig'],
   components: ['UButton'],
diff --git a/modules/lint/test/enforce.test.ts b/modules/lint/test/enforce.test.ts
index b8374c4..80542de 100644
--- a/modules/lint/test/enforce.test.ts
+++ b/modules/lint/test/enforce.test.ts
@@ -7,6 +7,7 @@ import { applyNustackConfig } from '../src/config'
 
 const FULL_CONTEXT: NustackContext = {
   modules: { nuxtUi: true, mdc: false },
+  nuxtUi: { prefix: 'U' },
   tailwind: { detected: true, entryPoint: 'app/assets/css/main.css' },
   autoImports: ['ref'],
   components: ['UButton'],
diff --git a/modules/lint/test/style.test.ts b/modules/lint/test/style.test.ts
index f8edebb..691d8a4 100644
--- a/modules/lint/test/style.test.ts
+++ b/modules/lint/test/style.test.ts
@@ -7,6 +7,7 @@ import { applyNustackConfig } from '../src/config'
 
 const FULL_CONTEXT: NustackContext = {
   modules: { nuxtUi: true, mdc: false },
+  nuxtUi: { prefix: 'U' },
   tailwind: { detected: true, entryPoint: 'app/assets/css/main.css' },
   autoImports: ['ref'],
   components: ['UButton'],
diff --git a/modules/lint/test/targets.test.ts b/modules/lint/test/targets.test.ts
index 566f8f3..3ff107a 100644
--- a/modules/lint/test/targets.test.ts
+++ b/modules/lint/test/targets.test.ts
@@ -11,6 +11,7 @@ import { resolveTarget } from '../src/target'
 // purely by the target/options under test rather than by missing detection.
 const FULL_CONTEXT: NustackContext = {
   modules: { nuxtUi: true, mdc: false },
+  nuxtUi: { prefix: 'U' },
   tailwind: { detected: true, entryPoint: 'app/assets/css/main.css' },
   autoImports: ['ref'],
   components: ['UButton'],
@@ -89,6 +90,7 @@ describe('target: vue-app', () => {
   it('drops tailwind/nuxtEcosystem when standalone detection finds nothing', async () => {
     const EMPTY: NustackContext = {
       modules: { nuxtUi: false, mdc: false },
+      nuxtUi: { prefix: 'U' },
       tailwind: { detected: false, entryPoint: null },
       autoImports: [],
       components: [],
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
index ad268e9..618c7e1 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
@@ -71,13 +71,23 @@ export const NUXT_UI_GLOB = ['**/*.vue']
 export interface NuxtUiConfigsOptions {
   /** Cumulative variant; `minimal` ships nothing, `recommended` (default) the rule set. */
   variant?: 'minimal' | 'recommended'
+  /** Component prefix from `ui.prefix`. Passed to every rule that resolves components. */
+  prefix?: string
   /** Extra rule overrides, merged onto the Vue-SFC scope. */
   rules?: Linter.RulesRecord
 }
 
+const RULES = Object.keys(plugin.rules!).sort()
+
+/** Whether a rule resolves components, and so takes the `prefix` option. */
+function acceptsPrefix(name: string): boolean {
+  const schema = (plugin.rules![name] as Rule.RuleModule).meta?.schema
+  return Array.isArray(schema) && Boolean((schema[0] as any)?.properties?.prefix)
+}
+
 /** Returns Vue-SFC-scoped Nuxt UI configs. */
 export function nuxtUiConfigs(options: NuxtUiConfigsOptions = {}): Linter.Config[] {
-  const { variant = 'recommended', rules } = options
+  const { variant = 'recommended', prefix = 'U', rules } = options
   const configs: Linter.Config[] = []
 
   if (variant !== 'minimal') {
@@ -85,32 +95,10 @@ export function nuxtUiConfigs(options: NuxtUiConfigsOptions = {}): Linter.Config
       name: 'nustack/nuxt-ui',
       files: NUXT_UI_GLOB,
       plugins: pluginRef,
-      rules: {
-        '@nustack/nuxt-ui/no-conflicting-state-props': 'warn',
-        '@nustack/nuxt-ui/no-deprecated-components': 'warn',
-        '@nustack/nuxt-ui/no-deprecated-model-modifiers': 'warn',
-        '@nustack/nuxt-ui/no-invalid-prop-combinations': 'warn',
-        '@nustack/nuxt-ui/prefer-link-to': 'warn',
-        '@nustack/nuxt-ui/prefer-u-button': 'warn',
-        '@nustack/nuxt-ui/prefer-u-form-controls': 'warn',
-        '@nustack/nuxt-ui/prefer-u-form-field': 'warn',
-        '@nustack/nuxt-ui/prefer-u-icon': 'warn',
-        '@nustack/nuxt-ui/prefer-u-kbd': 'warn',
-        '@nustack/nuxt-ui/prefer-u-link': 'warn',
-        '@nustack/nuxt-ui/prefer-u-modal': 'warn',
-        '@nustack/nuxt-ui/prefer-u-progress': 'warn',
-        '@nustack/nuxt-ui/prefer-u-separator': 'warn',
-        '@nustack/nuxt-ui/prefer-u-table': 'warn',
-        '@nustack/nuxt-ui/prefer-u-tree': 'warn',
-        '@nustack/nuxt-ui/require-avatar-alt': 'warn',
-        '@nustack/nuxt-ui/require-form-control-label': 'warn',
-        '@nustack/nuxt-ui/require-form-field-name': 'warn',
-        '@nustack/nuxt-ui/require-icon-button-label': 'warn',
-        '@nustack/nuxt-ui/require-overlay-title': 'warn',
-        '@nustack/nuxt-ui/require-popover-content': 'warn',
-        '@nustack/nuxt-ui/require-tooltip-content': 'warn',
-        '@nustack/nuxt-ui/require-u-app': 'warn',
-      },
+      rules: Object.fromEntries(RULES.map(name => [
+        `@nustack/nuxt-ui/${name}`,
+        prefix !== 'U' && acceptsPrefix(name) ? ['warn', { prefix }] : 'warn',
+      ])),
     })
   }
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.test.ts
new file mode 100644
index 0000000..c3ca7f1
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.test.ts
@@ -0,0 +1,132 @@
+import { RuleTester } from 'eslint'
+import { describe, it } from 'vitest'
+import vueParser from 'vue-eslint-parser'
+import plugin from '../../index.js'
+
+const tester = new RuleTester({
+  languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser },
+})
+
+const iconButton = plugin.rules?.['require-icon-button-label']
+function sfc(script: string, template: string) {
+  return `<script setup>\n${script}\n</script>\n<template>${template}</template>`
+}
+
+describe('component identification', () => {
+  it('matches every auto-import spelling of a component', () => {
+    tester.run('require-icon-button-label', iconButton as never, {
+      valid: [],
+      invalid: [
+        { filename: 'c.vue', code: '<template><UButton icon="i-lucide-x" /></template>', errors: 1 },
+        { filename: 'c.vue', code: '<template><u-button icon="i-lucide-x" /></template>', errors: 1 },
+        { filename: 'c.vue', code: '<template><LazyUButton icon="i-lucide-x" /></template>', errors: 1 },
+        { filename: 'c.vue', code: '<template><lazy-u-button icon="i-lucide-x" /></template>', errors: 1 },
+      ],
+    })
+  })
+
+  it('honours a configured ui.prefix', () => {
+    tester.run('require-icon-button-label', iconButton as never, {
+      valid: [
+        // `UButton` is not a component when the project prefix is `Nu`.
+        { filename: 'c.vue', code: '<template><UButton icon="i-lucide-x" /></template>', options: [{ prefix: 'Nu' }] },
+      ],
+      invalid: [
+        { filename: 'c.vue', code: '<template><NuButton icon="i-lucide-x" /></template>', options: [{ prefix: 'Nu' }], errors: 1 },
+        { filename: 'c.vue', code: '<template><nu-button icon="i-lucide-x" /></template>', options: [{ prefix: 'Nu' }], errors: 1 },
+        // An empty prefix disables prefixing entirely.
+        { filename: 'c.vue', code: '<template><Button icon="i-lucide-x" /></template>', options: [{ prefix: '' }], errors: 1 },
+      ],
+    })
+  })
+
+  it('follows named imports through an alias', () => {
+    tester.run('require-icon-button-label', iconButton as never, {
+      valid: [
+        // Imported from `#components` but not a Nuxt UI component.
+        { filename: 'c.vue', code: sfc('import { MyThing } from \'#components\'', '<MyThing icon="i-lucide-x" />') },
+      ],
+      invalid: [
+        { filename: 'c.vue', code: sfc('import { UButton as IconButton } from \'#components\'', '<IconButton icon="i-lucide-x" />'), errors: 1 },
+        { filename: 'c.vue', code: sfc('import { UButton as IconButton } from \'@nuxt/ui\'', '<IconButton icon="i-lucide-x" />'), errors: 1 },
+        { filename: 'c.vue', code: sfc('import Btn from \'@nuxt/ui/components/Button.vue\'', '<Btn icon="i-lucide-x" />'), errors: 1 },
+      ],
+    })
+  })
+
+  it('respects local shadowing of a Nuxt UI name', () => {
+    tester.run('require-icon-button-label', iconButton as never, {
+      valid: [
+        { filename: 'c.vue', code: sfc('import UButton from \'./MyButton.vue\'', '<UButton icon="i-lucide-x" />') },
+        { filename: 'c.vue', code: sfc('import { UButton } from \'~/components/ui\'', '<UButton icon="i-lucide-x" />') },
+      ],
+      invalid: [],
+    })
+  })
+
+  it('resolves <component :is> only when the target is static', () => {
+    tester.run('require-icon-button-label', iconButton as never, {
+      valid: [
+        { filename: 'c.vue', code: '<template><component :is="resolved" icon="i-lucide-x" /></template>' },
+        { filename: 'c.vue', code: '<template><component :is="map[key]" icon="i-lucide-x" /></template>' },
+      ],
+      invalid: [
+        { filename: 'c.vue', code: '<template><component is="UButton" icon="i-lucide-x" /></template>', errors: 1 },
+        { filename: 'c.vue', code: '<template><component :is="\'UButton\'" icon="i-lucide-x" /></template>', errors: 1 },
+        { filename: 'c.vue', code: sfc('import { UButton } from \'#components\'', '<component :is="UButton" icon="i-lucide-x" />'), errors: 1 },
+      ],
+    })
+  })
+
+  it('does not mistake native tags for components', () => {
+    tester.run('no-conflicting-state-props', plugin.rules?.['no-conflicting-state-props'] as never, {
+      valid: [
+        { filename: 'c.vue', code: '<template><ul default-value="a" model-value="b" /></template>' },
+        { filename: 'c.vue', code: '<template><use default-open open /></template>' },
+      ],
+      invalid: [
+        { filename: 'c.vue', code: '<template><u-modal default-open open /></template>', errors: 1 },
+        // The conflict is a component-authoring convention, so it is not limited to Nuxt UI.
+        { filename: 'c.vue', code: '<template><UserCard default-value="a" model-value="b" /></template>', errors: 1 },
+      ],
+    })
+  })
+
+  it('reports multi-word components with their real casing', () => {
+    tester.run('require-form-control-label', plugin.rules?.['require-form-control-label'] as never, {
+      valid: [],
+      invalid: [
+        {
+          filename: 'c.vue',
+          code: '<template><UInputMenu :items="items" /></template>',
+          errors: [{ messageId: 'missingLabel', data: { component: 'UInputMenu' } }],
+        },
+        {
+          filename: 'c.vue',
+          code: '<template><u-checkbox-group :items="items" /></template>',
+          errors: [{ messageId: 'missingLabel', data: { component: 'UCheckboxGroup' } }],
+        },
+      ],
+    })
+  })
+
+  it('resolves renamed components across spellings', () => {
+    tester.run('no-deprecated-components', plugin.rules?.['no-deprecated-components'] as never, {
+      valid: [
+        { filename: 'c.vue', code: sfc('import UButtonGroup from \'./ButtonGroup.vue\'', '<UButtonGroup />') },
+      ],
+      invalid: [
+        {
+          filename: 'c.vue',
+          code: '<template><u-button-group /></template>',
+          errors: [{ messageId: 'deprecated', data: { name: 'UButtonGroup', replacement: 'UFieldGroup' } }],
+        },
+        {
+          filename: 'c.vue',
+          code: '<template><LazyUPageMarquee /></template>',
+          errors: [{ messageId: 'deprecated', data: { name: 'UPageMarquee', replacement: 'UMarquee' } }],
+        },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.ts
new file mode 100644
index 0000000..f56d7db
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.ts
@@ -0,0 +1,175 @@
+// `#components` is Nuxt's barrel and also re-exports project components, so names from it still
+// go through prefix resolution rather than being trusted outright.
+const NUXT_UI_MODULE = /^(?:@nuxt\/ui|#ui)(?:\/|$)/
+const AUTO_IMPORT_MODULE = '#components'
+
+const LAZY_PREFIX = 'lazy'
+
+/**
+ * `vue-eslint-parser` lowercases `node.name` but keeps hyphens, so `<UButton>` and `<u-button>`
+ * arrive as `ubutton` and `u-button`. Both normalize to `ubutton`.
+ */
+export function normalizeComponentKey(name: string): string {
+  return name.replaceAll('-', '').toLowerCase()
+}
+
+export interface ComponentMatcher {
+  is: (node: any, name: string) => boolean
+  /** The entry of `names` this element matches, preserving its casing, or `null`. */
+  matchOf: (node: any, names: Iterable<string>) => string | null
+  isOneOf: (node: any, names: Iterable<string>) => boolean
+  hasAncestor: (node: any, name: string) => boolean
+  /** The element's key with `Lazy` and the prefix stripped, or `null` on a mismatch. */
+  keyOf: (node: any) => string | null
+  /** `keyOf` for a bare name, so option tables accept prefixed and unprefixed spellings. */
+  keyOfName: (name: string) => string | null
+  prefixed: (name: string) => string
+  rawName: (node: any) => string
+  isComponent: (node: any) => boolean
+}
+
+export const PREFIX_SCHEMA = {
+  /** Component prefix configured via `ui.prefix`; use `''` when the prefix is disabled. */
+  prefix: { type: 'string' },
+} as const
+
+export function componentOptionsSchema(extraProperties: Record<string, unknown> = {}): unknown[] {
+  return [{
+    type: 'object',
+    properties: { ...PREFIX_SCHEMA, ...extraProperties },
+    additionalProperties: false,
+  }]
+}
+
+/** `rawName` preserves case, `name` is lowercased by the parser. */
+function elementName(node: any): string {
+  return node?.rawName ?? node?.name ?? ''
+}
+
+function dynamicIsName(node: any): string | null {
+  const attribute = node.startTag.attributes.find((candidate: any) => {
+    if (!candidate.directive)
+      return candidate.key.name === 'is'
+    if (candidate.key.name?.name !== 'bind')
+      return false
+    return candidate.key.argument?.type === 'VIdentifier' && candidate.key.argument.name === 'is'
+  })
+  if (!attribute)
+    return null
+  if (!attribute.directive)
+    return attribute.value?.value ?? null
+
+  const expression = attribute.value?.expression
+  if (expression?.type === 'Identifier')
+    return expression.name
+  if (expression?.type === 'Literal' && typeof expression.value === 'string')
+    return expression.value
+  return null
+}
+
+/**
+ * Identifies Nuxt UI components in a template, covering the spellings a plain `node.name`
+ * comparison misses: kebab-case, `Lazy` wrappers, a configured `ui.prefix`, named imports under
+ * an alias, locally shadowed names, and `<component :is>` with a static target.
+ *
+ * Components built at runtime (`defineAsyncComponent`, `resolveComponent`, an `:is` bound to an
+ * expression) and re-exports through an intermediate module are treated as "not Nuxt UI", so they
+ * stay silent instead of producing false positives.
+ */
+export function createComponentMatcher(context: any): ComponentMatcher {
+  const prefix: string = context.options?.[0]?.prefix ?? 'U'
+  const prefixKey = normalizeComponentKey(prefix)
+
+  function stripPrefixes(name: string): string | null {
+    let key = normalizeComponentKey(name)
+    if (key.startsWith(LAZY_PREFIX))
+      key = key.slice(LAZY_PREFIX.length)
+    if (!key.startsWith(prefixKey))
+      return null
+    const stripped = key.slice(prefixKey.length)
+    return stripped.length > 0 ? stripped : null
+  }
+
+  // A `null` value means the name is bound to something definitively not Nuxt UI, which is how
+  // local shadowing (`import UButton from './MyButton.vue'`) suppresses a false positive.
+  const bindings = new Map<string, string | null>()
+  for (const statement of context.sourceCode?.ast?.body ?? []) {
+    if (statement.type !== 'ImportDeclaration' || statement.importKind === 'type')
+      continue
+
+    const source: string = statement.source.value
+    const fromNuxtUi = NUXT_UI_MODULE.test(source)
+    const fromBarrel = source === AUTO_IMPORT_MODULE
+
+    for (const specifier of statement.specifiers) {
+      if (specifier.importKind === 'type')
+        continue
+
+      if (specifier.type === 'ImportSpecifier') {
+        const imported = specifier.imported.name ?? specifier.imported.value
+        bindings.set(
+          specifier.local.name,
+          fromNuxtUi || fromBarrel ? stripPrefixes(imported) : null,
+        )
+        continue
+      }
+
+      if (specifier.type === 'ImportDefaultSpecifier') {
+        // `@nuxt/ui/components/Button.vue` — the file name is the unprefixed component.
+        const file = fromNuxtUi ? source.split('/').pop()?.replace(/\.vue$/, '') : undefined
+        bindings.set(specifier.local.name, file ? normalizeComponentKey(file) : null)
+      }
+    }
+  }
+
+  function effectiveName(node: any): string | null {
+    if (node?.type !== 'VElement')
+      return null
+    const raw = elementName(node)
+    return normalizeComponentKey(raw) === 'component' ? dynamicIsName(node) : raw
+  }
+
+  function keyOf(node: any): string | null {
+    const name = effectiveName(node)
+    if (name === null)
+      return null
+    const bound = bindings.get(name)
+    return bound !== undefined ? bound : stripPrefixes(name)
+  }
+
+  function matchOf(node: any, names: Iterable<string>): string | null {
+    const key = keyOf(node)
+    if (key === null)
+      return null
+    for (const name of names) {
+      if (normalizeComponentKey(name) === key)
+        return name
+    }
+    return null
+  }
+
+  function is(node: any, name: string): boolean {
+    return keyOf(node) === normalizeComponentKey(name)
+  }
+
+  return {
+    is,
+    matchOf,
+    isOneOf: (node, names) => matchOf(node, names) !== null,
+    hasAncestor: (node, name) => {
+      let parent = node.parent
+      while (parent) {
+        if (is(parent, name))
+          return true
+        parent = parent.parent
+      }
+      return false
+    },
+    keyOf,
+    keyOfName: stripPrefixes,
+    prefixed: name => `${prefix}${name}`,
+    rawName: elementName,
+    // Native tags are all-lowercase and unhyphenated; anything else is a component.
+    isComponent: node => /[A-Z-]/.test(elementName(node)),
+  }
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
index 0e4348c..559ce82 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
@@ -4,6 +4,9 @@ Do not combine controlled state (`open`, `v-model:open`, `model-value`, or `v-mo
 the corresponding uncontrolled initializer (`default-open` or `default-value`). Nuxt UI's
 APIs document `default-*` for cases where the caller does not control state.
 
+The pairing is a component-authoring convention rather than a Nuxt UI detail, so the rule
+applies to any component element. Native HTML tags are skipped.
+
 ```vue
 <!-- Incorrect -->
 <UModal v-model:open="open" default-open />
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts
index e63aa19..91e9dd5 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts
@@ -1,6 +1,7 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentName, defineTemplateVisitor, hasAttribute, hasVModel } from '../utils.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
+import { defineTemplateVisitor, hasAttribute, hasVModel } from '../utils.js'
 
 export const noConflictingStateProps: Rule = {
   meta: {
@@ -9,22 +10,25 @@ export const noConflictingStateProps: Rule = {
       description: 'Disallow mixing controlled Nuxt UI state with its uncontrolled default prop.',
       url: docsUrl('nuxt-ui/no-conflicting-state-props'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       conflicting: '`<{{ component }}>` cannot use controlled `{{ controlled }}` together with `{{ uncontrolled }}`; choose one state model.',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (!node.name.startsWith('u'))
+        // A component-authoring convention rather than a Nuxt UI one, so any component qualifies.
+        if (!matcher.isComponent(node))
           return
 
         if (hasAttribute(node, 'default-open') && (hasAttribute(node, 'open') || hasVModel(node, 'open'))) {
           context.report({
             loc: node.startTag.loc,
             messageId: 'conflicting',
-            data: { component: componentName(node.name), controlled: 'open / v-model:open', uncontrolled: 'default-open' },
+            data: { component: matcher.rawName(node), controlled: 'open / v-model:open', uncontrolled: 'default-open' },
           })
         }
 
@@ -32,7 +36,7 @@ export const noConflictingStateProps: Rule = {
           context.report({
             loc: node.startTag.loc,
             messageId: 'conflicting',
-            data: { component: componentName(node.name), controlled: 'model-value / v-model', uncontrolled: 'default-value' },
+            data: { component: matcher.rawName(node), controlled: 'model-value / v-model', uncontrolled: 'default-value' },
           })
         }
       },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md
index 26a4525..46d76d2 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md
@@ -36,11 +36,13 @@ verified against the live v4 docs.
 
 ## Options
 
-Register team-specific renames (proper-cased keys), merged onto the built-in table:
+Register team-specific renames, merged onto the built-in table. Keys accept either spelling
+(`UOldWidget` or `OldWidget`); values are written unprefixed:
 
 ```js
 '@nustack/nuxt-ui/no-deprecated-components': ['warn', {
-  components: { UOldWidget: 'UNewWidget' },
+  components: { UOldWidget: 'NewWidget' },
+  prefix: 'U', // your `ui.prefix`, when it is not the default
 }]
 ```
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts
index 544e748..d4c3ea3 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts
@@ -1,18 +1,16 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher, normalizeComponentKey } from '../component-matcher.js'
 import { defineTemplateVisitor } from '../utils.js'
 
-interface DeprecatedComponent {
-  /** Canonical (proper-cased) name, for the message. */
-  name: string
-  replacement: string
-}
-
-/** Verified 2026-07-21 against the ui.nuxt.com v4 migration guide; re-verify on the next major. */
-const DEPRECATED_COMPONENTS: Record<string, DeprecatedComponent> = {
-  ubuttongroup: { name: 'UButtonGroup', replacement: 'UFieldGroup' },
-  upagemarquee: { name: 'UPageMarquee', replacement: 'UMarquee' },
-  upageaccordion: { name: 'UPageAccordion', replacement: 'UAccordion' },
+/**
+ * Unprefixed `old` → `new` renames.
+ * Verified 2026-07-21 against the ui.nuxt.com v4 migration guide; re-verify on the next major.
+ */
+const DEPRECATED_COMPONENTS: Record<string, string> = {
+  ButtonGroup: 'FieldGroup',
+  PageMarquee: 'Marquee',
+  PageAccordion: 'Accordion',
 }
 
 export const noDeprecatedComponents: Rule = {
@@ -22,35 +20,45 @@ export const noDeprecatedComponents: Rule = {
       description: 'Disallow Nuxt UI components renamed in v4 in favour of their current names.',
       url: docsUrl('nuxt-ui/no-deprecated-components'),
     },
-    schema: [{
-      type: 'object',
-      properties: {
-        /** Extra `OldName` → `NewName` renames, merged onto the built-in v4 table. */
-        components: { type: 'object', additionalProperties: { type: 'string' } },
-      },
-      additionalProperties: false,
-    }],
+    schema: componentOptionsSchema({
+      /**
+       * Extra `OldName` → `NewName` renames merged onto the built-in table. Either spelling of
+       * the key works (`UButtonGroup` or `ButtonGroup`); the value is written unprefixed.
+       */
+      components: { type: 'object', additionalProperties: { type: 'string' } },
+    }),
     messages: {
       deprecated: '`<{{ name }}>` was renamed in Nuxt UI v4, use `<{{ replacement }}>` instead.',
     },
   },
   create(context: any) {
-    // User entries are written proper-cased (`{ UOld: 'UNew' }`) but matched lowercased.
-    const table: Record<string, DeprecatedComponent> = { ...DEPRECATED_COMPONENTS }
-    const extra = context.options[0]?.components ?? {}
-    for (const [name, replacement] of Object.entries(extra) as [string, string][])
-      table[name.toLowerCase()] = { name, replacement }
+    const matcher = createComponentMatcher(context)
+    const prefix: string = context.options[0]?.prefix ?? 'U'
+    const extra: Record<string, string> = context.options[0]?.components ?? {}
+    /** Accepts `UButtonGroup` and `ButtonGroup` alike, so the message never doubles the prefix. */
+    const unprefixed = (name: string) => (name.startsWith(prefix) ? name.slice(prefix.length) : name)
+    const table = new Map<string, { name: string, replacement: string }>(
+      Object.entries({ ...DEPRECATED_COMPONENTS, ...extra }).map(([name, replacement]) => [
+        matcher.keyOfName(name) ?? normalizeComponentKey(name),
+        { name: unprefixed(name), replacement: unprefixed(replacement) },
+      ]),
+    )
 
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        const deprecated = table[node.name]
-        if (deprecated) {
-          context.report({
-            loc: node.startTag.loc,
-            messageId: 'deprecated',
-            data: { name: deprecated.name, replacement: deprecated.replacement },
-          })
-        }
+        const key = matcher.keyOf(node)
+        const deprecated = key === null ? undefined : table.get(key)
+        if (!deprecated)
+          return
+
+        context.report({
+          loc: node.startTag.loc,
+          messageId: 'deprecated',
+          data: {
+            name: matcher.prefixed(deprecated.name),
+            replacement: matcher.prefixed(deprecated.replacement),
+          },
+        })
       },
     })
   },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
index b98ebd0..7e63ff8 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
@@ -27,7 +27,8 @@ Nuxt UI v4 (both convert empty/blank values to `null`; v4 also adds `.optional`
 ```js
 '@nustack/nuxt-ui/no-deprecated-model-modifiers': ['warn', {
   modifiers: { coerce: 'transform' }, // extra old → new renames, merged onto the built-ins
-  components: ['uinput', 'utextarea'], // lowercased components to check (replaces the default list)
+  components: ['Input', 'Textarea'],  // components to check (replaces the default list)
+  prefix: 'U',                        // your `ui.prefix`, when it is not the default
 }]
 ```
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts
index ead921c..ccef606 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts
@@ -22,7 +22,7 @@ describe('no-deprecated-model-modifiers', () => {
         { filename: 'component.vue', code: '<template><UTextarea v-model="value" :model-modifiers="{ nullify: true }" /></template>', errors: [{ messageId: 'preferNullable' }] },
         // Extended via options: extra modifier rename and a custom target component.
         { filename: 'component.vue', code: '<template><UInput v-model.coerce="value" /></template>', options: [{ modifiers: { coerce: 'transform' } }], errors: [{ messageId: 'preferNullable' }] },
-        { filename: 'component.vue', code: '<template><UCustom v-model.nullify="value" /></template>', options: [{ components: ['ucustom'] }], errors: [{ messageId: 'preferNullable' }] },
+        { filename: 'component.vue', code: '<template><UCustom v-model.nullify="value" /></template>', options: [{ components: ['Custom'] }], errors: [{ messageId: 'preferNullable' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts
index 10ef6b9..632898c 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts
@@ -1,5 +1,6 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor } from '../utils.js'
 
 /** Verified 2026-07-21 against the ui.nuxt.com v4 migration guide; re-verify on the next major. */
@@ -7,7 +8,7 @@ const DEPRECATED_MODIFIERS: Record<string, string> = {
   nullify: 'nullable',
 }
 
-const TARGET_COMPONENTS = ['uinput', 'uinputnumber', 'utextarea']
+const TARGET_COMPONENTS = ['Input', 'InputNumber', 'Textarea']
 
 function vModel(node: any): any {
   return node.startTag.attributes.find(
@@ -34,16 +35,12 @@ export const noDeprecatedModelModifiers: Rule = {
       description: 'Disallow the `v-model.nullify` modifier renamed to `.nullable` in Nuxt UI v4.',
       url: docsUrl('nuxt-ui/no-deprecated-model-modifiers'),
     },
-    schema: [{
-      type: 'object',
-      properties: {
-        /** Extra `old` → `new` modifier renames, merged onto the built-in table. */
-        modifiers: { type: 'object', additionalProperties: { type: 'string' } },
-        /** Components to check, lowercased. Replaces the built-in list when provided. */
-        components: { type: 'array', items: { type: 'string' } },
-      },
-      additionalProperties: false,
-    }],
+    schema: componentOptionsSchema({
+      /** Extra `old` → `new` modifier renames, merged onto the built-in table. */
+      modifiers: { type: 'object', additionalProperties: { type: 'string' } },
+      /** Canonical unprefixed names (`'Input'`). Replaces the built-in list when provided. */
+      components: { type: 'array', items: { type: 'string' } },
+    }),
     messages: {
       preferNullable: 'The `v-model.{{ old }}` modifier was renamed in Nuxt UI v4, use `v-model.{{ replacement }}` instead.',
     },
@@ -51,11 +48,12 @@ export const noDeprecatedModelModifiers: Rule = {
   create(context: any) {
     const options = context.options[0] ?? {}
     const modifiers: Record<string, string> = { ...DEPRECATED_MODIFIERS, ...options.modifiers }
-    const targets = new Set<string>(options.components ?? TARGET_COMPONENTS)
+    const matcher = createComponentMatcher(context)
+    const targets: string[] = options.components ?? TARGET_COMPONENTS
 
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (!targets.has(node.name))
+        if (!matcher.isOneOf(node, targets))
           return
 
         const model = vModel(node)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts
index 50944f5..e81c35d 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts
@@ -1,5 +1,6 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor, getStaticAttribute, hasAttribute, hasRawOptOut } from '../utils.js'
 
 interface StaticValue {
@@ -44,7 +45,7 @@ export const noInvalidPropCombinations: Rule = {
       description: 'Disallow documented Nuxt UI prop combinations that cannot work together.',
       url: docsUrl('nuxt-ui/no-invalid-prop-combinations'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       fileButtonMultiple: '`UFileUpload variant="button"` only supports a single file; remove `multiple` or use `variant="area"`.',
       fileLayoutArea: '`UFileUpload layout` is only supported with `variant="area"`.',
@@ -53,12 +54,14 @@ export const noInvalidPropCombinations: Rule = {
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
         if (hasRawOptOut(node))
           return
 
-        if (node.name === 'ufileupload') {
+        if (matcher.is(node, 'FileUpload')) {
           const variant = staticValue(node, 'variant')
           const multiple = staticBoolean(node, 'multiple')
           const layout = staticValue(node, 'layout')
@@ -80,7 +83,7 @@ export const noInvalidPropCombinations: Rule = {
           }
         }
 
-        if (node.name === 'uaccordion') {
+        if (matcher.is(node, 'Accordion')) {
           const type = getStaticAttribute(node, 'type')
           if (type === 'multiple' && hasAttribute(node, 'collapsible'))
             context.report({ loc: node.startTag.loc, messageId: 'accordionCollapsible' })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts
index 2b93868..cb016f4 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts
@@ -1,8 +1,9 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentName, defineTemplateVisitor, hasAttribute, hasRawOptOut } from '../utils.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
+import { defineTemplateVisitor, hasAttribute, hasRawOptOut } from '../utils.js'
 
-const LINK_COMPONENTS = new Set(['ulink', 'ubutton'])
+const LINK_COMPONENTS = new Set(['Link', 'Button'])
 
 export const preferLinkTo: Rule = {
   meta: {
@@ -11,16 +12,19 @@ export const preferLinkTo: Rule = {
       description: 'Prefer Nuxt UI/NuxtLink `to` on link-capable components over `href`.',
       url: docsUrl('nuxt-ui/prefer-link-to'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       preferTo: 'Use `to` instead of `href` on `<{{ component }}>` so Nuxt routing and link props stay consistent.',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (LINK_COMPONENTS.has(node.name) && !hasRawOptOut(node) && hasAttribute(node, 'href') && !hasAttribute(node, 'to'))
-          context.report({ loc: node.startTag.loc, messageId: 'preferTo', data: { component: componentName(node.name) } })
+        const component = matcher.matchOf(node, LINK_COMPONENTS)
+        if (component && !hasRawOptOut(node) && hasAttribute(node, 'href') && !hasAttribute(node, 'to'))
+          context.report({ loc: node.startTag.loc, messageId: 'preferTo', data: { component: matcher.prefixed(component) } })
       },
     })
   },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.ts
index c58f210..a4c2f5c 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.ts
@@ -1,5 +1,6 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor, hasRawOptOut } from '../utils.js'
 
 const CONTROL_MAP: Record<string, string> = {
@@ -35,16 +36,12 @@ export const preferUFormControls: Rule = {
       description: 'Prefer Nuxt UI form controls over raw form elements.',
       url: docsUrl('nuxt-ui/prefer-u-form-controls'),
     },
-    schema: [{
-      type: 'object',
-      properties: {
-        /** Extra `tag` → `Component` mappings, merged onto the built-in native-element map. */
-        controls: { type: 'object', additionalProperties: { type: 'string' } },
-        /** Extra input-`type` → `Component` mappings, merged onto the built-in type map. */
-        types: { type: 'object', additionalProperties: { type: 'string' } },
-      },
-      additionalProperties: false,
-    }],
+    schema: componentOptionsSchema({
+      /** Extra `tag` → `Component` mappings, merged onto the built-in native-element map. */
+      controls: { type: 'object', additionalProperties: { type: 'string' } },
+      /** Extra input-`type` → `Component` mappings, merged onto the built-in type map. */
+      types: { type: 'object', additionalProperties: { type: 'string' } },
+    }),
     messages: {
       preferUFormControl: 'Use `<{{ replacement }}>` instead of `<{{ tag }}>`; add `data-raw` to allow the native element.',
       preferSpecificControl: 'Use `<{{ replacement }}>` instead of `<UInput type="{{ type }}">`; add `data-raw` to allow the native element.',
@@ -54,6 +51,7 @@ export const preferUFormControls: Rule = {
     const options = context.options[0] ?? {}
     const controlMap: Record<string, string> = { ...CONTROL_MAP, ...options.controls }
     const typeMap: Record<string, string> = { ...TYPE_MAP, ...options.types }
+    const matcher = createComponentMatcher(context)
 
     return defineTemplateVisitor(context, {
       VElement(node: any) {
@@ -63,7 +61,7 @@ export const preferUFormControls: Rule = {
         const type = staticType(node)
 
         // `<UInput type="number">`, already Nuxt UI, but a dedicated component fits better.
-        if (node.name === 'uinput') {
+        if (matcher.is(node, 'Input')) {
           const replacement = type ? typeMap[type] : null
           if (replacement) {
             context.report({
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts
index ed5fa08..d470f44 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts
@@ -1,28 +1,34 @@
 import type { Rule } from '@oxlint/plugins'
+import type { ComponentMatcher } from '../component-matcher.js'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor, hasRawOptOut } from '../utils.js'
 
-const FORM_CONTROLS = new Set([
-  'input',
-  'select',
-  'textarea',
-  'ucheckbox',
-  'ucolorpicker',
-  'ufileupload',
-  'uinput',
-  'uinputdate',
-  'uinputnumber',
-  'uinputtime',
-  'uradiogroup',
-  'uselect',
-  'uslider',
-  'uswitch',
-  'utextarea',
+const NATIVE_CONTROLS = new Set(['input', 'select', 'textarea'])
+
+const UI_CONTROLS = new Set([
+  'Checkbox',
+  'ColorPicker',
+  'FileUpload',
+  'Input',
+  'InputDate',
+  'InputNumber',
+  'InputTime',
+  'RadioGroup',
+  'Select',
+  'Slider',
+  'Switch',
+  'Textarea',
 ])
 
-function containsFormControl(node: any): boolean {
+function isFormControl(node: any, matcher: ComponentMatcher): boolean {
+  return NATIVE_CONTROLS.has(node.name) || matcher.isOneOf(node, UI_CONTROLS)
+}
+
+function containsFormControl(node: any, matcher: ComponentMatcher): boolean {
   return node.children.some((child: any) =>
-    child.type === 'VElement' && (FORM_CONTROLS.has(child.name) || containsFormControl(child)),
+    child.type === 'VElement'
+    && (isFormControl(child, matcher) || containsFormControl(child, matcher)),
   )
 }
 
@@ -33,10 +39,10 @@ function staticAttribute(node: any, name: string): string | null {
   return attribute?.value.value ?? null
 }
 
-function hasControlWithId(node: any, id: string): boolean {
-  if (node.type === 'VElement' && FORM_CONTROLS.has(node.name) && staticAttribute(node, 'id') === id)
+function hasControlWithId(node: any, id: string, matcher: ComponentMatcher): boolean {
+  if (node.type === 'VElement' && isFormControl(node, matcher) && staticAttribute(node, 'id') === id)
     return true
-  return node.children?.some((child: any) => hasControlWithId(child, id)) ?? false
+  return node.children?.some((child: any) => hasControlWithId(child, id, matcher)) ?? false
 }
 
 function documentRoot(node: any): any {
@@ -53,24 +59,26 @@ export const preferUFormField: Rule = {
       description: 'Prefer UFormField over hand-written label and form-control pairs.',
       url: docsUrl('nuxt-ui/prefer-u-form-field'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       preferUFormField: 'Use `<UFormField label="...">` for this labelled control; add `data-raw` when a native label is intentional.',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
         if (node.name !== 'label' || hasRawOptOut(node))
           return
 
-        if (containsFormControl(node)) {
+        if (containsFormControl(node, matcher)) {
           context.report({ loc: node.startTag.loc, messageId: 'preferUFormField' })
           return
         }
 
         const id = staticAttribute(node, 'for')
-        if (id && hasControlWithId(documentRoot(node), id))
+        if (id && hasControlWithId(documentRoot(node), id, matcher))
           context.report({ loc: node.startTag.loc, messageId: 'preferUFormField' })
       },
     })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts
index 5491f23..bfc960d 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts
@@ -1,5 +1,6 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor, hasRawOptOut } from '../utils.js'
 
 function hasStaticTreeRole(node: any): boolean {
@@ -16,16 +17,18 @@ export const preferUTree: Rule = {
       description: 'Prefer UTree over hand-written elements with an explicit tree role.',
       url: docsUrl('nuxt-ui/prefer-u-tree'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       preferUTree:
         'Use `<UTree>` instead of a custom `role="tree"`; custom trees must implement the complete tree keyboard and focus model. Add `data-raw` to keep it.',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (node.name === 'utree' || hasRawOptOut(node) || !hasStaticTreeRole(node))
+        if (matcher.is(node, 'Tree') || hasRawOptOut(node) || !hasStaticTreeRole(node))
           return
 
         context.report({
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts
index 2be45d9..651ba68 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts
@@ -1,5 +1,6 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor, hasAttribute } from '../utils.js'
 
 export const requireAvatarAlt: Rule = {
@@ -9,15 +10,17 @@ export const requireAvatarAlt: Rule = {
       description: 'Require alternative text for Nuxt UI avatars that render an image.',
       url: docsUrl('nuxt-ui/require-avatar-alt'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       missingAlt: 'Add `alt` to `<UAvatar>` (or explicitly mark a decorative avatar with `aria-hidden`).',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (node.name !== 'uavatar' || !hasAttribute(node, 'src'))
+        if (!matcher.is(node, 'Avatar') || !hasAttribute(node, 'src'))
           return
         if (!hasAttribute(node, 'alt') && !hasAttribute(node, 'aria-hidden'))
           context.report({ loc: node.startTag.loc, messageId: 'missingAlt' })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
index c740100..6090878 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
@@ -1,33 +1,34 @@
 import type { Rule } from '@oxlint/plugins'
+import type { ComponentMatcher } from '../component-matcher.js'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentName, defineTemplateVisitor, hasNonEmptyAttribute, hasRawOptOut, hasSlot } from '../utils.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
+import { defineTemplateVisitor, hasNonEmptyAttribute, hasRawOptOut, hasSlot } from '../utils.js'
 
 const FORM_CONTROLS = new Set([
-  'ucheckbox',
-  'ucheckboxgroup',
-  'ucolorpicker',
-  'ufileupload',
-  'uinput',
-  'uinputdate',
-  'uinputmenu',
-  'uinputnumber',
-  'uinputrating',
-  'uinputtags',
-  'uinputtime',
-  'ulistbox',
-  'upininput',
-  'uradiogroup',
-  'uselect',
-  'uselectmenu',
-  'uslider',
-  'uswitch',
-  'utextarea',
+  'Checkbox',
+  'CheckboxGroup',
+  'ColorPicker',
+  'FileUpload',
+  'Input',
+  'InputDate',
+  'InputMenu',
+  'InputNumber',
+  'InputTags',
+  'InputTime',
+  'Listbox',
+  'PinInput',
+  'RadioGroup',
+  'Select',
+  'SelectMenu',
+  'Slider',
+  'Switch',
+  'Textarea',
 ])
 
-function hasLabeledFormFieldAncestor(node: any): boolean {
+function hasLabeledFormFieldAncestor(node: any, matcher: ComponentMatcher): boolean {
   let parent = node.parent
   while (parent) {
-    if (parent.type === 'VElement' && parent.name === 'uformfield') {
+    if (matcher.is(parent, 'FormField')) {
       return hasNonEmptyAttribute(parent, 'label')
         || hasSlot(parent, 'label')
     }
@@ -36,14 +37,14 @@ function hasLabeledFormFieldAncestor(node: any): boolean {
   return false
 }
 
-function hasAccessibleLabel(node: any): boolean {
+function hasAccessibleLabel(node: any, matcher: ComponentMatcher): boolean {
   return hasNonEmptyAttribute(node, 'label')
     || hasNonEmptyAttribute(node, 'legend')
     || hasNonEmptyAttribute(node, 'aria-label')
     || hasNonEmptyAttribute(node, 'aria-labelledby')
     || hasSlot(node, 'label')
     || hasSlot(node, 'legend')
-    || hasLabeledFormFieldAncestor(node)
+    || hasLabeledFormFieldAncestor(node, matcher)
 }
 
 export const requireFormControlLabel: Rule = {
@@ -53,20 +54,23 @@ export const requireFormControlLabel: Rule = {
       description: 'Require an accessible label for Nuxt UI form controls.',
       url: docsUrl('nuxt-ui/require-form-control-label'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       missingLabel: 'Add `label`, `legend`, `aria-label`, `aria-labelledby`, or wrap `<{{ component }}>` in a `<UFormField>` with `label` or a `#label` slot.',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (!FORM_CONTROLS.has(node.name) || hasRawOptOut(node) || hasAccessibleLabel(node))
+        const control = matcher.matchOf(node, FORM_CONTROLS)
+        if (!control || hasRawOptOut(node) || hasAccessibleLabel(node, matcher))
           return
         context.report({
           loc: node.startTag.loc,
           messageId: 'missingLabel',
-          data: { component: componentName(node.name) },
+          data: { component: matcher.prefixed(control) },
         })
       },
     })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
index a1b21ee..c1b90ac 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
@@ -1,6 +1,7 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { defineTemplateVisitor, hasAncestor, hasAttribute } from '../utils.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
+import { defineTemplateVisitor, hasAttribute } from '../utils.js'
 
 export const requireFormFieldName: Rule = {
   meta: {
@@ -9,16 +10,18 @@ export const requireFormFieldName: Rule = {
       description: 'Require a validation target on Nuxt UI form fields used inside a form.',
       url: docsUrl('nuxt-ui/require-form-field-name'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       missingName: 'Add `name` or `error-pattern` to this `<UFormField>` so `<UForm>` can route validation errors to it.',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (node.name === 'uformfield'
-          && hasAncestor(node, 'uform')
+        if (matcher.is(node, 'FormField')
+          && matcher.hasAncestor(node, 'Form')
           && !hasAttribute(node, 'name')
           && !hasAttribute(node, 'error-pattern')) {
           context.report({ loc: node.startTag.loc, messageId: 'missingName' })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
index 54a9c16..e03f4c3 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
@@ -1,5 +1,6 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor, getAttribute, hasAttribute, hasMeaningfulText, hasNonEmptyAttribute } from '../utils.js'
 
 function canBeLoading(node: any): boolean {
@@ -19,15 +20,17 @@ export const requireIconButtonLabel: Rule = {
       description: 'Require an accessible label for icon-, avatar-, and loading-only Nuxt UI buttons.',
       url: docsUrl('nuxt-ui/require-icon-button-label'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       missingLabel: 'Icon-, avatar-, or loading-only `<UButton>` needs `label`, `aria-label`, or an accessible `title`.',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (node.name !== 'ubutton'
+        if (!matcher.is(node, 'Button')
           || (!hasAttribute(node, 'icon') && !hasAttribute(node, 'avatar') && !canBeLoading(node))) {
           return
         }
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts
index fd232c2..1f2efd9 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts
@@ -1,8 +1,9 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor, hasNonEmptyAttribute, hasSlot } from '../utils.js'
 
-const OVERLAYS = new Set(['umodal', 'udrawer', 'uslideover'])
+const OVERLAYS = new Set(['Modal', 'Drawer', 'Slideover'])
 
 export const requireOverlayTitle: Rule = {
   meta: {
@@ -11,15 +12,17 @@ export const requireOverlayTitle: Rule = {
       description: 'Require an accessible title on Nuxt UI modal, drawer, and slideover components.',
       url: docsUrl('nuxt-ui/require-overlay-title'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       missingTitle: 'Add a `title`, `#title`, `aria-label`, or `aria-labelledby` to this Nuxt UI overlay.',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (OVERLAYS.has(node.name)
+        if (matcher.isOneOf(node, OVERLAYS)
           && !hasNonEmptyAttribute(node, 'title')
           && !hasNonEmptyAttribute(node, 'aria-label')
           && !hasNonEmptyAttribute(node, 'aria-labelledby')
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts
index 6f4badd..6e0920d 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts
@@ -1,5 +1,6 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor, hasSlot } from '../utils.js'
 
 export const requirePopoverContent: Rule = {
@@ -9,15 +10,17 @@ export const requirePopoverContent: Rule = {
       description: 'Require a content slot on Nuxt UI popovers.',
       url: docsUrl('nuxt-ui/require-popover-content'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       missingContent: 'Add a `#content` slot to `<UPopover>`; the `content` prop only configures positioning.',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (node.name === 'upopover' && !hasSlot(node, 'content'))
+        if (matcher.is(node, 'Popover') && !hasSlot(node, 'content'))
           context.report({ loc: node.startTag.loc, messageId: 'missingContent' })
       },
     })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts
index 0baa3a9..699ff41 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts
@@ -1,5 +1,6 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor, hasNonEmptyAttribute, hasSlot } from '../utils.js'
 
 export const requireTooltipContent: Rule = {
@@ -9,15 +10,17 @@ export const requireTooltipContent: Rule = {
       description: 'Require content on Nuxt UI tooltips so they communicate a useful hint.',
       url: docsUrl('nuxt-ui/require-tooltip-content'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       missingContent: 'Add a non-empty `text` prop or `#content` slot to `<UTooltip>`.',
     },
   },
   create(context: any) {
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (node.name === 'utooltip' && !hasNonEmptyAttribute(node, 'text') && !hasSlot(node, 'content'))
+        if (matcher.is(node, 'Tooltip') && !hasNonEmptyAttribute(node, 'text') && !hasSlot(node, 'content'))
           context.report({ loc: node.startTag.loc, messageId: 'missingContent' })
       },
     })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts
index 7cbc71e..7d5cd36 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts
@@ -1,5 +1,7 @@
 import type { Rule } from '@oxlint/plugins'
+import type { ComponentMatcher } from '../component-matcher.js'
 import { docsUrl } from '../../../utils/docs-url.js'
+import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
 import { defineTemplateVisitor } from '../utils.js'
 
 function isNuxtAppFile(filename: string): boolean {
@@ -10,10 +12,12 @@ function isNuxtAppFile(filename: string): boolean {
     && !normalized.includes('/layouts/')
 }
 
-function containsUApp(node: any): boolean {
-  if (node.name === 'uapp')
+function containsUApp(node: any, matcher: ComponentMatcher): boolean {
+  if (matcher.is(node, 'App'))
     return true
-  return (node.children ?? []).some((child: any) => child.type === 'VElement' && containsUApp(child))
+  return (node.children ?? []).some(
+    (child: any) => child.type === 'VElement' && containsUApp(child, matcher),
+  )
 }
 
 export const requireUApp: Rule = {
@@ -23,7 +27,7 @@ export const requireUApp: Rule = {
       description: 'Require the Nuxt UI App provider in the Nuxt application root.',
       url: docsUrl('nuxt-ui/require-u-app'),
     },
-    schema: [],
+    schema: componentOptionsSchema(),
     messages: {
       missingApp: 'Wrap the application in `<UApp>` to provide Nuxt UI configuration, toasts, tooltips, and programmatic overlays.',
     },
@@ -33,9 +37,11 @@ export const requireUApp: Rule = {
     if (!isNuxtAppFile(filename))
       return {}
 
+    const matcher = createComponentMatcher(context)
+
     return defineTemplateVisitor(context, {
       VElement(node: any) {
-        if (node.parent?.type === 'VDocumentFragment' && !containsUApp(node))
+        if (node.parent?.type === 'VDocumentFragment' && !containsUApp(node, matcher))
           context.report({ loc: node.startTag.loc, messageId: 'missingApp' })
       },
     })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
index 3e326c2..8381caa 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
@@ -1,4 +1,5 @@
-/** Note: `vue-eslint-parser` lowercases element names, so match `node.name` lowercased. */
+// `node.name` is only a safe comparison for native HTML tags; components go through
+// `createComponentMatcher`, which handles kebab-case, prefixes and import aliases.
 export function defineTemplateVisitor(context: any, visitor: Record<string, (node: any) => void>) {
   const services = context.sourceCode.parserServices
   if (typeof services?.defineTemplateBodyVisitor !== 'function')
@@ -69,23 +70,6 @@ export function hasMeaningfulText(node: any): boolean {
   })
 }
 
-export function componentName(name: string): string {
-  if (!name.startsWith('u'))
-    return name
-  const rest = name.slice(1).replace(/(^|-)([a-z])/g, (_match, _separator, character) => character.toUpperCase())
-  return `U${rest}`
-}
-
-export function hasAncestor(node: any, name: string): boolean {
-  let parent = node.parent
-  while (parent) {
-    if (parent.type === 'VElement' && parent.name === name)
-      return true
-    parent = parent.parent
-  }
-  return false
-}
-
 export function hasVModel(node: any, argumentName: string | null): boolean {
   return node.startTag.attributes.some((attribute: any) => {
     if (!attribute.directive || attribute.key.name?.name !== 'model')

From 2efe4dc3568bdcce201d097371e2c630901d319a Mon Sep 17 00:00:00 2001
From: norbiros <norbiros@protonmail.com>
Date: Mon, 10 Aug 2026 19:39:30 +0200
Subject: [PATCH 09/12] feat(lint-plugin-nuxt-ecosystem): error on broken code,
 warn on preferences

---
 .../src/index.test.ts                         | 34 +++++++++++++++++++
 .../lint-plugin-nuxt-ecosystem/src/index.ts   | 26 +++++++++++---
 .../nuxt-ui/require-form-field-name/index.ts  |  4 ++-
 .../require-icon-button-label/index.test.ts   |  1 +
 .../require-icon-button-label/index.ts        |  4 +--
 .../src/rules/nuxt-ui/utils.ts                | 11 +++---
 6 files changed, 68 insertions(+), 12 deletions(-)
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/index.test.ts

diff --git a/packages/lint-plugin-nuxt-ecosystem/src/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/index.test.ts
new file mode 100644
index 0000000..69117d4
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/index.test.ts
@@ -0,0 +1,34 @@
+import type { Linter } from 'eslint'
+import { describe, expect, it } from 'vitest'
+import plugin, { nuxtUiConfigs } from './index.js'
+
+function packRules(options?: Parameters<typeof nuxtUiConfigs>[0]): Partial<Linter.RulesRecord> {
+  return nuxtUiConfigs(options).find(config => config.name === 'nustack/nuxt-ui')!.rules!
+}
+
+function levelOf(entry: Linter.RuleEntry | undefined): string {
+  return Array.isArray(entry) ? String(entry[0]) : String(entry)
+}
+
+describe('nuxtUiConfigs', () => {
+  it('configures every rule the plugin exposes', () => {
+    expect(Object.keys(packRules()).sort()).toEqual(
+      Object.keys(plugin.rules!).map(name => `@nustack/nuxt-ui/${name}`).sort(),
+    )
+  })
+
+  it('errors on broken code and warns on preferences', () => {
+    const rules = packRules()
+    expect(levelOf(rules['@nustack/nuxt-ui/require-icon-button-label'])).toBe('error')
+    expect(levelOf(rules['@nustack/nuxt-ui/no-deprecated-components'])).toBe('error')
+    expect(levelOf(rules['@nustack/nuxt-ui/prefer-u-button'])).toBe('warn')
+    expect(levelOf(rules['@nustack/nuxt-ui/require-form-field-name'])).toBe('warn')
+  })
+
+  it('passes a custom prefix without losing the severity', () => {
+    const rules = packRules({ prefix: 'Nu' })
+    expect(rules['@nustack/nuxt-ui/require-icon-button-label']).toEqual(['error', { prefix: 'Nu' }])
+    // No component resolution, so no `prefix` option to accept.
+    expect(rules['@nustack/nuxt-ui/prefer-u-icon']).toBe('warn')
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
index 618c7e1..9c37d59 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
@@ -79,12 +79,25 @@ export interface NuxtUiConfigsOptions {
 
 const RULES = Object.keys(plugin.rules!).sort()
 
+function ruleMeta(name: string): Rule.RuleMetaData | undefined {
+  return (plugin.rules![name] as Rule.RuleModule).meta
+}
+
 /** Whether a rule resolves components, and so takes the `prefix` option. */
 function acceptsPrefix(name: string): boolean {
-  const schema = (plugin.rules![name] as Rule.RuleModule).meta?.schema
+  const schema = ruleMeta(name)?.schema
   return Array.isArray(schema) && Boolean((schema[0] as any)?.properties?.prefix)
 }
 
+/**
+ * `problem` rules report code that is already broken — a removed v4 API, props that cancel each
+ * other out, a control with no accessible name — so they error. `suggestion` rules express a
+ * preference between two things that both work, so they only warn.
+ */
+function severityOf(name: string): 'error' | 'warn' {
+  return ruleMeta(name)?.type === 'problem' ? 'error' : 'warn'
+}
+
 /** Returns Vue-SFC-scoped Nuxt UI configs. */
 export function nuxtUiConfigs(options: NuxtUiConfigsOptions = {}): Linter.Config[] {
   const { variant = 'recommended', prefix = 'U', rules } = options
@@ -95,10 +108,13 @@ export function nuxtUiConfigs(options: NuxtUiConfigsOptions = {}): Linter.Config
       name: 'nustack/nuxt-ui',
       files: NUXT_UI_GLOB,
       plugins: pluginRef,
-      rules: Object.fromEntries(RULES.map(name => [
-        `@nustack/nuxt-ui/${name}`,
-        prefix !== 'U' && acceptsPrefix(name) ? ['warn', { prefix }] : 'warn',
-      ])),
+      rules: Object.fromEntries(RULES.map((name) => {
+        const level = severityOf(name)
+        return [
+          `@nustack/nuxt-ui/${name}`,
+          prefix !== 'U' && acceptsPrefix(name) ? [level, { prefix }] : level,
+        ]
+      })),
     })
   }
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
index c1b90ac..a7c9f6f 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
@@ -5,7 +5,9 @@ import { defineTemplateVisitor, hasAttribute } from '../utils.js'
 
 export const requireFormFieldName: Rule = {
   meta: {
-    type: 'problem',
+    // A `<UFormField>` without `name` still renders and labels its control; it only opts out of
+    // automatic error routing, which a purely presentational field group legitimately wants.
+    type: 'suggestion',
     docs: {
       description: 'Require a validation target on Nuxt UI form fields used inside a form.',
       url: docsUrl('nuxt-ui/require-form-field-name'),
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
index 10e3b42..01394fb 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
@@ -11,6 +11,7 @@ describe('require-icon-button-label', () => {
         { filename: 'component.vue', code: '<template><UButton icon="i-lucide-search" aria-label="Search" /></template>' },
         { filename: 'component.vue', code: '<template><UButton icon="i-lucide-save">Save</UButton></template>' },
         { filename: 'component.vue', code: '<template><UButton :loading="false" /></template>' },
+        { filename: 'component.vue', code: '<template><UButton icon="i-lucide-save"><span>Save</span></UButton></template>' },
       ],
       invalid: [
         { filename: 'component.vue', code: '<template><UButton icon="i-lucide-search" /></template>', errors: [{ messageId: 'missingLabel' }] },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
index e03f4c3..c8c3901 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
@@ -1,7 +1,7 @@
 import type { Rule } from '@oxlint/plugins'
 import { docsUrl } from '../../../utils/docs-url.js'
 import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, getAttribute, hasAttribute, hasMeaningfulText, hasNonEmptyAttribute } from '../utils.js'
+import { defineTemplateVisitor, getAttribute, hasAttribute, hasLabelContent, hasNonEmptyAttribute } from '../utils.js'
 
 function canBeLoading(node: any): boolean {
   const attribute = getAttribute(node, 'loading')
@@ -35,7 +35,7 @@ export const requireIconButtonLabel: Rule = {
           return
         }
         if (hasNonEmptyAttribute(node, 'label') || hasNonEmptyAttribute(node, 'aria-label')
-          || hasNonEmptyAttribute(node, 'title') || hasMeaningfulText(node)) {
+          || hasNonEmptyAttribute(node, 'title') || hasLabelContent(node)) {
           return
         }
         context.report({ loc: node.startTag.loc, messageId: 'missingLabel' })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
index 8381caa..fee26a9 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
@@ -60,13 +60,16 @@ export function hasSlot(node: any, name: string): boolean {
   })
 }
 
-export function hasMeaningfulText(node: any): boolean {
+/**
+ * Whether the default slot can produce an accessible name. Interpolations and child elements
+ * both count: their content is unknowable here, and for a rule that errors a missed
+ * `<span>Save</span>` is far worse than staying quiet on a wrapped icon.
+ */
+export function hasLabelContent(node: any): boolean {
   return (node.children ?? []).some((child: any) => {
     if (child.type === 'VText')
       return child.value.trim().length > 0
-    // Interpolations can provide a runtime label. Child components (for example
-    // `<UIcon>`) are intentionally not treated as an accessible label.
-    return child.type === 'VExpressionContainer'
+    return child.type === 'VExpressionContainer' || child.type === 'VElement'
   })
 }
 

From 305cac0cc75d263aac3b5f03e6f6cf894726945c Mon Sep 17 00:00:00 2001
From: norbiros <norbiros@protonmail.com>
Date: Mon, 10 Aug 2026 20:07:40 +0200
Subject: [PATCH 10/12] docs(lint-plugin-nuxt-ecosystem): normalize rule doc
 format

Split inline Incorrect/Correct code comments into separate ## Incorrect
and ## Correct sections, consistent with the no-deprecated-components doc.
---
 .../no-conflicting-state-props/index.md       | 25 ++++++++-----
 .../no-invalid-prop-combinations/index.md     | 31 ++++++++++------
 .../src/rules/nuxt-ui/prefer-u-icon/index.md  | 16 ++++++---
 .../src/rules/nuxt-ui/prefer-u-kbd/index.md   | 16 ++++++---
 .../src/rules/nuxt-ui/prefer-u-modal/index.md | 20 +++++++----
 .../rules/nuxt-ui/prefer-u-progress/index.md  | 16 ++++++---
 .../rules/nuxt-ui/prefer-u-separator/index.md | 16 ++++++---
 .../src/rules/nuxt-ui/prefer-u-tree/index.md  | 12 ++++---
 .../rules/nuxt-ui/require-avatar-alt/index.md | 21 +++++++----
 .../require-form-control-label/index.md       | 33 ++++++++++-------
 .../nuxt-ui/require-form-field-name/index.md  | 36 ++++++++++++-------
 .../require-icon-button-label/index.md        | 20 +++++++----
 .../nuxt-ui/require-overlay-title/index.md    | 23 ++++++++----
 .../nuxt-ui/require-popover-content/index.md  | 34 +++++++++++-------
 .../nuxt-ui/require-tooltip-content/index.md  | 20 +++++++----
 .../src/rules/nuxt-ui/require-u-app/index.md  | 10 ++++--
 16 files changed, 240 insertions(+), 109 deletions(-)

diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
index 559ce82..a0f58f9 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
@@ -4,18 +4,27 @@ Do not combine controlled state (`open`, `v-model:open`, `model-value`, or `v-mo
 the corresponding uncontrolled initializer (`default-open` or `default-value`). Nuxt UI's
 APIs document `default-*` for cases where the caller does not control state.
 
-The pairing is a component-authoring convention rather than a Nuxt UI detail, so the rule
-applies to any component element. Native HTML tags are skipped.
+The rule is limited to Nuxt UI components that document the corresponding controlled and
+uncontrolled props. It does not infer this convention for application components.
+
+## Incorrect
 
 ```vue
-<!-- Incorrect -->
-<UModal v-model:open="open" default-open />
+<template>
+  <UModal v-model:open="open" default-open />
+</template>
+```
 
-<!-- Correct: controlled -->
-<UModal v-model:open="open" />
+## Correct
+
+```vue
+<template>
+  <!-- controlled -->
+  <UModal v-model:open="open" />
 
-<!-- Correct: uncontrolled -->
-<UModal default-open />
+  <!-- uncontrolled -->
+  <UModal default-open />
+</template>
 ```
 
 ## Further reading
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
index ff6e3cd..61522ca 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
@@ -9,19 +9,28 @@ Currently covered:
 - `UFileUpload position` requires `variant="area"` and `layout="list"`.
 - `UAccordion collapsible` is only meaningful for the default `type="single"`.
 
-Dynamic values are ignored when the relationship cannot be proven at lint time.
-Use `data-raw` for an intentional low-level exception.
+Dynamic values are ignored when the relationship cannot be proven at lint time. `data-raw`
+does not disable API correctness checks; use a standard ESLint disable comment for an
+exceptional suppression.
+
+## Incorrect
+
+```vue
+<template>
+  <UFileUpload variant="button" multiple />
+  <UFileUpload variant="area" position="outside" />
+  <UAccordion type="multiple" collapsible :items="items" />
+</template>
+```
+
+## Correct
 
 ```vue
-<!-- Incorrect -->
-<UFileUpload variant="button" multiple />
-<UFileUpload variant="area" position="outside" />
-<UAccordion type="multiple" collapsible :items="items" />
-
-<!-- Correct -->
-<UFileUpload variant="button" />
-<UFileUpload variant="area" layout="list" position="outside" />
-<UAccordion type="single" collapsible :items="items" />
+<template>
+  <UFileUpload variant="button" />
+  <UFileUpload variant="area" layout="list" position="outside" />
+  <UAccordion type="single" collapsible :items="items" />
+</template>
 ```
 
 ## Further reading
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
index b144e22..8215803 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
@@ -3,12 +3,20 @@
 Prefer Nuxt UI's `UIcon` component and its `name` prop over raw Iconify utility classes.
 Use `data-raw` for a deliberate low-level icon implementation.
 
+## Incorrect
+
 ```vue
-<!-- Incorrect -->
-<span class="i-lucide-search" />
+<template>
+  <span class="i-lucide-search" />
+</template>
+```
 
-<!-- Correct -->
-<UIcon name="i-lucide-search" />
+## Correct
+
+```vue
+<template>
+  <UIcon name="i-lucide-search" />
+</template>
 ```
 
 ## Further reading
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
index 29f65a3..17bae8c 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
@@ -2,12 +2,20 @@
 
 Prefer Nuxt UI's `UKbd` over a raw `kbd` element for theme-aware keyboard hints.
 
+## Incorrect
+
 ```vue
-<!-- Incorrect -->
-<kbd>K</kbd>
+<template>
+  <kbd>K</kbd>
+</template>
+```
 
-<!-- Correct -->
-<UKbd value="K" />
+## Correct
+
+```vue
+<template>
+  <UKbd value="K" />
+</template>
 ```
 
 Use `data-raw` when native markup is intentional.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md
index 60b6765..6b0d506 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md
@@ -3,14 +3,22 @@
 Prefer `UModal` over a raw `dialog` element. `UModal` supplies Nuxt UI styling and Reka UI
 dialog behavior, including focus management and screen-reader semantics.
 
+## Incorrect
+
 ```vue
-<!-- Incorrect -->
-<dialog open>Confirm deletion?</dialog>
+<template>
+  <dialog open>Confirm deletion?</dialog>
+</template>
+```
 
-<!-- Correct -->
-<UModal title="Confirm deletion">
-  <template #body>Are you sure?</template>
-</UModal>
+## Correct
+
+```vue
+<template>
+  <UModal title="Confirm deletion">
+    <template #body>Are you sure?</template>
+  </UModal>
+</template>
 ```
 
 The migration is structural rather than a direct tag rename. Use `data-raw` for deliberately
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
index 44e69f7..ea4d4f1 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
@@ -2,12 +2,20 @@
 
 Prefer Nuxt UI's accessible and theme-aware `UProgress` over a raw `progress` element.
 
+## Incorrect
+
 ```vue
-<!-- Incorrect -->
-<progress :value="50" max="100" />
+<template>
+  <progress :value="50" max="100" />
+</template>
+```
 
-<!-- Correct -->
-<UProgress :model-value="50" :max="100" />
+## Correct
+
+```vue
+<template>
+  <UProgress :model-value="50" :max="100" />
+</template>
 ```
 
 Use `data-raw` when native markup is intentional.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
index 033b828..32c9428 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
@@ -3,12 +3,20 @@
 Prefer `USeparator` over a raw `hr` element for consistent orientation, color, size, and
 optional label handling.
 
+## Incorrect
+
 ```vue
-<!-- Incorrect -->
-<hr>
+<template>
+  <hr>
+</template>
+```
 
-<!-- Correct -->
-<USeparator />
+## Correct
+
+```vue
+<template>
+  <USeparator />
+</template>
 ```
 
 Use `data-raw` when native markup is intentional.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md
index 2b50ef4..e14bda1 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md
@@ -9,15 +9,19 @@ bindings, drag and drop, or expansion controls.
 ## Incorrect
 
 ```vue
-<ul role="tree">
-  <TreeItem v-for="item in items" :key="item.id" :item="item" />
-</ul>
+<template>
+  <ul role="tree">
+    <TreeItem v-for="item in items" :key="item.id" :item="item" />
+  </ul>
+</template>
 ```
 
 ## Correct
 
 ```vue
-<UTree :items="items" />
+<template>
+  <UTree :items="items" />
+</template>
 ```
 
 Add `data-raw` to the tree root when a custom implementation is required. A custom tree
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
index dc96722..6d73c64 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
@@ -3,15 +3,24 @@
 Require `alt` on image-backed `UAvatar` components. Use `aria-hidden` for an explicitly
 decorative avatar.
 
+## Incorrect
+
 ```vue
-<!-- Incorrect -->
-<UAvatar src="/users/ben.png" />
+<template>
+  <UAvatar src="/users/ben.png" />
+</template>
+```
 
-<!-- Correct: meaningful image -->
-<UAvatar src="/users/ben.png" alt="Benjamin" />
+## Correct
+
+```vue
+<template>
+  <!-- meaningful image -->
+  <UAvatar src="/users/ben.png" alt="Benjamin" />
 
-<!-- Correct: decorative image -->
-<UAvatar src="/brand-mark.png" aria-hidden="true" />
+  <!-- decorative image -->
+  <UAvatar src="/brand-mark.png" aria-hidden="true" />
+</template>
 ```
 
 ## Further reading
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
index 640ce91..b293030 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
@@ -1,23 +1,32 @@
 # `@nustack/nuxt-ui/require-form-control-label`
 
-Require an accessible name for Nuxt UI form controls. A label may be provided by
-`label`, `legend`, `aria-label`, `aria-labelledby`, the matching slot, or an enclosing
-`UFormField` that has a `label` prop or `#label` slot.
+Require an accessible name for Nuxt UI form controls. The rule understands each component's
+supported `label` or `legend` API, ARIA naming, native `<label>` associations, and enclosing
+`UFormField` labels.
 
-```vue
-<!-- Incorrect -->
-<UInput placeholder="Search" />
+## Incorrect
 
-<!-- Correct -->
-<UFormField label="Search">
+```vue
+<template>
   <UInput placeholder="Search" />
-</UFormField>
-<UCheckboxGroup legend="Options" :items="items" />
-<USwitch aria-label="Enable notifications" />
+</template>
+```
+
+## Correct
+
+```vue
+<template>
+  <UFormField label="Search">
+    <UInput placeholder="Search" />
+  </UFormField>
+  <UCheckboxGroup legend="Options" :items="items" />
+  <USwitch aria-label="Enable notifications" />
+</template>
 ```
 
 Dynamic bindings are accepted because their runtime value cannot be proven statically.
-Use `data-raw` for an intentional low-level exception.
+`data-raw` does not disable accessibility checks; use a standard ESLint disable comment for
+an intentional exception.
 
 ## Further reading
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md
index 40eb7e6..3882c37 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md
@@ -4,20 +4,30 @@ Inside `UForm`, each `UFormField` needs a `name` or `error-pattern` so Nuxt UI c
 schema/custom-validation errors to the correct field. Standalone display-only form fields
 are ignored.
 
+## Incorrect
+
+Validation errors cannot be matched to this field:
+
+```vue
+<template>
+  <UForm :schema="schema" :state="state">
+    <UFormField label="Email">
+      <UInput v-model="state.email" />
+    </UFormField>
+  </UForm>
+</template>
+```
+
+## Correct
+
 ```vue
-<!-- Incorrect: validation errors cannot be matched to this field -->
-<UForm :schema="schema" :state="state">
-  <UFormField label="Email">
-    <UInput v-model="state.email" />
-  </UFormField>
-</UForm>
-
-<!-- Correct -->
-<UForm :schema="schema" :state="state">
-  <UFormField name="email" label="Email">
-    <UInput v-model="state.email" />
-  </UFormField>
-</UForm>
+<template>
+  <UForm :schema="schema" :state="state">
+    <UFormField name="email" label="Email">
+      <UInput v-model="state.email" />
+    </UFormField>
+  </UForm>
+</template>
 ```
 
 ## Further reading
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
index 908c5a5..c524feb 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
@@ -3,14 +3,22 @@
 Icon-, avatar-, and loading-only `UButton` instances need an accessible label. `label`,
 `aria-label`, `title`, or visible slot content satisfies the rule.
 
+## Incorrect
+
 ```vue
-<!-- Incorrect -->
-<UButton icon="i-lucide-search" />
-<UButton loading />
+<template>
+  <UButton icon="i-lucide-search" />
+  <UButton loading />
+</template>
+```
 
-<!-- Correct -->
-<UButton icon="i-lucide-search" aria-label="Search" />
-<UButton loading label="Saving" />
+## Correct
+
+```vue
+<template>
+  <UButton icon="i-lucide-search" aria-label="Search" />
+  <UButton loading label="Saving" />
+</template>
 ```
 
 ## Further reading
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md
index fa45ae9..8ebda75 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md
@@ -1,15 +1,24 @@
 # `@nustack/nuxt-ui/require-overlay-title`
 
-Require an accessible title on `UModal`, `UDrawer`, and `USlideover`. A `title` prop,
-`#title` slot, `aria-label`, or `aria-labelledby` satisfies the rule.
+Require an accessible title on `UModal`, `UDrawer`, and `USlideover`. A `title` prop, a
+non-empty `#title` slot, or an accessible name in the `content` configuration satisfies the
+rule. Root ARIA attributes label the trigger path, not the rendered overlay content.
+
+## Incorrect
 
 ```vue
-<!-- Incorrect -->
-<UModal><template #body>Delete this project?</template></UModal>
+<template>
+  <UModal><template #body>Delete this project?</template></UModal>
+</template>
+```
 
-<!-- Correct -->
-<UModal title="Delete project" />
-<UModal><template #title>Delete project</template></UModal>
+## Correct
+
+```vue
+<template>
+  <UModal title="Delete project" />
+  <UModal><template #title>Delete project</template></UModal>
+</template>
 ```
 
 ## Further reading
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md
index 8b60bf0..ba13f77 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md
@@ -3,19 +3,29 @@
 Require the `#content` slot on `UPopover`. The similarly named `content` prop configures
 floating position, collision handling, and alignment; it does not provide displayed content.
 
+## Incorrect
+
+The `content` prop configures floating position; it is not displayed content:
+
+```vue
+<template>
+  <UPopover :content="{ side: 'right' }">
+    <UButton label="Details" />
+  </UPopover>
+</template>
+```
+
+## Correct
+
 ```vue
-<!-- Incorrect: content config is not displayed content -->
-<UPopover :content="{ side: 'right' }">
-  <UButton label="Details" />
-</UPopover>
-
-<!-- Correct -->
-<UPopover>
-  <UButton label="Details" />
-  <template #content>
-    Details
-  </template>
-</UPopover>
+<template>
+  <UPopover>
+    <UButton label="Details" />
+    <template #content>
+      Details
+    </template>
+  </UPopover>
+</template>
 ```
 
 ## Further reading
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md
index 226142d..5b136f2 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md
@@ -1,14 +1,22 @@
 # `@nustack/nuxt-ui/require-tooltip-content`
 
-Require `text` or a `#content` slot on `UTooltip`. This prevents empty hover targets and
-keeps the component useful for keyboard and pointer users.
+Require non-empty `text`, `kbds`, or a `#content` slot on `UTooltip`. This prevents empty
+hover targets and keeps the component useful for keyboard and pointer users.
+
+## Incorrect
 
 ```vue
-<!-- Incorrect -->
-<UTooltip><UButton icon="i-lucide-settings" aria-label="Settings" /></UTooltip>
+<template>
+  <UTooltip><UButton icon="i-lucide-settings" aria-label="Settings" /></UTooltip>
+</template>
+```
 
-<!-- Correct -->
-<UTooltip text="Open settings"><UButton icon="i-lucide-settings" aria-label="Settings" /></UTooltip>
+## Correct
+
+```vue
+<template>
+  <UTooltip text="Open settings"><UButton icon="i-lucide-settings" aria-label="Settings" /></UTooltip>
+</template>
 ```
 
 ## Further reading
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
index 10aafd8..e1cbbb9 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
@@ -4,13 +4,19 @@ Require `UApp` in the Nuxt `app.vue` root. Nuxt UI documents it as the provider
 configuration, reading direction, body-lock behavior, toasts, tooltips, and programmatic
 modals/slideovers.
 
+## Incorrect
+
+`app.vue` without the Nuxt UI provider:
+
 ```vue
-<!-- Incorrect: app.vue without the Nuxt UI provider -->
 <template>
   <NuxtPage />
 </template>
+```
 
-<!-- Correct -->
+## Correct
+
+```vue
 <template>
   <UApp>
     <NuxtPage />

From c366d3a091dd1fd17ba03098f5804f3716f30606 Mon Sep 17 00:00:00 2001
From: norbiros <norbiros@protonmail.com>
Date: Thu, 13 Aug 2026 21:21:06 +0200
Subject: [PATCH 11/12] refactor(lint-plugin-nuxt-ecosystem): overhaul the
 module

This is a major breaking change that overhauls the rule architecture,
introduces explicit standalone configuration, and adds @nuxt/image as
a proof-of-concept ecosystem integration. Remove deprecated exports,
improve rule correctness and configuration.
---
 modules/lint/README.md                        |   5 +
 modules/lint/docs/configuration.md            |  37 ++-
 modules/lint/package.json                     |   1 +
 modules/lint/playground/app/app.vue           |   8 +-
 modules/lint/playground/package.json          |   2 +-
 modules/lint/src/config.ts                    |   6 +-
 modules/lint/src/configs/nuxt-ecosystem.ts    |  45 ++-
 modules/lint/src/context/index.ts             |   3 +-
 modules/lint/src/context/module-flags.ts      |   2 +
 modules/lint/src/utils.ts                     |   9 +-
 modules/lint/test/detect.test.ts              |  12 +-
 modules/lint/test/e2e.test.ts                 |  36 ++-
 modules/lint/test/enforce.test.ts             |   2 +-
 modules/lint/test/style.test.ts               |   2 +-
 modules/lint/test/targets.test.ts             |  18 +-
 packages/lint-plugin-nuxt-ecosystem/README.md | 206 ++++++++++---
 .../lint-plugin-nuxt-ecosystem/package.json   |   9 +-
 .../src/index.test.ts                         |  34 ---
 .../lint-plugin-nuxt-ecosystem/src/index.ts   | 178 ++---------
 .../src/rules/nuxt-image/components.ts        |  57 ++++
 .../src/rules/nuxt-image/module.ts            |  64 ++++
 .../rules/nuxt-image/no-assets-src/index.md   |  40 +++
 .../nuxt-image/no-assets-src/index.test.ts    |  43 +++
 .../rules/nuxt-image/no-assets-src/index.ts   |  44 +++
 .../rules/nuxt-image/prefer-nuxt-img/index.md |  37 +++
 .../nuxt-image/prefer-nuxt-img/index.test.ts  |  24 ++
 .../rules/nuxt-image/prefer-nuxt-img/index.ts |  37 +++
 .../nuxt-image/require-image-alt/index.md     |  36 +++
 .../require-image-alt/index.test.ts           |  70 +++++
 .../nuxt-image/require-image-alt/index.ts     |  39 +++
 .../rules/nuxt-ui/component-matcher.test.ts   | 132 ---------
 .../src/rules/nuxt-ui/component-matcher.ts    | 175 -----------
 .../src/rules/nuxt-ui/components.ts           |  37 +++
 .../src/rules/nuxt-ui/module.ts               | 128 ++++++++
 .../no-conflicting-state-props/index.md       |   6 +-
 .../no-conflicting-state-props/index.test.ts  |  24 +-
 .../no-conflicting-state-props/index.ts       |  71 ++++-
 .../nuxt-ui/no-deprecated-components/index.md |  38 ++-
 .../no-deprecated-components/index.test.ts    |  31 +-
 .../nuxt-ui/no-deprecated-components/index.ts | 105 +++++--
 .../no-deprecated-model-modifiers/index.md    |   4 +-
 .../index.test.ts                             |  31 +-
 .../no-deprecated-model-modifiers/index.ts    |  44 ++-
 .../no-invalid-prop-combinations/index.md     |   5 +-
 .../index.test.ts                             |  25 +-
 .../no-invalid-prop-combinations/index.ts     |  73 ++---
 .../src/rules/nuxt-ui/prefer-link-to/index.md |  10 +-
 .../nuxt-ui/prefer-link-to/index.test.ts      |  12 +-
 .../src/rules/nuxt-ui/prefer-link-to/index.ts |  17 +-
 .../rules/nuxt-ui/prefer-u-button/index.md    |   6 +-
 .../nuxt-ui/prefer-u-button/index.test.ts     |  15 +-
 .../rules/nuxt-ui/prefer-u-button/index.ts    |   2 +-
 .../src/rules/nuxt-ui/prefer-u-component.ts   |  28 +-
 .../nuxt-ui/prefer-u-form-controls/index.md   |  16 +-
 .../prefer-u-form-controls/index.test.ts      |  55 ++--
 .../nuxt-ui/prefer-u-form-controls/index.ts   |  97 +++---
 .../nuxt-ui/prefer-u-form-field/index.md      |  19 +-
 .../nuxt-ui/prefer-u-form-field/index.test.ts |  27 +-
 .../nuxt-ui/prefer-u-form-field/index.ts      |  44 +--
 .../src/rules/nuxt-ui/prefer-u-icon/index.md  |   4 +-
 .../rules/nuxt-ui/prefer-u-icon/index.test.ts |  15 +-
 .../src/rules/nuxt-ui/prefer-u-icon/index.ts  |  17 +-
 .../src/rules/nuxt-ui/prefer-u-kbd/index.md   |   6 +-
 .../rules/nuxt-ui/prefer-u-kbd/index.test.ts  |  12 +-
 .../src/rules/nuxt-ui/prefer-u-kbd/index.ts   |   2 +-
 .../src/rules/nuxt-ui/prefer-u-link/index.md  |   7 +-
 .../rules/nuxt-ui/prefer-u-link/index.test.ts |  25 +-
 .../src/rules/nuxt-ui/prefer-u-link/index.ts  |   2 +-
 .../src/rules/nuxt-ui/prefer-u-modal/index.md |   7 +-
 .../nuxt-ui/prefer-u-modal/index.test.ts      |  12 +-
 .../src/rules/nuxt-ui/prefer-u-modal/index.ts |   2 +-
 .../rules/nuxt-ui/prefer-u-progress/index.md  |   6 +-
 .../nuxt-ui/prefer-u-progress/index.test.ts   |  12 +-
 .../rules/nuxt-ui/prefer-u-progress/index.ts  |   2 +-
 .../rules/nuxt-ui/prefer-u-separator/index.md |   6 +-
 .../nuxt-ui/prefer-u-separator/index.test.ts  |  12 +-
 .../rules/nuxt-ui/prefer-u-separator/index.ts |   2 +-
 .../src/rules/nuxt-ui/prefer-u-table/index.md |   8 +-
 .../nuxt-ui/prefer-u-table/index.test.ts      |  16 +-
 .../src/rules/nuxt-ui/prefer-u-table/index.ts |   2 +-
 .../src/rules/nuxt-ui/prefer-u-tree/index.md  |   3 +-
 .../rules/nuxt-ui/prefer-u-tree/index.test.ts |  31 +-
 .../src/rules/nuxt-ui/prefer-u-tree/index.ts  |  19 +-
 .../rules/nuxt-ui/require-avatar-alt/index.md |   3 +-
 .../nuxt-ui/require-avatar-alt/index.test.ts  |  23 +-
 .../rules/nuxt-ui/require-avatar-alt/index.ts |  24 +-
 .../require-form-control-label/index.md       |   6 +-
 .../require-form-control-label/index.test.ts  |  23 +-
 .../require-form-control-label/index.ts       |  28 +-
 .../require-form-field-name/index.test.ts     |  18 +-
 .../nuxt-ui/require-form-field-name/index.ts  |  21 +-
 .../require-icon-button-label/index.md        |   9 +
 .../require-icon-button-label/index.test.ts   |  31 +-
 .../require-icon-button-label/index.ts        |  50 ++--
 .../nuxt-ui/require-nested-form-prop/index.md |  25 ++
 .../require-nested-form-prop/index.test.ts    |  22 ++
 .../nuxt-ui/require-nested-form-prop/index.ts |  35 +++
 .../require-overlay-title/index.test.ts       |  16 +-
 .../nuxt-ui/require-overlay-title/index.ts    |  15 +-
 .../require-popover-content/index.test.ts     |  12 +-
 .../nuxt-ui/require-popover-content/index.ts  |  15 +-
 .../require-tooltip-content/index.test.ts     |  14 +-
 .../nuxt-ui/require-tooltip-content/index.ts  |  15 +-
 .../src/rules/nuxt-ui/require-u-app/index.md  |   3 +-
 .../rules/nuxt-ui/require-u-app/index.test.ts |  19 +-
 .../src/rules/nuxt-ui/require-u-app/index.ts  |  91 ++++--
 .../src/rules/nuxt-ui/utils.ts                |  85 ------
 .../src/utils/component-matcher.ts            | 231 +++++++++++++++
 .../src/utils/docs-url.ts                     |   1 -
 .../src/utils/template.ts                     | 280 ++++++++++++++++++
 .../tests/index.test.ts                       | 188 ++++++++++++
 .../lint-plugin-nuxt-ecosystem/tests/parse.ts |  20 ++
 .../tests/rule-tester.ts                      |  30 ++
 .../tests/rules/nuxt-ui/components.test.ts    | 126 ++++++++
 .../rules/nuxt-ui/prefer-u-component.test.ts  |  54 ++++
 .../tests/utils/template.test.ts              | 179 +++++++++++
 .../lint-plugin-nuxt-ecosystem/tsconfig.json  |   2 +-
 .../vitest.config.ts                          |   2 +-
 pnpm-lock.yaml                                |  84 +-----
 119 files changed, 3055 insertions(+), 1358 deletions(-)
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/components.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/module.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.ts
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.test.ts
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/components.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/module.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.md
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.ts
 delete mode 100644 packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/utils/component-matcher.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/src/utils/template.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/tests/index.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/tests/parse.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/tests/rule-tester.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/tests/rules/nuxt-ui/components.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/tests/rules/nuxt-ui/prefer-u-component.test.ts
 create mode 100644 packages/lint-plugin-nuxt-ecosystem/tests/utils/template.test.ts

diff --git a/modules/lint/README.md b/modules/lint/README.md
index 461982d..01c2e76 100644
--- a/modules/lint/README.md
+++ b/modules/lint/README.md
@@ -45,6 +45,11 @@ The preset composes these layers and gates each on what your project actually us
 | **Tailwind**       | Class order and correctness                                    | [`better-tailwindcss`](https://github.com/schoero/eslint-plugin-better-tailwindcss)                                             |
 | **Vue SFC**        | Conventions from `eslint-plugin-vue` (e.g. `lang="ts"` blocks) | `eslint-plugin-vue`                                                                                                             |
 
+Nuxt ecosystem integrations can also be selected manually. For example,
+`nuxtEcosystem: { nuxtUi: { preset: 'minimal' } }` keeps only the Nuxt UI rules that report broken
+or deprecated code; `nuxtUi: false` disables the integration even when `@nuxt/ui` is installed. The
+default `recommended` preset adds design-system preferences on top, as warnings. See [Configuration](docs/configuration.md) for the complete options.
+
 **Want a rule added, or a plugin integrated?** [Open an issue](https://github.com/Zerya-Dev/nustack/issues) as the ruleset is meant to grow with what the community uses.
 
 ## 🚀 Quick Start
diff --git a/modules/lint/docs/configuration.md b/modules/lint/docs/configuration.md
index b1ebb5e..05739af 100644
--- a/modules/lint/docs/configuration.md
+++ b/modules/lint/docs/configuration.md
@@ -124,10 +124,45 @@ but you can force or disable any of them:
 | `vue`           | SFC conventions (`vue/block-lang` → `lang="ts"`)                              | `.vue` files                                                                          |
 | `vueUse`        | VueUse/browser API conventions                                                | Nuxt app/client files, or `vue-app`                                                   |
 | `vite`          | Vite asset/env safety                                                         | Nuxt app/client files, or `vue-app`                                                   |
-| `nuxtEcosystem` | per-module Nuxt-ecosystem preferences (Nuxt UI today)                         | each module's own detection (`@nuxt/ui` etc.), never blanket-disabled by a target     |
+| `nuxtEcosystem` | per-module Nuxt-ecosystem preferences                                         | each module's own detection (`@nuxt/ui` etc.), never blanket-disabled by a target     |
 | `tailwind`      | class sorting/correctness via better-tailwindcss (incl. the `:ui` prop)       | a Tailwind entry point                                                                |
 | `markdown`      | Markdown/MDC linting via mdclint for `content/**/*.md`                        | always; MDC preset when `@nuxt/content`, `@comark/nuxt`, or `@nuxtjs/mdc` is detected |
 
+### Nuxt ecosystem integrations
+
+`@nustackjs/lint` detects installed modules and enables their integrations automatically. You can
+also enable, configure, or disable each integration explicitly. Every integration provides two presets:
+
+| Preset        | Contents                                                      | Severity         |
+| ------------- | ------------------------------------------------------------- | ---------------- |
+| `minimal`     | Invalid usage, accessibility defects, removed or renamed APIs | `error`          |
+| `recommended` | `minimal` plus design-system preferences (`prefer-*`)         | `error` / `warn` |
+
+`recommended` is the default.
+
+The Nuxt UI rules reuse the SFC parsing the Vue layer already sets up — the plugin ships no
+parsers of its own.
+
+```ts
+nustack({
+  nuxtEcosystem: {
+    // Force @nuxt/ui rules on even when package detection is unavailable.
+    nuxtUi: {
+      preset: 'minimal',
+      rules: { '@nustack/nuxt-ui/require-u-app': 'off' },
+    },
+  },
+})
+```
+
+Use `nuxtUi: true` to force the default preset on, or `nuxtUi: false` to disable the detected
+integration. The configured Nuxt UI component prefix is read from `nuxt.config.ts` automatically.
+
+The `prefer-*` rules have no attribute-level opt-out. Suppress a deliberate exception with
+`<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-button -->` in the template — this works
+because the composed config carries `eslint-plugin-vue`'s `vue/comment-directive` and `.vue`
+processor.
+
 ## Context detection outside Nuxt
 
 Non-Nuxt targets (`vue-app`, and `nuxt-module`'s `src/**`) have no `nuxt prepare` to
diff --git a/modules/lint/package.json b/modules/lint/package.json
index 9e59201..f5d646c 100644
--- a/modules/lint/package.json
+++ b/modules/lint/package.json
@@ -52,6 +52,7 @@
   ],
   "scripts": {
     "prepack": "nuxt-module-build build",
+    "prepare": "pnpm --filter '@nustackjs/lint-plugin-*' --if-present build && nuxt-module-build prepare && nuxt-module-build build",
     "build": "nuxt-module-build prepare && nuxt-module-build build",
     "dev": "npm run dev:prepare && nuxt dev playground",
     "dev:build": "nuxt build playground",
diff --git a/modules/lint/playground/app/app.vue b/modules/lint/playground/app/app.vue
index 9daa00d..03f8faa 100644
--- a/modules/lint/playground/app/app.vue
+++ b/modules/lint/playground/app/app.vue
@@ -1,5 +1,9 @@
 <script setup lang="ts">
 const count = ref(0)
+
+function increment() {
+  count.value++
+}
 </script>
 
 <template>
@@ -8,12 +12,12 @@ const count = ref(0)
     <UButton
       class="px-4 py-2 bg-primary flex"
       :ui="{ base: 'rounded-lg text-white px-2' }"
-      @click="() => count++"
+      @click="increment"
     >
       Clicked {{ count }}
     </UButton>
 
-    <!-- raw <button> → nustack/prefer-u-button warns -->
+    <!-- raw <button> → @nustack/nuxt-ui/prefer-u-button warns -->
     <button class="p-2">
       Raw button
     </button>
diff --git a/modules/lint/playground/package.json b/modules/lint/playground/package.json
index f203b49..5ab8051 100644
--- a/modules/lint/playground/package.json
+++ b/modules/lint/playground/package.json
@@ -10,7 +10,7 @@
     "lint": "nuxt prepare && eslint ."
   },
   "dependencies": {
-    "@nustackjs/lint": "latest",
+    "@nustackjs/lint": "workspace:*",
     "@nuxt/content": "^3.15.0",
     "@nuxt/eslint": "^1.16.0",
     "@nuxt/ui": "^4.9.0",
diff --git a/modules/lint/src/config.ts b/modules/lint/src/config.ts
index ebe1a4d..83881dc 100644
--- a/modules/lint/src/config.ts
+++ b/modules/lint/src/config.ts
@@ -71,8 +71,8 @@ export interface NustackLintOptions {
   /** Vite build/runtime conventions. */
   vite?: ConcernToggle<ViteConcernOptions>
   /**
-   * Nuxt-ecosystem rules (Nuxt UI today; Pinia/Content later). `false` disables the whole
-   * ecosystem; an object tunes each module, e.g. `{ nuxtUi: false }`. Each module
+   * Nuxt-ecosystem rules (Nuxt UI and Nuxt Image today; Pinia/Content later). `false` disables
+   * the whole ecosystem; an object tunes each module, e.g. `{ nuxtUi: false }`. Each module
    * auto-gates on its own detection.
    */
   nuxtEcosystem?: NuxtEcosystemToggle
@@ -82,8 +82,6 @@ export interface NustackLintOptions {
   markdown?: ConcernToggle<MarkdownConcernOptions>
   /** Global rule changes, merged after every concern. */
   rules?: Rules
-  /** @deprecated Use `rules` instead. */
-  overrides?: Rules
   /**
    * Detected project context. Injected by the generated `.nuxt/nustack-eslint.mjs`
    * for Nuxt apps; the standalone `nustack()` factory fills it via
diff --git a/modules/lint/src/configs/nuxt-ecosystem.ts b/modules/lint/src/configs/nuxt-ecosystem.ts
index 7f55657..c3a8de5 100644
--- a/modules/lint/src/configs/nuxt-ecosystem.ts
+++ b/modules/lint/src/configs/nuxt-ecosystem.ts
@@ -1,27 +1,56 @@
+import type { NuxtImagePreset, NuxtUiPreset } from '@nustackjs/lint-plugin-nuxt-ecosystem'
 import type { Linter } from 'eslint'
 import type { NustackContext } from '../context'
 import type { ConcernOptions, ConcernToggle } from '../utils'
-import { nuxtUiConfigs } from '@nustackjs/lint-plugin-nuxt-ecosystem'
+import { nuxtImageConfig, nuxtUiConfig } from '@nustackjs/lint-plugin-nuxt-ecosystem'
 import { isEnabled, resolveConcernRules, subOptions } from '../utils'
 
-export type NuxtUiConcernOptions = ConcernOptions
+export interface NuxtUiConcernOptions extends ConcernOptions {
+  /** Rule preset from the Nuxt UI integration. @default 'recommended' */
+  preset?: NuxtUiPreset | false
+}
+
+export interface NuxtImageConcernOptions extends ConcernOptions {
+  /** Rule preset from the Nuxt Image integration. @default 'recommended' */
+  preset?: NuxtImagePreset | false
+}
 
 /** Options for detected Nuxt ecosystem integrations. */
 export interface NuxtEcosystemOptions {
   /** Nuxt UI component preferences. Auto-gated on `@nuxt/ui` detection. */
   nuxtUi?: ConcernToggle<NuxtUiConcernOptions>
+  /** Nuxt Image usage rules. Auto-gated on `@nuxt/image` detection. */
+  nuxtImage?: ConcernToggle<NuxtImageConcernOptions>
 }
 
 export type NuxtEcosystemToggle = ConcernToggle<NuxtEcosystemOptions>
 
+/**
+ * One config per supported module, each included only when that module is installed. Detection
+ * lives here (the context knows what the project has); the plugin owns the rules and presets.
+ */
 export function nuxtEcosystemConfig(
   context: NustackContext,
   options: NuxtEcosystemOptions = {},
 ): Linter.Config[] {
-  return isEnabled(options.nuxtUi, context.modules.nuxtUi)
-    ? nuxtUiConfigs({
-        prefix: context.nuxtUi.prefix,
-        rules: resolveConcernRules(subOptions(options.nuxtUi)),
-      })
-    : []
+  const configs: Linter.Config[] = []
+
+  if (isEnabled(options.nuxtUi, context.modules.nuxtUi)) {
+    const moduleOptions = subOptions(options.nuxtUi)
+    configs.push(nuxtUiConfig({
+      prefix: context.nuxtUi.prefix,
+      preset: moduleOptions.preset,
+      rules: resolveConcernRules(moduleOptions),
+    }))
+  }
+
+  if (isEnabled(options.nuxtImage, context.modules.nuxtImage)) {
+    const moduleOptions = subOptions(options.nuxtImage)
+    configs.push(nuxtImageConfig({
+      preset: moduleOptions.preset,
+      rules: resolveConcernRules(moduleOptions),
+    }))
+  }
+
+  return configs
 }
diff --git a/modules/lint/src/context/index.ts b/modules/lint/src/context/index.ts
index c6bb108..4d8deb9 100644
--- a/modules/lint/src/context/index.ts
+++ b/modules/lint/src/context/index.ts
@@ -2,6 +2,7 @@
 export interface NustackContext {
   modules: {
     nuxtUi: boolean
+    nuxtImage: boolean
     /** MDC-capable Markdown renderer (`@nuxt/content`, `@comark/nuxt`, or legacy `@nuxtjs/mdc`). */
     mdc: boolean
   }
@@ -27,7 +28,7 @@ export interface NustackContext {
 }
 
 export const EMPTY_CONTEXT: NustackContext = {
-  modules: { nuxtUi: false, mdc: false },
+  modules: { nuxtUi: false, nuxtImage: false, mdc: false },
   nuxtUi: { prefix: 'U' },
   tailwind: { detected: false, entryPoint: null },
   autoImports: [],
diff --git a/modules/lint/src/context/module-flags.ts b/modules/lint/src/context/module-flags.ts
index e11a18a..999c2a4 100644
--- a/modules/lint/src/context/module-flags.ts
+++ b/modules/lint/src/context/module-flags.ts
@@ -4,6 +4,7 @@ import type { NustackContext } from '.'
 export const MODULE_FLAGS = {
   '@nuxt/ui': 'nuxtUi',
   '@nuxt/ui-pro': 'nuxtUi',
+  '@nuxt/image': 'nuxtImage',
   '@comark/nuxt': 'mdc',
   '@nuxtjs/mdc': 'mdc',
 } as const satisfies Record<string, keyof NustackContext['modules']>
@@ -13,6 +14,7 @@ export function resolveModuleFlags(names: Iterable<string>): NustackContext['mod
 
   const modules: NustackContext['modules'] = {
     nuxtUi: false,
+    nuxtImage: false,
     mdc: false,
   }
   for (const [name, flag] of Object.entries(MODULE_FLAGS)) {
diff --git a/modules/lint/src/utils.ts b/modules/lint/src/utils.ts
index 5bbcc08..78993fb 100644
--- a/modules/lint/src/utils.ts
+++ b/modules/lint/src/utils.ts
@@ -9,16 +9,11 @@ export type Depth = 'quick' | 'full'
 export interface ConcernOptions {
   /** Per-concern rule changes, merged after the concern's defaults. */
   rules?: Rules
-  /** @deprecated Use `rules` instead. */
-  overrides?: Rules
 }
 
-/** Backward-compatible rule resolver while `rules` becomes the single public API. */
+/** Resolves an optional per-concern rule record. */
 export function resolveConcernRules(options: ConcernOptions): Rules {
-  return {
-    ...options.overrides,
-    ...options.rules,
-  }
+  return options.rules ?? {}
 }
 
 /** A per-concern toggle: `true`/`undefined` = default, `false` = off, object = tune. */
diff --git a/modules/lint/test/detect.test.ts b/modules/lint/test/detect.test.ts
index 2d89e8e..0f564ab 100644
--- a/modules/lint/test/detect.test.ts
+++ b/modules/lint/test/detect.test.ts
@@ -4,13 +4,13 @@ import { createContext, detectStandaloneContext } from '../src/context/detect'
 
 // Detection now resolves modules through node resolution (exsolve) instead of
 // parsing package.json, so a fixture's declared deps aren't automatically installed.
-// Mock the resolver to make only `@nuxt/ui` (and only from the nuxt-ui fixture)
-// resolvable; the Tailwind entry point is still found by the real CSS scan.
+// Mock the resolver to make only `@nuxt/ui` and `@nuxt/image` (and only from the nuxt-ui
+// fixture) resolvable; the Tailwind entry point is still found by the real CSS scan.
 vi.mock('exsolve', () => ({
   resolveModulePath: (id: string, opts: { from?: string }) => {
     const from = String(opts?.from ?? '')
-    if (from.includes('standalone-nuxt-ui') && id === '@nuxt/ui')
-      return '/virtual/node_modules/@nuxt/ui/index.mjs'
+    if (from.includes('standalone-nuxt-ui') && (id === '@nuxt/ui' || id === '@nuxt/image'))
+      return `/virtual/node_modules/${id}/index.mjs`
     return undefined
   },
 }))
@@ -19,9 +19,10 @@ const NUXT_UI_FIXTURE = fileURLToPath(new URL('./fixtures/standalone-nuxt-ui', i
 const PLAIN_FIXTURE = fileURLToPath(new URL('./fixtures/standalone-plain', import.meta.url))
 
 describe('detectStandaloneContext', () => {
-  it('detects @nuxt/ui (node resolution) and a Tailwind CSS entry point (css scan)', () => {
+  it('detects @nuxt/ui and @nuxt/image (node resolution) and a Tailwind CSS entry point (css scan)', () => {
     const ctx = detectStandaloneContext(NUXT_UI_FIXTURE)
     expect(ctx.modules.nuxtUi).toBe(true)
+    expect(ctx.modules.nuxtImage).toBe(true)
     expect(ctx.tailwind.detected).toBe(true)
     expect(ctx.tailwind.entryPoint).toBe('assets/css/main.css')
   })
@@ -29,6 +30,7 @@ describe('detectStandaloneContext', () => {
   it('reports nothing detected for a plain project', () => {
     const ctx = detectStandaloneContext(PLAIN_FIXTURE)
     expect(ctx.modules.nuxtUi).toBe(false)
+    expect(ctx.modules.nuxtImage).toBe(false)
     expect(ctx.tailwind.detected).toBe(false)
     expect(ctx.tailwind.entryPoint).toBeNull()
   })
diff --git a/modules/lint/test/e2e.test.ts b/modules/lint/test/e2e.test.ts
index 0372371..20d041a 100644
--- a/modules/lint/test/e2e.test.ts
+++ b/modules/lint/test/e2e.test.ts
@@ -11,7 +11,7 @@ import { applyNustackConfig } from '../src/config'
 const TAILWIND_ENTRY = fileURLToPath(new URL('./fixtures/tailwind.css', import.meta.url))
 
 const CONTEXT: NustackContext = {
-  modules: { nuxtUi: true, mdc: false },
+  modules: { nuxtUi: true, nuxtImage: true, mdc: false },
   nuxtUi: { prefix: 'U' },
   tailwind: { detected: true, entryPoint: TAILWIND_ENTRY },
   autoImports: ['ref', 'useRuntimeConfig'],
@@ -48,6 +48,40 @@ describe('e2e: composed config lints real code', () => {
     expect(ruleIds(messages)).toContain('@nustack/nuxt-ui/prefer-u-button')
   })
 
+  it('flags an unlabelled <NuxtImg> when @nuxt/image is detected (nuxt-image concern)', async () => {
+    const messages = await lint(`<script setup lang="ts"></script><template><NuxtImg src="/hero.png" /></template>`, 'app/pages/x.vue')
+    expect(ruleIds(messages)).toContain('@nustack/nuxt-image/require-image-alt')
+  })
+
+  it('applies the nuxt-image rules to Nuxt UI wrappers around NuxtImg, at the project prefix', async () => {
+    const code = `<script setup lang="ts"></script><template><NuColorModeImage light="~/assets/l.png" dark="/d.png" alt="Logo" width="20" height="20" /></template>`
+    const messages = await lint(
+      code,
+      'app/pages/x.vue',
+      { context: { ...CONTEXT, nuxtUi: { prefix: 'Nu' } } },
+    )
+    expect(ruleIds(messages)).toContain('@nustack/nuxt-image/no-assets-src')
+  })
+
+  it('does not apply nuxt-image rules to UI wrappers when Nuxt UI is disabled', async () => {
+    const code = `<script setup lang="ts"></script><template><UColorModeImage light="~/assets/l.png" dark="/d.png" /></template>`
+    const messages = await lint(
+      code,
+      'app/pages/x.vue',
+      { context: { ...CONTEXT, modules: { ...CONTEXT.modules, nuxtUi: false } } },
+    )
+    expect(ruleIds(messages).some(id => id.startsWith('@nustack/nuxt-image/'))).toBe(false)
+  })
+
+  it('leaves the nuxt-image rules out when the module is not installed', async () => {
+    const messages = await lint(
+      `<script setup lang="ts"></script><template><NuxtImg src="/hero.png" /></template>`,
+      'app/pages/x.vue',
+      { context: { ...CONTEXT, modules: { ...CONTEXT.modules, nuxtImage: false } } },
+    )
+    expect(ruleIds(messages).some(id => id.startsWith('@nustack/nuxt-image/'))).toBe(false)
+  })
+
   it('flags a redundant explicit auto-import (nuxt concern, fixable)', async () => {
     const messages = await lint(`import { ref } from 'vue'\nconst x = ref(1)`, 'app/composables/x.ts')
     expect(ruleIds(messages)).toContain('@nustack/nuxt/no-explicit-auto-import')
diff --git a/modules/lint/test/enforce.test.ts b/modules/lint/test/enforce.test.ts
index 80542de..d85b375 100644
--- a/modules/lint/test/enforce.test.ts
+++ b/modules/lint/test/enforce.test.ts
@@ -6,7 +6,7 @@ import { describe, expect, it } from 'vitest'
 import { applyNustackConfig } from '../src/config'
 
 const FULL_CONTEXT: NustackContext = {
-  modules: { nuxtUi: true, mdc: false },
+  modules: { nuxtUi: true, nuxtImage: true, mdc: false },
   nuxtUi: { prefix: 'U' },
   tailwind: { detected: true, entryPoint: 'app/assets/css/main.css' },
   autoImports: ['ref'],
diff --git a/modules/lint/test/style.test.ts b/modules/lint/test/style.test.ts
index 691d8a4..da261a7 100644
--- a/modules/lint/test/style.test.ts
+++ b/modules/lint/test/style.test.ts
@@ -6,7 +6,7 @@ import { describe, expect, it } from 'vitest'
 import { applyNustackConfig } from '../src/config'
 
 const FULL_CONTEXT: NustackContext = {
-  modules: { nuxtUi: true, mdc: false },
+  modules: { nuxtUi: true, nuxtImage: true, mdc: false },
   nuxtUi: { prefix: 'U' },
   tailwind: { detected: true, entryPoint: 'app/assets/css/main.css' },
   autoImports: ['ref'],
diff --git a/modules/lint/test/targets.test.ts b/modules/lint/test/targets.test.ts
index 3ff107a..977449e 100644
--- a/modules/lint/test/targets.test.ts
+++ b/modules/lint/test/targets.test.ts
@@ -10,7 +10,7 @@ import { resolveTarget } from '../src/target'
 // A context where every detectable feature is present, so concern gating is driven
 // purely by the target/options under test rather than by missing detection.
 const FULL_CONTEXT: NustackContext = {
-  modules: { nuxtUi: true, mdc: false },
+  modules: { nuxtUi: true, nuxtImage: true, mdc: false },
   nuxtUi: { prefix: 'U' },
   tailwind: { detected: true, entryPoint: 'app/assets/css/main.css' },
   autoImports: ['ref'],
@@ -87,9 +87,23 @@ describe('target: vue-app', () => {
     expect(ns).toContain('nustack/nuxt-ui')
   })
 
+  it('passes per-module ecosystem presets to the plugins', async () => {
+    const configs = await resolve({
+      target: 'vue-app',
+      nuxtEcosystem: {
+        nuxtUi: { preset: 'minimal' },
+        nuxtImage: { preset: 'minimal' },
+      },
+    })
+    expect(lastRuleValue(configs, '@nustack/nuxt-ui/require-avatar-alt')).toBe('error')
+    expect(lastRuleValue(configs, '@nustack/nuxt-ui/prefer-u-button')).toBeUndefined()
+    expect(lastRuleValue(configs, '@nustack/nuxt-image/require-image-alt')).toBe('error')
+    expect(lastRuleValue(configs, '@nustack/nuxt-image/prefer-nuxt-img')).toBeUndefined()
+  })
+
   it('drops tailwind/nuxtEcosystem when standalone detection finds nothing', async () => {
     const EMPTY: NustackContext = {
-      modules: { nuxtUi: false, mdc: false },
+      modules: { nuxtUi: false, nuxtImage: false, mdc: false },
       nuxtUi: { prefix: 'U' },
       tailwind: { detected: false, entryPoint: null },
       autoImports: [],
diff --git a/packages/lint-plugin-nuxt-ecosystem/README.md b/packages/lint-plugin-nuxt-ecosystem/README.md
index 497b6ee..15790ce 100644
--- a/packages/lint-plugin-nuxt-ecosystem/README.md
+++ b/packages/lint-plugin-nuxt-ecosystem/README.md
@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/@nustackjs/lint-plugin-nuxt-ecosystem)](https://www.npmjs.com/package/@nustackjs/lint-plugin-nuxt-ecosystem)
 [![GitHub License](https://img.shields.io/github/license/Zerya-Dev/nustack)](https://github.com/Zerya-Dev/nustack/blob/master/LICENSE)
 
-ESLint and [Oxlint](https://oxc.rs) rules for the [Nuxt module ecosystem](https://nuxt.com/modules). The plugin currently supports `@nuxt/ui` with plans to expand.
+ESLint rules for the [Nuxt module ecosystem](https://nuxt.com/modules). The plugin currently supports `@nuxt/ui` and `@nuxt/image`, with plans to expand.
 
 Every rule is based on the respective module's official documentation and recommendations.
 
@@ -11,64 +11,186 @@ If you are a developer of a popular module and want to add rules for it, please
 
 This package is used by [`@nustackjs/lint`](https://github.com/Zerya-Dev/nustack/tree/master/modules/lint) but can also be used standalone in any flat ESLint configuration.
 
-## Install
+## Usage
 
 ```bash
-pnpm add -D @nustackjs/lint-plugin-nuxt-ecosystem
+pnpm add -D eslint eslint-plugin-vue @typescript-eslint/parser @nustackjs/lint-plugin-nuxt-ecosystem
 ```
 
-## Usage
+Enable the modules your project actually has — nothing is implicit, this package never inspects
+your dependencies. Every rule reads the SFC template, so all of them are scoped to `**/*.vue`.
 
-Rule IDs start with `@nustack/nuxt-ui/<rule>`. You can use `configs.ui` to load only the Nuxt UI pack, or `configs.recommended` for all ecosystem packs included in this package.
+<details>
+<summary><b>ESLint</b> — <code>eslint.config.js</code></summary>
 
 ```js
-// eslint.config.js
-import nuxtEcosystem from '@nustackjs/lint-plugin-nuxt-ecosystem'
+// `eslint-plugin-vue` supplies the SFC parser these rules use to read the template.
+import tsParser from '@typescript-eslint/parser'
+import { nuxtEcosystemConfigs } from '@nustackjs/lint-plugin-nuxt-ecosystem'
+import vue from 'eslint-plugin-vue'
 
 export default [
-  // load just the Nuxt UI pack
-  nuxtEcosystem.configs.ui,
-
-  // or configure rules manually
+  ...vue.configs['flat/recommended'],
   {
-    plugins: { '@nustack/nuxt-ui': nuxtEcosystem },
-    rules: { '@nustack/nuxt-ui/prefer-u-button': 'warn' },
+    files: ['**/*.vue'],
+    languageOptions: { parserOptions: { parser: tsParser } },
   },
+  ...nuxtEcosystemConfigs({
+    nuxtUi: true,
+    nuxtImage: true,
+  }),
 ]
 ```
 
-These rules are compatible with Oxlint, although some may not work perfectly due to limited Vue support.
+`true` enables a module with its defaults; an options object both enables and configures it.
+Omitted modules stay disabled:
+
+```js
+nuxtEcosystemConfigs({ nuxtUi: true })
+nuxtEcosystemConfigs({ nuxtImage: { preset: 'minimal' } })
+```
+
+`nuxtUiConfig()` and `nuxtImageConfig()` are also exported directly, for when only one of them
+is needed.
+
+</details>
+
+<details>
+<summary><b>Antfu's ESLint config</b> — <code>eslint.config.js</code></summary>
+
+```js
+// `vue: true` brings in `eslint-plugin-vue`, which these rules need for the SFC parser.
+import antfu from '@antfu/eslint-config'
+import { nuxtEcosystemConfigs } from '@nustackjs/lint-plugin-nuxt-ecosystem'
+
+export default antfu(
+  { vue: true },
+  ...nuxtEcosystemConfigs({
+    nuxtUi: true,
+    nuxtImage: true,
+  }),
+)
+```
+
+</details>
+
+<details>
+<summary><b><code>@nustackjs/lint</code></b> — <code>eslint.config.js</code></summary>
+
+`@nustackjs/lint` detects `@nuxt/ui` and `@nuxt/image` and enables their configs for you, with
+the prefix your Nuxt UI setup uses. No ecosystem options are required:
+
+```js
+import nustack from '@nustackjs/lint'
+
+export default nustack()
+```
+
+Use `nuxtEcosystem` only to override the detected defaults or disable a module explicitly:
+
+```js
+export default nustack({
+  nuxtEcosystem: {
+    nuxtUi: { rules: { '@nustack/nuxt-ui/prefer-u-button': 'off' } },
+    nuxtImage: false,
+  },
+})
+```
+
+</details>
+
+### Oxlint
+
+Oxlint cannot run these rules yet. Its JavaScript plugin API does not currently support custom
+Vue file formats and parsers, while every rule in this package reads the Vue template AST. The
+rules use the `@oxlint/plugins` authoring API so they can become compatible when that limitation
+is removed, but this is not runtime support today.
+
+### Presets
+
+Every module ships the same two presets, and defaults to `recommended`:
+
+| Preset | Contents | Default |
+|---|---|---|
+| `minimal` | Invalid usage, accessibility defects, removed or renamed APIs (`error`) | |
+| `recommended` | `minimal` plus design-system preferences (`warn`) | Yes |
+
+```js
+nuxtEcosystemConfigs({
+  nuxtUi: { preset: 'minimal', prefix: 'Nu' },
+  nuxtImage: { preset: 'recommended' },
+})
+```
+
+`prefix` is a `nuxtUiConfig` option matching Nuxt UI's `ui.prefix`; it is shared with all UI
+rules through ESLint settings rather than repeated in every rule entry.
+
+### Individual Rules
+
+Use `preset: false` to enable only selected rules:
+
+```js
+nuxtUiConfig({
+  preset: false,
+  rules: {
+    '@nustack/nuxt-ui/require-avatar-alt': 'error',
+    '@nustack/nuxt-ui/prefer-u-button': 'warn',
+  },
+})
+```
+
+For full control, `nuxtUiPlugins`/`nuxtImagePlugins` (or `nuxtEcosystemPlugins` for all of them)
+and `nuxtUiRules()`/`nuxtImageRules()` are exported separately, so the plugins and their rule
+records can go into a flat-config object you build yourself.
 
 ## Rules
 
-### Nuxt UI
-
-| Rule | Description |
-|---|---|
-| [`@nustack/nuxt-ui/no-conflicting-state-props`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md) | Disallow controlled state together with `default-open` or `default-value`. |
-| [`@nustack/nuxt-ui/prefer-u-button`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md) | Prefer `<UButton>` over raw `<button>` when `@nuxt/ui` is available. |
-| [`@nustack/nuxt-ui/no-invalid-prop-combinations`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md) | Disallow documented incompatible prop combinations such as `UFileUpload variant="button" multiple`. |
-| [`@nustack/nuxt-ui/prefer-u-modal`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md) | Prefer `<UModal>` over raw `<dialog>`. |
-| [`@nustack/nuxt-ui/prefer-u-form-controls`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md) | Prefer Nuxt UI form controls over raw native form elements; type-aware (e.g. `<input type="number">` / `<UInput type="number">` → `<UInputNumber>`). |
-| [`@nustack/nuxt-ui/prefer-u-form-field`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md) | Prefer `<UFormField>` over identifiable hand-written label and form-control pairs. |
-| [`@nustack/nuxt-ui/prefer-u-link`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md) | Prefer `<ULink>` over raw `<a>` when `@nuxt/ui` is available. |
-| [`@nustack/nuxt-ui/prefer-u-kbd`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md) | Prefer `<UKbd>` over raw `<kbd>`. |
-| [`@nustack/nuxt-ui/prefer-u-progress`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md) | Prefer `<UProgress>` over raw `<progress>`. |
-| [`@nustack/nuxt-ui/prefer-u-separator`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md) | Prefer `<USeparator>` over raw `<hr>`. |
-| [`@nustack/nuxt-ui/prefer-u-table`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md) | Prefer `<UTable>` over raw `<table>` when `@nuxt/ui` is available. |
-| [`@nustack/nuxt-ui/prefer-u-tree`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md) | Prefer `<UTree>` over hand-written elements with explicit tree semantics. |
-| [`@nustack/nuxt-ui/no-deprecated-components`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md) | Disallow Nuxt UI components renamed in v4 (e.g. `UButtonGroup` → `UFieldGroup`). |
-| [`@nustack/nuxt-ui/no-deprecated-model-modifiers`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md) | Disallow the `v-model.nullify` modifier renamed to `.nullable` in Nuxt UI v4. |
-| [`@nustack/nuxt-ui/prefer-link-to`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md) | Prefer `to` over `href` on `ULink` and link-capable `UButton`. |
-| [`@nustack/nuxt-ui/prefer-u-icon`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md) | Prefer `<UIcon name="...">` over raw Iconify class markup. |
-| [`@nustack/nuxt-ui/require-avatar-alt`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md) | Require alt text on image-backed avatars. |
-| [`@nustack/nuxt-ui/require-form-field-name`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md) | Require `name` or `error-pattern` on form fields inside `<UForm>`. |
-| [`@nustack/nuxt-ui/require-form-control-label`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md) | Require an accessible label for Nuxt UI form controls. |
-| [`@nustack/nuxt-ui/require-icon-button-label`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md) | Require an accessible label for icon-, avatar-, and loading-only buttons. |
-| [`@nustack/nuxt-ui/require-overlay-title`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md) | Require accessible titles on modal, drawer, and slideover. |
-| [`@nustack/nuxt-ui/require-popover-content`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md) | Require a `#content` slot on `<UPopover>`. |
-| [`@nustack/nuxt-ui/require-tooltip-content`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md) | Require tooltip text or a content slot. |
-| [`@nustack/nuxt-ui/require-u-app`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md) | Require `<UApp>` in the Nuxt `app.vue` root. |
+Each module has its own rule-id namespace and presets, so rules for a module you do not use are
+never registered.
+
+### `@nuxt/ui`
+
+Rule IDs use the `@nustack/nuxt-ui/<rule>` namespace. Set `prefix` on `nuxtUiConfig()` (or the
+`nuxtUi` options passed to `nuxtEcosystemConfigs()`), not on individual rules.
+
+| Rule | Preset | Fix | Description |
+|---|---|---|---|
+| [`no-conflicting-state-props`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md) | `minimal` | No | Disallow controlled state together with its ignored default prop. |
+| [`no-invalid-prop-combinations`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md) | `minimal` | No | Disallow documented incompatible prop combinations. |
+| [`require-avatar-alt`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md) | `minimal` | No | Require alt text on image-backed avatars. |
+| [`require-form-control-label`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md) | `minimal` | No | Require an accessible label for form controls. |
+| [`require-form-field-name`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.md) | `minimal` | No | Require a validation target on fields inside `UForm`. |
+| [`require-icon-button-label`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md) | `minimal` | No | Require an accessible name for icon-only buttons. |
+| [`require-nested-form-prop`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.md) | `minimal` | No | Require `nested` on a `UForm` inside another `UForm`. |
+| [`require-overlay-title`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.md) | `minimal` | No | Require accessible titles on modal, drawer, and slideover. |
+| [`require-popover-content`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.md) | `minimal` | No | Require a content slot on `UPopover`. |
+| [`require-tooltip-content`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.md) | `minimal` | No | Require tooltip text or a content slot. |
+| [`require-u-app`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md) | `minimal` | No | Require `UApp` around the Nuxt application root. |
+| [`no-deprecated-components`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md) | `minimal` | Partial | Replace simple Nuxt UI component renames (v3 and v4). |
+| [`no-deprecated-model-modifiers`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md) | `minimal` | Yes | Replace the v3 `nullify` model modifier with `nullable`. |
+| [`prefer-link-to`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md) | `recommended` | No | Prefer `to` over `href` for internal navigation. |
+| [`prefer-u-button`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md) | `recommended` | No | Prefer `UButton` over raw `button`. |
+| [`prefer-u-form-controls`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md) | `recommended` | No | Prefer Nuxt UI form controls over native controls. |
+| [`prefer-u-form-field`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md) | `recommended` | No | Prefer `UFormField` over hand-written label/control pairs. |
+| [`prefer-u-icon`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md) | `recommended` | No | Prefer `UIcon` over raw Iconify class markup. |
+| [`prefer-u-kbd`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md) | `recommended` | No | Prefer `UKbd` over raw `kbd`. |
+| [`prefer-u-link`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md) | `recommended` | No | Prefer `ULink` over raw anchors. |
+| [`prefer-u-modal`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md) | `recommended` | No | Prefer `UModal` over raw dialogs. |
+| [`prefer-u-progress`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md) | `recommended` | No | Prefer `UProgress` over raw progress elements. |
+| [`prefer-u-separator`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md) | `recommended` | No | Prefer `USeparator` over raw horizontal rules. |
+| [`prefer-u-table`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md) | `recommended` | No | Prefer `UTable` over hand-written tables. |
+| [`prefer-u-tree`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md) | `recommended` | No | Prefer `UTree` over hand-written tree semantics. |
+
+### `@nuxt/image`
+
+Rule IDs use the `@nustack/nuxt-image/<rule>` namespace. When `nuxtUiConfig()` is also present,
+they cover Nuxt UI's `<UColorModeImage>` and `<ProseImg>`.
+
+| Rule | Preset | Fix | Description |
+|---|---|---|---|
+| [`no-assets-src`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.md) | `minimal` | No | Disallow build-time `~/assets` paths in `src`. |
+| [`require-image-alt`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.md) | `minimal` | No | Require alt text on `NuxtImg` and `NuxtPicture`. |
+| [`prefer-nuxt-img`](https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.md) | `recommended` | No | Prefer `NuxtImg` over raw `img`. |
 
 ## License
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/package.json b/packages/lint-plugin-nuxt-ecosystem/package.json
index ef27cba..afdeab7 100644
--- a/packages/lint-plugin-nuxt-ecosystem/package.json
+++ b/packages/lint-plugin-nuxt-ecosystem/package.json
@@ -2,7 +2,7 @@
   "name": "@nustackjs/lint-plugin-nuxt-ecosystem",
   "type": "module",
   "version": "0.4.0",
-  "description": "ESLint and Oxlint rules for the Nuxt module ecosystem (Nuxt UI). Used by @nustackjs/lint, usable standalone.",
+  "description": "ESLint rules for the most popular Nuxt modules and tools. Used by @nustackjs/lint, usable standalone.",
   "author": "Norbiros <me@norbiros.dev>",
   "license": "MIT",
   "homepage": "https://github.com/Zerya-Dev/nustack/tree/master/packages/lint-plugin-nuxt-ecosystem#readme",
@@ -13,10 +13,8 @@
   },
   "keywords": [
     "eslint",
-    "oxlint",
     "eslint-plugin",
     "nuxt",
-    "nuxt-ui",
     "nustack",
     "lint"
   ],
@@ -28,7 +26,8 @@
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs",
       "default": "./dist/index.mjs"
-    }
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "LICENSE",
@@ -38,6 +37,7 @@
   ],
   "scripts": {
     "build": "tsdown src/index.ts --dts --clean",
+    "prepack": "pnpm build",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },
@@ -48,6 +48,7 @@
     "@oxlint/plugins": "catalog:eslint"
   },
   "devDependencies": {
+    "@typescript-eslint/parser": "catalog:eslint",
     "eslint": "catalog:eslint",
     "tsdown": "catalog:build",
     "typescript": "catalog:typescript",
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/index.test.ts
deleted file mode 100644
index 69117d4..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/index.test.ts
+++ /dev/null
@@ -1,34 +0,0 @@
-import type { Linter } from 'eslint'
-import { describe, expect, it } from 'vitest'
-import plugin, { nuxtUiConfigs } from './index.js'
-
-function packRules(options?: Parameters<typeof nuxtUiConfigs>[0]): Partial<Linter.RulesRecord> {
-  return nuxtUiConfigs(options).find(config => config.name === 'nustack/nuxt-ui')!.rules!
-}
-
-function levelOf(entry: Linter.RuleEntry | undefined): string {
-  return Array.isArray(entry) ? String(entry[0]) : String(entry)
-}
-
-describe('nuxtUiConfigs', () => {
-  it('configures every rule the plugin exposes', () => {
-    expect(Object.keys(packRules()).sort()).toEqual(
-      Object.keys(plugin.rules!).map(name => `@nustack/nuxt-ui/${name}`).sort(),
-    )
-  })
-
-  it('errors on broken code and warns on preferences', () => {
-    const rules = packRules()
-    expect(levelOf(rules['@nustack/nuxt-ui/require-icon-button-label'])).toBe('error')
-    expect(levelOf(rules['@nustack/nuxt-ui/no-deprecated-components'])).toBe('error')
-    expect(levelOf(rules['@nustack/nuxt-ui/prefer-u-button'])).toBe('warn')
-    expect(levelOf(rules['@nustack/nuxt-ui/require-form-field-name'])).toBe('warn')
-  })
-
-  it('passes a custom prefix without losing the severity', () => {
-    const rules = packRules({ prefix: 'Nu' })
-    expect(rules['@nustack/nuxt-ui/require-icon-button-label']).toEqual(['error', { prefix: 'Nu' }])
-    // No component resolution, so no `prefix` option to accept.
-    expect(rules['@nustack/nuxt-ui/prefer-u-icon']).toBe('warn')
-  })
-})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
index 9c37d59..fee86cc 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/index.ts
@@ -1,163 +1,35 @@
-import type { ESLint, Linter, Rule } from 'eslint'
-import { eslintCompatPlugin } from '@oxlint/plugins'
-import { noConflictingStateProps as noConflictingStatePropsRule } from './rules/nuxt-ui/no-conflicting-state-props/index.js'
-import { noDeprecatedComponents as noDeprecatedComponentsRule } from './rules/nuxt-ui/no-deprecated-components/index.js'
-import { noDeprecatedModelModifiers as noDeprecatedModelModifiersRule } from './rules/nuxt-ui/no-deprecated-model-modifiers/index.js'
-import { noInvalidPropCombinations as noInvalidPropCombinationsRule } from './rules/nuxt-ui/no-invalid-prop-combinations/index.js'
-import { preferLinkTo as preferLinkToRule } from './rules/nuxt-ui/prefer-link-to/index.js'
-import { preferUButton as preferUButtonRule } from './rules/nuxt-ui/prefer-u-button/index.js'
-import { preferUFormControls as preferUFormControlsRule } from './rules/nuxt-ui/prefer-u-form-controls/index.js'
-import { preferUFormField as preferUFormFieldRule } from './rules/nuxt-ui/prefer-u-form-field/index.js'
-import { preferUIcon as preferUIconRule } from './rules/nuxt-ui/prefer-u-icon/index.js'
-import { preferUKbd as preferUKbdRule } from './rules/nuxt-ui/prefer-u-kbd/index.js'
-import { preferULink as preferULinkRule } from './rules/nuxt-ui/prefer-u-link/index.js'
-import { preferUModal as preferUModalRule } from './rules/nuxt-ui/prefer-u-modal/index.js'
-import { preferUProgress as preferUProgressRule } from './rules/nuxt-ui/prefer-u-progress/index.js'
-import { preferUSeparator as preferUSeparatorRule } from './rules/nuxt-ui/prefer-u-separator/index.js'
-import { preferUTable as preferUTableRule } from './rules/nuxt-ui/prefer-u-table/index.js'
-import { preferUTree as preferUTreeRule } from './rules/nuxt-ui/prefer-u-tree/index.js'
-import { requireAvatarAlt as requireAvatarAltRule } from './rules/nuxt-ui/require-avatar-alt/index.js'
-import { requireFormControlLabel as requireFormControlLabelRule } from './rules/nuxt-ui/require-form-control-label/index.js'
-import { requireFormFieldName as requireFormFieldNameRule } from './rules/nuxt-ui/require-form-field-name/index.js'
-import { requireIconButtonLabel as requireIconButtonLabelRule } from './rules/nuxt-ui/require-icon-button-label/index.js'
-import { requireOverlayTitle as requireOverlayTitleRule } from './rules/nuxt-ui/require-overlay-title/index.js'
-import { requirePopoverContent as requirePopoverContentRule } from './rules/nuxt-ui/require-popover-content/index.js'
-import { requireTooltipContent as requireTooltipContentRule } from './rules/nuxt-ui/require-tooltip-content/index.js'
-import { requireUApp as requireUAppRule } from './rules/nuxt-ui/require-u-app/index.js'
-
-const plugin = eslintCompatPlugin({
-  meta: {
-    name: '@nustack/nuxt-ui',
-  },
-  rules: {
-    'no-conflicting-state-props': noConflictingStatePropsRule,
-    'no-deprecated-components': noDeprecatedComponentsRule,
-    'no-deprecated-model-modifiers': noDeprecatedModelModifiersRule,
-    'no-invalid-prop-combinations': noInvalidPropCombinationsRule,
-    'prefer-link-to': preferLinkToRule,
-    'prefer-u-button': preferUButtonRule,
-    'prefer-u-form-controls': preferUFormControlsRule,
-    'prefer-u-form-field': preferUFormFieldRule,
-    'prefer-u-icon': preferUIconRule,
-    'prefer-u-kbd': preferUKbdRule,
-    'prefer-u-link': preferULinkRule,
-    'prefer-u-modal': preferUModalRule,
-    'prefer-u-progress': preferUProgressRule,
-    'prefer-u-separator': preferUSeparatorRule,
-    'prefer-u-table': preferUTableRule,
-    'prefer-u-tree': preferUTreeRule,
-    'require-avatar-alt': requireAvatarAltRule,
-    'require-form-control-label': requireFormControlLabelRule,
-    'require-form-field-name': requireFormFieldNameRule,
-    'require-icon-button-label': requireIconButtonLabelRule,
-    'require-overlay-title': requireOverlayTitleRule,
-    'require-popover-content': requirePopoverContentRule,
-    'require-tooltip-content': requireTooltipContentRule,
-    'require-u-app': requireUAppRule,
-  },
-}) as unknown as ESLint.Plugin & {
-  configs: {
-    /** The Nuxt UI pack, Vue-SFC-scoped, ready to spread into a flat config. */
-    ui: Linter.Config[]
-    /** Union of every ecosystem sub-pack shipped here (today: just Nuxt UI). */
-    recommended: Linter.Config[]
-  }
+import type { ESLint, Linter } from 'eslint'
+import type { NuxtImageConfigOptions } from './rules/nuxt-image/module.js'
+import type { NuxtUiConfigOptions } from './rules/nuxt-ui/module.js'
+import { nuxtImageConfig, nuxtImagePlugins } from './rules/nuxt-image/module.js'
+import { nuxtUiConfig, nuxtUiPlugins } from './rules/nuxt-ui/module.js'
+
+export * from './rules/nuxt-image/module.js'
+export * from './rules/nuxt-ui/module.js'
+
+export interface NuxtEcosystemOptions {
+  /** Enable Nuxt UI with defaults (`true`) or module-specific options. */
+  nuxtUi?: NuxtUiConfigOptions | boolean
+  /** Enable Nuxt Image with defaults (`true`) or module-specific options. */
+  nuxtImage?: NuxtImageConfigOptions | boolean
 }
 
-const pluginRef = { '@nustack/nuxt-ui': plugin }
-
-export const NUXT_UI_GLOB = ['**/*.vue']
-
-export interface NuxtUiConfigsOptions {
-  /** Cumulative variant; `minimal` ships nothing, `recommended` (default) the rule set. */
-  variant?: 'minimal' | 'recommended'
-  /** Component prefix from `ui.prefix`. Passed to every rule that resolves components. */
-  prefix?: string
-  /** Extra rule overrides, merged onto the Vue-SFC scope. */
-  rules?: Linter.RulesRecord
-}
-
-const RULES = Object.keys(plugin.rules!).sort()
-
-function ruleMeta(name: string): Rule.RuleMetaData | undefined {
-  return (plugin.rules![name] as Rule.RuleModule).meta
-}
+/** Builds configs only for explicitly enabled modules. Dependency detection lives in `@nustackjs/lint`. */
+export function nuxtEcosystemConfigs(options: NuxtEcosystemOptions): Linter.Config[] {
+  if (!options)
+    throw new TypeError('nuxtEcosystemConfigs() requires an object listing the modules to enable')
 
-/** Whether a rule resolves components, and so takes the `prefix` option. */
-function acceptsPrefix(name: string): boolean {
-  const schema = ruleMeta(name)?.schema
-  return Array.isArray(schema) && Boolean((schema[0] as any)?.properties?.prefix)
-}
-
-/**
- * `problem` rules report code that is already broken — a removed v4 API, props that cancel each
- * other out, a control with no accessible name — so they error. `suggestion` rules express a
- * preference between two things that both work, so they only warn.
- */
-function severityOf(name: string): 'error' | 'warn' {
-  return ruleMeta(name)?.type === 'problem' ? 'error' : 'warn'
-}
-
-/** Returns Vue-SFC-scoped Nuxt UI configs. */
-export function nuxtUiConfigs(options: NuxtUiConfigsOptions = {}): Linter.Config[] {
-  const { variant = 'recommended', prefix = 'U', rules } = options
   const configs: Linter.Config[] = []
 
-  if (variant !== 'minimal') {
-    configs.push({
-      name: 'nustack/nuxt-ui',
-      files: NUXT_UI_GLOB,
-      plugins: pluginRef,
-      rules: Object.fromEntries(RULES.map((name) => {
-        const level = severityOf(name)
-        return [
-          `@nustack/nuxt-ui/${name}`,
-          prefix !== 'U' && acceptsPrefix(name) ? [level, { prefix }] : level,
-        ]
-      })),
-    })
-  }
-
-  if (rules && Object.keys(rules).length) {
-    configs.push({
-      name: 'nustack/nuxt-ui/rules',
-      files: NUXT_UI_GLOB,
-      plugins: pluginRef,
-      rules,
-    })
-  }
+  if (options.nuxtUi)
+    configs.push(nuxtUiConfig(options.nuxtUi === true ? {} : options.nuxtUi))
+  if (options.nuxtImage)
+    configs.push(nuxtImageConfig(options.nuxtImage === true ? {} : options.nuxtImage))
 
   return configs
 }
 
-plugin.configs = {
-  ui: nuxtUiConfigs(),
-  // Union preset for every ecosystem sub-pack shipped by this package.
-  recommended: nuxtUiConfigs(),
+export const nuxtEcosystemPlugins: Record<string, ESLint.Plugin> = {
+  ...nuxtUiPlugins,
+  ...nuxtImagePlugins,
 }
-
-export const preferUButton: Rule.RuleModule = plugin.rules!['prefer-u-button'] as Rule.RuleModule
-export const preferUFormControls: Rule.RuleModule = plugin.rules!['prefer-u-form-controls'] as Rule.RuleModule
-export const preferUFormField: Rule.RuleModule = plugin.rules!['prefer-u-form-field'] as Rule.RuleModule
-export const preferULink: Rule.RuleModule = plugin.rules!['prefer-u-link'] as Rule.RuleModule
-export const preferUTable: Rule.RuleModule = plugin.rules!['prefer-u-table'] as Rule.RuleModule
-export const preferUTree: Rule.RuleModule = plugin.rules!['prefer-u-tree'] as Rule.RuleModule
-export const noDeprecatedComponents: Rule.RuleModule = plugin.rules!['no-deprecated-components'] as Rule.RuleModule
-export const noDeprecatedModelModifiers: Rule.RuleModule = plugin.rules!['no-deprecated-model-modifiers'] as Rule.RuleModule
-export const noConflictingStateProps: Rule.RuleModule = plugin.rules!['no-conflicting-state-props'] as Rule.RuleModule
-export const noInvalidPropCombinations: Rule.RuleModule = plugin.rules!['no-invalid-prop-combinations'] as Rule.RuleModule
-export const preferLinkTo: Rule.RuleModule = plugin.rules!['prefer-link-to'] as Rule.RuleModule
-export const preferUIcon: Rule.RuleModule = plugin.rules!['prefer-u-icon'] as Rule.RuleModule
-export const preferUKbd: Rule.RuleModule = plugin.rules!['prefer-u-kbd'] as Rule.RuleModule
-export const preferUModal: Rule.RuleModule = plugin.rules!['prefer-u-modal'] as Rule.RuleModule
-export const preferUProgress: Rule.RuleModule = plugin.rules!['prefer-u-progress'] as Rule.RuleModule
-export const preferUSeparator: Rule.RuleModule = plugin.rules!['prefer-u-separator'] as Rule.RuleModule
-export const requirePopoverContent: Rule.RuleModule = plugin.rules!['require-popover-content'] as Rule.RuleModule
-export const requireFormControlLabel: Rule.RuleModule = plugin.rules!['require-form-control-label'] as Rule.RuleModule
-export const requireUApp: Rule.RuleModule = plugin.rules!['require-u-app'] as Rule.RuleModule
-export const requireAvatarAlt: Rule.RuleModule = plugin.rules!['require-avatar-alt'] as Rule.RuleModule
-export const requireFormFieldName: Rule.RuleModule = plugin.rules!['require-form-field-name'] as Rule.RuleModule
-export const requireIconButtonLabel: Rule.RuleModule = plugin.rules!['require-icon-button-label'] as Rule.RuleModule
-export const requireOverlayTitle: Rule.RuleModule = plugin.rules!['require-overlay-title'] as Rule.RuleModule
-export const requireTooltipContent: Rule.RuleModule = plugin.rules!['require-tooltip-content'] as Rule.RuleModule
-export default plugin
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/components.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/components.ts
new file mode 100644
index 0000000..cf8cd45
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/components.ts
@@ -0,0 +1,57 @@
+import type { Context } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import type { ComponentMatcher } from '../../utils/component-matcher.js'
+import { createComponentMatcher } from '../../utils/component-matcher.js'
+import { hasNuxtUi, NUXT_UI_MODULE, nuxtUiPrefix } from '../nuxt-ui/components.js'
+
+const NUXT_IMAGE_MODULE = /^(?:@nuxt\/image(?:\/|$)|#components$)/
+
+const PROSE_PREFIX = 'Prose'
+
+export interface ImageTarget {
+  name: string
+  sources: readonly string[]
+}
+
+const IMAGE_COMPONENTS: Record<string, readonly string[]> = {
+  NuxtImg: ['src'],
+  NuxtPicture: ['src'],
+}
+
+// These wrappers resolve to `NuxtImg` and forward its image attributes.
+const NUXT_UI_IMAGE_COMPONENTS: Record<string, readonly string[]> = {
+  ColorModeImage: ['light', 'dark'],
+}
+
+const PROSE_IMAGE_COMPONENTS: Record<string, readonly string[]> = {
+  Img: ['src'],
+}
+
+export interface ImageMatcher {
+  match: (node: VueAST.VElement) => ImageTarget | null
+}
+
+function targetOf(matcher: ComponentMatcher, node: VueAST.VElement, components: Record<string, readonly string[]>): ImageTarget | null {
+  const match = matcher.matchOf(node, Object.keys(components))
+  return match === null ? null : { name: matcher.rawName(node), sources: components[match]! }
+}
+
+export function createNuxtImageMatcher(context: Context): ComponentMatcher {
+  return createComponentMatcher(context, { module: NUXT_IMAGE_MODULE, prefix: '' })
+}
+
+export function createImageMatcher(context: Context): ImageMatcher {
+  const image = createNuxtImageMatcher(context)
+  const nuxtUi = hasNuxtUi(context)
+    ? createComponentMatcher(context, { module: NUXT_UI_MODULE, prefix: nuxtUiPrefix(context) })
+    : null
+  const prose = hasNuxtUi(context)
+    ? createComponentMatcher(context, { module: NUXT_UI_MODULE, prefix: PROSE_PREFIX })
+    : null
+
+  return {
+    match: node => targetOf(image, node, IMAGE_COMPONENTS)
+      ?? (nuxtUi && targetOf(nuxtUi, node, NUXT_UI_IMAGE_COMPONENTS))
+      ?? (prose && targetOf(prose, node, PROSE_IMAGE_COMPONENTS)),
+  }
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/module.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/module.ts
new file mode 100644
index 0000000..76f7c82
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/module.ts
@@ -0,0 +1,64 @@
+import type { Plugin } from '@oxlint/plugins'
+import type { ESLint, Linter } from 'eslint'
+import { eslintCompatPlugin } from '@oxlint/plugins'
+import { nuxtUiSettings } from '../nuxt-ui/components.js'
+import { noAssetsSrc } from './no-assets-src/index.js'
+import { preferNuxtImg } from './prefer-nuxt-img/index.js'
+import { requireImageAlt } from './require-image-alt/index.js'
+
+export const nuxtImagePlugin = eslintCompatPlugin({
+  meta: {
+    name: '@nustackjs/lint-plugin-nuxt-ecosystem/nuxt-image',
+  },
+  rules: {
+    'no-assets-src': noAssetsSrc,
+    'prefer-nuxt-img': preferNuxtImg,
+    'require-image-alt': requireImageAlt,
+  },
+}) as Plugin & ESLint.Plugin
+
+export type NuxtImagePreset = 'minimal' | 'recommended'
+export interface NuxtImageRulesOptions {
+  preset?: NuxtImagePreset | false
+  rules?: Linter.RulesRecord
+}
+export interface NuxtImageConfigOptions extends NuxtImageRulesOptions {
+  nuxtUi?: false | { prefix?: string }
+}
+
+const NUXT_IMAGE_CORRECTNESS_RULES = {
+  'no-assets-src': 'error',
+  'require-image-alt': 'error',
+} as const satisfies Record<string, 'error'>
+
+const NUXT_IMAGE_CONVENTION_RULES = {
+  'prefer-nuxt-img': 'warn',
+} as const satisfies Record<string, 'warn'>
+
+export const NUXT_IMAGE_PRESET_RULES = {
+  minimal: NUXT_IMAGE_CORRECTNESS_RULES,
+  recommended: { ...NUXT_IMAGE_CORRECTNESS_RULES, ...NUXT_IMAGE_CONVENTION_RULES },
+} as const
+
+export const nuxtImagePlugins: Record<string, ESLint.Plugin> = { '@nustack/nuxt-image': nuxtImagePlugin }
+
+export function nuxtImageRules(options: NuxtImageRulesOptions = {}): Linter.RulesRecord {
+  const { preset = 'recommended', rules = {} } = options
+  const configured = preset === false
+    ? {}
+    : Object.fromEntries(Object.entries(NUXT_IMAGE_PRESET_RULES[preset]).map(([name, level]) => [`@nustack/nuxt-image/${name}`, level]))
+  return { ...configured, ...rules }
+}
+
+export function nuxtImageConfig(options: NuxtImageConfigOptions = {}): Linter.Config {
+  const { nuxtUi, ...rulesOptions } = options
+  const config: Linter.Config = {
+    name: 'nustack/nuxt-image',
+    files: ['**/*.vue'],
+    plugins: nuxtImagePlugins,
+    rules: nuxtImageRules(rulesOptions),
+  }
+  return nuxtUi
+    ? { ...config, settings: nuxtUiSettings(nuxtUi.prefix) }
+    : config
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.md
new file mode 100644
index 0000000..a246ef0
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.md
@@ -0,0 +1,40 @@
+# `@nustack/nuxt-image/no-assets-src`
+
+Disallow a build-time `assets/` alias in the `src` of `<NuxtImg>` and `<NuxtPicture>`.
+
+`src` is not resolved by the bundler — it is handed to the image provider as a URL at runtime, so
+`~/assets/hero.png` is requested verbatim and 404s in production. Images the provider optimises
+belong in `public/`; a file that has to stay in `assets/` must be imported and bound, which this
+rule leaves alone, along with anything else it cannot resolve statically.
+
+Every URL attribute is checked, including both `light` and `dark` on `<UColorModeImage>`.
+
+## Incorrect
+
+```vue
+<template>
+  <NuxtImg src="~/assets/hero.png" alt="" width="640" height="360" />
+  <NuxtImg src="@/assets/hero.png" alt="" width="640" height="360" />
+</template>
+```
+
+## Correct
+
+```vue
+<script setup lang="ts">
+import hero from '~/assets/hero.png'
+</script>
+
+<template>
+  <!-- served from `public/` and optimised by the provider -->
+  <NuxtImg src="/hero.png" alt="" width="640" height="360" />
+
+  <!-- bundled asset, resolved by Vite -->
+  <NuxtImg :src="hero" alt="" width="640" height="360" />
+</template>
+```
+
+## Further reading
+
+- [Nuxt Image — static images](https://image.nuxt.com/get-started/installation#static-images)
+- [Nuxt — `public/` vs `assets/`](https://nuxt.com/docs/guide/directory-structure/public)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.test.ts
new file mode 100644
index 0000000..7dfcfd1
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.test.ts
@@ -0,0 +1,43 @@
+import { describe, it } from 'vitest'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtImagePlugin } from '../../../index.js'
+
+describe('no-assets-src', () => {
+  it('reports build-time assets aliases in src', () => {
+    tester.run('no-assets-src', nuxtImagePlugin.rules['no-assets-src'], {
+      valid: [
+        '<template><NuxtImg src="/hero.png" alt="" /></template>',
+        '<template><NuxtImg src="https://cdn.example.com/assets/hero.png" alt="" /></template>',
+        '<template><NuxtImg :src="hero" alt="" /></template>',
+        '<template><NuxtImg src="/assets/hero.png" alt="" /></template>',
+        '<template><img src="~/assets/hero.png" alt=""></template>',
+        '<template><UAvatar src="~/assets/hero.png" /></template>',
+        '<template><UColorModeImage light="/l.png" dark="/d.png" alt="" /></template>',
+      ],
+      invalid: [
+        {
+          code: '<template><NuxtImg src="~/assets/hero.png" alt="" /></template>',
+          errors: [{ messageId: 'assetsSrc', data: { component: 'NuxtImg', attribute: 'src', src: '~/assets/hero.png' } }],
+        },
+        { code: '<template><NuxtImg src="@/assets/hero.png" alt="" /></template>', errors: [{ messageId: 'assetsSrc' }] },
+        { code: '<template><NuxtImg src="~~/assets/hero.png" alt="" /></template>', errors: [{ messageId: 'assetsSrc' }] },
+        { code: '<template><NuxtImg src="~assets/hero.png" alt="" /></template>', errors: [{ messageId: 'assetsSrc' }] },
+        { code: '<template><NuxtPicture src="~/assets/hero.png" alt="" /></template>', errors: [{ messageId: 'assetsSrc' }] },
+        { code: '<template><NuxtImg :src="\'~/assets/hero.png\'" alt="" /></template>', errors: [{ messageId: 'assetsSrc' }] },
+        {
+          code: '<template><ProseImg src="~/assets/hero.png" alt="" /></template>',
+          settings: { '@nustack/nuxt-ui': { enabled: true, prefix: 'U' } },
+          errors: [{ messageId: 'assetsSrc', data: { component: 'ProseImg', attribute: 'src', src: '~/assets/hero.png' } }],
+        },
+        {
+          code: '<template><UColorModeImage light="~/assets/l.png" dark="~/assets/d.png" alt="" /></template>',
+          settings: { '@nustack/nuxt-ui': { enabled: true, prefix: 'U' } },
+          errors: [
+            { messageId: 'assetsSrc', data: { component: 'UColorModeImage', attribute: 'light', src: '~/assets/l.png' } },
+            { messageId: 'assetsSrc', data: { component: 'UColorModeImage', attribute: 'dark', src: '~/assets/d.png' } },
+          ],
+        },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.ts
new file mode 100644
index 0000000..b1132cf
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/no-assets-src/index.ts
@@ -0,0 +1,44 @@
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, getStaticAttribute } from '../../../utils/template.js'
+import { createImageMatcher } from '../components.js'
+
+const ASSETS_ALIAS = /^(?:~~?|@@?)\/?assets\//
+
+export const noAssetsSrc: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Disallow `~/assets` paths in `@nuxt/image` sources, which resolve only at build time.',
+      url: docsUrl('nuxt-image/no-assets-src'),
+    },
+    schema: [],
+    messages: {
+      assetsSrc: '`<{{ component }}>` resolves `{{ attribute }}` as a URL at runtime, so `{{ src }}` never reaches the image provider. Move the file to `public/`.',
+    },
+  },
+  create(context: Context): Visitor {
+    const matcher = createImageMatcher(context)
+
+    return defineTemplateVisitor(context, {
+      VElement(node: VueAST.VElement) {
+        const image = matcher.match(node)
+        if (image === null)
+          return
+
+        for (const attribute of image.sources) {
+          const src = getStaticAttribute(node, attribute)
+          if (src === null || !ASSETS_ALIAS.test(src))
+            continue
+
+          context.report({
+            loc: node.startTag.loc,
+            messageId: 'assetsSrc',
+            data: { component: image.name, attribute, src },
+          })
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.md
new file mode 100644
index 0000000..cba333d
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.md
@@ -0,0 +1,37 @@
+# `@nustack/nuxt-image/prefer-nuxt-img`
+
+Prefer `<NuxtImg>` over a raw `<img>` once `@nuxt/image` is installed. A native `<img>` bypasses
+the provider entirely: no resizing, no modern formats, no `densities`, and no lazy-loading
+defaults.
+
+An `<img>` inside a native `<picture>` or inside `<NuxtPicture>` is correct markup and stays
+unreported. Only genuine native elements are reported: a component whose name merely lowercases to
+`img` (`<Img>`) is left alone, as is `<image>` inside SVG.
+
+Suppress intentional native markup with
+`<!-- eslint-disable-next-line @nustack/nuxt-image/prefer-nuxt-img -->`.
+
+## Incorrect
+
+```vue
+<template>
+  <img src="/hero.png" alt="" width="640" height="360">
+</template>
+```
+
+## Correct
+
+```vue
+<template>
+  <NuxtImg src="/hero.png" alt="" width="640" height="360" />
+
+  <picture>
+    <source srcset="/hero.avif" type="image/avif">
+    <img src="/hero.png" alt="" width="640" height="360">
+  </picture>
+</template>
+```
+
+## Further reading
+
+- [Nuxt Image `<NuxtImg>`](https://image.nuxt.com/usage/nuxt-img)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.test.ts
new file mode 100644
index 0000000..e2dc4ef
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.test.ts
@@ -0,0 +1,24 @@
+import { describe, it } from 'vitest'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtImagePlugin } from '../../../index.js'
+
+describe('prefer-nuxt-img', () => {
+  it('reports raw images outside picture markup', () => {
+    tester.run('prefer-nuxt-img', nuxtImagePlugin.rules['prefer-nuxt-img'], {
+      valid: [
+        '<template><NuxtImg src="/hero.png" alt="" /></template>',
+        '<template><picture><source srcset="/hero.avif"><img src="/hero.png" alt=""></picture></template>',
+        '<template><NuxtPicture src="/hero.png" alt=""><img src="/hero.png" alt=""></NuxtPicture></template>',
+        '<template><Img src="/hero.png" /></template>',
+        '<template><svg><image href="/hero.png" /></svg></template>',
+      ],
+      invalid: [
+        { code: '<template><img src="/hero.png" alt=""></template>', errors: [{ messageId: 'preferNuxtImg' }] },
+        {
+          code: '<template><div><img src="/hero.png" alt=""></div></template>',
+          errors: [{ messageId: 'preferNuxtImg' }],
+        },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.ts
new file mode 100644
index 0000000..6157263
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/prefer-nuxt-img/index.ts
@@ -0,0 +1,37 @@
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import { elementAncestor, isNativeElement } from '../../../utils/component-matcher.js'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor } from '../../../utils/template.js'
+import { createNuxtImageMatcher } from '../components.js'
+
+export const preferNuxtImg: Rule = {
+  meta: {
+    type: 'suggestion',
+    docs: {
+      description: 'Prefer `<NuxtImg>` over a raw `<img>` when `@nuxt/image` is available.',
+      url: docsUrl('nuxt-image/prefer-nuxt-img'),
+    },
+    schema: [],
+    messages: {
+      preferNuxtImg: 'Use `<NuxtImg>` instead of `<img>`, so the image goes through the configured provider.',
+    },
+  },
+  create(context: Context): Visitor {
+    const matcher = createNuxtImageMatcher(context)
+
+    return defineTemplateVisitor(context, {
+      VElement(node: VueAST.VElement) {
+        if (!isNativeElement(node, 'img'))
+          return
+
+        // A `<picture>` needs a native `<img>` child, and `<NuxtPicture>` builds that markup itself.
+        const parent = elementAncestor(node)
+        if (parent && (isNativeElement(parent, 'picture') || matcher.is(parent, 'NuxtPicture')))
+          return
+
+        context.report({ loc: node.startTag.loc, messageId: 'preferNuxtImg' })
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.md
new file mode 100644
index 0000000..dca2e70
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.md
@@ -0,0 +1,36 @@
+# `@nustack/nuxt-image/require-image-alt`
+
+Require `alt` on `<NuxtImg>` and `<NuxtPicture>`, plus Nuxt UI's wrappers around them
+(`<UColorModeImage>`, `<ProseImg>`). None of them invents alternative text. Use `aria-hidden` for
+a decorative image; an empty `alt=""` counts as one too.
+
+Components are matched by identity: `<nuxt-img>`, `<LazyNuxtImg>` and an aliased import are all
+reported, your own local `NuxtImg` is not.
+
+## Incorrect
+
+```vue
+<template>
+  <NuxtImg src="/team/ada.png" width="320" height="320" />
+</template>
+```
+
+## Correct
+
+```vue
+<template>
+  <!-- meaningful image -->
+  <NuxtImg src="/team/ada.png" alt="Ada Lovelace" width="320" height="320" />
+
+  <!-- decorative image -->
+  <NuxtPicture src="/pattern.png" aria-hidden="true" width="16" height="16" />
+
+  <!-- Nuxt UI wrapper, same requirement -->
+  <UColorModeImage light="/logo-light.svg" dark="/logo-dark.svg" alt="Nustack" />
+</template>
+```
+
+## Further reading
+
+- [Nuxt Image `<NuxtImg>`](https://image.nuxt.com/usage/nuxt-img)
+- [WCAG 1.1.1 Non-text Content](https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.test.ts
new file mode 100644
index 0000000..21bd5e9
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.test.ts
@@ -0,0 +1,70 @@
+import { describe, it } from 'vitest'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtImagePlugin } from '../../../index.js'
+
+const settings = (prefix = 'U') => ({ '@nustack/nuxt-ui': { enabled: true, prefix } })
+
+function sfc(script: string, template: string): string {
+  return `<script setup lang="ts">${script}</script><template>${template}</template>`
+}
+
+describe('require-image-alt', () => {
+  it('requires alt on the @nuxt/image components', () => {
+    tester.run('require-image-alt', nuxtImagePlugin.rules['require-image-alt'], {
+      valid: [
+        '<template><NuxtImg src="/ada.png" alt="Ada" /></template>',
+        '<template><nuxt-img src="/ada.png" alt="Ada" /></template>',
+        '<template><NuxtPicture src="/ada.png" alt="Ada" /></template>',
+        '<template><NuxtImg src="/pattern.png" alt="" /></template>',
+        '<template><NuxtImg src="/pattern.png" aria-hidden="true" /></template>',
+        '<template><NuxtImg v-bind="props" /></template>',
+        sfc('const NuxtImg = defineComponent({})', '<NuxtImg src="/ada.png" />'),
+        sfc('import NuxtImg from \'./MyImg.vue\'', '<NuxtImg src="/ada.png" />'),
+        '<template><img src="/ada.png"></template>',
+        '<template><UColorModeImage light="/l.png" dark="/d.png" alt="Logo" /></template>',
+        '<template><ProseImg src="/ada.png" alt="Ada" /></template>',
+        '<template><UColorModeImage light="/l.png" dark="/d.png" /></template>',
+        '<template><ProseImg src="/ada.png" /></template>',
+        { code: '<template><UColorModeImage light="/l.png" dark="/d.png" /></template>', settings: settings('Nu') },
+      ],
+      invalid: [
+        {
+          code: '<template><NuxtImg src="/ada.png" /></template>',
+          errors: [{ messageId: 'missingAlt', data: { component: 'NuxtImg' } }],
+        },
+        {
+          code: '<template><NuxtPicture src="/ada.png" width="10" height="10" /></template>',
+          errors: [{ messageId: 'missingAlt' }],
+        },
+        { code: '<template><LazyNuxtImg src="/ada.png" /></template>', errors: [{ messageId: 'missingAlt' }] },
+        { code: '<template><nuxt-picture src="/ada.png" /></template>', errors: [{ messageId: 'missingAlt' }] },
+        {
+          code: sfc('import { NuxtImg as Img } from \'@nuxt/image/components/NuxtImg.vue\'', '<Img src="/ada.png" />'),
+          errors: [{ messageId: 'missingAlt' }],
+        },
+        {
+          code: sfc('import { NuxtImg as Img } from \'#components\'', '<Img src="/ada.png" />'),
+          errors: [{ messageId: 'missingAlt' }],
+        },
+        { code: '<template><NuxtImg src="/ada.png" :alt="undefined" /></template>', errors: [{ messageId: 'missingAlt' }] },
+        { code: '<template><NuxtImg src="/ada.png" aria-hidden="false" /></template>', errors: [{ messageId: 'missingAlt' }] },
+        { code: '<template><NuxtImg src="/ada.png" :aria-hidden="false" /></template>', errors: [{ messageId: 'missingAlt' }] },
+        {
+          code: '<template><UColorModeImage light="/l.png" dark="/d.png" /></template>',
+          settings: settings(),
+          errors: [{ messageId: 'missingAlt', data: { component: 'UColorModeImage' } }],
+        },
+        {
+          code: '<template><ProseImg src="/ada.png" /></template>',
+          settings: settings(),
+          errors: [{ messageId: 'missingAlt', data: { component: 'ProseImg' } }],
+        },
+        {
+          code: '<template><NuColorModeImage light="/l.png" dark="/d.png" /></template>',
+          settings: settings('Nu'),
+          errors: [{ messageId: 'missingAlt', data: { component: 'NuColorModeImage' } }],
+        },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.ts
new file mode 100644
index 0000000..b601b55
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-image/require-image-alt/index.ts
@@ -0,0 +1,39 @@
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, getAttributeValue, getStaticBoolean } from '../../../utils/template.js'
+import { createImageMatcher } from '../components.js'
+
+export const requireImageAlt: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require alternative text on `@nuxt/image` components.',
+      url: docsUrl('nuxt-image/require-image-alt'),
+    },
+    schema: [],
+    messages: {
+      missingAlt: 'Add `alt` to `<{{ component }}>` (or mark a decorative image with `aria-hidden`).',
+    },
+  },
+  create(context: Context): Visitor {
+    const matcher = createImageMatcher(context)
+
+    return defineTemplateVisitor(context, {
+      VElement(node: VueAST.VElement) {
+        const image = matcher.match(node)
+        if (image === null)
+          return
+        const alt = getAttributeValue(node, 'alt')
+        const hasUsableAlt = alt.present && (!alt.known || alt.definite)
+        if (!hasUsableAlt && getStaticBoolean(node, 'aria-hidden') !== true) {
+          context.report({
+            loc: node.startTag.loc,
+            messageId: 'missingAlt',
+            data: { component: image.name },
+          })
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.test.ts
deleted file mode 100644
index c3ca7f1..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.test.ts
+++ /dev/null
@@ -1,132 +0,0 @@
-import { RuleTester } from 'eslint'
-import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../index.js'
-
-const tester = new RuleTester({
-  languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser },
-})
-
-const iconButton = plugin.rules?.['require-icon-button-label']
-function sfc(script: string, template: string) {
-  return `<script setup>\n${script}\n</script>\n<template>${template}</template>`
-}
-
-describe('component identification', () => {
-  it('matches every auto-import spelling of a component', () => {
-    tester.run('require-icon-button-label', iconButton as never, {
-      valid: [],
-      invalid: [
-        { filename: 'c.vue', code: '<template><UButton icon="i-lucide-x" /></template>', errors: 1 },
-        { filename: 'c.vue', code: '<template><u-button icon="i-lucide-x" /></template>', errors: 1 },
-        { filename: 'c.vue', code: '<template><LazyUButton icon="i-lucide-x" /></template>', errors: 1 },
-        { filename: 'c.vue', code: '<template><lazy-u-button icon="i-lucide-x" /></template>', errors: 1 },
-      ],
-    })
-  })
-
-  it('honours a configured ui.prefix', () => {
-    tester.run('require-icon-button-label', iconButton as never, {
-      valid: [
-        // `UButton` is not a component when the project prefix is `Nu`.
-        { filename: 'c.vue', code: '<template><UButton icon="i-lucide-x" /></template>', options: [{ prefix: 'Nu' }] },
-      ],
-      invalid: [
-        { filename: 'c.vue', code: '<template><NuButton icon="i-lucide-x" /></template>', options: [{ prefix: 'Nu' }], errors: 1 },
-        { filename: 'c.vue', code: '<template><nu-button icon="i-lucide-x" /></template>', options: [{ prefix: 'Nu' }], errors: 1 },
-        // An empty prefix disables prefixing entirely.
-        { filename: 'c.vue', code: '<template><Button icon="i-lucide-x" /></template>', options: [{ prefix: '' }], errors: 1 },
-      ],
-    })
-  })
-
-  it('follows named imports through an alias', () => {
-    tester.run('require-icon-button-label', iconButton as never, {
-      valid: [
-        // Imported from `#components` but not a Nuxt UI component.
-        { filename: 'c.vue', code: sfc('import { MyThing } from \'#components\'', '<MyThing icon="i-lucide-x" />') },
-      ],
-      invalid: [
-        { filename: 'c.vue', code: sfc('import { UButton as IconButton } from \'#components\'', '<IconButton icon="i-lucide-x" />'), errors: 1 },
-        { filename: 'c.vue', code: sfc('import { UButton as IconButton } from \'@nuxt/ui\'', '<IconButton icon="i-lucide-x" />'), errors: 1 },
-        { filename: 'c.vue', code: sfc('import Btn from \'@nuxt/ui/components/Button.vue\'', '<Btn icon="i-lucide-x" />'), errors: 1 },
-      ],
-    })
-  })
-
-  it('respects local shadowing of a Nuxt UI name', () => {
-    tester.run('require-icon-button-label', iconButton as never, {
-      valid: [
-        { filename: 'c.vue', code: sfc('import UButton from \'./MyButton.vue\'', '<UButton icon="i-lucide-x" />') },
-        { filename: 'c.vue', code: sfc('import { UButton } from \'~/components/ui\'', '<UButton icon="i-lucide-x" />') },
-      ],
-      invalid: [],
-    })
-  })
-
-  it('resolves <component :is> only when the target is static', () => {
-    tester.run('require-icon-button-label', iconButton as never, {
-      valid: [
-        { filename: 'c.vue', code: '<template><component :is="resolved" icon="i-lucide-x" /></template>' },
-        { filename: 'c.vue', code: '<template><component :is="map[key]" icon="i-lucide-x" /></template>' },
-      ],
-      invalid: [
-        { filename: 'c.vue', code: '<template><component is="UButton" icon="i-lucide-x" /></template>', errors: 1 },
-        { filename: 'c.vue', code: '<template><component :is="\'UButton\'" icon="i-lucide-x" /></template>', errors: 1 },
-        { filename: 'c.vue', code: sfc('import { UButton } from \'#components\'', '<component :is="UButton" icon="i-lucide-x" />'), errors: 1 },
-      ],
-    })
-  })
-
-  it('does not mistake native tags for components', () => {
-    tester.run('no-conflicting-state-props', plugin.rules?.['no-conflicting-state-props'] as never, {
-      valid: [
-        { filename: 'c.vue', code: '<template><ul default-value="a" model-value="b" /></template>' },
-        { filename: 'c.vue', code: '<template><use default-open open /></template>' },
-      ],
-      invalid: [
-        { filename: 'c.vue', code: '<template><u-modal default-open open /></template>', errors: 1 },
-        // The conflict is a component-authoring convention, so it is not limited to Nuxt UI.
-        { filename: 'c.vue', code: '<template><UserCard default-value="a" model-value="b" /></template>', errors: 1 },
-      ],
-    })
-  })
-
-  it('reports multi-word components with their real casing', () => {
-    tester.run('require-form-control-label', plugin.rules?.['require-form-control-label'] as never, {
-      valid: [],
-      invalid: [
-        {
-          filename: 'c.vue',
-          code: '<template><UInputMenu :items="items" /></template>',
-          errors: [{ messageId: 'missingLabel', data: { component: 'UInputMenu' } }],
-        },
-        {
-          filename: 'c.vue',
-          code: '<template><u-checkbox-group :items="items" /></template>',
-          errors: [{ messageId: 'missingLabel', data: { component: 'UCheckboxGroup' } }],
-        },
-      ],
-    })
-  })
-
-  it('resolves renamed components across spellings', () => {
-    tester.run('no-deprecated-components', plugin.rules?.['no-deprecated-components'] as never, {
-      valid: [
-        { filename: 'c.vue', code: sfc('import UButtonGroup from \'./ButtonGroup.vue\'', '<UButtonGroup />') },
-      ],
-      invalid: [
-        {
-          filename: 'c.vue',
-          code: '<template><u-button-group /></template>',
-          errors: [{ messageId: 'deprecated', data: { name: 'UButtonGroup', replacement: 'UFieldGroup' } }],
-        },
-        {
-          filename: 'c.vue',
-          code: '<template><LazyUPageMarquee /></template>',
-          errors: [{ messageId: 'deprecated', data: { name: 'UPageMarquee', replacement: 'UMarquee' } }],
-        },
-      ],
-    })
-  })
-})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.ts
deleted file mode 100644
index f56d7db..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/component-matcher.ts
+++ /dev/null
@@ -1,175 +0,0 @@
-// `#components` is Nuxt's barrel and also re-exports project components, so names from it still
-// go through prefix resolution rather than being trusted outright.
-const NUXT_UI_MODULE = /^(?:@nuxt\/ui|#ui)(?:\/|$)/
-const AUTO_IMPORT_MODULE = '#components'
-
-const LAZY_PREFIX = 'lazy'
-
-/**
- * `vue-eslint-parser` lowercases `node.name` but keeps hyphens, so `<UButton>` and `<u-button>`
- * arrive as `ubutton` and `u-button`. Both normalize to `ubutton`.
- */
-export function normalizeComponentKey(name: string): string {
-  return name.replaceAll('-', '').toLowerCase()
-}
-
-export interface ComponentMatcher {
-  is: (node: any, name: string) => boolean
-  /** The entry of `names` this element matches, preserving its casing, or `null`. */
-  matchOf: (node: any, names: Iterable<string>) => string | null
-  isOneOf: (node: any, names: Iterable<string>) => boolean
-  hasAncestor: (node: any, name: string) => boolean
-  /** The element's key with `Lazy` and the prefix stripped, or `null` on a mismatch. */
-  keyOf: (node: any) => string | null
-  /** `keyOf` for a bare name, so option tables accept prefixed and unprefixed spellings. */
-  keyOfName: (name: string) => string | null
-  prefixed: (name: string) => string
-  rawName: (node: any) => string
-  isComponent: (node: any) => boolean
-}
-
-export const PREFIX_SCHEMA = {
-  /** Component prefix configured via `ui.prefix`; use `''` when the prefix is disabled. */
-  prefix: { type: 'string' },
-} as const
-
-export function componentOptionsSchema(extraProperties: Record<string, unknown> = {}): unknown[] {
-  return [{
-    type: 'object',
-    properties: { ...PREFIX_SCHEMA, ...extraProperties },
-    additionalProperties: false,
-  }]
-}
-
-/** `rawName` preserves case, `name` is lowercased by the parser. */
-function elementName(node: any): string {
-  return node?.rawName ?? node?.name ?? ''
-}
-
-function dynamicIsName(node: any): string | null {
-  const attribute = node.startTag.attributes.find((candidate: any) => {
-    if (!candidate.directive)
-      return candidate.key.name === 'is'
-    if (candidate.key.name?.name !== 'bind')
-      return false
-    return candidate.key.argument?.type === 'VIdentifier' && candidate.key.argument.name === 'is'
-  })
-  if (!attribute)
-    return null
-  if (!attribute.directive)
-    return attribute.value?.value ?? null
-
-  const expression = attribute.value?.expression
-  if (expression?.type === 'Identifier')
-    return expression.name
-  if (expression?.type === 'Literal' && typeof expression.value === 'string')
-    return expression.value
-  return null
-}
-
-/**
- * Identifies Nuxt UI components in a template, covering the spellings a plain `node.name`
- * comparison misses: kebab-case, `Lazy` wrappers, a configured `ui.prefix`, named imports under
- * an alias, locally shadowed names, and `<component :is>` with a static target.
- *
- * Components built at runtime (`defineAsyncComponent`, `resolveComponent`, an `:is` bound to an
- * expression) and re-exports through an intermediate module are treated as "not Nuxt UI", so they
- * stay silent instead of producing false positives.
- */
-export function createComponentMatcher(context: any): ComponentMatcher {
-  const prefix: string = context.options?.[0]?.prefix ?? 'U'
-  const prefixKey = normalizeComponentKey(prefix)
-
-  function stripPrefixes(name: string): string | null {
-    let key = normalizeComponentKey(name)
-    if (key.startsWith(LAZY_PREFIX))
-      key = key.slice(LAZY_PREFIX.length)
-    if (!key.startsWith(prefixKey))
-      return null
-    const stripped = key.slice(prefixKey.length)
-    return stripped.length > 0 ? stripped : null
-  }
-
-  // A `null` value means the name is bound to something definitively not Nuxt UI, which is how
-  // local shadowing (`import UButton from './MyButton.vue'`) suppresses a false positive.
-  const bindings = new Map<string, string | null>()
-  for (const statement of context.sourceCode?.ast?.body ?? []) {
-    if (statement.type !== 'ImportDeclaration' || statement.importKind === 'type')
-      continue
-
-    const source: string = statement.source.value
-    const fromNuxtUi = NUXT_UI_MODULE.test(source)
-    const fromBarrel = source === AUTO_IMPORT_MODULE
-
-    for (const specifier of statement.specifiers) {
-      if (specifier.importKind === 'type')
-        continue
-
-      if (specifier.type === 'ImportSpecifier') {
-        const imported = specifier.imported.name ?? specifier.imported.value
-        bindings.set(
-          specifier.local.name,
-          fromNuxtUi || fromBarrel ? stripPrefixes(imported) : null,
-        )
-        continue
-      }
-
-      if (specifier.type === 'ImportDefaultSpecifier') {
-        // `@nuxt/ui/components/Button.vue` — the file name is the unprefixed component.
-        const file = fromNuxtUi ? source.split('/').pop()?.replace(/\.vue$/, '') : undefined
-        bindings.set(specifier.local.name, file ? normalizeComponentKey(file) : null)
-      }
-    }
-  }
-
-  function effectiveName(node: any): string | null {
-    if (node?.type !== 'VElement')
-      return null
-    const raw = elementName(node)
-    return normalizeComponentKey(raw) === 'component' ? dynamicIsName(node) : raw
-  }
-
-  function keyOf(node: any): string | null {
-    const name = effectiveName(node)
-    if (name === null)
-      return null
-    const bound = bindings.get(name)
-    return bound !== undefined ? bound : stripPrefixes(name)
-  }
-
-  function matchOf(node: any, names: Iterable<string>): string | null {
-    const key = keyOf(node)
-    if (key === null)
-      return null
-    for (const name of names) {
-      if (normalizeComponentKey(name) === key)
-        return name
-    }
-    return null
-  }
-
-  function is(node: any, name: string): boolean {
-    return keyOf(node) === normalizeComponentKey(name)
-  }
-
-  return {
-    is,
-    matchOf,
-    isOneOf: (node, names) => matchOf(node, names) !== null,
-    hasAncestor: (node, name) => {
-      let parent = node.parent
-      while (parent) {
-        if (is(parent, name))
-          return true
-        parent = parent.parent
-      }
-      return false
-    },
-    keyOf,
-    keyOfName: stripPrefixes,
-    prefixed: name => `${prefix}${name}`,
-    rawName: elementName,
-    // Native tags are all-lowercase and unhyphenated; anything else is a component.
-    isComponent: node => /[A-Z-]/.test(elementName(node)),
-  }
-}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/components.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/components.ts
new file mode 100644
index 0000000..6a46d7a
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/components.ts
@@ -0,0 +1,37 @@
+import type { Context } from '@oxlint/plugins'
+import type { ComponentMatcher } from '../../utils/component-matcher.js'
+import { createComponentMatcher } from '../../utils/component-matcher.js'
+
+export const NUXT_UI_MODULE = /^(?:@nuxt\/ui|#ui|#components)(?:\/|$)/
+
+export const NUXT_UI_SETTINGS_KEY = '@nustack/nuxt-ui'
+const DEFAULT_PREFIX = 'U'
+
+interface NuxtUiSettings {
+  enabled?: boolean
+  prefix?: string
+}
+
+function resolveNuxtUiSettings(context: Context): NuxtUiSettings | undefined {
+  const settings = (context as Context & { settings?: Record<string, unknown> }).settings?.[NUXT_UI_SETTINGS_KEY]
+  return typeof settings === 'object' && settings !== null ? settings as NuxtUiSettings : undefined
+}
+
+export function nuxtUiPrefix(context: Context): string {
+  return resolveNuxtUiSettings(context)?.prefix ?? DEFAULT_PREFIX
+}
+
+export function hasNuxtUi(context: Context): boolean {
+  return resolveNuxtUiSettings(context)?.enabled === true
+}
+
+export function nuxtUiSettings(prefix = DEFAULT_PREFIX): Record<string, NuxtUiSettings> {
+  return { [NUXT_UI_SETTINGS_KEY]: { enabled: true, prefix } }
+}
+
+export function createNuxtUiMatcher(context: Context): ComponentMatcher {
+  return createComponentMatcher(context, {
+    module: NUXT_UI_MODULE,
+    prefix: nuxtUiPrefix(context),
+  })
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/module.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/module.ts
new file mode 100644
index 0000000..b50de5b
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/module.ts
@@ -0,0 +1,128 @@
+import type { Plugin } from '@oxlint/plugins'
+import type { ESLint, Linter } from 'eslint'
+import { eslintCompatPlugin } from '@oxlint/plugins'
+import { nuxtUiSettings } from './components.js'
+import { noConflictingStateProps } from './no-conflicting-state-props/index.js'
+import { noDeprecatedComponents } from './no-deprecated-components/index.js'
+import { noDeprecatedModelModifiers } from './no-deprecated-model-modifiers/index.js'
+import { noInvalidPropCombinations } from './no-invalid-prop-combinations/index.js'
+import { preferLinkTo } from './prefer-link-to/index.js'
+import { preferUButton } from './prefer-u-button/index.js'
+import { preferUFormControls } from './prefer-u-form-controls/index.js'
+import { preferUFormField } from './prefer-u-form-field/index.js'
+import { preferUIcon } from './prefer-u-icon/index.js'
+import { preferUKbd } from './prefer-u-kbd/index.js'
+import { preferULink } from './prefer-u-link/index.js'
+import { preferUModal } from './prefer-u-modal/index.js'
+import { preferUProgress } from './prefer-u-progress/index.js'
+import { preferUSeparator } from './prefer-u-separator/index.js'
+import { preferUTable } from './prefer-u-table/index.js'
+import { preferUTree } from './prefer-u-tree/index.js'
+import { requireAvatarAlt } from './require-avatar-alt/index.js'
+import { requireFormControlLabel } from './require-form-control-label/index.js'
+import { requireFormFieldName } from './require-form-field-name/index.js'
+import { requireIconButtonLabel } from './require-icon-button-label/index.js'
+import { requireNestedFormProp } from './require-nested-form-prop/index.js'
+import { requireOverlayTitle } from './require-overlay-title/index.js'
+import { requirePopoverContent } from './require-popover-content/index.js'
+import { requireTooltipContent } from './require-tooltip-content/index.js'
+import { requireUApp } from './require-u-app/index.js'
+
+export const nuxtUiPlugin = eslintCompatPlugin({
+  meta: {
+    name: '@nustackjs/lint-plugin-nuxt-ecosystem/nuxt-ui',
+  },
+  rules: {
+    'no-conflicting-state-props': noConflictingStateProps,
+    'no-deprecated-components': noDeprecatedComponents,
+    'no-deprecated-model-modifiers': noDeprecatedModelModifiers,
+    'no-invalid-prop-combinations': noInvalidPropCombinations,
+    'prefer-link-to': preferLinkTo,
+    'prefer-u-button': preferUButton,
+    'prefer-u-form-controls': preferUFormControls,
+    'prefer-u-form-field': preferUFormField,
+    'prefer-u-icon': preferUIcon,
+    'prefer-u-kbd': preferUKbd,
+    'prefer-u-link': preferULink,
+    'prefer-u-modal': preferUModal,
+    'prefer-u-progress': preferUProgress,
+    'prefer-u-separator': preferUSeparator,
+    'prefer-u-table': preferUTable,
+    'prefer-u-tree': preferUTree,
+    'require-avatar-alt': requireAvatarAlt,
+    'require-form-control-label': requireFormControlLabel,
+    'require-form-field-name': requireFormFieldName,
+    'require-icon-button-label': requireIconButtonLabel,
+    'require-nested-form-prop': requireNestedFormProp,
+    'require-overlay-title': requireOverlayTitle,
+    'require-popover-content': requirePopoverContent,
+    'require-tooltip-content': requireTooltipContent,
+    'require-u-app': requireUApp,
+  },
+}) as Plugin & ESLint.Plugin
+
+export type NuxtUiPreset = 'minimal' | 'recommended'
+export interface NuxtUiRulesOptions {
+  preset?: NuxtUiPreset | false
+  rules?: Linter.RulesRecord
+}
+export interface NuxtUiConfigOptions extends NuxtUiRulesOptions {
+  prefix?: string
+}
+
+const NUXT_UI_MINIMAL_RULES = {
+  'no-conflicting-state-props': 'error',
+  'no-invalid-prop-combinations': 'error',
+  'require-avatar-alt': 'error',
+  'require-form-control-label': 'error',
+  'require-form-field-name': 'error',
+  'require-icon-button-label': 'error',
+  'require-nested-form-prop': 'error',
+  'require-overlay-title': 'error',
+  'require-popover-content': 'error',
+  'require-tooltip-content': 'error',
+  'require-u-app': 'error',
+  'no-deprecated-components': 'error',
+  'no-deprecated-model-modifiers': 'error',
+} as const satisfies Record<string, 'error'>
+
+const NUXT_UI_CONVENTION_RULES = {
+  'prefer-link-to': 'warn',
+  'prefer-u-button': 'warn',
+  'prefer-u-form-controls': 'warn',
+  'prefer-u-form-field': 'warn',
+  'prefer-u-icon': 'warn',
+  'prefer-u-kbd': 'warn',
+  'prefer-u-link': 'warn',
+  'prefer-u-modal': 'warn',
+  'prefer-u-progress': 'warn',
+  'prefer-u-separator': 'warn',
+  'prefer-u-table': 'warn',
+  'prefer-u-tree': 'warn',
+} as const satisfies Record<string, 'warn'>
+
+export const NUXT_UI_PRESET_RULES = {
+  minimal: NUXT_UI_MINIMAL_RULES,
+  recommended: { ...NUXT_UI_MINIMAL_RULES, ...NUXT_UI_CONVENTION_RULES },
+} as const
+
+export const nuxtUiPlugins: Record<string, ESLint.Plugin> = { '@nustack/nuxt-ui': nuxtUiPlugin }
+
+export function nuxtUiRules(options: NuxtUiRulesOptions = {}): Linter.RulesRecord {
+  const { preset = 'recommended', rules = {} } = options
+  const configured = preset === false
+    ? {}
+    : Object.fromEntries(Object.entries(NUXT_UI_PRESET_RULES[preset]).map(([name, level]) => [`@nustack/nuxt-ui/${name}`, level]))
+  return { ...configured, ...rules }
+}
+
+export function nuxtUiConfig(options: NuxtUiConfigOptions = {}): Linter.Config {
+  const { prefix = 'U', ...rulesOptions } = options
+  return {
+    name: 'nustack/nuxt-ui',
+    files: ['**/*.vue'],
+    plugins: nuxtUiPlugins,
+    rules: nuxtUiRules(rulesOptions),
+    settings: nuxtUiSettings(prefix),
+  }
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
index a0f58f9..7aeaa5e 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.md
@@ -4,8 +4,10 @@ Do not combine controlled state (`open`, `v-model:open`, `model-value`, or `v-mo
 the corresponding uncontrolled initializer (`default-open` or `default-value`). Nuxt UI's
 APIs document `default-*` for cases where the caller does not control state.
 
-The rule is limited to Nuxt UI components that document the corresponding controlled and
-uncontrolled props. It does not infer this convention for application components.
+The rule is limited to Nuxt UI components, which document the pairing. It does not infer the
+convention for application components — `<UserCard default-value model-value>` may mean something
+else entirely — and a known nullish binding (`:open="undefined"`) supplies no state, so it does
+not conflict.
 
 ## Incorrect
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.test.ts
index 340a8cb..8755aed 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.test.ts
@@ -1,19 +1,25 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('no-conflicting-state-props', () => {
   it('separates controlled and uncontrolled state', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('no-conflicting-state-props', plugin.rules?.['no-conflicting-state-props'] as never, {
+    tester.run('no-conflicting-state-props', nuxtUiPlugin.rules['no-conflicting-state-props'], {
       valid: [
-        { filename: 'component.vue', code: '<template><UModal v-model:open="open" /></template>' },
-        { filename: 'component.vue', code: '<template><UInput default-value="Draft" /></template>' },
+        { code: '<template><UModal v-model:open="open" /></template>' },
+        { code: '<template><UInput default-value="Draft" /></template>' },
+        { code: '<template><UserCard default-value="a" model-value="b" /></template>' },
+        { code: '<template><UModal v-bind="props" /></template>' },
+        { code: '<template><UModal default-open :open="undefined" /></template>' },
+        { code: '<template><UModal default-open :open="null" /></template>' },
+        { code: '<template><UInput default-value="Draft" :model-value="undefined" /></template>' },
+        { code: '<template><UModal :default-open="undefined" open /></template>' },
       ],
       invalid: [
-        { filename: 'component.vue', code: '<template><UModal v-model:open="open" default-open /></template>', errors: [{ messageId: 'conflicting' }] },
-        { filename: 'component.vue', code: '<template><UInput v-model="value" default-value="Draft" /></template>', errors: [{ messageId: 'conflicting' }] },
+        { code: '<template><UModal v-model:open="open" default-open /></template>', errors: [{ messageId: 'conflicting' }] },
+        { code: '<template><UInput v-model="value" default-value="Draft" /></template>', errors: [{ messageId: 'conflicting' }] },
+        { code: '<template><UInput v-bind="{ defaultValue: \'Draft\', modelValue: value }" /></template>', errors: [{ messageId: 'conflicting' }] },
+        { code: '<template><UModal default-open v-model:[`open`]="open" /></template>', errors: [{ messageId: 'conflicting' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts
index 91e9dd5..352159a 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-conflicting-state-props/index.ts
@@ -1,7 +1,52 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasAttribute, hasVModel } from '../utils.js'
+import { defineTemplateVisitor, hasDefiniteAttribute, hasVModel } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
+
+// Verified against @nuxt/ui 4.9; re-verify on the next major.
+const OPEN_STATE_COMPONENTS = [
+  'Collapsible',
+  'ContextMenu',
+  'Drawer',
+  'DropdownMenu',
+  'InputMenu',
+  'Modal',
+  'NavigationMenu',
+  'Popover',
+  'SelectMenu',
+  'Slideover',
+  'Toast',
+  'Tooltip',
+]
+
+const VALUE_STATE_COMPONENTS = [
+  'Accordion',
+  'Calendar',
+  'Checkbox',
+  'CheckboxGroup',
+  'ColorPicker',
+  'CommandPalette',
+  'Input',
+  'InputDate',
+  'InputMenu',
+  'InputNumber',
+  'InputTags',
+  'InputTime',
+  'Listbox',
+  'NavigationMenu',
+  'PinInput',
+  'RadioGroup',
+  'Select',
+  'SelectMenu',
+  'Slider',
+  'Stepper',
+  'Switch',
+  'Tabs',
+  'Textarea',
+  'Timeline',
+  'Tree',
+]
 
 export const noConflictingStateProps: Rule = {
   meta: {
@@ -10,21 +55,19 @@ export const noConflictingStateProps: Rule = {
       description: 'Disallow mixing controlled Nuxt UI state with its uncontrolled default prop.',
       url: docsUrl('nuxt-ui/no-conflicting-state-props'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       conflicting: '`<{{ component }}>` cannot use controlled `{{ controlled }}` together with `{{ uncontrolled }}`; choose one state model.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        // A component-authoring convention rather than a Nuxt UI one, so any component qualifies.
-        if (!matcher.isComponent(node))
-          return
-
-        if (hasAttribute(node, 'default-open') && (hasAttribute(node, 'open') || hasVModel(node, 'open'))) {
+      VElement(node: VueAST.VElement) {
+        if (matcher.isOneOf(node, OPEN_STATE_COMPONENTS)
+          && hasDefiniteAttribute(node, 'default-open')
+          && (hasDefiniteAttribute(node, 'open') || hasVModel(node, 'open'))) {
           context.report({
             loc: node.startTag.loc,
             messageId: 'conflicting',
@@ -32,7 +75,9 @@ export const noConflictingStateProps: Rule = {
           })
         }
 
-        if (hasAttribute(node, 'default-value') && (hasAttribute(node, 'model-value') || hasVModel(node, null))) {
+        if (matcher.isOneOf(node, VALUE_STATE_COMPONENTS)
+          && hasDefiniteAttribute(node, 'default-value')
+          && (hasDefiniteAttribute(node, 'model-value') || hasVModel(node, null))) {
           context.report({
             loc: node.startTag.loc,
             messageId: 'conflicting',
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md
index 46d76d2..7abb07d 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.md
@@ -1,16 +1,31 @@
 # `@nustack/nuxt-ui/no-deprecated-components`
 
-Disallow Nuxt UI components that were **renamed in v4**, pointing at their current names.
+Disallow Nuxt UI components that were renamed or removed, pointing at their migration.
 
-| Deprecated | Current |
-|---|---|
-| `UButtonGroup` | `UFieldGroup` |
-| `UPageMarquee` | `UMarquee` |
-| `UPageAccordion` | `UAccordion` |
+| Deprecated | Current | Renamed in |
+|---|---|---|
+| `UButtonGroup` | `UFieldGroup` | v4 |
+| `UPageMarquee` | `UMarquee` | v4 |
+| `UPageAccordion` | `UAccordion` plus former wrapper defaults | v4 |
+| `UFormGroup` | `UFormField` | v3 |
+| `UDropdown` | `UDropdownMenu` | v3 |
+| `UDivider` | `USeparator` | v3 |
+| `URange` | `USlider` | v3 |
+| `UToggle` | `USwitch` | v3 |
 
 This is a hand-maintained table (Nuxt UI ships no machine-readable deprecation feed, and
 ESLint/Oxlint can't resolve a component's `@deprecated` prop JSDoc in templates). Entries are
-verified against the live v4 docs.
+verified against the live migration guides; the v3 names are still gone in v4.
+
+`eslint --fix` rewrites the tag for every pure name swap, in the spelling it finds it — a
+kebab-case tag stays kebab-case, a `Lazy` wrapper stays lazy, and the closing tag follows. It
+deliberately leaves two cases to a human: `UPageAccordion` (see below) and any tag that resolves
+through a binding rather than spelling the component out, such as an aliased import or
+`<component :is>`.
+
+`UPageAccordion` was not a tag-only rename. It was a wrapper around `UAccordion` that set
+`unmount-on-hide="false"` and typography-oriented `ui` defaults. Preserve those values when
+the old behavior is required.
 
 ## Incorrect
 
@@ -36,16 +51,17 @@ verified against the live v4 docs.
 
 ## Options
 
-Register team-specific renames, merged onto the built-in table. Keys accept either spelling
-(`UOldWidget` or `OldWidget`); values are written unprefixed:
+Register team-specific renames, merged onto the built-in table. Canonical unprefixed names are
+preferred because they remain unambiguous when a name itself starts with the configured prefix
+(`UserCard` with prefix `U`). Prefixed keys remain supported for existing configurations:
 
 ```js
 '@nustack/nuxt-ui/no-deprecated-components': ['warn', {
-  components: { UOldWidget: 'NewWidget' },
-  prefix: 'U', // your `ui.prefix`, when it is not the default
+  components: { OldWidget: 'NewWidget' },
 }]
 ```
 
 ## Further reading
 
 - [Migrating to Nuxt UI v4](https://ui.nuxt.com/docs/getting-started/migration/v4)
+- [Migrating to Nuxt UI v3](https://ui.nuxt.com/docs/getting-started/migration/v3)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.test.ts
index c5c35a9..a319350 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.test.ts
@@ -1,26 +1,27 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
-const rule = plugin.rules?.['no-deprecated-components']
+const rule = nuxtUiPlugin.rules['no-deprecated-components']
 
 describe('no-deprecated-components', () => {
   it('reports Nuxt UI components renamed in v4', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-
-    tester.run('no-deprecated-components', rule as never, {
+    tester.run('no-deprecated-components', rule, {
       valid: [
-        { filename: 'component.vue', code: '<template><UFieldGroup /></template>' },
-        { filename: 'component.vue', code: '<template><UMarquee :items="items" /></template>' },
-        { filename: 'component.vue', code: '<template><UAccordion :items="items" /></template>' },
+        { code: '<template><UFieldGroup /></template>' },
+        { code: '<template><UMarquee :items="items" /></template>' },
+        { code: '<template><UAccordion :items="items" /></template>' },
       ],
       invalid: [
-        { filename: 'component.vue', code: '<template><UButtonGroup /></template>', errors: [{ messageId: 'deprecated' }] },
-        { filename: 'component.vue', code: '<template><UPageMarquee :items="items" /></template>', errors: [{ messageId: 'deprecated' }] },
-        { filename: 'component.vue', code: '<template><UPageAccordion :items="items" /></template>', errors: [{ messageId: 'deprecated' }] },
-        // Extended via options with a team-specific rename.
-        { filename: 'component.vue', code: '<template><UFoo /></template>', options: [{ components: { UFoo: 'UBar' } }], errors: [{ messageId: 'deprecated' }] },
+        { code: '<template><u-button-group>x</u-button-group></template>', output: '<template><u-field-group>x</u-field-group></template>', errors: [{ messageId: 'deprecated' }] },
+        { code: '<template><LazyUPageMarquee /></template>', output: '<template><LazyUMarquee /></template>', errors: [{ messageId: 'deprecated' }] },
+        { code: '<template><UButtonGroup /></template>', output: '<template><UFieldGroup /></template>', errors: [{ messageId: 'deprecated' }] },
+        { code: '<template><UPageMarquee :items="items" /></template>', output: '<template><UMarquee :items="items" /></template>', errors: [{ messageId: 'deprecated' }] },
+        { code: '<template><UPageAccordion :items="items" /></template>', errors: [{ messageId: 'deprecated' }] },
+        { code: '<template><UFormGroup label="Email"><UInput /></UFormGroup></template>', output: '<template><UFormField label="Email"><UInput /></UFormField></template>', errors: [{ messageId: 'deprecated' }] },
+        { code: '<template><UDivider /></template>', output: '<template><USeparator /></template>', errors: [{ messageId: 'deprecated' }] },
+        { code: '<template><UFoo /></template>', options: [{ components: { UFoo: 'UBar' } }], output: '<template><UBar /></template>', errors: [{ messageId: 'deprecated' }] },
+        { code: '<template><UUserCard /></template>', options: [{ components: { UserCard: 'MemberCard' } }], output: '<template><UMemberCard /></template>', errors: [{ messageId: 'deprecated' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts
index d4c3ea3..6651e43 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-components/index.ts
@@ -1,16 +1,41 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import { normalizeComponentKey } from '../../../utils/component-matcher.js'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher, normalizeComponentKey } from '../component-matcher.js'
-import { defineTemplateVisitor } from '../utils.js'
+import { defineTemplateVisitor } from '../../../utils/template.js'
+import { createNuxtUiMatcher, nuxtUiPrefix } from '../components.js'
 
-/**
- * Unprefixed `old` → `new` renames.
- * Verified 2026-07-21 against the ui.nuxt.com v4 migration guide; re-verify on the next major.
- */
+// Verified against the Nuxt UI v4 migration guides; re-verify on the next major.
 const DEPRECATED_COMPONENTS: Record<string, string> = {
   ButtonGroup: 'FieldGroup',
   PageMarquee: 'Marquee',
   PageAccordion: 'Accordion',
+  FormGroup: 'FormField',
+  Dropdown: 'DropdownMenu',
+  Divider: 'Separator',
+  Range: 'Slider',
+  Toggle: 'Switch',
+}
+
+/** Renames that were not tag-only, so an autofix would silently change behaviour. */
+const MANUAL_MIGRATION = new Set(['pageaccordion'])
+
+const LAZY_SPELLING = /^lazy-?/i
+
+function toKebabCase(name: string): string {
+  return name.replace(/[A-Z]/g, (letter, index) => (index === 0 ? '' : '-') + letter.toLowerCase())
+}
+
+/**
+ * The replacement tag in the spelling the reported one used. `null` when the tag does not spell
+ * the component out (an import alias, `<component :is>`), which a tag rename cannot follow.
+ */
+function renamedTag(raw: string, from: string, to: string): string | null {
+  const lazy = LAZY_SPELLING.exec(raw)?.[0] ?? ''
+  const bare = raw.slice(lazy.length)
+  if (normalizeComponentKey(bare) !== normalizeComponentKey(from))
+    return null
+  return bare.includes('-') ? lazy + toKebabCase(to) : lazy + to
 }
 
 export const noDeprecatedComponents: Rule = {
@@ -20,44 +45,64 @@ export const noDeprecatedComponents: Rule = {
       description: 'Disallow Nuxt UI components renamed in v4 in favour of their current names.',
       url: docsUrl('nuxt-ui/no-deprecated-components'),
     },
-    schema: componentOptionsSchema({
-      /**
-       * Extra `OldName` → `NewName` renames merged onto the built-in table. Either spelling of
-       * the key works (`UButtonGroup` or `ButtonGroup`); the value is written unprefixed.
-       */
-      components: { type: 'object', additionalProperties: { type: 'string' } },
-    }),
+    schema: [{
+      type: 'object',
+      properties: { components: { type: 'object', additionalProperties: { type: 'string' } } },
+      additionalProperties: false,
+    }],
+    fixable: 'code',
     messages: {
       deprecated: '`<{{ name }}>` was renamed in Nuxt UI v4, use `<{{ replacement }}>` instead.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
-    const prefix: string = context.options[0]?.prefix ?? 'U'
-    const extra: Record<string, string> = context.options[0]?.components ?? {}
-    /** Accepts `UButtonGroup` and `ButtonGroup` alike, so the message never doubles the prefix. */
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
+    const options = context.options[0] as { components?: Record<string, string> } | undefined
+    const prefix = nuxtUiPrefix(context)
+    const extra = options?.components ?? {}
     const unprefixed = (name: string) => (name.startsWith(prefix) ? name.slice(prefix.length) : name)
-    const table = new Map<string, { name: string, replacement: string }>(
-      Object.entries({ ...DEPRECATED_COMPONENTS, ...extra }).map(([name, replacement]) => [
-        matcher.keyOfName(name) ?? normalizeComponentKey(name),
-        { name: unprefixed(name), replacement: unprefixed(replacement) },
-      ]),
-    )
+    const table = new Map<string, { name: string, replacement: string }>()
+    for (const [name, replacement] of Object.entries({ ...DEPRECATED_COMPONENTS, ...extra })) {
+      const canonicalKey = normalizeComponentKey(name)
+      table.set(canonicalKey, { name, replacement })
+
+      // Keep accepting the old prefixed option spelling without making canonical names such as
+      // `UserCard` ambiguous when the configured prefix is `U`.
+      const prefixedKey = matcher.keyOfName(name)
+      if (prefixedKey && prefixedKey !== canonicalKey)
+        table.set(prefixedKey, { name: unprefixed(name), replacement: unprefixed(replacement) })
+    }
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
+      VElement(node: VueAST.VElement) {
         const key = matcher.keyOf(node)
         const deprecated = key === null ? undefined : table.get(key)
         if (!deprecated)
           return
 
+        const name = matcher.prefixed(deprecated.name)
+        const replacement = matcher.prefixed(deprecated.replacement)
+        const renamed = MANUAL_MIGRATION.has(key!)
+          ? null
+          : renamedTag(matcher.rawName(node), name, replacement)
+
         context.report({
           loc: node.startTag.loc,
           messageId: 'deprecated',
-          data: {
-            name: matcher.prefixed(deprecated.name),
-            replacement: matcher.prefixed(deprecated.replacement),
-          },
+          data: { name, replacement },
+          fix: renamed === null
+            ? undefined
+            : (fixer: any) => {
+                const raw = matcher.rawName(node)
+                // `<` and `</` precede the name in the start and end tag respectively.
+                const start = node.startTag.range[0] + 1
+                const fixes = [fixer.replaceTextRange([start, start + raw.length], renamed)]
+                if (node.endTag) {
+                  const end = node.endTag.range[0] + 2
+                  fixes.push(fixer.replaceTextRange([end, end + raw.length], renamed))
+                }
+                return fixes
+              },
         })
       },
     })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
index 7e63ff8..d598f50 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.md
@@ -4,6 +4,9 @@ Disallow the `v-model.nullify` modifier on Nuxt UI inputs. It was renamed to `.n
 Nuxt UI v4 (both convert empty/blank values to `null`; v4 also adds `.optional` for
 `undefined`). Applies to `UInput`, `UInputNumber`, and `UTextarea`.
 
+`eslint --fix` renames direct modifiers and identifier keys in `model-modifiers` objects. Object
+shorthand such as `{ nullify }` becomes `{ nullable: nullify }`, preserving the bound value.
+
 ## Incorrect
 
 ```vue
@@ -28,7 +31,6 @@ Nuxt UI v4 (both convert empty/blank values to `null`; v4 also adds `.optional`
 '@nustack/nuxt-ui/no-deprecated-model-modifiers': ['warn', {
   modifiers: { coerce: 'transform' }, // extra old → new renames, merged onto the built-ins
   components: ['Input', 'Textarea'],  // components to check (replaces the default list)
-  prefix: 'U',                        // your `ui.prefix`, when it is not the default
 }]
 ```
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts
index ccef606..4ee8ddf 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.test.ts
@@ -1,28 +1,25 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
-const rule = plugin.rules?.['no-deprecated-model-modifiers']
+const rule = nuxtUiPlugin.rules['no-deprecated-model-modifiers']
 
 describe('no-deprecated-model-modifiers', () => {
   it('reports the renamed v-model.nullify modifier', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-
-    tester.run('no-deprecated-model-modifiers', rule as never, {
+    tester.run('no-deprecated-model-modifiers', rule, {
       valid: [
-        { filename: 'component.vue', code: '<template><UInput v-model.nullable="value" /></template>' },
-        { filename: 'component.vue', code: '<template><UInput v-model="value" /></template>' },
-        { filename: 'component.vue', code: '<template><input v-model.nullify="value"></template>' },
+        { code: '<template><UInput v-model.nullable="value" /></template>' },
+        { code: '<template><UInput v-model="value" /></template>' },
+        { code: '<template><input v-model.nullify="value"></template>' },
       ],
       invalid: [
-        { filename: 'component.vue', code: '<template><UInput v-model.nullify="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
-        { filename: 'component.vue', code: '<template><UInputNumber v-model.nullify="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
-        { filename: 'component.vue', code: '<template><UTextarea v-model.nullify="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
-        { filename: 'component.vue', code: '<template><UTextarea v-model="value" :model-modifiers="{ nullify: true }" /></template>', errors: [{ messageId: 'preferNullable' }] },
-        // Extended via options: extra modifier rename and a custom target component.
-        { filename: 'component.vue', code: '<template><UInput v-model.coerce="value" /></template>', options: [{ modifiers: { coerce: 'transform' } }], errors: [{ messageId: 'preferNullable' }] },
-        { filename: 'component.vue', code: '<template><UCustom v-model.nullify="value" /></template>', options: [{ components: ['Custom'] }], errors: [{ messageId: 'preferNullable' }] },
+        { code: '<template><UInput v-model.nullify="value" /></template>', output: '<template><UInput v-model.nullable="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
+        { code: '<template><UInputNumber v-model.nullify="value" /></template>', output: '<template><UInputNumber v-model.nullable="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
+        { code: '<template><UTextarea v-model.nullify="value" /></template>', output: '<template><UTextarea v-model.nullable="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
+        { code: '<template><UTextarea v-model="value" :model-modifiers="{ nullify: true }" /></template>', output: '<template><UTextarea v-model="value" :model-modifiers="{ nullable: true }" /></template>', errors: [{ messageId: 'preferNullable' }] },
+        { code: '<template><UTextarea v-model="value" :modelModifiers="{ nullify }" /></template>', output: '<template><UTextarea v-model="value" :modelModifiers="{ nullable: nullify }" /></template>', errors: [{ messageId: 'preferNullable' }] },
+        { code: '<template><UInput v-model.coerce="value" /></template>', options: [{ modifiers: { coerce: 'transform' } }], output: '<template><UInput v-model.transform="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
+        { code: '<template><UCustom v-model.nullify="value" /></template>', options: [{ components: ['Custom'] }], output: '<template><UCustom v-model.nullable="value" /></template>', errors: [{ messageId: 'preferNullable' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts
index 632898c..bb41426 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-deprecated-model-modifiers/index.ts
@@ -1,7 +1,8 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor } from '../utils.js'
+import { defineTemplateVisitor, normalizePropName } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 /** Verified 2026-07-21 against the ui.nuxt.com v4 migration guide; re-verify on the next major. */
 const DEPRECATED_MODIFIERS: Record<string, string> = {
@@ -10,6 +11,11 @@ const DEPRECATED_MODIFIERS: Record<string, string> = {
 
 const TARGET_COMPONENTS = ['Input', 'InputNumber', 'Textarea']
 
+interface Options {
+  modifiers?: Record<string, string>
+  components?: string[]
+}
+
 function vModel(node: any): any {
   return node.startTag.attributes.find(
     (attribute: any) => attribute.directive && attribute.key.name?.name === 'model',
@@ -21,7 +27,7 @@ function modelModifiersObject(node: any): any | null {
     if (!candidate.directive || candidate.key.name?.name !== 'bind')
       return false
     const argument = candidate.key.argument
-    return argument?.type === 'VIdentifier' && argument.name === 'model-modifiers'
+    return argument?.type === 'VIdentifier' && normalizePropName(argument.name) === normalizePropName('model-modifiers')
   })
   return attribute?.value?.expression?.type === 'ObjectExpression'
     ? attribute.value.expression
@@ -35,24 +41,27 @@ export const noDeprecatedModelModifiers: Rule = {
       description: 'Disallow the `v-model.nullify` modifier renamed to `.nullable` in Nuxt UI v4.',
       url: docsUrl('nuxt-ui/no-deprecated-model-modifiers'),
     },
-    schema: componentOptionsSchema({
-      /** Extra `old` → `new` modifier renames, merged onto the built-in table. */
-      modifiers: { type: 'object', additionalProperties: { type: 'string' } },
-      /** Canonical unprefixed names (`'Input'`). Replaces the built-in list when provided. */
-      components: { type: 'array', items: { type: 'string' } },
-    }),
+    fixable: 'code',
+    schema: [{
+      type: 'object',
+      properties: {
+        modifiers: { type: 'object', additionalProperties: { type: 'string' } },
+        components: { type: 'array', items: { type: 'string' } },
+      },
+      additionalProperties: false,
+    }],
     messages: {
       preferNullable: 'The `v-model.{{ old }}` modifier was renamed in Nuxt UI v4, use `v-model.{{ replacement }}` instead.',
     },
   },
-  create(context: any) {
-    const options = context.options[0] ?? {}
+  create(context: Context): Visitor {
+    const options = (context.options[0] ?? {}) as Options
     const modifiers: Record<string, string> = { ...DEPRECATED_MODIFIERS, ...options.modifiers }
-    const matcher = createComponentMatcher(context)
+    const matcher = createNuxtUiMatcher(context)
     const targets: string[] = options.components ?? TARGET_COMPONENTS
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
+      VElement(node: VueAST.VElement) {
         if (!matcher.isOneOf(node, targets))
           return
 
@@ -64,6 +73,7 @@ export const noDeprecatedModelModifiers: Rule = {
               loc: modifier.loc ?? model.key.loc,
               messageId: 'preferNullable',
               data: { old: modifier.name, replacement },
+              fix: (fixer: any) => fixer.replaceTextRange(modifier.range, replacement),
             })
           }
         }
@@ -78,6 +88,12 @@ export const noDeprecatedModelModifiers: Rule = {
               loc: property.key.loc ?? property.loc,
               messageId: 'preferNullable',
               data: { old: name, replacement },
+              fix: (fixer: any) => fixer.replaceTextRange(
+                property.key.range,
+                property.shorthand
+                  ? `${replacement}: ${name}`
+                  : property.key.type === 'Literal' ? `'${replacement}'` : replacement,
+              ),
             })
           }
         }
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
index 61522ca..011bffb 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.md
@@ -9,9 +9,8 @@ Currently covered:
 - `UFileUpload position` requires `variant="area"` and `layout="list"`.
 - `UAccordion collapsible` is only meaningful for the default `type="single"`.
 
-Dynamic values are ignored when the relationship cannot be proven at lint time. `data-raw`
-does not disable API correctness checks; use a standard ESLint disable comment for an
-exceptional suppression.
+Dynamic values are ignored when the relationship cannot be proven at lint time. An
+exceptional suppression uses a standard ESLint disable comment.
 
 ## Incorrect
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.test.ts
index a1ddfe1..15d942e 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.test.ts
@@ -1,24 +1,21 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('no-invalid-prop-combinations', () => {
   it('checks documented component constraints', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('no-invalid-prop-combinations', plugin.rules?.['no-invalid-prop-combinations'] as never, {
+    tester.run('no-invalid-prop-combinations', nuxtUiPlugin.rules['no-invalid-prop-combinations'], {
       valid: [
-        { filename: 'component.vue', code: '<template><UFileUpload variant="button" :multiple="false" /></template>' },
-        { filename: 'component.vue', code: '<template><UFileUpload variant="area" layout="list" position="inside" /></template>' },
-        { filename: 'component.vue', code: '<template><UFileUpload :variant="variant" :position="position" /></template>' },
-        { filename: 'component.vue', code: '<template><UAccordion type="multiple" /></template>' },
-        { filename: 'component.vue', code: '<template><UAccordion type="multiple" collapsible data-raw /></template>' },
+        { code: '<template><UFileUpload variant="button" :multiple="false" /></template>' },
+        { code: '<template><UFileUpload variant="area" layout="list" position="inside" /></template>' },
+        { code: '<template><UFileUpload :variant="variant" :position="position" /></template>' },
+        { code: '<template><UAccordion type="multiple" /></template>' },
       ],
       invalid: [
-        { filename: 'component.vue', code: '<template><UFileUpload variant="button" multiple /></template>', errors: [{ messageId: 'fileButtonMultiple' }] },
-        { filename: 'component.vue', code: '<template><UFileUpload variant="button" layout="list" /></template>', errors: [{ messageId: 'fileLayoutArea' }] },
-        { filename: 'component.vue', code: '<template><UFileUpload position="inside" /></template>', errors: [{ messageId: 'filePositionList' }] },
-        { filename: 'component.vue', code: '<template><UAccordion type="multiple" collapsible /></template>', errors: [{ messageId: 'accordionCollapsible' }] },
+        { code: '<template><UFileUpload variant="button" multiple /></template>', errors: [{ messageId: 'fileButtonMultiple' }] },
+        { code: '<template><UFileUpload variant="button" layout="list" /></template>', errors: [{ messageId: 'fileLayoutArea' }] },
+        { code: '<template><UFileUpload position="inside" /></template>', errors: [{ messageId: 'filePositionList' }] },
+        { code: '<template><UAccordion type="multiple" collapsible /></template>', errors: [{ messageId: 'accordionCollapsible' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts
index e81c35d..ac68c57 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/no-invalid-prop-combinations/index.ts
@@ -1,42 +1,8 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, getStaticAttribute, hasAttribute, hasRawOptOut } from '../utils.js'
-
-interface StaticValue {
-  present: boolean
-  dynamic: boolean
-  value: string | null
-}
-
-function staticValue(node: any, name: string): StaticValue {
-  const attribute = node.startTag.attributes.find((candidate: any) => {
-    if (!candidate.directive)
-      return candidate.key.name === name
-    if (candidate.key.name?.name !== 'bind')
-      return false
-    const argument = candidate.key.argument
-    return argument?.type === 'VIdentifier' && argument.name === name
-  })
-  if (!attribute)
-    return { present: false, dynamic: false, value: null }
-  if (attribute.directive)
-    return { present: true, dynamic: true, value: null }
-  return { present: true, dynamic: false, value: attribute.value?.value ?? null }
-}
-
-function staticBoolean(node: any, name: string): boolean | null {
-  const attribute = staticValue(node, name)
-  if (!attribute.present || attribute.dynamic)
-    return null
-  if (attribute.value === null || attribute.value === '')
-    return true
-  if (attribute.value === 'true')
-    return true
-  if (attribute.value === 'false')
-    return false
-  return null
-}
+import { defineTemplateVisitor, getAttributeValue, getStaticAttribute, getStaticBoolean } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 export const noInvalidPropCombinations: Rule = {
   meta: {
@@ -45,7 +11,7 @@ export const noInvalidPropCombinations: Rule = {
       description: 'Disallow documented Nuxt UI prop combinations that cannot work together.',
       url: docsUrl('nuxt-ui/no-invalid-prop-combinations'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       fileButtonMultiple: '`UFileUpload variant="button"` only supports a single file; remove `multiple` or use `variant="area"`.',
       fileLayoutArea: '`UFileUpload layout` is only supported with `variant="area"`.',
@@ -53,31 +19,28 @@ export const noInvalidPropCombinations: Rule = {
       accordionCollapsible: '`UAccordion collapsible` is only meaningful with the default `type="single"`.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (hasRawOptOut(node))
-          return
-
+      VElement(node: VueAST.VElement) {
         if (matcher.is(node, 'FileUpload')) {
-          const variant = staticValue(node, 'variant')
-          const multiple = staticBoolean(node, 'multiple')
-          const layout = staticValue(node, 'layout')
-          const position = staticValue(node, 'position')
+          const variant = getAttributeValue(node, 'variant')
+          const multiple = getStaticBoolean(node, 'multiple')
+          const layout = getAttributeValue(node, 'layout')
+          const position = getAttributeValue(node, 'position')
 
-          if (!variant.dynamic && variant.value === 'button' && multiple === true) {
+          if (variant.known && variant.value === 'button' && multiple === true) {
             context.report({ loc: node.startTag.loc, messageId: 'fileButtonMultiple' })
           }
 
-          if (!layout.dynamic && layout.present && !variant.dynamic && variant.value === 'button') {
+          if (layout.known && layout.definite && variant.known && variant.value === 'button') {
             context.report({ loc: node.startTag.loc, messageId: 'fileLayoutArea' })
           }
 
-          if (position.present && !position.dynamic && !variant.dynamic && !layout.dynamic) {
-            const effectiveVariant = variant.present ? variant.value : 'area'
-            const effectiveLayout = layout.present ? layout.value : 'grid'
+          if (position.definite && position.known && variant.known && layout.known) {
+            const effectiveVariant = variant.definite ? variant.value : 'area'
+            const effectiveLayout = layout.definite ? layout.value : 'grid'
             if (effectiveVariant !== 'area' || effectiveLayout !== 'list')
               context.report({ loc: node.startTag.loc, messageId: 'filePositionList' })
           }
@@ -85,7 +48,7 @@ export const noInvalidPropCombinations: Rule = {
 
         if (matcher.is(node, 'Accordion')) {
           const type = getStaticAttribute(node, 'type')
-          if (type === 'multiple' && hasAttribute(node, 'collapsible'))
+          if (type === 'multiple' && getStaticBoolean(node, 'collapsible') === true)
             context.report({ loc: node.startTag.loc, messageId: 'accordionCollapsible' })
         }
       },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md
index 9bede8e..3756905 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.md
@@ -1,20 +1,18 @@
 # `@nustack/nuxt-ui/prefer-link-to`
 
-Use `to` on `ULink` and link-capable `UButton` components. It follows Nuxt UI's Link API
-and keeps routing-aware links consistent.
+Prefer `to` on `ULink` and link-capable `UButton` components for a consistent routing-aware
+API. Nuxt UI also supports `href`, so this rule is a preference rather than a defect and is
+reported as a warning. Suppress an intentional `href` with
+`<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-link-to -->`.
 
 ```vue
 <!-- Incorrect -->
 <UButton href="/settings">Settings</UButton>
-<ULink href="/docs">Docs</ULink>
 
 <!-- Correct -->
 <UButton to="/settings">Settings</UButton>
-<ULink to="/docs">Docs</ULink>
 ```
 
-Use `data-raw` when native `href` behavior is intentional.
-
 ## Further reading
 
 - [Nuxt UI Link](https://ui.nuxt.com/docs/components/link)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.test.ts
index 463a236..27995f6 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.test.ts
@@ -1,14 +1,12 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('prefer-link-to', () => {
   it('prefers to on link-capable components', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('prefer-link-to', plugin.rules?.['prefer-link-to'] as never, {
-      valid: [{ filename: 'component.vue', code: '<template><ULink to="/docs">Docs</ULink></template>' }],
-      invalid: [{ filename: 'component.vue', code: '<template><UButton href="/docs">Docs</UButton></template>', errors: [{ messageId: 'preferTo' }] }],
+    tester.run('prefer-link-to', nuxtUiPlugin.rules['prefer-link-to'], {
+      valid: [{ code: '<template><ULink to="/docs">Docs</ULink></template>' }],
+      invalid: [{ code: '<template><UButton href="/docs">Docs</UButton></template>', errors: [{ messageId: 'preferTo' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts
index cb016f4..eba2792 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-link-to/index.ts
@@ -1,7 +1,8 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasAttribute, hasRawOptOut } from '../utils.js'
+import { defineTemplateVisitor, hasAttribute } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 const LINK_COMPONENTS = new Set(['Link', 'Button'])
 
@@ -12,18 +13,18 @@ export const preferLinkTo: Rule = {
       description: 'Prefer Nuxt UI/NuxtLink `to` on link-capable components over `href`.',
       url: docsUrl('nuxt-ui/prefer-link-to'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       preferTo: 'Use `to` instead of `href` on `<{{ component }}>` so Nuxt routing and link props stay consistent.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
+      VElement(node: VueAST.VElement) {
         const component = matcher.matchOf(node, LINK_COMPONENTS)
-        if (component && !hasRawOptOut(node) && hasAttribute(node, 'href') && !hasAttribute(node, 'to'))
+        if (component && hasAttribute(node, 'href') && !hasAttribute(node, 'to'))
           context.report({ loc: node.startTag.loc, messageId: 'preferTo', data: { component: matcher.prefixed(component) } })
       },
     })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md
index 93f5fa4..7de1d26 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.md
@@ -18,7 +18,11 @@ Prefer Nuxt UI's `<UButton>` over raw `<button>` elements when `@nuxt/ui` is ava
 </template>
 ```
 
-Use `data-raw` as a local escape hatch when a raw native button is intentional.
+Suppress an intentional raw native button with
+`<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-button -->`.
+
+Only genuine native elements are reported: a component whose name merely lowercases to the
+tag (`<Button>`) is left alone.
 
 ## Further reading
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.test.ts
index eed1269..809a8a0 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.test.ts
@@ -1,22 +1,17 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
-const rule = plugin.rules?.['prefer-u-button']
+const rule = nuxtUiPlugin.rules['prefer-u-button']
 
 describe('prefer-u-button', () => {
   it('reports raw buttons in Vue templates', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-
-    tester.run('prefer-u-button', rule as never, {
+    tester.run('prefer-u-button', rule, {
       valid: [
-        { filename: 'component.vue', code: '<template><UButton>Save</UButton></template>' },
-        { filename: 'component.vue', code: '<template><button data-raw>Save</button></template>' },
+        { code: '<template><UButton>Save</UButton></template>' },
       ],
       invalid: [
         {
-          filename: 'component.vue',
           code: '<template><button>Save</button></template>',
           errors: [{ messageId: 'preferUButton' }],
         },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.ts
index 86db383..181d1a1 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-button/index.ts
@@ -2,7 +2,7 @@ import { preferUComponent } from '../prefer-u-component.js'
 
 export const preferUButton = preferUComponent({
   nativeTag: 'button',
-  component: 'UButton',
+  component: 'Button',
   ruleName: 'prefer-u-button',
   messageId: 'preferUButton',
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-component.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-component.ts
index 827cd41..8e98d66 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-component.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-component.ts
@@ -1,6 +1,9 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import { isNativeElement } from '../../utils/component-matcher.js'
 import { docsUrl } from '../../utils/docs-url.js'
-import { defineTemplateVisitor, hasRawOptOut } from './utils.js'
+import { defineTemplateVisitor } from '../../utils/template.js'
+import { nuxtUiPrefix } from './components.js'
 
 interface Options {
   nativeTag: string
@@ -16,19 +19,28 @@ export function preferUComponent(options: Options): Rule {
     meta: {
       type: 'suggestion',
       docs: {
-        description: `Prefer \`<${component}>\` over \`<${nativeTag}>\` when Nuxt UI is available.`,
+        // `meta` is static, so the description shows the default prefix; the report resolves it.
+        description: `Prefer \`<U${component}>\` over \`<${nativeTag}>\` when Nuxt UI is available.`,
         url: docsUrl(`nuxt-ui/${ruleName}`),
       },
       schema: [],
       messages: {
-        [messageId]: `Use \`<${component}>\` instead of \`<${nativeTag}>\`; add \`data-raw\` to allow the native element.`,
+        [messageId]: 'Use `<{{ component }}>` instead of `<{{ tag }}>`.',
       },
     },
-    create(context: any) {
+    create(context: Context): Visitor {
+      const prefix = nuxtUiPrefix(context)
+
       return defineTemplateVisitor(context, {
-        VElement(node: any) {
-          if (node.name === nativeTag && !hasRawOptOut(node))
-            context.report({ loc: node.startTag.loc, messageId })
+        VElement(node: VueAST.VElement) {
+          if (!isNativeElement(node, nativeTag))
+            return
+
+          context.report({
+            loc: node.startTag.loc,
+            messageId,
+            data: { component: `${prefix}${component}`, tag: nativeTag },
+          })
         },
       })
     },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md
index 67d7b41..ddc433e 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.md
@@ -16,6 +16,10 @@ points you at that component, both for a raw `<input type="number">` and for a g
 | `range` | `USlider` |
 | `checkbox` | `UCheckbox` |
 | `radio` | `URadioGroup` |
+| `submit`, `reset`, `button`, `image` | `UButton` |
+
+`type="hidden"` is skipped: it carries a value rather than user input, so no Nuxt UI
+control replaces it.
 
 ## Incorrect
 
@@ -41,16 +45,20 @@ points you at that component, both for a raw `<input type="number">` and for a g
 ```
 
 Dynamic types (`<UInput :type="kind" />`) are ignored; only a statically-written `type`
-is checked. Use `data-raw` as a local escape hatch when a native control is intentional.
+is checked. Only genuine native elements are reported: a component whose name merely
+lowercases to the tag (`<Input>`) is left alone. Suppress an intentional native control with
+`<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-form-controls -->`.
 
 ## Options
 
-Both maps are extensible (entries are merged onto the built-ins):
+Both maps are extensible (entries are merged onto the built-ins). Component names are
+written **unprefixed**, exactly like the built-in tables; the configured `ui.prefix` is
+applied when the message is built, so the same config works under any prefix:
 
 ```js
 '@nustack/nuxt-ui/prefer-u-form-controls': ['warn', {
-  controls: { progress: 'UProgress' }, // extra raw-element → component
-  types: { email: 'UEmailInput' },     // extra input-type → component
+  controls: { progress: 'Progress' }, // extra raw-element → component
+  types: { email: 'EmailInput' },     // extra input-type → component
 }]
 ```
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.test.ts
index 49b7e64..5a362be 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.test.ts
@@ -1,32 +1,45 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
-const rule = plugin.rules?.['prefer-u-form-controls']
+const rule = nuxtUiPlugin.rules['prefer-u-form-controls']
 
 describe('prefer-u-form-controls', () => {
   it('reports raw form controls and type-specialized inputs in Vue templates', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-
-    tester.run('prefer-u-form-controls', rule as never, {
+    tester.run('prefer-u-form-controls', rule, {
       valid: [
-        { filename: 'component.vue', code: '<template><UInput /></template>' },
-        { filename: 'component.vue', code: '<template><UInput type="text" /></template>' },
-        { filename: 'component.vue', code: '<template><UInput :type="kind" /></template>' },
-        { filename: 'component.vue', code: '<template><input data-raw></template>' },
-        { filename: 'component.vue', code: '<template><UInput type="number" data-raw /></template>' },
+        { code: '<template><UInput /></template>' },
+        { code: '<template><UInput type="text" /></template>' },
+        { code: '<template><UInput :type="kind" /></template>' },
+        { code: '<template><Input v-model="x" /></template>' },
+        { code: '<template><Select v-model="x" /></template>' },
+        { code: '<template><input type="hidden" name="csrf"></template>' },
+        { code: '<template><UInput type="hidden" /></template>' },
+      ],
+      invalid: [
+        { code: '<template><input></template>', errors: [{ messageId: 'preferUFormControl', data: { tag: 'input', replacement: 'UInput' } }] },
+        { code: '<template><input type="number"></template>', errors: [{ messageId: 'preferUFormControl', data: { tag: 'input', replacement: 'UInputNumber' } }] },
+        { code: '<template><select></select></template>', errors: [{ messageId: 'preferUFormControl' }] },
+        { code: '<template><textarea></textarea></template>', errors: [{ messageId: 'preferUFormControl' }] },
+        { code: '<template><input type="submit" value="Save"></template>', errors: [{ messageId: 'preferUFormControl', data: { tag: 'input', replacement: 'UButton' } }] },
+        { code: '<template><input type="reset"></template>', errors: [{ messageId: 'preferUFormControl', data: { tag: 'input', replacement: 'UButton' } }] },
+        { code: '<template><UInput type="number" /></template>', errors: [{ messageId: 'preferSpecificControl', data: { type: 'number', component: 'UInput', replacement: 'UInputNumber' } }] },
+        { code: '<template><UInput type="file" /></template>', errors: [{ messageId: 'preferSpecificControl' }] },
+        { code: '<template><UInput :type="\'number\'" /></template>', errors: [{ messageId: 'preferSpecificControl' }] },
+        { code: '<template><UInput type="NUMBER" /></template>', errors: [{ messageId: 'preferSpecificControl' }] },
+        { code: '<template><UInput v-bind="{ type: \'number\' }" /></template>', errors: [{ messageId: 'preferSpecificControl' }] },
+        { code: '<template><progress /></template>', options: [{ controls: { progress: 'Progress' } }], errors: [{ messageId: 'preferUFormControl', data: { tag: 'progress', replacement: 'UProgress' } }] },
+        { code: '<template><UInput type="email" /></template>', options: [{ types: { email: 'EmailInput' } }], errors: [{ messageId: 'preferSpecificControl', data: { type: 'email', component: 'UInput', replacement: 'UEmailInput' } }] },
       ],
+    })
+  })
+
+  it('spells replacements with the configured prefix', () => {
+    tester.run('prefer-u-form-controls', rule, {
+      valid: [],
       invalid: [
-        { filename: 'component.vue', code: '<template><input></template>', errors: [{ messageId: 'preferUFormControl' }] },
-        { filename: 'component.vue', code: '<template><input type="number"></template>', errors: [{ messageId: 'preferUFormControl' }] },
-        { filename: 'component.vue', code: '<template><select></select></template>', errors: [{ messageId: 'preferUFormControl' }] },
-        { filename: 'component.vue', code: '<template><textarea></textarea></template>', errors: [{ messageId: 'preferUFormControl' }] },
-        { filename: 'component.vue', code: '<template><UInput type="number" /></template>', errors: [{ messageId: 'preferSpecificControl' }] },
-        { filename: 'component.vue', code: '<template><UInput type="file" /></template>', errors: [{ messageId: 'preferSpecificControl' }] },
-        // Extended via options: extra native-element and type mappings.
-        { filename: 'component.vue', code: '<template><progress /></template>', options: [{ controls: { progress: 'UProgress' } }], errors: [{ messageId: 'preferUFormControl' }] },
-        { filename: 'component.vue', code: '<template><UInput type="email" /></template>', options: [{ types: { email: 'UEmailInput' } }], errors: [{ messageId: 'preferSpecificControl' }] },
+        { code: '<template><input type="text"></template>', settings: { '@nustack/nuxt-ui': { enabled: true, prefix: 'Nu' } }, errors: [{ messageId: 'preferUFormControl', data: { tag: 'input', replacement: 'NuInput' } }] },
+        { code: '<template><NuInput type="number" /></template>', settings: { '@nustack/nuxt-ui': { enabled: true, prefix: 'Nu' } }, errors: [{ messageId: 'preferSpecificControl', data: { type: 'number', component: 'NuInput', replacement: 'NuInputNumber' } }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.ts
index a4c2f5c..58912ba 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-controls/index.ts
@@ -1,32 +1,42 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import { isNativeHtmlElement } from '../../../utils/component-matcher.js'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasRawOptOut } from '../utils.js'
+import { defineTemplateVisitor, getStaticAttribute } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 const CONTROL_MAP: Record<string, string> = {
-  input: 'UInput',
-  select: 'USelect',
-  textarea: 'UTextarea',
+  input: 'Input',
+  select: 'Select',
+  textarea: 'Textarea',
 }
 
 /** Verified 2026-06-30 against ui.nuxt.com/docs/components; re-verify on the next Nuxt UI major. */
 const TYPE_MAP: Record<string, string> = {
-  number: 'UInputNumber',
-  file: 'UFileUpload',
-  color: 'UColorPicker',
-  date: 'UInputDate',
-  time: 'UInputTime',
-  range: 'USlider',
-  checkbox: 'UCheckbox',
-  radio: 'URadioGroup',
+  number: 'InputNumber',
+  file: 'FileUpload',
+  color: 'ColorPicker',
+  date: 'InputDate',
+  time: 'InputTime',
+  range: 'Slider',
+  checkbox: 'Checkbox',
+  radio: 'RadioGroup',
+  submit: 'Button',
+  reset: 'Button',
+  button: 'Button',
+  image: 'Button',
 }
 
-/** The static `type="..."` value; `null` for dynamic (`:type`) or absent types. */
-function staticType(node: any): string | null {
-  const attribute = node.startTag.attributes.find(
-    (attribute: any) => !attribute.directive && attribute.key.name === 'type' && attribute.value,
-  )
-  return attribute ? attribute.value.value : null
+/** `type="hidden"` carries data rather than input, so no Nuxt UI control replaces it. */
+const IGNORED_TYPE = 'hidden'
+
+function staticType(node: VueAST.VElement): string | null {
+  return getStaticAttribute(node, 'type')?.toLowerCase() ?? null
+}
+
+interface Options {
+  controls?: Record<string, string>
+  types?: Record<string, string>
 }
 
 export const preferUFormControls: Rule = {
@@ -36,43 +46,50 @@ export const preferUFormControls: Rule = {
       description: 'Prefer Nuxt UI form controls over raw form elements.',
       url: docsUrl('nuxt-ui/prefer-u-form-controls'),
     },
-    schema: componentOptionsSchema({
-      /** Extra `tag` → `Component` mappings, merged onto the built-in native-element map. */
-      controls: { type: 'object', additionalProperties: { type: 'string' } },
-      /** Extra input-`type` → `Component` mappings, merged onto the built-in type map. */
-      types: { type: 'object', additionalProperties: { type: 'string' } },
-    }),
+    schema: [{
+      type: 'object',
+      properties: {
+        controls: { type: 'object', additionalProperties: { type: 'string' } },
+        types: { type: 'object', additionalProperties: { type: 'string' } },
+      },
+      additionalProperties: false,
+    }],
     messages: {
-      preferUFormControl: 'Use `<{{ replacement }}>` instead of `<{{ tag }}>`; add `data-raw` to allow the native element.',
-      preferSpecificControl: 'Use `<{{ replacement }}>` instead of `<UInput type="{{ type }}">`; add `data-raw` to allow the native element.',
+      preferUFormControl: 'Use `<{{ replacement }}>` instead of `<{{ tag }}>`.',
+      preferSpecificControl: 'Use `<{{ replacement }}>` instead of `<{{ component }} type="{{ type }}">`.',
     },
   },
-  create(context: any) {
-    const options = context.options[0] ?? {}
+  create(context: Context): Visitor {
+    const options = (context.options[0] ?? {}) as Options
     const controlMap: Record<string, string> = { ...CONTROL_MAP, ...options.controls }
     const typeMap: Record<string, string> = { ...TYPE_MAP, ...options.types }
-    const matcher = createComponentMatcher(context)
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (hasRawOptOut(node))
-          return
-
+      VElement(node: VueAST.VElement) {
         const type = staticType(node)
+        if (type === IGNORED_TYPE)
+          return
 
-        // `<UInput type="number">`, already Nuxt UI, but a dedicated component fits better.
         if (matcher.is(node, 'Input')) {
-          const replacement = type ? typeMap[type] : null
-          if (replacement) {
+          const replacement = type === null ? undefined : typeMap[type]
+          if (type !== null && replacement) {
             context.report({
               loc: node.startTag.loc,
               messageId: 'preferSpecificControl',
-              data: { type, replacement },
+              data: {
+                type,
+                replacement: matcher.prefixed(replacement),
+                component: matcher.prefixed('Input'),
+              },
             })
           }
           return
         }
 
+        if (!isNativeHtmlElement(node))
+          return
+
         const base = controlMap[node.name]
         if (!base)
           return
@@ -84,7 +101,7 @@ export const preferUFormControls: Rule = {
         context.report({
           loc: node.startTag.loc,
           messageId: 'preferUFormControl',
-          data: { tag: node.name, replacement },
+          data: { tag: node.name, replacement: matcher.prefixed(replacement) },
         })
       },
     })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md
index 8ed003f..9182815 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.md
@@ -6,8 +6,13 @@ controls such as `<UInput>`.
 
 The rule reports a `<label>` when it wraps a known native or Nuxt UI form control, or when
 its static `for` value matches the static `id` of one. It does not report standalone
-label-like text or labels targeting non-form elements. Use `data-raw` as a local escape
-hatch when a native label is intentional.
+label-like text or labels targeting non-form elements, nor a component whose name merely
+lowercases to a native tag (`<Label>`, `<Input>`). Suppress an intentional native label with
+`<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-form-field -->`.
+
+When the original control is native, migrate both halves of the pair. Keeping a native
+`<input>` inside `UFormField` is not equivalent because it does not consume the ID provided
+by Nuxt UI.
 
 ## Incorrect
 
@@ -18,6 +23,16 @@ hatch when a native label is intentional.
 </template>
 ```
 
+For a native pair, replace the control as well:
+
+```vue
+<template>
+  <UFormField label="Email" name="email">
+    <UInput v-model="email" />
+  </UFormField>
+</template>
+```
+
 ## Correct
 
 ```vue
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.test.ts
index 75e5cc4..464d9f9 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.test.ts
@@ -1,26 +1,23 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
-const rule = plugin.rules?.['prefer-u-form-field']
+const rule = nuxtUiPlugin.rules['prefer-u-form-field']
 
 describe('prefer-u-form-field', () => {
   it('reports identifiable hand-written label/control pairs', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-
-    tester.run('prefer-u-form-field', rule as never, {
+    tester.run('prefer-u-form-field', rule, {
       valid: [
-        { filename: 'component.vue', code: '<template><UFormField label="Email"><UInput /></UFormField></template>' },
-        { filename: 'component.vue', code: '<template><label>Decorative text</label></template>' },
-        { filename: 'component.vue', code: '<template><label for="panel">Panel</label><section id="panel" /></template>' },
-        { filename: 'component.vue', code: '<template><label for="missing">External control</label></template>' },
-        { filename: 'component.vue', code: '<template><label for="email" data-raw>Email</label><input id="email"></template>' },
+        { code: '<template><UFormField label="Email"><UInput /></UFormField></template>' },
+        { code: '<template><label>Decorative text</label></template>' },
+        { code: '<template><label for="panel">Panel</label><section id="panel" /></template>' },
+        { code: '<template><label for="missing">External control</label></template>' },
+        { code: '<template><Label><Input /></Label></template>' },
       ],
       invalid: [
-        { filename: 'component.vue', code: '<template><label>Email <UInput /></label></template>', errors: [{ messageId: 'preferUFormField' }] },
-        { filename: 'component.vue', code: '<template><label><span>Name</span><input></label></template>', errors: [{ messageId: 'preferUFormField' }] },
-        { filename: 'component.vue', code: '<template><label for="country">Country</label><USelect id="country" /></template>', errors: [{ messageId: 'preferUFormField' }] },
+        { code: '<template><label>Email <UInput /></label></template>', errors: [{ messageId: 'preferUFormField' }] },
+        { code: '<template><label><span>Name</span><input></label></template>', errors: [{ messageId: 'preferUFormField' }] },
+        { code: '<template><label for="country">Country</label><USelect id="country" /></template>', errors: [{ messageId: 'preferUFormField' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts
index d470f44..55be4bd 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-form-field/index.ts
@@ -1,8 +1,10 @@
-import type { Rule } from '@oxlint/plugins'
-import type { ComponentMatcher } from '../component-matcher.js'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import type { ComponentMatcher } from '../../../utils/component-matcher.js'
+import { isNativeElement } from '../../../utils/component-matcher.js'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasRawOptOut } from '../utils.js'
+import { defineTemplateVisitor, documentRoot, getStaticAttribute } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 const NATIVE_CONTROLS = new Set(['input', 'select', 'textarea'])
 
@@ -21,8 +23,8 @@ const UI_CONTROLS = new Set([
   'Textarea',
 ])
 
-function isFormControl(node: any, matcher: ComponentMatcher): boolean {
-  return NATIVE_CONTROLS.has(node.name) || matcher.isOneOf(node, UI_CONTROLS)
+function isFormControl(node: VueAST.VElement, matcher: ComponentMatcher): boolean {
+  return [...NATIVE_CONTROLS].some(tag => isNativeElement(node, tag)) || matcher.isOneOf(node, UI_CONTROLS)
 }
 
 function containsFormControl(node: any, matcher: ComponentMatcher): boolean {
@@ -32,26 +34,12 @@ function containsFormControl(node: any, matcher: ComponentMatcher): boolean {
   )
 }
 
-function staticAttribute(node: any, name: string): string | null {
-  const attribute = node.startTag.attributes.find(
-    (candidate: any) => !candidate.directive && candidate.key.name === name && candidate.value,
-  )
-  return attribute?.value.value ?? null
-}
-
 function hasControlWithId(node: any, id: string, matcher: ComponentMatcher): boolean {
-  if (node.type === 'VElement' && isFormControl(node, matcher) && staticAttribute(node, 'id') === id)
+  if (node.type === 'VElement' && isFormControl(node, matcher) && getStaticAttribute(node, 'id') === id)
     return true
   return node.children?.some((child: any) => hasControlWithId(child, id, matcher)) ?? false
 }
 
-function documentRoot(node: any): any {
-  let root = node
-  while (root.parent)
-    root = root.parent
-  return root
-}
-
 export const preferUFormField: Rule = {
   meta: {
     type: 'suggestion',
@@ -59,17 +47,17 @@ export const preferUFormField: Rule = {
       description: 'Prefer UFormField over hand-written label and form-control pairs.',
       url: docsUrl('nuxt-ui/prefer-u-form-field'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
-      preferUFormField: 'Use `<UFormField label="...">` for this labelled control; add `data-raw` when a native label is intentional.',
+      preferUFormField: 'Use `<UFormField label="...">` for this labelled control.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (node.name !== 'label' || hasRawOptOut(node))
+      VElement(node: VueAST.VElement) {
+        if (!isNativeElement(node, 'label'))
           return
 
         if (containsFormControl(node, matcher)) {
@@ -77,7 +65,7 @@ export const preferUFormField: Rule = {
           return
         }
 
-        const id = staticAttribute(node, 'for')
+        const id = getStaticAttribute(node, 'for')
         if (id && hasControlWithId(documentRoot(node), id, matcher))
           context.report({ loc: node.startTag.loc, messageId: 'preferUFormField' })
       },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
index 8215803..05eb44c 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.md
@@ -1,7 +1,9 @@
 # `@nustack/nuxt-ui/prefer-u-icon`
 
 Prefer Nuxt UI's `UIcon` component and its `name` prop over raw Iconify utility classes.
-Use `data-raw` for a deliberate low-level icon implementation.
+Only a native `<i>` or `<span>` is reported, never a component whose name merely lowercases
+to one (`<Span>`). Suppress a deliberate low-level icon implementation with
+`<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-icon -->`.
 
 ## Incorrect
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.test.ts
index 249f347..0d027c6 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.test.ts
@@ -1,14 +1,15 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('prefer-u-icon', () => {
   it('prefers UIcon for Iconify classes', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('prefer-u-icon', plugin.rules?.['prefer-u-icon'] as never, {
-      valid: [{ filename: 'component.vue', code: '<template><UIcon name="i-lucide-search" /></template>' }],
-      invalid: [{ filename: 'component.vue', code: '<template><i class="i-lucide-search" /></template>', errors: [{ messageId: 'preferIcon' }] }],
+    tester.run('prefer-u-icon', nuxtUiPlugin.rules['prefer-u-icon'], {
+      valid: [{ code: '<template><UIcon name="i-lucide-search" /></template>' }],
+      invalid: [
+        { code: '<template><i class="i-lucide-search" /></template>', errors: [{ messageId: 'preferIcon', data: { component: 'UIcon', icon: 'i-lucide-search' } }] },
+        { code: '<template><i class="i-lucide-search" /></template>', settings: { '@nustack/nuxt-ui': { enabled: true, prefix: 'Nu' } }, errors: [{ messageId: 'preferIcon', data: { component: 'NuIcon', icon: 'i-lucide-search' } }] },
+      ],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.ts
index 63ddad1..0830ca6 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-icon/index.ts
@@ -1,6 +1,8 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { defineTemplateVisitor, getStaticAttribute, hasRawOptOut } from '../utils.js'
+import { defineTemplateVisitor, getStaticAttribute } from '../../../utils/template.js'
+import { nuxtUiPrefix } from '../components.js'
 
 export const preferUIcon: Rule = {
   meta: {
@@ -11,18 +13,19 @@ export const preferUIcon: Rule = {
     },
     schema: [],
     messages: {
-      preferIcon: 'Use `<UIcon name="{{ icon }}" />` instead of a raw icon class.',
+      preferIcon: 'Use `<{{ component }} name="{{ icon }}" />` instead of a raw icon class.',
     },
   },
-  create(context: any) {
+  create(context: Context): Visitor {
+    const component = `${nuxtUiPrefix(context)}Icon`
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (hasRawOptOut(node) || (node.name !== 'i' && node.name !== 'span'))
+      VElement(node: VueAST.VElement) {
+        if (node.name !== 'i' && node.name !== 'span')
           return
         const classes = getStaticAttribute(node, 'class')
         const icon = classes?.split(/\s+/).find((value: string) => /^i-[\w-]+$/.test(value))
         if (icon)
-          context.report({ loc: node.startTag.loc, messageId: 'preferIcon', data: { icon } })
+          context.report({ loc: node.startTag.loc, messageId: 'preferIcon', data: { component, icon } })
       },
     })
   },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
index 17bae8c..1967c65 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.md
@@ -18,7 +18,11 @@ Prefer Nuxt UI's `UKbd` over a raw `kbd` element for theme-aware keyboard hints.
 </template>
 ```
 
-Use `data-raw` when native markup is intentional.
+Suppress intentional native markup with
+`<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-kbd -->`.
+
+Only genuine native elements are reported: a component whose name merely lowercases to the
+tag (`<Kbd>`) is left alone.
 
 ## Further reading
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.test.ts
index 7969171..16f9b6d 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.test.ts
@@ -1,14 +1,12 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('prefer-u-kbd', () => {
   it('prefers UKbd', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('prefer-u-kbd', plugin.rules?.['prefer-u-kbd'] as never, {
-      valid: [{ filename: 'component.vue', code: '<template><UKbd value="K" /></template>' }],
-      invalid: [{ filename: 'component.vue', code: '<template><kbd>K</kbd></template>', errors: [{ messageId: 'preferUKbd' }] }],
+    tester.run('prefer-u-kbd', nuxtUiPlugin.rules['prefer-u-kbd'], {
+      valid: [{ code: '<template><UKbd value="K" /></template>' }],
+      invalid: [{ code: '<template><kbd>K</kbd></template>', errors: [{ messageId: 'preferUKbd' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.ts
index d05cd35..c37f286 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-kbd/index.ts
@@ -2,7 +2,7 @@ import { preferUComponent } from '../prefer-u-component.js'
 
 export const preferUKbd = preferUComponent({
   nativeTag: 'kbd',
-  component: 'UKbd',
+  component: 'Kbd',
   ruleName: 'prefer-u-kbd',
   messageId: 'preferUKbd',
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md
index f5bd711..1532a27 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.md
@@ -20,8 +20,11 @@ drop-in for an anchor.
 </template>
 ```
 
-Use `data-raw` as a local escape hatch when a raw native anchor is intentional (e.g. a
-`mailto:` or external download link you don't want routed).
+Suppress an intentional raw native anchor (e.g. a `mailto:` or external download link you
+don't want routed) with `<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-link -->`.
+
+Only genuine native elements are reported: a component whose name merely lowercases to the
+tag (`<Link>`) is left alone, and so is SVG's own `<a>`.
 
 ## Further reading
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.test.ts
index edbb398..1a5662c 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.test.ts
@@ -1,21 +1,26 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
-const rule = plugin.rules?.['prefer-u-link']
+const rule = nuxtUiPlugin.rules['prefer-u-link']
 
 describe('prefer-u-link', () => {
   it('reports raw anchors in Vue templates', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-
-    tester.run('prefer-u-link', rule as never, {
+    tester.run('prefer-u-link', rule, {
       valid: [
-        { filename: 'component.vue', code: '<template><ULink to="/home">Home</ULink></template>' },
-        { filename: 'component.vue', code: '<template><a data-raw href="/home">Home</a></template>' },
+        { code: '<template><ULink to="/home">Home</ULink></template>' },
+        { code: '<template><svg><a href="#x" /></svg></template>' },
       ],
       invalid: [
-        { filename: 'component.vue', code: '<template><a href="/home">Home</a></template>', errors: [{ messageId: 'preferULink' }] },
+        {
+          code: '<template><a href="/home">Home</a></template>',
+          errors: [{ messageId: 'preferULink', data: { component: 'ULink', tag: 'a' } }],
+        },
+        {
+          code: '<template><a href="/home">Home</a></template>',
+          settings: { '@nustack/nuxt-ui': { enabled: true, prefix: 'Nu' } },
+          errors: [{ messageId: 'preferULink', data: { component: 'NuLink', tag: 'a' } }],
+        },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.ts
index 2dc3671..af2777a 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-link/index.ts
@@ -2,7 +2,7 @@ import { preferUComponent } from '../prefer-u-component.js'
 
 export const preferULink = preferUComponent({
   nativeTag: 'a',
-  component: 'ULink',
+  component: 'Link',
   ruleName: 'prefer-u-link',
   messageId: 'preferULink',
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md
index 6b0d506..41c91dc 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.md
@@ -21,8 +21,11 @@ dialog behavior, including focus management and screen-reader semantics.
 </template>
 ```
 
-The migration is structural rather than a direct tag rename. Use `data-raw` for deliberately
-hand-written native dialogs.
+The migration is structural rather than a direct tag rename. Suppress a deliberately
+hand-written native dialog with `<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-modal -->`.
+
+Only genuine native elements are reported: a component whose name merely lowercases to the
+tag (`<Dialog>`) is left alone.
 
 ## Further reading
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.test.ts
index 81d0f73..3f1798d 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.test.ts
@@ -1,14 +1,12 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('prefer-u-modal', () => {
   it('prefers UModal', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('prefer-u-modal', plugin.rules?.['prefer-u-modal'] as never, {
-      valid: [{ filename: 'component.vue', code: '<template><UModal title="Confirm" /></template>' }],
-      invalid: [{ filename: 'component.vue', code: '<template><dialog>Confirm</dialog></template>', errors: [{ messageId: 'preferUModal' }] }],
+    tester.run('prefer-u-modal', nuxtUiPlugin.rules['prefer-u-modal'], {
+      valid: [{ code: '<template><UModal title="Confirm" /></template>' }],
+      invalid: [{ code: '<template><dialog>Confirm</dialog></template>', errors: [{ messageId: 'preferUModal' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.ts
index 86bb2ef..58870e7 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-modal/index.ts
@@ -2,7 +2,7 @@ import { preferUComponent } from '../prefer-u-component.js'
 
 export const preferUModal = preferUComponent({
   nativeTag: 'dialog',
-  component: 'UModal',
+  component: 'Modal',
   ruleName: 'prefer-u-modal',
   messageId: 'preferUModal',
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
index ea4d4f1..8ad5dc1 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.md
@@ -18,7 +18,11 @@ Prefer Nuxt UI's accessible and theme-aware `UProgress` over a raw `progress` el
 </template>
 ```
 
-Use `data-raw` when native markup is intentional.
+Suppress intentional native markup with
+`<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-progress -->`.
+
+Only genuine native elements are reported: a component whose name merely lowercases to the
+tag (`<Progress>`) is left alone, and so are SVG elements.
 
 ## Further reading
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.test.ts
index a550aa2..3aa99ca 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.test.ts
@@ -1,14 +1,12 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('prefer-u-progress', () => {
   it('prefers UProgress', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('prefer-u-progress', plugin.rules?.['prefer-u-progress'] as never, {
-      valid: [{ filename: 'component.vue', code: '<template><UProgress :model-value="50" /></template>' }],
-      invalid: [{ filename: 'component.vue', code: '<template><progress value="50" max="100" /></template>', errors: [{ messageId: 'preferUProgress' }] }],
+    tester.run('prefer-u-progress', nuxtUiPlugin.rules['prefer-u-progress'], {
+      valid: [{ code: '<template><UProgress :model-value="50" /></template>' }],
+      invalid: [{ code: '<template><progress value="50" max="100" /></template>', errors: [{ messageId: 'preferUProgress' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.ts
index 948501b..ab080d2 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-progress/index.ts
@@ -2,7 +2,7 @@ import { preferUComponent } from '../prefer-u-component.js'
 
 export const preferUProgress = preferUComponent({
   nativeTag: 'progress',
-  component: 'UProgress',
+  component: 'Progress',
   ruleName: 'prefer-u-progress',
   messageId: 'preferUProgress',
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
index 32c9428..6ad9e92 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.md
@@ -19,7 +19,11 @@ optional label handling.
 </template>
 ```
 
-Use `data-raw` when native markup is intentional.
+Suppress intentional native markup with
+`<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-separator -->`.
+
+Only genuine native elements are reported: a component whose name merely lowercases to the
+tag (`<Hr>`) is left alone.
 
 ## Further reading
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.test.ts
index 53a0c61..a55ac2b 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.test.ts
@@ -1,14 +1,12 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('prefer-u-separator', () => {
   it('prefers USeparator', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('prefer-u-separator', plugin.rules?.['prefer-u-separator'] as never, {
-      valid: [{ filename: 'component.vue', code: '<template><USeparator /></template>' }],
-      invalid: [{ filename: 'component.vue', code: '<template><hr></template>', errors: [{ messageId: 'preferUSeparator' }] }],
+    tester.run('prefer-u-separator', nuxtUiPlugin.rules['prefer-u-separator'], {
+      valid: [{ code: '<template><USeparator /></template>' }],
+      invalid: [{ code: '<template><hr></template>', errors: [{ messageId: 'preferUSeparator' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.ts
index 3f7a9ec..d8e3b78 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-separator/index.ts
@@ -2,7 +2,7 @@ import { preferUComponent } from '../prefer-u-component.js'
 
 export const preferUSeparator = preferUComponent({
   nativeTag: 'hr',
-  component: 'USeparator',
+  component: 'Separator',
   ruleName: 'prefer-u-separator',
   messageId: 'preferUSeparator',
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md
index 83ea7f4..55510d5 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.md
@@ -3,7 +3,7 @@
 Prefer Nuxt UI's `<UTable>` over raw `<table>` elements when `@nuxt/ui` is available.
 
 Unlike the other `prefer-u-*` rules, `UTable` is **data-driven** (`:data` / `:columns`)
-rather than a structural drop-in for hand-written `<tr>`/`<td>` markup. Reach for `data-raw`
+rather than a structural drop-in for hand-written `<tr>`/`<td>` markup. Suppress the report
 whenever a bespoke static table genuinely reads better as markup.
 
 ## Incorrect
@@ -26,7 +26,11 @@ whenever a bespoke static table genuinely reads better as markup.
 </template>
 ```
 
-Use `data-raw` as a local escape hatch when a raw native table is intentional.
+Suppress an intentional raw native table with
+`<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-table -->`.
+
+Only genuine native elements are reported: a component whose name merely lowercases to the
+tag (`<Table>`) is left alone.
 
 ## Further reading
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.test.ts
index 6f38dff..8843610 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.test.ts
@@ -1,21 +1,17 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
-const rule = plugin.rules?.['prefer-u-table']
+const rule = nuxtUiPlugin.rules['prefer-u-table']
 
 describe('prefer-u-table', () => {
   it('reports raw tables in Vue templates', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-
-    tester.run('prefer-u-table', rule as never, {
+    tester.run('prefer-u-table', rule, {
       valid: [
-        { filename: 'component.vue', code: '<template><UTable :data="rows" /></template>' },
-        { filename: 'component.vue', code: '<template><table data-raw><tbody /></table></template>' },
+        { code: '<template><UTable :data="rows" /></template>' },
       ],
       invalid: [
-        { filename: 'component.vue', code: '<template><table><tbody /></table></template>', errors: [{ messageId: 'preferUTable' }] },
+        { code: '<template><table><tbody /></table></template>', errors: [{ messageId: 'preferUTable' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.ts
index b58bb9f..0bfb5fe 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-table/index.ts
@@ -2,7 +2,7 @@ import { preferUComponent } from '../prefer-u-component.js'
 
 export const preferUTable = preferUComponent({
   nativeTag: 'table',
-  component: 'UTable',
+  component: 'Table',
   ruleName: 'prefer-u-table',
   messageId: 'preferUTable',
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md
index e14bda1..319ccbe 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.md
@@ -24,6 +24,7 @@ bindings, drag and drop, or expansion controls.
 </template>
 ```
 
-Add `data-raw` to the tree root when a custom implementation is required. A custom tree
+Suppress the report with `<!-- eslint-disable-next-line @nustack/nuxt-ui/prefer-u-tree -->`
+when a custom implementation is required. A custom tree
 remains responsible for arrow-key navigation, Home/End behavior, expansion state, focus
 movement, and keyboard-equivalent reordering.
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.test.ts
index 9e5010a..8616112 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.test.ts
@@ -1,46 +1,37 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
 import { preferUTree } from './index.js'
 
-const tester = new RuleTester({
-  languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser },
-})
-
 describe('prefer-u-tree', () => {
   it('reports only explicit static tree roots', () => {
-    tester.run('prefer-u-tree', preferUTree as never, {
+    tester.run('prefer-u-tree', preferUTree, {
       valid: [
-        { filename: 'component.vue', code: '<template><UTree :items="items" /></template>' },
+        { code: '<template><UTree :items="items" /></template>' },
         {
-          filename: 'component.vue',
           code: '<template><UTree role="tree" :items="items" /></template>',
         },
+        { code: '<template><ul :role="role"><li /></ul></template>' },
         {
-          filename: 'component.vue',
-          code: '<template><ul role="tree" data-raw><li role="treeitem" /></ul></template>',
-        },
-        { filename: 'component.vue', code: '<template><ul :role="role"><li /></ul></template>' },
-        {
-          filename: 'component.vue',
           code: '<template><ul :role="\'tree\'"><li /></ul></template>',
         },
-        { filename: 'component.vue', code: '<template><ul role="treegrid"><li /></ul></template>' },
+        { code: '<template><ul role="treegrid"><li /></ul></template>' },
         {
-          filename: 'component.vue',
           code: '<template><ul><TreeNode v-for="item in items" :item="item" /></ul></template>',
         },
       ],
       invalid: [
         {
-          filename: 'component.vue',
           code: '<template><ul role="tree"><li role="treeitem" /></ul></template>',
           errors: [{ messageId: 'preferUTree' }],
         },
         {
-          filename: 'component.vue',
           code: '<template><CustomTree role="tree" /></template>',
-          errors: [{ messageId: 'preferUTree' }],
+          errors: [{ messageId: 'preferUTree', data: { component: 'UTree' } }],
+        },
+        {
+          code: '<template><ul role="tree"><li role="treeitem" /></ul></template>',
+          settings: { '@nustack/nuxt-ui': { enabled: true, prefix: 'Nu' } },
+          errors: [{ messageId: 'preferUTree', data: { component: 'NuTree' } }],
         },
       ],
     })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts
index bfc960d..8a32701 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/prefer-u-tree/index.ts
@@ -1,7 +1,8 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasRawOptOut } from '../utils.js'
+import { defineTemplateVisitor } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 function hasStaticTreeRole(node: any): boolean {
   return node.startTag.attributes.some(
@@ -17,18 +18,18 @@ export const preferUTree: Rule = {
       description: 'Prefer UTree over hand-written elements with an explicit tree role.',
       url: docsUrl('nuxt-ui/prefer-u-tree'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       preferUTree:
-        'Use `<UTree>` instead of a custom `role="tree"`; custom trees must implement the complete tree keyboard and focus model. Add `data-raw` to keep it.',
+        'Use `<UTree>` instead of a custom `role="tree"`; custom trees must implement the complete tree keyboard and focus model.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (matcher.is(node, 'Tree') || hasRawOptOut(node) || !hasStaticTreeRole(node))
+      VElement(node: VueAST.VElement) {
+        if (matcher.is(node, 'Tree') || !hasStaticTreeRole(node))
           return
 
         context.report({
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
index 6d73c64..84836f1 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.md
@@ -1,7 +1,8 @@
 # `@nustack/nuxt-ui/require-avatar-alt`
 
 Require `alt` on image-backed `UAvatar` components. Use `aria-hidden` for an explicitly
-decorative avatar.
+decorative avatar. An empty `alt=""` counts as a deliberate decorative marker, but a binding
+known to be nullish (`:alt="undefined"`) renders no alternative text and is reported.
 
 ## Incorrect
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.test.ts
index ccaa781..321fa04 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.test.ts
@@ -1,17 +1,24 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('require-avatar-alt', () => {
   it('requires alt for image avatars', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('require-avatar-alt', plugin.rules?.['require-avatar-alt'] as never, {
+    tester.run('require-avatar-alt', nuxtUiPlugin.rules['require-avatar-alt'], {
       valid: [
-        { filename: 'component.vue', code: '<template><UAvatar src="/avatar.png" alt="Ada" /></template>' },
-        { filename: 'component.vue', code: '<template><UAvatar src="/mark.svg" aria-hidden="true" /></template>' },
+        { code: '<template><UAvatar src="/avatar.png" alt="Ada" /></template>' },
+        { code: '<template><UAvatar src="/mark.svg" aria-hidden="true" /></template>' },
+        { code: '<template><UAvatar :src="null" /></template>' },
+        { code: '<template><UAvatar src="/decor.svg" alt="" /></template>' },
+        { code: '<template><UAvatar v-bind="{ src: \'/ada.png\', alt: \'Ada\' }" /></template>' },
+      ],
+      invalid: [
+        { code: '<template><UAvatar src="/avatar.png" /></template>', errors: [{ messageId: 'missingAlt' }] },
+        { code: '<template><UAvatar src="/avatar.png" :aria-hidden="false" /></template>', errors: [{ messageId: 'missingAlt' }] },
+        { code: '<template><UAvatar src="/avatar.png" :aria-hidden="hidden" /></template>', errors: [{ messageId: 'missingAlt' }] },
+        { code: '<template><UAvatar v-bind="{ src: \'/avatar.png\' }" /></template>', errors: [{ messageId: 'missingAlt' }] },
+        { code: '<template><UAvatar src="/avatar.png" :alt="undefined" /></template>', errors: [{ messageId: 'missingAlt' }] },
       ],
-      invalid: [{ filename: 'component.vue', code: '<template><UAvatar src="/avatar.png" /></template>', errors: [{ messageId: 'missingAlt' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts
index 651ba68..6c34471 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-avatar-alt/index.ts
@@ -1,7 +1,8 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasAttribute } from '../utils.js'
+import { defineTemplateVisitor, getStaticBoolean, hasDefiniteAttribute } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 export const requireAvatarAlt: Rule = {
   meta: {
@@ -10,20 +11,23 @@ export const requireAvatarAlt: Rule = {
       description: 'Require alternative text for Nuxt UI avatars that render an image.',
       url: docsUrl('nuxt-ui/require-avatar-alt'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       missingAlt: 'Add `alt` to `<UAvatar>` (or explicitly mark a decorative avatar with `aria-hidden`).',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (!matcher.is(node, 'Avatar') || !hasAttribute(node, 'src'))
+      VElement(node: VueAST.VElement) {
+        if (!matcher.is(node, 'Avatar') || !hasDefiniteAttribute(node, 'src'))
           return
-        if (!hasAttribute(node, 'alt') && !hasAttribute(node, 'aria-hidden'))
-          context.report({ loc: node.startTag.loc, messageId: 'missingAlt' })
+        if (hasDefiniteAttribute(node, 'alt'))
+          return
+        if (getStaticBoolean(node, 'aria-hidden') === true)
+          return
+        context.report({ loc: node.startTag.loc, messageId: 'missingAlt' })
       },
     })
   },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
index b293030..7867bb7 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
@@ -24,9 +24,11 @@ supported `label` or `legend` API, ARIA naming, native `<label>` associations, a
 </template>
 ```
 
+A `UFormField` label only names a field that renders a single control. Controls in one
+`v-if` / `v-else-if` / `v-else` chain are alternatives, so the chain counts as one control.
+
 Dynamic bindings are accepted because their runtime value cannot be proven statically.
-`data-raw` does not disable accessibility checks; use a standard ESLint disable comment for
-an intentional exception.
+An intentional exception uses a standard ESLint disable comment.
 
 ## Further reading
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
index a814101..94834d5 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
@@ -1,23 +1,20 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('require-form-control-label', () => {
   it('requires accessible labels on form controls', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('require-form-control-label', plugin.rules?.['require-form-control-label'] as never, {
+    tester.run('require-form-control-label', nuxtUiPlugin.rules['require-form-control-label'], {
       valid: [
-        { filename: 'component.vue', code: '<template><UInput aria-label="Search" /></template>' },
-        { filename: 'component.vue', code: '<template><UCheckboxGroup legend="Theme" /></template>' },
-        { filename: 'component.vue', code: '<template><UFormField label="Email"><UInput /></UFormField></template>' },
-        { filename: 'component.vue', code: '<template><UFormField><template #label>Email</template><UInput /></UFormField></template>' },
-        { filename: 'component.vue', code: '<template><UInput data-raw /></template>' },
+        { code: '<template><UInput aria-label="Search" /></template>' },
+        { code: '<template><UCheckboxGroup legend="Theme" /></template>' },
+        { code: '<template><UFormField label="Email"><UInput /></UFormField></template>' },
+        { code: '<template><UFormField><template #label>Email</template><UInput /></UFormField></template>' },
       ],
       invalid: [
-        { filename: 'component.vue', code: '<template><UInput placeholder="Search" /></template>', errors: [{ messageId: 'missingLabel' }] },
-        { filename: 'component.vue', code: '<template><URadioGroup :items="items" /></template>', errors: [{ messageId: 'missingLabel' }] },
-        { filename: 'component.vue', code: '<template><UFormField><UInput /></UFormField></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UInput placeholder="Search" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><URadioGroup :items="items" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UFormField><UInput /></UFormField></template>', errors: [{ messageId: 'missingLabel' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
index 6090878..d0e468e 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
@@ -1,8 +1,10 @@
-import type { Rule } from '@oxlint/plugins'
-import type { ComponentMatcher } from '../component-matcher.js'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import type { ComponentMatcher } from '../../../utils/component-matcher.js'
+import { elementAncestor } from '../../../utils/component-matcher.js'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasNonEmptyAttribute, hasRawOptOut, hasSlot } from '../utils.js'
+import { defineTemplateVisitor, hasNonEmptyAttribute, hasSlot } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 const FORM_CONTROLS = new Set([
   'Checkbox',
@@ -25,19 +27,19 @@ const FORM_CONTROLS = new Set([
   'Textarea',
 ])
 
-function hasLabeledFormFieldAncestor(node: any, matcher: ComponentMatcher): boolean {
-  let parent = node.parent
+function hasLabeledFormFieldAncestor(node: VueAST.VElement, matcher: ComponentMatcher): boolean {
+  let parent = elementAncestor(node)
   while (parent) {
     if (matcher.is(parent, 'FormField')) {
       return hasNonEmptyAttribute(parent, 'label')
         || hasSlot(parent, 'label')
     }
-    parent = parent.parent
+    parent = elementAncestor(parent)
   }
   return false
 }
 
-function hasAccessibleLabel(node: any, matcher: ComponentMatcher): boolean {
+function hasAccessibleLabel(node: VueAST.VElement, matcher: ComponentMatcher): boolean {
   return hasNonEmptyAttribute(node, 'label')
     || hasNonEmptyAttribute(node, 'legend')
     || hasNonEmptyAttribute(node, 'aria-label')
@@ -54,18 +56,18 @@ export const requireFormControlLabel: Rule = {
       description: 'Require an accessible label for Nuxt UI form controls.',
       url: docsUrl('nuxt-ui/require-form-control-label'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       missingLabel: 'Add `label`, `legend`, `aria-label`, `aria-labelledby`, or wrap `<{{ component }}>` in a `<UFormField>` with `label` or a `#label` slot.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
+      VElement(node: VueAST.VElement) {
         const control = matcher.matchOf(node, FORM_CONTROLS)
-        if (!control || hasRawOptOut(node) || hasAccessibleLabel(node, matcher))
+        if (!control || hasAccessibleLabel(node, matcher))
           return
         context.report({
           loc: node.startTag.loc,
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.test.ts
index 8fadca7..a5f2dc8 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.test.ts
@@ -1,17 +1,19 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('require-form-field-name', () => {
   it('requires a validation target inside UForm', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('require-form-field-name', plugin.rules?.['require-form-field-name'] as never, {
+    tester.run('require-form-field-name', nuxtUiPlugin.rules['require-form-field-name'], {
       valid: [
-        { filename: 'component.vue', code: '<template><UForm :state="state"><UFormField name="email" /></UForm></template>' },
-        { filename: 'component.vue', code: '<template><UFormField label="Display only" /></template>' },
+        { code: '<template><UForm :state="state"><UFormField name="email" /></UForm></template>' },
+        { code: '<template><UFormField label="Display only" /></template>' },
+      ],
+      invalid: [
+        { code: '<template><UForm :state="state"><UFormField label="Email" /></UForm></template>', errors: [{ messageId: 'missingName' }] },
+        { code: '<template><UForm :state="state"><UFormField name="" /></UForm></template>', errors: [{ messageId: 'missingName' }] },
+        { code: '<template><UForm :state="state"><UFormField :name="undefined" /></UForm></template>', errors: [{ messageId: 'missingName' }] },
       ],
-      invalid: [{ filename: 'component.vue', code: '<template><UForm :state="state"><UFormField label="Email" /></UForm></template>', errors: [{ messageId: 'missingName' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
index a7c9f6f..09ac422 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-field-name/index.ts
@@ -1,31 +1,30 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasAttribute } from '../utils.js'
+import { defineTemplateVisitor, hasNonEmptyAttribute } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 export const requireFormFieldName: Rule = {
   meta: {
-    // A `<UFormField>` without `name` still renders and labels its control; it only opts out of
-    // automatic error routing, which a purely presentational field group legitimately wants.
     type: 'suggestion',
     docs: {
       description: 'Require a validation target on Nuxt UI form fields used inside a form.',
       url: docsUrl('nuxt-ui/require-form-field-name'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       missingName: 'Add `name` or `error-pattern` to this `<UFormField>` so `<UForm>` can route validation errors to it.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
+      VElement(node: VueAST.VElement) {
         if (matcher.is(node, 'FormField')
           && matcher.hasAncestor(node, 'Form')
-          && !hasAttribute(node, 'name')
-          && !hasAttribute(node, 'error-pattern')) {
+          && !hasNonEmptyAttribute(node, 'name')
+          && !hasNonEmptyAttribute(node, 'error-pattern')) {
           context.report({ loc: node.startTag.loc, messageId: 'missingName' })
         }
       },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
index c524feb..de49ff1 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.md
@@ -3,12 +3,21 @@
 Icon-, avatar-, and loading-only `UButton` instances need an accessible label. `label`,
 `aria-label`, `title`, or visible slot content satisfies the rule.
 
+A button counts as icon-only when it carries `icon`, `leading-icon`, `trailing-icon` or `avatar`,
+when it can be `loading` (anything but a statically `false` value), or when its only content is a
+`UIcon`/`UAvatar` — including one passed through a `#leading` or `#trailing` slot. Those two
+components render an image and no text, so they never answer for the label themselves.
+
 ## Incorrect
 
 ```vue
 <template>
   <UButton icon="i-lucide-search" />
   <UButton loading />
+  <UButton leading-icon="i-lucide-search" />
+  <UButton>
+    <UIcon name="i-lucide-search" />
+  </UButton>
 </template>
 ```
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
index 01394fb..04e05dc 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.test.ts
@@ -1,22 +1,29 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('require-icon-button-label', () => {
   it('labels icon-, avatar-, and loading-only buttons', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('require-icon-button-label', plugin.rules?.['require-icon-button-label'] as never, {
+    tester.run('require-icon-button-label', nuxtUiPlugin.rules['require-icon-button-label'], {
       valid: [
-        { filename: 'component.vue', code: '<template><UButton icon="i-lucide-search" aria-label="Search" /></template>' },
-        { filename: 'component.vue', code: '<template><UButton icon="i-lucide-save">Save</UButton></template>' },
-        { filename: 'component.vue', code: '<template><UButton :loading="false" /></template>' },
-        { filename: 'component.vue', code: '<template><UButton icon="i-lucide-save"><span>Save</span></UButton></template>' },
+        { code: '<template><UButton icon="i-lucide-search" aria-label="Search" /></template>' },
+        { code: '<template><UButton icon="i-lucide-save">Save</UButton></template>' },
+        { code: '<template><UButton :loading="false" /></template>' },
+        { code: '<template><UButton icon="i-lucide-save"><span>Save</span></UButton></template>' },
+        { code: '<template><UButton icon="i-lucide-save"><LocalizedText /></UButton></template>' },
+        { code: '<template><UButton v-bind="{ loading: false }" /></template>' },
       ],
       invalid: [
-        { filename: 'component.vue', code: '<template><UButton icon="i-lucide-search" /></template>', errors: [{ messageId: 'missingLabel' }] },
-        { filename: 'component.vue', code: '<template><UButton :avatar="avatar" /></template>', errors: [{ messageId: 'missingLabel' }] },
-        { filename: 'component.vue', code: '<template><UButton loading /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UButton icon="i-lucide-search" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UButton :avatar="avatar" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UButton loading /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UButton leading-icon="i-lucide-search" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UButton><UIcon name="i-lucide-search" /></UButton></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UButton><template #leading><UIcon name="i-lucide-search" /></template></UButton></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UButton icon="i-lucide-search"><span aria-hidden="true">Search</span></UButton></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UButton icon="i-lucide-search"><span v-if="false">Search</span></UButton></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UButton v-bind="{ loading: true }" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UButton icon="i-lucide-search"><Transition /></UButton></template>', errors: [{ messageId: 'missingLabel' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
index c8c3901..9457a3d 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-icon-button-label/index.ts
@@ -1,16 +1,24 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import type { ComponentMatcher } from '../../../utils/component-matcher.js'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, getAttribute, hasAttribute, hasLabelContent, hasNonEmptyAttribute } from '../utils.js'
+import { defineTemplateVisitor, getAttributeValue, hasAttribute, hasLabelContent, hasNonEmptyAttribute } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
-function canBeLoading(node: any): boolean {
-  const attribute = getAttribute(node, 'loading')
-  if (!attribute)
+const ICON_PROPS = ['icon', 'leading-icon', 'trailing-icon', 'avatar']
+
+const DECORATIVE_COMPONENTS = ['Icon', 'Avatar']
+
+function canBeLoading(node: VueAST.VElement): boolean {
+  const loading = getAttributeValue(node, 'loading')
+  if (!loading.present)
     return false
-  if (!attribute.directive)
-    return true
-  const expression = attribute.value?.expression
-  return expression?.type !== 'Literal' || expression.value !== false
+  return !loading.known || (loading.value !== false && loading.value !== 'false')
+}
+
+function hasDecorativeChild(node: VueAST.VElement, matcher: ComponentMatcher): boolean {
+  return node.children.some(child => child.type === 'VElement'
+    && (matcher.isOneOf(child, DECORATIVE_COMPONENTS) || hasDecorativeChild(child, matcher)))
 }
 
 export const requireIconButtonLabel: Rule = {
@@ -20,22 +28,28 @@ export const requireIconButtonLabel: Rule = {
       description: 'Require an accessible label for icon-, avatar-, and loading-only Nuxt UI buttons.',
       url: docsUrl('nuxt-ui/require-icon-button-label'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       missingLabel: 'Icon-, avatar-, or loading-only `<UButton>` needs `label`, `aria-label`, or an accessible `title`.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (!matcher.is(node, 'Button')
-          || (!hasAttribute(node, 'icon') && !hasAttribute(node, 'avatar') && !canBeLoading(node))) {
+      VElement(node: VueAST.VElement) {
+        if (!matcher.is(node, 'Button'))
           return
-        }
+
+        const iconOnly = ICON_PROPS.some(prop => hasAttribute(node, prop))
+          || canBeLoading(node)
+          || hasDecorativeChild(node, matcher)
+        if (!iconOnly)
+          return
+
         if (hasNonEmptyAttribute(node, 'label') || hasNonEmptyAttribute(node, 'aria-label')
-          || hasNonEmptyAttribute(node, 'title') || hasLabelContent(node)) {
+          || hasNonEmptyAttribute(node, 'title')
+          || hasLabelContent(node, child => matcher.isOneOf(child, DECORATIVE_COMPONENTS))) {
           return
         }
         context.report({ loc: node.startTag.loc, messageId: 'missingLabel' })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.md
new file mode 100644
index 0000000..68954cd
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.md
@@ -0,0 +1,25 @@
+# `@nustack/nuxt-ui/require-nested-form-prop`
+
+Nuxt UI v4 requires an inner `UForm` to opt into parent-form integration with the `nested`
+prop. The rule does not require `name`: unnamed nested forms are valid when they share the
+parent state rather than target a separate state path.
+
+## Incorrect
+
+```vue
+<UForm :state="state">
+  <UForm :schema="childSchema" />
+</UForm>
+```
+
+## Correct
+
+```vue
+<UForm :state="state">
+  <UForm nested :schema="childSchema" />
+</UForm>
+```
+
+## Further reading
+
+- [Nuxt UI Form nesting](https://ui.nuxt.com/docs/components/form#nesting-forms)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.test.ts
new file mode 100644
index 0000000..e38e8fd
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.test.ts
@@ -0,0 +1,22 @@
+import { describe, it } from 'vitest'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
+
+describe('require-nested-form-prop', () => {
+  it('requires explicit nested form behavior', () => {
+    tester.run('require-nested-form-prop', nuxtUiPlugin.rules['require-nested-form-prop'], {
+      valid: [
+        { code: '<template><UForm :state="state"><UForm nested :schema="child" /></UForm></template>' },
+        { code: '<template><UForm :state="state"><UForm nested="" :schema="child" /></UForm></template>' },
+        { code: '<template><UForm :state="state"><UForm nested="nested" :schema="child" /></UForm></template>' },
+        { code: '<template><UForm :state="state"><UForm :nested="isNested" :schema="child" /></UForm></template>' },
+        { code: '<template><UForm :state="state" /></template>' },
+      ],
+      invalid: [
+        { code: '<template><UForm :state="state"><UForm :schema="child" /></UForm></template>', errors: [{ messageId: 'requireNested' }] },
+        { code: '<template><UForm :state="state"><UForm :nested="false" /></UForm></template>', errors: [{ messageId: 'requireNested' }] },
+        { code: '<template><UForm :state="state"><UForm :nested="undefined" /></UForm></template>', errors: [{ messageId: 'requireNested' }] },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.ts
new file mode 100644
index 0000000..b82ba0b
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-nested-form-prop/index.ts
@@ -0,0 +1,35 @@
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import { docsUrl } from '../../../utils/docs-url.js'
+import { defineTemplateVisitor, getAttributeValue, getStaticBoolean } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
+
+export const requireNestedFormProp: Rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require the nested prop when a UForm is rendered inside another UForm.',
+      url: docsUrl('nuxt-ui/require-nested-form-prop'),
+    },
+    schema: [],
+    messages: {
+      requireNested: 'Add `nested` to this inner `<UForm>` so it attaches to the parent form instead of creating an independent nested form.',
+    },
+  },
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
+
+    return defineTemplateVisitor(context, {
+      VElement(node: VueAST.VElement) {
+        if (!matcher.is(node, 'Form') || !matcher.hasAncestor(node, 'Form'))
+          return
+
+        const nested = getAttributeValue(node, 'nested')
+        if (!nested.present
+          || (nested.known && getStaticBoolean(node, 'nested') !== true && nested.value !== 'nested')) {
+          context.report({ loc: node.startTag.loc, messageId: 'requireNested' })
+        }
+      },
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.test.ts
index f8ca893..af85848 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.test.ts
@@ -1,18 +1,16 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('require-overlay-title', () => {
   it('requires an accessible title', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('require-overlay-title', plugin.rules?.['require-overlay-title'] as never, {
+    tester.run('require-overlay-title', nuxtUiPlugin.rules['require-overlay-title'], {
       valid: [
-        { filename: 'component.vue', code: '<template><UModal title="Settings" /></template>' },
-        { filename: 'component.vue', code: '<template><UDrawer aria-label="Navigation" /></template>' },
-        { filename: 'component.vue', code: '<template><USlideover><template #title>Help</template></USlideover></template>' },
+        { code: '<template><UModal title="Settings" /></template>' },
+        { code: '<template><UDrawer aria-label="Navigation" /></template>' },
+        { code: '<template><USlideover><template #title>Help</template></USlideover></template>' },
       ],
-      invalid: [{ filename: 'component.vue', code: '<template><UModal /></template>', errors: [{ messageId: 'missingTitle' }] }],
+      invalid: [{ code: '<template><UModal /></template>', errors: [{ messageId: 'missingTitle' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts
index 1f2efd9..d38b0c0 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-overlay-title/index.ts
@@ -1,7 +1,8 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasNonEmptyAttribute, hasSlot } from '../utils.js'
+import { defineTemplateVisitor, hasNonEmptyAttribute, hasSlot } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 const OVERLAYS = new Set(['Modal', 'Drawer', 'Slideover'])
 
@@ -12,16 +13,16 @@ export const requireOverlayTitle: Rule = {
       description: 'Require an accessible title on Nuxt UI modal, drawer, and slideover components.',
       url: docsUrl('nuxt-ui/require-overlay-title'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       missingTitle: 'Add a `title`, `#title`, `aria-label`, or `aria-labelledby` to this Nuxt UI overlay.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
+      VElement(node: VueAST.VElement) {
         if (matcher.isOneOf(node, OVERLAYS)
           && !hasNonEmptyAttribute(node, 'title')
           && !hasNonEmptyAttribute(node, 'aria-label')
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.test.ts
index d0b1676..1186243 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.test.ts
@@ -1,14 +1,12 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('require-popover-content', () => {
   it('requires the content slot', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('require-popover-content', plugin.rules?.['require-popover-content'] as never, {
-      valid: [{ filename: 'component.vue', code: '<template><UPopover><UButton /><template #content>Details</template></UPopover></template>' }],
-      invalid: [{ filename: 'component.vue', code: '<template><UPopover :content="{ side: \'right\' }"><UButton /></UPopover></template>', errors: [{ messageId: 'missingContent' }] }],
+    tester.run('require-popover-content', nuxtUiPlugin.rules['require-popover-content'], {
+      valid: [{ code: '<template><UPopover><UButton /><template #content>Details</template></UPopover></template>' }],
+      invalid: [{ code: '<template><UPopover :content="{ side: \'right\' }"><UButton /></UPopover></template>', errors: [{ messageId: 'missingContent' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts
index 6e0920d..188c67b 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-popover-content/index.ts
@@ -1,7 +1,8 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasSlot } from '../utils.js'
+import { defineTemplateVisitor, hasSlot } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 export const requirePopoverContent: Rule = {
   meta: {
@@ -10,16 +11,16 @@ export const requirePopoverContent: Rule = {
       description: 'Require a content slot on Nuxt UI popovers.',
       url: docsUrl('nuxt-ui/require-popover-content'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       missingContent: 'Add a `#content` slot to `<UPopover>`; the `content` prop only configures positioning.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
+      VElement(node: VueAST.VElement) {
         if (matcher.is(node, 'Popover') && !hasSlot(node, 'content'))
           context.report({ loc: node.startTag.loc, messageId: 'missingContent' })
       },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.test.ts
index f19384f..6b84556 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.test.ts
@@ -1,17 +1,15 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('require-tooltip-content', () => {
   it('requires text or content slot', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('require-tooltip-content', plugin.rules?.['require-tooltip-content'] as never, {
+    tester.run('require-tooltip-content', nuxtUiPlugin.rules['require-tooltip-content'], {
       valid: [
-        { filename: 'component.vue', code: '<template><UTooltip text="Settings"><UButton /></UTooltip></template>' },
-        { filename: 'component.vue', code: '<template><UTooltip><template #content>Settings</template></UTooltip></template>' },
+        { code: '<template><UTooltip text="Settings"><UButton /></UTooltip></template>' },
+        { code: '<template><UTooltip><template #content>Settings</template></UTooltip></template>' },
       ],
-      invalid: [{ filename: 'component.vue', code: '<template><UTooltip><UButton /></UTooltip></template>', errors: [{ messageId: 'missingContent' }] }],
+      invalid: [{ code: '<template><UTooltip><UButton /></UTooltip></template>', errors: [{ messageId: 'missingContent' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts
index 699ff41..02d8629 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-tooltip-content/index.ts
@@ -1,7 +1,8 @@
-import type { Rule } from '@oxlint/plugins'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor, hasNonEmptyAttribute, hasSlot } from '../utils.js'
+import { defineTemplateVisitor, hasNonEmptyAttribute, hasSlot } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
 
 export const requireTooltipContent: Rule = {
   meta: {
@@ -10,16 +11,16 @@ export const requireTooltipContent: Rule = {
       description: 'Require content on Nuxt UI tooltips so they communicate a useful hint.',
       url: docsUrl('nuxt-ui/require-tooltip-content'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       missingContent: 'Add a non-empty `text` prop or `#content` slot to `<UTooltip>`.',
     },
   },
-  create(context: any) {
-    const matcher = createComponentMatcher(context)
+  create(context: Context): Visitor {
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
+      VElement(node: VueAST.VElement) {
         if (matcher.is(node, 'Tooltip') && !hasNonEmptyAttribute(node, 'text') && !hasSlot(node, 'content'))
           context.report({ loc: node.startTag.loc, messageId: 'missingContent' })
       },
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
index e1cbbb9..23f9506 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.md
@@ -24,7 +24,8 @@ modals/slideovers.
 </template>
 ```
 
-Files under `components`, `pages`, and `layouts` are ignored even if named `App.vue`.
+Only the project-root `app.vue` and Nuxt 4's `app/app.vue` are checked. Other files named
+`App.vue`, including Vue entry components and components inside workspace packages, are ignored.
 
 ## Further reading
 
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.test.ts
index 75bb582..c349d16 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.test.ts
@@ -1,17 +1,20 @@
-import { RuleTester } from 'eslint'
 import { describe, it } from 'vitest'
-import vueParser from 'vue-eslint-parser'
-import plugin from '../../../index.js'
+import { ruleTester as tester } from '../../../../tests/rule-tester.js'
+import { nuxtUiPlugin } from '../../../index.js'
 
 describe('require-u-app', () => {
   it('requires UApp only in the Nuxt application root', () => {
-    const tester = new RuleTester({ languageOptions: { ecmaVersion: 'latest', sourceType: 'module', parser: vueParser } })
-    tester.run('require-u-app', plugin.rules?.['require-u-app'] as never, {
+    tester.run('require-u-app', nuxtUiPlugin.rules['require-u-app'], {
       valid: [
-        { filename: '/project/app.vue', code: '<template><UApp><NuxtPage /></UApp></template>' },
-        { filename: '/project/components/App.vue', code: '<template><div /></template>' },
+        { filename: 'app.vue', code: '<template><UApp><NuxtPage /></UApp></template>' },
+        { filename: 'app/app.vue', code: '<template><UApp><NuxtLayout /></UApp></template>' },
+        { filename: 'App.vue', code: '<template><div /></template>' },
+        { filename: 'components/App.vue', code: '<template><div /></template>' },
+      ],
+      invalid: [
+        { filename: 'app.vue', code: '<template><NuxtPage /></template>', errors: [{ messageId: 'missingApp' }] },
+        { filename: 'app/app.vue', code: '<template><div><NuxtPage /></div></template>', errors: [{ messageId: 'missingApp' }] },
       ],
-      invalid: [{ filename: '/project/app.vue', code: '<template><NuxtPage /></template>', errors: [{ messageId: 'missingApp' }] }],
     })
   })
 })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts
index 7d5cd36..158b819 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-u-app/index.ts
@@ -1,23 +1,67 @@
-import type { Rule } from '@oxlint/plugins'
-import type { ComponentMatcher } from '../component-matcher.js'
+import type { Context, Rule, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import type { ComponentMatcher } from '../../../utils/component-matcher.js'
+import { isAbsolute, relative } from 'node:path'
+import { normalizeComponentKey } from '../../../utils/component-matcher.js'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { componentOptionsSchema, createComponentMatcher } from '../component-matcher.js'
-import { defineTemplateVisitor } from '../utils.js'
-
-function isNuxtAppFile(filename: string): boolean {
-  const normalized = filename.replaceAll('\\', '/').toLowerCase()
-  return (normalized === 'app.vue' || normalized.endsWith('/app.vue'))
-    && !normalized.includes('/components/')
-    && !normalized.includes('/pages/')
-    && !normalized.includes('/layouts/')
+import { defineTemplateVisitor } from '../../../utils/template.js'
+import { createNuxtUiMatcher } from '../components.js'
+
+const AUXILIARY_COMPONENTS = new Set(['nuxtloadingindicator', 'nuxtrouteannouncer'])
+
+function isNuxtAppFile(filename: string, cwd: string): boolean {
+  const projectPath = isAbsolute(filename) ? relative(cwd, filename) : filename
+  const normalized = projectPath.replaceAll('\\', '/')
+  return normalized === 'app.vue' || normalized === 'app/app.vue'
+}
+
+function descendants(node: VueAST.VElement): VueAST.VElement[] {
+  const result: VueAST.VElement[] = []
+  for (const child of node.children) {
+    if (child.type !== 'VElement')
+      continue
+    result.push(child, ...descendants(child))
+  }
+  return result
+}
+
+function hasUAppAncestor(node: VueAST.VElement, root: VueAST.VElement, matcher: ComponentMatcher): boolean {
+  let parent: VueAST.Node | null | undefined = node.parent
+  while (parent && parent !== root) {
+    if (parent.type === 'VElement' && matcher.is(parent, 'App'))
+      return true
+    parent = 'parent' in parent ? parent.parent : null
+  }
+  return false
+}
+
+function isDescendant(node: VueAST.VElement, ancestor: VueAST.VElement): boolean {
+  let parent: VueAST.Node | null | undefined = node.parent
+  while (parent) {
+    if (parent === ancestor)
+      return true
+    parent = 'parent' in parent ? parent.parent : null
+  }
+  return false
 }
 
-function containsUApp(node: any, matcher: ComponentMatcher): boolean {
-  if (matcher.is(node, 'App'))
-    return true
-  return (node.children ?? []).some(
-    (child: any) => child.type === 'VElement' && containsUApp(child, matcher),
-  )
+function wrapsApplication(root: VueAST.VElement, matcher: ComponentMatcher): boolean {
+  const elements = descendants(root)
+  const entries = elements.filter((element) => {
+    const name = normalizeComponentKey(matcher.rawName(element))
+    return name === 'nuxtpage' || name === 'nuxtlayout'
+  })
+
+  if (entries.length > 0)
+    return entries.every(entry => hasUAppAncestor(entry, root, matcher))
+
+  return elements.filter(element => matcher.is(element, 'App')).some(app => elements.every((element) => {
+    const name = normalizeComponentKey(matcher.rawName(element))
+    return element === app
+      || isDescendant(element, app)
+      || isDescendant(app, element)
+      || AUXILIARY_COMPONENTS.has(name)
+  }))
 }
 
 export const requireUApp: Rule = {
@@ -27,21 +71,20 @@ export const requireUApp: Rule = {
       description: 'Require the Nuxt UI App provider in the Nuxt application root.',
       url: docsUrl('nuxt-ui/require-u-app'),
     },
-    schema: componentOptionsSchema(),
+    schema: [],
     messages: {
       missingApp: 'Wrap the application in `<UApp>` to provide Nuxt UI configuration, toasts, tooltips, and programmatic overlays.',
     },
   },
-  create(context: any) {
-    const filename = context.filename ?? context.getFilename()
-    if (!isNuxtAppFile(filename))
+  create(context: Context): Visitor {
+    if (!isNuxtAppFile(context.filename, context.cwd))
       return {}
 
-    const matcher = createComponentMatcher(context)
+    const matcher = createNuxtUiMatcher(context)
 
     return defineTemplateVisitor(context, {
-      VElement(node: any) {
-        if (node.parent?.type === 'VDocumentFragment' && !containsUApp(node, matcher))
+      VElement(node: VueAST.VElement) {
+        if (node.parent?.type === 'VDocumentFragment' && !wrapsApplication(node, matcher))
           context.report({ loc: node.startTag.loc, messageId: 'missingApp' })
       },
     })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
deleted file mode 100644
index fee26a9..0000000
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/utils.ts
+++ /dev/null
@@ -1,85 +0,0 @@
-// `node.name` is only a safe comparison for native HTML tags; components go through
-// `createComponentMatcher`, which handles kebab-case, prefixes and import aliases.
-export function defineTemplateVisitor(context: any, visitor: Record<string, (node: any) => void>) {
-  const services = context.sourceCode.parserServices
-  if (typeof services?.defineTemplateBodyVisitor !== 'function')
-    return {}
-
-  return services.defineTemplateBodyVisitor(visitor)
-}
-
-export function hasRawOptOut(node: any): boolean {
-  return node.startTag.attributes.some(
-    (attribute: any) => !attribute.directive && attribute.key.name === 'data-raw',
-  )
-}
-
-/** Returns an attribute, including `:name`/`v-bind:name`, by its normalized name. */
-export function getAttribute(node: any, name: string): any | null {
-  return node.startTag.attributes.find((attribute: any) => {
-    if (!attribute.directive)
-      return attribute.key.name === name
-    if (attribute.key.name?.name !== 'bind')
-      return false
-    const argument = attribute.key.argument
-    return argument?.type === 'VIdentifier' && argument.name === name
-  }) ?? null
-}
-
-export function hasAttribute(node: any, name: string): boolean {
-  return !!getAttribute(node, name)
-}
-
-/** Accepts dynamic bindings and non-empty static string attributes. */
-export function hasNonEmptyAttribute(node: any, name: string): boolean {
-  const attribute = getAttribute(node, name)
-  if (!attribute)
-    return false
-  if (attribute.directive)
-    return true
-  return typeof attribute.value?.value === 'string' && attribute.value.value.trim().length > 0
-}
-
-export function getStaticAttribute(node: any, name: string): string | null {
-  const attribute = node.startTag.attributes.find(
-    (candidate: any) => !candidate.directive && candidate.key.name === name && candidate.value,
-  )
-  return attribute?.value?.value ?? null
-}
-
-export function hasSlot(node: any, name: string): boolean {
-  return (node.children ?? []).some((child: any) => {
-    if (child.type !== 'VElement')
-      return false
-    return child.startTag.attributes.some((attribute: any) => {
-      if (!attribute.directive || attribute.key.name?.name !== 'slot')
-        return false
-      const argument = attribute.key.argument
-      return argument?.type === 'VIdentifier' && argument.name === name
-    })
-  })
-}
-
-/**
- * Whether the default slot can produce an accessible name. Interpolations and child elements
- * both count: their content is unknowable here, and for a rule that errors a missed
- * `<span>Save</span>` is far worse than staying quiet on a wrapped icon.
- */
-export function hasLabelContent(node: any): boolean {
-  return (node.children ?? []).some((child: any) => {
-    if (child.type === 'VText')
-      return child.value.trim().length > 0
-    return child.type === 'VExpressionContainer' || child.type === 'VElement'
-  })
-}
-
-export function hasVModel(node: any, argumentName: string | null): boolean {
-  return node.startTag.attributes.some((attribute: any) => {
-    if (!attribute.directive || attribute.key.name?.name !== 'model')
-      return false
-    const argument = attribute.key.argument
-    if (argumentName === null)
-      return !argument
-    return argument?.type === 'VIdentifier' && argument.name === argumentName
-  })
-}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/utils/component-matcher.ts b/packages/lint-plugin-nuxt-ecosystem/src/utils/component-matcher.ts
new file mode 100644
index 0000000..37cb569
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/utils/component-matcher.ts
@@ -0,0 +1,231 @@
+import type { Context, ESTree } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+
+const LAZY_PREFIX = 'lazy'
+
+export function normalizeComponentKey(name: string): string {
+  return name.replaceAll('-', '').toLowerCase()
+}
+
+export function isComponentName(name: string): boolean {
+  return /[A-Z-]/.test(name)
+}
+
+export function isComponentElement(node: VueAST.VElement): boolean {
+  return isComponentName(elementName(node))
+}
+
+// The parser lowercases `<Table>` to `table`, while SVG also has tags such as `<a>`.
+export function isNativeHtmlElement(node: VueAST.VElement): boolean {
+  const HTML_NAMESPACE = 'http://www.w3.org/1999/xhtml'
+
+  return node.namespace === HTML_NAMESPACE && !isComponentElement(node)
+}
+
+export function isNativeElement(node: VueAST.VElement, tag: string): boolean {
+  return node.name === tag && isNativeHtmlElement(node)
+}
+
+export interface ComponentSource {
+  module: RegExp
+  prefix: string
+}
+
+export interface ComponentMatcher {
+  is: (node: VueAST.VElement, name: string) => boolean
+  matchOf: (node: VueAST.VElement, names: Iterable<string>) => string | null
+  isOneOf: (node: VueAST.VElement, names: Iterable<string>) => boolean
+  hasAncestor: (node: VueAST.VElement, name: string) => boolean
+  keyOf: (node: VueAST.VElement) => string | null
+  keyOfName: (name: string) => string | null
+  prefixed: (name: string) => string
+  rawName: (node: VueAST.VElement) => string
+}
+
+function elementName(node: VueAST.VElement): string {
+  return node.rawName ?? node.name
+}
+
+function isTypeOnly(node: object): boolean {
+  return (node as { importKind?: string }).importKind === 'type'
+}
+
+function dynamicIsName(node: VueAST.VElement): string | null {
+  const attribute = node.startTag.attributes.find((candidate) => {
+    if (!candidate.directive)
+      return candidate.key.name === 'is'
+    if (candidate.key.name.name !== 'bind')
+      return false
+    return candidate.key.argument?.type === 'VIdentifier' && candidate.key.argument.name === 'is'
+  })
+  if (!attribute)
+    return null
+  if (!attribute.directive)
+    return attribute.value?.value ?? null
+
+  const expression = attribute.value?.expression
+  if (expression?.type === 'Identifier')
+    return expression.name
+  if (expression?.type === 'Literal' && typeof expression.value === 'string')
+    return expression.value
+  if (expression?.type === 'TemplateLiteral' && expression.expressions.length === 0)
+    return expression.quasis[0]?.value.cooked ?? expression.quasis[0]?.value.raw ?? null
+  return null
+}
+
+export function elementAncestor(node: VueAST.VElement): VueAST.VElement | null {
+  let current: VueAST.Node | null | undefined = node.parent
+  while (current) {
+    if (current.type === 'VElement')
+      return current
+    current = 'parent' in current ? current.parent : null
+  }
+  return null
+}
+
+function patternNames(pattern: ESTree.BindingPattern | ESTree.BindingRestElement): string[] {
+  switch (pattern.type) {
+    case 'Identifier':
+      return [normalizeComponentKey(pattern.name)]
+    case 'ObjectPattern':
+      return pattern.properties.flatMap(property => property.type === 'Property'
+        ? patternNames(property.value as ESTree.BindingPattern)
+        : patternNames(property.argument))
+    case 'ArrayPattern':
+      return pattern.elements.flatMap(element => element ? patternNames(element as ESTree.BindingPattern) : [])
+    case 'AssignmentPattern':
+      return patternNames(pattern.left)
+    case 'RestElement':
+      return patternNames(pattern.argument)
+    default:
+      return []
+  }
+}
+
+function declaredNames(statement: ESTree.Statement): string[] {
+  if (statement.type === 'VariableDeclaration')
+    return statement.declarations.flatMap(declarator => patternNames(declarator.id))
+  if ((statement.type === 'FunctionDeclaration' || statement.type === 'ClassDeclaration') && statement.id)
+    return [normalizeComponentKey(statement.id.name)]
+  return []
+}
+
+export function createComponentMatcher(context: Context, source: ComponentSource): ComponentMatcher {
+  const { module: moduleId, prefix } = source
+  const prefixKey = normalizeComponentKey(prefix)
+
+  function stripPrefixes(name: string): string | null {
+    let key = normalizeComponentKey(name)
+    if (key.startsWith(LAZY_PREFIX))
+      key = key.slice(LAZY_PREFIX.length)
+    if (!key.startsWith(prefixKey))
+      return null
+    const stripped = key.slice(prefixKey.length)
+    return stripped.length > 0 ? stripped : null
+  }
+
+  // `null` marks local shadowing by a component outside the module.
+  const bindings = new Map<string, string | null>()
+  const namespaces = new Set<string>()
+  const body = context.sourceCode?.ast?.body ?? []
+
+  for (const statement of body) {
+    if (statement.type !== 'ImportDeclaration' || isTypeOnly(statement))
+      continue
+
+    const specifier = typeof statement.source.value === 'string' ? statement.source.value : ''
+    const fromModule = moduleId.test(specifier)
+
+    for (const imported of statement.specifiers) {
+      if (isTypeOnly(imported))
+        continue
+
+      if (imported.type === 'ImportSpecifier') {
+        const name = imported.imported.type === 'Identifier'
+          ? imported.imported.name
+          : imported.imported.value
+        bindings.set(
+          normalizeComponentKey(imported.local.name),
+          fromModule ? stripPrefixes(name) : null,
+        )
+        continue
+      }
+
+      if (imported.type === 'ImportDefaultSpecifier') {
+        const file = fromModule ? specifier.split('/').pop()?.replace(/\.vue$/, '') : undefined
+        bindings.set(normalizeComponentKey(imported.local.name), file ? normalizeComponentKey(file) : null)
+        continue
+      }
+
+      if (imported.type === 'ImportNamespaceSpecifier' && fromModule)
+        namespaces.add(normalizeComponentKey(imported.local.name))
+    }
+  }
+
+  for (const statement of body) {
+    for (const key of declaredNames(statement)) {
+      if (!bindings.has(key))
+        bindings.set(key, null)
+    }
+  }
+
+  function effectiveName(node: VueAST.VElement): string | null {
+    const raw = elementName(node)
+    return normalizeComponentKey(raw) === 'component' ? dynamicIsName(node) : raw
+  }
+
+  function keyOf(node: VueAST.VElement): string | null {
+    const name = effectiveName(node)
+    if (name === null)
+      return null
+    const bound = bindings.get(normalizeComponentKey(name))
+    if (bound !== undefined)
+      return bound
+    const dot = name.indexOf('.')
+    if (dot > 0 && namespaces.has(normalizeComponentKey(name.slice(0, dot))))
+      return stripPrefixes(name.slice(dot + 1))
+    // Without this guard, an empty prefix would match native tags.
+    if (!isComponentName(name))
+      return null
+    return stripPrefixes(name)
+  }
+
+  function namesKey(name: string, key: string): boolean {
+    return normalizeComponentKey(name) === key || stripPrefixes(name) === key
+  }
+
+  function matchOf(node: VueAST.VElement, names: Iterable<string>): string | null {
+    const key = keyOf(node)
+    if (key === null)
+      return null
+    for (const name of names) {
+      if (namesKey(name, key))
+        return name
+    }
+    return null
+  }
+
+  function is(node: VueAST.VElement, name: string): boolean {
+    const key = keyOf(node)
+    return key !== null && namesKey(name, key)
+  }
+
+  return {
+    is,
+    matchOf,
+    isOneOf: (node, names) => matchOf(node, names) !== null,
+    hasAncestor: (node, name) => {
+      let parent = elementAncestor(node)
+      while (parent) {
+        if (is(parent, name))
+          return true
+        parent = elementAncestor(parent)
+      }
+      return false
+    },
+    keyOf,
+    keyOfName: stripPrefixes,
+    prefixed: name => `${prefix}${name}`,
+    rawName: elementName,
+  }
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/utils/docs-url.ts b/packages/lint-plugin-nuxt-ecosystem/src/utils/docs-url.ts
index 91f457b..661a527 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/utils/docs-url.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/utils/docs-url.ts
@@ -1,6 +1,5 @@
 const RULES_BASE = 'https://github.com/Zerya-Dev/nustack/blob/master/packages/lint-plugin-nuxt-ecosystem/src/rules'
 
-/** Builds the GitHub URL for a rule's `index.md`, keyed by its path under `src/rules`. */
 export function docsUrl(rulePath: string): string {
   return `${RULES_BASE}/${rulePath}/index.md`
 }
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/utils/template.ts b/packages/lint-plugin-nuxt-ecosystem/src/utils/template.ts
new file mode 100644
index 0000000..450e4fe
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/src/utils/template.ts
@@ -0,0 +1,280 @@
+import type { Context, Visitor } from '@oxlint/plugins'
+import type { AST as VueAST } from 'vue-eslint-parser'
+import { isComponentElement } from './component-matcher.js'
+
+type ExpressionNode
+  = | NonNullable<VueAST.VExpressionContainer['expression']>
+    | VueAST.ESLintPattern
+    | VueAST.ESLintSpreadElement
+
+interface TemplateVisitor {
+  'VElement'?: (node: VueAST.VElement) => void
+  'VElement:exit'?: (node: VueAST.VElement) => void
+  'VText'?: (node: VueAST.VText) => void
+  'VExpressionContainer'?: (node: VueAST.VExpressionContainer) => void
+  'VDocumentFragment'?: (node: VueAST.VDocumentFragment) => void
+  [selector: string]: ((node: never) => void) | undefined
+}
+
+export function defineTemplateVisitor(context: Context, visitor: TemplateVisitor): Visitor {
+  const services = context.sourceCode.parserServices as {
+    defineTemplateBodyVisitor?: (templateVisitor: TemplateVisitor) => unknown
+  }
+  if (typeof services?.defineTemplateBodyVisitor !== 'function')
+    return {}
+
+  return services.defineTemplateBodyVisitor(visitor) as Visitor
+}
+
+export function documentRoot(node: VueAST.Node | null | undefined): VueAST.Node | null {
+  let root: VueAST.Node | null | undefined = node
+  while (root && 'parent' in root && root.parent)
+    root = root.parent
+  return root ?? null
+}
+
+export interface AttributeValue {
+  present: boolean
+  definite: boolean
+  known: boolean
+  value: unknown
+  expression?: ExpressionNode
+}
+
+const ABSENT_ATTRIBUTE: AttributeValue = { present: false, definite: false, known: true, value: undefined }
+const UNKNOWN_ATTRIBUTE: AttributeValue = { present: true, definite: true, known: false, value: undefined }
+const UNKNOWN_SPREAD: AttributeValue = { present: true, definite: false, known: false, value: undefined }
+
+function staticValue(value: unknown, expression: ExpressionNode): AttributeValue {
+  return { present: true, definite: value !== undefined && value !== null, known: true, value, expression }
+}
+
+function propertyName(property: VueAST.ESLintProperty): string | null {
+  if (property.computed) {
+    return property.key.type === 'Literal' && typeof property.key.value === 'string'
+      ? property.key.value
+      : null
+  }
+  if (property.key.type === 'Identifier')
+    return property.key.name
+  return property.key.type === 'Literal' ? String(property.key.value) : null
+}
+
+export function normalizePropName(name: string): string {
+  return name.replaceAll('-', '').toLowerCase()
+}
+
+function staticExpression(expression: ExpressionNode | null | undefined): AttributeValue {
+  if (!expression)
+    return UNKNOWN_ATTRIBUTE
+  if (expression.type === 'Literal')
+    return staticValue(expression.value, expression)
+  if (expression.type === 'Identifier' && expression.name === 'undefined')
+    return staticValue(undefined, expression)
+  if (expression.type === 'TemplateLiteral' && expression.expressions.length === 0) {
+    const quasi = expression.quasis[0]?.value
+    return staticValue(quasi?.cooked ?? quasi?.raw ?? '', expression)
+  }
+  if (expression.type === 'ArrayExpression') {
+    const values = []
+    for (const element of expression.elements) {
+      const value = staticExpression(element)
+      if (!value.known)
+        return UNKNOWN_ATTRIBUTE
+      values.push(value.value)
+    }
+    return { present: true, definite: true, known: true, value: values, expression }
+  }
+  return { ...UNKNOWN_ATTRIBUTE, expression }
+}
+
+function objectPropertyValue(expression: ExpressionNode | null | undefined, name: string): AttributeValue {
+  if (expression?.type !== 'ObjectExpression')
+    return UNKNOWN_SPREAD
+
+  for (let index = expression.properties.length - 1; index >= 0; index--) {
+    const property = expression.properties[index]
+    if (property?.type === 'SpreadElement') {
+      const spread = objectPropertyValue(property.argument, name)
+      if (spread.present)
+        return spread
+      continue
+    }
+    if (property?.type !== 'Property')
+      continue
+    const key = propertyName(property)
+    if (key === null)
+      return UNKNOWN_SPREAD
+    if (normalizePropName(key) !== normalizePropName(name))
+      continue
+    return staticExpression(property.value)
+  }
+
+  return ABSENT_ATTRIBUTE
+}
+
+export function getAttributeValue(node: VueAST.VElement, name: string): AttributeValue {
+  for (let index = node.startTag.attributes.length - 1; index >= 0; index--) {
+    const attribute = node.startTag.attributes[index]
+    if (!attribute)
+      continue
+    if (!attribute.directive) {
+      if (normalizePropName(attribute.key.name) !== normalizePropName(name))
+        continue
+      return {
+        present: true,
+        definite: true,
+        known: true,
+        value: attribute.value ? attribute.value.value : true,
+      }
+    }
+    if (attribute.key.name.name !== 'bind')
+      continue
+
+    const argument = attribute.key.argument
+    if (argument?.type === 'VIdentifier' && normalizePropName(argument.name) === normalizePropName(name))
+      return staticExpression(attribute.value?.expression)
+    if (!argument) {
+      const candidate = objectPropertyValue(attribute.value?.expression, name)
+      if (candidate.present)
+        return candidate
+    }
+  }
+
+  return ABSENT_ATTRIBUTE
+}
+
+export function hasAttribute(node: VueAST.VElement, name: string): boolean {
+  return getAttributeValue(node, name).present
+}
+
+export function hasDefiniteAttribute(node: VueAST.VElement, name: string): boolean {
+  return getAttributeValue(node, name).definite
+}
+
+export function hasNonEmptyAttribute(node: VueAST.VElement, name: string): boolean {
+  const attribute = getAttributeValue(node, name)
+  if (!attribute.present)
+    return false
+  if (!attribute.known)
+    return true
+  if (typeof attribute.value === 'string')
+    return attribute.value.trim().length > 0
+  if (Array.isArray(attribute.value))
+    return attribute.value.length > 0
+  return typeof attribute.value === 'number'
+}
+
+export function getStaticAttribute(node: VueAST.VElement, name: string): string | null {
+  const attribute = getAttributeValue(node, name)
+  return attribute.present && attribute.known && typeof attribute.value === 'string'
+    ? attribute.value
+    : null
+}
+
+export function getStaticBoolean(node: VueAST.VElement, name: string): boolean | null {
+  const attribute = getAttributeValue(node, name)
+  if (!attribute.present || !attribute.known)
+    return null
+  if (typeof attribute.value === 'boolean')
+    return attribute.value
+  if (attribute.value === '' || attribute.value === 'true')
+    return true
+  if (attribute.value === 'false')
+    return false
+  return null
+}
+
+function hasMeaningfulChildren(node: VueAST.VElement, isDecorative: (node: VueAST.VElement) => boolean): boolean {
+  return node.children.some((child) => {
+    if (child.type === 'VText')
+      return child.value.trim().length > 0
+    if (child.type === 'VExpressionContainer')
+      return expressionHasContent(child.expression)
+    if (isDecorative(child) || isStaticallyHidden(child))
+      return false
+    if (hasNonEmptyAttribute(child, 'alt'))
+      return true
+    return isComponentElement(child)
+      ? componentProvidesContent(child, isDecorative)
+      : hasMeaningfulChildren(child, isDecorative)
+  })
+}
+
+function isStaticallyHidden(node: VueAST.VElement): boolean {
+  if (getStaticBoolean(node, 'aria-hidden') === true)
+    return true
+  if (getStaticBoolean(node, 'hidden') === true)
+    return true
+  return node.startTag.attributes.some((attribute) => {
+    if (!attribute.directive)
+      return false
+    const directive = attribute.key.name.name
+    if (directive !== 'if' && directive !== 'show')
+      return false
+    const condition = staticExpression(attribute.value?.expression)
+    return condition.known && !condition.value
+  })
+}
+
+const TRANSPARENT_BUILT_INS = new Set(['component', 'keepalive', 'suspense', 'teleport', 'transition', 'transitiongroup'])
+
+function componentProvidesContent(node: VueAST.VElement, isDecorative: (node: VueAST.VElement) => boolean): boolean {
+  const key = (node.rawName ?? node.name).replaceAll('-', '').toLowerCase()
+  return !TRANSPARENT_BUILT_INS.has(key) || hasMeaningfulChildren(node, isDecorative)
+}
+
+function expressionHasContent(expression: ExpressionNode | null): boolean {
+  const value = staticExpression(expression)
+  return value.known ? hasNonEmptyStaticValue(value.value) : true
+}
+
+function hasNonEmptyStaticValue(value: unknown): boolean {
+  if (typeof value === 'string')
+    return value.trim().length > 0
+  return typeof value === 'number'
+}
+
+function slotName(attribute: VueAST.VDirective): string | null | undefined {
+  const argument = attribute.key.argument
+  if (!argument)
+    return undefined
+  if (argument.type === 'VIdentifier')
+    return argument.name
+  const value = staticExpression(argument.expression)
+  return value.known && typeof value.value === 'string' ? value.value : null
+}
+
+function isSlotFor(attribute: VueAST.VAttribute | VueAST.VDirective, name: string): boolean {
+  if (!attribute.directive || attribute.key.name.name !== 'slot')
+    return false
+  const resolved = slotName(attribute)
+  return resolved === null || resolved === name
+}
+
+export function hasSlot(node: VueAST.VElement, name: string, isDecorative: (node: VueAST.VElement) => boolean = () => false): boolean {
+  return node.children.some(child => child.type === 'VElement'
+    && !isStaticallyHidden(child)
+    && child.startTag.attributes.some(attribute => isSlotFor(attribute, name))
+    && hasMeaningfulChildren(child, isDecorative))
+}
+
+export function hasLabelContent(node: VueAST.VElement, isDecorative: (node: VueAST.VElement) => boolean = () => false): boolean {
+  return hasMeaningfulChildren(node, isDecorative)
+}
+
+export function hasVModel(node: VueAST.VElement, argumentName: string | null): boolean {
+  return node.startTag.attributes.some((attribute) => {
+    if (!attribute.directive || attribute.key.name.name !== 'model')
+      return false
+    const argument = attribute.key.argument
+    if (argumentName === null)
+      return !argument
+    if (argument?.type === 'VIdentifier')
+      return argument.name === argumentName
+    if (argument?.type !== 'VExpressionContainer')
+      return false
+    const value = staticExpression(argument.expression)
+    return value.known && value.value === argumentName
+  })
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/tests/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/tests/index.test.ts
new file mode 100644
index 0000000..c9a72d5
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/tests/index.test.ts
@@ -0,0 +1,188 @@
+import type { ESLint } from 'eslint'
+import { existsSync, readFileSync } from 'node:fs'
+import { describe, expect, it } from 'vitest'
+import {
+  NUXT_IMAGE_PRESET_RULES,
+  NUXT_UI_PRESET_RULES,
+  nuxtEcosystemConfigs,
+  nuxtEcosystemPlugins,
+  nuxtImageConfig,
+  nuxtImagePlugin,
+  nuxtImageRules,
+  nuxtUiConfig,
+  nuxtUiPlugin,
+  nuxtUiRules,
+} from '../src/index.js'
+
+type PresetRules = Record<string, 'error' | 'warn'>
+
+interface ModuleUnderTest {
+  directory: string
+  namespace: string
+  plugin: ESLint.Plugin & { rules: NonNullable<ESLint.Plugin['rules']> }
+  presets: { minimal: PresetRules, recommended: PresetRules }
+  rules: (options?: { preset?: 'minimal' | 'recommended' | false, rules?: Record<string, any> }) => Record<string, any>
+  config: (options?: any) => Record<string, any>
+  fixable: string[]
+}
+
+const MODULES: ModuleUnderTest[] = [
+  {
+    directory: 'nuxt-ui',
+    namespace: '@nustack/nuxt-ui',
+    plugin: nuxtUiPlugin,
+    presets: NUXT_UI_PRESET_RULES,
+    rules: nuxtUiRules,
+    config: nuxtUiConfig,
+    fixable: ['no-deprecated-components', 'no-deprecated-model-modifiers'],
+  },
+  {
+    directory: 'nuxt-image',
+    namespace: '@nustack/nuxt-image',
+    plugin: nuxtImagePlugin,
+    presets: NUXT_IMAGE_PRESET_RULES,
+    rules: nuxtImageRules,
+    config: nuxtImageConfig,
+    fixable: [],
+  },
+]
+
+describe.each(MODULES)('$namespace', (module) => {
+  const ruleNames = Object.keys(module.plugin.rules)
+
+  it('puts every registered rule in `recommended`', () => {
+    const recommended = Object.keys(module.presets.recommended)
+    expect(recommended.toSorted()).toEqual(ruleNames.toSorted())
+    expect(new Set(recommended).size).toBe(recommended.length)
+  })
+
+  it('keeps `minimal` a strict subset of `recommended`, errors only', () => {
+    for (const [name, level] of Object.entries(module.presets.minimal)) {
+      expect(level, name).toBe('error')
+      expect(module.presets.recommended[name], name).toBe('error')
+    }
+    const extra = ruleNames.filter(name => !(name in module.presets.minimal))
+    for (const name of extra)
+      expect(module.rules()[`${module.namespace}/${name}`], name).toBe('warn')
+  })
+
+  it('documents every registered rule', () => {
+    const readme = readFileSync(new URL('../README.md', import.meta.url), 'utf8')
+    for (const name of ruleNames) {
+      expect(existsSync(new URL(`../src/rules/${module.directory}/${name}/index.md`, import.meta.url)), name).toBe(true)
+      expect(readme, name).toContain(`[\`${name}\`]`)
+    }
+  })
+
+  it('gives every rule a description, a docs URL and messages', () => {
+    for (const [name, rule] of Object.entries(module.plugin.rules)) {
+      expect(rule.meta?.docs?.description, name).toBeTruthy()
+      expect(rule.meta?.docs?.url, name).toContain(`${module.directory}/${name}`)
+      expect(Object.keys(rule.meta?.messages ?? {}).length, name).toBeGreaterThan(0)
+    }
+  })
+
+  it('does not expose a per-rule prefix option', () => {
+    for (const [name, rule] of Object.entries(module.plugin.rules)) {
+      const schema = rule.meta?.schema
+      const first = Array.isArray(schema) ? schema[0] as { properties?: Record<string, unknown> } | undefined : undefined
+      expect('prefix' in (first?.properties ?? {}), name).toBe(false)
+    }
+  })
+
+  it('marks the fixable rules as such and no others', () => {
+    const fixable = ruleNames.filter(name => module.plugin.rules[name]?.meta?.fixable !== undefined)
+    expect(fixable.toSorted()).toEqual(module.fixable.toSorted())
+  })
+
+  it('defaults to `recommended` and honours `preset: false`', () => {
+    expect(module.rules()).toEqual(module.rules({ preset: 'recommended' }))
+    for (const name of Object.keys(module.presets.minimal))
+      expect(module.rules({ preset: 'minimal' })[`${module.namespace}/${name}`], name).toBe('error')
+    expect(module.rules({ preset: false })).toEqual({})
+  })
+
+  it('scopes the rules to SFCs and declares no parser', () => {
+    const config = module.config({ preset: 'minimal' })
+    expect(config.files).toEqual(['**/*.vue'])
+    expect(config.plugins).toHaveProperty(module.namespace)
+    expect(config.rules).toEqual(module.rules({ preset: 'minimal' }))
+    expect(config.languageOptions).toBeUndefined()
+  })
+})
+
+describe('nuxt UI presets', () => {
+  it('keeps `minimal` free of the preferences', () => {
+    const extra = Object.keys(nuxtUiPlugin.rules).filter(name => !(name in NUXT_UI_PRESET_RULES.minimal))
+    expect(extra.every(name => name.startsWith('prefer-')), extra.join(', ')).toBe(true)
+  })
+})
+
+describe('nuxtUiRules', () => {
+  it('merges explicitly listed rules without changing their options', () => {
+    const rules = nuxtUiRules({
+      preset: false,
+      rules: {
+        '@nustack/nuxt-ui/require-avatar-alt': 'error',
+        '@nustack/nuxt-ui/require-form-control-label': ['warn'],
+        '@nustack/nuxt-ui/prefer-u-form-controls': ['warn', { controls: {} }],
+        'vue/no-unused-vars': 'error',
+      },
+    })
+
+    expect(rules['@nustack/nuxt-ui/require-avatar-alt']).toBe('error')
+    expect(rules['@nustack/nuxt-ui/require-form-control-label']).toEqual(['warn'])
+    expect(rules['@nustack/nuxt-ui/prefer-u-form-controls']).toEqual(['warn', { controls: {} }])
+    expect(rules['vue/no-unused-vars']).toBe('error')
+  })
+
+  it('lets an override win over the preset entry for the same rule', () => {
+    const rules = nuxtUiRules({ rules: { '@nustack/nuxt-ui/require-u-app': 'off' } })
+    expect(rules['@nustack/nuxt-ui/require-u-app']).toBe('off')
+  })
+
+  it('leaves unknown rule ids alone', () => {
+    const listed = { '@nustack/nuxt-ui/require-avatar-alt': 'error' } as const
+    expect(nuxtUiRules({ preset: false, rules: listed })).toEqual(listed)
+  })
+})
+
+describe('config settings', () => {
+  it('enables Nuxt UI with its config-level prefix', () => {
+    expect(nuxtUiConfig({ prefix: 'Nu' }).settings).toEqual({
+      '@nustack/nuxt-ui': { enabled: true, prefix: 'Nu' },
+    })
+  })
+
+  it('keeps standalone Image independent unless Nuxt UI is explicit', () => {
+    expect(nuxtImageConfig().settings).toBeUndefined()
+    expect(nuxtImageConfig({ nuxtUi: {} }).settings).toEqual({
+      '@nustack/nuxt-ui': { enabled: true, prefix: 'U' },
+    })
+    expect(nuxtImageConfig({ nuxtUi: { prefix: 'Nu' } }).settings).toEqual({
+      '@nustack/nuxt-ui': { enabled: true, prefix: 'Nu' },
+    })
+  })
+})
+
+describe('nuxtEcosystemConfigs', () => {
+  it('only returns configs for explicitly enabled modules', () => {
+    expect(nuxtEcosystemConfigs({})).toEqual([])
+    expect(nuxtEcosystemConfigs({ nuxtUi: true }).map(config => config.name)).toEqual(['nustack/nuxt-ui'])
+    expect(nuxtEcosystemConfigs({ nuxtUi: true, nuxtImage: true }).map(config => config.name)).toEqual(['nustack/nuxt-ui', 'nustack/nuxt-image'])
+    expect(nuxtEcosystemConfigs({ nuxtUi: false, nuxtImage: false })).toEqual([])
+  })
+
+  it('does not silently disable every module when called without options from JavaScript', () => {
+    expect(() => (nuxtEcosystemConfigs as any)()).toThrow('requires an object listing the modules to enable')
+  })
+
+  it('passes each module its own options', () => {
+    const [nuxtImage] = nuxtEcosystemConfigs({ nuxtImage: { preset: 'minimal' } })
+    expect(Object.keys(nuxtImage?.rules ?? {})).toEqual(Object.keys(nuxtImageRules({ preset: 'minimal' })))
+  })
+
+  it('exposes every namespace through `nuxtEcosystemPlugins`', () => {
+    expect(Object.keys(nuxtEcosystemPlugins).toSorted()).toEqual(['@nustack/nuxt-image', '@nustack/nuxt-ui'])
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/tests/parse.ts b/packages/lint-plugin-nuxt-ecosystem/tests/parse.ts
new file mode 100644
index 0000000..231e86c
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/tests/parse.ts
@@ -0,0 +1,20 @@
+import type { AST as VueAST } from 'vue-eslint-parser'
+import { parseForESLint } from 'vue-eslint-parser'
+
+export function elements(template: string): VueAST.VElement[] {
+  const { ast } = parseForESLint(`<template>${template}</template>`, {
+    sourceType: 'module',
+    ecmaVersion: 'latest',
+  })
+  const body = ast.templateBody
+  if (!body)
+    throw new Error('template did not parse')
+  return body.children.filter((child): child is VueAST.VElement => child.type === 'VElement')
+}
+
+export function element(template: string): VueAST.VElement {
+  const [first] = elements(template)
+  if (!first)
+    throw new Error('template contains no element')
+  return first
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/tests/rule-tester.ts b/packages/lint-plugin-nuxt-ecosystem/tests/rule-tester.ts
new file mode 100644
index 0000000..2c7651a
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/tests/rule-tester.ts
@@ -0,0 +1,30 @@
+import type { Rule as OxlintRule } from '@oxlint/plugins'
+import type { ESLint } from 'eslint'
+import tsParser from '@typescript-eslint/parser'
+import { RuleTester } from 'eslint'
+import vueParser from 'vue-eslint-parser'
+
+type ESLintRule = NonNullable<NonNullable<ESLint.Plugin['rules']>[string]>
+type RuleTests = Parameters<RuleTester['run']>[2]
+
+const tester = new RuleTester({
+  languageOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+    parser: vueParser,
+    parserOptions: { parser: tsParser },
+  },
+})
+
+export const ruleTester = {
+  run(name: string, rule: ESLintRule | OxlintRule | undefined, tests: RuleTests, filename = 'component.vue') {
+    if (!rule)
+      throw new Error(`Rule "${name}" is not registered`)
+
+    tester.run(name, rule as Parameters<RuleTester['run']>[1], {
+      ...tests,
+      valid: tests.valid.map(test => typeof test === 'string' ? { code: test, filename } : { filename, ...test }),
+      invalid: tests.invalid.map(test => ({ filename, ...test })),
+    })
+  },
+}
diff --git a/packages/lint-plugin-nuxt-ecosystem/tests/rules/nuxt-ui/components.test.ts b/packages/lint-plugin-nuxt-ecosystem/tests/rules/nuxt-ui/components.test.ts
new file mode 100644
index 0000000..99286da
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/tests/rules/nuxt-ui/components.test.ts
@@ -0,0 +1,126 @@
+import { describe, it } from 'vitest'
+import { nuxtUiPlugin } from '../../../src/index.js'
+import { ruleTester as tester } from '../../rule-tester.js'
+
+const iconButton = nuxtUiPlugin.rules['require-icon-button-label']
+const settings = (prefix: string) => ({ '@nustack/nuxt-ui': { enabled: true, prefix } })
+function sfc(script: string, template: string) {
+  return `<script setup>\n${script}\n</script>\n<template>${template}</template>`
+}
+
+describe('component identification', () => {
+  it('matches every auto-import spelling of a component', () => {
+    tester.run('require-icon-button-label', iconButton, {
+      valid: [],
+      invalid: [
+        { code: '<template><UButton icon="i-lucide-x" /></template>', errors: 1 },
+        { code: '<template><u-button icon="i-lucide-x" /></template>', errors: 1 },
+        { code: '<template><LazyUButton icon="i-lucide-x" /></template>', errors: 1 },
+        { code: '<template><lazy-u-button icon="i-lucide-x" /></template>', errors: 1 },
+      ],
+    })
+  })
+
+  it('honours a configured ui.prefix', () => {
+    tester.run('require-icon-button-label', iconButton, {
+      valid: [
+        { code: '<template><UButton icon="i-lucide-x" /></template>', settings: settings('Nu') },
+      ],
+      invalid: [
+        { code: '<template><NuButton icon="i-lucide-x" /></template>', settings: settings('Nu'), errors: 1 },
+        { code: '<template><nu-button icon="i-lucide-x" /></template>', settings: settings('Nu'), errors: 1 },
+        { code: '<template><Button icon="i-lucide-x" /></template>', settings: settings(''), errors: 1 },
+      ],
+    })
+  })
+
+  it('follows named imports through an alias', () => {
+    tester.run('require-icon-button-label', iconButton, {
+      valid: [
+        { code: sfc('import { MyThing } from \'#components\'', '<MyThing icon="i-lucide-x" />') },
+      ],
+      invalid: [
+        { code: sfc('import { UButton as IconButton } from \'#components\'', '<IconButton icon="i-lucide-x" />'), errors: 1 },
+        { code: sfc('import { UButton as IconButton } from \'@nuxt/ui\'', '<IconButton icon="i-lucide-x" />'), errors: 1 },
+        { code: sfc('import Btn from \'@nuxt/ui/components/Button.vue\'', '<Btn icon="i-lucide-x" />'), errors: 1 },
+      ],
+    })
+  })
+
+  it('respects local shadowing of a Nuxt UI name', () => {
+    tester.run('require-icon-button-label', iconButton, {
+      valid: [
+        { code: sfc('import UButton from \'./MyButton.vue\'', '<UButton icon="i-lucide-x" />') },
+        { code: sfc('import { UButton } from \'~/components/ui\'', '<UButton icon="i-lucide-x" />') },
+      ],
+      invalid: [],
+    })
+  })
+
+  it('resolves <component :is> only when the target is static', () => {
+    tester.run('require-icon-button-label', iconButton, {
+      valid: [
+        { code: '<template><component :is="resolved" icon="i-lucide-x" /></template>' },
+        { code: '<template><component :is="map[key]" icon="i-lucide-x" /></template>' },
+      ],
+      invalid: [
+        { code: '<template><component is="UButton" icon="i-lucide-x" /></template>', errors: 1 },
+        { code: '<template><component :is="\'UButton\'" icon="i-lucide-x" /></template>', errors: 1 },
+        { code: sfc('import { UButton } from \'#components\'', '<component :is="UButton" icon="i-lucide-x" />'), errors: 1 },
+      ],
+    })
+  })
+
+  it('does not mistake native tags for components', () => {
+    tester.run('no-conflicting-state-props', nuxtUiPlugin.rules['no-conflicting-state-props'], {
+      valid: [
+        { code: '<template><ul default-value="a" model-value="b" /></template>' },
+        { code: '<template><use default-open open /></template>' },
+        { code: '<template><UserCard default-value="a" model-value="b" /></template>' },
+      ],
+      invalid: [
+        { code: '<template><u-modal default-open open /></template>', errors: 1 },
+      ],
+    })
+  })
+
+  it('reports multi-word components with their real casing', () => {
+    tester.run('require-form-control-label', nuxtUiPlugin.rules['require-form-control-label'], {
+      valid: [],
+      invalid: [
+        {
+          filename: 'c.vue',
+          code: '<template><UInputMenu :items="items" /></template>',
+          errors: [{ messageId: 'missingLabel', data: { component: 'UInputMenu' } }],
+        },
+        {
+          filename: 'c.vue',
+          code: '<template><u-checkbox-group :items="items" /></template>',
+          errors: [{ messageId: 'missingLabel', data: { component: 'UCheckboxGroup' } }],
+        },
+      ],
+    })
+  })
+
+  it('resolves renamed components across spellings', () => {
+    tester.run('no-deprecated-components', nuxtUiPlugin.rules['no-deprecated-components'], {
+      valid: [
+        { code: sfc('import UButtonGroup from \'./ButtonGroup.vue\'', '<UButtonGroup />') },
+      ],
+      invalid: [
+        {
+          filename: 'c.vue',
+          code: '<template><u-button-group /></template>',
+          output: '<template><u-field-group /></template>',
+          errors: [{ messageId: 'deprecated', data: { name: 'UButtonGroup', replacement: 'UFieldGroup' } }],
+        },
+        {
+          filename: 'c.vue',
+          code: '<template><LazyUPageMarquee /></template>',
+          output: '<template><LazyUMarquee /></template>',
+          errors: [{ messageId: 'deprecated', data: { name: 'UPageMarquee', replacement: 'UMarquee' } }],
+        },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/tests/rules/nuxt-ui/prefer-u-component.test.ts b/packages/lint-plugin-nuxt-ecosystem/tests/rules/nuxt-ui/prefer-u-component.test.ts
new file mode 100644
index 0000000..8a41ef1
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/tests/rules/nuxt-ui/prefer-u-component.test.ts
@@ -0,0 +1,54 @@
+import { describe, it } from 'vitest'
+import { nuxtUiPlugin } from '../../../src/index.js'
+import { ruleTester as tester } from '../../rule-tester.js'
+
+/** Every rule built from `preferUComponent`, so the per-rule files only carry what is specific. */
+const RULES = [
+  { name: 'prefer-u-button', tag: 'button', component: 'Button' },
+  { name: 'prefer-u-kbd', tag: 'kbd', component: 'Kbd' },
+  { name: 'prefer-u-link', tag: 'a', component: 'Link' },
+  { name: 'prefer-u-modal', tag: 'dialog', component: 'Modal' },
+  { name: 'prefer-u-progress', tag: 'progress', component: 'Progress' },
+  { name: 'prefer-u-separator', tag: 'hr', component: 'Separator' },
+  { name: 'prefer-u-table', tag: 'table', component: 'Table' },
+] as const
+
+const settings = (prefix: string) => ({ '@nustack/nuxt-ui': { enabled: true, prefix } })
+
+describe.each(RULES)('$name', ({ name, tag, component }) => {
+  const rule = nuxtUiPlugin.rules[name]
+  const messageId = `preferU${component}`
+
+  it('reports the native tag and nothing that only looks like it', () => {
+    tester.run(name, rule, {
+      valid: [
+        // The Nuxt UI component itself, and a component that merely shares the native name.
+        { code: `<template><U${component} /></template>` },
+        { code: `<template><${component} /></template>` },
+        // Outside the template the tag is just an identifier or a string.
+        { code: `<script setup>\nconst ${tag} = 1\nconst html = '<${tag}></${tag}>'\n</script>\n<template><div /></template>` },
+      ],
+      invalid: [
+        {
+          code: `<template><${tag} /></template>`,
+          errors: [{ messageId, data: { component: `U${component}`, tag } }],
+        },
+      ],
+    })
+  })
+
+  it('spells the replacement with the configured prefix', () => {
+    tester.run(name, rule, {
+      valid: [
+        { code: `<template><Nu${component} /></template>`, settings: settings('Nu') },
+      ],
+      invalid: [
+        {
+          code: `<template><${tag} /></template>`,
+          settings: settings('Nu'),
+          errors: [{ messageId, data: { component: `Nu${component}`, tag } }],
+        },
+      ],
+    })
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/tests/utils/template.test.ts b/packages/lint-plugin-nuxt-ecosystem/tests/utils/template.test.ts
new file mode 100644
index 0000000..57a34bf
--- /dev/null
+++ b/packages/lint-plugin-nuxt-ecosystem/tests/utils/template.test.ts
@@ -0,0 +1,179 @@
+import type { AST as VueAST } from 'vue-eslint-parser'
+import { describe, expect, it } from 'vitest'
+import {
+  documentRoot,
+  getAttributeValue,
+  getStaticAttribute,
+  getStaticBoolean,
+  hasAttribute,
+  hasDefiniteAttribute,
+  hasLabelContent,
+  hasNonEmptyAttribute,
+  hasSlot,
+  hasVModel,
+} from '../../src/utils/template.js'
+import { element } from '../parse.js'
+
+describe('getAttributeValue', () => {
+  it('reads a plain attribute, valueless or not', () => {
+    expect(getAttributeValue(element('<UInput placeholder="Email" />'), 'placeholder'))
+      .toMatchObject({ present: true, definite: true, known: true, value: 'Email' })
+    expect(getAttributeValue(element('<UInput disabled />'), 'disabled'))
+      .toMatchObject({ present: true, definite: true, known: true, value: true })
+    expect(getAttributeValue(element('<UInput />'), 'disabled'))
+      .toMatchObject({ present: false, definite: false, known: true })
+  })
+
+  it('evaluates the expressions that are as static as a literal', () => {
+    const value = (code: string) => getAttributeValue(element(code), 'open')
+    expect(value('<UModal :open="true" />')).toMatchObject({ known: true, definite: true, value: true })
+    expect(value('<UModal :open="\'yes\'" />')).toMatchObject({ known: true, value: 'yes' })
+    expect(value('<UModal :open="`yes`" />')).toMatchObject({ known: true, value: 'yes' })
+    expect(value('<UModal :open="[1, 2]" />')).toMatchObject({ known: true, value: [1, 2] })
+    expect(value('<UModal :open="undefined" />')).toMatchObject({ present: true, definite: false, known: true })
+    expect(value('<UModal :open="null" />')).toMatchObject({ present: true, definite: false, known: true })
+  })
+
+  it('gives up on anything it cannot prove', () => {
+    const value = (code: string) => getAttributeValue(element(code), 'open')
+    expect(value('<UModal :open="isOpen" />')).toMatchObject({ present: true, definite: true, known: false })
+    // eslint-disable-next-line no-template-curly-in-string -- Vue source, not JS interpolation.
+    expect(value('<UModal :open="`${a}`" />')).toMatchObject({ known: false })
+    expect(value('<UModal :open="[1, unknown]" />')).toMatchObject({ known: false })
+  })
+
+  it('normalizes prop spelling and lets the last duplicate win', () => {
+    expect(getAttributeValue(element('<UInput modelValue="value" />'), 'model-value'))
+      .toMatchObject({ known: true, value: 'value' })
+    expect(getAttributeValue(element('<UInput :modelValue="1" />'), 'model-value'))
+      .toMatchObject({ known: true, value: 1 })
+    expect(getAttributeValue(element('<UInput v-bind="{ \'model-value\': 1 }" />'), 'modelValue'))
+      .toMatchObject({ known: true, value: 1 })
+    expect(getAttributeValue(element('<UInput v-bind="{ modelValue: 1 }" />'), 'model-value'))
+      .toMatchObject({ known: true, value: 1 })
+    expect(getAttributeValue(element('<UInput :value="\'a\'" :value="\'b\'" />'), 'value'))
+      .toMatchObject({ value: 'b' })
+  })
+
+  it('reads through a v-bind object, including nested spreads', () => {
+    const value = (code: string) => getAttributeValue(element(code), 'multiple')
+    expect(value('<UFileUpload v-bind="{ multiple: true }" />')).toMatchObject({ known: true, value: true })
+    expect(value('<UFileUpload v-bind="{ ...defaults, multiple: false }" />')).toMatchObject({ known: true, value: false })
+    expect(value('<UFileUpload v-bind="{ ...defaults }" />')).toMatchObject({ present: true, definite: false, known: false })
+    expect(value('<UFileUpload v-bind="{ [key]: true }" />')).toMatchObject({ known: false })
+    expect(value('<UFileUpload v-bind="props" />')).toMatchObject({ known: false })
+  })
+
+  it('prefers an explicit prop over the same key inside v-bind', () => {
+    expect(getAttributeValue(element('<UFileUpload v-bind="{ multiple: true }" :multiple="false" />'), 'multiple'))
+      .toMatchObject({ known: true, value: false })
+  })
+})
+
+describe('attribute predicates', () => {
+  it('separates presence from actually supplying a value', () => {
+    expect(hasAttribute(element('<UModal :open="undefined" />'), 'open')).toBe(true)
+    expect(hasDefiniteAttribute(element('<UModal :open="undefined" />'), 'open')).toBe(false)
+    expect(hasDefiniteAttribute(element('<UModal :open="isOpen" />'), 'open')).toBe(true)
+  })
+
+  it('treats whitespace and empty collections as empty', () => {
+    expect(hasNonEmptyAttribute(element('<UAvatar alt="Face" />'), 'alt')).toBe(true)
+    expect(hasNonEmptyAttribute(element('<UAvatar alt="" />'), 'alt')).toBe(false)
+    expect(hasNonEmptyAttribute(element('<UAvatar alt="   " />'), 'alt')).toBe(false)
+    expect(hasNonEmptyAttribute(element('<UKbd :value="[]" />'), 'value')).toBe(false)
+    expect(hasNonEmptyAttribute(element('<UKbd :value="[1]" />'), 'value')).toBe(true)
+    expect(hasNonEmptyAttribute(element('<UProgress :value="0" />'), 'value')).toBe(true)
+    expect(hasNonEmptyAttribute(element('<UAvatar :alt="label" />'), 'alt')).toBe(true)
+  })
+
+  it('reads booleans in every spelling HTML allows', () => {
+    expect(getStaticBoolean(element('<span hidden />'), 'hidden')).toBe(true)
+    expect(getStaticBoolean(element('<span hidden="" />'), 'hidden')).toBe(true)
+    expect(getStaticBoolean(element('<span hidden="true" />'), 'hidden')).toBe(true)
+    expect(getStaticBoolean(element('<span hidden="false" />'), 'hidden')).toBe(false)
+    expect(getStaticBoolean(element('<span :hidden="false" />'), 'hidden')).toBe(false)
+    expect(getStaticBoolean(element('<span :hidden="flag" />'), 'hidden')).toBe(null)
+    expect(getStaticBoolean(element('<span />'), 'hidden')).toBe(null)
+  })
+
+  it('returns a static string only when it really is one', () => {
+    expect(getStaticAttribute(element('<input type="number">'), 'type')).toBe('number')
+    expect(getStaticAttribute(element('<input :type="kind">'), 'type')).toBe(null)
+    expect(getStaticAttribute(element('<input :type="\'number\'">'), 'type')).toBe('number')
+  })
+})
+
+describe('slots', () => {
+  const decorative = (node: VueAST.VElement) => node.rawName === 'UIcon'
+
+  it('requires a declared slot to have content', () => {
+    const withContent = element('<UTooltip><template #content>Hint</template></UTooltip>')
+    expect(hasSlot(withContent, 'content')).toBe(true)
+
+    const empty = element('<UTooltip><template #content></template></UTooltip>')
+    expect(hasSlot(empty, 'content')).toBe(false)
+  })
+
+  it('accepts a dynamic slot name rather than guessing it is the wrong one', () => {
+    expect(hasSlot(element('<UTooltip><template #[name]>Hint</template></UTooltip>'), 'content')).toBe(true)
+    expect(hasSlot(element('<UTooltip><template #footer>Hint</template></UTooltip>'), 'content')).toBe(false)
+  })
+
+  it('ignores decorative and statically hidden slot content', () => {
+    expect(hasSlot(element('<UButton><template #default><UIcon name="i-x" /></template></UButton>'), 'default', decorative)).toBe(false)
+    expect(hasSlot(element('<UButton><template #default v-if="false">Save</template></UButton>'), 'default')).toBe(false)
+  })
+})
+
+describe('hasLabelContent', () => {
+  const decorative = (node: VueAST.VElement) => node.rawName === 'UIcon'
+
+  it('counts text, interpolation and nested markup', () => {
+    expect(hasLabelContent(element('<UButton>Save</UButton>'))).toBe(true)
+    expect(hasLabelContent(element('<UButton>{{ label }}</UButton>'))).toBe(true)
+    expect(hasLabelContent(element('<UButton><span><b>Save</b></span></UButton>'))).toBe(true)
+    expect(hasLabelContent(element('<UButton>   </UButton>'))).toBe(false)
+    expect(hasLabelContent(element('<UButton></UButton>'))).toBe(false)
+    expect(hasLabelContent(element('<UButton>{{ "" }}</UButton>'))).toBe(false)
+  })
+
+  it('counts an image with alt text but not a decorative one', () => {
+    expect(hasLabelContent(element('<UButton><img src="/a.png" alt="Save"></UButton>'))).toBe(true)
+    expect(hasLabelContent(element('<UButton><img src="/a.png" alt=""></UButton>'))).toBe(false)
+    expect(hasLabelContent(element('<UButton><UIcon name="i-x" /></UButton>'), decorative)).toBe(false)
+  })
+
+  it('assumes an unknown component renders something, but looks through transparent built-ins', () => {
+    expect(hasLabelContent(element('<UButton><MyLabel /></UButton>'))).toBe(true)
+    expect(hasLabelContent(element('<UButton><Transition></Transition></UButton>'))).toBe(false)
+    expect(hasLabelContent(element('<UButton><Transition>Save</Transition></UButton>'))).toBe(true)
+    expect(hasLabelContent(element('<UButton><KeepAlive><MyLabel /></KeepAlive></UButton>'))).toBe(true)
+  })
+
+  it('skips content hidden from the accessibility tree', () => {
+    expect(hasLabelContent(element('<UButton><span aria-hidden="true">Save</span></UButton>'))).toBe(false)
+    expect(hasLabelContent(element('<UButton><span hidden>Save</span></UButton>'))).toBe(false)
+    expect(hasLabelContent(element('<UButton><span v-if="\'\'">Save</span></UButton>'))).toBe(false)
+    expect(hasLabelContent(element('<UButton><span v-if="ready">Save</span></UButton>'))).toBe(true)
+    expect(hasLabelContent(element('<UButton><span :aria-hidden="flag">Save</span></UButton>'))).toBe(true)
+  })
+})
+
+describe('hasVModel', () => {
+  it('distinguishes the default model from a named one', () => {
+    expect(hasVModel(element('<UInput v-model="value" />'), null)).toBe(true)
+    expect(hasVModel(element('<UInput v-model="value" />'), 'open')).toBe(false)
+    expect(hasVModel(element('<UModal v-model:open="open" />'), 'open')).toBe(true)
+    expect(hasVModel(element('<UModal v-model:open="open" />'), null)).toBe(false)
+    expect(hasVModel(element('<UModal v-model:[name]="open" />'), 'open')).toBe(false)
+    expect(hasVModel(element('<UModal :open="open" />'), 'open')).toBe(false)
+  })
+})
+
+describe('documentRoot', () => {
+  it('climbs past the template element to the document fragment', () => {
+    const root = documentRoot(element('<UForm><UInput /></UForm>'))
+    expect(root?.type).toBe('VDocumentFragment')
+  })
+})
diff --git a/packages/lint-plugin-nuxt-ecosystem/tsconfig.json b/packages/lint-plugin-nuxt-ecosystem/tsconfig.json
index 7222a53..45176c8 100644
--- a/packages/lint-plugin-nuxt-ecosystem/tsconfig.json
+++ b/packages/lint-plugin-nuxt-ecosystem/tsconfig.json
@@ -1,4 +1,4 @@
 {
   "extends": "../../tsconfig.package.json",
-  "include": ["src", "vitest.config.ts"]
+  "include": ["src", "tests", "vitest.config.ts"]
 }
diff --git a/packages/lint-plugin-nuxt-ecosystem/vitest.config.ts b/packages/lint-plugin-nuxt-ecosystem/vitest.config.ts
index 647f393..9998904 100644
--- a/packages/lint-plugin-nuxt-ecosystem/vitest.config.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/vitest.config.ts
@@ -2,6 +2,6 @@ import { defineConfig } from 'vitest/config'
 
 export default defineConfig({
   test: {
-    include: ['src/**/*.test.ts'],
+    include: ['src/**/index.test.ts', 'tests/**/*.test.ts'],
   },
 })
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 80d7dd4..7fc233e 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -235,8 +235,8 @@ importers:
   modules/lint/playground:
     dependencies:
       '@nustackjs/lint':
-        specifier: latest
-        version: 0.5.0(71bed611addd699af4f876cdc8040948)
+        specifier: workspace:*
+        version: link:..
       '@nuxt/content':
         specifier: ^3.15.0
         version: 3.15.0(@valibot/to-json-schema@1.7.1(valibot@1.4.2(typescript@6.0.3)))(esbuild@0.28.1)(magicast@0.5.3)(rolldown@1.1.4)(rollup@4.62.2)(sqlite3@5.1.7)(valibot@1.4.2(typescript@6.0.3))(vite@7.3.6(@types/node@26.1.0)(jiti@2.7.0)(lightningcss@1.32.0)(terser@5.48.0)(yaml@2.9.0))
@@ -294,6 +294,9 @@ importers:
         specifier: catalog:eslint
         version: 1.72.0
     devDependencies:
+      '@typescript-eslint/parser':
+        specifier: catalog:eslint
+        version: 8.62.1(eslint@10.6.0(jiti@2.7.0))(typescript@6.0.3)
       eslint:
         specifier: catalog:eslint
         version: 10.6.0(jiti@2.7.0)
@@ -1337,12 +1340,6 @@ packages:
     engines: {node: '>=10'}
     deprecated: This functionality has been moved to @npmcli/fs
 
-  '@nustackjs/lint@0.5.0':
-    resolution: {integrity: sha512-EJbKOINv8C+xtguc96LE5G/5zBc5QyiVahrixkhnkDJM/MWC/j+enMAqhxyDbedHmsIn9v2QLJJynZJnsECZmQ==}
-    peerDependencies:
-      eslint: '>=9.0.0'
-      nuxt: '>=3.0.0'
-
   '@nuxt/cli@3.36.1':
     resolution: {integrity: sha512-qu0LLFjOr1alMSrcVb3k3fWYXGeETeOIN5UoGoGEjwWVtf+KxQbN5IAzdXb7ip5D3pfKLcrAOTbIGf9XFmeGFQ==}
     engines: {node: ^16.14.0 || >=18.0.0}
@@ -9027,77 +9024,6 @@ snapshots:
       rimraf: 3.0.2
     optional: true
 
-  '@nustackjs/lint@0.5.0(71bed611addd699af4f876cdc8040948)':
-    dependencies:
-      '@antfu/eslint-config': 9.1.0(@typescript-eslint/rule-tester@8.62.1(eslint@10.6.0(jiti@2.7.0))(typescript@6.0.3))(@typescript-eslint/typescript-estree@8.62.1(typescript@6.0.3))(@typescript-eslint/utils@8.62.1(eslint@10.6.0(jiti@2.7.0))(typescript@6.0.3))(@vue/compiler-sfc@3.5.39)(eslint-plugin-format@2.0.1(eslint@10.6.0(jiti@2.7.0)))(eslint@10.6.0(jiti@2.7.0))(typescript@6.0.3)(vitest@4.1.9(@types/node@26.1.0)(vite@7.3.6(@types/node@26.1.0)(jiti@2.7.0)(lightningcss@1.32.0)(terser@5.48.0)(yaml@2.9.0)))
-      '@nustackjs/lint-plugin-nuxt': link:packages/lint-plugin-nuxt
-      '@nustackjs/lint-plugin-nuxt-ecosystem': link:packages/lint-plugin-nuxt-ecosystem
-      '@nustackjs/lint-plugin-vite': link:packages/lint-plugin-vite
-      '@nustackjs/lint-plugin-vueuse': link:packages/lint-plugin-vueuse
-      '@nuxt/eslint': 1.16.0(@typescript-eslint/utils@8.62.1(eslint@10.6.0(jiti@2.7.0))(typescript@6.0.3))(@vue/compiler-sfc@3.5.39)(crossws@0.4.9(srvx@0.11.21))(esbuild@0.28.1)(eslint-plugin-format@2.0.1(eslint@10.6.0(jiti@2.7.0)))(eslint@10.6.0(jiti@2.7.0))(magicast@0.5.3)(oxc-parser@0.133.0)(rolldown@1.1.4)(rollup@4.62.2)(typescript@6.0.3)(vite@7.3.6(@types/node@26.1.0)(jiti@2.7.0)(lightningcss@1.32.0)(terser@5.48.0)(yaml@2.9.0))
-      '@nuxt/kit': 4.4.8(magicast@0.5.3)
-      '@typescript-eslint/utils': 8.62.1(eslint@10.6.0(jiti@2.7.0))(typescript@6.0.3)
-      defu: 6.1.7
-      eslint: 10.6.0(jiti@2.7.0)
-      eslint-flat-config-utils: 3.2.0
-      eslint-plugin-better-tailwindcss: 4.6.1(eslint@10.6.0(jiti@2.7.0))(tailwindcss@4.3.2)(typescript@6.0.3)
-      eslint-plugin-format: 2.0.1(eslint@10.6.0(jiti@2.7.0))
-      eslint-plugin-vue: 10.9.2(@stylistic/eslint-plugin@5.10.0(eslint@10.6.0(jiti@2.7.0)))(@typescript-eslint/parser@8.62.1(eslint@10.6.0(jiti@2.7.0))(typescript@6.0.3))(eslint@10.6.0(jiti@2.7.0))(vue-eslint-parser@10.4.1(eslint@10.6.0(jiti@2.7.0)))
-      exsolve: 1.1.0
-      mdclint: 0.1.2(eslint@10.6.0(jiti@2.7.0))
-      nuxt: 4.4.8(@babel/plugin-syntax-jsx@7.29.7(@babel/core@7.29.7))(@babel/plugin-syntax-typescript@7.29.7(@babel/core@7.29.7))(@parcel/watcher@2.5.6)(@types/node@26.1.0)(@vitejs/devtools@0.3.4(crossws@0.4.9(srvx@0.11.21))(db0@0.3.4(sqlite3@5.1.7))(esbuild@0.28.1)(ioredis@5.11.1)(rolldown@1.1.4)(rollup@4.62.2)(typescript@6.0.3)(vite@7.3.6(@types/node@26.1.0)(jiti@2.7.0)(lightningcss@1.32.0)(terser@5.48.0)(yaml@2.9.0)))(@vue/compiler-sfc@3.5.39)(cac@6.7.14)(db0@0.3.4(sqlite3@5.1.7))(encoding@0.1.13)(esbuild@0.28.1)(eslint@10.6.0(jiti@2.7.0))(ioredis@5.11.1)(lightningcss@1.32.0)(magicast@0.5.3)(optionator@0.9.4)(rolldown@1.1.4)(rollup-plugin-visualizer@7.0.1(rolldown@1.1.4)(rollup@4.62.2))(rollup@4.62.2)(sqlite3@5.1.7)(srvx@0.11.21)(terser@5.48.0)(typescript@6.0.3)(vite@7.3.6(@types/node@26.1.0)(jiti@2.7.0)(lightningcss@1.32.0)(terser@5.48.0)(yaml@2.9.0))(yaml@2.9.0)
-      unimport: 6.3.0(esbuild@0.28.1)(oxc-parser@0.133.0)(rolldown@1.1.4)(rollup@4.62.2)(vite@7.3.6(@types/node@26.1.0)(jiti@2.7.0)(lightningcss@1.32.0)(terser@5.48.0)(yaml@2.9.0))
-      vue-eslint-parser: 10.4.1(eslint@10.6.0(jiti@2.7.0))
-    transitivePeerDependencies:
-      - '@angular-eslint/eslint-plugin'
-      - '@angular-eslint/eslint-plugin-template'
-      - '@angular-eslint/template-parser'
-      - '@eslint-react/eslint-plugin'
-      - '@eslint/css'
-      - '@eslint/json'
-      - '@farmfe/core'
-      - '@modelcontextprotocol/sdk'
-      - '@next/eslint-plugin-next'
-      - '@prettier/plugin-xml'
-      - '@rspack/core'
-      - '@stylistic/eslint-plugin'
-      - '@typescript-eslint/parser'
-      - '@typescript-eslint/rule-tester'
-      - '@typescript-eslint/typescript-estree'
-      - '@unocss/eslint-plugin'
-      - '@vue/compiler-sfc'
-      - astro-eslint-parser
-      - bufferutil
-      - bun-types-no-globals
-      - crossws
-      - esbuild
-      - eslint-import-resolver-node
-      - eslint-plugin-astro
-      - eslint-plugin-jsx-a11y
-      - eslint-plugin-react-refresh
-      - eslint-plugin-solid
-      - eslint-plugin-svelte
-      - eslint-plugin-vuejs-accessibility
-      - eslint-webpack-plugin
-      - magicast
-      - oxc-parser
-      - oxlint
-      - prettier-plugin-astro
-      - prettier-plugin-slidev
-      - rolldown
-      - rollup
-      - supports-color
-      - svelte-eslint-parser
-      - tailwindcss
-      - ts-declaration-location
-      - typescript
-      - unloader
-      - utf-8-validate
-      - vite
-      - vite-plugin-eslint2
-      - vitest
-      - webpack
-
   '@nuxt/cli@3.36.1(@nuxt/schema@4.4.8)(cac@6.7.14)(magicast@0.5.3)':
     dependencies:
       '@bomb.sh/tab': 0.0.17(cac@6.7.14)(citty@0.2.2)

From 29ef6a816b03b416d77c98178fdc11fe3689f2f2 Mon Sep 17 00:00:00 2001
From: lajczi <lajczi@disroot.org>
Date: Sun, 16 Aug 2026 23:37:56 +0200
Subject: [PATCH 12/12] address Codex feedback

---
 packages/lint-plugin-nuxt-ecosystem/README.md |  2 +-
 .../require-form-control-label/index.md       | 20 ++++++
 .../require-form-control-label/index.test.ts  |  9 +++
 .../require-form-control-label/index.ts       | 71 +++++++++++++++----
 .../src/utils/template.ts                     | 26 ++++++-
 .../tests/utils/template.test.ts              | 39 ++++++++++
 6 files changed, 151 insertions(+), 16 deletions(-)

diff --git a/packages/lint-plugin-nuxt-ecosystem/README.md b/packages/lint-plugin-nuxt-ecosystem/README.md
index 15790ce..a2bc40a 100644
--- a/packages/lint-plugin-nuxt-ecosystem/README.md
+++ b/packages/lint-plugin-nuxt-ecosystem/README.md
@@ -81,7 +81,7 @@ export default antfu(
 the prefix your Nuxt UI setup uses. No ecosystem options are required:
 
 ```js
-import nustack from '@nustackjs/lint'
+import { nustack } from '@nustackjs/lint/config'
 
 export default nustack()
 ```
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
index 7867bb7..d74e959 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.md
@@ -4,11 +4,23 @@ Require an accessible name for Nuxt UI form controls. The rule understands each
 supported `label` or `legend` API, ARIA naming, native `<label>` associations, and enclosing
 `UFormField` labels.
 
+`label` is a real API on `UCheckbox`, `USwitch`, and `UFileUpload`. `legend` is a real API on
+`UCheckboxGroup` and `URadioGroup`. The same attribute on other controls is ignored because it
+does not create an accessible name.
+
+A native `<label>` (wrapping the control, or `for` matching a static `id`) is an accessible
+name. `prefer-u-form-field` still prefers `UFormField` for that pair.
+
 ## Incorrect
 
 ```vue
 <template>
   <UInput placeholder="Search" />
+  <UInput label="Email" />
+  <UFormField label="Range">
+    <UInput />
+    <UInput />
+  </UFormField>
 </template>
 ```
 
@@ -21,6 +33,13 @@ supported `label` or `legend` API, ARIA naming, native `<label>` associations, a
   </UFormField>
   <UCheckboxGroup legend="Options" :items="items" />
   <USwitch aria-label="Enable notifications" />
+  <UFileUpload label="Drop a file" />
+  <label for="email">Email</label>
+  <UInput id="email" />
+  <UFormField label="Contact">
+    <UInput v-if="useEmail" />
+    <UTextarea v-else />
+  </UFormField>
 </template>
 ```
 
@@ -34,3 +53,4 @@ An intentional exception uses a standard ESLint disable comment.
 
 - [Nuxt UI FormField](https://ui.nuxt.com/docs/components/form-field)
 - [Nuxt UI CheckboxGroup](https://ui.nuxt.com/docs/components/checkbox-group)
+- [Nuxt UI FileUpload](https://ui.nuxt.com/docs/components/file-upload)
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
index 94834d5..8986c0b 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.test.ts
@@ -8,13 +8,22 @@ describe('require-form-control-label', () => {
       valid: [
         { code: '<template><UInput aria-label="Search" /></template>' },
         { code: '<template><UCheckboxGroup legend="Theme" /></template>' },
+        { code: '<template><UCheckbox label="Remember me" /></template>' },
+        { code: '<template><UFileUpload label="Drop a file" /></template>' },
         { code: '<template><UFormField label="Email"><UInput /></UFormField></template>' },
         { code: '<template><UFormField><template #label>Email</template><UInput /></UFormField></template>' },
+        { code: '<template><label for="email">Email</label><UInput id="email" /></template>' },
+        { code: '<template><label>Email <UInput /></label></template>' },
+        { code: '<template><UFormField label="Contact"><UInput v-if="useEmail" /><UTextarea v-else /></UFormField></template>' },
       ],
       invalid: [
         { code: '<template><UInput placeholder="Search" /></template>', errors: [{ messageId: 'missingLabel' }] },
         { code: '<template><URadioGroup :items="items" /></template>', errors: [{ messageId: 'missingLabel' }] },
         { code: '<template><UFormField><UInput /></UFormField></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UInput label="Email" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UTextarea legend="Notes" /></template>', errors: [{ messageId: 'missingLabel' }] },
+        { code: '<template><UFormField label="Range"><UInput /><UInput /></UFormField></template>', errors: [{ messageId: 'missingLabel' }, { messageId: 'missingLabel' }] },
+        { code: '<template><UFormField label="Contact"><UInput v-if="a" /><UTextarea v-if="b" /></UFormField></template>', errors: [{ messageId: 'missingLabel' }, { messageId: 'missingLabel' }] },
       ],
     })
   })
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
index d0e468e..dfb0153 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/rules/nuxt-ui/require-form-control-label/index.ts
@@ -1,9 +1,9 @@
 import type { Context, Rule, Visitor } from '@oxlint/plugins'
 import type { AST as VueAST } from 'vue-eslint-parser'
 import type { ComponentMatcher } from '../../../utils/component-matcher.js'
-import { elementAncestor } from '../../../utils/component-matcher.js'
+import { elementAncestor, isNativeElement } from '../../../utils/component-matcher.js'
 import { docsUrl } from '../../../utils/docs-url.js'
-import { defineTemplateVisitor, hasNonEmptyAttribute, hasSlot } from '../../../utils/template.js'
+import { defineTemplateVisitor, documentRoot, findElement, getStaticAttribute, hasDirective, hasLabelContent, hasNonEmptyAttribute, hasSlot, isStaticallyHidden } from '../../../utils/template.js'
 import { createNuxtUiMatcher } from '../components.js'
 
 const FORM_CONTROLS = new Set([
@@ -27,26 +27,69 @@ const FORM_CONTROLS = new Set([
   'Textarea',
 ])
 
-function hasLabeledFormFieldAncestor(node: VueAST.VElement, matcher: ComponentMatcher): boolean {
+const LABEL_CONTROLS = new Set(['Checkbox', 'FileUpload', 'Switch'])
+const LEGEND_CONTROLS = new Set(['CheckboxGroup', 'RadioGroup'])
+
+function alternativeChains(node: VueAST.VElement): VueAST.VElement[][] {
+  const chains: VueAST.VElement[][] = []
+  let chain: VueAST.VElement[] | null = null
+
+  for (const child of node.children) {
+    if (child.type !== 'VElement' || isStaticallyHidden(child))
+      continue
+    if (chain && (hasDirective(child, 'else-if') || hasDirective(child, 'else'))) {
+      chain.push(child)
+      continue
+    }
+    chain = [child]
+    chains.push(chain)
+  }
+
+  return chains
+}
+
+function concurrentControls(node: VueAST.VElement, matcher: ComponentMatcher): number {
+  if (matcher.isOneOf(node, FORM_CONTROLS))
+    return 1
+  return alternativeChains(node).reduce(
+    (total, chain) => total + Math.max(...chain.map(branch => concurrentControls(branch, matcher))),
+    0,
+  )
+}
+
+function hasLabelingAncestor(node: VueAST.VElement, matcher: ComponentMatcher): boolean {
   let parent = elementAncestor(node)
   while (parent) {
+    if (isNativeElement(parent, 'label'))
+      return true
     if (matcher.is(parent, 'FormField')) {
-      return hasNonEmptyAttribute(parent, 'label')
-        || hasSlot(parent, 'label')
+      return (hasNonEmptyAttribute(parent, 'label') || hasSlot(parent, 'label'))
+        && concurrentControls(parent, matcher) === 1
     }
     parent = elementAncestor(parent)
   }
   return false
 }
 
-function hasAccessibleLabel(node: VueAST.VElement, matcher: ComponentMatcher): boolean {
-  return hasNonEmptyAttribute(node, 'label')
-    || hasNonEmptyAttribute(node, 'legend')
-    || hasNonEmptyAttribute(node, 'aria-label')
+function hasLabelForId(node: VueAST.VElement): boolean {
+  const id = getStaticAttribute(node, 'id')
+  if (!id)
+    return false
+  return findElement(documentRoot(node), candidate => isNativeElement(candidate, 'label')
+    && getStaticAttribute(candidate, 'for') === id
+    && hasLabelContent(candidate)) !== null
+}
+
+function hasAccessibleLabel(node: VueAST.VElement, control: string, matcher: ComponentMatcher): boolean {
+  if (LABEL_CONTROLS.has(control) && (hasNonEmptyAttribute(node, 'label') || hasSlot(node, 'label')))
+    return true
+  if (LEGEND_CONTROLS.has(control) && (hasNonEmptyAttribute(node, 'legend') || hasSlot(node, 'legend')))
+    return true
+
+  return hasNonEmptyAttribute(node, 'aria-label')
     || hasNonEmptyAttribute(node, 'aria-labelledby')
-    || hasSlot(node, 'label')
-    || hasSlot(node, 'legend')
-    || hasLabeledFormFieldAncestor(node, matcher)
+    || hasLabelingAncestor(node, matcher)
+    || hasLabelForId(node)
 }
 
 export const requireFormControlLabel: Rule = {
@@ -58,7 +101,7 @@ export const requireFormControlLabel: Rule = {
     },
     schema: [],
     messages: {
-      missingLabel: 'Add `label`, `legend`, `aria-label`, `aria-labelledby`, or wrap `<{{ component }}>` in a `<UFormField>` with `label` or a `#label` slot.',
+      missingLabel: 'Add `label`, `legend`, `aria-label`, `aria-labelledby`, a native `<label>`, or wrap `<{{ component }}>` in a `<UFormField>` with `label` or a `#label` slot.',
     },
   },
   create(context: Context): Visitor {
@@ -67,7 +110,7 @@ export const requireFormControlLabel: Rule = {
     return defineTemplateVisitor(context, {
       VElement(node: VueAST.VElement) {
         const control = matcher.matchOf(node, FORM_CONTROLS)
-        if (!control || hasAccessibleLabel(node, matcher))
+        if (!control || hasAccessibleLabel(node, control, matcher))
           return
         context.report({
           loc: node.startTag.loc,
diff --git a/packages/lint-plugin-nuxt-ecosystem/src/utils/template.ts b/packages/lint-plugin-nuxt-ecosystem/src/utils/template.ts
index 450e4fe..73f4b8b 100644
--- a/packages/lint-plugin-nuxt-ecosystem/src/utils/template.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/src/utils/template.ts
@@ -33,6 +33,26 @@ export function documentRoot(node: VueAST.Node | null | undefined): VueAST.Node
   return root ?? null
 }
 
+function childNodes(node: VueAST.Node): VueAST.VElement['children'] {
+  return node.type === 'VElement' || node.type === 'VDocumentFragment' ? node.children : []
+}
+
+export function findElement(
+  root: VueAST.Node | null | undefined,
+  predicate: (node: VueAST.VElement) => boolean,
+): VueAST.VElement | null {
+  if (!root)
+    return null
+  if (root.type === 'VElement' && predicate(root))
+    return root
+  for (const child of childNodes(root)) {
+    const found = findElement(child, predicate)
+    if (found)
+      return found
+  }
+  return null
+}
+
 export interface AttributeValue {
   present: boolean
   definite: boolean
@@ -201,7 +221,7 @@ function hasMeaningfulChildren(node: VueAST.VElement, isDecorative: (node: VueAS
   })
 }
 
-function isStaticallyHidden(node: VueAST.VElement): boolean {
+export function isStaticallyHidden(node: VueAST.VElement): boolean {
   if (getStaticBoolean(node, 'aria-hidden') === true)
     return true
   if (getStaticBoolean(node, 'hidden') === true)
@@ -263,6 +283,10 @@ export function hasLabelContent(node: VueAST.VElement, isDecorative: (node: VueA
   return hasMeaningfulChildren(node, isDecorative)
 }
 
+export function hasDirective(node: VueAST.VElement, name: string): boolean {
+  return node.startTag.attributes.some(attribute => attribute.directive && attribute.key.name.name === name)
+}
+
 export function hasVModel(node: VueAST.VElement, argumentName: string | null): boolean {
   return node.startTag.attributes.some((attribute) => {
     if (!attribute.directive || attribute.key.name.name !== 'model')
diff --git a/packages/lint-plugin-nuxt-ecosystem/tests/utils/template.test.ts b/packages/lint-plugin-nuxt-ecosystem/tests/utils/template.test.ts
index 57a34bf..9a28f28 100644
--- a/packages/lint-plugin-nuxt-ecosystem/tests/utils/template.test.ts
+++ b/packages/lint-plugin-nuxt-ecosystem/tests/utils/template.test.ts
@@ -2,15 +2,18 @@ import type { AST as VueAST } from 'vue-eslint-parser'
 import { describe, expect, it } from 'vitest'
 import {
   documentRoot,
+  findElement,
   getAttributeValue,
   getStaticAttribute,
   getStaticBoolean,
   hasAttribute,
   hasDefiniteAttribute,
+  hasDirective,
   hasLabelContent,
   hasNonEmptyAttribute,
   hasSlot,
   hasVModel,
+  isStaticallyHidden,
 } from '../../src/utils/template.js'
 import { element } from '../parse.js'
 
@@ -171,9 +174,45 @@ describe('hasVModel', () => {
   })
 })
 
+describe('hasDirective', () => {
+  it('matches a directive by name, whatever its argument or value', () => {
+    expect(hasDirective(element('<UInput v-if="ready" />'), 'if')).toBe(true)
+    expect(hasDirective(element('<UInput v-else />'), 'else')).toBe(true)
+    expect(hasDirective(element('<UModal v-model:open="open" />'), 'model')).toBe(true)
+    expect(hasDirective(element('<UInput v-if="ready" />'), 'else-if')).toBe(false)
+    expect(hasDirective(element('<UInput if="ready" />'), 'if')).toBe(false)
+  })
+})
+
+describe('isStaticallyHidden', () => {
+  it('reports only the elements provably absent from the accessibility tree', () => {
+    expect(isStaticallyHidden(element('<span hidden>Save</span>'))).toBe(true)
+    expect(isStaticallyHidden(element('<span aria-hidden="true">Save</span>'))).toBe(true)
+    expect(isStaticallyHidden(element('<span v-if="false">Save</span>'))).toBe(true)
+    expect(isStaticallyHidden(element('<span v-show="\'\'">Save</span>'))).toBe(true)
+    expect(isStaticallyHidden(element('<span v-if="ready">Save</span>'))).toBe(false)
+    expect(isStaticallyHidden(element('<span>Save</span>'))).toBe(false)
+  })
+})
+
 describe('documentRoot', () => {
   it('climbs past the template element to the document fragment', () => {
     const root = documentRoot(element('<UForm><UInput /></UForm>'))
     expect(root?.type).toBe('VDocumentFragment')
   })
 })
+
+describe('findElement', () => {
+  it('searches the whole tree from any node, including the root itself', () => {
+    const form = element('<UForm><div><UInput id="email" /></div></UForm>')
+    expect(findElement(form, node => node.rawName === 'UInput')?.rawName).toBe('UInput')
+    expect(findElement(form, node => node.rawName === 'UForm')?.rawName).toBe('UForm')
+    expect(findElement(form, node => node.rawName === 'UTextarea')).toBe(null)
+    expect(findElement(null, () => true)).toBe(null)
+  })
+
+  it('reaches siblings of the starting element through the document root', () => {
+    const label = element('<label for="email">Email</label><UInput id="email" />')
+    expect(findElement(documentRoot(label), node => node.rawName === 'UInput')?.rawName).toBe('UInput')
+  })
+})