@atlashub/smartstack-cli 4.34.0 → 4.35.0

package/dist/mcp-entry.mjs

@@ -26102,7 +26102,7 @@ var init_types3 = __esm({
         includeLayouts: external_exports.boolean().default(true).describe("Generate layout components"),
         includeGuards: external_exports.boolean().default(true).describe("Include route guards for permissions"),
         generateRegistry: external_exports.boolean().default(true).describe("Generate navRoutes.generated.ts"),
-        outputFormat: external_exports.enum(["standalone", "applicationRoutes", "clientRoutes", "componentRegistry"]).default("componentRegistry").describe('Output format: "componentRegistry" (v3.7+) generates PageRegistry.register() calls for DynamicRouter. "applicationRoutes" (deprecated) generates RouteObject[] arrays for App.tsx. "standalone" generates createBrowserRouter(). "clientRoutes" is a deprecated alias for "applicationRoutes".'),
+        outputFormat: external_exports.enum(["standalone", "componentRegistry"]).default("componentRegistry").describe('Output format: "componentRegistry" (v3.7+, default) generates PageRegistry.register() calls for DynamicRouter. "standalone" generates createBrowserRouter() for non-SmartStack projects.'),
         dryRun: external_exports.boolean().default(false).describe("Preview without writing files")
       }).optional()
     });
