@fluixi/core 1.0.0-alpha.83 → 1.0.0-alpha.84

package/dist/src/lib/plugins/route-scanner.cjs

@@ -1 +1,189 @@
-"use strict";var P=Object.create;var S=Object.defineProperty;var G=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var T=Object.getPrototypeOf,v=Object.prototype.hasOwnProperty;var $=(t,n)=>{for(var s in n)S(t,s,{get:n[s],enumerable:!0})},L=(t,n,s,i)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of O(n))!v.call(t,o)&&o!==s&&S(t,o,{get:()=>n[o],enumerable:!(i=G(n,o))||i.enumerable});return t};var b=(t,n,s)=>(s=t!=null?P(T(t)):{},L(n||!t||!t.__esModule?S(s,"default",{value:t,enumerable:!0}):s,t)),w=t=>L(S({},"__esModule",{value:!0}),t);var z={};$(z,{scanRoutes:()=>V});module.exports=w(z);var g=b(require("fs"),1),u=b(require("path"),1),N=[".tsx",".ts",".jsx",".js"];function V(t,n={}){let s=n.extensions??N,i=u.resolve(t);return g.existsSync(i)?F(i,i,"",s):[]}function F(t,n,s,i){let o=g.readdirSync(t,{withFileTypes:!0}),r=[],W=null,h=[],d=[];for(let e of o)e.isDirectory()?d.push(e):e.isFile()&&X(e.name,i)&&h.push(e);let l,c=[];for(let e of h)j(e.name)==="layout"?l=I(e.name,t,n,s,!0):c.push(e);let y=[];for(let e of c)y.push(I(e.name,t,n,s,!1));let f=[];for(let e of d){let a=e.name,A=_(a),C=A?"":k(a),R=C?E(s,C):s,x=F(u.join(t,a),n,R,i);if(A)f.push(...x);else{let m=x.find(p=>p.isLayout&&p.urlPath===R),D=x.filter(p=>!p.isLayout||p.urlPath!==R);m?(m.children=[...m.children,...D],f.push(m)):D.length>0&&f.push(...D)}}return l?(l.children=[...y,...f],r.push(l)):r.push(...y,...f),q(r)}function I(t,n,s,i,o){let r=j(t),W=u.relative(s,u.join(n,t)),h=r==="index",d=r.startsWith("[..."),l=!d&&r.startsWith("[")&&r.endsWith("]"),c;o?c="":h?c="/":d?c=`*${r.slice(4,-1)}`:l?c=`:${r.slice(1,-1)}`:c=r;let y=o||h?i||"/":E(i,c),f=u.join(n,t),e=!1;try{let a=g.readFileSync(f,"utf-8");e=/export\s+(const|function|async\s+function)\s+routeData\b/.test(a)}catch{}return{filePath:W.replace(/\\/g,"/"),urlSegment:c,urlPath:y,isLayout:o,isIndex:h,isDynamic:l,isCatchAll:d,isGroup:!1,children:[],parentUrlPath:i,hasRouteData:e,rootDir:s,dir:n}}function X(t,n){return n.some(s=>t.endsWith(s))}function j(t){let n=t.lastIndexOf(".");return n>0?t.slice(0,n):t}function _(t){return t.startsWith("(")&&t.endsWith(")")}function k(t){return t.startsWith("[...")&&t.endsWith("]")?"*"+t.slice(4,-1):t.startsWith("[")&&t.endsWith("]")?":"+t.slice(1,-1):t}function E(t,n){return(t.endsWith("/")?t:t+"/")+n}function q(t){return t.sort((n,s)=>n.isLayout&&!s.isLayout?-1:!n.isLayout&&s.isLayout?1:n.isIndex&&!s.isIndex?-1:!n.isIndex&&s.isIndex?1:!n.isDynamic&&!n.isCatchAll&&(s.isDynamic||s.isCatchAll)?-1:(n.isDynamic||n.isCatchAll)&&!s.isDynamic&&!s.isCatchAll?1:n.isDynamic&&s.isCatchAll?-1:n.isCatchAll&&s.isDynamic?1:n.urlSegment.localeCompare(s.urlSegment))}
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/plugins/route-scanner.ts
+var route_scanner_exports = {};
+__export(route_scanner_exports, {
+  scanRoutes: () => scanRoutes
+});
+module.exports = __toCommonJS(route_scanner_exports);
+var fs = __toESM(require("fs"), 1);
+var path = __toESM(require("path"), 1);
+var DEFAULT_EXTENSIONS = [".tsx", ".ts", ".jsx", ".js"];
+function scanRoutes(routesDir, options = {}) {
+  const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+  const absDir = path.resolve(routesDir);
+  if (!fs.existsSync(absDir)) {
+    return [];
+  }
+  return scanDirectory(absDir, absDir, "", extensions);
+}
+function scanDirectory(dir, rootDir, parentUrlPath, extensions) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const routes = [];
+  const layoutRoute = null;
+  const files = [];
+  const dirs = [];
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      dirs.push(entry);
+    } else if (entry.isFile() && hasValidExtension(entry.name, extensions)) {
+      files.push(entry);
+    }
+  }
+  let layout;
+  const nonLayoutFiles = [];
+  for (const file of files) {
+    const baseName = stripExtension(file.name);
+    if (baseName === "layout") {
+      layout = buildFileRoute(file.name, dir, rootDir, parentUrlPath, true);
+    } else {
+      nonLayoutFiles.push(file);
+    }
+  }
+  const fileRoutes = [];
+  for (const file of nonLayoutFiles) {
+    fileRoutes.push(
+      buildFileRoute(file.name, dir, rootDir, parentUrlPath, false)
+    );
+  }
+  const dirRoutes = [];
+  for (const d of dirs) {
+    const dirName = d.name;
+    const isGroup = isRouteGroup(dirName);
+    const segment = isGroup ? "" : dirNameToSegment(dirName);
+    const childUrlPath = segment ? joinUrlPath(parentUrlPath, segment) : parentUrlPath;
+    const children = scanDirectory(
+      path.join(dir, dirName),
+      rootDir,
+      childUrlPath,
+      extensions
+    );
+    if (isGroup) {
+      dirRoutes.push(...children);
+    } else {
+      const childLayout = children.find((c) => c.isLayout && c.urlPath === childUrlPath);
+      const childNonLayout = children.filter((c) => !c.isLayout || c.urlPath !== childUrlPath);
+      if (childLayout) {
+        childLayout.children = [...childLayout.children, ...childNonLayout];
+        dirRoutes.push(childLayout);
+      } else if (childNonLayout.length > 0) {
+        dirRoutes.push(...childNonLayout);
+      }
+    }
+  }
+  if (layout) {
+    layout.children = [...fileRoutes, ...dirRoutes];
+    routes.push(layout);
+  } else {
+    routes.push(...fileRoutes, ...dirRoutes);
+  }
+  return sortRoutes(routes);
+}
+function buildFileRoute(fileName, dir, rootDir, parentUrlPath, isLayout) {
+  const baseName = stripExtension(fileName);
+  const filePath = path.relative(rootDir, path.join(dir, fileName));
+  const isIndex = baseName === "index";
+  const isCatchAll = baseName.startsWith("[...");
+  const isDynamic = !isCatchAll && baseName.startsWith("[") && baseName.endsWith("]");
+  let urlSegment;
+  if (isLayout) {
+    urlSegment = "";
+  } else if (isIndex) {
+    urlSegment = "/";
+  } else if (isCatchAll) {
+    const paramName = baseName.slice(4, -1);
+    urlSegment = `*${paramName}`;
+  } else if (isDynamic) {
+    const paramName = baseName.slice(1, -1);
+    urlSegment = `:${paramName}`;
+  } else {
+    urlSegment = baseName;
+  }
+  const urlPath = isLayout ? parentUrlPath || "/" : isIndex ? parentUrlPath || "/" : joinUrlPath(parentUrlPath, urlSegment);
+  const absoluteFilePath = path.join(dir, fileName);
+  let hasRouteData = false;
+  try {
+    const content = fs.readFileSync(absoluteFilePath, "utf-8");
+    hasRouteData = /export\s+(const|function|async\s+function)\s+routeData\b/.test(content);
+  } catch {
+  }
+  return {
+    filePath: filePath.replace(/\\/g, "/"),
+    // normalize to forward slashes
+    urlSegment,
+    urlPath,
+    isLayout,
+    isIndex,
+    isDynamic,
+    isCatchAll,
+    isGroup: false,
+    children: [],
+    parentUrlPath,
+    hasRouteData,
+    rootDir,
+    dir
+  };
+}
+function hasValidExtension(fileName, extensions) {
+  return extensions.some((ext) => fileName.endsWith(ext));
+}
+function stripExtension(fileName) {
+  const lastDot = fileName.lastIndexOf(".");
+  return lastDot > 0 ? fileName.slice(0, lastDot) : fileName;
+}
+function isRouteGroup(dirName) {
+  return dirName.startsWith("(") && dirName.endsWith(")");
+}
+function dirNameToSegment(dirName) {
+  if (dirName.startsWith("[...") && dirName.endsWith("]")) {
+    return "*" + dirName.slice(4, -1);
+  }
+  if (dirName.startsWith("[") && dirName.endsWith("]")) {
+    return ":" + dirName.slice(1, -1);
+  }
+  return dirName;
+}
+function joinUrlPath(parent, segment) {
+  const base = parent.endsWith("/") ? parent : parent + "/";
+  return base + segment;
+}
+function sortRoutes(routes) {
+  return routes.sort((a, b) => {
+    if (a.isLayout && !b.isLayout) return -1;
+    if (!a.isLayout && b.isLayout) return 1;
+    if (a.isIndex && !b.isIndex) return -1;
+    if (!a.isIndex && b.isIndex) return 1;
+    if (!a.isDynamic && !a.isCatchAll && (b.isDynamic || b.isCatchAll)) return -1;
+    if ((a.isDynamic || a.isCatchAll) && !b.isDynamic && !b.isCatchAll) return 1;
+    if (a.isDynamic && b.isCatchAll) return -1;
+    if (a.isCatchAll && b.isDynamic) return 1;
+    return a.urlSegment.localeCompare(b.urlSegment);
+  });
+}

