xertica-ui 2.2.0 → 2.3.0

package/dist/cli.js

@@ -761,17 +761,219 @@ 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 +1013,12 @@ 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: "install",
@@ -826,6 +1034,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",
@@ -876,6 +1085,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 });
     await fs2.ensureDir(path2.join(targetDir, "src", "app", "context"));
     await fs2.copy(
       path2.join(templatesDir, "src", "app", "context", "AuthContext.tsx"),
@@ -899,10 +1109,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 +1126,29 @@ 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
@@ -1019,6 +1186,12 @@ ${hasTemplate ? `        <Route path="/template" element={<ProtectedRoute><Templ
     console.log(
       chalk.gray("  To add/remove languages later: npx xertica-ui update \u2192 Languages")
     );
+    console.log(
+      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 +1199,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 +1216,11 @@ 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: "Project files",
         description: "Update app shell, shared, features and pages to a specific version",
@@ -1182,6 +1362,117 @@ ${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;
+  }
   const { versionType } = await prompts({
     type: "select",
     name: "versionType",
@@ -1292,6 +1583,24 @@ ${summary.join("\n")}
       await syncLocaleFiles(updatedTemplatesDir, targetDir, selectedCodes, {
         pruneOthers: true
       });
+      const projectConfig = await readXerticaConfig(targetDir);
+      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 +1622,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 });

package/dist/components/assistant/xertica-assistant/hooks/index.d.ts

@@ -0,0 +1,6 @@
+export { useAssistantMessages } from './use-assistant-messages';
+export type { UseAssistantMessagesProps, UseAssistantMessagesReturn, EvaluationState } from './use-assistant-messages';
+export { useAssistantConversations } from './use-assistant-conversations';
+export type { UseAssistantConversationsProps, UseAssistantConversationsReturn } from './use-assistant-conversations';
+export { useAssistantSuggestions, DEFAULT_SUGGESTIONS } from './use-assistant-suggestions';
+export type { UseAssistantSuggestionsProps, UseAssistantSuggestionsReturn } from './use-assistant-suggestions';

package/dist/components/assistant/xertica-assistant/hooks/use-assistant-conversations.d.ts

@@ -0,0 +1,21 @@
+import type { Message, Conversation, SearchResult, AssistantTab } from '../types';
+export interface UseAssistantConversationsProps {
+    savedConversations?: Conversation[];
+    /** Current tab — used to compute conversasFiltradas */
+    abaSelecionada: AssistantTab;
+    setAbaSelecionada: (tab: AssistantTab) => void;
+    setMensagens: React.Dispatch<React.SetStateAction<Message[]>>;
+}
+export interface UseAssistantConversationsReturn {
+    conversas: Conversation[];
+    conversaAtual: string | null;
+    conversasFiltradas: Conversation[];
+    savedSearches: string[];
+    executingCommand: string | null;
+    handleNovaConversa: () => void;
+    handleSelecionarConversa: (conversaId: string) => void;
+    handleToggleFavoritaConversa: (conversaId: string) => void;
+    handleOpenSearchResult: (result: SearchResult) => void;
+    handleExecuteSearchCommand: (commandId: string, searchTerm: string, results: SearchResult[], messageId: string) => Promise<void>;
+}
+export declare function useAssistantConversations({ savedConversations, abaSelecionada, setAbaSelecionada, setMensagens, }: UseAssistantConversationsProps): UseAssistantConversationsReturn;

package/dist/components/assistant/xertica-assistant/hooks/use-assistant-messages.d.ts

@@ -0,0 +1,49 @@
+import type { Message, MockResponse } from '../types';
+export interface UseAssistantMessagesProps {
+    initialMessages?: Message[];
+    isProcessing?: boolean;
+    demoMode?: boolean;
+    customResponses?: MockResponse[];
+    responseGenerator?: (message: string) => Promise<string | Partial<Message>> | string | Partial<Message>;
+    onSendMessage?: (message: string) => void;
+    onEvaluation?: (messageId: string, type: 'like' | 'dislike', reason?: string) => void;
+    /** Current tab — used to drive auto-scroll */
+    abaSelecionada: string;
+}
+export interface EvaluationState {
+    isOpen: boolean;
+    messageId: string | null;
+    type: 'dislike' | null;
+    category?: string | null;
+    reason: string;
+}
+export interface UseAssistantMessagesReturn {
+    mensagens: Message[];
+    setMensagens: React.Dispatch<React.SetStateAction<Message[]>>;
+    mensagem: string;
+    setMensagem: (value: string) => void;
+    copiedId: string | null;
+    generatingPodcastId: string | null;
+    editingDocument: {
+        content: string;
+        title: string;
+    } | null;
+    setEditingDocument: (doc: {
+        content: string;
+        title: string;
+    } | null) => void;
+    evaluationState: EvaluationState;
+    setEvaluationState: React.Dispatch<React.SetStateAction<EvaluationState>>;
+    messagesEndRef: React.RefObject<HTMLDivElement>;
+    handleEnviarMensagem: (arg?: string) => Promise<void>;
+    handleToggleFavorite: (messageId: string) => void;
+    handleCopyMessage: (content: string, messageId: string) => Promise<void>;
+    handleGeneratePodcast: (messageId: string, content: string) => Promise<void>;
+    handleDownloadDocument: (content: string, fileName: string) => void;
+    handleDownloadPodcast: (audioUrl: string, fileName: string) => void;
+    handleEditDocument: (content: string, title: string) => void;
+    handleEvaluationClick: (messageId: string, type: 'like' | 'dislike') => void;
+    openFeedbackDialog: (messageId: string, category: string | null) => void;
+    handleSubmitDislike: () => void;
+}
+export declare function useAssistantMessages({ initialMessages, isProcessing, demoMode, customResponses, responseGenerator, onSendMessage, onEvaluation, abaSelecionada, }: UseAssistantMessagesProps): UseAssistantMessagesReturn;

package/dist/components/assistant/xertica-assistant/hooks/use-assistant-suggestions.d.ts

@@ -0,0 +1,16 @@
+import type { Suggestion } from '../types';
+export declare const DEFAULT_SUGGESTIONS: Suggestion[];
+export interface UseAssistantSuggestionsProps {
+    suggestions?: Suggestion[];
+    richSuggestions?: Suggestion[];
+    onRichAction?: (actionId: string, actionText: string) => void;
+    /** handleEnviarMensagem from useAssistantMessages, passed in to avoid circular deps */
+    handleEnviarMensagem: (arg?: string | any) => Promise<void>;
+}
+export interface UseAssistantSuggestionsReturn {
+    sugestoes: Suggestion[];
+    showMoreSuggestions: boolean;
+    setShowMoreSuggestions: (show: boolean) => void;
+    handleRichSuggestionClick: (suggestion: Suggestion) => void;
+}
+export declare function useAssistantSuggestions({ suggestions, richSuggestions, onRichAction, handleEnviarMensagem, }: UseAssistantSuggestionsProps): UseAssistantSuggestionsReturn;