stx-router 0.2.48 → 0.2.53

package/dist/middleware.js

@@ -0,0 +1,290 @@
+// @bun
+// src/middleware.ts
+import fs from "fs";
+import path from "path";
+function navigateTo(navPath, options = {}) {
+  return {
+    type: "redirect",
+    path: navPath,
+    options: {
+      replace: options.replace ?? false,
+      external: options.external ?? false,
+      redirectCode: options.redirectCode ?? 302
+    }
+  };
+}
+function abortNavigation(error) {
+  const normalizedError = typeof error === "string" ? { statusCode: 500, message: error } : error;
+  return {
+    type: "abort",
+    error: normalizedError
+  };
+}
+function defineMiddleware(handler, options = {}) {
+  return {
+    handler,
+    mode: options.mode ?? "universal"
+  };
+}
+function parseCookies(cookieHeader) {
+  const cookies = {};
+  if (!cookieHeader)
+    return cookies;
+  const pairs = cookieHeader.split(";");
+  for (const pair of pairs) {
+    const [name, ...rest] = pair.split("=");
+    if (name) {
+      const key = name.trim();
+      const value = rest.join("=").trim();
+      if (key) {
+        cookies[key] = decodeURIComponent(value);
+      }
+    }
+  }
+  return cookies;
+}
+function serializeCookie(name, value, options = {}) {
+  let cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`;
+  if (options.expires) {
+    const expires = typeof options.expires === "number" ? new Date(Date.now() + options.expires * 1000) : options.expires;
+    cookie += `; Expires=${expires.toUTCString()}`;
+  }
+  if (options.path)
+    cookie += `; Path=${options.path}`;
+  if (options.domain)
+    cookie += `; Domain=${options.domain}`;
+  if (options.secure)
+    cookie += "; Secure";
+  if (options.httpOnly)
+    cookie += "; HttpOnly";
+  if (options.sameSite)
+    cookie += `; SameSite=${options.sameSite}`;
+  return cookie;
+}
+function createServerCookieManager(request, responseHeaders) {
+  const cookieHeader = request.headers.get("cookie") || "";
+  const cookies = parseCookies(cookieHeader);
+  return {
+    get(name) {
+      return cookies[name];
+    },
+    set(name, value, options = {}) {
+      cookies[name] = value;
+      responseHeaders.append("Set-Cookie", serializeCookie(name, value, options));
+    },
+    delete(name) {
+      delete cookies[name];
+      responseHeaders.append("Set-Cookie", serializeCookie(name, "", { expires: new Date(0), path: "/" }));
+    },
+    getAll() {
+      return { ...cookies };
+    }
+  };
+}
+function createClientCookieManager() {
+  return {
+    get(name) {
+      if (typeof document === "undefined")
+        return;
+      const cookies = parseCookies(document.cookie);
+      return cookies[name];
+    },
+    set(name, value, options = {}) {
+      if (typeof document === "undefined")
+        return;
+      document.cookie = serializeCookie(name, value, options);
+    },
+    delete(name) {
+      if (typeof document === "undefined")
+        return;
+      document.cookie = serializeCookie(name, "", { expires: new Date(0), path: "/" });
+    },
+    getAll() {
+      if (typeof document === "undefined")
+        return {};
+      return parseCookies(document.cookie);
+    }
+  };
+}
+function createStorageManager() {
+  const available = typeof window !== "undefined" && typeof window.localStorage !== "undefined";
+  return {
+    get(key) {
+      if (!available)
+        return null;
+      try {
+        return window.localStorage.getItem(key);
+      } catch {
+        return null;
+      }
+    },
+    set(key, value) {
+      if (!available)
+        return;
+      try {
+        window.localStorage.setItem(key, value);
+      } catch {}
+    },
+    remove(key) {
+      if (!available)
+        return;
+      try {
+        window.localStorage.removeItem(key);
+      } catch {}
+    },
+    isAvailable() {
+      return available;
+    }
+  };
+}
+var middlewareRegistry = new Map;
+function registerMiddleware(name, middleware) {
+  middlewareRegistry.set(name, middleware);
+}
+function getMiddleware(name) {
+  return middlewareRegistry.get(name);
+}
+function hasMiddleware(name) {
+  return middlewareRegistry.has(name);
+}
+function clearMiddleware() {
+  middlewareRegistry.clear();
+}
+function getMiddlewareNames() {
+  return Array.from(middlewareRegistry.keys());
+}
+async function loadMiddlewareFromDirectory(baseDir, middlewareDir = "middleware") {
+  const fullPath = path.resolve(baseDir, middlewareDir);
+  if (!fs.existsSync(fullPath)) {
+    return;
+  }
+  const files = fs.readdirSync(fullPath);
+  for (const file of files) {
+    if (!file.endsWith(".ts") && !file.endsWith(".js"))
+      continue;
+    if (file.includes(".test.") || file.includes(".spec."))
+      continue;
+    const name = file.replace(/\.(ts|js)$/, "");
+    const filePath = path.join(fullPath, file);
+    try {
+      const mod = await import(filePath);
+      const mw = mod.default;
+      if (mw && typeof mw.handler === "function") {
+        registerMiddleware(name, mw);
+      } else if (typeof mw === "function") {
+        registerMiddleware(name, { handler: mw, mode: "universal" });
+      }
+    } catch (error) {
+      console.warn(`Failed to load middleware '${name}' from ${filePath}:`, error);
+    }
+  }
+}
+function parseQuery(search) {
+  const query = {};
+  if (!search)
+    return query;
+  const params = new URLSearchParams(search);
+  for (const [key, value] of params) {
+    query[key] = value;
+  }
+  return query;
+}
+function createRouteLocation(pathname, params, meta, search = "") {
+  return {
+    path: pathname,
+    params,
+    query: parseQuery(search),
+    fullPath: search ? `${pathname}?${search}` : pathname,
+    meta
+  };
+}
+function createMiddlewareContext(to, from, request) {
+  const isServer = typeof window === "undefined";
+  const isClient = !isServer;
+  const responseHeaders = new Headers;
+  return {
+    to,
+    from,
+    isClient,
+    isServer,
+    cookies: isServer && request ? createServerCookieManager(request, responseHeaders) : createClientCookieManager(),
+    storage: createStorageManager(),
+    state: {},
+    request,
+    responseHeaders
+  };
+}
+async function runMiddleware(middlewareNames, context) {
+  const names = Array.isArray(middlewareNames) ? middlewareNames : [middlewareNames];
+  const isServer = context.isServer;
+  for (const name of names) {
+    const middleware = getMiddleware(name);
+    if (!middleware) {
+      console.warn(`Middleware '${name}' not found`);
+      continue;
+    }
+    if (middleware.mode === "server" && !isServer)
+      continue;
+    if (middleware.mode === "client" && isServer)
+      continue;
+    try {
+      const result = await middleware.handler(context);
+      if (result) {
+        if (result.type === "redirect") {
+          return {
+            passed: false,
+            redirect: result,
+            state: context.state,
+            responseHeaders: context.responseHeaders
+          };
+        }
+        if (result.type === "abort") {
+          return {
+            passed: false,
+            abort: result,
+            state: context.state,
+            responseHeaders: context.responseHeaders
+          };
+        }
+      }
+    } catch (error) {
+      console.error(`Error in middleware '${name}':`, error);
+      return {
+        passed: false,
+        abort: {
+          type: "abort",
+          error: {
+            statusCode: 500,
+            message: error instanceof Error ? error.message : "Middleware error"
+          }
+        },
+        state: context.state,
+        responseHeaders: context.responseHeaders
+      };
+    }
+  }
+  return {
+    passed: true,
+    state: context.state,
+    responseHeaders: context.responseHeaders
+  };
+}
+export {
+  runMiddleware,
+  registerMiddleware,
+  navigateTo,
+  loadMiddlewareFromDirectory,
+  hasMiddleware,
+  getMiddlewareNames,
+  getMiddleware,
+  defineMiddleware,
+  createStorageManager,
+  createServerCookieManager,
+  createRouteLocation,
+  createMiddlewareContext,
+  createClientCookieManager,
+  clearMiddleware,
+  abortNavigation
+};
+
+//# debugId=2F078381FE718BF864756E2164756E21

package/dist/middleware.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/middleware.ts"],
+  "sourcesContent": [
+    "import fs from 'node:fs'\nimport path from 'node:path'\nimport type {\n  AbortNavigationResult,\n  CookieManager,\n  CookieOptions,\n  MiddlewareContext,\n  MiddlewareMode,\n  MiddlewareOptions,\n  MiddlewareResult,\n  NavigateToOptions,\n  NavigateToResult,\n  NavigationError,\n  NavigationResult,\n  RouteLocation,\n  RouteMiddlewareDefinition,\n  RouteMiddlewareHandler,\n  StorageManager,\n} from './types'\n\n// =============================================================================\n// Navigation Helpers\n// =============================================================================\n\nexport function navigateTo(navPath: string, options: NavigateToOptions = {}): NavigateToResult {\n  return {\n    type: 'redirect',\n    path: navPath,\n    options: {\n      replace: options.replace ?? false,\n      external: options.external ?? false,\n      redirectCode: options.redirectCode ?? 302,\n    },\n  }\n}\n\nexport function abortNavigation(error: string | NavigationError): AbortNavigationResult {\n  const normalizedError: NavigationError\n    = typeof error === 'string' ? { statusCode: 500, message: error } : error\n\n  return {\n    type: 'abort',\n    error: normalizedError,\n  }\n}\n\n// =============================================================================\n// Middleware Definition\n// =============================================================================\n\nexport function defineMiddleware(\n  handler: RouteMiddlewareHandler,\n  options: MiddlewareOptions = {},\n): RouteMiddlewareDefinition {\n  return {\n    handler,\n    mode: options.mode ?? 'universal',\n  }\n}\n\n// =============================================================================\n// Cookie Manager\n// =============================================================================\n\nfunction parseCookies(cookieHeader: string): Record<string, string> {\n  const cookies: Record<string, string> = {}\n  if (!cookieHeader) return cookies\n\n  const pairs = cookieHeader.split(';')\n  for (const pair of pairs) {\n    const [name, ...rest] = pair.split('=')\n    if (name) {\n      const key = name.trim()\n      const value = rest.join('=').trim()\n      if (key) {\n        cookies[key] = decodeURIComponent(value)\n      }\n    }\n  }\n  return cookies\n}\n\nfunction serializeCookie(name: string, value: string, options: CookieOptions = {}): string {\n  let cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`\n\n  if (options.expires) {\n    const expires\n      = typeof options.expires === 'number'\n        ? new Date(Date.now() + options.expires * 1000)\n        : options.expires\n    cookie += `; Expires=${expires.toUTCString()}`\n  }\n\n  if (options.path) cookie += `; Path=${options.path}`\n  if (options.domain) cookie += `; Domain=${options.domain}`\n  if (options.secure) cookie += '; Secure'\n  if (options.httpOnly) cookie += '; HttpOnly'\n  if (options.sameSite) cookie += `; SameSite=${options.sameSite}`\n\n  return cookie\n}\n\nexport function createServerCookieManager(\n  request: Request,\n  responseHeaders: Headers,\n): CookieManager {\n  const cookieHeader = request.headers.get('cookie') || ''\n  const cookies = parseCookies(cookieHeader)\n\n  return {\n    get(name: string): string | undefined {\n      return cookies[name]\n    },\n    set(name: string, value: string, options: CookieOptions = {}): void {\n      cookies[name] = value\n      responseHeaders.append('Set-Cookie', serializeCookie(name, value, options))\n    },\n    delete(name: string): void {\n      delete cookies[name]\n      responseHeaders.append(\n        'Set-Cookie',\n        serializeCookie(name, '', { expires: new Date(0), path: '/' }),\n      )\n    },\n    getAll(): Record<string, string> {\n      return { ...cookies }\n    },\n  }\n}\n\nexport function createClientCookieManager(): CookieManager {\n  return {\n    get(name: string): string | undefined {\n      if (typeof document === 'undefined') return undefined\n      const cookies = parseCookies(document.cookie)\n      return cookies[name]\n    },\n    set(name: string, value: string, options: CookieOptions = {}): void {\n      if (typeof document === 'undefined') return\n      document.cookie = serializeCookie(name, value, options)\n    },\n    delete(name: string): void {\n      if (typeof document === 'undefined') return\n      document.cookie = serializeCookie(name, '', { expires: new Date(0), path: '/' })\n    },\n    getAll(): Record<string, string> {\n      if (typeof document === 'undefined') return {}\n      return parseCookies(document.cookie)\n    },\n  }\n}\n\n// =============================================================================\n// Storage Manager\n// =============================================================================\n\nexport function createStorageManager(): StorageManager {\n  const available\n    = typeof window !== 'undefined' && typeof window.localStorage !== 'undefined'\n\n  return {\n    get(key: string): string | null {\n      if (!available) return null\n      try { return window.localStorage.getItem(key) }\n      catch { return null }\n    },\n    set(key: string, value: string): void {\n      if (!available) return\n      try { window.localStorage.setItem(key, value) }\n      catch { /* storage full or blocked */ }\n    },\n    remove(key: string): void {\n      if (!available) return\n      try { window.localStorage.removeItem(key) }\n      catch { /* ignore */ }\n    },\n    isAvailable(): boolean {\n      return available\n    },\n  }\n}\n\n// =============================================================================\n// Middleware Registry\n// =============================================================================\n\nconst middlewareRegistry = new Map<string, RouteMiddlewareDefinition>()\n\nexport function registerMiddleware(name: string, middleware: RouteMiddlewareDefinition): void {\n  middlewareRegistry.set(name, middleware)\n}\n\nexport function getMiddleware(name: string): RouteMiddlewareDefinition | undefined {\n  return middlewareRegistry.get(name)\n}\n\nexport function hasMiddleware(name: string): boolean {\n  return middlewareRegistry.has(name)\n}\n\nexport function clearMiddleware(): void {\n  middlewareRegistry.clear()\n}\n\nexport function getMiddlewareNames(): string[] {\n  return Array.from(middlewareRegistry.keys())\n}\n\n// =============================================================================\n// Middleware Loading\n// =============================================================================\n\nexport async function loadMiddlewareFromDirectory(\n  baseDir: string,\n  middlewareDir: string = 'middleware',\n): Promise<void> {\n  const fullPath = path.resolve(baseDir, middlewareDir)\n\n  if (!fs.existsSync(fullPath)) {\n    return\n  }\n\n  const files = fs.readdirSync(fullPath)\n\n  for (const file of files) {\n    if (!file.endsWith('.ts') && !file.endsWith('.js')) continue\n    if (file.includes('.test.') || file.includes('.spec.')) continue\n\n    const name = file.replace(/\\.(ts|js)$/, '')\n    const filePath = path.join(fullPath, file)\n\n    try {\n      const mod = await import(filePath)\n      const mw = mod.default\n\n      if (mw && typeof mw.handler === 'function') {\n        registerMiddleware(name, mw)\n      }\n      else if (typeof mw === 'function') {\n        registerMiddleware(name, { handler: mw, mode: 'universal' })\n      }\n    }\n    catch (error) {\n      console.warn(`Failed to load middleware '${name}' from ${filePath}:`, error)\n    }\n  }\n}\n\n// =============================================================================\n// Middleware Context & Execution\n// =============================================================================\n\nfunction parseQuery(search: string): Record<string, string> {\n  const query: Record<string, string> = {}\n  if (!search) return query\n\n  const params = new URLSearchParams(search)\n  for (const [key, value] of params) {\n    query[key] = value\n  }\n  return query\n}\n\nexport function createRouteLocation(\n  pathname: string,\n  params: Record<string, string>,\n  meta: Record<string, unknown>,\n  search: string = '',\n): RouteLocation {\n  return {\n    path: pathname,\n    params,\n    query: parseQuery(search),\n    fullPath: search ? `${pathname}?${search}` : pathname,\n    meta,\n  }\n}\n\nexport function createMiddlewareContext(\n  to: RouteLocation,\n  from: RouteLocation | null,\n  request?: Request,\n): MiddlewareContext {\n  const isServer = typeof window === 'undefined'\n  const isClient = !isServer\n  const responseHeaders = new Headers()\n\n  return {\n    to,\n    from,\n    isClient,\n    isServer,\n    cookies: isServer && request\n      ? createServerCookieManager(request, responseHeaders)\n      : createClientCookieManager(),\n    storage: createStorageManager(),\n    state: {},\n    request,\n    responseHeaders,\n  }\n}\n\nexport async function runMiddleware(\n  middlewareNames: string | string[],\n  context: MiddlewareContext,\n): Promise<MiddlewareResult> {\n  const names = Array.isArray(middlewareNames) ? middlewareNames : [middlewareNames]\n  const isServer = context.isServer\n\n  for (const name of names) {\n    const middleware = getMiddleware(name)\n\n    if (!middleware) {\n      console.warn(`Middleware '${name}' not found`)\n      continue\n    }\n\n    if (middleware.mode === 'server' && !isServer) continue\n    if (middleware.mode === 'client' && isServer) continue\n\n    try {\n      const result = await middleware.handler(context)\n\n      if (result) {\n        if (result.type === 'redirect') {\n          return {\n            passed: false,\n            redirect: result,\n            state: context.state,\n            responseHeaders: context.responseHeaders,\n          }\n        }\n\n        if (result.type === 'abort') {\n          return {\n            passed: false,\n            abort: result,\n            state: context.state,\n            responseHeaders: context.responseHeaders,\n          }\n        }\n      }\n    }\n    catch (error) {\n      console.error(`Error in middleware '${name}':`, error)\n      return {\n        passed: false,\n        abort: {\n          type: 'abort',\n          error: {\n            statusCode: 500,\n            message: error instanceof Error ? error.message : 'Middleware error',\n          },\n        },\n        state: context.state,\n        responseHeaders: context.responseHeaders,\n      }\n    }\n  }\n\n  return {\n    passed: true,\n    state: context.state,\n    responseHeaders: context.responseHeaders,\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "2F078381FE718BF864756E2164756E21",
+  "names": []
+}

