docs: support zh

apps/docs/README.md

@@ -37,7 +37,7 @@ You can also run equivalent commands inside `apps/docs` with `pnpm run <script>`
 
 ## i18n workflow
 
-This docs app supports multiple locales (`en`, `ko`, `de`, `fr`).
+This docs app supports multiple locales (`en`, `ko`, `de`, `fr`, `ru`, `ja`, `es`, `zh-Hans`).
 
 ```bash
 # extract translation files

apps/docs/docs/advanced/custom-transformer.md

@@ -95,7 +95,7 @@ class ReportRequest {
 class ProductQuery {
     @Query('q')
     @Transform((value: string) => value.toLowerCase().trim())
-    @IsNotEmpty()
+    @MinLength(1)
     searchTerm!: string
 
     @Query()
@@ -155,4 +155,4 @@ class FilterRequest {
 
 // GET /filter?active=yes → { active: true }
 // GET /filter?active=0   → { active: false }
-```
+```

apps/docs/docs/advanced/nested-binding.md

@@ -6,7 +6,7 @@ Express-Cargo allows you to handle nested objects in requests, automatically bin
 
 ```typescript
 import express, { Request, Response } from 'express'
-import { Body, bindingCargo, getCargo } from 'express-cargo'
+import { Body, Type, bindingCargo, getCargo } from 'express-cargo'
 
 // 1. Define nested Object
 class Profile {
@@ -16,6 +16,7 @@ class Profile {
 
 class ExampleObject {
     @Body('profile')
+    @Type(() => Profile)
     profile!: Profile
 }
 

apps/docs/docs/examples/nested-request.md

@@ -40,7 +40,7 @@ export class UserInfoRequest {
 
 ```typescript
 // order.request.ts
-import { Body, Min, Max } from 'express-cargo'
+import { Body, Min, Max, Type } from 'express-cargo'
 import { UserInfoRequest } from './user.request'
 
 export class OrderRequest {
@@ -53,6 +53,7 @@ export class OrderRequest {
     quantity!: number
 
     @Body('user')
+    @Type(() => UserInfoRequest)
     user!: UserInfoRequest
 }
 ```

apps/docs/docs/getting-started.md

@@ -80,9 +80,8 @@ pnpm add reflect-metadata
 #### 6-1. `src/app.ts`
 
 ```typescript
-import express from 'express'
-import { bindingCargo, getCargo, Body, Query, Header, Params, Min, Max, Equal, NotEqual, Prefix, Suffix } from 'express-cargo'
-import errorHandlerRouter from './errorHandler'
+import express, { Request, Response, NextFunction } from 'express'
+import { bindingCargo, getCargo, Body, Equal, CargoValidationError } from 'express-cargo'
 
 const app = express()
 
@@ -91,10 +90,6 @@ const port = process.env.PORT || 3000
 app.use(express.json())
 app.use(express.urlencoded({ extended: true }))
 
-app.use(errorHandlerRouter)
-
-app.listen(port, () => {console.log(`Example app listening on port ${port}`)})
-
 class ExampleRequest {
   @Body() // Extract fields from the request body
   @Equal('1') // If the value is not "1", a validation error occurs
@@ -105,6 +100,19 @@ app.post('/example', bindingCargo(ExampleRequest), (req, res) => { // bindingCar
   const cargo = getCargo<ExampleRequest>(req) // Return a validated type-safe object
   res.json(cargo)
 })
+
+app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
+  if (err instanceof CargoValidationError) {
+    res.status(400).json({
+      errors: err.errors.map(error => error.message),
+    })
+    return
+  }
+
+  next(err)
+})
+
+app.listen(port, () => {console.log(`Example app listening on port ${port}`)})
 ```
 
 ### 7. Run

apps/docs/docusaurus.config.ts

@@ -37,7 +37,7 @@ const config: Config = {
     // may want to replace "en" with "zh-Hans".
     i18n: {
         defaultLocale: 'en',
-        locales: ['en', 'ko', 'de', 'fr', 'ru', 'ja', 'es'],
+        locales: ['en', 'ko', 'de', 'fr', 'ru', 'ja', 'es', 'zh-Hans'],
         localeConfigs: {
             en: {
                 label: 'English',
@@ -66,6 +66,10 @@ const config: Config = {
                 label: 'Español',
                 direction: 'ltr',
             },
+            'zh-Hans': {
+                label: '简体中文',
+                direction: 'ltr',
+            },
         },
     },