package/dist/src/lib/plugins/route-scanner.d.ts

@@ -1,9 +1,8 @@
 /**
- * @fileoverview File-system route scanner
  * @module @fluixi/core/plugins/route-scanner
  *
  * Scans a routes directory and builds a route tree following SolidStart conventions.
- * Pure utility — no bundler dependency.
+ * Pure utility, no bundler dependency.
  */
 export interface ScannedRoute {
     /** Relative file path from routes dir: 'users/[id].tsx' */

package/dist/src/lib/plugins/route-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-scanner.d.ts","sourceRoot":"","sources":["../../../../src/lib/plugins/route-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAQD;;GAEG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,WAAgB,GACxB,YAAY,EAAE,CAShB"}
+{"version":3,"file":"route-scanner.d.ts","sourceRoot":"","sources":["../../../../src/lib/plugins/route-scanner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAQD;;GAEG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,WAAgB,GACxB,YAAY,EAAE,CAShB"}

package/dist/src/lib/plugins/route-scanner.js

@@ -1,9 +1,8 @@
 /**
- * @fileoverview File-system route scanner
  * @module @fluixi/core/plugins/route-scanner
  *
  * Scans a routes directory and builds a route tree following SolidStart conventions.
- * Pure utility — no bundler dependency.
+ * Pure utility, no bundler dependency.
  */
 import * as fs from 'fs';
 import * as path from 'path';
@@ -71,7 +70,7 @@ function scanDirectory(dir, rootDir, parentUrlPath, extensions) {
         else {
             // Regular directory: becomes a nested route
             // If there's a DIRECT layout in the children (urlPath matches this dir's path),
-            // it becomes the parent route. We must NOT pick up layouts from deeper descendants
+            // it becomes the parent route. We must not pick up layouts from deeper descendants
             // (e.g. campaigns/[id]/workspace/layout.tsx must not be the layout for campaigns/).
             const childLayout = children.find((c) => c.isLayout && c.urlPath === childUrlPath);
             const childNonLayout = children.filter((c) => !c.isLayout || c.urlPath !== childUrlPath);
@@ -81,7 +80,7 @@ function scanDirectory(dir, rootDir, parentUrlPath, extensions) {
                 dirRoutes.push(childLayout);
             }
             else if (childNonLayout.length > 0) {
-                // No layout — just add children with their full paths
+                // No layout, just add children with their full paths
                 dirRoutes.push(...childNonLayout);
             }
         }
@@ -114,12 +113,12 @@ function buildFileRoute(fileName, dir, rootDir, parentUrlPath, isLayout) {
         urlSegment = '/';
     }
     else if (isCatchAll) {
-        // [...rest] → *rest
+        // [...rest] -> *rest
         const paramName = baseName.slice(4, -1); // remove '[...' and ']'
         urlSegment = `*${paramName}`;
     }
     else if (isDynamic) {
-        // [id] → :id
+        // [id] -> :id
         const paramName = baseName.slice(1, -1); // remove '[' and ']'
         urlSegment = `:${paramName}`;
     }
@@ -173,10 +172,10 @@ function isRouteGroup(dirName) {
 /** Convert a directory name to its URL segment, matching the same rules as file names. */
 function dirNameToSegment(dirName) {
     if (dirName.startsWith('[...') && dirName.endsWith(']')) {
-        return '*' + dirName.slice(4, -1); // [...rest] → *rest
+        return '*' + dirName.slice(4, -1); // [...rest] -> *rest
     }
     if (dirName.startsWith('[') && dirName.endsWith(']')) {
-        return ':' + dirName.slice(1, -1); // [id] → :id
+        return ':' + dirName.slice(1, -1); // [id] -> :id
     }
     return dirName;
 }

package/dist/src/lib/plugins/route-scanner.mjs

@@ -1 +1,158 @@
-import*as d from"fs";import*as a from"path";var F=[".tsx",".ts",".jsx",".js"];function O(t,n={}){let s=n.extensions??F,i=a.resolve(t);return d.existsSync(i)?L(i,i,"",s):[]}function L(t,n,s,i){let g=d.readdirSync(t,{withFileTypes:!0}),o=[],D=null,f=[],h=[];for(let e of g)e.isDirectory()?h.push(e):e.isFile()&&j(e.name,i)&&f.push(e);let u,r=[];for(let e of f)b(e.name)==="layout"?u=C(e.name,t,n,s,!0):r.push(e);let y=[];for(let e of r)y.push(C(e.name,t,n,s,!1));let l=[];for(let e of h){let c=e.name,W=E(c),A=W?"":P(c),S=A?I(s,A):s,R=L(a.join(t,c),n,S,i);if(W)l.push(...R);else{let m=R.find(p=>p.isLayout&&p.urlPath===S),x=R.filter(p=>!p.isLayout||p.urlPath!==S);m?(m.children=[...m.children,...x],l.push(m)):x.length>0&&l.push(...x)}}return u?(u.children=[...y,...l],o.push(u)):o.push(...y,...l),G(o)}function C(t,n,s,i,g){let o=b(t),D=a.relative(s,a.join(n,t)),f=o==="index",h=o.startsWith("[..."),u=!h&&o.startsWith("[")&&o.endsWith("]"),r;g?r="":f?r="/":h?r=`*${o.slice(4,-1)}`:u?r=`:${o.slice(1,-1)}`:r=o;let y=g||f?i||"/":I(i,r),l=a.join(n,t),e=!1;try{let c=d.readFileSync(l,"utf-8");e=/export\s+(const|function|async\s+function)\s+routeData\b/.test(c)}catch{}return{filePath:D.replace(/\\/g,"/"),urlSegment:r,urlPath:y,isLayout:g,isIndex:f,isDynamic:u,isCatchAll:h,isGroup:!1,children:[],parentUrlPath:i,hasRouteData:e,rootDir:s,dir:n}}function j(t,n){return n.some(s=>t.endsWith(s))}function b(t){let n=t.lastIndexOf(".");return n>0?t.slice(0,n):t}function E(t){return t.startsWith("(")&&t.endsWith(")")}function P(t){return t.startsWith("[...")&&t.endsWith("]")?"*"+t.slice(4,-1):t.startsWith("[")&&t.endsWith("]")?":"+t.slice(1,-1):t}function I(t,n){return(t.endsWith("/")?t:t+"/")+n}function G(t){return t.sort((n,s)=>n.isLayout&&!s.isLayout?-1:!n.isLayout&&s.isLayout?1:n.isIndex&&!s.isIndex?-1:!n.isIndex&&s.isIndex?1:!n.isDynamic&&!n.isCatchAll&&(s.isDynamic||s.isCatchAll)?-1:(n.isDynamic||n.isCatchAll)&&!s.isDynamic&&!s.isCatchAll?1:n.isDynamic&&s.isCatchAll?-1:n.isCatchAll&&s.isDynamic?1:n.urlSegment.localeCompare(s.urlSegment))}export{O as scanRoutes};
+// src/lib/plugins/route-scanner.ts
+import * as fs from "fs";
+import * as path from "path";
+var DEFAULT_EXTENSIONS = [".tsx", ".ts", ".jsx", ".js"];
+function scanRoutes(routesDir, options = {}) {
+  const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+  const absDir = path.resolve(routesDir);
+  if (!fs.existsSync(absDir)) {
+    return [];
+  }
+  return scanDirectory(absDir, absDir, "", extensions);
+}
+function scanDirectory(dir, rootDir, parentUrlPath, extensions) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const routes = [];
+  const layoutRoute = null;
+  const files = [];
+  const dirs = [];
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      dirs.push(entry);
+    } else if (entry.isFile() && hasValidExtension(entry.name, extensions)) {
+      files.push(entry);
+    }
+  }
+  let layout;
+  const nonLayoutFiles = [];
+  for (const file of files) {
+    const baseName = stripExtension(file.name);
+    if (baseName === "layout") {
+      layout = buildFileRoute(file.name, dir, rootDir, parentUrlPath, true);
+    } else {
+      nonLayoutFiles.push(file);
+    }
+  }
+  const fileRoutes = [];
+  for (const file of nonLayoutFiles) {
+    fileRoutes.push(
+      buildFileRoute(file.name, dir, rootDir, parentUrlPath, false)
+    );
+  }
+  const dirRoutes = [];
+  for (const d of dirs) {
+    const dirName = d.name;
+    const isGroup = isRouteGroup(dirName);
+    const segment = isGroup ? "" : dirNameToSegment(dirName);
+    const childUrlPath = segment ? joinUrlPath(parentUrlPath, segment) : parentUrlPath;
+    const children = scanDirectory(
+      path.join(dir, dirName),
+      rootDir,
+      childUrlPath,
+      extensions
+    );
+    if (isGroup) {
+      dirRoutes.push(...children);
+    } else {
+      const childLayout = children.find((c) => c.isLayout && c.urlPath === childUrlPath);
+      const childNonLayout = children.filter((c) => !c.isLayout || c.urlPath !== childUrlPath);
+      if (childLayout) {
+        childLayout.children = [...childLayout.children, ...childNonLayout];
+        dirRoutes.push(childLayout);
+      } else if (childNonLayout.length > 0) {
+        dirRoutes.push(...childNonLayout);
+      }
+    }
+  }
+  if (layout) {
+    layout.children = [...fileRoutes, ...dirRoutes];
+    routes.push(layout);
+  } else {
+    routes.push(...fileRoutes, ...dirRoutes);
+  }
+  return sortRoutes(routes);
+}
+function buildFileRoute(fileName, dir, rootDir, parentUrlPath, isLayout) {
+  const baseName = stripExtension(fileName);
+  const filePath = path.relative(rootDir, path.join(dir, fileName));
+  const isIndex = baseName === "index";
+  const isCatchAll = baseName.startsWith("[...");
+  const isDynamic = !isCatchAll && baseName.startsWith("[") && baseName.endsWith("]");
+  let urlSegment;
+  if (isLayout) {
+    urlSegment = "";
+  } else if (isIndex) {
+    urlSegment = "/";
+  } else if (isCatchAll) {
+    const paramName = baseName.slice(4, -1);
+    urlSegment = `*${paramName}`;
+  } else if (isDynamic) {
+    const paramName = baseName.slice(1, -1);
+    urlSegment = `:${paramName}`;
+  } else {
+    urlSegment = baseName;
+  }
+  const urlPath = isLayout ? parentUrlPath || "/" : isIndex ? parentUrlPath || "/" : joinUrlPath(parentUrlPath, urlSegment);
+  const absoluteFilePath = path.join(dir, fileName);
+  let hasRouteData = false;
+  try {
+    const content = fs.readFileSync(absoluteFilePath, "utf-8");
+    hasRouteData = /export\s+(const|function|async\s+function)\s+routeData\b/.test(content);
+  } catch {
+  }
+  return {
+    filePath: filePath.replace(/\\/g, "/"),
+    // normalize to forward slashes
+    urlSegment,
+    urlPath,
+    isLayout,
+    isIndex,
+    isDynamic,
+    isCatchAll,
+    isGroup: false,
+    children: [],
+    parentUrlPath,
+    hasRouteData,
+    rootDir,
+    dir
+  };
+}
+function hasValidExtension(fileName, extensions) {
+  return extensions.some((ext) => fileName.endsWith(ext));
+}
+function stripExtension(fileName) {
+  const lastDot = fileName.lastIndexOf(".");
+  return lastDot > 0 ? fileName.slice(0, lastDot) : fileName;
+}
+function isRouteGroup(dirName) {
+  return dirName.startsWith("(") && dirName.endsWith(")");
+}
+function dirNameToSegment(dirName) {
+  if (dirName.startsWith("[...") && dirName.endsWith("]")) {
+    return "*" + dirName.slice(4, -1);
+  }
+  if (dirName.startsWith("[") && dirName.endsWith("]")) {
+    return ":" + dirName.slice(1, -1);
+  }
+  return dirName;
+}
+function joinUrlPath(parent, segment) {
+  const base = parent.endsWith("/") ? parent : parent + "/";
+  return base + segment;
+}
+function sortRoutes(routes) {
+  return routes.sort((a, b) => {
+    if (a.isLayout && !b.isLayout) return -1;
+    if (!a.isLayout && b.isLayout) return 1;
+    if (a.isIndex && !b.isIndex) return -1;
+    if (!a.isIndex && b.isIndex) return 1;
+    if (!a.isDynamic && !a.isCatchAll && (b.isDynamic || b.isCatchAll)) return -1;
+    if ((a.isDynamic || a.isCatchAll) && !b.isDynamic && !b.isCatchAll) return 1;
+    if (a.isDynamic && b.isCatchAll) return -1;
+    if (a.isCatchAll && b.isDynamic) return 1;
+    return a.urlSegment.localeCompare(b.urlSegment);
+  });
+}
+export {
+  scanRoutes
+};

package/dist/src/lib/plugins/vite.cjs

@@ -1 +1,27 @@
-"use strict";var p=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var n=(e,i)=>{for(var l in i)p(e,l,{get:i[l],enumerable:!0})},g=(e,i,l,r)=>{if(i&&typeof i=="object"||typeof i=="function")for(let t of x(i))!f.call(e,t)&&t!==l&&p(e,t,{get:()=>i[t],enumerable:!(r=u(i,t))||r.enumerable});return e};var m=e=>g(p({},"__esModule",{value:!0}),e);var V={};n(V,{createVitePlugin:()=>o.createVitePlugin,fluixi:()=>o.fluixi});module.exports=m(V);var o=require("@fluixi/vite-plugin");
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/plugins/vite.ts
+var vite_exports = {};
+__export(vite_exports, {
+  createVitePlugin: () => import_vite_plugin.createVitePlugin,
+  fluixi: () => import_vite_plugin.fluixi
+});
+module.exports = __toCommonJS(vite_exports);
+var import_vite_plugin = require("@fluixi/vite-plugin");

package/dist/src/lib/plugins/vite.mjs

@@ -1 +1,6 @@
-import{fluixi as t,createVitePlugin as l}from"@fluixi/vite-plugin";export{l as createVitePlugin,t as fluixi};
+// src/lib/plugins/vite.ts
+import { fluixi, createVitePlugin } from "@fluixi/vite-plugin";
+export {
+  createVitePlugin,
+  fluixi
+};

package/dist/src/lib/render/await.cjs

@@ -1 +1,38 @@
-"use strict";var a=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var T=(n,e)=>{for(var t in e)a(n,t,{get:e[t],enumerable:!0})},l=(n,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of c(e))!s.call(n,r)&&r!==t&&a(n,r,{get:()=>e[r],enumerable:!(o=u(e,r))||o.enumerable});return n};var f=n=>l(a({},"__esModule",{value:!0}),n);var P={};T(P,{Await:()=>w});module.exports=f(P);var i=require("@fluixi/reactive/signal");function w(n){let e=()=>{let o=n.value;return typeof o=="function"?o():o},[t]=(0,i.createResource)(e);return()=>{if(t.loading)return n.fallback;let o=n.children;return typeof o=="function"?o(t()):o}}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/render/await.ts
+var await_exports = {};
+__export(await_exports, {
+  Await: () => Await
+});
+module.exports = __toCommonJS(await_exports);
+var import_signal = require("@fluixi/reactive/signal");
+function Await(props) {
+  const fetcher = () => {
+    const v = props.value;
+    return typeof v === "function" ? v() : v;
+  };
+  const [data] = (0, import_signal.createResource)(fetcher);
+  return () => {
+    if (data.loading) return props.fallback;
+    const child = props.children;
+    return typeof child === "function" ? child(data()) : child;
+  };
+}

