@anzusystems/common-admin 1.49.0 → 2.0.0-rc.1

package/package.json

@@ -1,26 +1,41 @@
 {
   "name": "@anzusystems/common-admin",
-  "packageManager": "yarn@4.18.0",
+  "packageManager": "yarn@4.18.1",
   "files": [
     "dist",
-    "src/eslint"
+    "src/eslint/**",
+    "src/vite/**"
+  ],
+  "module": "./dist/common-admin.js",
+  "sideEffects": [
+    "**/*.css"
   ],
-  "module": "./dist/common-admin.es.js",
   "types": "./dist/common-admin.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/common-admin.js",
-      "types": "./dist/common-admin.d.ts"
+      "types": "./dist/common-admin.d.ts",
+      "import": "./dist/common-admin.js"
+    },
+    "./styles": {
+      "types": "./dist/common-admin.css.d.ts",
+      "default": "./dist/common-admin.css"
+    },
+    "./eslint": {
+      "types": "./src/eslint/plugin.d.mts",
+      "default": "./src/eslint/plugin.mjs"
     },
-    "./styles": "./dist/common-admin.css",
-    "./labs": {
-      "import": "./dist/labs.js",
-      "types": "./dist/labs.d.ts"
+    "./oxlint": "./src/eslint/oxlint.mjs",
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
     },
-    "./eslint": "./src/eslint/plugin.mjs",
-    "./*": "./*"
+    "./vite": {
+      "types": "./src/vite/index.d.mts",
+      "default": "./src/vite/index.mjs"
+    },
+    "./package.json": "./package.json"
   },
