@jay-framework/jay-stack-cli 0.15.3 → 0.15.5

package/agent-kit-template/contracts-and-plugins.md

@@ -244,6 +244,7 @@ Schemas use a compact type notation:
 | `propName: enum(a \| b \| c)`     | Required enum                                            |
 | `propName:` + nested block        | Nested object                                            |
 | `propName:` + `- childProp: type` | Array of objects (YAML list)                             |
+| `propName: record(T)`             | Record with typed values (e.g., `record(boolean)`)       |
 | `propName: importedName`          | Type from `import:` block (references a `.jay-contract`) |
 | `- importedName`                  | Array of imported type                                   |
 

package/dist/index.js

@@ -8,7 +8,7 @@ import path from "path";
 import fs, { promises } from "fs";
 import YAML from "yaml";
 import { getLogger, createDevLogger, setDevLogger } from "@jay-framework/logger";
-import { parseJayFile, JAY_IMPORT_RESOLVER, generateElementDefinitionFile, ContractTagType, parseContract, generateElementFile } from "@jay-framework/compiler-jay-html";
+import { parseJayFile, JAY_IMPORT_RESOLVER, generateElementDefinitionFile, ContractTagType, parseContract, generateElementFile, htmlElementTagNameMap } from "@jay-framework/compiler-jay-html";
 import { JAY_CONTRACT_EXTENSION, JAY_EXTENSION, resolvePluginManifest, LOCAL_PLUGIN_PATH, JayAtomicType, JayEnumType, loadPluginManifest, RuntimeMode, GenerateTarget } from "@jay-framework/compiler-shared";
 import { listContracts, materializeContracts } from "@jay-framework/stack-server-runtime";
 import { listContracts as listContracts2, materializeContracts as materializeContracts2 } from "@jay-framework/stack-server-runtime";
@@ -3129,6 +3129,128 @@ function analyzeTagCoverage(jayHtml, file) {
   }
   return { file, contracts };
 }