@@ -57901,9 +57901,6 @@ ensuring frontend routes stay synchronized with backend NavRoute attributes.`,
 function toKebabCase(segment) {
   return segment.replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2").replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
 }
-function toCamelCase2(segment) {
-  return segment.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-}
 function capitalize(str) {
   return str.charAt(0).toUpperCase() + str.slice(1);
 }
@@ -57975,16 +57972,6 @@ async function scaffoldRoutes(input, config2) {
     result.files.push({ path: registryFile, content: registryContent, type: "created" });
   }
   const outputFormat = options?.outputFormat ?? "componentRegistry";
-  if (outputFormat === "clientRoutes") {
-    if (!result.warnings) result.warnings = [];
-    result.warnings.push('outputFormat "clientRoutes" is DEPRECATED. Use "applicationRoutes" instead (same behavior, correct naming).');
-  }
-  if (outputFormat === "applicationRoutes") {
-    if (!result.warnings) result.warnings = [];
-    result.warnings.push(
-      'outputFormat "applicationRoutes" is DEPRECATED (v3.7+). Use "componentRegistry" for PageRegistry + DynamicRouter pattern. See: DynamicRouter replaces manual App.tsx wiring.'
-    );
-  }
   if (outputFormat === "componentRegistry") {
     const pageFiles = await discoverPageFiles(webPath, navRoutes);
     const registryContent = generateComponentRegistry(navRoutes, pageFiles, webPath);
@@ -58003,121 +57990,9 @@ async function scaffoldRoutes(input, config2) {
     result.instructions.push("1. Ensure `main.tsx` imports `./extensions/componentRegistry.generated`");
     result.instructions.push("2. Ensure navigation seed data has matching `componentKey` values");
     result.instructions.push("3. DynamicRouter resolves routes automatically \u2014 no App.tsx wiring needed");
-  }
-  if (outputFormat === "applicationRoutes" || outputFormat === "clientRoutes") {
-    const pageFiles = await discoverPageFiles(webPath, navRoutes);
-    const applicationRoutesContent = generateApplicationRoutesConfig(navRoutes, pageFiles, includeGuards);
-    const applicationRoutesFile = path19.join(routesPath, "applicationRoutes.generated.tsx");
-    if (!dryRun) {
-      await ensureDirectory(routesPath);
-      await writeText(applicationRoutesFile, applicationRoutesContent);
-    }
-    result.files.push({ path: applicationRoutesFile, content: applicationRoutesContent, type: "created" });
-    const routeCount = navRoutes.length * 4;
-    result.instructions.push(`Generated ${routeCount} routes (4 CRUD per NavRoute) for ${navRoutes.length} NavRoutes in applicationRoutes format`);
-    result.instructions.push("");
-    result.instructions.push("## App.tsx Wiring Instructions");
-    result.instructions.push("");
-    result.instructions.push("**Detect App.tsx pattern first**, then follow the matching instructions:");
-    result.instructions.push("");
-    const routeTree = buildRouteTree(navRoutes);
-    result.instructions.push("### Pattern A: mergeRoutes (applicationRoutes pattern)");
-    result.instructions.push("");
-    result.instructions.push("Routes are FLAT (no nested children) \u2014 compatible with `mergeRoutes()`.");
-    result.instructions.push("Each NavRoute generates 4 routes: list, create, detail (:id), edit (:id/edit).");
-    result.instructions.push("");
-    result.instructions.push("**IMPORTANT:** Pages are lazy-loaded. Use `<Suspense fallback={<PageLoader />}>` wrapper.");
-    result.instructions.push("");
-    result.instructions.push("```tsx");
-    result.instructions.push("import { lazy, Suspense } from 'react';");
-    result.instructions.push("import { PageLoader } from '@/components/ui/PageLoader';");
-    result.instructions.push("");
-    const importedComponents = /* @__PURE__ */ new Set();
-    for (const [_app, modules] of Object.entries(routeTree)) {
-      for (const [, moduleRoutes] of Object.entries(modules)) {
-        for (const route of moduleRoutes) {
-          const discovery = pageFiles.get(route.navRoute);
-          if (discovery) {
-            for (const page of [discovery.list, discovery.create, discovery.detail, discovery.edit]) {
-              if (page && !importedComponents.has(page.componentName)) {
-                importedComponents.add(page.componentName);
-                result.instructions.push(`const ${page.componentName} = lazy(() =>`);
-                result.instructions.push(`  import('${page.importPath}').then(m => ({ default: m.${page.componentName} }))`);
-                result.instructions.push(");");
-              }
-            }
-          } else {
-            const { entityPlural, entitySingular, basePath } = deriveEntityNames(route.navRoute);
-            for (const comp of [`${entityPlural}Page`, `${entitySingular}CreatePage`, `${entitySingular}DetailPage`, `${entitySingular}EditPage`]) {
-              if (!importedComponents.has(comp)) {
-                importedComponents.add(comp);
-                result.instructions.push(`// TODO: const ${comp} = lazy(() => import('${basePath}/${comp}').then(m => ({ default: m.${comp} })));`);
-              }
-            }
-          }
-        }
-      }
-    }
-    result.instructions.push("");
-    result.instructions.push("const applicationRoutes = {");
-    for (const [app, modules] of Object.entries(routeTree)) {
-      result.instructions.push(`  '${toKebabCase(app)}': [`);
-      for (const [, moduleRoutes] of Object.entries(modules)) {
-        for (const route of moduleRoutes) {
-          const modulePath = route.navRoute.split(".").slice(1).map(toKebabCase).join("/");
-          const discovery = pageFiles.get(route.navRoute);
-          const { entityPlural, entitySingular } = deriveEntityNames(route.navRoute);
-          const listComp = discovery?.list?.componentName || `${entityPlural}Page`;
-          const createComp = discovery?.create?.componentName || `${entitySingular}CreatePage`;
-          const detailComp = discovery?.detail?.componentName || `${entitySingular}DetailPage`;
-          const editComp = discovery?.edit?.componentName || `${entitySingular}EditPage`;
-          result.instructions.push(`    // === ${entityPlural.toLowerCase()} (NavRoute: ${route.navRoute}) ===`);
-          result.instructions.push(`    { path: '${modulePath}', element: <Suspense fallback={<PageLoader />}><${listComp} /></Suspense> },`);
-          result.instructions.push(`    { path: '${modulePath}/create', element: <Suspense fallback={<PageLoader />}><${createComp} /></Suspense> },`);
-          result.instructions.push(`    { path: '${modulePath}/:id', element: <Suspense fallback={<PageLoader />}><${detailComp} /></Suspense> },`);
-          result.instructions.push(`    { path: '${modulePath}/:id/edit', element: <Suspense fallback={<PageLoader />}><${editComp} /></Suspense> },`);
-        }
-      }
-      result.instructions.push("  ],");
-    }
-    result.instructions.push("};");
-    result.instructions.push("```");
-    result.instructions.push("");
-    result.instructions.push("Routes are automatically injected into BOTH standard and tenant-prefixed trees by `mergeRoutes()`.");
-    result.instructions.push("");
-    result.instructions.push('### Pattern B: JSX Routes (if App.tsx uses `<Route path="/{application}" element={<{Layout} />}>`)');
-    result.instructions.push("");
-    result.instructions.push("Insert `<Route>` children INSIDE the appropriate Layout wrapper.");
-    result.instructions.push("**IMPORTANT:** Use `<Suspense fallback={<PageLoader />}>` for lazy-loaded pages.");
-    result.instructions.push("");
-    for (const [app, modules] of Object.entries(routeTree)) {
-      const layoutName = getLayoutName(app);
-      result.instructions.push(`#### ${capitalize(app)} application (inside \`<Route path="/${toKebabCase(app)}" element={<${layoutName} />}>\`):`);
-      result.instructions.push("");
-      result.instructions.push("```tsx");
-      for (const [, moduleRoutes] of Object.entries(modules)) {
-        for (const route of moduleRoutes) {
-          const modulePath = route.navRoute.split(".").slice(1).map(toKebabCase).join("/");
-          const discovery = pageFiles.get(route.navRoute);
-          const { entityPlural, entitySingular } = deriveEntityNames(route.navRoute);
-          const listComp = discovery?.list?.componentName || `${entityPlural}Page`;
-          const createComp = discovery?.create?.componentName || `${entitySingular}CreatePage`;
-          const detailComp = discovery?.detail?.componentName || `${entitySingular}DetailPage`;
-          const editComp = discovery?.edit?.componentName || `${entitySingular}EditPage`;
-          result.instructions.push(`<Route path="${modulePath}" element={<Suspense fallback={<PageLoader />}><${listComp} /></Suspense>} />`);
-          result.instructions.push(`<Route path="${modulePath}/create" element={<Suspense fallback={<PageLoader />}><${createComp} /></Suspense>} />`);
-          result.instructions.push(`<Route path="${modulePath}/:id" element={<Suspense fallback={<PageLoader />}><${detailComp} /></Suspense>} />`);
-          result.instructions.push(`<Route path="${modulePath}/:id/edit" element={<Suspense fallback={<PageLoader />}><${editComp} /></Suspense>} />`);
-        }
-      }
-      result.instructions.push("```");
-      result.instructions.push("");
-      result.instructions.push("**IMPORTANT:** Also add the same routes inside the tenant-prefixed block (`/t/:slug/...`)");
-      result.instructions.push("");
-    }
   } else {
     if (!result.warnings) result.warnings = [];
-    result.warnings.push("STANDALONE MODE: createBrowserRouter() is NOT compatible with SmartStack App.tsx which uses useRoutes() + mergeRoutes()");
+    result.warnings.push("STANDALONE MODE: createBrowserRouter() is for non-SmartStack projects. SmartStack uses DynamicRouter + PageRegistry (v3.7+).");
     result.warnings.push("All routes are in TODO commented state \u2014 manual activation required");
     const routerContent = generateRouterConfig(navRoutes, includeGuards);
     const routerFile = path19.join(routesPath, "index.tsx");
@@ -58610,164 +58485,6 @@ async function discoverPageFiles(webPath, routes) {
   }
   return pageMap;
 }
