anl 1.5.7 → 1.5.9

package/README.ar.md

@@ -17,4 +17,214 @@
 - ⚡️ دعم رفع الملفات
 - 🛠 خيارات قابلة للتكوين لإنشاء الكود
 
-[... rest of content similar to README.en.md but in Arabic ...]
+## التثبيت
+
+```bash
+$ npm install anl -g
+
+$ yarn global add anl
+```
+
+## طريقة الاستخدام
+
+1. تنفيذ الأمر
+
+```bash
+$ anl type
+```
+
+2. إكمال إعدادات المشروع
+
+- عند تنفيذ `anl type` لأول مرة، سيتم إنشاء ملف التكوين `an.config.json` تلقائياً في جذر المشروع (يمكن إنشاؤه يدوياً أيضاً)
+- راجع وصف الإعدادات للحصول على تفاصيل المعلمات
+- لا يمكن تغيير اسم ملف التكوين
+
+```json
+{
+	"saveTypeFolderPath": "apps/types",
+	"saveApiListFolderPath": "apps/api/",
+	"saveEnumFolderPath": "apps/enums",
+	"importEnumPath": "../../enums",
+	"swaggerJsonUrl": "https://generator3.swagger.io/openapi.json",
+	"requestMethodsImportPath": "./fetch",
+	"dataLevel": "serve",
+	"formatting": {
+		"indentation": "\t",
+		"lineEnding": "\n"
+	},
+	"headers": {}
+}
+```
+
+3. إنشاء تعريفات أنواع TypeScript ودوال طلبات API، قم بتنفيذ الأمر مرة أخرى
+
+```bash
+$ anl type
+```
+
+## وصف الإعدادات
+
+| الإعداد                  | النوع                        | إلزامي | الوصف                           |
+| ------------------------ | ---------------------------- | ------ | ------------------------------- |
+| saveTypeFolderPath       | string                       | نعم    | مسار حفظ ملفات تعريف الأنواع    |
+| saveApiListFolderPath    | string                       | نعم    | مسار حفظ ملفات دوال API         |
+| saveEnumFolderPath       | string                       | نعم    | مسار حفظ ملفات الأنواع المعدودة |
+| importEnumPath           | string                       | نعم    | مسار استيراد الأنواع المعدودة   |
+| swaggerJsonUrl           | string                       | نعم    | عنوان وثيقة Swagger JSON        |
+| requestMethodsImportPath | string                       | نعم    | مسار استيراد طرق الطلب          |
+| dataLevel                | 'data' \| 'serve' \| 'axios' | نعم    | مستوى بيانات الاستجابة          |
+| formatting               | object                       | لا     | إعدادات تنسيق الكود             |
+| headers                  | object                       | لا     | إعدادات رؤوس الطلب              |
+
+## هيكل الملفات المنشأة
+
+- يتم إنشاء هيكل الملفات هذا وفقاً لملف التكوين
+
+project/
+├── apps/
+│ ├── types/
+│ │ ├── models/ # جميع ملفات تعريف الأنواع (باستثناء الأنواع المعدودة)
+│ │ ├── connectors/ # تعريفات أنواع API (ملفات تعريف الواجهة)
+│ │ └── enums/ # تعريفات الأنواع المعدودة
+│ └── api/
+│ ├── fetch.ts # تنفيذ طرق الطلب
+│ └── index.ts # دوال طلبات API
+
+## أمثلة على الكود المنشأ
+
+### ملف تعريف الأنواع
+
+```typescript
+declare namespace UserDetail_GET {
+	interface Query {
+		userId: string;
+	}
+
+	interface Response {
+		id: string;
+		name: string;
+		age: number;
+		role: UserRole;
+	}
+}
+```
+
+### دالة طلب API
+
+```typescript
+import { GET } from './fetch';
+
+/**
+ * الحصول على تفاصيل المستخدم
+ */
+export const userDetailGet = (params: UserDetail_GET.Query) => GET<UserDetail_GET.Response>('/user/detail', params);
+```
+
+## وصف الميزات
+
+### تحليل الأنواع
+
+- دعم جميع أنواع البيانات في مواصفات OpenAPI 3.0
+- معالجة تلقائية للأنواع المتداخلة المعقدة
+- دعم المصفوفات والكائنات والأنواع المعدودة
+- إنشاء تلقائي لتعليقات الواجهة
+
+### رفع الملفات
+
+عند اكتشاف نوع رفع الملفات، سيتم إضافة رؤوس الطلب المناسبة تلقائياً:
+
+```typescript
+export const uploadFile = (params: UploadFile.Body) =>
+	POST<UploadFile.Response>('/upload', params, {
+		headers: { 'Content-Type': 'multipart/form-data' },
+	});
+```
+
+### معالجة الأخطاء
+
+تتضمن الأداة آلية شاملة لمعالجة الأخطاء:
+
+- تنبيهات أخطاء التحليل
+- تحذيرات فشل إنشاء الأنواع
+- معالجة استثناءات كتابة الملفات
+
+## التطوير
+
+```bash
+# تثبيت التبعيات
+npm install
+
+# وضع التطوير
+اضغط F5 للتصحيح
+
+# البناء
+npm run build
+
+# الربط المحلي للتصحيح
+npm run blink
+```
+
+## ملاحظات هامة
+
+1. تأكد من إمكانية الوصول إلى عنوان وثيقة Swagger JSON
+2. يجب أن تكون المسارات في ملف التكوين نسبية لجذر المشروع
+3. سيتم استبدال الملفات الموجودة بنفس الاسم
+4. يُنصح بإضافة الملفات المنشأة إلى نظام التحكم في الإصدار
+
+## الأسئلة الشائعة
+
+1. فشل تنسيق ملفات الأنواع المنشأة
+
+   - تحقق من تثبيت prettier
+   - تأكد من وجود ملف تكوين prettier في جذر المشروع
+
+2. خطأ في مسار استيراد دوال الطلب
+   - تحقق من صحة إعداد requestMethodsImportPath
+   - تأكد من وجود ملف طرق الطلب
+
+## دليل المساهمة
+
+نرحب بتقديم المشكلات وطلبات السحب!
+
+## الترخيص
+
+ISC License
+
+## تعليمات الوثائق متعددة اللغات
+
+لتحسين صيانة الوثائق متعددة اللغات، نقدم التوصيات التالية:
+
+1. معايير تسمية الملفات
+
+   - استخدم رموز اللغة القياسية:
+     - النسخة الصينية: `README.zh-CN.md`
+     - النسخة الإنجليزية: `README.en.md`
+     - النسخة الإسبانية: `README.es.md`
+     - النسخة العربية: `README.ar.md`
+     - النسخة الفرنسية: `README.fr.md`
+     - النسخة الروسية: `README.ru.md`
+     - النسخة اليابانية: `README.ja.md`
+
+2. تحديث الوثائق المتزامن
+
+   - استخدم سكريبت `sync-docs.js` للمزامنة التلقائية لجميع النسخ اللغوية
+   - قم بتشغيل `npm run sync-docs` بعد تعديل الوثيقة الرئيسية
+   - تأكد من اتساق هيكل جميع النسخ اللغوية
+
+3. معايير الترجمة
+
+   - حافظ على اتساق المصطلحات التقنية
+   - احتفظ بأمثلة الكود باللغة الإنجليزية
+   - استخدم اللغة المناسبة للتعليقات والشروحات
+   - حافظ على توحيد تنسيق التخطيط
+
+4. دليل المساهمة
+
+   - نرحب باقتراحات تحسين النسخ متعددة اللغات
+   - يرجى تحديث جميع النسخ اللغوية عند تقديم طلب السحب
+   - إذا وجدت مشكلة في الترجمة، يرجى تقديم مشكلة
+
+5. تحسين تبديل اللغة
+   - أضف أيقونات تبديل اللغة في أعلى كل وثيقة
+   - حافظ على اتساق ترتيب روابط جميع اللغات
+   - اجعل رابط اللغة الحالية في حالة غير نشطة

