create-bubbles 0.1.22 → 0.1.24

package/template-vp-monorepo-react-nestjs/packages/i18n/cli/test/report.test.ts

@@ -0,0 +1,63 @@
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { describe, expect, it } from 'vite-plus/test'
+
+import { createSyncReport, writeSyncReport } from '../src/report.ts'
+import { useTemporaryDirectory } from './temporary-directory.ts'
+
+describe('sync report', () => {
+  const temporaryDirectory = useTemporaryDirectory()
+
+  it('writes the flat report format', async () => {
+    const report = createSyncReport({
+      clean: false,
+      dryRun: true,
+      files: [
+        {
+          project: 'web',
+          path: 'apps/web/src/locales/en_US.json',
+          locale: 'en_US',
+          added: ['用户'],
+          unused: ['旧文案'],
+          deleted: [],
+          unchangedCount: 2,
+        },
+      ],
+    })
+    const path = join(temporaryDirectory.path, 'reports', 'i18n.json')
+
+    await writeSyncReport(report, path)
+
+    expect(JSON.parse(await readFile(path, 'utf8'))).toEqual({
+      command: 'sync',
+      clean: false,
+      dryRun: true,
+      files: [
+        {
+          project: 'web',
+          path: 'apps/web/src/locales/en_US.json',
+          locale: 'en_US',
+          added: ['用户'],
+          unused: ['旧文案'],
+          deleted: [],
+          unchangedCount: 2,
+        },
+      ],
+    })
+  })
+
+  it('writes a check report', async () => {
+    const report = createSyncReport({ command: 'check' })
+    const path = join(temporaryDirectory.path, 'reports', 'i18n-check.json')
+
+    await writeSyncReport(report, path)
+
+    expect(JSON.parse(await readFile(path, 'utf8'))).toEqual({
+      command: 'check',
+      clean: false,
+      dryRun: false,
+      files: [],
+    })
+  })
+})

package/template-vp-monorepo-react-nestjs/packages/i18n/cli/test/sync.test.ts