-function generateApplicationRoutesConfig(routes, pageFiles, includeGuards) {
-  const routeTree = buildRouteTree(routes);
-  const lines = [
-    "/**",
-    " * Application Routes Configuration",
-    " *",
-    " * Auto-generated by SmartStack MCP - DO NOT EDIT MANUALLY",
-    ' * Run `scaffold_routes` with outputFormat: "applicationRoutes" to regenerate.',
-    " *",
-    " * These routes are FLAT (not nested children) \u2014 compatible with mergeRoutes().",
-    " * Each NavRoute generates up to 4 CRUD routes: list, create, detail, edit.",
-    " */",
-    "",
-    "import type { RouteObject } from 'react-router-dom';",
-    "import type { ApplicationRouteExtensions } from '@atlashub/smartstack';",
-    "import { lazy, Suspense } from 'react';",
-    "import { Navigate } from 'react-router-dom';",
-    "import { PageLoader } from '@/components/ui/PageLoader';"
-  ];
-  if (includeGuards) {
-    lines.push("import { ROUTES } from './navRoutes.generated';");
-    lines.push("import { PermissionGuard } from './guards';");
-  }
-  lines.push("");
-  const importedComponents = /* @__PURE__ */ new Set();
-  for (const route of routes) {
-    const discovery = pageFiles.get(route.navRoute);
-    if (discovery) {
-      for (const page of [discovery.list, discovery.create, discovery.detail, discovery.edit]) {
-        if (page && !importedComponents.has(page.componentName)) {
-          importedComponents.add(page.componentName);
-          lines.push(`const ${page.componentName} = lazy(() =>`);
-          lines.push(`  import('${page.importPath}').then(m => ({ default: m.${page.componentName} }))`);
-          lines.push(");");
-        }
-      }
-    }
-  }
-  for (const route of routes) {
-    const discovery = pageFiles.get(route.navRoute);
-    const { entityPlural, entitySingular, basePath } = deriveEntityNames(route.navRoute);
-    if (!discovery?.list && !importedComponents.has(`${entityPlural}Page`)) {
-      importedComponents.add(`${entityPlural}Page`);
-      lines.push(`const ${entityPlural}Page = lazy(() =>`);
-      lines.push(`  import('${basePath}/${entityPlural}Page').then(m => ({ default: m.${entityPlural}Page }))`);
-      lines.push(");");
-    }
-    if (!discovery?.create && !importedComponents.has(`${entitySingular}CreatePage`)) {
-      importedComponents.add(`${entitySingular}CreatePage`);
-      lines.push(`const ${entitySingular}CreatePage = lazy(() =>`);
-      lines.push(`  import('${basePath}/${entitySingular}CreatePage').then(m => ({ default: m.${entitySingular}CreatePage }))`);
-      lines.push(");");
-    }
-    if (!discovery?.detail && !importedComponents.has(`${entitySingular}DetailPage`)) {
-      importedComponents.add(`${entitySingular}DetailPage`);
-      lines.push(`const ${entitySingular}DetailPage = lazy(() =>`);
-      lines.push(`  import('${basePath}/${entitySingular}DetailPage').then(m => ({ default: m.${entitySingular}DetailPage }))`);
-      lines.push(");");
-    }
-    if (!discovery?.edit && !importedComponents.has(`${entitySingular}EditPage`)) {
-      importedComponents.add(`${entitySingular}EditPage`);
-      lines.push(`const ${entitySingular}EditPage = lazy(() =>`);
-      lines.push(`  import('${basePath}/${entitySingular}EditPage').then(m => ({ default: m.${entitySingular}EditPage }))`);
-      lines.push(");");
-    }
-  }
-  lines.push("");
-  for (const [app, modules] of Object.entries(routeTree)) {
-    const appCamel = toCamelCase2(app);
-    const appKebab = toKebabCase(app);
-    const appUpper = capitalize(appCamel);
-    const layoutName = getLayoutName(app);
-    lines.push("/**");
-    lines.push(` * Routes for ${appUpper} application`);
-    lines.push(` * Flat routes for mergeRoutes() \u2014 children of <Route path="/${appKebab}" element={<${layoutName} />}>`);
-    lines.push(" */");
-    lines.push(`export const ${appCamel}Routes: RouteObject[] = [`);
-    for (const [, moduleRoutes] of Object.entries(modules)) {
-      for (const route of moduleRoutes) {
-        const modulePath = route.navRoute.split(".").slice(1).map(toKebabCase).join("/");
-        const discovery = pageFiles.get(route.navRoute);
-        const { entityPlural, entitySingular } = deriveEntityNames(route.navRoute);
-        const permGuardOpen = includeGuards && route.permissions.length > 0 ? `<PermissionGuard permissions={ROUTES['${route.navRoute}'].permissions}>` : "";
-        const permGuardClose = permGuardOpen ? "</PermissionGuard>" : "";
-        lines.push(`  // === ${entityPlural.toLowerCase()} (NavRoute: ${route.navRoute}) ===`);
-        const listComp = discovery?.list?.componentName || `${entityPlural}Page`;
-        const listElement = `<Suspense fallback={<PageLoader />}>${permGuardOpen}<${listComp} />${permGuardClose}</Suspense>`;
-        lines.push(`  { path: '${modulePath}', element: ${listElement} },`);
-        const createComp = discovery?.create?.componentName || `${entitySingular}CreatePage`;
-        const createElement = `<Suspense fallback={<PageLoader />}>${permGuardOpen}<${createComp} />${permGuardClose}</Suspense>`;
-        lines.push(`  { path: '${modulePath}/create', element: ${createElement} },`);
-        const detailComp = discovery?.detail?.componentName || `${entitySingular}DetailPage`;
-        const detailElement = `<Suspense fallback={<PageLoader />}>${permGuardOpen}<${detailComp} />${permGuardClose}</Suspense>`;
-        lines.push(`  { path: '${modulePath}/:id', element: ${detailElement} },`);
-        const editComp = discovery?.edit?.componentName || `${entitySingular}EditPage`;
-        const editElement = `<Suspense fallback={<PageLoader />}>${permGuardOpen}<${editComp} />${permGuardClose}</Suspense>`;
-        lines.push(`  { path: '${modulePath}/:id/edit', element: ${editElement} },`);
-      }
-    }
-    lines.push("");
-    lines.push("  // --- Parent redirect routes ---");
-    let appFirstPath;
-    const moduleRedirects = /* @__PURE__ */ new Map();
-    for (const [moduleName, modRoutes] of Object.entries(modules)) {
-      if (modRoutes.length > 0) {
-        const firstRoute = modRoutes[0];
-        const segments = firstRoute.navRoute.split(".").slice(1).map(toKebabCase);
-        const firstFullPath = segments.join("/");
-        const moduleKebab = toKebabCase(moduleName);
-        if (!appFirstPath) {
-          appFirstPath = firstFullPath;
-        }
-        if (segments.length > 1 && !moduleRedirects.has(moduleKebab)) {
-          moduleRedirects.set(moduleKebab, firstFullPath);
-        }
-      }
-    }
-    for (const [modulePath, targetPath] of moduleRedirects) {
-      lines.push(`  { path: '${modulePath}', element: <Navigate to="${targetPath}" replace /> },`);
-    }
-    if (appFirstPath) {
-      lines.push(`  { path: '', element: <Navigate to="${appFirstPath}" replace /> },`);
-    }
-    lines.push("];");
-    lines.push("");
-  }
-  const appKeys = Object.keys(routeTree);
-  lines.push("/** All generated routes grouped by application */");
-  lines.push("export const generatedRoutes: Record<string, RouteObject[]> = {");
-  for (const app of appKeys) {
-    const appCamel = toCamelCase2(app);
-    const appKebab = toKebabCase(app);
-    lines.push(`  '${appKebab}': ${appCamel}Routes,`);
-  }
-  lines.push("};");
-  lines.push("");
-  lines.push("/**");
-  lines.push(" * Application route extensions for mergeRoutes() pattern.");
-  lines.push(" * Import and spread into your App.tsx applicationRoutes:");
-  lines.push(" *");
-  lines.push(" * ```tsx");
-  lines.push(" * import { applicationRouteExtensions } from './routes/applicationRoutes.generated';");
-  lines.push(" * const applicationRoutes = {");
-  lines.push(" *   ...applicationRouteExtensions,");
-  lines.push(" *   // your additional routes...");
-  lines.push(" * };");
-  lines.push(" * ```");
-  lines.push(" */");
-  lines.push("export const applicationRouteExtensions: Record<string, RouteObject[]> = {");
-  for (const app of appKeys) {
-    const appCamel = toCamelCase2(app);
-    const appKebab = toKebabCase(app);
-    lines.push(`  '${appKebab}': ${appCamel}Routes,`);
-  }
-  lines.push("};");
-  lines.push("");
-  return lines.join("\n");
-}
 function generateComponentRegistry(navRoutes, pageFiles, _webPath) {
   const lines = [];
   lines.push("/**");
@@ -58803,9 +58520,6 @@ function generateComponentRegistry(navRoutes, pageFiles, _webPath) {
   }
   return lines.join("\n");
 }
