zn-ai/docs/Vue-Exit-Checklist.md

zn-ai Vue Exit Checklist

Goal: move zn-ai from "React renderer plus leftover Vue-era assets/config" to a truly React-only repo, while keeping build and typecheck green at each step.

Current Status

• Renderer bootstrap is React-only.
  • index.html
  • src/main.tsx
• src/** is now the active React renderer tree and no longer reaches back into the removed Vue code.
• Electron/shared runtime no longer imports from src/lib/*, src/shared/*, or src/i18n/locales/*.
  • active runtime callers now use @runtime/* -> runtime-shared/*
• Legacy compatibility/config cleanup is complete.
  • removed @vitejs/plugin-vue
  • removed unplugin-auto-import
  • removed Vue module declarations from global.d.ts
  • removed stale src/** path aliases from Vite and TypeScript
  • moved openapi-ts-request output to src/api
  • added src/api/request.ts as the React-side generated request bridge
• The old Vue tree is gone end-to-end.
  • deleted src/main-vue.ts
  • deleted src/router/index.ts
  • deleted src/permission.ts
  • deleted src/App.vue
  • deleted the remaining src/** directory, including src/main.ts and src/framework.ts
• Vue-era runtime dependencies are gone from package.json.
  • removed vue
  • removed pinia
  • removed vue-router
  • removed element-plus
  • removed vue-i18n
  • removed @remixicon/vue
  • removed @lucide/vue
  • removed vue-codemirror
  • removed vue-markdown-render
  • removed @vueuse/core

What This Means

• The old Vue runtime path is no longer present in the source tree.
• src/** is no longer a live runtime or config boundary.
• The remaining follow-up is mostly housekeeping, not migration-blocking runtime work.
  • stale historical references in docs
  • optional cleanup of package-lock.json if the repo standardizes on pnpm only
  • the known bytecode warning when the local Electron binary is missing

File Plan

1. package.json

Done

• removed the Vue-era runtime/UI dependencies from the manifest
• refreshed pnpm-lock.yaml

2. global.d.ts

Done

• removed declare module "@stores/*";
• removed declare module "@service/*";
• removed declare module "@utils/*";
• removed declare module "@constant/*";
• removed declare module "vue-router";
• removed declare module "*.vue"
• removed declare module "@remixicon/vue"
• removed declare module "@assets/images/*"

3. tsconfig.app.json

Done

• removed explicit include for src/permission.ts
• removed include: "src/**/*.vue"
• removed the remaining dead src/** path aliases

4. vite.config.ts

Done

• active renderer build is React-only
• Electron shared runtime uses @runtime/*
• removed the legacy src/** alias surface from the Vite config

Recommended Execution Order

1. Done: remove low-risk compatibility items from package.json and global.d.ts
2. Done: remove the dead Vue bootstrap chain
3. Done: remove the dead Vue page/component/store/request tree
4. Done: delete src/main.ts, src/framework.ts, and the remaining dead src/** files
5. Done: trim stale TypeScript/Vite/OpenAPI alias surface that pointed into deleted legacy areas
6. Done: remove the remaining Vue-era dependencies from package.json

Residual Notes

• Keep @runtime/* -> runtime-shared/*, which is now the active Electron/shared-runtime boundary.
• package-lock.json still contains historical Vue-era entries, but the active workspace lockfile is pnpm-lock.yaml.

Next Gate

Vue exit is effectively complete for source/runtime once all of the following remain true:

1. no source file imports any Vue-era runtime package
2. package.json stays free of the Vue-era dependencies and pnpm-lock.yaml stays refreshed
3. Vite/TypeScript/OpenAPI config stays off src/**
4. pnpm typecheck and pnpm build:vite stay green