@@ -0,0 +1,203 @@
+import { access, readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { describe, expect, it } from 'vite-plus/test'
+
+import {
+  CatalogValidationError,
+  EmptyScanCleanError,
+  syncCatalog,
+  syncProject,
+} from '../src/sync.ts'
+import { useTemporaryDirectory } from './temporary-directory.ts'
+
+describe('syncCatalog', () => {
+  const temporaryDirectory = useTemporaryDirectory()
+
+  it('creates a missing catalog and initializes every key with itself', async () => {
+    const path = join(temporaryDirectory.path, 'locales', 'en_US.json')
+
+    const report = await syncCatalog({
+      project: 'web',
+      locale: 'en_US',
+      path,
+      keys: new Set(['中文', 'English']),
+    })
+
+    expect(report.added).toEqual(['English', '中文'])
+    expect(JSON.parse(await readFile(path, 'utf8'))).toEqual({
+      English: 'English',
+      中文: '中文',
+    })
+  })
+
+  it('adds missing keys, keeps translations and is idempotent', async () => {
+    const path = join(temporaryDirectory.path, 'en_US.json')
+    const initial = '{\r\n    "existing": "Translated",\r\n    "unused": "Old"\r\n}\r\n'
+    await writeFile(path, initial, 'utf8')
+
+    const first = await syncCatalog({
+      project: 'web',
+      locale: 'en_US',
+      path,
+      keys: new Set(['existing', 'new message']),
+    })
+
+    expect(first).toEqual({
+      project: 'web',
+      path,
+      locale: 'en_US',
+      added: ['new message'],
+      unused: ['unused'],
+      deleted: [],
+      unchangedCount: 1,
+    })
+    expect(JSON.parse(await readFile(path, 'utf8'))).toEqual({
+      existing: 'Translated',
+      unused: 'Old',
+      'new message': 'new message',
+    })
+
+    const afterFirstSync = await readFile(path, 'utf8')
+    expect(afterFirstSync).toContain('\r\n    "new message"')
+
+    const second = await syncCatalog({
+      project: 'web',
+      locale: 'en_US',
+      path,
+      keys: new Set(['existing', 'new message']),
+    })
+
+    expect(second.added).toEqual([])
+    expect(second.unused).toEqual(['unused'])
+    expect(second.unchangedCount).toBe(2)
+    expect(await readFile(path, 'utf8')).toBe(afterFirstSync)
+  })
+
+  it('deletes unused keys only when clean is enabled', async () => {
+    const path = join(temporaryDirectory.path, 'zh_CN.json')
+    await writeFile(path, '{\n  "保留": "翻译",\n  "旧文案": "旧翻译"\n}\n', 'utf8')
+
+    const report = await syncCatalog({
+      project: 'web',
+      locale: 'zh_CN',
+      path,
+      keys: new Set(['保留', '新增']),
+      clean: true,
+    })
+
+    expect(report.added).toEqual(['新增'])
+    expect(report.unused).toEqual([])
+    expect(report.deleted).toEqual(['旧文案'])
+    expect(JSON.parse(await readFile(path, 'utf8'))).toEqual({
+      保留: '翻译',
+      新增: '新增',
+    })
+  })
+
+  it('reports changes without writing in dry-run mode', async () => {
+    const path = join(temporaryDirectory.path, 'dry-run.json')
+    const initial = '{"used":"Translation","stale":"Old"}'
+    await writeFile(path, initial, 'utf8')
+
+    const report = await syncCatalog({
+      project: 'web',
+      locale: 'en_US',
+      path,
+      keys: new Set(['used', 'new']),
+      clean: true,
+      dryRun: true,
+    })
+
+    expect(report.added).toEqual(['new'])
+    expect(report.deleted).toEqual(['stale'])
+    expect(await readFile(path, 'utf8')).toBe(initial)
+
+    const missingPath = join(temporaryDirectory.path, 'missing.json')
+    await syncCatalog({
+      project: 'web',
+      locale: 'fr_FR',
+      path: missingPath,
+      keys: new Set(['new']),
+      dryRun: true,
+    })
+    await expect(access(missingPath)).rejects.toMatchObject({ code: 'ENOENT' })
+  })
+
+  it('refuses to clear a non-empty catalog after an empty scan', async () => {
+    const path = join(temporaryDirectory.path, 'protected.json')
+    const initial = '{"existing":"Translation"}'
+    await writeFile(path, initial, 'utf8')
+
+    await expect(
+      syncCatalog({
+        project: 'web',
+        locale: 'en_US',
+        path,
+        keys: new Set(),
+        clean: true,
+      }),
+    ).rejects.toBeInstanceOf(EmptyScanCleanError)
+    expect(await readFile(path, 'utf8')).toBe(initial)
+  })
+
+  it('allows an intentional empty clean', async () => {
+    const path = join(temporaryDirectory.path, 'allow-empty.json')
+    await writeFile(path, '{"existing":"Translation"}\n', 'utf8')
+
+    const report = await syncCatalog({
+      project: 'web',
+      locale: 'en_US',
+      path,
+      keys: new Set(),
+      clean: true,
+      allowEmpty: true,
+    })
+
+    expect(report.deleted).toEqual(['existing'])
+    expect(JSON.parse(await readFile(path, 'utf8'))).toEqual({})
+  })
+
+  it('rejects non-string catalog values without overwriting the file', async () => {
+    const path = join(temporaryDirectory.path, 'nested.json')
+    const initial = '{"valid":"Translation","nested":{"value":"Invalid"}}'
+    await writeFile(path, initial, 'utf8')
+
+    await expect(
+      syncCatalog({
+        project: 'web',
+        locale: 'en_US',
+        path,
+        keys: new Set(['valid', 'new']),
+      }),
+    ).rejects.toBeInstanceOf(CatalogValidationError)
+    expect(await readFile(path, 'utf8')).toBe(initial)
+  })
+})
+
+describe('syncProject', () => {
+  const temporaryDirectory = useTemporaryDirectory()
+
+  it('validates every catalog before writing any catalog', async () => {
+    const validPath = join(temporaryDirectory.path, 'valid.json')
+    const invalidPath = join(temporaryDirectory.path, 'invalid.json')
+    const validInitial = '{"existing":"Translation"}\n'
+    const invalidInitial = '{ invalid json'
+    await writeFile(validPath, validInitial, 'utf8')
+    await writeFile(invalidPath, invalidInitial, 'utf8')
+
+    await expect(
+      syncProject({
+        project: 'web',
+        catalogs: {
+          en_US: validPath,
+          zh_CN: invalidPath,
+        },
+        keys: new Set(['existing', 'new']),
+      }),
+    ).rejects.toBeInstanceOf(CatalogValidationError)
+
+    expect(await readFile(validPath, 'utf8')).toBe(validInitial)
+    expect(await readFile(invalidPath, 'utf8')).toBe(invalidInitial)
+  })
+})

package/template-vp-monorepo-react-nestjs/packages/i18n/cli/test/temporary-directory.ts

@@ -0,0 +1,25 @@
+import { mkdtemp, rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+import { afterEach, beforeEach } from 'vite-plus/test'
+
+export function useTemporaryDirectory(): { readonly path: string } {
+  let path = ''
+
+  beforeEach(async () => {
+    path = await mkdtemp(join(tmpdir(), 'bubbles-i18n-'))
+  })
+
+  afterEach(async () => {
+    if (path !== '') {
+      await rm(path, { recursive: true, force: true })
+    }
+  })
+
+  return {
+    get path() {
+      return path
+    },
+  }
+}

package/template-vp-monorepo-react-nestjs/packages/i18n/cli/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../../tsconfig.lib.json",
+  "compilerOptions": {
+    "allowImportingTsExtensions": true,
+    "erasableSyntaxOnly": true,
+    "types": ["node"]
+  },
+  "include": ["src", "test"]
+}

package/template-vp-monorepo-react-nestjs/packages/i18n/cli/vite.config.ts

@@ -0,0 +1,18 @@
+import { defineConfig } from 'vite-plus'
+
+export default defineConfig({
+  pack: {
+    entry: {
+      index: './src/index.ts',
+      cli: './src/cli.ts',
+    },
+    format: ['esm'],
+    platform: 'node',
+    target: 'node22',
+    dts: true,
+    clean: true,
+    treeshake: true,
+    shims: true,
+    outExtensions: () => ({ js: '.mjs' }),
+  },
+})

package/template-vp-monorepo-react-nestjs/packages/i18n/core/tsconfig.json

@@ -1,15 +1,4 @@
 {
-  "extends": "../../../tsconfig.json",
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "lib": ["ES2020", "DOM"],
-    "types": [],
-    "strict": true,
-    "skipLibCheck": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true
-  },
+  "extends": "../../../tsconfig.lib.json",
   "include": ["src"]
 }