-function getLayoutName(_application) {
-  return "AppLayout";
-}
 function deriveEntityNames(navRoute) {
   const parts = navRoute.split(".");
   const lastSegment = parts[parts.length - 1];
@@ -58911,7 +58625,7 @@ and generates corresponding frontend routing infrastructure.`,
               includeLayouts: { type: "boolean", default: true },
               includeGuards: { type: "boolean", default: true },
               generateRegistry: { type: "boolean", default: true },
-              outputFormat: { type: "string", enum: ["standalone", "applicationRoutes", "clientRoutes", "componentRegistry"], default: "componentRegistry", description: "componentRegistry (v3.7+): PageRegistry.register() calls for DynamicRouter. applicationRoutes (deprecated): RouteObject[] arrays for App.tsx. standalone: createBrowserRouter(). clientRoutes: deprecated alias for applicationRoutes." },
+              outputFormat: { type: "string", enum: ["standalone", "componentRegistry"], default: "componentRegistry", description: "componentRegistry (v3.7+, default): PageRegistry.register() calls for DynamicRouter. standalone: createBrowserRouter() for non-SmartStack projects." },
               dryRun: { type: "boolean", default: false }
             }
           }
@@ -59149,7 +58863,7 @@ async function validateApiClients(webPath, backendRoutes, result) {
   }
 }
 async function validateRoutes(webPath, backendRoutes, result) {
-  const routeCandidates = ["applicationRoutes.generated.tsx", "clientRoutes.generated.tsx", "index.tsx"];
+  const routeCandidates = ["index.tsx"];
   let routesContent = "";
   for (const candidate of routeCandidates) {
     const candidatePath = path20.join(webPath, "src", "routes", candidate);
@@ -59246,10 +58960,9 @@ async function validateAppWiring(webPath, backendRoutes, result) {
     );
     return;
   }
-  const hasApplicationRoutesImport = appContent.includes("applicationRoutes.generated") || appContent.includes("clientRoutes.generated");
   const hasRoutesImport = appContent.includes("from './routes") || appContent.includes("from '../routes");
   const hasInlineRoutes = appContent.includes("<Route ");
-  result.appWiring.routesImported = hasApplicationRoutesImport || hasRoutesImport || hasInlineRoutes;
+  result.appWiring.routesImported = hasRoutesImport || hasInlineRoutes;
   const hasDynamicRouter = appContent.includes("DynamicRouter") || appContent.includes("<DynamicRouter");
   const hasComponentRegistry = appContent.includes("componentRegistry.generated");
   if (hasDynamicRouter || hasComponentRegistry) {
@@ -59291,7 +59004,7 @@ async function validateAppWiring(webPath, backendRoutes, result) {
   }
 }
 async function validateCrudRoutes(webPath, backendRoutes, result) {
-  const routeCandidates = ["applicationRoutes.generated.tsx", "clientRoutes.generated.tsx"];
+  const routeCandidates = ["index.tsx"];
   let routesContent = "";
   for (const candidate of routeCandidates) {
     const candidatePath = path20.join(webPath, "src", "routes", candidate);