fg-devkit 1.26.0 → 1.27.1

package/README.md

@@ -282,6 +282,28 @@ Set `PIWIK_CLIENT_ID` and `PIWIK_CLIENT_SECRET` in the environment, `.env.local`
 
 Session and event slots are assigned by Piwik as the next free number in that scope. The command creates one dimension at a time and stops if the returned slot is not the local slot. Deactivating a dimension does not free the slot. Product dimensions send the local slot (1–20).
 
+## Local fds-vue-core in a consuming repo
+
+Replaces the yalc flow. Clone `fds-vue-core` next to the consuming repo, then in the consuming repo:
+
+```bash
+pnpm exec fgd link-fds-vue-core          # or: link-fds-vue-core ../path/to/fds-vue-core
+```
+
+It builds `fds-vue-core`, sets the dependency to `file:../fds-vue-core` and runs `pnpm install`. pnpm copies the build into `node_modules` and resolves `vue` from the consuming repo, so there is one `vue` at runtime and in the types. The command keeps watching `fds-vue-core/src`: each change rebuilds, reinstalls and restarts a running Vite dev server. Ctrl+C stops watching; `--no-watch` links without watching.
+
+When `fds-vue-core` has a `build:assets` script, the watch uses `vite build --watch` plus `build:assets` instead of the full `pnpm build` (about 11 s instead of about 21 s per change). Types still come from `vite-plugin-dts`; only the extra `vue-tsc` type check is skipped, so a type error in `fds-vue-core` does not stop the update.
+
+To link several repos at once, run `link-fds-vue-core` in each. The first one watches; the others only join its list of linked repos (kept in `fds-vue-core/node_modules/.fg-devkit-linked-consumers.json`). One build then updates every linked repo.
+
+Before committing:
+
+```bash
+pnpm exec fgd unlink-fds-vue-core
+```
+
+This restores the version from the last commit. The shared Lefthook pre-commit hook runs `fgd check-local-links` and blocks commits where the staged `package.json` or `pnpm-lock.yaml` has a `file:` or `link:` dependency.
+
 ## Local development with pnpm link
 
 Use this flow to test local `fg-devkit` changes in a consuming repo.

package/configs/dependency-policy.vue-workspace.json

