@a11yfred/neighbor 1.1.2 → 2.0.0

package/lib/rules.js

@@ -1663,7 +1663,7 @@ export function makeNoNoninteractiveTabindex(h) {
 const ROLE_TO_ELEMENT = {
   button:      'button',
   link:        'a',
-  heading:     'h1–h6',
+  heading:     'h1-h6',
   checkbox:    'input[type=checkbox]',
   radio:       'input[type=radio]',
   textbox:     'input or textarea',
@@ -2265,9 +2265,350 @@ function isEffectivelyEmpty(wrapperNode, h) {
   })
 }
 
+// ─── no-skipped-heading-levels ───────────────────────────────────────────────
+
+export function makeNoSkippedHeadingLevels(h) {
+  return {
+    meta: {
+      type: 'suggestion',
+      docs: { description: 'Disallow skipping heading levels (e.g. <h1> to <h3>)' },
+      messages: {
+        skippedHeading: 'Skipped heading level. Do not jump from <h{{prev}}> to <h{{current}}>. (Axe: heading-order)',
+      },
+      schema: [],
+    },
+    create(context) {
+      let prevLevel = null
+      return {
+        [h.elementVisitor](node) {
+          const el = h.getElementName(node)
+          const role = h.getRoleValue(node)
+          let currentLevel = null
+          
+          if (el && el.match(/^h[1-6]$/i) && role !== 'presentation' && role !== 'none') {
+            currentLevel = parseInt(el.charAt(1), 10)
+          }
+          
+          const ariaLevelAttr = h.getAttr(node, 'aria-level')
+          const ariaLevel = ariaLevelAttr ? h.getAttrStringValue(ariaLevelAttr) : null
+          if (ariaLevel && !isNaN(parseInt(ariaLevel, 10))) {
+            currentLevel = parseInt(ariaLevel, 10)
+          }
+          
+          if (currentLevel !== null) {
+            if (prevLevel !== null && currentLevel > prevLevel + 1) {
+              context.report({
+                node,
+                messageId: 'skippedHeading',
+                data: { prev: prevLevel, current: currentLevel }
+              })
+            }
+            prevLevel = currentLevel
+          }
+        },
+      }
+    },
+  }
+}
+
+// ─── no-multiple-main ────────────────────────────────────────────────────────
+
+export function makeNoMultipleMain(h) {
+  return {
+    meta: {
+      type: 'problem',
+      docs: { description: 'Disallow more than one <main> or role="main" element per file' },
+      messages: {
+        multipleMain: 'A document must not have more than one <main> or role="main" visible. (Axe: landmark-one-main)',
+      },
+      schema: [],
+    },
+    create(context) {
+      let mainCount = 0
+      return {
+        [h.elementVisitor](node) {
+          const role = h.getRoleValue(node)
+          const el = h.getElementName(node)
+          if (role === 'main' || (el === 'main' && role !== 'presentation' && role !== 'none')) {
+            mainCount++
+            if (mainCount > 1) {
+              context.report({ node, messageId: 'multipleMain' })
+            }
+          }
+        },
+      }
+    },
+  }
+}
+
+// ─── no-toggle-without-checked ───────────────────────────────────────────────
+
+export function makeNoToggleWithoutChecked(h) {
+  return {
+    meta: {
+      type: 'problem',
+      docs: { description: 'Disallow role="switch", "checkbox", or "radio" without aria-checked' },
+      messages: {
+        missingChecked: 'Elements with role="{{role}}" must have an aria-checked attribute to convey their state. (APG)',
+      },
+      schema: [],
+    },
+    create(context) {
+      return {
+        [h.elementVisitor](node) {
+          const role = h.getRoleValue(node)
+          if (role !== 'switch' && role !== 'checkbox' && role !== 'radio') return
+          
+          if (h.hasAttr(node, 'aria-checked')) return
+          
+          // Exception: HTML native <input type="checkbox/radio"> has native state
+          const el = h.getElementName(node)
+          if (el === 'input') {
+            const typeAttr = h.getAttr(node, 'type')
+            const type = typeAttr ? h.getAttrStringValue(typeAttr) : null
+            if (type === 'checkbox' || type === 'radio') return
+          }
+          
+          context.report({ node, messageId: 'missingChecked', data: { role } })
+        },
+      }
+    },
+  }
+}
+
+// ─── no-expanded-without-controls ────────────────────────────────────────────
+
+export function makeNoExpandedWithoutControls(h) {
+  return {
+    meta: {
+      type: 'suggestion',
+      docs: { description: 'Disallow aria-expanded without aria-controls' },
+      messages: {
+        missingControls: 'Elements with aria-expanded must have an aria-controls attribute pointing to the ID of the expandable container. (APG: Disclosure)',
+      },
+      schema: [],
+    },
+    create(context) {
+      return {
+        [h.elementVisitor](node) {
+          if (!h.hasAttr(node, 'aria-expanded')) return
+          if (h.hasAttr(node, 'aria-controls')) return
+          
+          context.report({ node, messageId: 'missingControls' })
+        },
+      }
+    },
+  }
+}
+
+// ─── no-aria-hidden-on-main ──────────────────────────────────────────────────
+
+export function makeNoAriaHiddenOnMain(h) {
+  return {
+    meta: {
+      type: 'problem',
+      docs: { description: 'Disallow aria-hidden="true" on <body>, <main>, or role="main"' },
+      messages: {
+        hiddenMain: 'aria-hidden="true" on the main content or body hides the entire application from screen readers. Place it on a sibling wrapper instead. (APG)',
+      },
+      schema: [],
+    },
+    create(context) {
+      return {
+        [h.elementVisitor](node) {
+          const isHidden = h.getAttrStringValue(h.getAttr(node, 'aria-hidden')) === 'true'
+          if (!isHidden) return
+          
+          const el = h.getElementName(node)
+          const role = h.getRoleValue(node)
+          
+          if (el === 'main' || el === 'body' || role === 'main') {
+            context.report({ node, messageId: 'hiddenMain' })
+          }
+        },
+      }
+    },
+  }
+}
+
+// ─── no-meter-without-valuenow ───────────────────────────────────────────────
+
+export function makeNoMeterWithoutValuenow(h) {
+  return {
+    meta: {
+      type: 'problem',
+      docs: { description: 'Disallow role="meter" without aria-valuenow' },
+      messages: {
+        missingValuenow: 'role="meter" represents a scalar measurement and must have an aria-valuenow attribute. (APG: Meter)',
+      },
+      schema: [],
+    },
+    create(context) {
+      return {
+        [h.elementVisitor](node) {
+          const role = h.getRoleValue(node)
+          if (role !== 'meter') return
+          if (h.hasAttr(node, 'aria-valuenow')) return
+          
+          context.report({ node, messageId: 'missingValuenow' })
+        },
+      }
+    },
+  }
+}
+
+// ─── vue-transition-live-region ──────────────────────────────────────────────
+
+export function makeVueTransitionLiveRegion(h) {
+  return {
+    meta: {
+      type: 'suggestion',
+      docs: { description: 'Require aria-live on <Transition>/<TransitionGroup> containing dynamic text' },
+      messages: {
+        missingLive:
+          '<{{tag}}> renders content dynamically but has no aria-live region wrapper. Screen readers will not announce the new content. Wrap it in an element with aria-live="polite". (WCAG SC 4.1.3)',
+      },
+      schema: [],
+    },
+    create(context) {
+      return {
+        [h.elementVisitor](node) {
+          const raw = node.rawName ?? node.name ?? ''
+          if (raw !== 'Transition' && raw !== 'TransitionGroup' && raw !== 'transition' && raw !== 'transition-group') return
+
+          if (h.hasAttr(node, 'aria-live')) return
+          let ancestor = typeof h.getParent === 'function' ? h.getParent(node) : null
+          while (ancestor) {
+            if (h.hasAttr(ancestor, 'aria-live')) return
+            ancestor = typeof h.getParent === 'function' ? h.getParent(ancestor) : null
+          }
+
+          const children = node.children ?? []
+          const hasContent = children.some(c => {
+            if (c.type === 'VText') return (c.value ?? '').trim().length > 0
+            if (c.type === 'VElement') return true
+            return false
+          })
+          if (!hasContent) return
+
+          context.report({ node, messageId: 'missingLive', data: { tag: raw } })
+        },
+      }
+    },
+  }
+}
+
+// ─── vue-click-key-events ────────────────────────────────────────────────────
+
+export function makeVueClickKeyEvents(_h) {
+  return {
+    meta: {
+      type: 'problem',
+      docs: { description: 'Require keyboard event handlers alongside @click on non-native elements' },
+      messages: {
+        missingKeyboard:
+          'Element has @click but no @keyup.enter or @keydown.space. Vue does not polyfill keyboard events on custom elements  -  keyboard-only users cannot activate it. Add @keyup.enter and @keydown.space handlers. (WCAG SC 2.1.1)',
+      },
+      schema: [],
+    },
+    create(context) {
+      return {
+        VAttribute(node) {
+          if (!node.directive) return
+
+          const keyName = node.key?.name
+          const argName = node.key?.argument?.name ?? node.key?.argument?.value
+          if (keyName !== 'on' || argName !== 'click') return
+
+          const vElement = node.parent?.parent ?? node.parent
+          if (!vElement || vElement.type !== 'VElement') return
+
+          const el = (vElement.rawName ?? vElement.name ?? '').toLowerCase()
+          if (['button', 'a', 'input', 'select', 'textarea', 'summary'].includes(el)) return
+
+          const attrs = vElement.startTag?.attributes ?? []
+          const hasKeyboard = attrs.some(a => {
+            if (!a.directive) return false
+            const k = a.key?.name
+            const arg = a.key?.argument?.name ?? a.key?.argument?.value ?? ''
+            const modifiers = a.key?.modifiers ?? []
+            if (k !== 'on') return false
+            if (arg === 'keyup' && modifiers.includes('enter')) return true
+            if (arg === 'keydown' && (modifiers.includes('space') || modifiers.includes('enter'))) return true
+            if (arg === 'keypress') return true
+            return false
+          })
+
+          if (!hasKeyboard) {
+            context.report({ node, messageId: 'missingKeyboard' })
+          }
+        },
+      }
+    },
+  }
+}
+
+// ─── react-fragment-ruins-aria ───────────────────────────────────────────────
+
+const ARIA_CHILD_CONSTRAINED_ROLES = new Set([
+  'list', 'listbox', 'menu', 'menubar', 'radiogroup', 'tree',
+  'grid', 'rowgroup', 'row', 'tablist',
+])
+const NATIVE_CHILD_CONSTRAINED = new Set([
+  'ul', 'ol', 'dl', 'table', 'thead', 'tbody', 'tfoot', 'tr', 'select',
+])
+
+export function makeReactFragmentRuinsAria(h) {
+  return {
+    meta: {
+      type: 'suggestion',
+      docs: { description: 'Warn when a <div key={...}> in a map breaks required ARIA parent-child relationships' },
+      messages: {
+        useFragment:
+          'A <div> with only a `key` prop inside a constrained ARIA container breaks the required DOM hierarchy. Use <React.Fragment key={...}> instead. (ARIA 1.2)',
+      },
+      schema: [],
+    },
+    create(context) {
+      return {
+        [h.elementVisitor](node) {
+          const el = h.getElementName(node)
+          if (el !== 'div' && el !== 'span') return
+
+          const attrs = node.openingElement?.attributes ?? node.startTag?.attributes ?? []
+          const nonKeyAttrs = attrs.filter(a => {
+            const name = a.name?.name ?? a.name ?? a.key?.name
+            return name !== 'key'
+          })
+          if (nonKeyAttrs.length > 0) return
+
+          const parent = typeof h.getParent === 'function' ? h.getParent(node) : null
+          if (!parent) return
+
+          const parentEl = h.getElementName(parent)
+          const parentRole = h.getRoleValue(parent)
+
+          if (
+            (parentRole && ARIA_CHILD_CONSTRAINED_ROLES.has(parentRole)) ||
+            (parentEl && NATIVE_CHILD_CONSTRAINED.has(parentEl))
+          ) {
+            context.report({ node, messageId: 'useFragment' })
+          }
+        },
+      }
+    },
+  }
+}
+
 // ─── All rules map ────────────────────────────────────────────────────────────
 
 export const RULE_FACTORIES = {
+  'no-toggle-without-checked':                  makeNoToggleWithoutChecked,
+  'no-expanded-without-controls':               makeNoExpandedWithoutControls,
+  'no-aria-hidden-on-main':                     makeNoAriaHiddenOnMain,
+  'no-meter-without-valuenow':                  makeNoMeterWithoutValuenow,
+  'no-skipped-heading-levels':                  makeNoSkippedHeadingLevels,
+  'no-multiple-main':                           makeNoMultipleMain,
   'no-aria-label-on-generic':                   makeNoAriaLabelOnGeneric,
   'no-assertive-live-overuse':                  makeNoAssertiveLiveOveruse,
   'warn-role-alert':                            makeWarnRoleAlert,
@@ -2330,6 +2671,13 @@ export const RULE_FACTORIES = {
   'no-dynamic-content-without-live':            makeNoDynamicContentWithoutLive,
   'form-field-multiple-labels':                 makeFormFieldMultipleLabels,
   'no-empty-table-header':                      makeNoEmptyTableHeader,
+  // Vue-specific template rules  -  included in Vue config only
+  'vue-transition-live-region':                 makeVueTransitionLiveRegion,
+  'vue-click-key-events':                       makeVueClickKeyEvents,
+  'vue-router-focus-management':                makeVueRouterFocusManagement,
+  // React-specific JSX rules  -  included in React/Remix configs only
+  'react-fragment-ruins-aria':                  makeReactFragmentRuinsAria,
+  'react-spa-focus-management':                 makeReactSpaFocusManagement,
 }
 
 /** Build the rules map for a plugin by applying helpers to all factories. */
@@ -2350,10 +2698,16 @@ export function buildRecommendedRules(ns) {
     [`${ns}/no-unblocked-aria-disabled`]:                 'error',
     [`${ns}/no-roles-without-name`]:                      'error',
     [`${ns}/no-group-without-name`]:                      'error',
+    [`${ns}/no-toggle-without-checked`]:                  'error',
+    [`${ns}/no-aria-hidden-on-main`]:                     'error',
+    [`${ns}/no-meter-without-valuenow`]:                  'error',
+    [`${ns}/no-expanded-without-controls`]:               'warn',
+    [`${ns}/no-skipped-heading-levels`]:                  'warn',
+    [`${ns}/no-multiple-main`]:                           'warn',
     [`${ns}/no-presentation-on-focusable`]:               'error',
     [`${ns}/no-log-with-interactive-children`]:           'error',
     [`${ns}/no-aria-hidden-in-link`]:                     'error',
-    [`${ns}/no-redundant-aria-hidden-with-presentation`]: 'error',
+    [`${ns}/no-redundant-aria-hidden-with-presentation`]: 'warn',
     [`${ns}/no-aria-owns-on-void`]:                       'error',
     [`${ns}/no-title-as-label`]:                          'error',
     [`${ns}/no-tabs-without-structure`]:                  'error',
@@ -2392,7 +2746,7 @@ export function buildRecommendedRules(ns) {
     [`${ns}/no-tab-without-controls`]:                    'off',
     [`${ns}/no-href-hash`]:                               'off',
     [`${ns}/warn-role-alert`]:                            'off',
-    [`${ns}/prefer-aria-disabled`]:                       'warn',
+    [`${ns}/prefer-aria-disabled`]:                       'off',
     [`${ns}/no-target-blank-without-label`]:              'off',
     [`${ns}/no-dialog-without-close`]:                    'off',
   }
@@ -2417,3 +2771,20 @@ export function buildPortabilityRules(ns) {
     [`${ns}/no-scope-on-td`]:                         'error',
   }
 }
+
+/** Build Vue-specific rules (Transition live region, click key events). */
+export function buildVueFrameworkRules(ns) {
+  return {
+    [`${ns}/vue-transition-live-region`]: 'warn',
+    [`${ns}/vue-click-key-events`]:       'error',
+    [`${ns}/vue-router-focus-management`]: 'off',
+  }
+}
+
+/** Build React/Remix-specific JSX rules (fragment hierarchy, etc.). */
+export function buildReactFrameworkRules(ns) {
+  return {
+    [`${ns}/react-fragment-ruins-aria`]: 'warn',
+    [`${ns}/react-spa-focus-management`]: 'warn',
+  }
+}

package/neighbor-content.mjs

@@ -57,7 +57,7 @@
  *   SJSU Writing Ctr sjsu.edu/writingcenter/docs/handouts/Accessible Writing Strategies.pdf
  */
 
-import { CONTENT_RULE_FACTORIES, buildContentRecommendedRules } from './lib/content-rules.js'
+import { CONTENT_RULE_FACTORIES, buildContentRecommendedRules } from '@a11yfred/neighbor/lib/content-rules.js'
 
 const NS = '@a11yfred/neighbor/content'
 

package/neighbor-eslint-angular.mjs

@@ -23,12 +23,13 @@
  *   ]
  */
 
