xertica-ui 2.2.1 → 2.4.0

package/dist/cli.js

@@ -691,9 +691,11 @@ export function registerLanguageResource(
 export default i18n;
 `;
 }
-function generateAppTsx(selectedCodes) {
+function generateAppTsx(selectedCodes, disableDarkMode = false) {
   const selectedLangs = SUPPORTED_LANGUAGES.filter((l) => selectedCodes.includes(l.code));
   const isMonolingual = selectedLangs.length === 1;
+  const disableDarkModeProp = disableDarkMode ? `
+          disableDarkMode={true}` : "";
   const isAllDefaults = selectedLangs.length === SUPPORTED_LANGUAGES.length && selectedLangs.every((l) => DEFAULT_SELECTION.includes(l.code));
   const languagesArrayLiteral = selectedLangs.map(
     (l) => `            { code: '${l.code}', label: '${l.label}', shortLabel: '${l.shortLabel}' },`
@@ -737,7 +739,7 @@ export default function App() {
       <QueryClientProvider client={queryClient}>
         <XerticaProvider
           apiKey={geminiApiKey}
-          googleMapsApiKey={googleMapsApiKey}${availableLanguagesProp}
+          googleMapsApiKey={googleMapsApiKey}${availableLanguagesProp}${disableDarkModeProp}
         >
           <Router>
             {/* AuthProvider must be inside Router (needs useNavigate) */}
@@ -761,17 +763,222 @@ function toJsIdent(code) {
 }
 
 // bin/cli.ts
+var XERTICA_CONFIG_FILE = ".xertica.json";
+async function readXerticaConfig(targetDir) {
+  const configPath = path2.join(targetDir, XERTICA_CONFIG_FILE);
+  if (!await fs2.pathExists(configPath)) return null;
+  try {
+    return await fs2.readJson(configPath);
+  } catch {
+    return null;
+  }
+}
+async function writeXerticaConfig(targetDir, config) {
+  const configPath = path2.join(targetDir, XERTICA_CONFIG_FILE);
+  const existing = await readXerticaConfig(targetDir) ?? {
+    version: 1,
+    hasAssistant: false
+  };
+  await fs2.writeJson(configPath, { ...existing, ...config, version: 1 }, { spaces: 2 });
+}
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = path2.dirname(__filename);
 var pkgJson = JSON.parse(
   fs2.readFileSync(path2.resolve(__dirname, "../package.json"), "utf-8")
 );
+function generateAuthGuard({
+  hasLogin,
+  hasHome,
+  hasTemplate,
+  hasAssistant,
+  firstProtectedPath
+}) {
+  return `import React from 'react';
+import { Routes, Route, Navigate } from 'react-router-dom';
+import { useAuth } from '../context/AuthContext';
+
+// \u2500\u2500\u2500 Lazy page imports \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+${hasLogin ? `const LoginPage = React.lazy(() => import('../../pages/LoginPage').then(m => ({ default: m.LoginPage })));
+const ForgotPasswordPage = React.lazy(() => import('../../pages/ForgotPasswordPage').then(m => ({ default: m.ForgotPasswordPage })));
+const VerifyEmailPage = React.lazy(() => import('../../pages/VerifyEmailPage').then(m => ({ default: m.VerifyEmailPage })));
+const ResetPasswordPage = React.lazy(() => import('../../pages/ResetPasswordPage').then(m => ({ default: m.ResetPasswordPage })));` : ""}
+
+${hasHome ? `const HomePage = React.lazy(() => import('../../pages/HomePage').then(m => ({ default: m.HomePage })));` : ""}
+${hasTemplate ? `const TemplatePage = React.lazy(() => import('../../pages/TemplatePage').then(m => ({ default: m.TemplatePage })));` : ""}
+${hasAssistant ? `const AssistantPage = React.lazy(() => import('../../pages/AssistantPage').then(m => ({ default: m.AssistantPage })));` : ""}
+
+// \u2500\u2500\u2500 Route guards \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+function ProtectedRoute({ children }: { children: React.ReactNode }) {
+  const { user, isLoading } = useAuth();
+  if (isLoading) return null;
+  if (!user) return <Navigate to="${hasLogin ? "/login" : firstProtectedPath}" replace />;
+  return <>{children}</>;
+}
+
+${hasLogin ? `function GuestRoute({ children }: { children: React.ReactNode }) {
+  const { user, isLoading } = useAuth();
+  if (isLoading) return null;
+  if (user) return <Navigate to="${firstProtectedPath}" replace />;
+  return <>{children}</>;
+}
+
+function LoginPageWithAuth() {
+  const { login } = useAuth();
+  return <LoginPage onLogin={login} />;
+}` : ""}
+
+// \u2500\u2500\u2500 Route tree \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+export function AuthGuard() {
+  const { user } = useAuth();
+
+  return (
+    <div className="min-h-screen bg-muted overflow-x-hidden max-w-full">
+      <Routes>
+${hasLogin ? `        <Route path="/login" element={<GuestRoute><LoginPageWithAuth /></GuestRoute>} />
+        <Route path="/forgot-password" element={<GuestRoute><ForgotPasswordPage /></GuestRoute>} />
+        <Route path="/verify-email" element={<GuestRoute><VerifyEmailPage /></GuestRoute>} />
+        <Route path="/reset-password" element={<GuestRoute><ResetPasswordPage /></GuestRoute>} />` : ""}
+
+${hasHome ? `        <Route path="/home" element={<ProtectedRoute><HomePage /></ProtectedRoute>} />` : ""}
+${hasTemplate ? `        <Route path="/template" element={<ProtectedRoute><TemplatePage /></ProtectedRoute>} />` : ""}
+${hasAssistant ? `        <Route path="/assistente" element={<ProtectedRoute><AssistantPage /></ProtectedRoute>} />` : ""}
+
+        <Route path="/" element={<Navigate to={user ? '${firstProtectedPath}' : '${hasLogin ? "/login" : firstProtectedPath}'} replace />} />
+        <Route path="*" element={<Navigate to={user ? '${firstProtectedPath}' : '${hasLogin ? "/login" : firstProtectedPath}'} replace />} />
+      </Routes>
+    </div>
+  );
+}
+`;
+}
+function generateHomePage(hasAssistant) {
+  if (hasAssistant) {
+    return `import React from 'react';
+import { XerticaAssistant, generateDemoResponse } from 'xertica-ui/assistant';
+import { useLayout } from 'xertica-ui/hooks';
+import { useNavigate } from 'react-router-dom';
+import { AppLayout } from '../app/components/AppLayout';
+import { HomeContent } from '../features/home';
+import { useAssistantConfig, getMockRichSuggestions, getMockFeedbackOptions } from '../features/assistant';
+
+/**
+ * Home page \u2014 thin layout shell.
+ *
+ * Assistant config (suggestions, feedback options) is fetched via React Query.
+ * To connect to a real API replace \`fetchAssistantConfig\` in
+ * \`features/assistant/data/mock.ts\`.
+ */
+export function HomePage() {
+  const { assistenteExpanded, toggleAssistente } = useLayout();
+  const navigate = useNavigate();
+
+  const { data: assistantConfig } = useAssistantConfig();
+
+  return (
+    <AppLayout
+      assistant={
+        <XerticaAssistant
+          isExpanded={assistenteExpanded}
+          onToggle={toggleAssistente}
+          defaultTab="chat"
+          demoMode={true}
+          userName="Ariel Santos"
+          responseGenerator={generateDemoResponse}
+          suggestions={assistantConfig?.suggestions}
+          richSuggestions={assistantConfig?.richSuggestions ?? getMockRichSuggestions()}
+          feedbackOptions={assistantConfig?.feedbackOptions ?? getMockFeedbackOptions()}
+          showHistory={false}
+          showFavorites={false}
+          onNavigateSettings={() => navigate('/settings')}
+          onNavigateFullPage={() => navigate('/assistente')}
+          onEvaluation={(messageId, type, reason) => {
+            // Wire your feedback persistence logic here
+            console.log(\`Avalia\xE7\xE3o: \${type} na mensagem \${messageId}. Motivo: \${reason}\`);
+          }}
+        />
+      }
+    >
+      <HomeContent />
+    </AppLayout>
+  );
+}
+`;
+  }
+  return `import React from 'react';
+import { AppLayout } from '../app/components/AppLayout';
+import { HomeContent } from '../features/home';
+
+/**
+ * Home page \u2014 thin layout shell.
+ */
+export function HomePage() {
+  return (
+    <AppLayout>
+      <HomeContent />
+    </AppLayout>
+  );
+}
+`;
+}
+function generateTemplatePage(hasAssistant) {
+  if (hasAssistant) {
+    return `import React from 'react';
+import { XerticaAssistant } from 'xertica-ui/assistant';
+import { useLayout } from 'xertica-ui/hooks';
+import { AppLayout } from '../app/components/AppLayout';
+import { TemplateContent } from '../features/template';
+
+/**
+ * Template page \u2014 thin layout shell.
+ *
+ * Auth state is consumed from \`AuthContext\` via \`AppLayout\` \u2014 no props needed.
+ */
+export function TemplatePage() {
+  const { assistenteExpanded, toggleAssistente } = useLayout();
+
+  return (
+    <AppLayout
+      assistant={
+        <XerticaAssistant
+          isExpanded={assistenteExpanded}
+          onToggle={toggleAssistente}
+          onEvaluation={(id, type, reason) => console.log('Feedback:', id, type, reason)}
+        />
+      }
+    >
+      <TemplateContent />
+    </AppLayout>
+  );
+}
+`;
+  }
+  return `import React from 'react';
+import { AppLayout } from '../app/components/AppLayout';
+import { TemplateContent } from '../features/template';
+
+/**
+ * Template page \u2014 thin layout shell.
+ *
+ * Auth state is consumed from \`AuthContext\` via \`AppLayout\` \u2014 no props needed.
+ */
+export function TemplatePage() {
+  return (
+    <AppLayout>
+      <TemplateContent />
+    </AppLayout>
+  );
+}
+`;
+}
 var program = new Command();
 program.name("xertica-ui").description("CLI to initialize Xertica UI projects").version(pkgJson.version);
 program.command("init").description("Initialize a new Xertica UI project").argument("[directory]", "Directory to initialize in", ".").action(async (directory) => {
   const targetDir = path2.resolve(process.cwd(), directory);
   const templatesDir = path2.resolve(__dirname, "../templates");
-  console.log(chalk.blue("\u{1F680} Welcome to Xertica UI CLI!"));
+  console.log(chalk.blue(`\u{1F680} Welcome to Xertica UI CLI! ${chalk.dim(`v${pkgJson.version}`)}`));
   const response = await prompts([
     {
       type: "multiselect",
@@ -811,6 +1018,18 @@ program.command("init").description("Initialize a new Xertica UI project").argum
       })),
       initial: 0
     },
+    {
+      type: "confirm",
+      name: "hasAssistant",
+      message: "Include AI Assistant? (XerticaAssistant chat page + sidebar variant)",
+      initial: true
+    },
+    {
+      type: "confirm",
+      name: "enableDarkMode",
+      message: "Enable dark mode support?",
+      initial: true
+    },
     {
       type: "confirm",
       name: "install",
@@ -826,6 +1045,7 @@ program.command("init").description("Initialize a new Xertica UI project").argum
     const hasLogin = pages.includes("login");
     const hasHome = pages.includes("home");
     const hasTemplate = pages.includes("template");
+    const hasAssistant = response.hasAssistant ?? true;
     const selectedLanguages = Array.isArray(response.languages) && response.languages.length > 0 ? response.languages : DEFAULT_SELECTION;
     const rootFilesToCopy = [
       "index.html",
@@ -856,10 +1076,11 @@ program.command("init").description("Initialize a new Xertica UI project").argum
       path2.join(templatesDir, "src", "main.tsx"),
       path2.join(targetDir, "src", "main.tsx")
     );
+    const disableDarkMode = response.enableDarkMode === false;
     await fs2.ensureDir(path2.join(targetDir, "src", "app"));
     await fs2.writeFile(
       path2.join(targetDir, "src", "app", "App.tsx"),
-      generateAppTsx(selectedLanguages)
+      generateAppTsx(selectedLanguages, disableDarkMode)
     );
     await fs2.ensureDir(path2.join(targetDir, "src", "app", "components"));
     await fs2.copy(
@@ -876,6 +1097,7 @@ program.command("init").description("Initialize a new Xertica UI project").argum
     );
     await syncLocaleFiles(templatesDir, targetDir, selectedLanguages, { pruneOthers: true });
     await writeLanguagesConfig(targetDir, selectedLanguages);
+    await writeXerticaConfig(targetDir, { hasAssistant, disableDarkMode });
     await fs2.ensureDir(path2.join(targetDir, "src", "app", "context"));
     await fs2.copy(
       path2.join(templatesDir, "src", "app", "context", "AuthContext.tsx"),
@@ -899,10 +1121,12 @@ program.command("init").description("Initialize a new Xertica UI project").argum
         path2.join(targetDir, "src", "features", "template")
       );
     }
-    await fs2.copy(
-      path2.join(templatesDir, "src", "features", "assistant"),
-      path2.join(targetDir, "src", "features", "assistant")
-    );
+    if (hasAssistant) {
+      await fs2.copy(
+        path2.join(templatesDir, "src", "features", "assistant"),
+        path2.join(targetDir, "src", "features", "assistant")
+      );
+    }
     await fs2.ensureDir(path2.join(targetDir, "src", "pages"));
     const pagesToCopy = [];
     if (hasLogin)
@@ -914,74 +1138,35 @@ program.command("init").description("Initialize a new Xertica UI project").argum
       );
     if (hasHome) pagesToCopy.push("HomePage.tsx");
     if (hasTemplate) pagesToCopy.push("TemplatePage.tsx");