package/template-vp-monorepo-react-nestjs/packages/i18n/react/tsconfig.json

@@ -1,16 +1,9 @@
 {
-  "extends": "../../../tsconfig.json",
+  "extends": "../../../tsconfig.lib.json",
   "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
     "jsx": "react-jsx",
-    "lib": ["ES2020", "DOM"],
-    "types": ["react"],
-    "strict": true,
-    "skipLibCheck": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true
+    "types": ["react"]
   },
   "include": ["src"]
 }

package/template-vp-monorepo-react-nestjs/packages/i18n/vue/tsconfig.json

@@ -1,15 +1,8 @@
 {
-  "extends": "../../../tsconfig.json",
+  "extends": "../../../tsconfig.lib.json",
   "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "lib": ["ES2020", "DOM"],
-    "types": ["vue"],
-    "strict": true,
-    "skipLibCheck": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "types": ["vue"]
   },
   "include": ["src"]
 }

package/template-vp-monorepo-react-nestjs/packages/shared/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "shared",
+  "version": "0.0.0",
+  "private": true,
+  "description": "",
+  "keywords": [],
+  "license": "ISC",
+  "author": "",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.js"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "import": "./dist/utils.js",
+      "require": "./dist/utils.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "dev": "vp pack --watch",
+    "build": "vp pack"
+  },
+  "devDependencies": {
+    "typescript": "catalog:",
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
+  }
+}