-import { h } from './lib/helpers-angular.js'
-import { buildRules, buildRecommendedRules, buildPortabilityRules } from './lib/rules.js'
-import { buildUlamRulesAngular, buildUlamRecommendedRulesFramework } from './lib/ulam-rules.js'
+import { h } from '@a11yfred/neighbor/lib/helpers-angular.js'
+import { buildRules, buildRecommendedRules, buildPortabilityRules } from '@a11yfred/neighbor/lib/rules.js'
+import { buildUlamRulesAngular, buildUlamRecommendedRulesFramework } from '@a11yfred/neighbor/lib/ulam-rules.js'
+import { buildAngularFrameworkRules, buildAngularHostRecommendedRules } from '@a11yfred/neighbor/lib/framework-rules.js'
 
 const NS = '@a11yfred/neighbor'
-const rules = { ...buildRules(h), ...buildUlamRulesAngular() }
+const rules = { ...buildRules(h), ...buildUlamRulesAngular(), ...buildAngularFrameworkRules() }
 const plugin = { meta: { name: `${NS}/angular` }, rules }
 
 let angularA11y = null
@@ -41,14 +42,36 @@ const ANGULAR_A11Y_RULES = [
   'no-positive-tabindex', 'role-has-required-aria', 'table-scope', 'valid-aria',
 ]
 
