fg-devkit 1.0.0 → 1.1.2

package/README.md

@@ -4,10 +4,66 @@ Shared settings and tools to improve the developer experience for Vue and TypeSc
 
 ## Quick command alias (zsh)
 
-To run `fg` instead of `pnpm exec fg`, add this alias:
+To run `fgd` instead of `pnpm exec fg-devkit`, add this alias:
 
 ```bash
-echo "alias fg='pnpm exec fg'" >> ~/.zshrc && source ~/.zshrc
+echo "alias fgd='pnpm exec fg-devkit'" >> ~/.zshrc && source ~/.zshrc
 ```
 
 This works in repos where `fg-devkit` is installed.
+
+## Bundled ESLint stack
+
+`fg-devkit` ships its own ESLint stack (core + parser + plugins), so consuming repos do not need to install ESLint packages just to lint with the shared config.
+
+Run lint via CLI:
+
+```bash
+pnpm exec fgd lint .
+pnpm exec fgd lint-fix .
+```
+
+## Bundled Prettier
+
+`fg-devkit` also ships Prettier, so consuming repos can format using the bundled package.
+
+Run formatting via CLI:
+
+```bash
+pnpm exec fgd format
+pnpm exec fgd format-check
+```
+
+## Bundled TypeScript
+
+`fg-devkit` ships `vue-tsc` and `typescript`, so consuming repos can run Vue typecheck without installing local TS tooling.
+
+Run typecheck via CLI:
+
+```bash
+pnpm exec fgd typecheck
+pnpm exec fgd typecheck-watch
+```
+
+## tsconfig in consuming repos
+
+Use `fgd sync-project-configs` (or `fgd sync-tooling-configs`) to write the local `tsconfig.json` template from `fg-devkit`.
+
+Do not use an extends-only `tsconfig.json` to `fg-devkit/tsconfig.app.sync.json` in consuming repos.
+TypeScript resolves `include`/`exclude` relative to the extended config file location in `node_modules`,
+which can cause `No inputs were found`.
+
+The supported approach is: keep a local `tsconfig.json` file in each consuming repo and let sync overwrite
+it with the shared app template.
+
+## Minimal local Prettier config for consuming repos
+
+Use this as your local `prettier.config.js` to inherit defaults from `fg-devkit`:
+
+```js
+import basePrettierConfig from 'fg-devkit/prettier.config.js'
+
+export default {
+  ...basePrettierConfig,
+}
+```

package/configs/eslint.config.base.js

@@ -3,8 +3,10 @@
 
 import tseslint from '@typescript-eslint/eslint-plugin'
 import tsparser from '@typescript-eslint/parser'
+import pluginI18n from '@intlify/eslint-plugin-vue-i18n'
 import pluginVitest from '@vitest/eslint-plugin'
 import skipFormatting from '@vue/eslint-config-prettier/skip-formatting'
+import pluginPrettier from 'eslint-plugin-prettier'
 import pluginVue from 'eslint-plugin-vue'
 import { globalIgnores } from 'eslint/config'
 import vueParser from 'vue-eslint-parser'
@@ -23,9 +25,6 @@ export default function createBaseConfig(options = {}) {
     additionalSettings = {},
   } = options
 