package/template-vp-monorepo-react-nestjs/packages/shared/src/index.ts

@@ -0,0 +1,13 @@
+export type {
+  ApiErrorDetail,
+  ApiFailure,
+  AuthUser,
+  CurrentUser,
+  LoginRequest,
+  LoginResult,
+  LogoutResult,
+  RegisterRequest,
+  RegisterResult,
+  SessionTerminalType,
+} from './types'
+export { ACCOUNT_PATTERN, isSessionTerminal, normalizeAccount, SESSION_TERMINALS } from './utils'

package/template-vp-monorepo-react-nestjs/packages/shared/src/types/auth.ts

@@ -0,0 +1,35 @@
+export type SessionTerminalType = 'web' | 'desktop' | 'mobile'
+
+export interface RegisterRequest {
+  name: string
+  account: string
+  password: string
+}
+
+export interface LoginRequest {
+  account: string
+  password: string
+}
+
+export interface AuthUser {
+  id: string
+  account: string
+  name: string
+}
+
+export type RegisterResult = AuthUser
+
+export interface LoginResult {
+  accessToken: string
+  tokenType: 'Bearer'
+  idleExpiresIn: number
+  absoluteExpiresAt: string
+}
+
+export interface CurrentUser extends AuthUser {
+  terminal: SessionTerminalType
+}
+
+export interface LogoutResult {
+  loggedOut: true
+}

package/template-vp-monorepo-react-nestjs/packages/shared/src/types/common.ts

@@ -0,0 +1,11 @@
+export interface ApiErrorDetail {
+  readonly path?: string
+  readonly code: string
+  readonly message: string
+}
+
+export interface ApiFailure {
+  readonly code: string
+  readonly message: string
+  readonly details?: ApiErrorDetail[]
+}

package/template-vp-monorepo-react-nestjs/packages/shared/src/types/index.ts

@@ -0,0 +1,11 @@
+export type {
+  AuthUser,
+  CurrentUser,
+  LoginRequest,
+  LoginResult,
+  LogoutResult,
+  RegisterRequest,
+  RegisterResult,
+  SessionTerminalType,
+} from './auth'
+export type { ApiErrorDetail, ApiFailure } from './common'

package/template-vp-monorepo-react-nestjs/packages/shared/src/utils/account.ts

@@ -0,0 +1,5 @@
+export const ACCOUNT_PATTERN = /^[A-Za-z0-9_]+$/
+
+export function normalizeAccount(value: string) {
+  return value.trim().toLowerCase()
+}

package/template-vp-monorepo-react-nestjs/packages/shared/src/utils/index.ts

@@ -0,0 +1,2 @@
+export { ACCOUNT_PATTERN, normalizeAccount } from './account'
+export { isSessionTerminal, SESSION_TERMINALS } from './session-terminal'

package/template-vp-monorepo-react-nestjs/packages/shared/src/utils/session-terminal.ts

@@ -0,0 +1,11 @@
+import type { SessionTerminalType } from '../types'
+
+export const SESSION_TERMINALS = [
+  'web',
+  'desktop',
+  'mobile',
+] as const satisfies readonly SessionTerminalType[]
+
+export function isSessionTerminal(value: unknown): value is SessionTerminalType {
+  return SESSION_TERMINALS.includes(value as SessionTerminalType)
+}

package/template-vp-monorepo-react-nestjs/packages/shared/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "../../tsconfig.lib.json",
+  "include": ["src"]
+}

package/template-vp-monorepo-react-nestjs/packages/shared/vite.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vite-plus'
+
+export default defineConfig({
+  pack: {
+    entry: {
+      index: './src/index.ts',
+      types: './src/types/index.ts',
+      utils: './src/utils/index.ts',
+    },
+    format: ['esm'],
+    platform: 'neutral',
+    target: 'es2020',
+    dts: true,
+    clean: true,
+    treeshake: true,
+  },
+})