+const UNLIKELY_ANGULAR_RULES = new Set([
+  'no-autofocus', 'no-distracting-elements'
+])
+
 function getAngularA11yRules(plugin) {
   const out = {}
   for (const rule of ANGULAR_A11Y_RULES) {
-    if (plugin.rules?.[rule]) out[`@angular-eslint/template/${rule}`] = 'error'
+    if (plugin.rules?.[rule]) {
+      out[`@angular-eslint/template/${rule}`] = UNLIKELY_ANGULAR_RULES.has(rule) ? 'off' : 'error'
+    }
   }
   return out
 }
 
+const angularRecommended = {
+  ...buildRecommendedRules(NS),
+  ...buildPortabilityRules(NS),
+  ...buildUlamRecommendedRulesFramework(NS),
+  ...buildAngularHostRecommendedRules(NS),
+}
+
+// Omit rules that are already covered by @angular-eslint/template (if installed):
+if (angularA11y) {
+  delete angularRecommended[`${NS}/no-heading-no-content`] // covered by @angular-eslint/template/elements-content
+  delete angularRecommended[`${NS}/no-anchor-no-content`] // covered by @angular-eslint/template/elements-content
+  delete angularRecommended[`${NS}/no-img-redundant-alt`] // covered by @angular-eslint/template/alt-text
+  delete angularRecommended[`${NS}/no-scope-on-td`] // covered by @angular-eslint/template/table-scope
+  delete angularRecommended[`${NS}/no-invalid-aria-prop-value`] // covered by @angular-eslint/template/valid-aria
+}
+
 export default {
   ...plugin,
   configs: {
@@ -59,9 +82,7 @@ export default {
       },
       rules: {
         ...(angularA11y ? getAngularA11yRules(angularA11y) : {}),
-        ...buildRecommendedRules(NS),
-        ...buildPortabilityRules(NS),
-        ...buildUlamRecommendedRulesFramework(NS),
+        ...angularRecommended,
       },
     },
   },