package/README.en.md

@@ -1,6 +1,6 @@
 # an-cli
 
-English| [Español](./README.es.md) | [العربية](./README.ar.md) | [Français](./README.fr.md) | [Русский](./README.ru.md) | [日本語](./README.jp.md) | 简体中文
+English | [Español](./README.es.md) | [العربية](./README.ar.md) | [Français](./README.fr.md) | [Русский](./README.ru.md) | [日本語](./README.jp.md) | [简体中文](./README.md)
 
 Frontend Command Line Tool
 
@@ -79,3 +79,152 @@ $ anl type
 ## Generated File Structure
 
 - This file structure is generated based on the configuration file
+
+project/
+├── apps/
+│ ├── types/
+│ │ ├── models/ # All type definition files (excluding enums)
+│ │ ├── connectors/ # API type definitions (interface files)
+│ │ └── enums/ # Enum type definitions
+│ └── api/
+│ ├── fetch.ts # Request method implementation
+│ └── index.ts # API request functions
+
+## Generated Code Examples
+
+### Type Definition File
+
+```typescript
+declare namespace UserDetail_GET {
+	interface Query {
+		userId: string;
+	}
+
+	interface Response {
+		id: string;
+		name: string;
+		age: number;
+		role: UserRole;
+	}
+}
+```
+
+### API Request Function
+
+```typescript
+import { GET } from './fetch';
+
+/**
+ * Get user details
+ */
+export const userDetailGet = (params: UserDetail_GET.Query) => GET<UserDetail_GET.Response>('/user/detail', params);
+```
+
+## Feature Details
+
+### Type Parsing
+
+- Supports all OpenAPI 3.0 specification data types
+- Automatically handles complex nested types
+- Supports arrays, objects, enums, and other types
+- Automatically generates interface comments
+
+### File Upload
+
+When file upload type is detected, corresponding headers will be automatically added:
+
+```typescript
+export const uploadFile = (params: UploadFile.Body) =>
+	POST<UploadFile.Response>('/upload', params, {
+		headers: { 'Content-Type': 'multipart/form-data' },
+	});
+```
+
+### Error Handling
+
+The tool has built-in comprehensive error handling mechanisms:
+
+- Parsing error prompts
+- Type generation failure warnings
+- File writing exception handling
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Development mode
+Press F5 to debug
+
+# Build
+npm run build
+
+# Local link debugging
+npm run blink
+```
+
+## Important Notes
+
+1. Ensure the Swagger JSON documentation URL is accessible
+2. Paths in the configuration file should be relative to the project root directory
+3. Generated files will overwrite existing files with the same name
+4. It's recommended to include generated files in version control
+
+## Common Issues
+
+1. Generated type file formatting fails
+
+   - Check if prettier is installed
+   - Confirm if prettier configuration file exists in the project root
+
+2. Request function import path error
+   - Check if requestMethodsImportPath configuration is correct
+   - Confirm if the request method file exists
+
+## Contributing
+
+Issues and Pull Requests are welcome!
+
+## License
+
+ISC License
+
+## Multi-language Documentation Guidelines
+
+To better maintain multi-language documentation, we provide the following suggestions:
+
+1. File Naming Convention
+
+   - Use standard language codes:
+     - Chinese: `README.zh-CN.md`
+     - English: `README.en.md`
+     - Spanish: `README.es.md`
+     - Arabic: `README.ar.md`
+     - French: `README.fr.md`
+     - Russian: `README.ru.md`
+     - Japanese: `README.ja.md`
+
+2. Document Synchronization
+
+   - Use `sync-docs.js` script to automatically sync all language versions
+   - Run `npm run sync-docs` after modifying the main documentation
+   - Ensure consistent structure across all language versions
+
+3. Translation Guidelines
+
+   - Maintain consistency in technical terms
+   - Keep code examples in English
+   - Use corresponding language for comments and explanations
+   - Maintain uniform formatting
+
+4. Contribution Guidelines
+
+   - Welcome suggestions for improving multi-language versions
+   - Please update all language versions when submitting PRs
+   - Submit issues for translation problems
+
+5. Language Switching Optimization
+   - Add language switching icons at the top of each document
+   - Maintain consistent order of language version links
+   - Keep current language link in inactive state

package/README.es.md

@@ -17,4 +17,213 @@ Una herramienta de línea de comandos que genera automáticamente definiciones d
 - ⚡️ Soporte para carga de archivos
 - 🛠 Opciones configurables de generación de código
 
-[... resto del contenido similar al README.en.md pero en español ...]
+## Instalación
+
+```bash
+$ npm install anl -g
+
+$ yarn global add anl
+```
+
+## Uso
+
+1. Ejecutar el comando
+
+```bash
+$ anl type
+```
+
+2. Completar la configuración
+
+- La primera vez que ejecute `anl type`, se creará automáticamente un archivo de configuración llamado `an.config.json` en la raíz del proyecto (también puede crearlo manualmente)
+- Consulte la descripción de la configuración para obtener detalles sobre los parámetros
+- El nombre del archivo de configuración no se puede modificar
+
+```json
+{
+	"saveTypeFolderPath": "apps/types",
+	"saveApiListFolderPath": "apps/api/",
+	"saveEnumFolderPath": "apps/enums",
+	"importEnumPath": "../../enums",
+	"swaggerJsonUrl": "https://generator3.swagger.io/openapi.json",
+	"requestMethodsImportPath": "./fetch",
+	"dataLevel": "serve",
+	"formatting": {
+		"indentation": "\t",
+		"lineEnding": "\n"
+	},
+	"headers": {}
+}
+```
+
+3. Generar definiciones de tipos TypeScript y funciones de solicitud de API, ejecute el comando nuevamente
+
+```bash
+$ anl type
+```
+
+## Configuración
+
+| Parámetro                | Tipo                         | Requerido | Descripción                                       |
+| ------------------------ | ---------------------------- | --------- | ------------------------------------------------- |
+| saveTypeFolderPath       | string                       | Sí        | Ruta para guardar archivos de definición de tipos |
+| saveApiListFolderPath    | string                       | Sí        | Ruta para guardar funciones de solicitud API      |
+| saveEnumFolderPath       | string                       | Sí        | Ruta para guardar tipos enum                      |
+| importEnumPath           | string                       | Sí        | Ruta de importación para tipos enum               |
+| swaggerJsonUrl           | string                       | Sí        | URL del documento Swagger JSON                    |
+| requestMethodsImportPath | string                       | Sí        | Ruta de importación para métodos de solicitud     |
+| dataLevel                | 'data' \| 'serve' \| 'axios' | Sí        | Nivel de datos de respuesta de la API             |
+| formatting               | object                       | No        | Configuración de formato de código                |
+| headers                  | object                       | No        | Configuración de encabezados de solicitud         |
+
+## Estructura de Archivos Generados
+
+- Esta estructura de archivos se genera según el archivo de configuración
+  project/
+  ├── apps/
+  │ ├── types/
+  │ │ ├── models/ # Todos los archivos de definición de tipos (excluyendo enums)
+  │ │ ├── connectors/ # Definiciones de tipos API (archivos de interfaz)
+  │ │ └── enums/ # Definiciones de tipos enum
+  │ └── api/
+  │ ├── fetch.ts # Implementación de métodos de solicitud
+  │ └── index.ts # Funciones de solicitud API
+
+## Ejemplos de Código Generado
+
+### Archivo de Definición de Tipos
+
+```typescript
+declare namespace UserDetail_GET {
+	interface Query {
+		userId: string;
+	}
+
+	interface Response {
+		id: string;
+		name: string;
+		age: number;
+		role: UserRole;
+	}
+}
+```
+
+### Función de Solicitud API
+
+```typescript
+import { GET } from './fetch';
+
+/**
+ * Obtener detalles del usuario
+ */
+export const userDetailGet = (params: UserDetail_GET.Query) => GET<UserDetail_GET.Response>('/user/detail', params);
+```
+
+## Características Detalladas
+
+### Análisis de Tipos
+
+- Soporta todos los tipos de datos del estándar OpenAPI 3.0
+- Manejo automático de tipos anidados complejos
+- Soporte para arrays, objetos, enums y otros tipos
+- Generación automática de comentarios de interfaz
+
+### Carga de Archivos
+
+Cuando se detecta un tipo de carga de archivo, se añade automáticamente el encabezado correspondiente:
+
+```typescript
+export const uploadFile = (params: UploadFile.Body) =>
+	POST<UploadFile.Response>('/upload', params, {
+		headers: { 'Content-Type': 'multipart/form-data' },
+	});
+```
+
+### Manejo de Errores
+
+La herramienta incluye un mecanismo completo de manejo de errores:
+
+- Mensajes de error de análisis
+- Advertencias de fallos en la generación de tipos
+- Manejo de excepciones en la escritura de archivos
+
+## Desarrollo
+
+```bash
+# Instalar dependencias
+npm install
+
+# Modo desarrollo
+Presionar F5 para depurar
+
+# Construir
+npm run build
+
+# Enlace local para pruebas
+npm run blink
+```
+
+## Consideraciones
+
+1. Asegúrese de que la URL del documento Swagger JSON sea accesible
+2. Las rutas en el archivo de configuración deben ser relativas a la raíz del proyecto
+3. Los archivos generados sobrescribirán los archivos existentes con el mismo nombre
+4. Se recomienda incluir los archivos generados en el control de versiones
+
+## Problemas Comunes
+
+1. Fallo en el formato de los archivos de tipos generados
+
+   - Verificar si prettier está instalado
+   - Confirmar si existe un archivo de configuración de prettier en la raíz del proyecto
+
+2. Error en la ruta de importación de funciones de solicitud
+   - Verificar si la configuración de requestMethodsImportPath es correcta
+   - Confirmar si existe el archivo de métodos de solicitud
+
+## Guía de Contribución
+
+¡Las Issues y Pull Requests son bienvenidas!
+
+## Licencia
+
+Licencia ISC
+
+## Documentación Multilingüe
+
+Para mantener mejor la documentación multilingüe, proporcionamos las siguientes recomendaciones:
+
+1. Convención de Nombres de Archivos
+
+   - Usar códigos de idioma estándar:
+     - Chino: `README.zh-CN.md`
+     - Inglés: `README.en.md`
+     - Español: `README.es.md`
+     - Árabe: `README.ar.md`
+     - Francés: `README.fr.md`
+     - Ruso: `README.ru.md`
+     - Japonés: `README.ja.md`
+
+2. Actualización de Documentación
+
+   - Usar el script `sync-docs.js` para sincronizar automáticamente todas las versiones
+   - Ejecutar `npm run sync-docs` después de modificar la documentación principal
+   - Asegurar que todas las versiones mantengan la misma estructura
+
+3. Normas de Traducción
+
+   - Mantener consistencia en términos técnicos
+   - Mantener ejemplos de código en inglés
+   - Usar el idioma correspondiente para comentarios y explicaciones
+   - Mantener formato uniforme
+
+4. Guía de Contribución
+
+   - Se aceptan sugerencias para mejorar las versiones en diferentes idiomas
+   - Actualizar todas las versiones al enviar PR
+   - Crear Issues para problemas de traducción
+
+5. Optimización de Cambio de Idioma
+   - Añadir iconos de cambio de idioma en la parte superior de cada documento
+   - Mantener orden consistente en enlaces de idiomas
+   - Mantener enlace del idioma actual en estado inactivo

package/README.fr.md

@@ -17,4 +17,210 @@ Un outil en ligne de commande qui génère automatiquement des définitions de t
 - ⚡️ Prise en charge du téléchargement de fichiers
 - 🛠 Options de génération de code configurables
 
-[... rest of content similar to README.en.md but in French ...]
+## Installation
+
+```bash
+$ npm install anl -g
+
+$ yarn global add anl
+```
+
+## Utilisation
+
+1. Exécuter la commande
+
+```bash
+$ anl type
+```
+
+2. Configurer le projet
+
+- Lors de la première exécution de `anl type`, un fichier de configuration nommé `an.config.json` sera automatiquement créé dans le répertoire racine du projet (ou peut être créé manuellement)
+- Voir la section Configuration pour plus de détails
+- Le nom du fichier de configuration ne peut pas être modifié
+
+```json
+{
+	"saveTypeFolderPath": "apps/types",
+	"saveApiListFolderPath": "apps/api/",
+	"saveEnumFolderPath": "apps/enums",
+	"importEnumPath": "../../enums",
+	"swaggerJsonUrl": "https://generator3.swagger.io/openapi.json",
+	"requestMethodsImportPath": "./fetch",
+	"dataLevel": "serve",
+	"formatting": {
+		"indentation": "\t",
+		"lineEnding": "\n"
+	},
+	"headers": {}
+}
+```
+
+3. Générer les définitions de types TypeScript et les fonctions API en exécutant à nouveau la commande
+
+```bash
+$ anl type
+```
+
+## Configuration
+
+| Option                   | Type                         | Requis | Description                                  |
+| ------------------------ | ---------------------------- | ------ | -------------------------------------------- |
+| saveTypeFolderPath       | string                       | Oui    | Chemin de sauvegarde des fichiers de types   |
+| saveApiListFolderPath    | string                       | Oui    | Chemin de sauvegarde des fonctions API       |
+| saveEnumFolderPath       | string                       | Oui    | Chemin de sauvegarde des énumérations        |
+| importEnumPath           | string                       | Oui    | Chemin d'importation des énumérations        |
+| swaggerJsonUrl           | string                       | Oui    | URL du document Swagger JSON                 |
+| requestMethodsImportPath | string                       | Oui    | Chemin d'importation des méthodes de requête |
+| dataLevel                | 'data' \| 'serve' \| 'axios' | Oui    | Niveau de données de réponse                 |
+| formatting               | object                       | Non    | Configuration du formatage du code           |
+| headers                  | object                       | Non    | Configuration des en-têtes de requête        |
+
+## Structure des Fichiers Générés
+
+project/
+├── apps/
+│ ├── types/
+│ │ ├── models/ # Fichiers de définition de types (sans énumérations)
+│ │ ├── connectors/ # Définitions de types API
+│ │ └── enums/ # Définitions des types énumérés
+│ └── api/
+│ ├── fetch.ts # Implémentation des méthodes de requête
+│ └── index.ts # Fonctions de requête API
+
+## Exemples de Code Générés
+
+### Fichier de Définition de Type
+
+```typescript
+declare namespace UserDetail_GET {
+	interface Query {
+		userId: string;
+	}
+
+	interface Response {
+		id: string;
+		name: string;
+		age: number;
+		role: UserRole;
+	}
+}
+```
+
+### Fonction de Requête API
+
+```typescript
+import { GET } from './fetch';
+
+/**
+ * Obtenir les détails de l'utilisateur
+ */
+export const userDetailGet = (params: UserDetail_GET.Query) => GET<UserDetail_GET.Response>('/user/detail', params);
+```
+
+## Caractéristiques
+
+### Analyse des Types
+
+- Prise en charge de tous les types de données OpenAPI 3.0
+- Traitement automatique des types imbriqués complexes
+- Prise en charge des tableaux, objets, énumérations
+- Génération automatique des commentaires d'interface
+
+### Téléchargement de Fichiers
+
+```typescript
+export const uploadFile = (params: UploadFile.Body) =>
+	POST<UploadFile.Response>('/upload', params, {
+		headers: { 'Content-Type': 'multipart/form-data' },
+	});
+```
+
+### Gestion des Erreurs
+
+L'outil intègre un mécanisme complet de gestion des erreurs :
+
+- Messages d'erreur d'analyse
+- Avertissements de génération de types
+- Gestion des exceptions d'écriture de fichiers
+
+## Développement
+
+```bash
+# Installation des dépendances
+npm install
+
+# Mode développement
+Appuyez sur F5 pour déboguer
+
+# Construction
+npm run build
+
+# Liaison locale pour le débogage
+npm run blink
+```
+
+## Points Importants
+
+1. Assurez-vous que l'URL du document Swagger JSON est accessible
+2. Les chemins dans le fichier de configuration doivent être relatifs à la racine du projet
+3. Les fichiers générés écraseront les fichiers existants du même nom
+4. Il est recommandé d'inclure les fichiers générés dans le contrôle de version
+
+## FAQ
+
+1. Échec du formatage des fichiers de types générés
+
+   - Vérifiez si prettier est installé
+   - Vérifiez la présence du fichier de configuration prettier dans la racine du projet
+
+2. Erreur de chemin d'importation des fonctions de requête
+   - Vérifiez la configuration de requestMethodsImportPath
+   - Confirmez l'existence du fichier des méthodes de requête
+
+## Guide de Contribution
+
+Les Issues et Pull Requests sont les bienvenus !
+
+## Licence
+
+Licence ISC
+
+## Documentation Multilingue
+
+Pour une meilleure maintenance de la documentation multilingue, nous suggérons :
+
+1. Convention de Nommage des Fichiers
+
+   - Utilisation des codes de langue standard :
+     - Chinois : `README.zh-CN.md`
+     - Anglais : `README.en.md`
+     - Espagnol : `README.es.md`
+     - Arabe : `README.ar.md`
+     - Français : `README.fr.md`
+     - Russe : `README.ru.md`
+     - Japonais : `README.ja.md`
+
+2. Synchronisation des Documents
+
+   - Utilisez le script `sync-docs.js` pour synchroniser automatiquement
+   - Exécutez `npm run sync-docs` après les modifications
+   - Maintenez une structure cohérente dans toutes les versions
+
+3. Normes de Traduction
+
+   - Maintenir la cohérence des termes techniques
+   - Conserver les exemples de code en anglais
+   - Utiliser la langue correspondante pour les commentaires
+   - Maintenir un format uniforme
+
+4. Guide de Contribution
+
+   - Les suggestions d'amélioration multilingue sont bienvenues
+   - Mettre à jour toutes les versions lors des PR
+   - Signaler les problèmes de traduction via Issues
+
+5. Optimisation du Changement de Langue
+   - Icônes de changement de langue en haut de chaque document
+   - Ordre cohérent des liens linguistiques
+   - Lien de la langue actuelle désactivé

package/README.jp.md

@@ -17,4 +17,214 @@ Swagger JSONに基づいてTypeScriptの型定義とAPIリクエスト関数を
 - ⚡️ ファイルアップロードのサポート
 - 🛠 設定可能なコード生成オプション
 
-[... rest of content similar to README.en.md but in Japanese ...]
+## インストール
+
+```bash
+$ npm install anl -g
+
+$ yarn global add anl
+```
+
+## 使用方法
+
+1. コマンドの実行
+
+```bash
+$ anl type
+```
+
+2. 設定の完了
+
+- 初めて `anl type` コマンドを実行すると、*プロジェクトのルートディレクトリ*に `an.config.json` という名前の設定ファイルが*自動的に作成*されます（手動で作成することも可能です）。
+- 具体的なパラメータについては設定項目の説明をご覧ください。
+- 設定ファイル名は変更できません。
+
+```json
+{
+	"saveTypeFolderPath": "apps/types",
+	"saveApiListFolderPath": "apps/api/",
+	"saveEnumFolderPath": "apps/enums",
+	"importEnumPath": "../../enums",
+	"swaggerJsonUrl": "https://generator3.swagger.io/openapi.json",
+	"requestMethodsImportPath": "./fetch",
+	"dataLevel": "serve",
+	"formatting": {
+		"indentation": "\t",
+		"lineEnding": "\n"
+	},
+	"headers": {}
+}
+```
+
+3. TypeScript型定義とAPIリクエスト関数の生成は、再度生成コマンドを実行するだけです。
+
+```bash
+$ anl type
+```
+
+## 設定項目の説明
+
+| 設定項目                 | 型                           | 必須   | 説明                               |
+| ------------------------ | ---------------------------- | ------ | ---------------------------------- |
+| saveTypeFolderPath       | string                       | はい   | 型定義ファイルの保存パス           |
+| saveApiListFolderPath    | string                       | はい   | APIリクエスト関数の保存パス        |
+| saveEnumFolderPath       | string                       | はい   | 列挙型ファイルの保存パス           |
+| importEnumPath           | string                       | はい   | 列挙型のインポートパス             |
+| swaggerJsonUrl           | string                       | はい   | Swagger JSONドキュメントのURL      |
+| requestMethodsImportPath | string                       | はい   | リクエストメソッドのインポートパス |
+| dataLevel                | 'data' \| 'serve' \| 'axios' | はい   | インターフェースの戻り値レベル     |
+| formatting               | object                       | いいえ | コードフォーマット設定             |
+| headers                  | object                       | いいえ | リクエストヘッダー設定             |
+
+## 生成されるファイル構造
+
+- このファイル構造は設定ファイルに基づいて生成されます
+
+project/
+├── apps/
+│ ├── types/
+│ │ ├── models/ # すべての型定義ファイル（列挙型を除く）
+│ │ ├── connectors/ # API型定義（インターフェース定義ファイル）
+│ │ └── enums/ # 列挙型定義
+│ └── api/
+│ ├── fetch.ts # リクエストメソッドの実装
+│ └── index.ts # APIリクエスト関数
+
+## 生成されるコードの例
+
+### 型定義ファイル
+
+```typescript
+declare namespace UserDetail_GET {
+	interface Query {
+		userId: string;
+	}
+
+	interface Response {
+		id: string;
+		name: string;
+		age: number;
+		role: UserRole;
+	}
+}
+```
+
+### APIリクエスト関数
+
+```typescript
+import { GET } from './fetch';
+
+/**
+ * ユーザー詳細の取得
+ */
+export const userDetailGet = (params: UserDetail_GET.Query) => GET<UserDetail_GET.Response>('/user/detail', params);
+```
+
+## 機能の説明
+
+### 型解析
+
+- OpenAPI 3.0仕様のすべてのデータ型をサポート
+- 複雑なネスト型を自動処理
+- 配列、オブジェクト、列挙型などをサポート
+- インターフェースコメントを自動生成
+
+### ファイルアップロード
+
+ファイルアップロード型が検出された場合、対応するリクエストヘッダーが自動的に追加されます：
+
+```typescript
+export const uploadFile = (params: UploadFile.Body) =>
+	POST<UploadFile.Response>('/upload', params, {
+		headers: { 'Content-Type': 'multipart/form-data' },
+	});
+```
+
+### エラー処理
+
+ツールには包括的なエラー処理メカニズムが組み込まれています：
+
+- 解析エラーの通知
+- 型生成失敗の警告
+- ファイル書き込みの例外処理
+
+## 開発
+
+```bash
+# 依存関係のインストール
+npm install
+
+# 開発モード
+F5キーでデバッグ
+
+# ビルド
+npm run build
+
+# ローカルリンクデバッグ
+npm run blink
+```
+
+## 注意事項
+
+1. Swagger JSONドキュメントのURLにアクセスできることを確認してください
+2. 設定ファイルのパスはプロジェクトルートディレクトリからの相対パスである必要があります
+3. 生成されたファイルは既存の同名ファイルを上書きします
+4. 生成されたファイルはバージョン管理に含めることをお勧めします
+
+## よくある質問
+
+1. 生成された型ファイルのフォーマットに失敗する
+
+   - prettierがインストールされているか確認してください
+   - プロジェクトルートディレクトリにprettier設定ファイルが存在するか確認してください
+
+2. リクエスト関数のインポートパスが間違っている
+   - requestMethodsImportPathの設定が正しいか確認してください
+   - リクエストメソッドファイルが存在するか確認してください
+
+## 貢献ガイド
+
+IssueやPull Requestを歓迎します！
+
+## ライセンス
+
+ISC License
+
+## 多言語ドキュメントについて
+
+多言語ドキュメントをより良く管理するために、以下の提案を提供します：
+
+1. ファイル命名規則
+
+   - 標準的な言語コードを使用：
+     - 中国語版：`README.zh-CN.md`
+     - 英語版：`README.en.md`
+     - スペイン語版：`README.es.md`
+     - アラビア語版：`README.ar.md`
+     - フランス語版：`README.fr.md`
+     - ロシア語版：`README.ru.md`
+     - 日本語版：`README.ja.md`
+
+2. ドキュメントの同期更新
+
+   - `sync-docs.js`スクリプトを使用してすべての言語バージョンを自動同期
+   - メインドキュメントを修正後、`npm run sync-docs`を実行
+   - すべての言語バージョンの構造が一貫していることを確認
+
+3. 翻訳規則
+
+   - 専門用語の一貫性を保持
+   - コード例は英語のまま
+   - コメントと説明は対応する言語を使用
+   - レイアウトフォーマットの統一性を保持
+
+4. 貢献ガイドライン
+
+   - 多言語バージョンの改善提案を歓迎
+   - PRを提出する際は、すべての言語バージョンを更新してください
+   - 翻訳の問題を発見した場合は、Issueを提出してください
+
+5. 言語切り替えの最適化
+   - 各ドキュメントの上部に言語切り替えアイコンを追加
+   - すべての言語バージョンのリンク順序を一貫させる
+   - 現在の言語リンクは非アクティブ状態を維持

package/README.ru.md

@@ -17,4 +17,211 @@
 - ⚡️ Поддержка загрузки файлов
 - 🛠 Настраиваемые параметры генерации кода
 
-[... rest of content similar to README.en.md but in Russian ...]
+## Установка
+
+```bash
+$ npm install anl -g
+
+$ yarn global add anl
+```
+
+## Использование
+
+1. Выполните команду
+
+```bash
+$ anl type
+```
+
+2. Настройте конфигурацию
+
+- При первом выполнении команды `anl type` в корневой директории проекта автоматически создается файл конфигурации `an.config.json` (также можно создать вручную)
+- Подробное описание параметров смотрите в разделе конфигурации
+- Имя файла конфигурации изменять нельзя
+
+```json
+{
+	"saveTypeFolderPath": "apps/types",
+	"saveApiListFolderPath": "apps/api/",
+	"saveEnumFolderPath": "apps/enums",
+	"importEnumPath": "../../enums",
+	"swaggerJsonUrl": "https://generator3.swagger.io/openapi.json",
+	"requestMethodsImportPath": "./fetch",
+	"dataLevel": "serve",
+	"formatting": {
+		"indentation": "\t",
+		"lineEnding": "\n"
+	},
+	"headers": {}
+}
+```
+
+3. Сгенерируйте определения типов TypeScript и функции запросов API, выполнив команду еще раз
+
+```bash
+$ anl type
+```
+
+## Параметры конфигурации
+
+| Параметр                 | Тип                          | Обязательный | Описание                                 |
+| ------------------------ | ---------------------------- | ------------ | ---------------------------------------- |
+| saveTypeFolderPath       | string                       | Да           | Путь сохранения файлов определения типов |
+| saveApiListFolderPath    | string                       | Да           | Путь сохранения файлов функций API       |
+| saveEnumFolderPath       | string                       | Да           | Путь сохранения файлов перечислений      |
+| importEnumPath           | string                       | Да           | Путь импорта перечислений                |
+| swaggerJsonUrl           | string                       | Да           | URL документации Swagger JSON            |
+| requestMethodsImportPath | string                       | Да           | Путь импорта методов запроса             |
+| dataLevel                | 'data' \| 'serve' \| 'axios' | Да           | Уровень возвращаемых данных              |
+| formatting               | object                       | Нет          | Настройки форматирования кода            |
+| headers                  | object                       | Нет          | Настройки заголовков запроса             |
+
+## Структура генерируемых файлов
+
+├── apps/
+│ ├── types/
+│ │ ├── models/ # Все определения типов (кроме перечислений)
+│ │ ├── connectors/ # Определения типов API
+│ │ └── enums/ # Определения перечислений
+│ └── api/
+│ ├── fetch.ts # Реализация методов запроса
+│ └── index.ts # Функции запросов API
+
+## Примеры генерируемого кода
+
+### Файл определения типов
+
+```typescript
+declare namespace UserDetail_GET {
+	interface Query {
+		userId: string;
+	}
+
+	interface Response {
+		id: string;
+		name: string;
+		age: number;
+		role: UserRole;
+	}
+}
+```
+
+### Функции запросов API
+
+```typescript
+import { GET } from './fetch';
+
+/**
+ * Получить детали пользователя
+ */
+export const userDetailGet = (params: UserDetail_GET.Query) => GET<UserDetail_GET.Response>('/user/detail', params);
+```
+
+## Описание функциональности
+
+### Анализ типов
+
+- Поддержка всех типов данных спецификации OpenAPI 3.0
+- Автоматическая обработка сложных вложенных типов
+- Поддержка массивов, объектов, перечислений
+- Автоматическая генерация комментариев интерфейсов
+
+### Загрузка файлов
+
+При обнаружении типа загрузки файлов автоматически добавляются соответствующие заголовки:
+
+```typescript
+export const uploadFile = (params: UploadFile.Body) =>
+	POST<UploadFile.Response>('/upload', params, {
+		headers: { 'Content-Type': 'multipart/form-data' },
+	});
+```
+
+### Обработка ошибок
+
+Инструмент имеет встроенный механизм обработки ошибок:
+
+- Уведомления об ошибках разбора
+- Предупреждения о неудачной генерации типов
+- Обработка исключений при записи файлов
+
+## Разработка
+
+```bash
+# Установка зависимостей
+npm install
+
+# Режим разработки
+Нажмите F5 для отладки
+
+# Сборка
+npm run build
+
+# Локальная отладка
+npm run blink
+```
+
+## Важные замечания
+
+1. Убедитесь, что URL документации Swagger JSON доступен
+2. Пути в файле конфигурации должны быть относительно корневой директории проекта
+3. Генерируемые файлы перезапишут существующие файлы с тем же именем
+4. Рекомендуется добавить генерируемые файлы в систему контроля версий
+
+## Часто задаваемые вопросы
+
+1. Не удается отформатировать сгенерированные файлы типов
+
+   - Проверьте, установлен ли prettier
+   - Убедитесь, что в корневой директории проекта есть файл конфигурации prettier
+
+2. Ошибка в пути импорта функций запроса
+   - Проверьте правильность настройки requestMethodsImportPath
+   - Убедитесь, что файл с методами запроса существует
+
+## Руководство по содействию
+
+Приветствуются Issue и Pull Request!
+
+## Лицензия
+
+ISC License
+
+## Документация на разных языках
+
+Для лучшего управления многоязычной документацией мы предлагаем следующие рекомендации:
+
+1. Правила именования файлов
+
+   - Используйте стандартные языковые коды:
+     - Китайский: `README.zh-CN.md`
+     - Английский: `README.en.md`
+     - Испанский: `README.es.md`
+     - Арабский: `README.ar.md`
+     - Французский: `README.fr.md`
+     - Русский: `README.ru.md`
+     - Японский: `README.ja.md`
+
+2. Синхронизация документации
+
+   - Используйте скрипт `sync-docs.js` для автоматической синхронизации всех языковых версий
+   - Запускайте `npm run sync-docs` после изменения основной документации
+   - Обеспечьте согласованность структуры всех языковых версий
+
+3. Правила перевода
+
+   - Поддерживайте согласованность технических терминов
+   - Сохраняйте примеры кода на английском языке
+   - Используйте соответствующий язык для комментариев и пояснений
+   - Поддерживайте единообразие форматирования
+
+4. Руководство по содействию
+
+   - Приветствуются предложения по улучшению многоязычных версий
+   - Обновляйте все языковые версии при отправке PR
+   - Создавайте Issue при обнаружении проблем с переводом
+
+5. Оптимизация переключения языков
+   - Добавляйте значки переключения языков в верхней части каждого документа
+   - Поддерживайте последовательный порядок ссылок на все языковые версии
+   - Оставляйте ссылку на текущий язык неактивной

package/lib/package.json.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e="1.5.7",i="FE command line tool",s="bin/an-cli.js",p={dev:"rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript -w",build:"rimraf lib && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",pub:"bash publish.sh",ts:"tsc ./src/int.ts --noEmit --watch",blink:"npm run build && npm link","sync-docs":"node scripts/sync-docs.js"},l={anl:"bin/an-cli.js"},o="Gleason <bianliuzhu@gmail.com>",t={"@commitlint/cli":"^17.4.3","@commitlint/config-conventional":"^17.4.3","@rollup/plugin-commonjs":"^21.0.1","@rollup/plugin-json":"^4.1.0","@rollup/plugin-node-resolve":"^13.1.3","@rollup/plugin-typescript":"^8.3.0","@types/inquirer":"^9.0.3","@types/shelljs":"^0.8.11","@typescript-eslint/eslint-plugin":"^5.52.0","@typescript-eslint/parser":"^5.52.0","cross-env":"^7.0.3",eslint:"^8.7.0",husky:"^8.0.3","openapi-types":"^12.1.3",prettier:"^3.3.2",rimraf:"^5.0.7",rollup:"^2.64.0","rollup-plugin-cleandir":"^2.0.0","rollup-plugin-copy":"^3.5.0","rollup-plugin-terser":"^7.0.2",typescript:"^4.5.4"},r={"app-root-path":"^3.1.0",cac:"^6.7.12",chalk:"4.*","clear-console":"^1.1.0",commander:"^10.0.0",figures:"^6.1.0",inquirer:"^10.1.8","log-symbols":"^5.1.0",ora:"5.*","progress-estimator":"^0.3.0",shelljs:"^0.8.5"},n=["typescript","cli","typescript 脚手架","ts 脚手架","ts-cli","脚手架"],c=["package.json","README.md","lib","template"],u={type:"git",url:"https://github.com/bianliuzhu/an-cli.git"},a="commonjs",m={name:"anl",version:e,description:i,main:s,scripts:p,bin:l,author:o,license:"ISC",devDependencies:t,dependencies:r,keywords:n,files:c,repository:u,type:a};exports.author=o,exports.bin=l,exports.default=m,exports.dependencies=r,exports.description=i,exports.devDependencies=t,exports.files=c,exports.keywords=n,exports.license="ISC",exports.main=s,exports.name="anl",exports.repository=u,exports.scripts=p,exports.type=a,exports.version=e;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e="1.5.9",i="FE command line tool",s="bin/an-cli.js",p={dev:"rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript -w",build:"rimraf lib && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",pub:"bash publish.sh",ts:"tsc ./src/int.ts --noEmit --watch",blink:"npm run build && npm link","sync-docs":"node scripts/sync-docs.js"},l={anl:"bin/an-cli.js"},o="Gleason <bianliuzhu@gmail.com>",t={"@commitlint/cli":"^17.4.3","@commitlint/config-conventional":"^17.4.3","@rollup/plugin-commonjs":"^21.0.1","@rollup/plugin-json":"^4.1.0","@rollup/plugin-node-resolve":"^13.1.3","@rollup/plugin-typescript":"^8.3.0","@types/inquirer":"^9.0.3","@types/shelljs":"^0.8.11","@typescript-eslint/eslint-plugin":"^5.52.0","@typescript-eslint/parser":"^5.52.0","cross-env":"^7.0.3",eslint:"^8.7.0",husky:"^8.0.3","openapi-types":"^12.1.3",prettier:"^3.3.2",rimraf:"^5.0.7",rollup:"^2.64.0","rollup-plugin-cleandir":"^2.0.0","rollup-plugin-copy":"^3.5.0","rollup-plugin-terser":"^7.0.2",typescript:"^4.5.4"},r={"app-root-path":"^3.1.0",cac:"^6.7.12",chalk:"4.*","clear-console":"^1.1.0",commander:"^10.0.0",figures:"^6.1.0",inquirer:"^10.1.8","log-symbols":"^5.1.0",ora:"5.*","progress-estimator":"^0.3.0",shelljs:"^0.8.5"},n=["typescript","cli","typescript 脚手架","ts 脚手架","ts-cli","脚手架"],c=["package.json","README.md","lib","template"],u={type:"git",url:"https://github.com/bianliuzhu/an-cli.git"},a="commonjs",m={name:"anl",version:e,description:i,main:s,scripts:p,bin:l,author:o,license:"ISC",devDependencies:t,dependencies:r,keywords:n,files:c,repository:u,type:a};exports.author=o,exports.bin=l,exports.default=m,exports.dependencies=r,exports.description=i,exports.devDependencies=t,exports.files=c,exports.keywords=n,exports.license="ISC",exports.main=s,exports.name="anl",exports.repository=u,exports.scripts=p,exports.type=a,exports.version=e;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "anl",
-	"version": "1.5.7",
+	"version": "1.5.9",
 	"description": "FE command line tool",
 	"main": "bin/an-cli.js",
 	"scripts": {