package/dist/src/lib/render/await.d.ts

@@ -4,5 +4,23 @@ export interface AwaitProps<T> {
     /** Render prop called with the resolved value (or plain children). */
     children?: ((value: T) => unknown) | unknown;
 }
+/**
+ * Render the result of a promise, with a fallback while it is pending.
+ *
+ * `value` may be a promise or a function returning one. Pass a function when the promise
+ * should be created by the component rather than by whoever wrote the tag, which is what
+ * keeps a re-render from firing the request again.
+ *
+ * `children` is either a render prop called with the resolved value, or plain children
+ * that ignore it.
+ *
+ * @example
+ * ```ts
+ * html`
+ *   <${Await} value=${() => fetchUser(id)} fallback=${html`<p>loading...</p>`}>
+ *     ${(user) => html`<h1>${user.name}</h1>`}
+ *   </${Await}>`;
+ * ```
+ */
 export declare function Await<T>(props: AwaitProps<T>): () => unknown;
 //# sourceMappingURL=await.d.ts.map

package/dist/src/lib/render/await.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"await.d.ts","sourceRoot":"","sources":["../../../../src/lib/render/await.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,OAAO,CAAC;CAC9C;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,CAW5D"}
+{"version":3,"file":"await.d.ts","sourceRoot":"","sources":["../../../../src/lib/render/await.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,OAAO,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,CAW5D"}

package/dist/src/lib/render/await.js

@@ -1,9 +1,9 @@
 /**
- * `<Await value=${promise}>` — resolve a promise and render its value.
+ * `<Await value=${promise}>`: resolve a promise and render its value.
  *
  * A thin, Suspense-free helper for the common "await one promise" case:
  *
- *   <Await value=${fetchUser(id)} fallback=${html`<p>loading…</p>`}>
+ *   <Await value=${fetchUser(id)} fallback=${html`<p>loading...</p>`}>
  *     ${(user) => html`<span>${user.name}</span>`}
  *   </Await>
  *
@@ -12,6 +12,24 @@
  * resource read is guarded by `.loading`, so it never throws/suspends.
  */
 import { createResource } from '@fluixi/reactive/signal';
+/**
+ * Render the result of a promise, with a fallback while it is pending.
+ *
+ * `value` may be a promise or a function returning one. Pass a function when the promise
+ * should be created by the component rather than by whoever wrote the tag, which is what
+ * keeps a re-render from firing the request again.
+ *
+ * `children` is either a render prop called with the resolved value, or plain children
+ * that ignore it.
+ *
+ * @example
+ * ```ts
+ * html`
+ *   <${Await} value=${() => fetchUser(id)} fallback=${html`<p>loading...</p>`}>
+ *     ${(user) => html`<h1>${user.name}</h1>`}
+ *   </${Await}>`;
+ * ```
+ */
 export function Await(props) {
     const fetcher = () => {
         const v = props.value;

package/dist/src/lib/render/await.mjs

@@ -1 +1,17 @@
-import{createResource as r}from"@fluixi/reactive/signal";function i(e){let t=()=>{let n=e.value;return typeof n=="function"?n():n},[o]=r(t);return()=>{if(o.loading)return e.fallback;let n=e.children;return typeof n=="function"?n(o()):n}}export{i as Await};
+// src/lib/render/await.ts
+import { createResource } from "@fluixi/reactive/signal";
+function Await(props) {
+  const fetcher = () => {
+    const v = props.value;
+    return typeof v === "function" ? v() : v;
+  };
+  const [data] = createResource(fetcher);
+  return () => {
+    if (data.loading) return props.fallback;
+    const child = props.children;
+    return typeof child === "function" ? child(data()) : child;
+  };
+}
+export {
+  Await
+};