package/neighbor-eslint-lit.mjs

@@ -0,0 +1,85 @@
+/**
+ * @a11yfred/neighbor  -  ESLint plugin (Lit)
+ *
+ * Flags Lit-specific accessibility issues like autofocus within html`...` templates.
+ *
+ * Usage in eslint.config.js:
+ *   import neighborLit from '@a11yfred/neighbor/lit'
+ *
+ *   export default [
+ *     {
+ *       files: ['**/*.ts', '**/*.js'],
+ *       plugins: { '@a11yfred/neighbor': neighborLit },
+ *       rules: neighborLit.configs.recommended.rules,
+ *     },
+ *   ]
+ */
+
+import { buildLitRules, buildLitRecommendedRules } from '@a11yfred/neighbor/lib/framework-rules.js'
+import { buildRecommendedRules, buildPortabilityRules } from '@a11yfred/neighbor/lib/rules.js'
+
+const NS = '@a11yfred/neighbor'
+const rules = buildLitRules()
+const plugin = { meta: { name: `${NS}/lit` }, rules }
+
+let litA11y = null
+try { litA11y = (await import('eslint-plugin-lit-a11y')).default } catch {}
+
+const LIT_A11Y_RULES = [
+  'accessible-emoji', 'alt-text', 'anchor-is-valid', 'aria-activedescendant-has-tabindex',
+  'aria-attr-valid-value', 'aria-attrs', 'aria-role', 'aria-unsupported-elements',
+  'click-events-have-key-events', 'heading-has-content', 'iframe-title',
+  'img-redundant-alt', 'mouse-events-have-key-events', 'no-access-key',
+  'no-autofocus', 'no-distracting-elements', 'no-redundant-role',
+  'role-has-required-aria-props', 'role-supports-aria-props', 'scope', 'tabindex-no-positive',
+  'valid-lang'
+]
+
+const UNLIKELY_LIT_RULES = new Set([
+  'accessible-emoji', 'no-autofocus', 'no-distracting-elements', 'no-redundant-role'
+])
+
+function getLitA11yRules(plugin) {
+  const out = {}
+  for (const rule of LIT_A11Y_RULES) {
+    if (plugin.rules?.[rule]) {
+      out[`lit-a11y/${rule}`] = UNLIKELY_LIT_RULES.has(rule) ? 'off' : 'error'
+    }
+  }
+  return out
+}
+
+const litRecommended = {
+  ...buildRecommendedRules(NS),
+  ...buildPortabilityRules(NS),
+  ...buildLitRecommendedRules(NS),
+}
+
+// Omit rules that are already covered by lit-a11y (if installed):
+if (litA11y) {
+  delete litRecommended[`${NS}/no-heading-no-content`] // covered by lit-a11y/heading-has-content
+  delete litRecommended[`${NS}/no-iframe-no-title`] // covered by lit-a11y/iframe-title
+  delete litRecommended[`${NS}/no-img-redundant-alt`] // covered by lit-a11y/img-redundant-alt
+  delete litRecommended[`${NS}/no-access-key`] // covered by lit-a11y/no-access-key
+  delete litRecommended[`${NS}/no-aria-activedescendant-no-tabindex`] // covered by lit-a11y/aria-activedescendant-has-tabindex
+  delete litRecommended[`${NS}/no-anchor-no-content`] // covered by lit-a11y/anchor-is-valid
+  delete litRecommended[`${NS}/no-invalid-aria-prop-value`] // covered by lit-a11y/aria-attr-valid-value
+  delete litRecommended[`${NS}/no-role-supports-aria-props`] // covered by lit-a11y/role-supports-aria-props
+  delete litRecommended[`${NS}/no-scope-on-td`] // covered by lit-a11y/scope
+}
+
+export default {
+  ...plugin,
+  configs: {
+    recommended: {
+      plugins: {
+        [NS]: plugin,
+        ...(litA11y ? { 'lit-a11y': litA11y } : {}),
+      },
+      rules: {
+        ...(litA11y ? getLitA11yRules(litA11y) : {}),
+        ...litRecommended,
+      },
+    },
+  },
+}