@@ -1,6 +1,6 @@
 {
   "toolchain": {
-    "packageManager": "pnpm@12.14.0",
+    "packageManager": "pnpm@12.15.0",
     "node": {
       "nvmrc": "22",
       "engines": ">=22.13.0",
@@ -13,49 +13,43 @@
       "@e965/xlsx": "0.20.3",
       "@element-plus/icons-vue": "2.3.2",
       "@lexical/html": "0.52.0",
+      "@lexical/link": "0.52.0",
       "@lexical/list": "0.52.0",
       "@lexical/rich-text": "0.52.0",
-      "@lexical/link": "0.52.0",
       "@piwikpro/vue-piwik-pro": "2.0.0",
-      "@sentry/vue": "11.8.0",
-      "@tanstack/vue-query": "5.104.5",
-      "@types/leaflet": "1.9.22",
-      "@unhead/vue": "2.0.5",
-      "@vue-leaflet/vue-leaflet": "0.10.1",
+      "@sentry/vue": "11.9.0",
+      "@tanstack/vue-query": "5.105.0",
+      "@unhead/vue": "3.4.3",
       "@vuelidate/core": "2.0.3",
       "@vuelidate/validators": "2.0.4",
-      "@vueuse/components": "12.7.0",
-      "@vueuse/core": "14.4.0",
-      "chart.js": "4.5.1",
+      "@vueuse/core": "15.0.0",
+      "axios": "1.20.0",
+      "chart.js": "4.6.1",
       "content-disposition-header": "0.6.0",
       "date-fns": "4.4.0",
       "element-plus": "2.14.7",
-      "fds-vue-core": "8.11.2",
+      "exceljs": "4.4.0",
+      "fds-vue-core": "8.11.5",
       "imask": "7.6.1",
-      "leaflet": "1.9.4",
       "lexical": "0.52.0",
+      "libphonenumber-js": "1.13.15",
       "lodash": "4.18.1",
       "lodash-es": "4.18.1",
+      "maplibre-gl": "6.16.0",
       "markdown-it": "15.0.3",
+      "personnummer": "3.3.1",
       "pinia": "4.1.0",
-      "playwright": "1.64.1",
+      "qrcode.vue": "3.11.0",
       "quill": "2.0.3",
-      "randexp": "0.6.1",
-      "register-service-worker": "1.7.2",
       "vega-embed": "7.3.0",
       "vega-lite": "6.5.0",
       "vue-chartjs": "5.3.4",
-      "vue-i18n": "11.4.16",
       "vue-quilly": "1.1.6",
-      "vue-router": "5.4.0",
       "vue3-touch-keyboard": "1.3.9",
-      "vuex": "4.1.0",
-      "vuex-persist": "3.1.3",
-      "yup": "1.7.1"
+      "vuex": "4.1.0"
     },
     "devDependencies": {
       "@chromatic-com/storybook": "5.6.0",
-      "@eslint/js": "9.39.1",
       "@intlify/unplugin-vue-i18n": "11.2.7",
       "@playwright/test": "1.64.1",
       "@storybook/addon-a11y": "10.6.3",
@@ -63,39 +57,38 @@
       "@storybook/addon-vitest": "10.6.3",
       "@storybook/vue3": "10.6.3",
       "@storybook/vue3-vite": "10.6.3",
-      "@tanstack/vue-query-devtools": "6.3.5",
-      "@tsconfig/node22": "22.0.6",
+      "@tanstack/vue-query-devtools": "6.3.6",
       "@types/lodash-es": "4.17.12",
-      "@types/node": "22.16.5",
+      "@types/node": "22.20.4",
+      "@vitejs/plugin-vue": "6.0.10",
       "@vitest/browser": "5.0.5",
+      "@vitest/browser-playwright": "5.0.5",
       "@vue/compiler-dom": "3.5.44",
-      "@vue/eslint-config-standard": "8.0.1",
-      "@vue/server-renderer": "3.5.44",
+      "@vue/language-core": "3.3.13",
       "@vue/test-utils": "2.5.1",
-      "arg": "5.0.2",
-      "babel-eslint": "10.1.0",
-      "eslint-plugin-storybook": "10.6.3",
-      "globals": "15.11.0",
+      "fg-devkit": "1.27.0",
+      "happy-dom": "21.0.4",
       "jsdom": "30.1.3",
+      "randexp": "0.6.1",
       "sass": "1.106.1",
       "storybook": "10.6.3",
-      "tsx": "4.23.15",
       "vega": "6.4.0",
+      "vite": "8.3.5",
       "vite-plugin-dts": "5.1.2",
       "vite-plugin-vue-devtools": "8.2.1",
       "vite-plugin-vue-inspector": "7.0.0",
-      "vitest": "5.0.5",
-      "yaml": "2.9.1"
+      "vitest": "5.0.5"
     }
   },
   "managedAnywhere": {
     "@tailwindcss/vite": "4.3.3",
-    "@vitejs/plugin-vue": "6.0.10",
-    "axios": "1.20.0",
-    "dotenv": "18.0.8",
-    "qrcode.vue": "3.11.0",
+    "@vue/devtools-api": "8.2.1",
+    "dotenv": "18.0.9",
+    "playwright": "1.64.1",
     "tailwindcss": "4.3.3",
-    "vite": "8.3.5",
-    "vue": "3.5.44"
-  }
+    "vue": "3.5.44",
+    "vue-i18n": "11.4.16",
+    "vue-router": "5.4.0"
+  },
+  "overrides": {}
 }

package/configs/lefthook.yml

@@ -4,3 +4,5 @@ pre-commit:
       run: zsh -lc "node ./node_modules/fg-devkit/scripts/fg-devkit.mjs lint ."
     typecheck:
       run: zsh -lc "node ./node_modules/fg-devkit/scripts/fg-devkit.mjs typecheck"
+    local-links:
+      run: zsh -lc "node ./node_modules/fg-devkit/scripts/fg-devkit.mjs check-local-links"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fg-devkit",
-  "version": "1.26.0",
+  "version": "1.27.1",
   "description": "Shared configs, scripts, and DX tooling for Vue / TypeScript frontend repos",
   "type": "module",
   "license": "UNLICENSED",
