xertica-ui 2.3.0 → 2.4.0

package/templates/src/i18n.ts

@@ -1,124 +1,124 @@
-// ─────────────────────────────────────────────────────────────────────────────
-// i18n.ts — i18next configuration
-//
-// Import this file once at the application entry point (main.tsx) BEFORE any
-// component is rendered. The side-effect initializes i18next synchronously so
-// that `useTranslation()` is ready on first render.
-//
-// Locale layout (split for maintainability — merged at boot into a single
-// `translation` namespace so all existing `t('home.welcome')`-style calls
-// keep working without changes):
-//
-//   locales/<lang>/{common,nav,errors,languageSelector,themeToggle}.json
-//   locales/<lang>/pages/{home,templates,login,resetPassword,verifyEmail}.json
-//   locales/<lang>/components/{assistant,sidebar,media,projectCard,
-//                              profileCard,notificationCard,activityCard,
-//                              stats,team}.json
-//
-// The chunks for each language are gathered via `import.meta.glob` (resolved
-// statically at build time by Vite — no runtime fetch, fully tree-shakable),
-// so adding a new JSON file under `locales/<lang>/...` is picked up
-// automatically without touching this file.
-//
-// Adding a language — three options:
-//
-// Option A) Drop-in via LanguageProvider (recommended for app consumers):
-//   <LanguageProvider availableLanguages={[
-//     ...DEFAULT_LANGUAGES,
-//     { code: 'fr', label: 'Français', resources: frJson },
-//   ]}>
-//   The provider calls i18n.addResourceBundle() automatically.
-//
-// Option B) Manual registration via the helper exported below:
-//   import { registerLanguageResource } from 'xertica-ui';
-//   registerLanguageResource('fr', frJson);
-//
-// Option C) Add it here statically (only for the library itself):
-//   1. Create the new locales/<code>/ folder (mirror an existing language)
-//   2. Add one more `import.meta.glob` call below + an entry in `resources`.
-// ─────────────────────────────────────────────────────────────────────────────
-
-import i18n from 'i18next';
-import { initReactI18next } from 'react-i18next';
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Build a single { key: contents } bundle from a Vite glob result.
-//
-// Input  (Vite glob output): { './locales/pt-BR/common.json': {...},
-//                              './locales/pt-BR/pages/home.json': {...},
-//                              './locales/pt-BR/components/assistant.json': {...},
-//                              ... }
-// Output (bundle for i18n) : { common: {...}, home: {...}, assistant: {...}, ... }
-//
-// Keys are derived from the file basename — folder (pages/components) is
-// discarded because the legacy flat JSON had a single namespace.
-// ─────────────────────────────────────────────────────────────────────────────
-function bundleLang(chunks: Record<string, unknown>): Record<string, unknown> {
-  const out: Record<string, unknown> = {};
-  for (const [filePath, value] of Object.entries(chunks)) {
-    const base = filePath.split('/').pop();
-    if (!base) continue;
-    const key = base.replace(/\.json$/, '');
-    out[key] = value;
-  }
-  return out;
-}
-
-// `import.meta.glob` requires a literal pattern — we expand it once per
-// language. `eager: true` inlines the JSON at build time. `import: 'default'`
-// returns the JSON value directly instead of `{ default: ... }`.
-const ptBR = bundleLang(
-  import.meta.glob('./locales/pt-BR/**/*.json', { eager: true, import: 'default' })
-);
-const en = bundleLang(
-  import.meta.glob('./locales/en/**/*.json', { eager: true, import: 'default' })
-);
-const es = bundleLang(
-  import.meta.glob('./locales/es/**/*.json', { eager: true, import: 'default' })
-);
-
-const STORAGE_KEY = 'xertica_language';
-const DEFAULT_FALLBACK = 'pt-BR';
-
-const savedLanguage =
-  typeof window !== 'undefined'
-    ? (localStorage.getItem(STORAGE_KEY) ?? DEFAULT_FALLBACK)
-    : DEFAULT_FALLBACK;
-
-i18n.use(initReactI18next).init({
-  resources: {
-    'pt-BR': { translation: ptBR },
-    en: { translation: en },
-    es: { translation: es },
-  },
-  lng: savedLanguage,
-  fallbackLng: DEFAULT_FALLBACK,
-  interpolation: {
-    // React already escapes values — no need for i18next to double-escape
-    escapeValue: false,
-  },
-});
-
-/**
- * Register an additional locale at runtime. Useful when an app wants to add a
- * language without editing the i18n.ts file itself. Safe to call multiple
- * times — a bundle is only added the first time it appears for a given
- * `(code, namespace)` pair.
- *
- * @param code   BCP-47 language code (e.g. `'fr'`, `'ja'`, `'pt-PT'`)
- * @param json   Translation object — same shape as the bundled `<lang>` object
- *               above (top-level keys `common`, `nav`, `home`, etc.)
- * @param ns     Translation namespace (defaults to `'translation'`, which is
- *               the only namespace used by Xertica UI)
- */
-export function registerLanguageResource(
-  code: string,
-  json: Record<string, unknown>,
-  ns: string = 'translation'
-): void {
-  if (!i18n.hasResourceBundle(code, ns)) {
-    i18n.addResourceBundle(code, ns, json, true, true);
-  }
-}
-
-export default i18n;
+// ─────────────────────────────────────────────────────────────────────────────
+// i18n.ts — i18next configuration
+//
+// Import this file once at the application entry point (main.tsx) BEFORE any
+// component is rendered. The side-effect initializes i18next synchronously so
+// that `useTranslation()` is ready on first render.
+//
+// Locale layout (split for maintainability — merged at boot into a single
+// `translation` namespace so all existing `t('home.welcome')`-style calls
+// keep working without changes):
+//
+//   locales/<lang>/{common,nav,errors,languageSelector,themeToggle}.json
+//   locales/<lang>/pages/{home,templates,login,resetPassword,verifyEmail}.json
+//   locales/<lang>/components/{assistant,sidebar,media,projectCard,
+//                              profileCard,notificationCard,activityCard,
+//                              stats,team}.json
+//
+// The chunks for each language are gathered via `import.meta.glob` (resolved
+// statically at build time by Vite — no runtime fetch, fully tree-shakable),
+// so adding a new JSON file under `locales/<lang>/...` is picked up
+// automatically without touching this file.
+//
+// Adding a language — three options:
+//
+// Option A) Drop-in via LanguageProvider (recommended for app consumers):
+//   <LanguageProvider availableLanguages={[
+//     ...DEFAULT_LANGUAGES,
+//     { code: 'fr', label: 'Français', resources: frJson },
+//   ]}>
+//   The provider calls i18n.addResourceBundle() automatically.
+//
+// Option B) Manual registration via the helper exported below:
+//   import { registerLanguageResource } from 'xertica-ui';
+//   registerLanguageResource('fr', frJson);
+//
+// Option C) Add it here statically (only for the library itself):
+//   1. Create the new locales/<code>/ folder (mirror an existing language)
+//   2. Add one more `import.meta.glob` call below + an entry in `resources`.
+// ─────────────────────────────────────────────────────────────────────────────
+
+import i18n from 'i18next';
+import { initReactI18next } from 'react-i18next';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Build a single { key: contents } bundle from a Vite glob result.
+//
+// Input  (Vite glob output): { './locales/pt-BR/common.json': {...},
+//                              './locales/pt-BR/pages/home.json': {...},
+//                              './locales/pt-BR/components/assistant.json': {...},
+//                              ... }
+// Output (bundle for i18n) : { common: {...}, home: {...}, assistant: {...}, ... }
+//
+// Keys are derived from the file basename — folder (pages/components) is
+// discarded because the legacy flat JSON had a single namespace.
+// ─────────────────────────────────────────────────────────────────────────────
+function bundleLang(chunks: Record<string, unknown>): Record<string, unknown> {
+  const out: Record<string, unknown> = {};
+  for (const [filePath, value] of Object.entries(chunks)) {
+    const base = filePath.split('/').pop();
+    if (!base) continue;
+    const key = base.replace(/\.json$/, '');
+    out[key] = value;
+  }
+  return out;
+}
+
+// `import.meta.glob` requires a literal pattern — we expand it once per
+// language. `eager: true` inlines the JSON at build time. `import: 'default'`
+// returns the JSON value directly instead of `{ default: ... }`.
+const ptBR = bundleLang(
+  import.meta.glob('./locales/pt-BR/**/*.json', { eager: true, import: 'default' })
+);
+const en = bundleLang(
+  import.meta.glob('./locales/en/**/*.json', { eager: true, import: 'default' })
+);
+const es = bundleLang(
+  import.meta.glob('./locales/es/**/*.json', { eager: true, import: 'default' })
+);
+
+const STORAGE_KEY = 'xertica_language';
+const DEFAULT_FALLBACK = 'pt-BR';
+
+const savedLanguage =
+  typeof window !== 'undefined'
+    ? (localStorage.getItem(STORAGE_KEY) ?? DEFAULT_FALLBACK)
+    : DEFAULT_FALLBACK;
+
+i18n.use(initReactI18next).init({
+  resources: {
+    'pt-BR': { translation: ptBR },
+    en: { translation: en },
+    es: { translation: es },
+  },
+  lng: savedLanguage,
+  fallbackLng: DEFAULT_FALLBACK,
+  interpolation: {
+    // React already escapes values — no need for i18next to double-escape
+    escapeValue: false,
+  },
+});
+
+/**
+ * Register an additional locale at runtime. Useful when an app wants to add a
+ * language without editing the i18n.ts file itself. Safe to call multiple
+ * times — a bundle is only added the first time it appears for a given
+ * `(code, namespace)` pair.
+ *
+ * @param code   BCP-47 language code (e.g. `'fr'`, `'ja'`, `'pt-PT'`)
+ * @param json   Translation object — same shape as the bundled `<lang>` object
+ *               above (top-level keys `common`, `nav`, `home`, etc.)
+ * @param ns     Translation namespace (defaults to `'translation'`, which is
+ *               the only namespace used by Xertica UI)
+ */
+export function registerLanguageResource(
+  code: string,
+  json: Record<string, unknown>,
+  ns: string = 'translation'
+): void {
+  if (!i18n.hasResourceBundle(code, ns)) {
+    i18n.addResourceBundle(code, ns, json, true, true);
+  }
+}
+
+export default i18n;