package/neighbor-eslint-remix3.mjs

@@ -0,0 +1,49 @@
+/**
+ * @a11yfred/neighbor  -  ESLint plugin (Remix 3)
+ *
+ * Flags the same ARIA anti-patterns as neighbor-eslint.mjs, plus specific
+ * ulam rules tailored for Remix (e.g., no-use-page-title-in-remix).
+ *
+ * Usage in eslint.config.js:
+ *   import neighbor from '@a11yfred/neighbor/remix3'
+ *
+ *   export default [
+ *     {
+ *       files: ['**/*.tsx', '**/*.jsx'],
+ *       plugins: { '@a11yfred/neighbor': neighbor },
+ *       rules: neighbor.configs.recommended.rules,
+ *     },
+ *   ]
+ */
+
+import { h } from '@a11yfred/neighbor/lib/helpers-jsx.js'
+import { buildRules, buildRecommendedRules, buildReactFrameworkRules } from '@a11yfred/neighbor/lib/rules.js'
+import { buildUlamRules, buildUlamRecommendedRules } from '@a11yfred/neighbor/lib/ulam-rules.js'
+import { buildRemixRules, buildRemixRecommendedRules } from '@a11yfred/neighbor/lib/framework-rules.js'
+
+const NS = '@a11yfred/neighbor'
+const rules = { ...buildRules(h), ...buildUlamRules(), ...buildRemixRules() }
+
+const plugin = { meta: { name: `${NS}/remix3` }, rules }
+
+let jsxA11y = null
+try { jsxA11y = (await import('eslint-plugin-jsx-a11y')).default } catch {}
+
+export default {
+  ...plugin,
+  configs: {
+    recommended: {
+      plugins: {
+        [NS]: plugin,
+        ...(jsxA11y ? { 'jsx-a11y': jsxA11y } : {}),
+      },
+      rules: {
+        ...(jsxA11y ? jsxA11y.configs.recommended.rules : {}),
+        ...buildRecommendedRules(NS),
+        ...buildUlamRecommendedRules(NS),
+        ...buildReactFrameworkRules(NS),
+        ...buildRemixRecommendedRules(NS),
+      },
+    },
+  },
+}