@@ -54,13 +54,13 @@
     "@intlify/eslint-plugin-vue-i18n": "4.5.1",
     "@typescript-eslint/eslint-plugin": "8.72.0",
     "@typescript-eslint/parser": "8.72.0",
-    "@vitest/eslint-plugin": "1.6.27",
+    "@vitest/eslint-plugin": "1.6.28",
     "@vue/eslint-config-prettier": "10.2.0",
     "eslint": "10.13.0",
     "eslint-plugin-prettier": "5.5.7",
     "eslint-plugin-vue": "10.11.1",
     "eslint-plugin-vuejs-accessibility": "2.6.3",
-    "fallow": "3.34.1",
+    "fallow": "3.36.0",
     "git-cliff": "2.14.2",
     "lefthook": "2.2.2",
     "npm-check-updates": "23.1.1",

package/scaffold/vue/package.json

@@ -16,12 +16,12 @@
   },
   "dependencies": {
     "@tailwindcss/vite": "4.3.3",
-    "@tanstack/vue-query": "5.104.5",
+    "@tanstack/vue-query": "5.105.0",
     "axios": "1.20.0",
     "content-disposition-header": "0.6.0",
     "date-fns": "4.4.0",
-    "dotenv": "18.0.8",
-    "fds-vue-core": "8.11.2",
+    "dotenv": "18.0.9",
+    "fds-vue-core": "8.11.5",
     "pinia": "4.1.0",
     "qrcode.vue": "3.11.0",
     "vue": "3.5.44",
@@ -30,16 +30,16 @@
   },
   "devDependencies": {
     "@intlify/unplugin-vue-i18n": "11.2.7",
-    "@tanstack/vue-query-devtools": "6.3.5",
-    "@types/node": "22.16.5",
-    "fg-devkit": "1.26.0",
+    "@tanstack/vue-query-devtools": "6.3.6",
+    "@types/node": "22.20.4",
+    "fg-devkit": "1.27.1",
     "@vitejs/plugin-vue": "6.0.10",
     "tailwindcss": "4.3.3",
     "tsx": "4.23.15",
     "vite": "8.3.5",
     "vite-plugin-vue-inspector": "7.0.0"
   },
-  "packageManager": "pnpm@12.14.0",
+  "packageManager": "pnpm@12.15.0",
   "engines": {
     "node": ">=22.13.0"
   }

package/scripts/fg-devkit.mjs

@@ -25,6 +25,9 @@
  *   pnpm exec fg-devkit sync-vscode-settings
  *   pnpm exec fg-devkit sync-consumer-scripts
  *   pnpm exec fg-devkit setup-lefthook
+ *   pnpm exec fg-devkit link-fds-vue-core [path] [--no-watch]
+ *   pnpm exec fg-devkit unlink-fds-vue-core
+ *   pnpm exec fg-devkit check-local-links
  *   pnpm exec fg-devkit full-consumer-setup
  *   pnpm exec fg-devkit create-release [release|candidate] [patch|minor|major] [--skip-release-notes]
  *   pnpm exec fg-devkit generate-release-notes [--tag=vX.Y.Z]
@@ -614,6 +617,10 @@ Commands:
   sync-vite-plugin-vue-inspector  Add/pin vite-plugin-vue-inspector, wire vite.config, install, commit
   sync-consumer-scripts           Enforce standard fgd scripts in consumer package.json
   setup-lefthook                  Write lefthook.yml and install the git hooks
+  link-fds-vue-core [path] [--no-watch]
+                                 Use a local fds-vue-core checkout (default ../fds-vue-core) and rebuild it on changes
+  unlink-fds-vue-core             Go back to the fds-vue-core version from the last commit
+  check-local-links               Fail when staged package.json or pnpm-lock.yaml has a file: or link: dependency
   setup-ai-rules [--plugins=a,b]  Pick the fg-ai-rules Claude Code plugins for this repo, install them once per machine, commit
   full-consumer-setup             Run: scripts -> lefthook -> step 3 -> step 2 -> pnpm install -> AI rules
   create-release [release|candidate] [patch|minor|major] [--skip-release-notes]
