@jay-framework/stack-route-scanner 0.22.2 → 0.23.1

package/dist/index.d.mts

@@ -23,6 +23,8 @@ type JayRoute = {
      * e.g., /products/ceramic-flower-vase declares { slug: 'ceramic-flower-vase' }.
      */
     inferredParams?: Record<string, string>;
+    /** When true, dev-server tooling route — consumers may filter from page navigation. */
+    devOnly?: boolean;
 };
 type JayRoutes = JayRoute[];
 interface ScanFilesOptions {
@@ -43,7 +45,9 @@ declare function parseRouteSegments(routePath: string): JayRouteSegment[];
  * Create a JayRoute from explicit path and file locations (DL#130).
  * Used for plugin-provided routes where the path is declared, not inferred from the filesystem.
  */
-declare function createRoute(routePath: string, jayHtmlPath: string, compPath: string, componentExport?: string): JayRoute;
+declare function createRoute(routePath: string, jayHtmlPath: string, compPath: string, componentExport?: string, options?: {
+    devOnly?: boolean;
+}): JayRoute;
 declare function scanRoutes(baseDir: string, options: ScanFilesOptions): Promise<JayRoutes>;
 
 declare function routeToExpressRoute(route: JayRoute): string;

package/dist/index.mjs

@@ -14,8 +14,7 @@ function convertToRoutePath(BASE_DIR, jayHtmlPath, { jayHtmlFilename, compFilena
   let rawRoute = jayHtmlPath.replace(BASE_DIR, "").replace(`/${jayHtmlFilename}`, "").replace("\\", "/");
   const segments = rawRoute.split("/").filter((segment) => segment.length > 0).map((segment) => {
     const match = segment.match(PARSE_PARAM);
-    if (!match)
-      return segment;
+    if (!match) return segment;
     const isOptional = !!match[1];
     const isCatchAll = !!match[2];
     const name = match[3];
@@ -36,8 +35,7 @@ async function scanDirectory(BASE_DIR, directory, options) {
   for (const item of items) {
     const fullPath = path.join(directory, item.name);
     if (item.isDirectory()) {
-      if (IGNORED_DIRS.has(item.name))
-        continue;
+      if (IGNORED_DIRS.has(item.name)) continue;
       routes = [...routes, ...await scanDirectory(BASE_DIR, fullPath, options)];
     } else if (item.name === options.jayHtmlFilename) {
       const route = convertToRoutePath(BASE_DIR, fullPath, options);
@@ -74,8 +72,7 @@ async function scanDirectory(BASE_DIR, directory, options) {
   return routes;
 }
 function getSegmentPriority(segment) {
-  if (typeof segment === "string")
-    return 0;
+  if (typeof segment === "string") return 0;
   switch (segment.type) {
     case 0:
       return 1;
@@ -90,18 +87,14 @@ function compareRoutes(a, b) {
   for (let i = 0; i < maxLen; i++) {
     const segA = a.segments[i];
     const segB = b.segments[i];
-    if (segA === void 0)
-      return 1;
-    if (segB === void 0)
-      return -1;
+    if (segA === void 0) return 1;
+    if (segB === void 0) return -1;
     const priorityA = getSegmentPriority(segA);
     const priorityB = getSegmentPriority(segB);
-    if (priorityA !== priorityB)
-      return priorityA - priorityB;
+    if (priorityA !== priorityB) return priorityA - priorityB;
     if (typeof segA === "string" && typeof segB === "string") {
       const cmp = segA.localeCompare(segB);
-      if (cmp !== 0)
-        return cmp;
+      if (cmp !== 0) return cmp;
     }
   }
   return 0;
@@ -111,8 +104,7 @@ function sortRoutesByPriority(routes) {
 }
 function dedentYaml(text) {
   const lines = text.split("\n").filter((l) => l.trim().length > 0);
-  if (lines.length === 0)
-    return "";
+  if (lines.length === 0) return "";
   const minIndent = Math.min(...lines.map((l) => l.match(/^\s*/)?.[0].length ?? 0));
   return lines.map((l) => l.slice(minIndent)).join("\n");
 }
@@ -141,13 +133,11 @@ async function parseHeadlessProps(jayHtmlPath) {
   let merged;
   for (const script of headlessScripts) {
     const body = dedentYaml(script.textContent ?? "");
-    if (!body)
-      continue;
+    if (!body) continue;
     try {
       const parsed = YAML.parse(body);
       if (parsed && typeof parsed === "object") {
-        if (!merged)
-          merged = {};
+        if (!merged) merged = {};
         for (const [k, v] of Object.entries(parsed)) {
           merged[k] = String(v);
         }
@@ -163,8 +153,7 @@ async function parseHeadlessProps(jayHtmlPath) {
 function parseRouteSegments(routePath) {
   return routePath.split("/").filter((s) => s.length > 0).map((segment) => {
     const match = segment.match(PARSE_PARAM);
-    if (!match)
-      return segment;
+    if (!match) return segment;
     return {
       name: match[3],
       type: match[1] ? 2 : match[2] ? 1 : 0
@@ -172,13 +161,14 @@ function parseRouteSegments(routePath) {
     };
   });
 }
-function createRoute(routePath, jayHtmlPath, compPath, componentExport) {
+function createRoute(routePath, jayHtmlPath, compPath, componentExport, options) {
   return {
     segments: parseRouteSegments(routePath),
     rawRoute: routePath,
     jayHtmlPath,
     compPath,
-    ...componentExport && { componentExport }
+    ...componentExport && { componentExport },
+    ...options?.devOnly && { devOnly: true }
   };
 }
 async function scanRoutes(baseDir, options) {

package/package.json

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