@sudajs/cli 0.11.0 → 0.12.1

package/dist/index.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import { createHash } from 'crypto';
-import fs, { writeFile, stat, readdir, readFile, mkdir, copyFile, rm } from 'fs/promises';
+import fs, { readFile, writeFile, stat, readdir, mkdir, copyFile, rm } from 'fs/promises';
 import { createRequire } from 'module';
 import path2 from 'path';
 import { createInterface } from 'readline/promises';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { createThemeAgentManifest, createSudaPageAgentRuntime, checkThemeModule, formatThemeCheckResult, agentValidationResultSchema, agentPageSchemaOutputSchema, agentComponentOutputSchema } from '@sudajs/theme-engine';
+import { themeDesignSystemSchema, createThemeAgentManifest, createSudaPageAgentRuntime, checkThemeModule, formatThemeCheckResult, agentValidationResultSchema, agentPageSchemaOutputSchema, agentComponentOutputSchema } from '@sudajs/theme-engine';
 import { themeManifestSchema } from '@sudajs/theme-engine/server';
 import { Command } from 'commander';
 import { build } from 'esbuild';
@@ -402,6 +402,34 @@ var updateContactFormOutputSchema = z.discriminatedUnion("status", [
     contactForm: contactFormViewSchema
   })
 ]);
+var themeSettingsViewSchema = z.object({
+  themeKey: z.string(),
+  themeVersion: z.string(),
+  designSystem: themeDesignSystemSchema,
+  rootProps: z.record(z.unknown()),
+  schema: z.unknown()
+});
+var themeSettingsOutputSchema = z.object({
+  themeSettings: themeSettingsViewSchema
+});
+var updateThemeSettingsInputSchema = z.object({
+  projectId: z.string().min(1),
+  rootProps: z.record(z.unknown()),
+  confirm: z.boolean().optional()
+});
+var updateThemeSettingsOutputSchema = z.discriminatedUnion("status", [
+  z.object({
+    status: z.literal("needs_confirmation"),
+    projectId: z.string(),
+    impact: z.string(),
+    draft: updateThemeSettingsInputSchema.omit({ confirm: true })
+  }),
+  z.object({
+    status: z.literal("updated"),
+    projectId: z.string(),
+    themeSettings: themeSettingsViewSchema
+  })
+]);
 var PROJECT_NAME_MIN_LENGTH = 1;
 var PROJECT_NAME_MAX_LENGTH = 80;
 var PROJECT_DESCRIPTION_MIN_LENGTH = 1;