package/neighbor-eslint-vue.mjs

@@ -18,9 +18,9 @@
  *   ]
  */
 
-import { h } from './lib/helpers-vue.js'
-import { buildRules, buildRecommendedRules, buildPortabilityRules } from './lib/rules.js'
-import { buildUlamRulesVue, buildUlamRecommendedRulesFramework } from './lib/ulam-rules.js'
+import { h } from '@a11yfred/neighbor/lib/helpers-vue.js'
+import { buildRules, buildRecommendedRules, buildPortabilityRules, buildVueFrameworkRules } from '@a11yfred/neighbor/lib/rules.js'
+import { buildUlamRulesVue, buildUlamRecommendedRulesFramework } from '@a11yfred/neighbor/lib/ulam-rules.js'
 
 const NS = '@a11yfred/neighbor'
 const rules = { ...buildRules(h), ...buildUlamRulesVue() }
@@ -29,6 +29,24 @@ const plugin = { meta: { name: `${NS}/vue` }, rules }
 let vueA11y = null
 try { vueA11y = (await import('eslint-plugin-vuejs-accessibility')).default } catch {}
 
+const vueRecommended = {
+  ...buildRecommendedRules(NS),
+  ...buildPortabilityRules(NS),
+  ...buildUlamRecommendedRulesFramework(NS),
+  ...buildVueFrameworkRules(NS),
+}
+
+// Omit rules that are already covered by vuejs-accessibility (if installed):
+if (vueA11y) {
+  delete vueRecommended[`${NS}/no-heading-no-content`] // covered by vuejs-accessibility/heading-has-content
+  delete vueRecommended[`${NS}/no-iframe-no-title`] // covered by vuejs-accessibility/iframe-has-title
+  delete vueRecommended[`${NS}/no-access-key`] // covered by vuejs-accessibility/no-access-key
+  delete vueRecommended[`${NS}/no-img-redundant-alt`] // covered by vuejs-accessibility/alt-text
+  delete vueRecommended[`${NS}/no-anchor-no-content`] // covered by vuejs-accessibility/anchor-has-content
+  delete vueRecommended[`${NS}/no-invalid-aria-prop-value`] // covered by vuejs-accessibility/aria-props
+  delete vueRecommended[`${NS}/no-role-supports-aria-props`] // covered by vuejs-accessibility/aria-role
+}
+
 export default {
   ...plugin,
   configs: {
@@ -39,9 +57,11 @@ export default {
       },
       rules: {
         ...(vueA11y ? vueA11y.configs['flat/recommended'].rules : {}),
-        ...buildRecommendedRules(NS),
-        ...buildPortabilityRules(NS),
-        ...buildUlamRecommendedRulesFramework(NS),
+        'vuejs-accessibility/accessible-emoji': 'off',
+        'vuejs-accessibility/no-autofocus': 'off',
+        'vuejs-accessibility/no-distracting-elements': 'off',
+        'vuejs-accessibility/no-redundant-roles': 'off',
+        ...vueRecommended,
       },
     },
   },