@jay-framework/plugin-validator 0.25.0 → 0.25.2

package/dist/index.d.ts

@@ -18,7 +18,7 @@ interface ValidationResult {
     typesGenerated?: number;
 }
 interface ValidationError {
-    type: 'schema' | 'file-missing' | 'export-mismatch' | 'contract-invalid' | 'component-contract-mismatch' | 'type-generation-failed' | 'add-menu-catalog' | 'compiler-leak';
+    type: 'schema' | 'file-missing' | 'export-mismatch' | 'contract-invalid' | 'component-contract-mismatch' | 'type-generation-failed' | 'add-menu-catalog' | 'compiler-leak' | 'jay-html-compile';
     message: string;
     location?: string;
     suggestion?: string;

package/dist/index.js

@@ -1,8 +1,8 @@
 import fs from "fs";
 import path from "path";
 import YAML from "yaml";
-import { loadPluginManifest, normalizeActionEntry } from "@jay-framework/compiler-shared";
-import { parseContract } from "@jay-framework/compiler-jay-html";
+import { JAY_EXTENSION, RuntimeMode, loadPluginManifest, normalizeActionEntry } from "@jay-framework/compiler-shared";
+import { parseJayFile, JAY_IMPORT_RESOLVER, generateElementFile, generateServerElementFile, parseContract } from "@jay-framework/compiler-jay-html";
 import { ts } from "@jay-framework/typescript-bridge";
 const FRAMEWORK_PROP_TYPES = /* @__PURE__ */ new Set(["PageProps", "RequestQuery"]);
 function checkComponentPropsAndParams(sourceCode, contract, contractName, contractPath, sourcePath) {
@@ -1157,6 +1157,61 @@ async function validateAiditorSettings(context, result) {
     });
   }
 }
+async function compileValidateRouteJayHtml(absoluteJayHtmlPath, pluginRoot) {
+  const content = fs.readFileSync(absoluteJayHtmlPath, "utf-8");
+  const dirname = path.dirname(absoluteJayHtmlPath);
+  const filename = path.basename(absoluteJayHtmlPath, JAY_EXTENSION);
+  const errors = [];
+  try {
+    const parsedFile = await parseJayFile(
+      content,
+      filename,
+      dirname,
+      {},
+      JAY_IMPORT_RESOLVER,
+      pluginRoot
+    );
+    for (const validation of parsedFile.validations) {
+      errors.push(validation);
+    }
+    if (!parsedFile.val || parsedFile.validations.length > 0) {
+      return errors;
+    }
+    const generatedFile = generateElementFile(parsedFile.val, RuntimeMode.MainTrusted);
+    for (const validation of generatedFile.validations) {
+      errors.push(validation);
+    }
+    const serverElementFile = generateServerElementFile(parsedFile.val);
+    for (const validation of serverElementFile.validations) {
+      errors.push(`[SSR] ${validation}`);
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    errors.push(message);
+  }
+  return errors;
+}
+async function validateRouteJayHtmlTemplates(context, result) {
+  const routes = context.manifest.routes;
+  if (!routes || !Array.isArray(routes)) return;
+  for (const route of routes) {
+    if (!route.jayHtml) continue;
+    const absolutePath = path.resolve(context.pluginPath, route.jayHtml);
+    if (!fs.existsSync(absolutePath)) {
+      continue;
+    }
+    const compileErrors = await compileValidateRouteJayHtml(absolutePath, context.pluginPath);
+    const relPath = path.relative(context.pluginPath, absolutePath);
+    for (const message of compileErrors) {
+      result.errors.push({
+        type: "jay-html-compile",
+        message: `Route "${route.path}" jayHtml failed to compile: ${message}`,
+        location: relPath,
+        suggestion: "Fix the template syntax or run `jay-stack validate -p <dir>` on the source page during development. See agent-kit/designer/jay-html-template-syntax.md"
+      });
+    }
+  }
+}
 async function validatePlugin(options = {}) {
   const pluginPath = options.pluginPath || process.cwd();
   if (options.local) {
@@ -1226,6 +1281,7 @@ async function validatePluginPackage(pluginPath, options) {
   await validateAddMenuCatalog(context, result);
   await validateAiditorSettings(context, result);
   validateNoCompilerLeak(context, result);
+  await validateRouteJayHtmlTemplates(context, result);
   result.valid = result.errors.length === 0;
   return result;
 }
@@ -2080,6 +2136,20 @@ async function validatePackageJson(context, result) {
         suggestion: 'Add "./plugin.yaml": "./plugin.yaml" to exports field'
       });
     }
+    if (context.manifest.commands) {
+      for (const cmd of context.manifest.commands) {
+        if (!cmd.command) continue;
+        const exportKey = `./${cmd.command}`;
+        if (!packageJson.exports || !packageJson.exports[exportKey]) {
+          result.errors.push({
+            type: "export-mismatch",
+            message: `command metadata file "${cmd.command}" not exported in package.json (required for plugin resolution)`,
+            location: packageJsonPath,
+            suggestion: `Add "${exportKey}": "${exportKey}" to exports field`
+          });
+        }
+      }
+    }
     const agentKitDir = path.join(context.pluginPath, "agent-kit");
     if (fs.existsSync(agentKitDir) && fs.statSync(agentKitDir).isDirectory()) {
       const filesArray = packageJson.files;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/plugin-validator",
-  "version": "0.25.0",
+  "version": "0.25.2",
   "type": "module",
   "license": "Apache-2.0",
   "description": "Validation tool for Jay Stack plugins",
@@ -25,14 +25,14 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/compiler-jay-html": "^0.25.0",
-    "@jay-framework/compiler-shared": "^0.25.0",
-    "@jay-framework/typescript-bridge": "^0.25.0",
+    "@jay-framework/compiler-jay-html": "^0.25.2",
+    "@jay-framework/compiler-shared": "^0.25.2",
+    "@jay-framework/typescript-bridge": "^0.25.2",
     "chalk": "^4.1.2",
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.25.0",
+    "@jay-framework/dev-environment": "^0.25.2",
     "@types/node": "^22.15.21",
     "rimraf": "^5.0.5",
     "tsup": "^8.0.1",