package/templates/src/locales/en/common.json

@@ -1,21 +1,21 @@
-{
-  "view": "View",
-  "edit": "Edit",
-  "delete": "Delete",
-  "cancel": "Cancel",
-  "save": "Save",
-  "confirm": "Confirm",
-  "loading": "Loading...",
-  "error": "Error",
-  "previous": "Previous",
-  "next": "Next",
-  "new": "New",
-  "active": "Active",
-  "inactive": "Inactive",
-  "away": "Away",
-  "close": "Close",
-  "copied": "Copied",
-  "copyCode": "Copy code",
-  "seeMore": "See more",
-  "seeLess": "See less"
-}
+{
+  "view": "View",
+  "edit": "Edit",
+  "delete": "Delete",
+  "cancel": "Cancel",
+  "save": "Save",
+  "confirm": "Confirm",
+  "loading": "Loading...",
+  "error": "Error",
+  "previous": "Previous",
+  "next": "Next",
+  "new": "New",
+  "active": "Active",
+  "inactive": "Inactive",
+  "away": "Away",
+  "close": "Close",
+  "copied": "Copied",
+  "copyCode": "Copy code",
+  "seeMore": "See more",
+  "seeLess": "See less"
+}

package/templates/src/locales/en/components/activityCard.json

@@ -1,10 +1,10 @@
-{
-  "title": "Recent Activity",
-  "type": {
-    "create": "Created",
-    "update": "Updated",
-    "remove": "Removed",
-    "comment": "Commented",
-    "deploy": "Deploy"
-  }
-}
+{
+  "title": "Recent Activity",
+  "type": {
+    "create": "Created",
+    "update": "Updated",
+    "remove": "Removed",
+    "comment": "Commented",
+    "deploy": "Deploy"
+  }
+}

