TypeScript Migration Rules for 9jang Project

Architecture Standard

• We are using a Monorepo structure with

  pnpm workspaces

  .
• Centralized Data Source: All API schemas and types MUST reside in

  shared/src/schemas

  .
• Never define types locally if they represent API entities; always use

  z.infer<typeof Schema>

  from the shared package.

TypeScript Best Practices

• No

  any

  : Use

  unknown

  with type guards if a type is truly uncertain.
• Zod Integration: Use Zod for runtime validation at the API service layer.
• Tiptap Extensions: When migrating extensions, use "Module Augmentation" to register custom commands and attributes in

  @tiptap/core

  .

Migration Strategy

• When converting Vue components, prioritize

  <script setup lang="ts">

  .
• For large composables (e.g., usePrintPreview), break down the logic into smaller, typed internal functions.
• Ensure all path aliases use

  @/

  for frontend and

  @9jang/shared

  for shared types.