package/dist/named-routes.js

@@ -0,0 +1,58 @@
+// @bun
+// src/named-routes.ts
+var routes = {};
+var appUrl = "";
+function setAppUrl(url) {
+  appUrl = url.replace(/\/$/, "");
+}
+function defineRoute(name, routePath, params = {}) {
+  routes[name] = { path: routePath, name, params };
+}
+function defineRoutes(routeDefinitions) {
+  for (const [name, definition] of Object.entries(routeDefinitions)) {
+    if (typeof definition === "string") {
+      routes[name] = { path: definition, name };
+    } else {
+      routes[name] = { ...definition, name };
+    }
+  }
+}
+function route(name, params = {}, absolute = false) {
+  const r = routes[name];
+  if (!r) {
+    console.warn(`Route [${name}] not defined.`);
+    return "#undefined-route";
+  }
+  const mergedParams = { ...r.params, ...params };
+  let routePath = r.path;
+  routePath = routePath.replace(/:(\w+)/g, (_, paramName) => {
+    const value = mergedParams[paramName];
+    if (value === undefined) {
+      console.warn(`Missing parameter [${paramName}] for route [${name}].`);
+      return `:${paramName}`;
+    }
+    delete mergedParams[paramName];
+    return encodeURIComponent(String(value));
+  });
+  const remainingParams = Object.entries(mergedParams);
+  if (remainingParams.length > 0) {
+    const queryString = remainingParams.map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`).join("&");
+    routePath += (routePath.includes("?") ? "&" : "?") + queryString;
+  }
+  return absolute && appUrl ? `${appUrl}${routePath}` : routePath;
+}
+function resetRoutes() {
+  for (const key of Object.keys(routes)) {
+    delete routes[key];
+  }
+  appUrl = "";
+}
+export {
+  setAppUrl,
+  route,
+  resetRoutes,
+  defineRoutes,
+  defineRoute
+};
+
+//# debugId=7C705CA1193613B164756E2164756E21

package/dist/named-routes.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/named-routes.ts"],
+  "sourcesContent": [
+    "interface RouteDefinition {\n  path: string\n  name?: string\n  params?: Record<string, any>\n}\n\nconst routes: Record<string, RouteDefinition> = {}\nlet appUrl: string = ''\n\nexport function setAppUrl(url: string): void {\n  appUrl = url.replace(/\\/$/, '')\n}\n\nexport function defineRoute(name: string, routePath: string, params: Record<string, any> = {}): void {\n  routes[name] = { path: routePath, name, params }\n}\n\nexport function defineRoutes(routeDefinitions: Record<string, string | RouteDefinition>): void {\n  for (const [name, definition] of Object.entries(routeDefinitions)) {\n    if (typeof definition === 'string') {\n      routes[name] = { path: definition, name }\n    }\n    else {\n      routes[name] = { ...definition, name }\n    }\n  }\n}\n\nexport function route(\n  name: string,\n  params: Record<string, any> = {},\n  absolute = false,\n): string {\n  const r = routes[name]\n\n  if (!r) {\n    console.warn(`Route [${name}] not defined.`)\n    return '#undefined-route'\n  }\n\n  const mergedParams = { ...r.params, ...params }\n  let routePath = r.path\n\n  routePath = routePath.replace(/:(\\w+)/g, (_, paramName) => {\n    const value = mergedParams[paramName]\n\n    if (value === undefined) {\n      console.warn(`Missing parameter [${paramName}] for route [${name}].`)\n      return `:${paramName}`\n    }\n\n    delete mergedParams[paramName]\n    return encodeURIComponent(String(value))\n  })\n\n  const remainingParams = Object.entries(mergedParams)\n  if (remainingParams.length > 0) {\n    const queryString = remainingParams\n      .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)\n      .join('&')\n\n    routePath += (routePath.includes('?') ? '&' : '?') + queryString\n  }\n\n  return absolute && appUrl ? `${appUrl}${routePath}` : routePath\n}\n\nexport function resetRoutes(): void {\n  for (const key of Object.keys(routes)) {\n    delete routes[key]\n  }\n  appUrl = ''\n}\n"
+  ],
+  "mappings": ";;AAMA,IAAM,SAA0C,CAAC;AACjD,IAAI,SAAiB;AAEd,SAAS,SAAS,CAAC,KAAmB;AAAA,EAC3C,SAAS,IAAI,QAAQ,OAAO,EAAE;AAAA;AAGzB,SAAS,WAAW,CAAC,MAAc,WAAmB,SAA8B,CAAC,GAAS;AAAA,EACnG,OAAO,QAAQ,EAAE,MAAM,WAAW,MAAM,OAAO;AAAA;AAG1C,SAAS,YAAY,CAAC,kBAAkE;AAAA,EAC7F,YAAY,MAAM,eAAe,OAAO,QAAQ,gBAAgB,GAAG;AAAA,IACjE,IAAI,OAAO,eAAe,UAAU;AAAA,MAClC,OAAO,QAAQ,EAAE,MAAM,YAAY,KAAK;AAAA,IAC1C,EACK;AAAA,MACH,OAAO,QAAQ,KAAK,YAAY,KAAK;AAAA;AAAA,EAEzC;AAAA;AAGK,SAAS,KAAK,CACnB,MACA,SAA8B,CAAC,GAC/B,WAAW,OACH;AAAA,EACR,MAAM,IAAI,OAAO;AAAA,EAEjB,IAAI,CAAC,GAAG;AAAA,IACN,QAAQ,KAAK,UAAU,oBAAoB;AAAA,IAC3C,OAAO;AAAA,EACT;AAAA,EAEA,MAAM,eAAe,KAAK,EAAE,WAAW,OAAO;AAAA,EAC9C,IAAI,YAAY,EAAE;AAAA,EAElB,YAAY,UAAU,QAAQ,WAAW,CAAC,GAAG,cAAc;AAAA,IACzD,MAAM,QAAQ,aAAa;AAAA,IAE3B,IAAI,UAAU,WAAW;AAAA,MACvB,QAAQ,KAAK,sBAAsB,yBAAyB,QAAQ;AAAA,MACpE,OAAO,IAAI;AAAA,IACb;AAAA,IAEA,OAAO,aAAa;AAAA,IACpB,OAAO,mBAAmB,OAAO,KAAK,CAAC;AAAA,GACxC;AAAA,EAED,MAAM,kBAAkB,OAAO,QAAQ,YAAY;AAAA,EACnD,IAAI,gBAAgB,SAAS,GAAG;AAAA,IAC9B,MAAM,cAAc,gBACjB,IAAI,EAAE,KAAK,WAAW,GAAG,mBAAmB,GAAG,KAAK,mBAAmB,OAAO,KAAK,CAAC,GAAG,EACvF,KAAK,GAAG;AAAA,IAEX,cAAc,UAAU,SAAS,GAAG,IAAI,MAAM,OAAO;AAAA,EACvD;AAAA,EAEA,OAAO,YAAY,SAAS,GAAG,SAAS,cAAc;AAAA;AAGjD,SAAS,WAAW,GAAS;AAAA,EAClC,WAAW,OAAO,OAAO,KAAK,MAAM,GAAG;AAAA,IACrC,OAAO,OAAO;AAAA,EAChB;AAAA,EACA,SAAS;AAAA;",
+  "debugId": "7C705CA1193613B164756E2164756E21",
+  "names": []
+}

package/dist/nested-layouts.js

@@ -0,0 +1,23 @@
+// @bun
+// src/nested-layouts.ts
+import fs from "fs";
+import path from "path";
+function resolveLayoutChain(routeFilePath, pagesDir) {
+  const layouts = [];
+  let dir = path.dirname(routeFilePath);
+  while (dir.startsWith(pagesDir) || dir === pagesDir) {
+    const layoutFile = path.join(dir, "_layout.stx");
+    if (fs.existsSync(layoutFile)) {
+      layouts.unshift(layoutFile);
+    }
+    if (dir === pagesDir)
+      break;
+    dir = path.dirname(dir);
+  }
+  return layouts;
+}
+export {
+  resolveLayoutChain
+};
+
+//# debugId=04BAC85420BADB4464756E2164756E21

package/dist/nested-layouts.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/nested-layouts.ts"],
+  "sourcesContent": [
+    "import fs from 'node:fs'\nimport path from 'node:path'\n\nexport function resolveLayoutChain(routeFilePath: string, pagesDir: string): string[] {\n  const layouts: string[] = []\n  let dir = path.dirname(routeFilePath)\n\n  // Walk up from the route's directory to the pages root, collecting _layout.stx files\n  while (dir.startsWith(pagesDir) || dir === pagesDir) {\n    const layoutFile = path.join(dir, '_layout.stx')\n    if (fs.existsSync(layoutFile)) {\n      layouts.unshift(layoutFile) // Prepend so root layout is first\n    }\n\n    if (dir === pagesDir) break\n    dir = path.dirname(dir)\n  }\n\n  return layouts\n}\n"
+  ],
+  "mappings": ";;AAAA;AACA;AAEO,SAAS,kBAAkB,CAAC,eAAuB,UAA4B;AAAA,EACpF,MAAM,UAAoB,CAAC;AAAA,EAC3B,IAAI,MAAM,KAAK,QAAQ,aAAa;AAAA,EAGpC,OAAO,IAAI,WAAW,QAAQ,KAAK,QAAQ,UAAU;AAAA,IACnD,MAAM,aAAa,KAAK,KAAK,KAAK,aAAa;AAAA,IAC/C,IAAI,GAAG,WAAW,UAAU,GAAG;AAAA,MAC7B,QAAQ,QAAQ,UAAU;AAAA,IAC5B;AAAA,IAEA,IAAI,QAAQ;AAAA,MAAU;AAAA,IACtB,MAAM,KAAK,QAAQ,GAAG;AAAA,EACxB;AAAA,EAEA,OAAO;AAAA;",
+  "debugId": "04BAC85420BADB4464756E2164756E21",
+  "names": []
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+// @bun
+
+//# debugId=5B372796A419555264756E2164756E21

package/dist/types.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "5B372796A419555264756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stx-router",
   "type": "module",
-  "version": "0.2.48",
+  "version": "0.2.53",
   "description": "File-based router for STX — .stx template discovery, nested layouts, typed route params, middleware, and client-side SPA navigation.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
@@ -29,7 +29,8 @@
       "import": "./dist/index.js"
     },
     "./*": {
-      "import": "./dist/*"
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
     }
   },
   "module": "./dist/index.js",