@skywu/virtual-chat-sdk 1.8.0 → 1.9.0

package/README.md

@@ -1,13 +1,14 @@
-# @virtual-chat/sdk
+# @skywu/virtual-chat-sdk
 
-[![npm version](https://badge.fury.io/js/%40virtual-chat%2Fsdk.svg)](https://badge.fury.io/js/%40virtual-chat%2Fsdk)
+[![npm version](https://badge.fury.io/js/%40skywu%2Fvirtual-chat-sdk.svg)](https://badge.fury.io/js/%40skywu%2Fvirtual-chat-sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A modern JavaScript/TypeScript SDK for embedding floating chat widgets into web applications. Features real-time messaging, virtual chat simulations, and seamless integration.
+A modern JavaScript/TypeScript SDK for embedding floating chat widgets into web applications. Features real-time messaging, virtual chat simulations, **20+ languages support**, and seamless integration.
 
 ## ✨ Features
 
 - 🎈 **Floating Button Mode** - Non-intrusive chat widget with smooth expand/collapse animations
+- 🌍 **20+ Languages** - Built-in i18n support (English, 简体中文, 繁體中文, Español, हिन्दी, العربية, Português, Deutsch, 日本語, 한국어, Français, Русский, Italiano, Türkçe, Polski, Tiếng Việt, ไทย, Bahasa Indonesia, Nederlands, and more)
 - 🎨 **Multiple UI Templates** - WhatsApp and Telegram-style themes with dark mode support
 - ⚡ **Real-time Communication** - WebSocket-based messaging with automatic reconnection
 - 📱 **Responsive Design** - Optimized for desktop, tablet, and mobile devices
@@ -22,13 +23,13 @@ A modern JavaScript/TypeScript SDK for embedding floating chat widgets into web
 
 ```bash
 # npm
-npm install @virtual-chat/sdk
+npm install @skywu/virtual-chat-sdk
 
 # yarn
-yarn add @virtual-chat/sdk
+yarn add @skywu/virtual-chat-sdk
 
 # pnpm
-pnpm add @virtual-chat/sdk
+pnpm add @skywu/virtual-chat-sdk
 ```
 
 ### CDN (Browser)
@@ -200,7 +201,7 @@ const chat = ChatSDK.init({
 | `templateId` | `string` | `undefined` | Specific template to load (uses project default if not specified) |
 | `userId` | `string` | Auto-generated | Unique user identifier |
 | `username` | `string` | Auto-generated | Display name for the user |
-| `language` | `string` | `'en'` | Language code (en, zh, es, fr, de, ja, ko, etc.) |
+| `language` | `string` | `'en'` | Language code: `'en'`, `'zh'`, `'zh-TW'`, `'es'`, `'hi'`, `'ar'`, `'pt'`, `'de'`, `'ja'`, `'ko'`, `'fr'`, `'ru'`, `'it'`, `'tr'`, `'pl'`, `'vi'`, `'th'`, `'id'`, `'nl'` |
 | `theme` | `'light' \| 'dark' \| 'auto'` | `'light'` | UI theme |
 | `uiTemplate` | `'whatsapp' \| 'telegram' \| 'discord' \| 'slack'` | `'whatsapp'` | Chat UI style |
 | `width` | `string \| number` | `'400px'` | Widget width |
@@ -343,23 +344,35 @@ const chat = ChatSDK.init({
 });
 ```
 
-### Multi-language Support
+### Multi-language Support (20+ Languages)
 
 ```javascript
 const chat = ChatSDK.init({
   container: '#chat',
   projectId: 'support-chat',
-  language: 'en' // Start with English
+  language: 'en', // Start with English
+  mode: 'floating'
 });
 
-// Language switcher
+// Language switcher - dynamically change UI language
 document.getElementById('lang-zh').addEventListener('click', () => {
-  chat.setLanguage('zh');
+  chat.setLanguage('zh'); // 简体中文
 });
 
 document.getElementById('lang-es').addEventListener('click', () => {
-  chat.setLanguage('es');
+  chat.setLanguage('es'); // Español
 });
+
+document.getElementById('lang-ar').addEventListener('click', () => {
+  chat.setLanguage('ar'); // العربية (RTL support)
+});
+
+// Supported languages:
+// 'en' (English), 'zh' (简体中文), 'zh-TW' (繁體中文), 'es' (Español),
+// 'hi' (हिन्दी), 'ar' (العربية), 'pt' (Português), 'de' (Deutsch),
+// 'ja' (日本語), 'ko' (한국어), 'fr' (Français), 'ru' (Русский),
+// 'it' (Italiano), 'tr' (Türkçe), 'pl' (Polski), 'vi' (Tiếng Việt),
+// 'th' (ไทย), 'id' (Bahasa Indonesia), 'nl' (Nederlands)
 ```
 
 ### Event-driven Integration
@@ -406,11 +419,13 @@ const chat = ChatSDK.init({
 The SDK includes full TypeScript definitions:
 
 ```typescript
-import { ChatSDK, ChatSDKConfig, ChatMessage } from '@virtual-chat/sdk';
+import { ChatSDK, ChatSDKConfig, ChatMessage } from '@skywu/virtual-chat-sdk';
 
 const config: ChatSDKConfig = {
   container: '#chat',
   projectId: 'my-project',
+  language: 'zh', // 简体中文
+  mode: 'floating',
   onMessage: (message: ChatMessage) => {
     console.log(message.content);
   }