-    pagesToCopy.push("AssistantPage.tsx");
+    if (hasAssistant) pagesToCopy.push("AssistantPage.tsx");
     for (const pageFile of pagesToCopy) {
+      if (pageFile === "HomePage.tsx") {
+        await fs2.writeFile(
+          path2.join(targetDir, "src", "pages", "HomePage.tsx"),
+          generateHomePage(hasAssistant)
+        );
+        continue;
+      }
+      if (pageFile === "TemplatePage.tsx") {
+        await fs2.writeFile(
+          path2.join(targetDir, "src", "pages", "TemplatePage.tsx"),
+          generateTemplatePage(hasAssistant)
+        );
+        continue;
+      }
       const src = path2.join(templatesDir, "src", "pages", pageFile);
       if (await fs2.pathExists(src)) {
         await fs2.copy(src, path2.join(targetDir, "src", "pages", pageFile));
       }
     }
     const firstProtectedPath = hasHome ? "/home" : hasTemplate ? "/template" : "/login";
-    const authGuardContent = `import React from 'react';
-import { Routes, Route, Navigate } from 'react-router-dom';
-import { useAuth } from '../context/AuthContext';
-
-// \u2500\u2500\u2500 Lazy page imports \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-
-${hasLogin ? `const LoginPage = React.lazy(() => import('../../pages/LoginPage').then(m => ({ default: m.LoginPage })));
-const ForgotPasswordPage = React.lazy(() => import('../../pages/ForgotPasswordPage').then(m => ({ default: m.ForgotPasswordPage })));
-const VerifyEmailPage = React.lazy(() => import('../../pages/VerifyEmailPage').then(m => ({ default: m.VerifyEmailPage })));
-const ResetPasswordPage = React.lazy(() => import('../../pages/ResetPasswordPage').then(m => ({ default: m.ResetPasswordPage })));` : ""}
-
-${hasHome ? `const HomePage = React.lazy(() => import('../../pages/HomePage').then(m => ({ default: m.HomePage })));` : ""}
-${hasTemplate ? `const TemplatePage = React.lazy(() => import('../../pages/TemplatePage').then(m => ({ default: m.TemplatePage })));` : ""}
-const AssistantPage = React.lazy(() => import('../../pages/AssistantPage').then(m => ({ default: m.AssistantPage })));
-
-// \u2500\u2500\u2500 Route guards \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-
-function ProtectedRoute({ children }: { children: React.ReactNode }) {
-  const { user, isLoading } = useAuth();
-  if (isLoading) return null;
-  if (!user) return <Navigate to="${hasLogin ? "/login" : firstProtectedPath}" replace />;
-  return <>{children}</>;
-}
-
-${hasLogin ? `function GuestRoute({ children }: { children: React.ReactNode }) {
-  const { user, isLoading } = useAuth();
-  if (isLoading) return null;
-  if (user) return <Navigate to="${firstProtectedPath}" replace />;
-  return <>{children}</>;
-}
-
-function LoginPageWithAuth() {
-  const { login } = useAuth();
-  return <LoginPage onLogin={login} />;
-}` : ""}
-
-// \u2500\u2500\u2500 Route tree \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-
-export function AuthGuard() {
-  const { user } = useAuth();
-
-  return (
-    <div className="min-h-screen bg-muted overflow-x-hidden max-w-full">
-      <Routes>
-${hasLogin ? `        <Route path="/login" element={<GuestRoute><LoginPageWithAuth /></GuestRoute>} />
-        <Route path="/forgot-password" element={<GuestRoute><ForgotPasswordPage /></GuestRoute>} />
-        <Route path="/verify-email" element={<GuestRoute><VerifyEmailPage /></GuestRoute>} />
-        <Route path="/reset-password" element={<GuestRoute><ResetPasswordPage /></GuestRoute>} />` : ""}
-
-${hasHome ? `        <Route path="/home" element={<ProtectedRoute><HomePage /></ProtectedRoute>} />` : ""}
-${hasTemplate ? `        <Route path="/template" element={<ProtectedRoute><TemplatePage /></ProtectedRoute>} />` : ""}
-        <Route path="/assistente" element={<ProtectedRoute><AssistantPage /></ProtectedRoute>} />
-
-        <Route path="/" element={<Navigate to={user ? '${firstProtectedPath}' : '${hasLogin ? "/login" : firstProtectedPath}'} replace />} />
-        <Route path="*" element={<Navigate to={user ? '${firstProtectedPath}' : '${hasLogin ? "/login" : firstProtectedPath}'} replace />} />
-      </Routes>
-    </div>
-  );
-}
-`;
+    const authGuardContent = generateAuthGuard({
+      hasLogin,
+      hasHome,
+      hasTemplate,
+      hasAssistant,
+      firstProtectedPath
+    });
     await fs2.writeFile(
       path2.join(targetDir, "src", "app", "components", "AuthGuard.tsx"),
       authGuardContent
@@ -1016,9 +1201,13 @@ ${hasTemplate ? `        <Route path="/template" element={<ProtectedRoute><Templ
         `  Languages: ${langLabels}${selectedLanguages.length === 1 ? " (monolingual \u2014 LanguageSelector hidden)" : ""}`
       )
     );
+    console.log(chalk.gray("  To add/remove languages later: npx xertica-ui update \u2192 Languages"));
     console.log(
-      chalk.gray("  To add/remove languages later: npx xertica-ui update \u2192 Languages")
+      chalk.gray(`  AI Assistant: ${hasAssistant ? "included (/assistente)" : "not included"}`)
     );
+    if (!hasAssistant) {
+      console.log(chalk.gray("  To add the assistant later: npx xertica-ui update \u2192 Assistant"));
+    }
   } catch (error) {
     spinner.fail("Failed to initialize project");
     console.error(error);
@@ -1026,6 +1215,8 @@ ${hasTemplate ? `        <Route path="/template" element={<ProtectedRoute><Templ
 });
 program.command("update").alias("update-theme").description("Update theme or project files to the latest version").action(async () => {
   const targetDir = process.cwd();
+  console.log(chalk.blue(`\u{1F527} Xertica UI CLI ${chalk.dim(`v${pkgJson.version}`)}`));
+  const currentConfig = await readXerticaConfig(targetDir);
   const { updateType } = await prompts({
     type: "select",
     name: "updateType",
@@ -1041,6 +1232,16 @@ program.command("update").alias("update-theme").description("Update theme or pro
         description: "Add or remove supported languages (pt-BR, en, es, \u2026)",
         value: "languages"
       },
+      {
+        title: "Assistant",
+        description: currentConfig?.hasAssistant ? "Remove the AI Assistant from your project" : "Add the AI Assistant to your project",
+        value: "assistant"
+      },
+      {
+        title: "Dark Mode",
+        description: currentConfig?.disableDarkMode ? "Enable dark mode support in your project" : "Disable dark mode support in your project",
+        value: "darkmode"
+      },
       {
         title: "Project files",
         description: "Update app shell, shared, features and pages to a specific version",
@@ -1123,10 +1324,8 @@ Current languages: ${SUPPORTED_LANGUAGES.filter((l) => currentCodes.includes(l.c
       return;
     }
     const summary = [];
-    if (toAdd.length > 0)
-      summary.push(chalk.green(`  + ${toAdd.join(", ")}`));
-    if (toRemove.length > 0)
-      summary.push(chalk.red(`  - ${toRemove.join(", ")}`));
+    if (toAdd.length > 0) summary.push(chalk.green(`  + ${toAdd.join(", ")}`));
+    if (toRemove.length > 0) summary.push(chalk.red(`  - ${toRemove.join(", ")}`));
     console.log(`
 ${summary.join("\n")}
 `);
@@ -1151,19 +1350,13 @@ ${summary.join("\n")}
         "templates"
       );
       const templatesSourceDir = await fs2.pathExists(installedTemplatesDir) ? installedTemplatesDir : path2.resolve(__dirname, "../templates");
-      const { copied, removed } = await syncLocaleFiles(
-        templatesSourceDir,
-        targetDir,
-        newCodes,
-        { pruneOthers: true }
-      );
-      await fs2.writeFile(
-        path2.join(targetDir, "src", "i18n.ts"),
-        generateI18nFile(newCodes)
-      );
+      const { copied, removed } = await syncLocaleFiles(templatesSourceDir, targetDir, newCodes, {
+        pruneOthers: true
+      });
+      await fs2.writeFile(path2.join(targetDir, "src", "i18n.ts"), generateI18nFile(newCodes));
       await fs2.writeFile(
         path2.join(targetDir, "src", "app", "App.tsx"),
-        generateAppTsx(newCodes)
+        generateAppTsx(newCodes, currentConfig?.disableDarkMode ?? false)
       );
       await writeLanguagesConfig(targetDir, newCodes);
       spinner2.succeed("Languages updated successfully!");
@@ -1171,9 +1364,7 @@ ${summary.join("\n")}
       if (removed.length > 0) console.log(chalk.red(`  Removed: ${removed.join(", ")}`));
       if (newCodes.length === 1) {
         console.log(
-          chalk.gray(
-            `  Project is now monolingual \u2014 the LanguageSelector will auto-hide.`
-          )
+          chalk.gray(`  Project is now monolingual \u2014 the LanguageSelector will auto-hide.`)
         );
       }
     } catch (error) {
@@ -1182,6 +1373,162 @@ ${summary.join("\n")}
     }
     return;
   }
+  if (updateType === "assistant") {
+    let currentlyHas;
+    if (currentConfig !== null) {
+      currentlyHas = currentConfig.hasAssistant;
+    } else {
+      const assistantFeatureDir = path2.join(targetDir, "src", "features", "assistant");
+      const assistantPage = path2.join(targetDir, "src", "pages", "AssistantPage.tsx");
+      currentlyHas = await fs2.pathExists(assistantFeatureDir) || await fs2.pathExists(assistantPage);
+      await writeXerticaConfig(targetDir, { hasAssistant: currentlyHas });
+    }
+    console.log(
+      chalk.cyan(
+        `
+AI Assistant is currently: ${currentlyHas ? chalk.green("enabled") : chalk.red("disabled")}
+`
+      )
+    );
+    const { action } = await prompts({
+      type: "select",
+      name: "action",
+      message: currentlyHas ? "Remove the AI Assistant from your project?" : "Add the AI Assistant to your project?",
+      choices: currentlyHas ? [
+        {
+          title: "Remove assistant",
+          description: "Deletes AssistantPage and assistant feature files",
+          value: "remove"
+        },
+        { title: "Cancel", value: "cancel" }
+      ] : [
+        {
+          title: "Add assistant",
+          description: "Copies AssistantPage and assistant feature files",
+          value: "add"
+        },
+        { title: "Cancel", value: "cancel" }
+      ]
+    });
+    if (!action || action === "cancel") {
+      console.log(chalk.gray("Update cancelled."));
+      return;
+    }
+    const { confirmed: confirmed2 } = await prompts({
+      type: "confirm",
+      name: "confirmed",
+      message: chalk.yellow(
+        action === "remove" ? "\u26A0\uFE0F  This will delete src/features/assistant/ and src/pages/AssistantPage.tsx and regenerate AuthGuard.tsx. Continue?" : "\u26A0\uFE0F  This will copy src/features/assistant/ and src/pages/AssistantPage.tsx and regenerate AuthGuard.tsx. Continue?"
+      ),
+      initial: action === "add"
+    });
+    if (!confirmed2) {
+      console.log(chalk.gray("Update cancelled."));
+      return;
+    }
+    const spinner2 = ora(
+      action === "add" ? "Adding assistant..." : "Removing assistant..."
+    ).start();
+    try {
+      const installedTemplatesDir = path2.join(
+        targetDir,
+        "node_modules",
+        "xertica-ui",
+        "templates"
+      );
+      const templatesSourceDir = await fs2.pathExists(installedTemplatesDir) ? installedTemplatesDir : path2.resolve(__dirname, "../templates");
+      const pagesDir = path2.join(targetDir, "src", "pages");
+      const existingPages = await fs2.pathExists(pagesDir) ? await fs2.readdir(pagesDir) : [];
+      const hasLogin = existingPages.includes("LoginPage.tsx");
+      const hasHome = existingPages.includes("HomePage.tsx");
+      const hasTemplate = existingPages.includes("TemplatePage.tsx");
+      const firstProtectedPath = hasHome ? "/home" : hasTemplate ? "/template" : "/login";
+      const persistedCodes = await readLanguagesConfig(targetDir);
+      const selectedCodes = persistedCodes && persistedCodes.length > 0 ? persistedCodes : DEFAULT_SELECTION;
+      if (action === "add") {
+        await fs2.copy(
+          path2.join(templatesSourceDir, "src", "features", "assistant"),
+          path2.join(targetDir, "src", "features", "assistant"),
+          { overwrite: true }
+        );
+        await fs2.copy(
+          path2.join(templatesSourceDir, "src", "pages", "AssistantPage.tsx"),
+          path2.join(targetDir, "src", "pages", "AssistantPage.tsx"),
+          { overwrite: true }
+        );
+      } else {
+        await fs2.remove(path2.join(targetDir, "src", "features", "assistant"));
+        await fs2.remove(path2.join(targetDir, "src", "pages", "AssistantPage.tsx"));
+      }
+      const newHasAssistant = action === "add";
+      if (hasHome) {
+        await fs2.writeFile(
+          path2.join(targetDir, "src", "pages", "HomePage.tsx"),
+          generateHomePage(newHasAssistant)
+        );
+      }
+      if (hasTemplate) {
+        await fs2.writeFile(
+          path2.join(targetDir, "src", "pages", "TemplatePage.tsx"),
+          generateTemplatePage(newHasAssistant)
+        );
+      }
+      await fs2.writeFile(
+        path2.join(targetDir, "src", "app", "components", "AuthGuard.tsx"),
+        generateAuthGuard({
+          hasLogin,
+          hasHome,
+          hasTemplate,
+          hasAssistant: newHasAssistant,
+          firstProtectedPath
+        })
+      );
+      await writeXerticaConfig(targetDir, { hasAssistant: newHasAssistant });
+      spinner2.succeed(
+        action === "add" ? "AI Assistant added successfully!" : "AI Assistant removed successfully!"
+      );
+      if (action === "add") {
+        console.log(chalk.gray("\n  Route /assistente is now available."));
+        console.log(chalk.gray("  Configure your Gemini API key in VITE_GEMINI_API_KEY."));
+      } else {
+        console.log(chalk.gray("\n  Assistant files removed and AuthGuard updated."));
+      }
+    } catch (error) {
+      spinner2.fail("Failed to update assistant");
+      console.error(error);
+    }
+    return;
+  }
+  if (updateType === "darkmode") {
+    const currentlyDisabled = currentConfig?.disableDarkMode ?? false;
+    const { enableDarkMode } = await prompts({
+      type: "confirm",
+      name: "enableDarkMode",
+      message: currentlyDisabled ? "Enable dark mode support in your project?" : "Disable dark mode support in your project? (This will hide the toggle and force light mode)",
+      initial: !currentlyDisabled
+    });
+    if (enableDarkMode === void 0) return;
+    const newDisableDarkMode = !enableDarkMode;
+    const spinner2 = ora(
+      newDisableDarkMode ? "Disabling dark mode..." : "Enabling dark mode..."
+    ).start();
+    try {
+      await writeXerticaConfig(targetDir, { disableDarkMode: newDisableDarkMode });
+      const persistedCodes = await readLanguagesConfig(targetDir);
+      const selectedCodes = persistedCodes && persistedCodes.length > 0 ? persistedCodes : DEFAULT_SELECTION;
+      await fs2.writeFile(
+        path2.join(targetDir, "src", "app", "App.tsx"),
+        generateAppTsx(selectedCodes, newDisableDarkMode)
+      );
+      spinner2.succeed(
+        newDisableDarkMode ? "Dark mode disabled successfully! (Locked to Light Mode)" : "Dark mode enabled successfully!"
+      );
+    } catch (error) {
+      spinner2.fail("Failed to update dark mode configuration");
+      console.error(error);
+    }
+    return;
+  }
   const { versionType } = await prompts({
     type: "select",
     name: "versionType",
@@ -1281,17 +1628,32 @@ ${summary.join("\n")}
         if (selectedCodes.length === 0) selectedCodes = DEFAULT_SELECTION;
         await writeLanguagesConfig(targetDir, selectedCodes);
       }
+      const projectConfig = await readXerticaConfig(targetDir);
       await fs2.writeFile(
         path2.join(targetDir, "src", "app", "App.tsx"),
-        generateAppTsx(selectedCodes)
-      );
-      await fs2.writeFile(
-        path2.join(targetDir, "src", "i18n.ts"),
-        generateI18nFile(selectedCodes)
+        generateAppTsx(selectedCodes, projectConfig?.disableDarkMode ?? false)
       );
+      await fs2.writeFile(path2.join(targetDir, "src", "i18n.ts"), generateI18nFile(selectedCodes));
       await syncLocaleFiles(updatedTemplatesDir, targetDir, selectedCodes, {
         pruneOthers: true
       });
+      const pagesDir = path2.join(targetDir, "src", "pages");
+      const existingPages = await fs2.pathExists(pagesDir) ? await fs2.readdir(pagesDir) : [];
+      const hasLoginP = existingPages.includes("LoginPage.tsx");
+      const hasHomeP = existingPages.includes("HomePage.tsx");
+      const hasTemplateP = existingPages.includes("TemplatePage.tsx");
+      const hasAssistantP = projectConfig?.hasAssistant ?? existingPages.includes("AssistantPage.tsx");
+      const firstProtectedP = hasHomeP ? "/home" : hasTemplateP ? "/template" : "/login";
+      await fs2.writeFile(
+        path2.join(targetDir, "src", "app", "components", "AuthGuard.tsx"),
+        generateAuthGuard({
+          hasLogin: hasLoginP,
+          hasHome: hasHomeP,
+          hasTemplate: hasTemplateP,
+          hasAssistant: hasAssistantP,
+          firstProtectedPath: firstProtectedP
+        })
+      );
     }
     if (filesToUpdate.includes("shared")) {
       await fs2.copy(
@@ -1313,8 +1675,24 @@ ${summary.join("\n")}
       const pagesDir = path2.join(targetDir, "src", "pages");
       const srcPagesDir = path2.join(updatedTemplatesDir, "src", "pages");
       if (await fs2.pathExists(pagesDir) && await fs2.pathExists(srcPagesDir)) {
+        const projectCfg = await readXerticaConfig(targetDir);
         const existingPages = await fs2.readdir(pagesDir);
+        const assistantEnabled = projectCfg?.hasAssistant ?? existingPages.includes("AssistantPage.tsx");
         for (const pageFile of existingPages) {
+          if (pageFile === "HomePage.tsx") {
+            await fs2.writeFile(
+              path2.join(pagesDir, "HomePage.tsx"),
+              generateHomePage(assistantEnabled)
+            );
+            continue;
+          }
+          if (pageFile === "TemplatePage.tsx") {
+            await fs2.writeFile(
+              path2.join(pagesDir, "TemplatePage.tsx"),
+              generateTemplatePage(assistantEnabled)
+            );
+            continue;
+          }
           const src = path2.join(srcPagesDir, pageFile);
           if (await fs2.pathExists(src)) {
             await fs2.copy(src, path2.join(pagesDir, pageFile), { overwrite: true });