rtgl 0.0.38 → 1.0.0-rc1

package/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { build, scaffold, watch, examples } from "@rettangoli/fe/cli";
+import { build, check, scaffold, watch, examples } from "@rettangoli/fe/cli";
 import { generate, report, accept } from "@rettangoli/vt/cli";
 import { buildSite, watchSite, screenshotCommand, initSite } from "@rettangoli/sites/cli";
 import { buildSvg } from "@rettangoli/ui/cli";
@@ -25,11 +25,14 @@ function readConfig() {
     const configContent = readFileSync(configPath, "utf8");
     return yaml.load(configContent);
   } catch (error) {
-    console.error("Error reading config file:", error.message);
-    return null;
+    throw new Error(`Error reading config file "${configPath}": ${error.message}`);
   }
 }
 
+function collectValues(value, previous = []) {
+  return [...previous, value];
+}
+
 const program = new Command();
 
 program
@@ -103,6 +106,41 @@ Examples:
     build(options);
   });
 
+feCommand
+  .command("check")
+  .description("Validate frontend component file contracts")
+  .option("--format <format>", "Output format: text or json", "text")
+  .addHelpText(
+    "after",
+    `
+
+Examples:
+  $ rettangoli fe check
+  $ rettangoli fe check --format json
+`,
+  )
+  .action((options) => {
+    const config = readConfig();
+
+    if (!config) {
+      throw new Error("rettangoli.config.yaml not found");
+    }
+
+    if (!config.fe?.dirs?.length) {
+      throw new Error("fe.dirs not found or empty in config");
+    }
+
+    const missingDirs = config.fe.dirs.filter(
+      (dir) => !existsSync(resolve(process.cwd(), dir)),
+    );
+    if (missingDirs.length > 0) {
+      throw new Error(`Directories do not exist: ${missingDirs.join(", ")}`);
+    }
+
+    options.dirs = config.fe.dirs;
+    check(options);
+  });
+
 feCommand
   .command("scaffold")
   .description("Scaffold UI components")
@@ -195,10 +233,14 @@ vtCommand
   .command("generate")
   .description("Generate visualizations")
   .option("--skip-screenshots", "Skip screenshot generation")
-  .option("--screenshot-wait-time <time>", "Wait time between screenshots", parseInt, 0)
-  .option("--concurrency <number>", "Number of concurrent screenshots", parseInt, 12)
-  .option("--wait-event <name>", "Custom event name to wait for instead of networkidle (e.g., vt:ready)")
-  .action((options) => {
+  .option("--concurrency <number>", "Number of parallel capture workers", parseInt)
+  .option("--timeout <ms>", "Global capture timeout in ms", parseInt)
+  .option("--wait-event <name>", "Custom event name to mark page ready (uses event wait strategy)")
+  .option("--folder <path>", "Run only specs under folder prefix (repeatable)", collectValues, [])
+  .option("--group <section-key>", "Run only one section key from vt.sections (repeatable)", collectValues, [])
+  .option("--item <spec-path>", "Run only one spec path relative to vt/specs (repeatable)", collectValues, [])
+  .option("--headed", "Run Playwright in headed mode")
+  .action(async (options) => {
     console.log(`rtgl v${packageJson.version}`);
     const config = readConfig();
 
@@ -208,17 +250,23 @@ vtCommand
 
     // Use vt.path from config, default to 'vt'
     options.vtPath = config.vt?.path || "vt";
+    if (options.headed) {
+      options.headless = false;
+    }
 
-    generate(options);
+    await generate(options);
   });
 
 vtCommand
   .command("report")
   .description("Create reports")
-  .option("--compare-method <method>", "Comparison method: pixelmatch or md5", "pixelmatch")
-  .option("--color-threshold <number>", "Color threshold for pixelmatch (0-1)", parseFloat, 0.1)
-  .option("--diff-threshold <number>", "Max diff pixels percentage to pass (0-100)", parseFloat, 0.3)
-  .action((options) => {
+  .option("--compare-method <method>", "Comparison method: pixelmatch or md5")
+  .option("--color-threshold <number>", "Color threshold for pixelmatch (0-1)", parseFloat)
+  .option("--diff-threshold <number>", "Max diff pixels percentage to pass (0-100)", parseFloat)
+  .option("--folder <path>", "Compare only screenshots under folder prefix (repeatable)", collectValues, [])
+  .option("--group <section-key>", "Compare only one section key from vt.sections (repeatable)", collectValues, [])
+  .option("--item <spec-path>", "Compare only one spec path relative to vt/specs (repeatable)", collectValues, [])
+  .action(async (options) => {
     const config = readConfig();
 
     if (!config) {
@@ -226,18 +274,21 @@ vtCommand
     }
 
     const vtPath = config.vt?.path || "vt";
-    report({
+    await report({
       vtPath,
       compareMethod: options.compareMethod,
       colorThreshold: options.colorThreshold,
       diffThreshold: options.diffThreshold,
+      folder: options.folder,
+      group: options.group,
+      item: options.item,
     });
   });
 
 vtCommand
   .command("accept")
   .description("Accept changes")
-  .action(() => {
+  .action(async () => {
     const config = readConfig();
 
     if (!config) {
@@ -245,7 +296,7 @@ vtCommand
     }
 
     const vtPath = config.vt?.path || "vt";
-    accept({ vtPath });
+    await accept({ vtPath });
   });
 
 const sitesCommand = program.command("sites").description("Rettangoli Sites");
@@ -349,4 +400,4 @@ Examples:
     buildSvg(options);
   });
 
-program.parse();
+await program.parseAsync();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rtgl",
-  "version": "0.0.38",
+  "version": "1.0.0-rc1",
   "description": "CLI tool for Rettangoli - A frontend framework and development toolkit",
   "type": "module",
   "bin": {
@@ -49,7 +49,7 @@
     "js-yaml": "^4.1.0",
     "@rettangoli/fe": "0.0.14",
     "@rettangoli/sites": "0.2.7",
-    "@rettangoli/vt": "0.0.14",
+    "@rettangoli/vt": "1.0.0-rc1",
     "@rettangoli/ui": "0.1.31"
   }
 }