@@ -717,6 +724,7 @@ async function runInteractiveMenu() {
       description: 'Overwrite shared config files with the versions in fg-devkit',
     },
     { name: 'Setup', value: 'setup', description: 'Git hooks and first-time setup of a repo' },
+    { name: 'Local dev fds-vue-core', value: 'local-fds-vue-core', description: 'Develop against a local fds-vue-core checkout' },
     {
       name: 'Dead code (Fallow)',
       value: 'fallow-dead-code',
@@ -1150,6 +1158,25 @@ async function runInteractiveMenu() {
       return runSelectedAction(() => (choice === 'lefthook' ? runSetupLefthook() : runFullConsumerSetup()))
     }
 
+    if (group === 'local-fds-vue-core') {
+      const choice = await selectPrompt({
+        message: 'Local dev fds-vue-core',
+        choices: [
+          {
+            name: 'Link and watch',
+            value: 'link',
+            description: 'Use ../fds-vue-core and rebuild it when its src changes',
+          },
+          { name: 'Unlink', value: 'unlink', description: 'Go back to the fds-vue-core version from the last commit' },
+          { name: 'Cancel', value: 'cancel' },
+        ],
+        default: 'link',
+        loop: false,
+      })
+      if (choice === 'cancel') continue
+      return runSelectedAction(() => runNode('link-fds-vue-core.mjs', [choice]))
+    }
+
     if (group === 'fallow-dead-code') {
       return runSelectedAction(() => runBundledFallow(['dead-code']))
     }
@@ -1305,6 +1332,18 @@ async function main() {
       process.exitCode = await runCommit(rest)
       return
     }
+    if (sub === 'link-fds-vue-core') {
+      process.exitCode = runNode('link-fds-vue-core.mjs', ['link', ...rest])
+      return
+    }
+    if (sub === 'unlink-fds-vue-core') {
+      process.exitCode = runNode('link-fds-vue-core.mjs', ['unlink'])
+      return
+    }
+    if (sub === 'check-local-links') {
+      process.exitCode = runNode('link-fds-vue-core.mjs', ['check'])
+      return
+    }
     if (sub === 'scaffold-vue') {
       process.exitCode = runNode('scaffold-vue.mjs', rest)
       return

package/scripts/lib/vite-build-watch.mjs

@@ -0,0 +1,13 @@
+import { createRequire } from 'node:module'
+import path from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+const require = createRequire(path.join(process.cwd(), 'package.json'))
+const { build } = await import(pathToFileURL(require.resolve('vite')).href)
+
+const watcher = await build({ build: { watch: {} } })
+watcher.on('event', (event) => {
+  if (event.code === 'END') process.send?.({ type: 'built' })
+  if (event.code === 'ERROR') process.send?.({ type: 'failed' })
+  event.result?.close?.()
+})

package/scripts/link-fds-vue-core.mjs

@@ -0,0 +1,285 @@
+#!/usr/bin/env node
+/**
+ * Develops fds-vue-core locally inside one or more consumer repos, without yalc.
+ *
+ * link [path] [--no-watch]
+ *   Points the consumer's fds-vue-core dependency at a local checkout (default ../fds-vue-core) with
+ *   file: and runs pnpm install. pnpm copies the package into node_modules and resolves vue from the
+ *   consumer, so runtime and types use one vue. The consumer is added to the checkout's list of
+ *   linked repos (node_modules/.fg-devkit-linked-consumers.json in fds-vue-core).
+ *   Then watches fds-vue-core: on each change it rebuilds once, reinstalls in every linked repo and
+ *   restarts their running Vite dev servers (clears node_modules/.vite and touches vite.config.*).
+ *   When fds-vue-core has a build:assets script, the watch runs vite build --watch (types come from
+ *   vite-plugin-dts) plus build:assets instead of the full pnpm build, which skips the vue-tsc type check.
+ *   When another link is already watching the same checkout, this repo is only added to the list and
+ *   that watcher updates it too. Ctrl+C stops watching; the links stay until unlink.
+ * unlink
+ *   Restores the fds-vue-core version from the last commit (HEAD:package.json), runs pnpm install and
+ *   removes the repo from the checkout's list of linked repos.
+ * check
+ *   Fails when the staged package.json or pnpm-lock.yaml contains a file: or link: dependency.
+ *   Used by the shared lefthook pre-commit hook.
+ *
+ * Usage:
+ *   pnpm exec fg-devkit link-fds-vue-core [path] [--no-watch]
+ *   pnpm exec fg-devkit unlink-fds-vue-core
+ *   pnpm exec fg-devkit check-local-links
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { spawnSync, spawn, fork } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+
+const PACKAGE_NAME = 'fds-vue-core'
+const DEPENDENCY_FIELDS = ['dependencies', 'devDependencies']
+const VITE_CONFIG_CANDIDATES = ['vite.config.ts', 'vite.config.mts', 'vite.config.js', 'vite.config.mjs']
+const LOCAL_SPEC_PATTERN = /^(file|link):/
+const LINKED_CONSUMERS_FILE = '.fg-devkit-linked-consumers.json'
+const WATCHER_PID_FILE = '.fg-devkit-link-watcher.pid'
+
+const cwd = process.cwd()
+const scriptDirectory = path.dirname(fileURLToPath(import.meta.url))
+
+function fail(message) {
+  console.error(`[link-fds-vue-core] ${message}`)
+  process.exit(1)
+}
+
+function log(message) {
+  console.log(`[link-fds-vue-core] ${message}`)
+}
+
+function runSync(command, args, runCwd) {
+  const result = spawnSync(command, args, { stdio: 'inherit', cwd: runCwd })
+  return result.status === 0
+}
+
+function readPackageJson(consumerPath) {
+  const packageJsonPath = path.join(consumerPath, 'package.json')
+  if (!fs.existsSync(packageJsonPath)) return null
+  return JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'))
+}
+
+function findDependencyField(packageJson) {
+  return DEPENDENCY_FIELDS.find((name) => packageJson?.[name]?.[PACKAGE_NAME])
+}
+
+function requireDependencyField(consumerPath) {
+  const field = findDependencyField(readPackageJson(consumerPath))
+  if (!field) fail(`${PACKAGE_NAME} is not a dependency in ${path.join(consumerPath, 'package.json')}`)
+  return field
+}
+
+function setDependencySpec(consumerPath, spec) {
+  const packageJson = readPackageJson(consumerPath)
+  packageJson[findDependencyField(packageJson)][PACKAGE_NAME] = spec
+  fs.writeFileSync(path.join(consumerPath, 'package.json'), `${JSON.stringify(packageJson, null, 2)}\n`, 'utf8')
+}
+
+function linkedLibraryPath(consumerPath) {
+  const packageJson = readPackageJson(consumerPath)
+  const spec = packageJson?.[findDependencyField(packageJson)]?.[PACKAGE_NAME]
+  if (!spec?.startsWith('file:')) return null
+  return path.resolve(consumerPath, spec.slice('file:'.length))
+}
+
+function linkedConsumersPath(libraryPath) {
+  return path.join(libraryPath, 'node_modules', LINKED_CONSUMERS_FILE)
+}
+
+function readLinkedConsumers(libraryPath) {
+  try {
+    return JSON.parse(fs.readFileSync(linkedConsumersPath(libraryPath), 'utf8'))
+  } catch {
+    return []
+  }
+}
+
+function writeLinkedConsumers(libraryPath, consumers) {
+  fs.mkdirSync(path.join(libraryPath, 'node_modules'), { recursive: true })
+  fs.writeFileSync(linkedConsumersPath(libraryPath), `${JSON.stringify(consumers, null, 2)}\n`, 'utf8')
+}
+
+function currentLinkedConsumers(libraryPath) {
+  const consumers = readLinkedConsumers(libraryPath).filter(
+    (consumerPath) => linkedLibraryPath(consumerPath) === libraryPath,
+  )
+  writeLinkedConsumers(libraryPath, consumers)
+  return consumers
+}
+
+function watcherPidPath(libraryPath) {
+  return path.join(libraryPath, 'node_modules', WATCHER_PID_FILE)
+}
+
+function isWatcherRunning(libraryPath) {
+  try {
+    process.kill(Number(fs.readFileSync(watcherPidPath(libraryPath), 'utf8')), 0)
+    return true
+  } catch {
+    return false
+  }
+}
+
+function restartViteDevServer(consumerPath) {
+  fs.rmSync(path.join(consumerPath, 'node_modules', '.vite'), { recursive: true, force: true })
+  const viteConfig = VITE_CONFIG_CANDIDATES.map((name) => path.join(consumerPath, name)).find((file) =>
+    fs.existsSync(file),
+  )
+  if (!viteConfig) return
+  const now = new Date()
+  fs.utimesSync(viteConfig, now, now)
+}
+
+function installInConsumer(consumerPath) {
+  if (!runSync('pnpm', ['install'], consumerPath)) {
+    console.error(`[link-fds-vue-core] pnpm install failed in ${consumerPath}.`)
+    return false
+  }
+  restartViteDevServer(consumerPath)
+  return true
+}
+
+function updateLinkedConsumers(libraryPath) {
+  const consumers = currentLinkedConsumers(libraryPath)
+  const updated = consumers.filter((consumerPath) => installInConsumer(consumerPath))
+  log(`Updated ${updated.length} of ${consumers.length} linked repos: ${updated.map((consumerPath) => path.basename(consumerPath)).join(', ') || 'none'}.`)
+}
+
+function hasBuildAssetsScript(libraryPath) {
+  return Boolean(readPackageJson(libraryPath).scripts?.['build:assets'])
+}
+
+function watchWithViteBuildWatch(libraryPath) {
+  const child = fork(path.join(scriptDirectory, 'lib', 'vite-build-watch.mjs'), [], { cwd: libraryPath })
+  child.on('message', (message) => {
+    if (message.type !== 'built') {
+      console.error('[link-fds-vue-core] Build failed; waiting for the next change.')
+      return
+    }
+    if (!runSync('pnpm', ['run', 'build:assets'], libraryPath)) {
+      console.error('[link-fds-vue-core] build:assets failed; waiting for the next change.')
+      return
+    }
+    updateLinkedConsumers(libraryPath)
+  })
+  child.on('exit', (code) => process.exit(code ?? 1))
+  log(`Watching ${libraryPath} with vite build --watch for all linked repos. Press Ctrl+C to stop (the links stay until unlink-fds-vue-core).`)
+}
+
+function watchWithFullBuild(libraryPath) {
+  const sourcePath = path.join(libraryPath, 'src')
+  let timer = null
+  let building = false
+  let changedWhileBuilding = false
+
+  const rebuild = () => {
+    if (building) {
+      changedWhileBuilding = true
+      return
+    }
+    building = true
+    const child = spawn('pnpm', ['build'], { stdio: 'inherit', cwd: libraryPath })
+    child.on('close', (code) => {
+      if (code === 0) {
+        updateLinkedConsumers(libraryPath)
+      } else {
+        console.error('[link-fds-vue-core] Build failed; waiting for the next change.')
+      }
+      building = false
+      if (changedWhileBuilding) {
+        changedWhileBuilding = false
+        rebuild()
+      }
+    })
+  }
+
+  fs.watch(sourcePath, { recursive: true }, () => {
+    clearTimeout(timer)
+    timer = setTimeout(rebuild, 300)
+  })
+  log(`Watching ${sourcePath} for all linked repos. Press Ctrl+C to stop (the links stay until unlink-fds-vue-core).`)
+}
+
+function startWatching(libraryPath, useViteBuildWatch) {
+  fs.writeFileSync(watcherPidPath(libraryPath), String(process.pid), 'utf8')
+  process.on('exit', () => fs.rmSync(watcherPidPath(libraryPath), { force: true }))
+  process.on('SIGINT', () => process.exit(0))
+  process.on('SIGTERM', () => process.exit(0))
+  if (useViteBuildWatch) watchWithViteBuildWatch(libraryPath)
+  else watchWithFullBuild(libraryPath)
+}
+
+function link(args) {
+  const pathArgument = args.find((argument) => !argument.startsWith('--'))
+  const libraryPath = path.resolve(cwd, pathArgument ?? path.join('..', PACKAGE_NAME))
+  const libraryPackageJson = readPackageJson(libraryPath)
+  if (!libraryPackageJson) fail(`No package.json at ${libraryPath}`)
+  if (libraryPackageJson.name !== PACKAGE_NAME) fail(`${libraryPath} is not ${PACKAGE_NAME}`)
+  if (libraryPath === cwd) fail(`Run this in a repo that uses ${PACKAGE_NAME}, not in ${PACKAGE_NAME} itself.`)
+
+  requireDependencyField(cwd)
+  const watcherRunning = isWatcherRunning(libraryPath)
+  const watch = !watcherRunning && !args.includes('--no-watch')
+  const useViteBuildWatch = watch && hasBuildAssetsScript(libraryPath)
+  if (!watcherRunning && !useViteBuildWatch) {
+    log(`Building ${libraryPath}...`)
+    if (!runSync('pnpm', ['build'], libraryPath)) fail('Build failed.')
+  }
+
+  setDependencySpec(cwd, `file:${path.relative(cwd, libraryPath)}`)
+  writeLinkedConsumers(libraryPath, [...new Set([...currentLinkedConsumers(libraryPath), cwd])])
+  if (!useViteBuildWatch && !installInConsumer(cwd)) process.exit(1)
+  log(`${PACKAGE_NAME} is linked to ${libraryPath}. Run unlink-fds-vue-core before you commit.`)
+
+  if (watcherRunning) {
+    log('Another link-fds-vue-core is already watching this checkout; it updates this repo too.')
+    return
+  }
+  if (watch) startWatching(libraryPath, useViteBuildWatch)
+}
+
+function unlink() {
+  const field = requireDependencyField(cwd)
+  const libraryPath = linkedLibraryPath(cwd)
+  const head = spawnSync('git', ['show', 'HEAD:package.json'], { cwd, encoding: 'utf8' })
+  if (head.status !== 0) fail('Could not read package.json from the last commit.')
+  const committedSpec = JSON.parse(head.stdout)[field]?.[PACKAGE_NAME]
+  if (!committedSpec || LOCAL_SPEC_PATTERN.test(committedSpec)) {
+    fail(`The last commit has no published ${PACKAGE_NAME} version in ${field}; set it in package.json by hand.`)
+  }
+  setDependencySpec(cwd, committedSpec)
+  if (libraryPath) currentLinkedConsumers(libraryPath)
+  if (!installInConsumer(cwd)) process.exit(1)
+  log(`${PACKAGE_NAME} is back on ${committedSpec}.`)
+}
+
+function readStagedFile(file) {
+  const result = spawnSync('git', ['show', `:${file}`], { cwd, encoding: 'utf8' })
+  return result.status === 0 ? result.stdout : ''
+}
+
+function check() {
+  const stagedPackageJson = readStagedFile('package.json')
+  const packageJson = stagedPackageJson ? JSON.parse(stagedPackageJson) : {}
+  const localDependencies = [...DEPENDENCY_FIELDS, 'optionalDependencies'].flatMap((field) =>
+    Object.entries(packageJson[field] ?? {})
+      .filter(([, spec]) => LOCAL_SPEC_PATTERN.test(spec))
+      .map(([name, spec]) => `${name}: ${spec}`),
+  )
+  const lockfileHasLocalDependency = /specifier: (file|link):/.test(readStagedFile('pnpm-lock.yaml'))
+  if (localDependencies.length === 0 && !lockfileHasLocalDependency) return
+
+  console.error('[check-local-links] Local dependency links are staged for commit:')
+  for (const dependency of localDependencies) console.error(`  ${dependency}`)
+  if (lockfileHasLocalDependency) console.error('  pnpm-lock.yaml has a file: or link: specifier')
+  console.error('[check-local-links] Run: pnpm exec fgd unlink-fds-vue-core (or git commit --no-verify for WIP).')
+  process.exit(1)
+}
+
+const [command, ...args] = process.argv.slice(2)
+if (command === 'link') link(args)
+else if (command === 'unlink') unlink()
+else if (command === 'check') check()
+else fail('Usage: link-fds-vue-core.mjs <link [path] [--no-watch] | unlink | check>')