@agent-scope/cli 1.16.0 → 1.17.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { existsSync, writeFileSync, readFileSync, mkdirSync, appendFileSync, readdirSync, rmSync } from 'fs';
-import { resolve, join, dirname } from 'path';
+import { existsSync, writeFileSync, readFileSync, mkdirSync, appendFileSync, readdirSync, rmSync, statSync, createReadStream } from 'fs';
+import { resolve, join, extname, dirname } from 'path';
 import { generateManifest } from '@agent-scope/manifest';
 import { SpriteSheetGenerator, safeRender, BrowserPool, ALL_CONTEXT_IDS, contextAxis, stressAxis, ALL_STRESS_IDS, RenderMatrix, SatoriRenderer } from '@agent-scope/render';
 import { TokenResolver, ComplianceEngine, parseTokenFileSync, ThemeResolver, exportTokens, validateTokenFile, TokenValidationError, TokenParseError, ImpactAnalyzer } from '@agent-scope/tokens';
@@ -9,6 +9,8 @@ import { createRequire } from 'module';
 import * as readline from 'readline';
 import { chromium } from 'playwright';
 import { loadTrace, generateTest, getBrowserEntryScript } from '@agent-scope/playwright';
+import { createServer } from 'http';
+import { buildSite } from '@agent-scope/site';
 
 // src/ci/commands.ts
 async function buildComponentHarness(filePath, componentName, props, viewportWidth, projectCss) {
@@ -1107,9 +1109,9 @@ function createRL() {
   });
 }
 async function ask(rl, question) {
-  return new Promise((resolve16) => {
+  return new Promise((resolve17) => {
     rl.question(question, (answer) => {
-      resolve16(answer.trim());
+      resolve17(answer.trim());
     });
   });
 }
@@ -4609,6 +4611,130 @@ function buildStructuredReport(report) {
     route: report.route?.pattern ?? null
   };
 }
+var MIME_TYPES = {
+  ".html": "text/html; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".js": "application/javascript; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".svg": "image/svg+xml",
+  ".ico": "image/x-icon"
+};
+function registerBuild(siteCmd) {
+  siteCmd.command("build").description("Build a static HTML gallery from .reactscope/ output").option("-i, --input <path>", "Path to .reactscope input directory", ".reactscope").option("-o, --output <path>", "Output directory for generated site", ".reactscope/site").option("--base-path <path>", "Base URL path prefix for subdirectory deployment", "/").option("--compliance <path>", "Path to compliance batch report JSON").option("--title <text>", "Site title", "Scope \u2014 Component Gallery").action(
+    async (opts) => {
+      try {
+        const inputDir = resolve(process.cwd(), opts.input);
+        const outputDir = resolve(process.cwd(), opts.output);
+        if (!existsSync(inputDir)) {
+          throw new Error(
+            `Input directory not found: ${inputDir}
+Run \`scope manifest generate\` and \`scope render\` first.`
+          );
+        }
+        const manifestPath = join(inputDir, "manifest.json");
+        if (!existsSync(manifestPath)) {
+          throw new Error(
+            `Manifest not found at ${manifestPath}
+Run \`scope manifest generate\` first.`
+          );
+        }
+        process.stderr.write(`Building site from ${inputDir}\u2026
+`);
+        await buildSite({
+          inputDir,
+          outputDir,
+          basePath: opts.basePath,
+          ...opts.compliance !== void 0 && {
+            compliancePath: resolve(process.cwd(), opts.compliance)
+          },
+          title: opts.title
+        });
+        process.stderr.write(`Site written to ${outputDir}
+`);
+        process.stdout.write(`${outputDir}
+`);
+      } catch (err) {
+        process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+        process.exit(1);
+      }
+    }
+  );
+}
+function registerServe(siteCmd) {
+  siteCmd.command("serve").description("Serve the built static site locally").option("-p, --port <number>", "Port to listen on", "3000").option("-d, --dir <path>", "Directory to serve", ".reactscope/site").action((opts) => {
+    try {
+      const port = Number.parseInt(opts.port, 10);
+      if (Number.isNaN(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid port: ${opts.port}`);
+      }
+      const serveDir = resolve(process.cwd(), opts.dir);
+      if (!existsSync(serveDir)) {
+        throw new Error(
+          `Serve directory not found: ${serveDir}
+Run \`scope site build\` first.`
+        );
+      }
+      const server = createServer((req, res) => {
+        const rawUrl = req.url ?? "/";
+        const urlPath = decodeURIComponent(rawUrl.split("?")[0] ?? "/");
+        const filePath = join(serveDir, urlPath.endsWith("/") ? `${urlPath}index.html` : urlPath);
+        if (!filePath.startsWith(serveDir)) {
+          res.writeHead(403, { "Content-Type": "text/plain" });
+          res.end("Forbidden");
+          return;
+        }
+        if (existsSync(filePath) && statSync(filePath).isFile()) {
+          const ext = extname(filePath).toLowerCase();
+          const contentType = MIME_TYPES[ext] ?? "application/octet-stream";
+          res.writeHead(200, { "Content-Type": contentType });
+          createReadStream(filePath).pipe(res);
+          return;
+        }
+        const htmlPath = `${filePath}.html`;
+        if (existsSync(htmlPath) && statSync(htmlPath).isFile()) {
+          res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+          createReadStream(htmlPath).pipe(res);
+          return;
+        }
+        res.writeHead(404, { "Content-Type": "text/plain" });
+        res.end(`Not found: ${urlPath}`);
+      });
+      server.listen(port, () => {
+        process.stderr.write(`Scope site running at http://localhost:${port}
+`);
+        process.stderr.write(`Serving ${serveDir}
+`);
+        process.stderr.write("Press Ctrl+C to stop.\n");
+      });
+      server.on("error", (err) => {
+        if (err.code === "EADDRINUSE") {
+          process.stderr.write(`Error: Port ${port} is already in use.
+`);
+        } else {
+          process.stderr.write(`Server error: ${err.message}
+`);
+        }
+        process.exit(1);
+      });
+    } catch (err) {
+      process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+  });
+}
+function createSiteCommand() {
+  const siteCmd = new Command("site").description(
+    "Build and serve the static component gallery site"
+  );
+  registerBuild(siteCmd);
+  registerServe(siteCmd);
+  return siteCmd;
+}
 var DEFAULT_STYLES_PATH = ".reactscope/compliance-styles.json";
 function loadStylesFile(stylesPath) {
   const absPath = resolve(process.cwd(), stylesPath);
@@ -5628,6 +5754,7 @@ function createProgram(options = {}) {
     registerDiffSubCommand(existingReportCmd);
     registerPrCommentSubCommand(existingReportCmd);
   }
+  program.addCommand(createSiteCommand());
   return program;
 }