-  "version": "1.49.0",
+  "version": "2.0.0-rc.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -28,138 +43,164 @@
   },
   "scripts": {
     "prepare": "node -e \"if (process.env.SKIP_PLAYWRIGHT_INSTALL !== 'true') { require('child_process').execSync('playwright install chromium --with-deps', { stdio: 'inherit' }) }\"",
-    "docs:dev": "vitepress dev docs",
-    "docs:build-only": "vitepress build docs",
-    "docs:build": "yarn build ; yarn docs:build-only",
-    "docs:preview": "vitepress preview docs",
     "playground:dev": "vite",
     "playground:build": "vite build",
     "playground:build:nm": "vite build --minify false",
-    "build": "vite build --config vite.config.lib.ts",
-    "build:dev": "vite build --minify false --sourcemap true --config vite.config.lib.ts",
-    "lib:build": "vite build --config vite.config.lib.ts",
-    "ci": "run-s --print-name lint:tsc lint:oxlint lint:eslint lint:stylelint",
+    "build": "vite build --config vite.config.lib.mts",
+    "dev:admin": "COMMON_ADMIN_DTS=0 COMMON_ADMIN_DEV_BUNDLE=1 vite build --watch --config vite.config.lib.mts --outDir node_modules/.cache/common-admin-dev --emptyOutDir --logLevel warn",
+    "dev:admin:types": "COMMON_ADMIN_COPY=types vite build --config vite.config.lib.mts --logLevel warn",
+    "build:dev": "vite build --minify false --sourcemap true --config vite.config.lib.mts",
+    "lib:build": "run-s --print-name lint:tsc build",
+    "ci": "run-p --aggregate-output --continue-on-error --print-label --silent lint:tsc format:check lint:oxlint lint:eslint lint:stylelint",
     "lint": "[ \"$*\" = \"--fix\" ] && yarn lint:fix || yarn ci",
-    "lint:fix": "run-s --print-name lint:tsc format lint:oxlint:fix lint:eslint:fix lint:stylelint:fix",
+    "lint:fix": "run-s --print-name lint:tsc lint:oxlint:fix lint:eslint:fix lint:stylelint:fix format",
     "lint:tsc": "NODE_OPTIONS=--max-old-space-size=4096 vue-tsc --build",
     "lint:tsc:test": "NODE_OPTIONS=--max-old-space-size=4096 vue-tsc --build tsconfig.test.json",
     "lint:eslint": "eslint",
     "lint:eslint:fix": "eslint --fix",
-    "lint:oxlint": "oxlint .",
-    "lint:oxlint:fix": "oxlint . --fix",
+    "lint:oxlint": "oxlint . --disable-nested-config",
+    "lint:oxlint:fix": "oxlint . --fix --disable-nested-config",
     "lint:stylelint": "stylelint src/**/*.{scss,vue}",
     "lint:stylelint:fix": "stylelint src/**/*.{scss,vue} --fix",
-    "format": "oxfmt src/",
-    "format:check": "oxfmt src/ --check",
+    "format": "oxfmt --disable-nested-config src vite.config.lib.mts vite.config.mts vitest.config.mts eslint.config.mjs",
+    "format:check": "oxfmt --disable-nested-config src vite.config.lib.mts vite.config.mts vitest.config.mts eslint.config.mjs --check",
     "test": "vitest",
-    "test:run": "vitest run",
-    "test:ui": "vitest --ui"
+    "test:browser": "vitest run",
+    "test:eslint": "vitest run --config vitest.config.node.mts",
+    "test:run": "run-s --print-name test:browser test:eslint",
+    "test:ui": "vitest --ui",
+    "release:start": "npx -y --allow-git=all github:anzusystems/release-tools#main start",
+    "release:publish": "npx -y --allow-git=all github:anzusystems/release-tools#main publish",
+    "release:cleanup": "npx -y --allow-git=all github:anzusystems/release-tools#main cleanup"
   },
   "devDependencies": {
-    "@anzusystems/common-admin": "workspace:*",
-    "@intlify/unplugin-vue-i18n": "^11.2.5",
-    "@kyvg/vue3-notification": "^3.4.2",
+    "@anzusystems/common-admin": "2.0.0-rc.1",
+    "@intlify/unplugin-vue-i18n": "^11.2.7",
     "@mdi/font": "^7.4.47",
-    "@microsoft/api-extractor": "^7.59.0",
-    "@sentry/vue": "^10.73.0",
-    "@shikijs/vitepress-twoslash": "^4.4.3",
-    "@stylistic/eslint-plugin": "^5.10.0",
+    "@sentry/vite-plugin": "11.8.0",
+    "@sentry/vue": "^11.8.0",
     "@tsconfig/node22": "^22.0.6",
-    "@types/node": "^24.13.3",
+    "@types/node": "^24.19.2",
     "@types/rusha": "^0.8.3",
     "@types/sortablejs": "^1.15.9",
-    "@types/webfontloader": "^1.6.38",
-    "@vitejs/plugin-vue": "^6.0.8",
-    "@vitest/browser": "^4.1.11",
-    "@vitest/browser-playwright": "^4.1.11",
-    "@vitest/ui": "^4.1.11",
-    "@vue/compiler-dom": "3.5.42",
+    "@typescript-eslint/parser": "^8.72.0",
+    "@vitejs/plugin-vue": "^6.0.10",
+    "@vitest/browser": "^5.0.5",
+    "@vitest/browser-playwright": "^5.0.5",
+    "@vitest/ui": "^5.0.5",
+    "@vue/compiler-dom": "3.5.44",
     "@vue/devtools-api": "^8.2.1",
     "@vue/eslint-config-typescript": "^14.9.0",
-    "@vue/language-server": "3.3.11",
-    "@vue/test-utils": "^2.5.0",
+    "@vue/language-server": "3.3.13",
+    "@vue/test-utils": "^2.5.1",
     "@vue/tsconfig": "0.9.1",
     "@vuelidate/core": "^2.0.3",
     "@vuelidate/validators": "^2.0.4",
-    "@vueuse/core": "14.4.0",
-    "@vueuse/integrations": "14.4.0",
+    "@vueuse/core": "15.0.0",
+    "@vueuse/integrations": "15.0.0",
+    "@vueuse/shared": "15.0.0",
     "axios": "1.20.0",
-    "cropperjs": "^1.6.3",
+    "cropperjs2": "npm:cropperjs@2.2.0",
     "dayjs": "1.11.23",
-    "eslint": "^10.9.1",
-    "eslint-plugin-oxlint": "1.80.0",
-    "eslint-plugin-vue": "10.10.0",
-    "eslint-plugin-vuetify": "^2.7.2",
+    "eslint": "^10.13.0",
+    "eslint-plugin-oxlint": "1.89.0",
+    "eslint-plugin-pinia": "^0.4.2",
+    "eslint-plugin-vue": "10.11.1",
+    "eslint-plugin-vuetify": "^2.7.3",
     "npm-run-all2": "^9.0.3",
-    "oxfmt": "^0.65.0",
-    "oxlint": "1.80.0",
-    "pinia": "4.0.3",
-    "playwright": "^1.62.1",
-    "postcss": "^8.5.26",
+    "oxfmt": "^0.74.0",
+    "oxlint": "1.89.0",
+    "pinia": "4.1.0",
+    "playwright": "^1.64.1",
+    "postcss": "^8.5.31",
     "postcss-html": "^2.0.0",
-    "postcss-prefix-selector": "^2.2.0",
     "rusha": "^0.8.14",
-    "sass": "1.103.1",
-    "socket.io-client": "4.8.3",
+    "sass": "1.105.2",
+    "socket.io-client": "4.8.4",
     "sortablejs": "^1.15.7",
-    "stylelint": "17.14.1",
+    "stylelint": "17.16.0",
     "stylelint-config-html": "^2.0.0",
     "stylelint-config-recommended": "^18.0.0",
     "stylelint-config-recommended-vue": "^2.0.0",
     "stylelint-config-standard-scss": "^17.0.0",
-    "typescript": "5.9.3",
-    "unplugin": "3.3.0",
-    "unplugin-dts": "^1.1.0",
-    "uuid": "^14.0.2",
-    "vite": "7.3.6",
+    "typescript": "~6.0.3",
+    "unplugin": "3.4.0",
+    "unplugin-dts": "^1.1.2",
+    "uuid": "^14.0.3",
+    "vite": "8.3.4",
     "vite-plugin-vuetify": "^2.1.3",
-    "vitepress": "1.6.4",
-    "vitest": "^4.1.11",
-    "vue": "3.5.42",
+    "vitest": "^5.0.5",
+    "vue": "3.5.44",
     "vue-eslint-parser": "^10.4.1",
-    "vue-i18n": "11.4.10",
-    "vue-router": "5.3.0",
-    "vue-tsc": "3.3.11",
-    "vuetify": "4.1.12",
-    "webfontloader": "^1.6.28"
+    "vue-i18n": "11.4.16",
+    "vue-router": "5.4.0",
+    "vue-tsc": "3.3.13",
+    "vuetify": "4.3.0"
   },
   "peerDependencies": {
-    "@sentry/vue": "^10.0.0",
+    "@mdi/font": "^7.4.47",
+    "@sentry/vite-plugin": "^11.8.0",
+    "@sentry/vue": "^11.8.0",
+    "@vue/eslint-config-typescript": "^14.9.0",
     "@vuelidate/core": "^2.0.3",
     "@vuelidate/validators": "^2.0.4",
-    "@vueuse/core": "^14.1.0",
-    "@vueuse/integrations": "^14.1.0",
-    "axios": "^1.13.4",
-    "dayjs": "^1.11.19",
-    "pinia": "^4.0.2",
-    "socket.io-client": "^4.8.3",
-    "unplugin": "^3.0.0",
-    "vue": "^3.5.27",
-    "vue-i18n": "^11.2.8",
-    "vue-router": "^5.0.1",
-    "vuetify": "^4.0.0"
+    "@vueuse/core": "^15.0.0",
+    "@vueuse/integrations": "^15.0.0",
+    "@vueuse/shared": "^15.0.0",
+    "axios": "^1.20.0",
+    "dayjs": "^1.11.23",
+    "eslint": "^10.13.0",
+    "eslint-plugin-oxlint": "^1.89.0",
+    "eslint-plugin-pinia": "^0.4.2",
+    "eslint-plugin-vue": "^10.11.1",
+    "eslint-plugin-vuetify": "^2.7.3",
+    "oxlint": "^1.89.0",
+    "pinia": "^4.1.0",
+    "socket.io-client": "^4.8.4",
+    "sortablejs": "^1.15.7",
+    "vite": "^8.3.4",
+    "vitest": "^5.0.5",
+    "vue": "^3.5.44",
+    "vue-i18n": "^11.4.16",
+    "vue-router": "^5.4.0",
+    "vuetify": "^4.3.0"
   },
   "peerDependenciesMeta": {
-    "@sentry/vue": {
+    "@sentry/vite-plugin": {
+      "optional": true
+    },
+    "@vue/eslint-config-typescript": {
       "optional": true
     },
-    "@vueuse/core": {
+    "@vueuse/shared": {
       "optional": true
     },
-    "@vueuse/integrations": {
+    "eslint": {
       "optional": true
     },
-    "axios": {
+    "eslint-plugin-oxlint": {
       "optional": true
     },
-    "dayjs": {
+    "eslint-plugin-pinia": {
+      "optional": true
+    },
+    "eslint-plugin-vue": {
+      "optional": true
+    },
+    "eslint-plugin-vuetify": {
+      "optional": true
+    },
+    "oxlint": {
       "optional": true
     },
     "socket.io-client": {
       "optional": true
     },
-    "vue-router": {
+    "vite": {
+      "optional": true
+    },
+    "vitest": {
       "optional": true
     }
   }
-}
+}

package/src/eslint/adminConfig.mjs

@@ -0,0 +1,253 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { createRequire } from 'node:module'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { globalComponentNames } from './globalComponentNames.mjs'
+import { recommended } from './plugin.mjs'
+
+// The target `import` resolves to in an `exports` entry: the first key, in the object's own order, that
+// is one of the conditions an import in node matches. `require.resolve` would take the `require` branch,
+// the CommonJS build, a different module from the one the admin's own `import` gets.
+const IMPORT_CONDITIONS = new Set(['import', 'node', 'module-sync', 'default'])
+const importTarget = (entry) => {
+  if (typeof entry === 'string') return entry
+  if (Array.isArray(entry)) return entry.map(importTarget).find(Boolean)
+  if (!entry || typeof entry !== 'object') return undefined
+  if (Object.keys(entry).some((key) => key.startsWith('.'))) return importTarget(entry['.'])
+  for (const [condition, target] of Object.entries(entry)) {
+    if (IMPORT_CONDITIONS.has(condition)) {
+      const resolved = importTarget(target)
+      if (resolved) return resolved
+    }
+  }
+  return undefined
+}
+
+// Resolved from the admin, not from this file: the admin declares these plugins, and under pnpm the
+// library's own directory cannot see its consumer's packages. The package's directory is looked up
+// rather than its entry resolved, so a package that only has an `import` entry is found as well.
+const packageDir = (require, name) => {
+  for (const base of require.resolve.paths(name) ?? []) {
+    const dir = path.join(base, name)
+    if (fs.existsSync(path.join(dir, 'package.json'))) return fs.realpathSync(dir)
+  }
+  return undefined
+}
+
+const loader = (root) => {
+  const require = createRequire(root)
+  return (name) => {
+    const dir = packageDir(require, name)
+    const exports = dir ? JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf-8')).exports : undefined
+    const target = exports === undefined ? undefined : importTarget(exports)
+    return import(pathToFileURL(target ? path.join(dir, target) : require.resolve(name)).href)
+  }
+}
+
+// The component names in the admin's installed Vuetify, for `vue/no-undef-components`: registered by
+// vite-plugin-vuetify, never imported, so the rule cannot see them otherwise.
+const vuetifyComponents = (root) => {
+  try {
+    const content = fs.readFileSync(new URL('./node_modules/vuetify/dist/vuetify.d.ts', root), 'utf-8')
+    const match = content.match(/interface GlobalComponents \{([\s\S]*?)\}/)
+    return match?.[1] ? Array.from(match[1].matchAll(/^\s+([V][a-zA-Z0-9]+):/gm), (m) => m[1]) : []
+  } catch (e) {
+    console.error('Error reading vuetify.d.ts', e)
+    return []
+  }
+}
+
+const routeNameSeverity = (value) => (value === false || value === 'off' ? 'off' : value === 'warn' ? 'warn' : 'error')
+
+/**
+ * The whole eslint config of an admin, which each of them used to carry as a copy.
+ *
+ * `root` is the admin's `import.meta.url` (of its eslint.config.mjs): the plugins, Vuetify's component
+ * list, `.oxlintrc.json` and `src/typed-router.d.ts` are all resolved against it, never against the
+ * cwd -- an eslint run started from a subdirectory would otherwise lose the oxlint-disabled rules and
+ * check route names against nothing. `extra` configs come last.
+ *
+ * @param {import('./plugin.d.mts').AnzuAdminEslintOptions} options
+ * @param {...import('eslint').Linter.Config} extra
+ */
+export async function defineAnzuAdminConfig(options, ...extra) {
+  const {
+    root,
+    oxlintConfig = '.oxlintrc.json',
+    typedRouter = 'src/typed-router.d.ts',
+    globalComponents = [],
+    ignores = [],
+    noExplicitAny = 'error',
+    anzu = {},
+    vueProject = {},
+  } = options
+  // A plain path is read as the path of the config file, like `import.meta.url` is.
+  const rootUrl = String(root).startsWith('file:') ? String(root) : pathToFileURL(String(root)).href
+  const load = loader(rootUrl)
+  const { configureVueProject, defineConfigWithVueTs, vueTsConfigs } = await load('@vue/eslint-config-typescript')
+  // Its `.vue` scan for type-aware rules starts at the admin's root rather than the cwd.
+  configureVueProject({ rootDir: fileURLToPath(new URL('.', rootUrl)), ...vueProject })
+  const plugin = async (name) => {
+    const module = await load(name)
+    return module.default ?? module
+  }
+  const pluginVue = await plugin('eslint-plugin-vue')
+  const pluginPinia = await plugin('eslint-plugin-pinia')
+  const vuetify = await plugin('eslint-plugin-vuetify')
+  const oxlint = oxlintConfig ? await plugin('eslint-plugin-oxlint') : null
+
+  return defineConfigWithVueTs(
+    {
+      name: 'app/files-to-lint',
+      files: ['**/*.{ts,mts,tsx,vue}'],
+    },
+    {
+      name: 'app/files-to-ignore',
+      ignores: [
+        '**/dist/**',
+        '**/dist-ssr/**',
+        '**/coverage/**',
+        '.stylelintrc.js',
+        '**/e2e/**',
+        'src/typed-router.d.ts',
+        ...ignores,
+      ],
+    },
+    pluginVue.configs['flat/essential'],
+    pluginVue.configs['flat/strongly-recommended'],
+    pluginVue.configs['flat/recommended'],
+    vueTsConfigs.recommended,
+    {
+      name: 'app/pinia',
+      plugins: {
+        pinia: pluginPinia,
+      },
+      rules: {
+        'pinia/never-export-initialized-store': 'error',
+        'pinia/no-duplicate-store-ids': 'error',
+        'pinia/no-return-global-properties': 'error',
+        'pinia/no-store-to-refs-in-store': 'error',
+        'pinia/prefer-single-store-per-file': 'error',
+        'pinia/prefer-use-store-naming-convention': 'error',
+        'pinia/require-setup-store-properties-export': 'error',
+      },
+    },
+    recommended(anzu),
+    {
+      name: 'app/rules',
+      settings: {
+        anzu: { typedRouter: fileURLToPath(new URL(typedRouter, rootUrl)) },
+      },
+      rules: {
+        'anzu/valid-route-name': routeNameSeverity(anzu.validRouteName),
+        '@typescript-eslint/ban-ts-comment': 'off',
+        '@typescript-eslint/no-explicit-any': noExplicitAny,
+        '@typescript-eslint/no-empty-interface': 'off',
+        '@typescript-eslint/no-empty-object-type': 'off',
+        '@typescript-eslint/no-unused-expressions': 'off',
+        '@typescript-eslint/no-unused-vars': [
+          'error',
+          {
+            caughtErrors: 'none',
+          },
+        ],
+        'vue/multi-word-component-names': [
+          'error',
+          {
+            ignores: ['Acl'],
+          },
+        ],
+        'vue/valid-v-slot': ['error', { allowModifiers: true }],
+        'vue/no-undef-components': [
+          'error',
+          {
+            // Registered globally rather than imported, so the rule cannot see them: the Vuetify
+            // components, common-admin's button aliases and `Acl`, the router's, and the admin's own.
+            ignorePatterns: [
+              ...vuetifyComponents(rootUrl),
+              ...globalComponentNames,
+              'RouterLink',
+              'RouterView',
+              ...globalComponents,
+            ],
+          },
+        ],
+        'vue/attribute-hyphenation': ['error', 'always'],
+        'vue/v-on-event-hyphenation': ['error', 'always'],
+        'vue/custom-event-name-casing': ['error', 'camelCase'],
+        'vue/define-emits-declaration': ['error', 'type-based'],
+        'vue/no-template-target-blank': ['error'],
+        'vue/block-order': ['error', { order: [['script', 'template'], 'style'] }],
+        'vue/define-macros-order': ['error'],
+        'vue/component-name-in-template-casing': ['error'],
+        'vue/component-api-style': ['error'],
+        'vue/prefer-define-options': ['error'],
+        'vue/no-setup-props-reactivity-loss': ['error'],
+        'vue/no-ref-object-reactivity-loss': ['error'],
+      },
+    },
+    {
+      name: 'app/no-relative-imports',
+      files: ['src/**/*.{ts,vue}'],
+      rules: {
+        'no-restricted-imports': [
+          'error',
+          {
+            patterns: [
+              {
+                group: ['../*', './*'],
+                message: 'Use absolute imports with @ instead of relative imports',
+              },
+            ],
+          },
+        ],
+      },
+    },
+    {
+      // File-based routing names these files, not us: `index.vue`, `new.vue`, `edit.vue`.
+      name: 'app/file-based-routing',
+      files: ['src/pages/**/*.vue'],
+      rules: {
+        'vue/multi-word-component-names': 'off',
+      },
+    },
+    {
+      name: 'app/test-files',
+      files: ['**/*.test.{ts,js}', '**/*.spec.{ts,js}', '**/test/**/*.{ts,js}'],
+      rules: {
+        '@typescript-eslint/no-explicit-any': 'off',
+        '@typescript-eslint/no-non-null-assertion': 'off',
+        'vue/one-component-per-file': 'off',
+      },
+    },
+    ...vuetify.configs['flat/recommended-v4'],
+    // Derives the disabled-rule list from the oxlint config, so a rule enabled there stops being run
+    // twice. prefer-const is switched off in the shared oxlint rules on purpose, so that it stays
+    // eslint's: oxlint does not run it inside a .vue at all.
+    ...(oxlint ? await oxlint.buildFromOxlintConfigFile(fileURLToPath(new URL(oxlintConfig, rootUrl))) : []),
+    {
+      // The only eslint rules that fight oxfmt. Measured, not assumed: with this block removed, eslint
+      // reports 85 warnings in an admin and 145 in common-admin, and in both they fall on these same
+      // rules and no others.
+      //
+      // html-self-closing is configured rather than switched off, because only its `void` half
+      // conflicts: oxfmt writes `<img />` where the rule's default demands `<img>`. With
+      // `void: 'any'` the formatter keeps that half and eslint keeps `<VBtn></VBtn>`.
+      name: 'app/owned-by-oxfmt',
+      rules: {
+        'vue/html-closing-bracket-newline': 'off',
+        'vue/html-indent': 'off',
+        'vue/singleline-html-element-content-newline': 'off',
+        'vue/html-self-closing': [
+          'error',
+          {
+            html: { void: 'any', normal: 'always', component: 'always' },
+            svg: 'always',
+            math: 'always',
+          },
+        ],
+      },
+    },
+    ...extra
+  )
+}

package/src/eslint/globalComponentNames.d.mts

@@ -0,0 +1,9 @@
+/** The components the library registers globally: for the `ignorePatterns` of `vue/no-undef-components`. */
+export declare const globalComponentNames: readonly [
+  'ABtnPrimary',
+  'ABtnSecondary',
+  'ABtnTertiary',
+  'ABtnIcon',
+  'AChipNoLink',
+  'Acl',
+]

package/src/eslint/globalComponentNames.mjs

@@ -0,0 +1,15 @@
+// Its own module, without the preset's node imports: a browser test imports it as well.
+/**
+ * The components the library registers globally -- the button aliases of its Vuetify config and the
+ * plugin's `Acl` and `AChipNoLink` -- for the `ignorePatterns` of `vue/no-undef-components`. Kept equal to the
+ * registrations (and to `CommonAdminGlobalComponents`) by a test. Admins used to read the aliases out
+ * of the rolled-up declarations with a regex, which the per-module declarations no longer allow.
+ */
+export const globalComponentNames = Object.freeze([
+  'ABtnPrimary',
+  'ABtnSecondary',
+  'ABtnTertiary',
+  'ABtnIcon',
+  'AChipNoLink',
+  'Acl',
+])

package/src/eslint/oxlint-admin.json

@@ -0,0 +1,45 @@
+{
+  // The oxlint rules the admins share; an admin's .oxlintrc.json extends it and keeps its own env,
+  // categories and ignorePatterns (oxlint merges only rules, plugins and overrides from `extends`, and
+  // eslint-plugin-oxlint follows `extends` the same way).
+  "plugins": ["eslint", "typescript", "unicorn", "oxc", "vue", "import"],
+  "rules": {
+    "no-unused-vars": ["error", { "caughtErrors": "none" }],
+    "no-unused-expressions": "off",
+
+    "no-var": "error",
+    "prefer-rest-params": "error",
+    "prefer-spread": "error",
+    "typescript/no-array-constructor": "error",
+    "typescript/no-namespace": "error",
+    "typescript/no-require-imports": "error",
+    "typescript/no-unnecessary-type-constraint": "error",
+    "typescript/no-unsafe-function-type": "error",
+    "vue/component-definition-name-casing": "error",
+    "vue/no-multiple-slot-args": "error",
+    "vue/no-required-prop-with-default": "error",
+    "vue/prop-name-casing": "error",
+    "vue/require-default-prop": "error",
+    "vue/require-prop-types": "error",
+    "vue/require-typed-ref": "error",
+
+    // oxlint does not run prefer-const inside a .vue file at all, so handing it over
+    // would switch it off for every SFC. Left to eslint, which does both.
+    "prefer-const": "off",
+
+    // Enabled here, so that eslint stops running its copies: it had to while the imports were implicit.
+    "vue/no-async-in-computed-properties": "error",
+    "vue/no-side-effects-in-computed-properties": "error",
+    "vue/return-in-computed-property": "error",
+    "vue/no-lifecycle-after-await": "error",
+    "vue/no-watch-after-await": "error",
+
+    // Imports: oxfmt sorts the statements (`sortImports` in .oxfmtrc.json); these sort the names
+    // inside the braces, merge two imports of one module and keep types in their own `import type`.
+    "sort-imports": ["error", { "ignoreDeclarationSort": true }],
+    "import/no-duplicates": ["error", { "considerQueryString": true }],
+    "import/consistent-type-specifier-style": ["error", "prefer-top-level"],
+    // Reads `@/typed-router.d.ts?raw` in the route tests as a module without a default export.
+    "import/default": "off"
+  }
+}

package/src/eslint/oxlint.mjs

@@ -0,0 +1,28 @@
+import { anzuPlugin } from './plugin.mjs'
+
+/**
+ * Oxlint entry point for the Anzu rules.
+ *
+ * The rules operate on the standard ESTree AST, so oxlint runs them through its
+ * JS plugin bridge with output identical to ESLint - including .vue <script>
+ * blocks, scope analysis and autofix.
+ *
+ * Usage in .oxlintrc.json:
+ *
+ *   {
+ *     "jsPlugins": ["@anzusystems/common-admin/oxlint"],
+ *     "rules": {
+ *       "anzu/no-ts-extension": "error",
+ *       "anzu/url-params-match-template": "error"
+ *     }
+ *   }
+ *
+ * When these are enabled here, turn them off in eslint.config.mjs - oxlint's
+ * `buildFromOxlintConfigFile` does not know about third-party rule names.
+ *
+ * NOTE: oxlint JS plugins are alpha and not subject to semver.
+ */
+export default {
+  meta: { name: 'anzu' },
+  rules: anzuPlugin.rules,
+}