@jay-framework/jay-stack-cli 0.10.0 → 0.11.0

package/README.md

@@ -14,16 +14,68 @@ npm install @jay-framework/stack-cli
 
 ## Usage
 
-### Basic Usage
+### Commands
 
-Simply run the CLI from your project root:
+#### `jay-stack dev [path]`
+
+Start the development server:
 
 ```bash
-@jay-framework/@jay-framework/jay-cli
+jay-stack dev              # Start dev server in current directory
+jay-stack dev ./my-project # Start dev server in specified directory
 ```
 
 This will start both the development server and editor server with default configuration.
 
+#### `jay-stack validate [path]`
+
+Validate all `.jay-html` and `.jay-contract` files in the project without creating output files:
+
+```bash
+jay-stack validate              # Validate files in pagesBase from config
+jay-stack validate ./src/pages  # Validate files in specified directory
+jay-stack validate --verbose    # Show per-file validation status
+jay-stack validate --json       # Output results as JSON (for CI/tooling)
+```
+
+This command is useful for:
+
+- **CI pipelines**: Returns exit code 1 on validation errors
+- **Development workflow**: Quick syntax checking without running the dev server
+- **Vite integration**: Validate generated `.jay-html` files
+
+Example output:
+
+```
+✅ Jay Stack validation successful!
+
+Scanned 12 .jay-html files, 5 .jay-contract files
+No errors found.
+```
+
+Or with errors:
+
+```
+❌ Jay Stack validation failed
+
+Errors:
+  ❌ src/pages/product/page.jay-html
+     jay file should have exactly one jay-data script, found 2
+
+1 error(s) found, 11 file(s) valid.
+```
+
+#### `jay-stack validate-plugin [path]`
+
+Validate a Jay Stack plugin package:
+
+```bash
+jay-stack validate-plugin              # Validate plugin in current directory
+jay-stack validate-plugin ./my-plugin  # Validate plugin in specified directory
+jay-stack validate-plugin --verbose    # Show detailed validation output
+jay-stack validate-plugin --strict     # Treat warnings as errors (for CI)
+```
+
 ### Configuration
 
 The CLI uses a `.jay` configuration file (YAML format) to customize port ranges for both servers. Create a `.jay` file in your project root:
@@ -143,15 +195,29 @@ The CLI is built using:
 - **get-port** - Automatic port discovery
 - **Vite** - Build tool integration
 
-## Future Enhancements
+## CLI Reference
+
+| Command                            | Description                              |
+| ---------------------------------- | ---------------------------------------- |
+| `jay-stack dev [path]`             | Start the development server             |
+| `jay-stack validate [path]`        | Validate jay-html and jay-contract files |
+| `jay-stack validate-plugin [path]` | Validate a plugin package                |
+
+### Validate Command Options
+
+| Option          | Description                     |
+| --------------- | ------------------------------- |
+| `-v, --verbose` | Show per-file validation status |
+| `--json`        | Output results as JSON          |
 
-**Note**: The CLI currently does not accept command-line parameters. This will change in future versions to support:
+### Validate-Plugin Command Options
 
-- Custom pages directory path
-- Custom TypeScript configuration file
-- Custom output directory
-- Additional server configuration options
-- Development vs production modes
+| Option             | Description                            |
+| ------------------ | -------------------------------------- |
+| `-v, --verbose`    | Show detailed validation output        |
+| `--strict`         | Treat warnings as errors (for CI)      |
+| `--local`          | Validate local plugins in src/plugins/ |
+| `--generate-types` | Generate .d.ts files for contracts     |
 
 ## Related Packages
 

package/dist/index.js

@@ -4,14 +4,15 @@ import { mkDevServer } from "@jay-framework/dev-server";
 import { createEditorServer } from "@jay-framework/editor-server";
 import getPort from "get-port";
 import path from "path";
-import fs from "fs";
+import fs, { promises } from "fs";
 import YAML from "yaml";
 import { parse } from "node-html-parser";
 import { createRequire } from "module";