package/template-vp-monorepo-react-nestjs/pnpm-workspace.yaml

@@ -25,13 +25,15 @@ catalog:
   '@nestjs/schematics': ^11.0.0
   '@nestjs/swagger': ^11.4.6
   '@nestjs/testing': ^11.0.1
+  '@swc/cli': ^0.8.1
+  '@swc/core': ^1.16.0
   '@tailwindcss/vite': ^4.3.1
   '@types/express': ^5.0.0
   '@types/node': ^26.1.1
   '@types/nprogress': ^0.2.3
+  '@types/pg': ^8.21.0
   '@types/react': ^19.2.17
   '@types/react-dom': ^19.2.3
-  '@typescript/native': npm:typescript@^7.0.2
   '@unocss/eslint-plugin': ^66.7.2
   '@unocss/preset-attributify': ^66.7.5
   '@unocss/preset-wind4': ^66.7.5
@@ -89,12 +91,9 @@ catalog:
   vue-router: ^5.1.0
   vue-tsc: ^3.3.7
   zod: ^4.4.3
-catalogs:
-  node24:
-    '@types/node': ^24.0.0
-  typescript6:
-    typescript: npm:@typescript/typescript6@^6.0.2
 overrides:
+  # 4.0.5 depends on mdn-data@2.29.0, which is missing from npm's full package index.
+  '@eslint/css-tree': 4.0.4
   vite: 'catalog:'
 peerDependencyRules:
   allowAny:
@@ -106,6 +105,7 @@ minimumReleaseAgeExclude:
 allowBuilds:
   '@parcel/watcher': true
   '@scarf/scarf': true
+  '@swc/core': true
   argon2: true
   esbuild: true
   lefthook: true

package/template-vp-monorepo-react-nestjs/scripts/clean.mjs

@@ -0,0 +1,48 @@
+import { readdir, rm } from 'node:fs/promises'
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const projectRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const removableDirectories = new Set(['.vite', 'coverage', 'dist', 'dist-ssr'])
+
+function assertInsideProject(targetPath) {
+  const relativePath = relative(projectRoot, targetPath)
+
+  if (relativePath === '' || relativePath === '..' || relativePath.startsWith(`..${process.platform === 'win32' ? '\\' : '/'}`) || isAbsolute(relativePath)) {
+    throw new Error(`Refusing to remove path outside the project: ${targetPath}`)
+  }
+}
+
+async function remove(targetPath) {
+  assertInsideProject(targetPath)
+  await rm(targetPath, { force: true, recursive: true })
+  console.log(`Removed ${relative(projectRoot, targetPath)}`)
+}
+
+async function clean(directory) {
+  const entries = await readdir(directory, { withFileTypes: true })
+
+  await Promise.all(
+    entries.map(async (entry) => {
+      if (entry.name === '.git' || entry.name === 'node_modules') return
+
+      const targetPath = join(directory, entry.name)
+
+      if (entry.isDirectory()) {
+        if (removableDirectories.has(entry.name)) {
+          await remove(targetPath)
+          return
+        }
+
+        await clean(targetPath)
+        return
+      }
+
+      if (entry.isFile() && entry.name.endsWith('.tsbuildinfo')) {
+        await remove(targetPath)
+      }
+    }),
+  )
+}
+
+await clean(projectRoot)

package/template-vp-monorepo-react-nestjs/tsconfig.base.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true,
+    "noImplicitOverride": true
+  }
+}

package/template-vp-monorepo-react-nestjs/tsconfig.bundler.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "moduleDetection": "force",
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "esModuleInterop": true,
+    "noEmit": true
+  }
+}

package/template-vp-monorepo-react-nestjs/tsconfig.json

@@ -1,9 +1,11 @@
 {
+  "extends": "./tsconfig.base.json",
   "compilerOptions": {
-    "noEmit": true,
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "allowImportingTsExtensions": true,
-    "esModuleInterop": true
-  }
+    "target": "ES2023",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "types": ["node"],
+    "noEmit": true
+  },
+  "include": ["vite.config.ts"]
 }