-  // Note: Optional plugins should be imported by the consuming project
-  // This config accepts them via additionalPlugins option
-
   const defaultAdditionalIgnores = [
     'test-results/**',
     'playwright-report/**',
@@ -130,6 +129,8 @@ export default function createBaseConfig(options = {}) {
       files: ['**/*.vue', '**/*.js', '**/*.jsx', '**/*.cjs', '**/*.mjs', '**/*.ts', '**/*.tsx', '**/*.cts', '**/*.mts'],
       plugins: {
         '@typescript-eslint': tseslint,
+        ...(enablePrettier ? { prettier: pluginPrettier } : {}),
+        ...(enableI18n ? { '@intlify/vue-i18n': pluginI18n } : {}),
         ...additionalPlugins,
       },
       settings: {
@@ -172,12 +173,13 @@ export default function createBaseConfig(options = {}) {
         'no-useless-return': 'error',
         'no-useless-concat': 'error',
         '@typescript-eslint/no-unused-vars': [
-          'error',
+          'warn',
           {
             argsIgnorePattern: '^_',
             varsIgnorePattern: '^_',
           },
         ],
+        'padding-line-between-statements': ['error', { blankLine: 'always', prev: 'export', next: 'export' }],
         '@typescript-eslint/ban-ts-comment': 'off',
         '@typescript-eslint/explicit-function-return-type': 'off',
         '@typescript-eslint/no-var-requires': 'off',
@@ -197,9 +199,9 @@ export default function createBaseConfig(options = {}) {
         'eol-last': 'error',
         'no-lonely-if': 'error',
         // Prettier integration (if enabled and plugin provided)
-        ...(enablePrettier && additionalPlugins.prettier ? { 'prettier/prettier': 'warn' } : {}),
+        ...(enablePrettier ? { 'prettier/prettier': 'warn' } : {}),
         // i18n rules (if enabled and plugin provided)
-        ...(enableI18n && additionalPlugins['@intlify/vue-i18n']
+        ...(enableI18n
           ? {
               '@intlify/vue-i18n/no-missing-keys': 'error',
               '@intlify/vue-i18n/no-raw-text': [

package/configs/eslint.sync-stub.js

@@ -1,7 +1,6 @@
 /**
- * Minimal ESLint flat config for apps using fg-devkit.
- * Copied to eslint.config.js by sync-tooling-configs / sync-project-configs.
- * Customize locally (plugins, rules) or pass options via createBaseConfig after syncing.
+ * ESLint sync template for Vue apps using fg-devkit.
+ * Mirrors the previously used project defaults so sync preserves current behavior.
  */
 import createBaseConfig from 'fg-devkit/eslint.config.base.js'
 import { fileURLToPath } from 'node:url'
@@ -9,11 +8,12 @@ import { fileURLToPath } from 'node:url'
 const tsconfigRootDir = fileURLToPath(new URL('.', import.meta.url))
 
 export default [
-  {
-    ignores: ['.yalc/**', '**/node_modules/**'],
-  },
   ...createBaseConfig({
     tsconfigRootDir,
     tsconfigFiles: ['./tsconfig.json'],
+    extraNonTypeAwareFiles: ['playwright.config.ts', 'poeditor/**/*.ts'],
+    enablePrettier: true,
+    enableI18n: true,
+    i18nLocaleDir: './src/lang/*.json',
   }),
 ]

package/configs/prettier.sync-stub.js

@@ -0,0 +1,6 @@
+// Extend shared Prettier config from fg-devkit
+import basePrettierConfig from 'fg-devkit/prettier.config.js'
+
+export default {
+  ...basePrettierConfig,
+}

package/configs/tsconfig.app.sync.json

@@ -1,38 +1,14 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
   "extends": "fg-devkit/tsconfig.base.json",
-  "include": [
-    "env.d.ts",
-    "src/**/*",
-    "src/**/*.vue",
-    "src/**/*.ts",
-    "src/**/*.d.ts",
-    "src/vuex.d.ts"
-  ],
+  "include": ["env.d.ts", "src/**/*", "src/**/*.vue", "src/**/*.ts", "src/**/*.d.ts", "src/vuex.d.ts"],
   "exclude": ["src/**/__tests__/*"],
   "compilerOptions": {
-    "strict": true,
-    "composite": true,
-    "noEmit": true,
     "types": ["@intlify/unplugin-vue-i18n/messages", "vue-i18n", "vite/client"],
-    "moduleResolution": "bundler",
-    "resolvePackageJsonExports": true,
     "paths": {
       "@/*": ["./src/*"],
       "@intlify/*": ["./node_modules/@intlify/*"]
     },
-    "baseUrl": ".",
-    "allowJs": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "skipLibCheck": true,
-    "preserveSymlinks": false
-  },
-  "vueCompilerOptions": {
-    "strictTemplates": true,
-    "experimentalCompatMode": 2,
-    "types": ["fds-vue-core"]
+    "baseUrl": "."
   }
 }

package/configs/tsconfig.base.json

@@ -1,18 +1,26 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
-  "extends": "@vue/tsconfig/tsconfig.dom.json",
+  "extends": "./tsconfig.vue-dom.json",
   "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "moduleResolution": "bundler",
+    "resolvePackageJsonExports": true,
+    "noEmit": true,
+    "composite": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,
     "allowJs": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
     "noUnusedLocals": true,
     "noUnusedParameters": true,
-    "paths": {
-      "@/*": ["./src/*"]
-    }
+    "preserveSymlinks": false
   },
   "vueCompilerOptions": {
     "strictTemplates": true,
+    "experimentalCompatMode": 2,
     "types": ["fds-vue-core"]
   }
 }

package/configs/tsconfig.vue-base.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "noEmit": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
+    "moduleDetection": "force",
+    "jsx": "preserve",
+    "jsxImportSource": "vue",
+    "noImplicitThis": true,
+    "strict": true,
+    "verbatimModuleSyntax": true,
+    "target": "ESNext",
+    "useDefineForClassFields": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "libReplacement": false,
+    "skipLibCheck": true
+  }
+}

package/configs/tsconfig.vue-dom.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.vue-base.json",
+  "compilerOptions": {
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "types": []
+  }
+}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "fg-devkit",
-  "version": "1.0.0",
+  "version": "1.1.2",
   "description": "Shared configs, scripts, and DX tooling for Vue / TypeScript frontend repos",
   "type": "module",
   "license": "UNLICENSED",
   "bin": {
-    "fg": "./scripts/fg-devkit.mjs",
+    "fgd": "./scripts/fg-devkit.mjs",
     "fg-devkit": "./scripts/fg-devkit.mjs",
     "fg-vuln-commit": "./scripts/vuln-commit.mjs",
     "fds-vuln-commit": "./scripts/vuln-commit.mjs"
@@ -48,20 +48,25 @@
     "typescript",
     "vue"
   ],
-  "peerDependencies": {
-    "@typescript-eslint/eslint-plugin": "^8.57.0",
-    "@typescript-eslint/parser": "^8.57.0",
-    "@vitest/eslint-plugin": "^1.5.0",
-    "@vue/eslint-config-prettier": "^10.0.0",
-    "@vue/tsconfig": "^0.8.0",
-    "eslint": "^9.0.0 || ^10.0.0",
-    "eslint-plugin-vue": "^10.0.0",
-    "typescript": ">=5.0.0",
-    "vue-eslint-parser": "^10.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@vitest/eslint-plugin": {
-      "optional": true
+  "config": {
+    "commitizen": {
+      "path": "./scripts/cz/cz-adapter.cjs"
     }
+  },
+  "dependencies": {
+    "@intlify/eslint-plugin-vue-i18n": "4.3.0",
+    "@typescript-eslint/eslint-plugin": "8.58.2",
+    "@typescript-eslint/parser": "8.58.2",
+    "@vitest/eslint-plugin": "1.6.16",
+    "@vue/eslint-config-prettier": "10.2.0",
+    "@vue/tsconfig": "0.9.1",
+    "commitizen": "4.3.1",
+    "eslint": "10.2.1",
+    "eslint-plugin-prettier": "5.5.5",
+    "eslint-plugin-vue": "10.8.0",
+    "prettier": "3.8.3",
+    "typescript": "5.9.3",
+    "vue-eslint-parser": "10.4.0",
+    "vue-tsc": "3.2.7"
   }
 }

package/scripts/cz/cz-adapter.cjs

@@ -4,6 +4,7 @@
  */
 module.exports = {
   prompter(cz, commit) {
+    const defaultType = process.env.FG_DEVKIT_CZ_DEFAULT_TYPE;
     const types = [
       { value: "feat", name: "feat(scope): Added" },
       { value: "fix", name: "fix(scope): Fixed" },
@@ -22,6 +23,7 @@ module.exports = {
         name: "change_type",
         message: "Select the type of change you are committing",
         choices: types,
+        default: defaultType && types.some((t) => t.value === defaultType) ? defaultType : undefined,
       },
       {
         type: "input",

package/scripts/fg-devkit.mjs

@@ -5,12 +5,18 @@
  * Non-interactive (for scripts and automation):
  *   pnpm exec fg-devkit check-deps [policy-file]
  *   pnpm exec fg-devkit sync-deps [policy-file]
- *   pnpm exec fg-devkit sync-project-configs   (VS Code + Prettier + ESLint stub + tsconfig app template)
- *   pnpm exec fg-devkit sync-tooling-configs   (Prettier + ESLint stub + tsconfig app template only)
+ *   pnpm exec fg-devkit sync-project-configs   (VS Code + tooling sync; overwrites config files)
+ *   pnpm exec fg-devkit sync-tooling-configs   (tooling sync only; overwrites config files)
  *   pnpm exec fg-devkit sync-vscode-settings
  *   pnpm exec fg-devkit create-release [patch|minor|major]
- *   pnpm exec fg-devkit commit [cz-args...]   (Commitizen; uses package.json config.commitizen.path)
+ *   pnpm exec fg-devkit commit [cz-args...]   (Commitizen; uses fg-devkit bundled cz adapter)
  *   pnpm exec fg-devkit commit-vuln           (staged package.json version bumps → vuln() commit)
+ *   pnpm exec fg-devkit lint [eslint-args...]     (run ESLint with fg-devkit bundled packages)
+ *   pnpm exec fg-devkit lint-fix [eslint-args...] (same as lint plus --fix)
+ *   pnpm exec fg-devkit format [prettier-args...] (run Prettier with fg-devkit bundled package)
+ *   pnpm exec fg-devkit format-check [prettier-args...] (same as format plus --check)
+ *   pnpm exec fg-devkit typecheck [vue-tsc-args...]   (run vue-tsc with fg-devkit bundled package)
+ *   pnpm exec fg-devkit typecheck-watch [vue-tsc-args...] (same as typecheck plus --watch)
  * Interactive menu (no subcommand):
  *   pnpm exec fg-devkit
  *
@@ -24,8 +30,10 @@ import readline from 'node:readline/promises'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { stdin as input, stdout as output } from 'node:process'
+import { createRequire } from 'node:module'
 
 const scriptDir = path.dirname(fileURLToPath(import.meta.url))
+const require = createRequire(import.meta.url)
 
 /** Run another script in this package via Node; inherits stdio and returns the child exit code. */
 function runNode(scriptRelative, args = [], options = {}) {
@@ -68,37 +76,140 @@ function runReleaseScript(args = []) {
   return r.status ?? 1
 }
 
+/** Prompt release type in CLI before invoking release.sh to avoid a "stuck" terminal feeling. */
+async function promptReleaseType(rl) {
+  console.log('\nSelect release type:')
+  console.log('  1) patch')
+  console.log('  2) minor')
+  console.log('  3) major')
+  console.log('  0) Cancel\n')
+  const choice = (await rl.question('Release type [1-3] (default: 1): ')).trim() || '1'
+  if (choice === '0') {
+    return null
+  }
+  if (choice === '1') {
+    return 'patch'
+  }
+  if (choice === '2') {
+    return 'minor'
+  }
+  if (choice === '3') {
+    return 'major'
+  }
+  console.error('[fg-devkit] Invalid release type selection.')
+  return null
+}
+
 /**
- * Run Commitizen in the consumer repo (reads config.commitizen.path from package.json).
- * Tries pnpm exec cz, then pnpm exec git-cz, then npx commitizen git-cz.
+ * Run Commitizen from fg-devkit's bundled dependency set.
+ * Always forces fg-devkit's bundled cz adapter so it stays interactive.
  */
-function runCommitizen(args = []) {
-  const cwd = process.cwd()
-  const attempts = [
-    () => spawnSync('pnpm', ['exec', 'cz', ...args], { stdio: 'inherit', cwd, env: process.env }),
-    () => spawnSync('pnpm', ['exec', 'git-cz', ...args], { stdio: 'inherit', cwd, env: process.env }),
-    () =>
-      spawnSync('npx', ['--yes', 'commitizen', 'git-cz', ...args], {
-        stdio: 'inherit',
-        cwd,
-        env: process.env,
-      }),
-  ]
-  for (const run of attempts) {
-    const r = run()
-    if (r.error) {
-      if (r.error.code === 'ENOENT') {
-        continue
-      }
-      console.error('[fg-devkit]', r.error.message)
-      return 1
-    }
-    return r.status ?? 1
+function runCommitizen(args = [], extraEnv = {}) {
+  let bootstrapBin
+  let commitizenPkgDir
+  const adapterPath = path.join(scriptDir, 'cz', 'cz-adapter.cjs')
+  try {
+    bootstrapBin = require.resolve('commitizen/dist/cli/git-cz.js')
+    commitizenPkgDir = path.dirname(require.resolve('commitizen/package.json'))
+  } catch {
+    console.error('[fg-devkit] Could not resolve bundled commitizen. Reinstall fg-devkit and retry.')
+    return 1
+  }
+
+  const launcher = `
+const { bootstrap } = require(${JSON.stringify(bootstrapBin)});
+const argv = ['node', 'git-cz', ...JSON.parse(process.env.FG_DEVKIT_CZ_ARGS || '[]')];
+bootstrap(
+  {
+    cliPath: ${JSON.stringify(commitizenPkgDir)},
+    config: { path: ${JSON.stringify(adapterPath)} },
+  },
+  argv
+);
+`
+
+  const r = spawnSync(process.execPath, ['-e', launcher], {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: {
+      ...process.env,
+      FG_DEVKIT_CZ_ARGS: JSON.stringify(args),
+      ...extraEnv,
+    },
+  })
+  if (r.error) {
+    console.error('[fg-devkit]', r.error.message)
+    return 1
+  }
+  return r.status ?? 1
+}
+
+
+/** Run ESLint from fg-devkit's bundled dependency set. */
+function runBundledEslint(args = []) {
+  let eslintBin
+  try {
+    const eslintPkgPath = require.resolve('eslint/package.json')
+    eslintBin = path.join(path.dirname(eslintPkgPath), 'bin', 'eslint.js')
+  } catch {
+    console.error('[fg-devkit] Could not resolve bundled eslint. Reinstall fg-devkit and retry.')
+    return 1
+  }
+
+  const r = spawnSync(process.execPath, [eslintBin, ...args], {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: process.env,
+  })
+  if (r.error) {
+    console.error('[fg-devkit]', r.error.message)
+    return 1
+  }
+  return r.status ?? 1
+}
+
+/** Run Prettier from fg-devkit's bundled dependency set. */
+function runBundledPrettier(args = []) {
+  let prettierBin
+  try {
+    prettierBin = require.resolve('prettier/bin/prettier.cjs')
+  } catch {
+    console.error('[fg-devkit] Could not resolve bundled prettier. Reinstall fg-devkit and retry.')
+    return 1
   }
-  console.error(
-    '[fg-devkit] Commitizen not found. Add devDependency "commitizen", set config.commitizen.path, then retry.',
-  )
-  return 1
+
+  const r = spawnSync(process.execPath, [prettierBin, ...args], {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: process.env,
+  })
+  if (r.error) {
+    console.error('[fg-devkit]', r.error.message)
+    return 1
+  }
+  return r.status ?? 1
+}
+
+/** Run vue-tsc from fg-devkit's bundled dependency set. */
+function runBundledTypeScript(args = []) {
+  let vueTscBin
+  try {
+    vueTscBin = require.resolve('vue-tsc/bin/vue-tsc.js')
+  } catch {
+    console.error('[fg-devkit] Could not resolve bundled vue-tsc. Reinstall fg-devkit and retry.')
+    return 1
+  }
+
+  const r = spawnSync(process.execPath, [vueTscBin, ...args], {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: process.env,
+  })
+  if (r.error) {
+    console.error('[fg-devkit]', r.error.message)
+    return 1
+  }
+  return r.status ?? 1
 }
 
 /** Map subcommand name → script file (extra argv after subcommand is forwarded). */
@@ -117,13 +228,19 @@ function printHelp() {
 Commands:
   check-deps [policy-file]        Validate package.json + pins against policy
   sync-deps [policy-file]         Align declared versions to policy (existing keys only)
-  sync-project-configs            VS Code settings + Prettier + ESLint + tsconfig (app template)
-  sync-tooling-configs            Prettier + ESLint + tsconfig (app template; no VS Code)
+  sync-project-configs            VS Code + tooling sync (overwrites config files)
+  sync-tooling-configs            Tooling sync only (overwrites config files)
   sync-vscode-settings            Copy shared VS Code settings into .vscode/settings.json
   create-release [bump]         Version bump, git push, GitHub release (patch|minor|major; omit = prompt)
                                  (alias: createRelease)
-  commit [args...]              Commitizen (git-cz); uses config.commitizen.path in package.json
+  commit [args...]              Commitizen (git-cz) with fg-devkit bundled adapter
   commit-vuln                   Commit staged dependency bumps as vuln() (alias: vuln-commit)
+  lint [eslint-args...]         Run ESLint using fg-devkit bundled ESLint stack
+  lint-fix [eslint-args...]     Run ESLint with --fix using fg-devkit bundled ESLint stack
+  format [prettier-args...]     Run Prettier using fg-devkit bundled package
+  format-check [prettier-args...] Run Prettier with --check using fg-devkit bundled package
+  typecheck [vue-tsc-args...]       Run vue-tsc using fg-devkit bundled package
+  typecheck-watch [vue-tsc-args...] Run vue-tsc with --watch using fg-devkit bundled package
 
 With no command, opens an interactive menu.
 
@@ -135,33 +252,33 @@ Options:
 const MENU = [
   {
     key: '1',
-    label: 'Check dependency policy against package.json (check-deps)',
+    label: 'Check dependency policy',
     run: () => runNode('check-dependency-policy.mjs'),
   },
   {
     key: '2',
-    label: 'Sync dependency versions from policy (sync-deps)',
+    label: 'Sync dependency policy',
     run: () => runNode('sync-dependency-policy.mjs'),
   },
   {
     key: '3',
-    label: 'Sync project configs (VS Code + Prettier + ESLint + tsconfig app template)',
+    label: 'Sync configs (vscode, eslint, prettier, tsconfig)',
     run: () => runNode('sync-project-configs.mjs'),
   },
   {
     key: '4',
-    label: 'Create release (version bump, push, gh release — run from package repo root)',
+    label: 'Create release',
     run: () => runReleaseScript(),
   },
   {
     key: '5',
-    label: 'Commit (Commitizen — interactive conventional commit)',
+    label: 'Commit (Commitizen)',
     run: () => runCommitizen(),
   },
   {
     key: '6',
-    label: 'Commit vulnerability bumps (staged package.json → vuln() message)',
-    run: () => runNode('vuln-commit.mjs'),
+    label: 'Commit vulnerability (Commitizen)',
+    run: () => runCommitizen([], { FG_DEVKIT_CZ_DEFAULT_TYPE: 'vuln' }),
   },
 ]
 
@@ -189,18 +306,29 @@ async function runInteractiveMenu() {
     return 1
   }
 
-  let exitCode = 0
-  try {
-    const out = item.run()
-    if (typeof out === 'object' && out !== null && typeof out.then === 'function') {
-      exitCode = await out
-    } else if (typeof out === 'number') {
-      exitCode = out
+  let out
+  if (item.key === '4') {
+    const bumpType = await promptReleaseType(rl)
+    if (!bumpType) {
+      rl.close()
+      return 0
     }
-  } finally {
+    // Close menu readline before spawning interactive child processes.
+    rl.close()
+    out = runReleaseScript([bumpType])
+  } else {
+    // Close menu readline before spawning interactive child processes.
     rl.close()
+    out = item.run()
   }
-  return exitCode
+
+  if (typeof out === 'object' && out !== null && typeof out.then === 'function') {
+    return await out
+  }
+  if (typeof out === 'number') {
+    return out
+  }
+  return 0
 }
 
 async function main() {
@@ -224,6 +352,30 @@ async function main() {
       process.exitCode = runNode('vuln-commit.mjs', rest)
       return
     }
+    if (sub === 'lint') {
+      process.exitCode = runBundledEslint(rest.length > 0 ? rest : ['.'])
+      return
+    }
+    if (sub === 'lint-fix') {
+      process.exitCode = runBundledEslint(rest.length > 0 ? ['--fix', ...rest] : ['--fix', '.'])
+      return
+    }
+    if (sub === 'format') {
+      process.exitCode = runBundledPrettier(rest.length > 0 ? rest : ['--write', '.'])
+      return
+    }
+    if (sub === 'format-check') {
+      process.exitCode = runBundledPrettier(rest.length > 0 ? ['--check', ...rest] : ['--check', '.'])
+      return
+    }
+    if (sub === 'typecheck') {
+      process.exitCode = runBundledTypeScript(rest.length > 0 ? rest : ['--noEmit', '-p', 'tsconfig.json'])
+      return
+    }
+    if (sub === 'typecheck-watch') {
+      process.exitCode = runBundledTypeScript(rest.length > 0 ? ['--watch', ...rest] : ['--noEmit', '--watch', '-p', 'tsconfig.json'])
+      return
+    }
     const script = DIRECT_COMMANDS[sub]
     if (!script) {
       console.error(`[fg-devkit] Unknown command: ${sub}`)

package/scripts/sync-tooling-configs.mjs

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 /**
  * Syncs shared tooling files from fg-devkit into the repo root:
- * - prettier.config.js — full copy from fg-devkit
- * - eslint.config.js — copy of the minimal eslint.sync-stub.js (flat config + createBaseConfig)
- * - tsconfig.json — full copy of tsconfig.app.sync.json (Vue app defaults: include/exclude,
- *   compilerOptions, vueCompilerOptions, extends fg-devkit/tsconfig.base.json)
+ * - prettier.config.js — overwritten from fg-devkit prettier sync template
+ * - eslint.config.js — overwritten from fg-devkit eslint sync template
+ * - tsconfig.json — overwritten from fg-devkit tsconfig app sync template
+ *
+ * This command is intentionally deterministic: each run rewrites files to the shared templates.
  *
  * Requires fg-devkit on disk (direct dependency or via fds-vue-core).
  *
@@ -15,11 +16,14 @@
 
 import fs from 'node:fs'
 import path from 'node:path'
+import { fileURLToPath } from 'node:url'
 
 const projectRoot = process.cwd()
+const scriptDir = path.dirname(fileURLToPath(import.meta.url))
 
 function findFgDevkitPackageRoot() {
   const candidates = [
+    path.resolve(scriptDir, '..'),
     path.join(projectRoot, 'node_modules', 'fg-devkit'),
     path.join(projectRoot, 'node_modules', 'fds-vue-core', 'node_modules', 'fg-devkit'),
   ]
@@ -39,13 +43,13 @@ if (!fgRoot) {
   process.exit(1)
 }
 
-const prettierSrc = path.join(fgRoot, 'configs', 'prettier.config.js')
+const prettierSrc = path.join(fgRoot, 'configs', 'prettier.sync-stub.js')
 const eslintStubSrc = path.join(fgRoot, 'configs', 'eslint.sync-stub.js')
 const tsconfigSrc = path.join(fgRoot, 'configs', 'tsconfig.app.sync.json')
 
 if (!fs.existsSync(prettierSrc) || !fs.existsSync(eslintStubSrc) || !fs.existsSync(tsconfigSrc)) {
   console.error(
-    '[sync-tooling] Missing prettier.config.js, eslint.sync-stub.js, or tsconfig.app.sync.json inside fg-devkit package.',
+    '[sync-tooling] Missing prettier.sync-stub.js, eslint.sync-stub.js, or tsconfig.app.sync.json inside fg-devkit package.',
   )
   process.exit(1)
 }
@@ -54,9 +58,8 @@ try {
   fs.copyFileSync(prettierSrc, path.join(projectRoot, 'prettier.config.js'))
   fs.copyFileSync(eslintStubSrc, path.join(projectRoot, 'eslint.config.js'))
   fs.copyFileSync(tsconfigSrc, path.join(projectRoot, 'tsconfig.json'))
+  console.log('[sync-tooling] Updated prettier.config.js, eslint.config.js, and tsconfig.json.')
 } catch (err) {
   console.error(`[sync-tooling] ${err.message}`)
   process.exit(1)
 }
-
-console.log('[sync-tooling] Updated prettier.config.js, eslint.config.js, and tsconfig.json.')