@jay-framework/stack-route-scanner 0.21.0 → 0.22.0

package/dist/index.d.mts

@@ -18,7 +18,7 @@ type JayRoute = {
     /** NPM package name for plugin routes. Used by build to generate portable module paths. */
     packageName?: string;
     /**
-     * Explicit params declared via <script type="application/jay-params"> in the jay-html.
+     * Explicit params declared via YAML body in headless component script tags (DL#156).
      * Used by static override routes to provide param values.
      * e.g., /products/ceramic-flower-vase declares { slug: 'ceramic-flower-vase' }.
      */

package/dist/index.mjs

@@ -41,9 +41,27 @@ async function scanDirectory(BASE_DIR, directory, options) {
       routes = [...routes, ...await scanDirectory(BASE_DIR, fullPath, options)];
     } else if (item.name === options.jayHtmlFilename) {
       const route = convertToRoutePath(BASE_DIR, fullPath, options);
-      const { params, validations } = await parseJayParams(fullPath);
+      const { params, validations } = await parseHeadlessProps(fullPath);
       if (params) {
-        route.inferredParams = params;
+        const hasDynamicSegments = route.segments.some((s) => typeof s !== "string");
+        if (hasDynamicSegments) {
+          const dynamicParamNames = new Set(
+            route.segments.filter(
+              (s) => typeof s !== "string"
+            ).map((s) => s.name)
+          );
+          const routeParams = {};
+          for (const [k, v] of Object.entries(params)) {
+            if (dynamicParamNames.has(k)) {
+              routeParams[k] = v;
+            }
+          }
+          if (Object.keys(routeParams).length > 0) {
+            route.inferredParams = routeParams;
+          }
+        } else {
+          route.inferredParams = params;
+        }
       }
       if (validations.length > 0) {
         for (const v of validations) {
@@ -98,7 +116,7 @@ function dedentYaml(text) {
   const minIndent = Math.min(...lines.map((l) => l.match(/^\s*/)?.[0].length ?? 0));
   return lines.map((l) => l.slice(minIndent)).join("\n");
 }
-async function parseJayParams(jayHtmlPath) {
+async function parseHeadlessProps(jayHtmlPath) {
   let content;
   try {
     content = await promises.readFile(jayHtmlPath, "utf-8");
@@ -110,28 +128,37 @@ async function parseJayParams(jayHtmlPath) {
     blockTextElements: { script: true, style: true }
   });
   const head = root.querySelector("head");
+  const validations = [];
   const paramScripts = (head ?? root).querySelectorAll('script[type="application/jay-params"]');
-  if (paramScripts.length === 0)
-    return { params: void 0, validations: [] };
-  if (paramScripts.length > 1) {
-    return {
-      params: void 0,
-      validations: [
-        'Multiple <script type="application/jay-params"> tags found — expected at most one'
-      ]
-    };
+  if (paramScripts.length > 0) {
+    validations.push(
+      '<script type="application/jay-params"> is deprecated. Move the values into the YAML body of the headless component that uses them. See agent-kit/developer/routing.md for details.'
+    );
   }
-  const body = dedentYaml(paramScripts[0].textContent ?? "");
-  if (!body)
-    return { params: void 0, validations: [] };
-  try {
-    return { params: YAML.parse(body), validations: [] };
-  } catch (e) {
-    return {
-      params: void 0,
-      validations: [`Failed to parse jay-params YAML: ${e.message}`]
-    };
+  const headlessScripts = (head ?? root).querySelectorAll(
+    'script[type="application/jay-headless"]'
+  );
+  let merged;
+  for (const script of headlessScripts) {
+    const body = dedentYaml(script.textContent ?? "");
+    if (!body)
+      continue;
+    try {
+      const parsed = YAML.parse(body);
+      if (parsed && typeof parsed === "object") {
+        if (!merged)
+          merged = {};
+        for (const [k, v] of Object.entries(parsed)) {
+          merged[k] = String(v);
+        }
+      }
+    } catch (e) {
+      validations.push(
+        `Failed to parse headless component props YAML: ${e.message}`
+      );
+    }
   }
+  return { params: merged, validations };
 }
 function parseRouteSegments(routePath) {
   return routePath.split("/").filter((s) => s.length > 0).map((segment) => {
@@ -160,7 +187,7 @@ async function scanRoutes(baseDir, options) {
   const sortedRoutes = sortRoutesByPriority(routes);
   const routesWithParams = sortedRoutes.filter((r) => r.inferredParams);
   if (routesWithParams.length > 0) {
-    getLogger().info("[route-scanner] Routes with explicit params (jay-params):");
+    getLogger().info("[route-scanner] Routes with explicit params (headless props):");
     for (const route of routesWithParams) {
       getLogger().info(`  ${route.rawRoute} → ${JSON.stringify(route.inferredParams)}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/stack-route-scanner",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "license": "Apache-2.0",
   "main": "dist/index.mjs",
   "types": "dist/index.d.mts",
@@ -9,7 +9,7 @@
     "readme.md"
   ],
   "dependencies": {
-    "@jay-framework/logger": "^0.21.0",
+    "@jay-framework/logger": "^0.22.0",
     "node-html-parser": "^6.1.12",
     "yaml": "^2.3.4"
   },
@@ -25,7 +25,7 @@
     "test:watch": "vitest"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.21.0",
+    "@jay-framework/dev-environment": "^0.22.0",
     "@types/node": "^20.11.5",
     "nodemon": "^3.0.3",
     "replace-in-file": "^7.1.0",