+const htmlTagNameMap = htmlElementTagNameMap;
+function resolveContractTag(contract, tagPath) {
+  const segments = tagPath.split(".");
+  let tags = contract.tags;
+  for (let i = 0; i < segments.length; i++) {
+    const tag = tags.find((t) => t.tag === segments[i]);
+    if (!tag)
+      return void 0;
+    if (i === segments.length - 1)
+      return tag;
+    if (!tag.tags)
+      return void 0;
+    tags = tag.tags;
+  }
+  return void 0;
+}
+function checkRefElementTypes(jayHtml, file) {
+  const imports = jayHtml.headlessImports;
+  const keyMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < imports.length; i++) {
+    if (imports[i].key) {
+      keyMap.set(imports[i].key, i);
+    }
+  }
+  const warnings = [];
+  function checkRef(ref, scopes) {
+    const refPath = ref.refPath;
+    const dot = refPath.indexOf(".");
+    let importIndex;
+    let tagPath;
+    if (dot !== -1) {
+      const key = refPath.substring(0, dot);
+      const idx = keyMap.get(key);
+      if (idx !== void 0) {
+        importIndex = idx;
+        tagPath = refPath.substring(dot + 1);
+      }
+    }
+    if (importIndex === void 0 && scopes.length > 0) {
+      const scope = scopes[scopes.length - 1];
+      importIndex = scope.importIndex;
+      tagPath = scope.prefix ? `${scope.prefix}.${refPath}` : refPath;
+    }
+    if (importIndex === void 0)
+      return;
+    const imp = imports[importIndex];
+    if (!imp.contract)
+      return;
+    const contractTag = resolveContractTag(imp.contract, tagPath);
+    if (!contractTag || !contractTag.elementType)
+      return;
+    const contractTypes = contractTag.elementType;
+    if (contractTypes.includes("HTMLElement"))
+      return;
+    if (!contractTypes.includes(ref.actualType)) {
+      const label = imp.key ? `${imp.key}.${tagPath}` : tagPath;
+      warnings.push(
+        `Ref "${label}" is on a <${ref.htmlTag}> (${ref.actualType}) but the contract declares ${contractTypes.join(" | ")}`
+      );
+    }
+  }
+  function walkElement(element, scopes) {
+    const tagName = element.rawTagName?.toLowerCase();
+    let childScopes = scopes;
+    if (tagName?.startsWith("jay:")) {
+      const contractName = tagName.substring(4);
+      const idx = imports.findIndex(
+        (imp) => imp.contractName === contractName && imp.contract
+      );
+      if (idx !== -1) {
+        childScopes = [...scopes, { importIndex: idx, prefix: "" }];
+      }
+    }
+    const forEachVal = element.getAttribute?.("forEach");
+    if (forEachVal) {
+      const fePath = extractTagPath(forEachVal);
+      if (fePath) {
+        const dot = fePath.indexOf(".");
+        if (dot !== -1) {
+          const key = fePath.substring(0, dot);
+          const idx = keyMap.get(key);
+          if (idx !== void 0) {
+            childScopes = [
+              ...childScopes,
+              { importIndex: idx, prefix: fePath.substring(dot + 1) }
+            ];
+          }
+        } else if (childScopes.length > 0) {
+          const scope = childScopes[childScopes.length - 1];
+          const newPrefix = scope.prefix ? `${scope.prefix}.${fePath}` : fePath;
+          childScopes = [
+            ...childScopes,
+            { importIndex: scope.importIndex, prefix: newPrefix }
+          ];
+        }
+      }
+    }
+    if (tagName === "with-data") {
+      const accessor = element.getAttribute?.("accessor");
+      if (accessor && accessor !== "." && childScopes.length > 0) {
+        const scope = childScopes[childScopes.length - 1];
+        const newPrefix = scope.prefix ? `${scope.prefix}.${accessor}` : accessor;
+        childScopes = [
+          ...childScopes,
+          { importIndex: scope.importIndex, prefix: newPrefix }
+        ];
+      }
+    }
+    const refVal = element.getAttribute?.("ref");
+    if (refVal && tagName) {
+      const actualType = htmlTagNameMap[tagName] ?? "HTMLElement";
+      checkRef({ refPath: refVal, htmlTag: tagName, actualType }, childScopes);
+    }
+    for (const child of element.childNodes ?? []) {
+      if (child.nodeType === 1) {
+        walkElement(child, childScopes);
+      }
+    }
+  }
+  walkElement(jayHtml.body, []);
+  return warnings;
+}
 const PARSE_PARAM = /^\[(\[)?(\.\.\.)?([^\]]+)\]?\]$/;
 function extractRouteParams(filePath, pagesBase) {
   const relative = path.relative(pagesBase, filePath);
@@ -3282,6 +3404,10 @@ async function validateJayFiles(options = {}) {
       for (const msg of routeParamWarnings) {
         warnings.push({ file: relativePath, message: msg });
       }
+      const refTypeErrors = checkRefElementTypes(parsedFile.val, relativePath);
+      for (const msg of refTypeErrors) {
+        errors.push({ file: relativePath, message: msg, stage: "generate" });
+      }
       const fileCoverage = analyzeTagCoverage(parsedFile.val, relativePath);
       if (fileCoverage) {
         coverage.push(fileCoverage);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/jay-stack-cli",
-  "version": "0.15.3",
+  "version": "0.15.5",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -24,14 +24,14 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/compiler-jay-html": "^0.15.3",
-    "@jay-framework/compiler-shared": "^0.15.3",
-    "@jay-framework/dev-server": "^0.15.3",
-    "@jay-framework/editor-server": "^0.15.3",
-    "@jay-framework/fullstack-component": "^0.15.3",
-    "@jay-framework/logger": "^0.15.3",
-    "@jay-framework/plugin-validator": "^0.15.3",
-    "@jay-framework/stack-server-runtime": "^0.15.3",
+    "@jay-framework/compiler-jay-html": "^0.15.5",
+    "@jay-framework/compiler-shared": "^0.15.5",
+    "@jay-framework/dev-server": "^0.15.5",
+    "@jay-framework/editor-server": "^0.15.5",
+    "@jay-framework/fullstack-component": "^0.15.5",
+    "@jay-framework/logger": "^0.15.5",
+    "@jay-framework/plugin-validator": "^0.15.5",
+    "@jay-framework/stack-server-runtime": "^0.15.5",
     "chalk": "^4.1.2",
     "commander": "^14.0.0",
     "express": "^5.0.1",
@@ -42,7 +42,7 @@
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.15.3",
+    "@jay-framework/dev-environment": "^0.15.5",
     "@types/express": "^5.0.2",
     "@types/node": "^22.15.21",
     "nodemon": "^3.0.3",