@jay-framework/stack-route-scanner 0.15.6 → 0.16.0

package/dist/index.d.mts

@@ -30,8 +30,18 @@ interface ScanFilesOptions {
  * Static routes come before dynamic routes at the same position.
  */
 declare function sortRoutesByPriority(routes: JayRoutes): JayRoutes;
+/**
+ * Parse a route path string into segments (DL#130).
+ * Supports [param], [[optional]], [...catchAll] patterns.
+ */
+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): JayRoute;
 declare function scanRoutes(baseDir: string, options: ScanFilesOptions): Promise<JayRoutes>;
 
 declare function routeToExpressRoute(route: JayRoute): string;
 
-export { type JayRoute, type JayRouteParam, JayRouteParamType, type JayRouteSegment, type JayRoutes, type ScanFilesOptions, routeToExpressRoute, scanRoutes, sortRoutesByPriority };
+export { type JayRoute, type JayRouteParam, JayRouteParamType, type JayRouteSegment, type JayRoutes, type ScanFilesOptions, createRoute, parseRouteSegments, routeToExpressRoute, scanRoutes, sortRoutesByPriority };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { promises } from "fs";
+import { promises, existsSync } from "fs";
 import path from "path";
 import { parse } from "node-html-parser";
 import YAML from "yaml";
@@ -25,7 +25,8 @@ function convertToRoutePath(BASE_DIR, jayHtmlPath, { jayHtmlFilename, compFilena
       /* single */
     };
   });
-  const compPath = jayHtmlPath.replace(jayHtmlFilename, compFilename);
+  const candidateCompPath = jayHtmlPath.replace(jayHtmlFilename, compFilename);
+  const compPath = existsSync(candidateCompPath) ? candidateCompPath : "";
   return { segments, jayHtmlPath, compPath, rawRoute };
 }
 async function scanDirectory(BASE_DIR, directory, options) {
@@ -129,6 +130,26 @@ async function parseJayParams(jayHtmlPath) {
     };
   }
 }
+function parseRouteSegments(routePath) {
+  return routePath.split("/").filter((s) => s.length > 0).map((segment) => {
+    const match = segment.match(PARSE_PARAM);
+    if (!match)
+      return segment;
+    return {
+      name: match[3],
+      type: match[1] ? 2 : match[2] ? 1 : 0
+      /* single */
+    };
+  });
+}
+function createRoute(routePath, jayHtmlPath, compPath) {
+  return {
+    segments: parseRouteSegments(routePath),
+    rawRoute: routePath,
+    jayHtmlPath,
+    compPath
+  };
+}
 async function scanRoutes(baseDir, options) {
   const BASE_DIR = path.resolve(baseDir);
   const routes = await scanDirectory(BASE_DIR, BASE_DIR, options);
@@ -159,6 +180,8 @@ function routeToExpressRoute(route) {
 }
 export {
   JayRouteParamType,
+  createRoute,
+  parseRouteSegments,
   routeToExpressRoute,
   scanRoutes,
   sortRoutesByPriority

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/stack-route-scanner",
-  "version": "0.15.6",
+  "version": "0.16.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.15.6",
+    "@jay-framework/logger": "^0.16.0",
     "node-html-parser": "^6.1.12",
     "yaml": "^2.3.4"
   },
@@ -25,7 +25,7 @@
     "test:watch": "vitest"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.15.6",
+    "@jay-framework/dev-environment": "^0.16.0",
     "@types/node": "^20.11.5",
     "nodemon": "^3.0.3",
     "replace-in-file": "^7.1.0",