package/templates/src/locales/en/components/assistant.json

@@ -1,119 +1,119 @@
-{
-  "title": "Xertica Assistant",
-  "defaultUserName": "User",
-  "defaultWelcomeMessage": "How can I help you?",
-  "greeting": "Hello, {{name}}",
-  "open": "Open assistant",
-  "expand": "Expand assistant",
-  "collapse": "Collapse assistant",
-  "moreSuggestions": "More suggestions",
-  "back": "Back",
-  "inputPlaceholder": "Send a message",
-  "uploadDocument": "Upload document",
-  "uploadAudio": "Upload audio",
-  "download": "Download",
-  "generatePodcast": "Generate Podcast",
-  "like": "Like",
-  "dislike": "Dislike",
-  "copied": "Copied",
-  "copyMessage": "Copy message",
-  "audioNotSupported": "Your browser does not support the audio element.",
-  "searchResultsFound": "Results Found",
-  "searchSources": "Consulted Sources",
-  "searchActions": "What you can do with these results",
-  "searchSaved": "Search saved",
-  "processing": "Processing...",
-  "newConversation": "New Conversation",
-  "noFavorites": "No favorite conversations yet",
-  "noHistory": "No conversation history",
-  "closeDocumentEditor": "Close document editor",
-  "documentEditorPlaceholder": "Start typing the content of your document here...",
-  "recordingAudio": "Recording audio",
-  "stopRecording": "Stop recording",
-  "viewActions": "View actions",
-  "attachFile": "Attach file",
-  "suggestWithVoice": "Suggest with voice",
-  "removeAction": "Remove action",
-  "sendMessage": "Send message",
-  "disclaimer": "The Xertica assistant may make mistakes. Consider verifying important information.",
-  "recordingStarted": "Recording started",
-  "recordingDescription": "Speak your message...",
-  "recordingDescriptionFull": "Speak your question or command. Recording will stop automatically in 60s.",
-  "podcastName": "Podcast",
-  "likeToast": "Thank you for the positive rating!",
-  "feedbackToast": "Thank you for your feedback. We will improve.",
-  "defaultSuggestions": {
-    "createDocument": "Help me create a professional document",
-    "searchFiles": "Search my files for \"report\"",
-    "summarizeConversations": "Summarize the important conversations from this week",
-    "createPodcast": "Create a podcast about the last project"
-  },
-  "voiceTranscriptions": {
-    "salesData": "How can I analyze last quarter's sales data?",
-    "performanceReport": "Help me create a team performance report",
-    "marketTrends": "What are the main current market trends?",
-    "customerSatisfaction": "I need insights on customer satisfaction",
-    "teamProductivity": "How can I improve my team's productivity?",
-    "keyMetrics": "Show me a summary of the most important metrics",
-    "digitalMarketing": "Create a document on digital marketing techniques",
-    "socialEngagement": "Analyze the social media engagement data"
-  },
-  "tabs": {
-    "chat": "Chat",
-    "chatLabel": "View chat",
-    "history": "History",
-    "historyLabel": "View conversation history",
-    "favorites": "Favorites",
-    "favoritesLabel": "View favorite messages"
-  },
-  "actions": {
-    "createDocument": "Create document",
-    "createDocumentDesc": "Generate a complete document",
-    "generatePodcast": "Generate podcast",
-    "generatePodcastDesc": "Create an audio podcast",
-    "search": "Search",
-    "searchDesc": "Search for relevant information"
-  },
-  "feedbackDialog": {
-    "title": "Send feedback",
-    "titleWithCategory": "Send feedback: {{category}}",
-    "description": "Tell us why this response was not helpful so we can improve.",
-    "descriptionOptional": "Would you like to add a comment? (Optional)",
-    "placeholder": "Describe the reason...",
-    "placeholderOptional": "Additional comment...",
-    "confirmAndSend": "Confirm and Send",
-    "send": "Send Feedback"
-  },
-  "suggestions": {
-    "whatCanIAsk": "What can I ask you to do?",
-    "whatDoYouDo": "What do you do?",
-    "whichProjects": "Which projects should I focus on now?",
-    "nextProject": "What is my next project?"
-  },
-  "richSuggestions": {
-    "viewPerformance": "View performance analysis",
-    "generateReport": "Generate project report",
-    "createDocument": "Create requirements document",
-    "generatePodcast": "Generate daily summary podcast"
-  },
-  "feedback": {
-    "notWhatIWanted": "Not what I was looking for",
-    "incorrectInfo": "Incorrect information",
-    "incompleteAnswer": "Incomplete answer",
-    "other": "Other..."
-  },
-  "page": {
-    "today": "Today",
-    "yesterday": "Yesterday",
-    "thisWeek": "This week",
-    "searchConversations": "Search conversations...",
-    "rename": "Rename",
-    "delete": "Delete",
-    "cancel": "Cancel",
-    "save": "Save",
-    "deleteConversationTitle": "Delete conversation",
-    "deleteConversationDesc": "Are you sure you want to delete \"{{name}}\"? This action cannot be undone.",
-    "renameConversationTitle": "Rename conversation",
-    "conversationNameLabel": "Conversation name"
-  }
-}
+{
+  "title": "Xertica Assistant",
+  "defaultUserName": "User",
+  "defaultWelcomeMessage": "How can I help you?",
+  "greeting": "Hello, {{name}}",
+  "open": "Open assistant",
+  "expand": "Expand assistant",
+  "collapse": "Collapse assistant",
+  "moreSuggestions": "More suggestions",
+  "back": "Back",
+  "inputPlaceholder": "Send a message",
+  "uploadDocument": "Upload document",
+  "uploadAudio": "Upload audio",
+  "download": "Download",
+  "generatePodcast": "Generate Podcast",
+  "like": "Like",
+  "dislike": "Dislike",
+  "copied": "Copied",
+  "copyMessage": "Copy message",
+  "audioNotSupported": "Your browser does not support the audio element.",
+  "searchResultsFound": "Results Found",
+  "searchSources": "Consulted Sources",
+  "searchActions": "What you can do with these results",
+  "searchSaved": "Search saved",
+  "processing": "Processing...",
+  "newConversation": "New Conversation",
+  "noFavorites": "No favorite conversations yet",
+  "noHistory": "No conversation history",
+  "closeDocumentEditor": "Close document editor",
+  "documentEditorPlaceholder": "Start typing the content of your document here...",
+  "recordingAudio": "Recording audio",
+  "stopRecording": "Stop recording",
+  "viewActions": "View actions",
+  "attachFile": "Attach file",
+  "suggestWithVoice": "Suggest with voice",
+  "removeAction": "Remove action",
+  "sendMessage": "Send message",
+  "disclaimer": "The Xertica assistant may make mistakes. Consider verifying important information.",
+  "recordingStarted": "Recording started",
+  "recordingDescription": "Speak your message...",
+  "recordingDescriptionFull": "Speak your question or command. Recording will stop automatically in 60s.",
+  "podcastName": "Podcast",
+  "likeToast": "Thank you for the positive rating!",
+  "feedbackToast": "Thank you for your feedback. We will improve.",
+  "defaultSuggestions": {
+    "createDocument": "Help me create a professional document",
+    "searchFiles": "Search my files for \"report\"",
+    "summarizeConversations": "Summarize the important conversations from this week",
+    "createPodcast": "Create a podcast about the last project"
+  },
+  "voiceTranscriptions": {
+    "salesData": "How can I analyze last quarter's sales data?",
+    "performanceReport": "Help me create a team performance report",
+    "marketTrends": "What are the main current market trends?",
+    "customerSatisfaction": "I need insights on customer satisfaction",
+    "teamProductivity": "How can I improve my team's productivity?",
+    "keyMetrics": "Show me a summary of the most important metrics",
+    "digitalMarketing": "Create a document on digital marketing techniques",
+    "socialEngagement": "Analyze the social media engagement data"
+  },
+  "tabs": {
+    "chat": "Chat",
+    "chatLabel": "View chat",
+    "history": "History",
+    "historyLabel": "View conversation history",
+    "favorites": "Favorites",
+    "favoritesLabel": "View favorite messages"
+  },
+  "actions": {
+    "createDocument": "Create document",
+    "createDocumentDesc": "Generate a complete document",
+    "generatePodcast": "Generate podcast",
+    "generatePodcastDesc": "Create an audio podcast",
+    "search": "Search",
+    "searchDesc": "Search for relevant information"
+  },
+  "feedbackDialog": {
+    "title": "Send feedback",
+    "titleWithCategory": "Send feedback: {{category}}",
+    "description": "Tell us why this response was not helpful so we can improve.",
+    "descriptionOptional": "Would you like to add a comment? (Optional)",
+    "placeholder": "Describe the reason...",
+    "placeholderOptional": "Additional comment...",
+    "confirmAndSend": "Confirm and Send",
+    "send": "Send Feedback"
+  },
+  "suggestions": {
+    "whatCanIAsk": "What can I ask you to do?",
+    "whatDoYouDo": "What do you do?",
+    "whichProjects": "Which projects should I focus on now?",
+    "nextProject": "What is my next project?"
+  },
+  "richSuggestions": {
+    "viewPerformance": "View performance analysis",
+    "generateReport": "Generate project report",
+    "createDocument": "Create requirements document",
+    "generatePodcast": "Generate daily summary podcast"
+  },
+  "feedback": {
+    "notWhatIWanted": "Not what I was looking for",
+    "incorrectInfo": "Incorrect information",
+    "incompleteAnswer": "Incomplete answer",
+    "other": "Other..."
+  },
+  "page": {
+    "today": "Today",
+    "yesterday": "Yesterday",
+    "thisWeek": "This week",
+    "searchConversations": "Search conversations...",
+    "rename": "Rename",
+    "delete": "Delete",
+    "cancel": "Cancel",
+    "save": "Save",
+    "deleteConversationTitle": "Delete conversation",
+    "deleteConversationDesc": "Are you sure you want to delete \"{{name}}\"? This action cannot be undone.",
+    "renameConversationTitle": "Rename conversation",
+    "conversationNameLabel": "Conversation name"
+  }
+}

