xertica-ui 2.5.3 → 2.7.0

package/templates/src/i18n.ts

@@ -20,6 +20,15 @@
 // so adding a new JSON file under `locales/<lang>/...` is picked up
 // automatically without touching this file.
 //
+// Singleton guard: `node_modules/i18next` is a single instance shared (hoisted)
+// between this app and xertica-ui itself. `i18n.init()` fully replaces the
+// resource store rather than merging, so calling it unconditionally here would
+// race with the library's own bootstrap — whichever side initializes last wins
+// and silently wipes the other's resources. To avoid this, we only call
+// `.init()` if i18next hasn't been initialized yet; otherwise we merge our
+// resources in via `addResourceBundle(..., overwrite: false)` so a
+// design-system default never clobbers a key this app has already registered.
+//
 // Adding a language — three options:
 //
 // Option A) Drop-in via LanguageProvider (recommended for app consumers):
@@ -85,19 +94,33 @@ const savedLanguage =
     ? (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,
-  },
-});
+const defaultResourcesByLang: Record<string, Record<string, unknown>> = {
+  'pt-BR': ptBR,
+  en,
+  es,
+};
+
+if (!i18n.isInitialized) {
+  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,
+    },
+  });
+} else {
+  // Already initialized by xertica-ui's own bootstrap — merge our resources in
+  // without overwriting keys the library has already registered.
+  for (const [lang, resources] of Object.entries(defaultResourcesByLang)) {
+    i18n.addResourceBundle(lang, 'translation', resources, true, false);
+  }
+}
 
 /**
  * Register an additional locale at runtime. Useful when an app wants to add a

package/templates/src/locales/en/pages/settings.json

@@ -0,0 +1,15 @@
+{
+  "title": "Settings",
+  "subtitle": "Manage your account and application preferences",
+  "account": "Account",
+  "accountDescription": "Your account information",
+  "email": "Email",
+  "preferences": "Preferences",
+  "preferencesDescription": "Customize your experience",
+  "theme": "Theme",
+  "themeDescription": "Toggle between light and dark mode",
+  "language": "Language",
+  "languageDescription": "Choose the interface language",
+  "logout": "Log out",
+  "logoutDescription": "End your session on this device"
+}

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

@@ -1,317 +1,9 @@
 {
   "breadcrumb": "Template Page",
   "title": "Template Page",
-  "subtitle": "Complete template with components from the Xertica UI Design System",
-  "formSubmitSuccess": "Form submitted successfully!",
-  "sections": {
-    "alerts": "Alerts",
-    "cardsAndTabs": "Cards & Tabs",
-    "buttons": "Buttons",
-    "badges": "Badges",
-    "dialogs": "Dialogs",
-    "sidebarVariations": "Sidebar Variations",
-    "enhancedComponents": "v2.2.1 — Enhanced Components"
-  },
-  "alerts": {
-    "infoTitle": "Information",
-    "infoDescription": "This is an example of an informational alert using Design System components.",
-    "errorTitle": "Error",
-    "errorDescription": "An error occurred while processing your request.",
-    "successTitle": "Success",
-    "successDescription": "Operation completed successfully!",
-    "warningTitle": "Warning",
-    "warningDescription": "Warning: this action cannot be undone."
-  },
-  "tabs": {
-    "overview": "Overview",
-    "forms": "Forms",
-    "data": "Data",
-    "settings": "Settings"
-  },
-  "overview": {
-    "progressTitle": "Progress & Sliders",
-    "progressDescription": "Examples of progress components",
-    "projectProgress": "Project Progress",
-    "volume": "Volume",
-    "totalUsersDemoValue": "1,234",
-    "revenueDemoValue": "$45.2k",
-    "conversionRateDemoValue": "3.2%"
-  },
-  "forms": {
-    "registrationTitle": "Registration Form",
-    "registrationDescription": "Fill in the fields below to create a new account",
-    "firstName": "First name",
-    "firstNamePlaceholder": "John",
-    "lastName": "Last name",
-    "lastNamePlaceholder": "Doe",
-    "email": "Email",
-    "emailPlaceholder": "john@example.com",
-    "phone": "Phone",
-    "phonePlaceholder": "(555) 123-4567",
-    "role": "Role",
-    "rolePlaceholder": "Select a role",
-    "roles": {
-      "developer": "Developer",
-      "designer": "Designer",
-      "manager": "Manager",
-      "analyst": "Analyst"
-    },
-    "bio": "Biography",
-    "bioPlaceholder": "Tell us a bit about yourself...",
-    "preferences": "Preferences",
-    "newsletter": "Receive newsletter by email",
-    "pushNotifications": "Enable push notifications",
-    "featureUpdates": "Receive updates about new features",
-    "accountType": "Account Type",
-    "accountPersonal": "Personal",
-    "accountBusiness": "Business",
-    "accountEnterprise": "Enterprise",
-    "cancel": "Cancel",
-    "createAccount": "Create Account"
-  },
-  "data": {
-    "title": "User List",
-    "description": "Manage system users",
-    "searchPlaceholder": "Search users...",
-    "headers": {
-      "name": "Name",
-      "email": "Email",
-      "role": "Role",
-      "status": "Status",
-      "actions": "Actions"
-    },
-    "roles": {
-      "developerFemale": "Developer",
-      "designer": "Designer",
-      "manager": "Manager",
-      "analyst": "Analyst"
-    },
-    "status": {
-      "active": "Active",
-      "away": "Away",
-      "inactive": "Inactive"
-    },
-    "edit": "Edit",
-    "showing": "Showing {{count}} of {{total}} users",
-    "previous": "Previous",
-    "next": "Next",
-    "demoEmailDomain": "example.com"
-  },
-  "settings": {
-    "title": "System Settings",
-    "description": "Manage general settings",
-    "darkMode": "Dark Mode",
-    "darkModeDescription": "Enable dark theme in the interface",
-    "emailNotifications": "Email Notifications",
-    "emailNotificationsDescription": "Receive important updates by email",
-    "pushNotifications": "Push Notifications",
-    "pushNotificationsDescription": "Receive instant notifications in the browser",
-    "language": "Language",
-    "languages": {
-      "ptBR": "Português (Brazil)",
-      "en": "English",
-      "es": "Español"
-    },
-    "timezone": "Time Zone",
-    "timezones": {
-      "saoPaulo": "America/Sao Paulo (GMT-3)",
-      "newYork": "America/New York (GMT-5)",
-      "london": "Europe/London (GMT+0)"
-    },
-    "restoreDefaults": "Restore Defaults",
-    "saveChanges": "Save Changes"
-  },
-  "buttons": {
-    "title": "Button Variations",
-    "description": "Different button styles and sizes",
-    "variants": "Variants",
-    "sizes": "Sizes",
-    "withIcons": "With Icons",
-    "states": "States",
-    "profile": "Profile",
-    "messages": "Messages",
-    "schedule": "Schedule",
-    "disabled": "Disabled",
-    "outlineDisabled": "Outline Disabled",
-    "variantLabels": {
-      "default": "Default",
-      "secondary": "Secondary",
-      "outline": "Outline",
-      "ghost": "Ghost",
-      "link": "Link",
-      "destructive": "Destructive"
-    },
-    "sizeLabels": {
-      "small": "Small",
-      "default": "Default",
-      "large": "Large"
-    }
-  },
-  "badges": {
-    "title": "Badge Variations",
-    "description": "Different badge styles for statuses and tags",
-    "labels": {
-      "default": "Default",
-      "secondary": "Secondary",
-      "outline": "Outline",
-      "destructive": "Destructive",
-      "success": "Success",
-      "warning": "Warning",
-      "info": "Info"
-    }
-  },
-  "dialogs": {
-    "dialogTitle": "Dialog",
-    "dialogDescription": "A basic interactive modal",
-    "editProfile": "Edit Profile",
-    "editProfileDescription": "Make changes to your profile here. Click save when you're done.",
-    "name": "Name",
-    "nameDefaultValue": "Pedro Duarte",
-    "username": "Username",
-    "usernameDefaultValue": "@pedroduarte",
-    "update": "Update",
-    "alertDialogTitle": "Alert Dialog",
-    "alertDialogDescription": "An alert for important decisions",
-    "deleteAccount": "Delete Account",
-    "areYouSure": "Are you absolutely sure?",
-    "deleteWarning": "This action cannot be undone. This will permanently delete your account and remove your data from our servers.",
-    "cancel": "Cancel",
-    "continue": "Continue"
-  },
-  "sidebar": {
-    "title": "Sidebar Assistant Mode vs Default",
-    "description": "The Sidebar supports flexibility through the variant property.",
-    "assistantMode": "Assistant Mode",
-    "defaultMode": "Default Mode",
-    "searchTopicsPlaceholder": "Search topics...",
-    "newConversation": "New Conversation",
-    "recent": "Recent",
-    "constructionMonitoring": "Construction Monitoring",
-    "items": {
-      "sidebarRefactor": "Sidebar Refactor",
-      "sidebarRefactorDescription": "Active now",
-      "br163Restoration": "BR-163 Restoration",
-      "br163Location": "Cuiabá, MT"
-    },
-    "actions": {
-      "rename": "Rename",
-      "renameToast": "Open rename...",
-      "move": "Move",
-      "moveActive": "Active Projects",
-      "moveActiveToast": "Moved to Active Projects",
-      "moveMonitoring": "Monitoring",
-      "moveMonitoringToast": "Moved to Monitoring",
-      "moveArchive": "Archive",
-      "moveArchiveToast": "Moved to Archive",
-      "clear": "Clear",
-      "clearToast": "History cleared!",
-      "newCategory": "New Category",
-      "newCategoryToast": "Create new category...",
-      "archiveGroup": "Archive Group",
-      "archiveGroupToast": "Archiving group..."
-    },
-    "logoutToast": "Signed out",
-    "settingsClickedToast": "Settings clicked",
-    "routes": {
-      "home": "Home",
-      "dashboard": "Dashboard",
-      "settings": "Settings"
-    },
-    "assistantContent": "Assistant Mode Content",
-    "defaultContent": "Traditional System Navigation"
-  },
-  "enhanced": {
-    "pagination": {
-      "title": "Pagination",
-      "description": "Page navigation with the <code>disabled</code> prop on Previous/Next — accessible ARIA and focus.",
-      "pageOfTotal": "Page {{current}} of {{total}} — Set-deduplicated algorithm guarantees item uniqueness"
-    },
-    "stepper": {
-      "title": "Stepper",
-      "description": "Multi-step wizard with <code>role=\"list\"</code>, <code>aria-current=\"step\"</code> and <code>initialStep</code> automatically clamped.",
-      "step1Label": "Personal data",
-      "step1Description": "Name and email",
-      "step2Label": "Address",
-      "step2Description": "ZIP code and city",
-      "step3Label": "Confirmation",
-      "step3Description": "Review and submit",
-      "previous": "Previous",
-      "next": "Next",
-      "finish": "Finish"
-    },
-    "treeView": {
-      "title": "TreeView",
-      "description": "Hierarchical navigation with <code>ariaLabel</code>, roving tabindex and WAI-ARIA keyboard (Space expands/collapses, Enter selects).",
-      "ariaLabel": "Component structure",
-      "selectedConsoleLog": "Selected:",
-      "nodes": {
-        "components": "Components",
-        "ui": "UI",
-        "button": "Button",
-        "input": "Input",
-        "pagination": "Pagination",
-        "layout": "Layout",
-        "sidebar": "Sidebar",
-        "header": "Header",
-        "hooks": "Hooks"
-      }
-    },
-    "richText": {
-      "title": "RichTextEditor",
-      "description": "Rich text editor with <code>role=\"textbox\"</code>, <code>aria-multiline</code> and counters via <code>useState</code> (without IIFE).",
-      "placeholder": "Write here..."
-    }
-  },
-  "footer": {
-    "title": "Template CLI-Ready",
-    "subtitle": "How to use this template",
-    "descriptionPart1": "This template is ready to be used as a base for new projects. All components are imported from the ",
-    "descriptionPart2": " library and follow Xertica UI's CLI-first architecture.",
-    "tipTitle": "Tip",
-    "tipDescriptionPart1": "Copy this file as a starting point for your pages. All components are reusable and customizable through the CSS variables defined in ",
-    "tipDescriptionPart2": "."
-  },
-  "headerWithBreadcrumbs": {
-    "sectionTitle": "Header with Breadcrumbs",
-    "cardTitle": "Main Header",
-    "cardDescription": "Example of a Header with 4-level breadcrumbs",
-    "exampleContentTitle": "Example Content",
-    "exampleContentDescriptionPart1": "In this example, the ",
-    "exampleContentDescriptionPart2": " component of the application now supports an array of breadcrumbs for complex navigations with more than 3 levels.",
-    "breadcrumbs": {
-      "dashboard": "Dashboard",
-      "settings": "Settings",
-      "users": "Users",
-      "accessProfile": "Access Profile"
-    }
-  },
-  "headerVariations": {
-    "sectionTitle": "Header Variations",
-    "cardTitle": "Main Header Settings",
-    "cardDescription": "The Header focuses on navigation (breadcrumbs) and quick contextual actions.",
-    "visibleElements": "Visible Elements",
-    "actionButtons": "Action Buttons",
-    "breadcrumbsLabel": "Breadcrumbs",
-    "preview": "Preview",
-    "currentPage": "Current Page",
-    "contentArea": "Page Content Area",
-    "breadcrumbBrand": "Xertica UI",
-    "breadcrumbSettings": "Settings",
-    "breadcrumbProfile": "Profile",
-    "notificationsOpenedToast": "Notifications opened",
-    "messagesLabel": "Messages",
-    "messagesOpenedToast": "Messages opened"
-  },
-  "sidebarControls": {
-    "footerSettings": "Footer Settings",
-    "userProfile": "User Profile",
-    "settings": "Settings",
-    "logoutButton": "Logout Button",
-    "sidebarWidthDesktop": "Sidebar Width (Desktop)",
-    "sidebarWidthAriaLabel": "Sidebar Width",
-    "filterByStatus": "Filter by Status",
-    "filterActive": "Active",
-    "filterArchived": "Archived",
-    "filterPending": "Pending"
-  }
+  "subtitle": "Starting point for your own pages",
+  "exampleTitle": "Example",
+  "exampleInputLabel": "Name",
+  "exampleInputPlaceholder": "Type something...",
+  "exampleButton": "Submit"
 }

package/templates/src/locales/es/pages/settings.json

@@ -0,0 +1,15 @@
+{
+  "title": "Configuración",
+  "subtitle": "Administra tu cuenta y las preferencias de la aplicación",
+  "account": "Cuenta",
+  "accountDescription": "Información de tu cuenta",
+  "email": "Correo electrónico",
+  "preferences": "Preferencias",
+  "preferencesDescription": "Personaliza tu experiencia",
+  "theme": "Tema",
+  "themeDescription": "Alterna entre el modo claro y oscuro",
+  "language": "Idioma",
+  "languageDescription": "Elige el idioma de la interfaz",
+  "logout": "Cerrar sesión",
+  "logoutDescription": "Finaliza tu sesión en este dispositivo"
+}