@@ -696,6 +724,35 @@ ${issues}`);
     throw new Error(formatThemeCheckResult(result));
   }
 }
+function hasTailwindV4Dependency(dependencies, name) {
+  const value = dependencies?.[name];
+  return typeof value === "string" && /^[~^<>=\s]*4(?:[.\s<>=-]|$)/.test(value.trim());
+}
+async function validateThemeTailwindContract(root) {
+  const packageJsonPath = path2.join(root, "package.json");
+  const packageJson = await readJson(packageJsonPath);
+  const dependencyScopes = [packageJson.dependencies, packageJson.devDependencies];
+  const hasTailwind = dependencyScopes.some(
+    (dependencies) => hasTailwindV4Dependency(dependencies, "tailwindcss")
+  );
+  const hasPostcssPlugin = dependencyScopes.some(
+    (dependencies) => hasTailwindV4Dependency(dependencies, "@tailwindcss/postcss")
+  );
+  if (!hasTailwind) {
+    throw new Error("Suda themes must depend on tailwindcss v4.");
+  }
+  if (!hasPostcssPlugin) {
+    throw new Error("Suda themes must depend on @tailwindcss/postcss v4.");
+  }
+  const stylesEntry = path2.join(root, "src", "styles.css");
+  if (!await pathExists(stylesEntry)) {
+    throw new Error(`Missing ${stylesEntry}. Suda themes must define src/styles.css.`);
+  }
+  const styles = await readFile(stylesEntry, "utf8");
+  if (!styles.includes('@import "tailwindcss";') && !styles.includes("@import 'tailwindcss';")) {
+    throw new Error('src/styles.css must include `@import "tailwindcss";`.');
+  }
+}
 async function validateTheme(root) {
   const packageJsonPath = path2.join(root, "package.json");
   const serverEntryPath = path2.join(root, "dist", "index.js");
@@ -709,6 +766,7 @@ async function validateTheme(root) {
   }
   const module = await loadThemeModule(serverEntryPath);
   validateThemeModule(module);
+  await validateThemeTailwindContract(root);
   await validateThemeLocales(root);
   const result = {
     root,
@@ -1144,12 +1202,15 @@ var __testUtils = {
   performActivateTheme,
   performConfirmedPageOperation,
   performUpdateContactForm,
+  performUpdateThemeSettings,
+  getRemoteThemeSettings,
   renderDevStarterPageHtml,
   resolveDevStarterSlug,
   resolveScreenshotOptions,
   slugifyThemeName,
   validateThemeKey,
   validateThemeName,
+  validateThemeTailwindContract,
   validateThemeLocales,
   toViteModuleUrl,
   updateRemotePageDraft
@@ -1883,6 +1944,58 @@ async function performUpdateContactForm(auth, input, fetcher = fetchJson) {
     contactForm
   };
 }
+async function getRemoteThemeSettings(auth, projectId, fetcher = fetchJson) {
+  const response = await fetcher(
+    `${auth.baseUrl}/api/cli/agent/projects/${encodeURIComponent(projectId)}/theme/settings`,
+    { token: auth.token }
+  );
+  return themeSettingsViewSchema.parse(response);
+}
+async function updateRemoteThemeSettings(auth, input, fetcher = fetchJson) {
+  const response = await fetcher(
+    `${auth.baseUrl}/api/cli/agent/projects/${encodeURIComponent(input.projectId)}/theme/settings`,
+    {
+      method: "PATCH",
+      token: auth.token,
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ rootProps: input.rootProps })
+    }
+  );
+  return themeSettingsViewSchema.parse(response);
+}
+function describeThemeSettingsUpdate(rootProps) {
+  const keys = Object.keys(rootProps);
+  const parts = keys.map((key) => {
+    if (key !== "designSystem") {
+      return key;
+    }
+    const value = rootProps.designSystem;
+    if (value && typeof value === "object" && !Array.isArray(value) && typeof value.presetId === "string") {
+      const presetId = value.presetId;
+      return `designSystem preset "${presetId}"`;
+    }
+    return "designSystem";
+  });
+  return parts.join(", ") || "no explicit root prop changes";
+}
+async function performUpdateThemeSettings(auth, input, fetcher = fetchJson) {
+  const draft = updateThemeSettingsInputSchema.omit({ confirm: true }).parse(input);
+  const impact = `This will update theme layout root settings for project "${input.projectId}": ${describeThemeSettingsUpdate(input.rootProps)}. Theme settings affect the public site rendering after they are saved.`;
+  if (input.confirm !== true) {
+    return {
+      status: "needs_confirmation",
+      projectId: input.projectId,
+      impact,
+      draft
+    };
+  }
+  const themeSettings = await updateRemoteThemeSettings(auth, input, fetcher);
+  return {
+    status: "updated",
+    projectId: input.projectId,
+    themeSettings
+  };
+}
 async function listAgentProjects() {
   const auth = await requireCliBaseUrl();
   const result = await fetchJson(
@@ -2109,6 +2222,48 @@ async function startMcpServer() {
       );
     }
   );
+  server.registerTool(
+    "get_theme_settings",
+    {
+      description: 'Read project theme layout root settings. Use this before planning theme style changes. The result includes manifest.designSystem presets, current rootProps, and the layout root schema. To use a preset, set rootProps.designSystem to { presetId }. To fully customize colors/radius, set rootProps.designSystem to { presetId: "custom", tokens: { colors, radius } } using every token from designSystem.',
+      inputSchema: {
+        projectId: z.string()
+      },
+      outputSchema: themeSettingsOutputSchema.shape
+    },
+    async ({ projectId }) => {
+      const auth = await requireCliBaseUrl();
+      const structuredContent = themeSettingsOutputSchema.parse({
+        themeSettings: await getRemoteThemeSettings(auth, projectId)
+      });
+      return mcpStructured("Suda theme settings.", structuredContent);
+    }
+  );
+  server.registerTool(
+    "update_theme_settings",
+    {
+      description: "Plan or update project theme layout root settings. Use this for choosing a designSystem preset or saving custom design tokens for colors and radius. Conversation flow: first call get_theme_settings, then propose the exact rootProps changes to the user. Call this tool without confirm or with confirm:false to return the impact summary; only call again with confirm:true after the user explicitly agrees. Do not create theme source code or introduce a second token system.",
+      inputSchema: updateThemeSettingsInputSchema.shape,
+      outputSchema: {
+        status: z.enum(["needs_confirmation", "updated"]),
+        projectId: z.string(),
+        impact: z.string().optional(),
+        draft: updateThemeSettingsInputSchema.omit({ confirm: true }).optional(),
+        themeSettings: themeSettingsViewSchema.optional()
+      }
+    },
+    async (input) => {
+      const parsed = updateThemeSettingsInputSchema.parse(input);
+      const auth = await requireCliBaseUrl();
+      const structuredContent = updateThemeSettingsOutputSchema.parse(
+        await performUpdateThemeSettings(auth, parsed)
+      );
+      return mcpStructured(
+        structuredContent.status === "needs_confirmation" ? "Updating these theme settings requires explicit confirmation." : "Updated Suda theme settings.",
+        structuredContent
+      );
+    }
+  );
   server.registerTool(
     "create_page_draft",
     {