package/templates/src/locales/en/components/media.json

@@ -1,29 +1,29 @@
-{
-  "audioTitle": "Audio",
-  "video": "Video",
-  "untitledVideo": "Untitled Video",
-  "play": "Play",
-  "pause": "Pause",
-  "mute": "Mute",
-  "unmute": "Unmute",
-  "restart": "Restart",
-  "info": "Info",
-  "speed": "Speed",
-  "speedLabel": "Speed ({{speed}}x)",
-  "downloadAudio": "Download Audio",
-  "downloadFile": "Download file",
-  "moreOptions": "More options",
-  "closePlayer": "Close player",
-  "selectSpeed": "Select speed",
-  "audioInfo": "Audio info",
-  "playbackProgress": "Playback progress",
-  "videoProgress": "Video progress",
-  "volume": "Volume",
-  "floatingMode": "Floating Mode",
-  "openFloatingMode": "Open floating mode",
-  "playingMedia": "Playing Media",
-  "playingFloating": "Playing in floating window",
-  "restoreToPage": "Restore to page",
-  "restore": "Restore",
-  "popOut": "Pop-out Player"
-}
+{
+  "audioTitle": "Audio",
+  "video": "Video",
+  "untitledVideo": "Untitled Video",
+  "play": "Play",
+  "pause": "Pause",
+  "mute": "Mute",
+  "unmute": "Unmute",
+  "restart": "Restart",
+  "info": "Info",
+  "speed": "Speed",
+  "speedLabel": "Speed ({{speed}}x)",
+  "downloadAudio": "Download Audio",
+  "downloadFile": "Download file",
+  "moreOptions": "More options",
+  "closePlayer": "Close player",
+  "selectSpeed": "Select speed",
+  "audioInfo": "Audio info",
+  "playbackProgress": "Playback progress",
+  "videoProgress": "Video progress",
+  "volume": "Volume",
+  "floatingMode": "Floating Mode",
+  "openFloatingMode": "Open floating mode",
+  "playingMedia": "Playing Media",
+  "playingFloating": "Playing in floating window",
+  "restoreToPage": "Restore to page",
+  "restore": "Restore",
+  "popOut": "Pop-out Player"
+}

package/templates/src/locales/en/components/notificationCard.json

@@ -1,5 +1,5 @@
-{
-  "title": "Notifications",
-  "markAllRead": "Mark all as read",
-  "viewAll": "View all notifications"
-}
+{
+  "title": "Notifications",
+  "markAllRead": "Mark all as read",
+  "viewAll": "View all notifications"
+}

package/templates/src/locales/en/components/profileCard.json

@@ -1,8 +1,8 @@
-{
-  "status": {
-    "online": "Online",
-    "offline": "Offline",
-    "away": "Away",
-    "busy": "Busy"
-  }
-}
+{
+  "status": {
+    "online": "Online",
+    "offline": "Offline",
+    "away": "Away",
+    "busy": "Busy"
+  }
+}