-import { parseJayFile, JAY_IMPORT_RESOLVER, generateElementDefinitionFile, parseContract, ContractTagType } from "@jay-framework/compiler-jay-html";
-import { JAY_CONTRACT_EXTENSION, JAY_EXTENSION, JayAtomicType, JayEnumType, loadPluginManifest } from "@jay-framework/compiler-shared";
+import { parseJayFile, JAY_IMPORT_RESOLVER, generateElementDefinitionFile, parseContract, ContractTagType, generateElementFile } from "@jay-framework/compiler-jay-html";
+import { JAY_CONTRACT_EXTENSION, JAY_EXTENSION, JayAtomicType, JayEnumType, loadPluginManifest, RuntimeMode, GenerateTarget } from "@jay-framework/compiler-shared";
 import { Command } from "commander";
 import chalk from "chalk";
+import { glob } from "glob";
 const DEFAULT_CONFIG = {
   devServer: {
     portRange: [3e3, 3100],
@@ -1459,6 +1460,148 @@ async function validateDynamicContracts(context, result) {
     }
   }
 }
+async function findJayFiles(dir) {
+  return await glob(`${dir}/**/*${JAY_EXTENSION}`);
+}
+async function findContractFiles(dir) {
+  return await glob(`${dir}/**/*${JAY_CONTRACT_EXTENSION}`);
+}
+async function validateJayFiles(options = {}) {
+  const config = loadConfig();
+  const resolvedConfig = getConfigWithDefaults(config);
+  const projectRoot = process.cwd();
+  const scanDir = options.path ? path.resolve(options.path) : path.resolve(resolvedConfig.devServer.pagesBase);
+  const errors = [];
+  const warnings = [];
+  const jayHtmlFiles = await findJayFiles(scanDir);
+  const contractFiles = await findContractFiles(scanDir);
+  if (options.verbose) {
+    console.log(chalk.gray(`Scanning directory: ${scanDir}`));
+    console.log(chalk.gray(`Found ${jayHtmlFiles.length} .jay-html files`));
+    console.log(chalk.gray(`Found ${contractFiles.length} .jay-contract files
+`));
+  }
+  for (const contractFile of contractFiles) {
+    const relativePath = path.relative(projectRoot, contractFile);
+    try {
+      const content = await promises.readFile(contractFile, "utf-8");
+      const result = parseContract(content, path.basename(contractFile));
+      if (result.validations.length > 0) {
+        for (const validation of result.validations) {
+          errors.push({
+            file: relativePath,
+            message: validation,
+            stage: "parse"
+          });
+        }
+        if (options.verbose) {
+          console.log(chalk.red(`❌ ${relativePath}`));
+        }
+      } else if (options.verbose) {
+        console.log(chalk.green(`✓ ${relativePath}`));
+      }
+    } catch (error) {
+      errors.push({
+        file: relativePath,
+        message: error.message,
+        stage: "parse"
+      });
+      if (options.verbose) {
+        console.log(chalk.red(`❌ ${relativePath}`));
+      }
+    }
+  }
+  for (const jayFile of jayHtmlFiles) {
+    const relativePath = path.relative(projectRoot, jayFile);
+    const filename = path.basename(jayFile.replace(JAY_EXTENSION, ""));
+    const dirname = path.dirname(jayFile);
+    try {
+      const content = await promises.readFile(jayFile, "utf-8");
+      const parsedFile = await parseJayFile(
+        content,
+        filename,
+        dirname,
+        {},
+        JAY_IMPORT_RESOLVER,
+        projectRoot
+      );
+      if (parsedFile.validations.length > 0) {
+        for (const validation of parsedFile.validations) {
+          errors.push({
+            file: relativePath,
+            message: validation,
+            stage: "parse"
+          });
+        }
+        if (options.verbose) {
+          console.log(chalk.red(`❌ ${relativePath}`));
+        }
+        continue;
+      }
+      const generatedFile = generateElementFile(
+        parsedFile.val,
+        RuntimeMode.MainTrusted,
+        GenerateTarget.jay
+      );
+      if (generatedFile.validations.length > 0) {
+        for (const validation of generatedFile.validations) {
+          errors.push({
+            file: relativePath,
+            message: validation,
+            stage: "generate"
+          });
+        }
+        if (options.verbose) {
+          console.log(chalk.red(`❌ ${relativePath}`));
+        }
+      } else if (options.verbose) {
+        console.log(chalk.green(`✓ ${relativePath}`));
+      }
+    } catch (error) {
+      errors.push({
+        file: relativePath,
+        message: error.message,
+        stage: "parse"
+      });
+      if (options.verbose) {
+        console.log(chalk.red(`❌ ${relativePath}`));
+      }
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    jayHtmlFilesScanned: jayHtmlFiles.length,
+    contractFilesScanned: contractFiles.length,
+    errors,
+    warnings
+  };
+}
+function printJayValidationResult(result, options) {
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log("");
+  if (result.valid) {
+    console.log(chalk.green("✅ Jay Stack validation successful!\n"));
+    console.log(
+      `Scanned ${result.jayHtmlFilesScanned} .jay-html files, ${result.contractFilesScanned} .jay-contract files`
+    );
+    console.log("No errors found.");
+  } else {
+    console.log(chalk.red("❌ Jay Stack validation failed\n"));
+    console.log("Errors:");
+    for (const error of result.errors) {
+      console.log(chalk.red(`  ❌ ${error.file}`));
+      console.log(chalk.gray(`     ${error.message}`));
+      console.log("");
+    }
+    const validFiles = result.jayHtmlFilesScanned + result.contractFilesScanned - result.errors.length;
+    console.log(
+      chalk.red(`${result.errors.length} error(s) found, ${validFiles} file(s) valid.`)
+    );
+  }
+}
 const program = new Command();
 program.name("jay-stack").description("Jay Stack CLI - Development server and plugin validation").version("0.9.0");
 program.command("dev [path]").description("Start the Jay Stack development server").action(async (path2, options) => {
@@ -1471,6 +1614,26 @@ program.command("dev [path]").description("Start the Jay Stack development serve
     process.exit(1);
   }
 });
+program.command("validate [path]").description("Validate all .jay-html and .jay-contract files in the project").option("-v, --verbose", "Show per-file validation status").option("--json", "Output results as JSON").action(async (scanPath, options) => {
+  try {
+    const result = await validateJayFiles({
+      path: scanPath,
+      verbose: options.verbose,
+      json: options.json
+    });
+    printJayValidationResult(result, options);
+    if (!result.valid) {
+      process.exit(1);
+    }
+  } catch (error) {
+    if (options.json) {
+      console.log(JSON.stringify({ valid: false, error: error.message }, null, 2));
+    } else {
+      console.error(chalk.red("Validation error:"), error.message);
+    }
+    process.exit(1);
+  }
+});
 program.command("validate-plugin [path]").description("Validate a Jay Stack plugin package").option("--local", "Validate local plugins in src/plugins/").option("-v, --verbose", "Show detailed validation output").option("--strict", "Treat warnings as errors (for CI)").option("--generate-types", "Generate .d.ts files for contracts").action(async (pluginPath, options) => {
   try {
     const result = await validatePlugin({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/jay-stack-cli",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -23,16 +23,19 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/dev-server": "^0.10.0",
-    "@jay-framework/editor-server": "^0.10.0",
-    "@jay-framework/plugin-validator": "^0.10.0",
+    "@jay-framework/compiler-jay-html": "^0.11.0",
+    "@jay-framework/compiler-shared": "^0.11.0",
+    "@jay-framework/dev-server": "^0.11.0",
+    "@jay-framework/editor-server": "^0.11.0",
+    "@jay-framework/plugin-validator": "^0.11.0",
     "chalk": "^4.1.2",
     "commander": "^14.0.0",
     "express": "^5.0.1",
+    "glob": "^10.3.10",
     "vite": "^5.0.11"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.10.0",
+    "@jay-framework/dev-environment": "^0.11.0",
     "@types/express": "^5.0.2",
     "@types/node": "^22.15.21",
     "nodemon": "^3.0.3",